すべてのプロダクト
Search

このプロダクト

    Platform For AI:CreateService

    ドキュメントセンター

    Platform For AI:CreateService

    最終更新日:Dec 23, 2025

    Elastic Algorithm Service (EAS) でモデルサービスを作成します。

    操作説明

    **この操作を呼び出す前に、EAS の課金について精通していることを確認してください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    eas:CreateService

    create

    *All Resource

    *

    		 なし なし

    リクエスト構文

    POST /api/v2/services HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    body

    string

    任意

    リクエストボディ。 主要なリクエストパラメーターの詳細については、表 1. リクエストボディパラメーターおよび表 2. メタデータパラメーターをご参照ください。 関連するすべてのパラメーターの詳細については、「モデルサービスのパラメーター」をご参照ください。

    镜像部署服务： { "name": "foo", "metadata": { "instance": 2, "memory": 7000, "cpu": 4 }, "containers": [ { "image": "****", "script": "**** --listen=0.0.0.0 --server_port=8000 --headless", "port": 8000 } ], "storage": [ { "oss": { "path": "oss://examplebuket/data111/", "readOnly": false }, "properties": { "resource_type": "model" }, "mount_path": "/data" } ] } 镜像部署AI-Web应用： { "name": "foo", "metadata": { "instance": 1, "memory": 7000, "cpu": 4, "enable_webservice": true }, "containers": [ { "image": "****", "script": "**** --listen=0.0.0.0 --server_port=8000 --headless", "port": 8000 } ], "storage": [ { "oss": { "path": "oss://examplebucket/data111/", "readOnly": false }, "properties": { "resource_type": "model" }, "mount_path": "/data" } ] } 模型+processor部署服务： { "metadata": { "instance": 1, "memory": 7000, "cpu": 4 }, "name": "foo", "model_config": {}, "processor_type": "python", "processor_path": "oss://****", "processor_entry": "a.py", "model_path": "oss://****" }
    Develop

    string

    任意

    開発モードに入るかどうかを指定します。

    有効値：

    • true

    • false

    列挙値:

    • true :

      true

    true
    Labels

    object

    任意

    カスタムラベル。

    string

    任意

    ラベル。

    {"key":"value"}
    WorkspaceId

    string

    任意

    ワークスペース ID。

    123456

    表 1. リクエストボディパラメーター

    パラメータータイプ必須説明
    nameStringはいサービス名。リージョン内で一意である必要があります。
    tokenStringいいえ認証用のトークン。 トークンを指定せず、generate_token が true に設定されている場合、トークンは自動的に生成されます。
    model_pathStringいいえモデルファイルのパス。 HTTP アドレスまたは Object Storage Service (OSS) パスを指定できます。 HTTP アドレスを指定する場合、その HTTP アドレスはパブリックにアクセス可能である必要があります。 OSS パスを指定する場合、パスはディレクトリまたはファイル名にすることができます。 .tar.gz、.tar.bz2、または .zip ファイルを指定した場合、システムは自動的にファイルを解凍します。
    role_arnstringいいえmodel_path または processor_path を OSS アドレスに設定する場合、OSS にアクセスするために role_arn パラメーターを指定し、role_arn を取得するために Role_ARN パラメーターを指定する必要があります。
    oss_endpointStringいいえOSS バケットのエンドポイント。 model_path または processor_path を OSS パスに設定する場合、このパラメーターを指定する必要があります。
    model_entryStringいいえモデルのプライマリファイル。 任意のファイルをモデルのプライマリファイルとして指定できます。 ファイルが指定されていない場合、model_path で指定されたファイルがモデルのプライマリファイルとして使用されます。 プライマリファイルのパスは、プロセッサの Load() 関数に配信されます。
    processor_pathStringはいプロセッサファイルのパス。 ローカルファイルまたは HTTP アドレスを指定できます。 .tar.gz、.tar.bz2、または .zip ファイルを指定した場合、システムは自動的にファイルを解凍します。
    processor_entryStringいいえprocessor_type を C、C++、または Python に設定した場合、このパラメーターは必須です。 プロセッサのメインファイル。 メインファイルには、予測に必要な Load() および Process() 関数の実装が含まれています。
    processor_mainclassStringいいえprocessor_type を Java に設定した場合、このパラメーターは必須です。 プロセッサの JAR パッケージ内のメインクラス。
    processor_typeStringはいプロセッサの実装に使用される言語。 有効値：C、C++、Java、Python。
    metadataDictいいえサービスのメタデータ。 詳細については、表 2 をご参照ください。
    cloudDictいいえマップキー。 このパラメーターは、サービスをデプロイするためにインスタンスタイプを指定する場合にのみ必須です。 このパラメーターは、"cloud":{"computing":{"instance_type": "ecs.gxxxxxx.large"}} の形式で指定する必要があります。
    containersListいいえカスタムイメージを使用して実装されるコンテナーデプロイメントのメソッド。 プロセッサを使用してデプロイされたコンテナーが要件を満たせない場合、カスタムイメージを使用してコンテナーをデプロイできます。 詳細については、「カスタムイメージを使用したモデルサービスのデプロイ」をご参照ください。

    説明 model_path パラメーターと processor_path パラメーターは、モデル入力とプロセッサ入力のソースを指定します。 パスは HTTP アドレスまたは OSS パスに設定できます。 オンプレミスマシンでテストコマンドを使用してモデルをデバッグする場合、パラメーターをローカルファイルおよびディレクトリに設定できます。

    • HTTP アドレスを使用する場合、関連ファイルを .tar.gz、.tar.bz2、または .zip ファイルに圧縮する必要があります。 その後、ファイルを OSS にアップロードして HTTP アドレスを生成できます。

    • OSS パスを使用する場合、ディレクトリまたはファイル名をパスとして入力できます。

    表 2. メタデータパラメーター

    パラメータータイプ必須説明例
    instanceIntいいえサービスの開始に必要なワーカーの数。1
    cpuIntいいえ各ワーカーが必要とする CPU の数。1
    gpuIntいいえ各ワーカーが必要とする GPU の数。0
    memoryIntいいえ各ワーカーが必要とするメモリサイズ。 単位：MB。1000
    resourceStringいいえサービスが属するリソースグループ。eas-r-aaabbbccc
    rpc.worker_threadsIntいいえ各インスタンスでリクエストを同時に処理するために使用されるスレッドの数。5
    rpc.max_queue_sizeIntいいえリクエストを処理するためのキューの最大サイズ。 キューがいっぱいの場合、新しいリクエストは破棄され、HTTP 450 ステータスコードが返されます。64
    rpc.keepaliveIntいいえリクエストのタイムアウト期間。 単位：ミリ秒。5000
    rpc.rate_limitIntいいえ単一インスタンスのリクエストスロットリングをトリガーする 1 秒あたりのクエリ数 (QPS) の値。 QPS を超えると、新しいリクエストは破棄され、HTTP 429 ステータスコードが返されます。0
    releaseBoolいいえカナリアリリース用のサービスを作成するかどうかを指定します。 有効値：true および false。 このパラメーターを true に設定した場合、カナリアリリース用のサービスを作成する必要があります。false

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスパラメーター。

    RequestId

    string

    リクエスト ID。

    40325405-579C-4D82****
    ServiceId

    string

    作成されたサービスの ID。

    eas-m-aaxxxddf
    ServiceName

    string

    作成されたサービスの名前。

    yourname
    Status

    string

    サービスステータス。

    Creating
    Region

    string

    作成されたサービスのリージョン ID。

    cn-shanghai
    InternetEndpoint

    string

    作成されたサービスのパブリックエンドポイント。

    http://pai-eas.vpc.cn-shanghai.****
    IntranetEndpoint

    string

    作成されたサービスの内部エンドポイント。

    http://pai-eas.cn-shanghai.****

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "40325405-579C-4D82****",
  "ServiceId": "eas-m-aaxxxddf",
  "ServiceName": "yourname",
  "Status": "Creating",
  "Region": "cn-shanghai",
  "InternetEndpoint": "http://pai-eas.vpc.cn-shanghai.****",
  "IntranetEndpoint": "http://pai-eas.cn-shanghai.****"
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。