すべてのプロダクト
Search

このプロダクト

    Platform For AI:CreateInstance

    ドキュメントセンター

    Platform For AI:CreateInstance

    最終更新日:Jul 17, 2026

    DSW インスタンスを作成します。

    今すぐお試しください

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

    テスト

    RAM 認証

    この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

    リクエスト構文

    POST /api/v2/instances HTTP/1.1

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    body

    object

    任意

    インスタンスのプロパティ。

    WorkspaceId

    string

    任意

    ワークスペースの ID。ワークスペース ID の取得方法については、 ListWorkspaces を参照してください。

    40823
    InstanceName

    string

    任意

    インスタンス名。フォーマット要件:

    • 英字、数字、アンダースコア (_) のみ使用できます。

    • 27 文字を超えることはできません。

    training_data
    EcsSpec

    string

    任意

    ECS インスタンスタイプ。ECS インスタンスタイプの取得方法については、 ListEcsSpecs を参照してください。

    ecs.c6.large
    ImageId

    string

    任意

    イメージの ID。イメージ ID の取得方法については、 ListImages を参照してください。

    image-05cefd0be2exxxx
    ImageUrl

    string

    任意

    イメージの URL。イメージ URL の取得方法については、 ListImages を参照してください。

    registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu
    Datasets

    array<object>

    任意

    データセットのリスト。

    object

    任意

    データセット。

    DatasetId

    string

    任意

    データセットの ID。データセットが読み取り専用の場合、MountAccess を使用して読み書きに変更することはできません。

    データセット ID の取得方法については、 ListDatasets を参照してください。データセット ID を指定する場合、Uri は指定できません。

    d-vsqjvs****rp5l206u
    DatasetVersion

    string

    任意

    データセットのバージョン。DatasetId を同時に指定する必要があります。デフォルト値: v1。

    v1
    Uri

    string

    任意

    直接マウントするストレージサービスディレクトリの URI。このフィールドは DatasetId と相互排他です。

    ストレージタイプごとの URI フォーマット:

    • OSS: oss://bucket-name.oss-cn-shanghai-internal.aliyuncs.com/data/path/ (バケット名とパスを含むセット)

    • NAS: nas://29**d-b12****446.cn-hangzhou.nas.aliyuncs.com/data/path/

    • エクストリーム NAS: nas://29****123-y**r.cn-hangzhou.extreme.nas.aliyuncs.com/data/path/

    • CPFS: cpfs://cpfs-213****87.cn-wulanchabu/ptc-292*****cbb/exp-290********03e/data/path/

    • インテリジェントコンピューティング CPFS: bmcpfs://cpfs-290******foflh-vpc-x****8r.cn-wulanchabu.cpfs.aliyuncs.com/data/path/

    oss://bucket-name.oss-cn-shanghai-internal.aliyuncs.com/data/path/
    MountPath

    string

    任意

    データセットのマウントパス。

    /mnt/data
    MountAccess

    string

    任意

    データセットマウント後の読み書き権限。データセットが読み取り専用の場合、読み書きに変更することはできません。

    列挙値:

    • RW :

      読み書き。

    • RO :

      読み取り専用。

    RW
    Options

    string

    任意

    カスタムマウントプロパティ。現在、OSS のみがサポートされています。OptionType を同時に指定することはできません。詳細については、DSW マウント構成 を参照してください。

    { "fs.oss.download.thread.concurrency": "10", "fs.oss.upload.thread.concurrency": "10", "fs.jindo.args": "-oattr_timeout=3 -oentry_timeout=0 -onegative_timeout=0 -oauto_cache -ono_symlink" }

    OptionType deprecated

    string

    任意

    マウントタイプ。Options を同時に指定することはできません。このパラメーターは非推奨です。代わりに Options パラメーターを使用してください。

    ReadOnly
    Dynamic

    boolean

    任意

    動的マウントを有効にするかどうかを指定します。デフォルト値: false。

    • 現在、汎用コンピューティングリソースを持つインスタンスのみがサポートされています。

    • 現在、OSS データセットのみがサポートされています。マウントされたデータセットは読み取り専用モードになります。

    • 動的にマウントされるデータセットの MountPath は、動的マウントルートパス (デフォルト: /mnt/dynamic/) のサブパスである必要があります (例: /mnt/dynamic/data1/)。

    • 動的にマウントされるデータセットは、非動的にマウントされるデータセットの後に配置する必要があります。

    true
    RoleArn

    string

    任意

    UserVpc

    object

    任意

    ユーザー VPC の構成。

    VpcId

    string

    任意

    VPC ID。

    vpc-xxxxx
    VSwitchId

    string

    任意

    vSwitch の ID。

    vsw-xxxxx
    SecurityGroupId

    string

    任意

    セキュリティグループの ID。

    sg-xxxxxx
    ExtendedCIDRs

    array

    任意

    拡張 CIDR ブロック。

    • vSwitch ID が空の場合、このパラメーターは任意です。システムは VPC 配下のすべての CIDR ブロックを自動的に取得します。

    • vSwitch ID が空でない場合、このパラメーターは必須です。VPC 配下のすべての CIDR ブロックを指定してください。

    ["192.168.0.1/24", "192.168.1.1/24"]

    string

    任意

    拡張 CIDR ブロック。

    "172.16.19.0/24","172.16.2.0/24","172.16.12.0/24"
    DefaultRoute

    string

    任意

    デフォルトルーティング。有効な値:

    eth0
    ForwardInfos

    array

    任意

    ポート フォワーディング情報。

    ForwardInfo

    任意

    ポート フォワーディング情報のリスト。マップされたポート、ゲートウェイ ID、SSH 公開鍵などのパラメーターを設定して転送できます。

    BandwidthLimit

    BandwidthLimit

    任意

    Accessibility

    string

    任意

    インスタンスの可視性。

    列挙値:

    • PUBLIC :

      ワークスペース内のすべてのユーザーに表示されます。

    • PRIVATE :

      ワークスペース内のオーナーと管理者にのみ表示されます。

    PRIVATE
    EnvironmentVariables

    object

    任意

    DSW インスタンスに注入される環境変数。

    警告 ここで指定された環境変数は、システムプリセットの環境変数をオーバーライドする可能性があります。

    {userName: "Chris"}

    string

    任意

    ユーザー指定の環境変数。DSW インスタンスの起動後、指定された環境変数がコンテナに注入されます。

    MAAS
    ResourceId

    string

    任意

    リソースグループの ID。サブスクリプションインスタンスに必須です。専用リソースグループの作成方法については、「DLC リソースグループクラスターの準備と管理」を参照してください。

    dsw-123456789
    Priority

    integer

    任意

    リソース割り当ての優先度。優先度の高いインスタンスにリソースが先に割り当てられます。有効な値: 1～9。

    • 1: 最低優先度。

    • 9: 最高優先度。

    1
    RequestedResource

    object

    任意

    リソースの構成。

    {"CPU":"4","Memory":"8Gi","SharedMemory":"4Gi","GPU":"1","GPUType":"Tesla-V100-16G"}
    CPU

    string

    任意

    CPU のコア数。

    32
    Memory

    string

    任意

    メモリのサイズ。単位: GB。

    重要 このパラメーターを渡す際は、32 ではなく 32GB のように単位を指定してください。 単位が指定されていない場合、デフォルトの単位は MB です。

    32GB
    SharedMemory

    string

    任意

    共有メモリのサイズ。単位: GB。

    重要 このパラメーターを渡す際は、32 ではなく 32GB のように単位を指定してください。 単位が指定されていない場合、デフォルトの単位は MB です。

    32GB
    GPU

    string

    任意

    GPU の数。

    4
    GPUType

    string

    任意

    GPU のタイプ。有効な値:

    • V100

    • A100

    • T4

    • A10

    • P100

    v100
    Labels

    array<object>

    任意

    ユーザー定義のラベル。

    {'foo': 'bar'}

    object

    任意

    ユーザー定義のラベル。

    Key

    string

    任意

    ユーザー定義のラベルキー。

    stsTokenOwner
    Value

    string

    任意

    ユーザー定義のラベル値。

    123xxxxxxxx
    CloudDisks

    array<object>

    任意

    クラウドディスクのリスト。

    []

    array<object>

    任意

    クラウドディスクのリスト。

    Capacity

    string

    任意

    リソースタイプがパブリックリソースに設定されている場合、またはリソースクォータがサブスクリプション汎用コンピューティングリソース (CPU コア ≥ 2 かつメモリ ≥ 4 GB、または GPU 設定あり) に設定されている場合:

    各インスタンスには、永続ストレージ用に無料の 100 GiB システムクラウドディスククォータが含まれます。インスタンスが 15 日以上停止されている場合、クラウドディスクの内容はクリアされます。クラウドディスクは容量拡張をサポートしています。具体的な料金については、コンソールインターフェイスを参照してください。

    警告

    • 拡張後の容量削減はサポートされていません。必要に応じて容量を拡張してください。

    • 拡張後、システムクラウドディスク全体 (無料分 + 有料分) は 15 日間のリリース制限の対象外となりますが、料金は引き続き発生します。

    • インスタンスが削除されると、システムクラウドディスクも同時にリリースされます。削除前に必要なデータバックアップを行ってください。

    永久ストレージの場合は、データセットマウントを設定するか、ストレージパスマウントに OSS、NAS、または CPFS のパスを追加してください。

    100Gi
    SubType

    string

    任意

    クラウドディスクのタイプ:

    • rootfs: ルートファイルシステムとしてマウントされます。システム環境はこのディスクに保存されます。

    rootfs
    MountPath

    string

    任意

    クラウドディスクのマウントパス。

    /mnt/systemDisk
    Path

    string

    任意

    インスタンスにマウントされるクラウドディスク上のサブディレクトリパス。

    workspace
    Status

    object

    任意

    クラウドディスクまたはスナップショットの使用量。

    Available

    integer

    任意

    利用可能な空き容量。単位: バイト。

    31841058816
    Usage

    integer

    任意

    使用済み容量。単位: バイト。

    371195904
    Capacity

    integer

    任意

    容量。単位: バイト。

    32212254720
    WorkspaceSource

    string

    任意

    作業ディレクトリのストレージを指定します。クラウドディスクまたは Datasets のデータセットを /mnt/workspace 作業ディレクトリにマウントできます。OSS データセットおよび動的マウントデータセットはサポートされていません。

    有効な値:

    • rootfsCloudDisk: クラウドディスクを作業ディレクトリにマウントします。

    • データセットマウントパス: Datasets 内のデータセットの MountPath (例: /mnt/data)。URI フォーマットのデータセットはこの方法でのみ指定できます。

    • データセット ID: d-vsqjvs****rp5l206u など。同じデータセットが複数のパスにマウントされている場合、最初のものが選択されます。このメソッドは推奨されません。代わりにマウントパスを使用してください。

    このパラメーターが空の場合:

    • インスタンスがクラウドディスクを使用している場合、デフォルトでクラウドディスクが選択されます。

    • 利用可能なクラウドディスクがない場合、最初の NAS または CPFS データセットが作業ディレクトリとして選択されます。

    • 利用可能なクラウドディスクまたは NAS/CPFS 作業ディレクトリがない場合、ホスト領域が使用されます。

    rootfsCloudDisk
    UserId

    string

    任意

    インスタンス所有者のアカウント ID。Alibaba Cloud アカウントまたは Resource Access Management (RAM) ユーザーをサポートします。

    161228528250****
    Driver

    string

    任意

    NVIDIA ドライバーの構成。

    535.54.03
    CredentialConfig CredentialConfig

    任意

    認証情報の構成。

    Affinity

    object

    任意

    アフィニティ構成。

    CPU

    object

    任意

    CPU アフィニティ構成。サブスクリプション汎用コンピューティングインスタンスでのみサポートされています。

    Enable

    boolean

    任意

    CPU アフィニティを有効にするかどうかを指定します。

    • false: 無効。

    • true: 有効。

    true
    ImageAuth

    string

    任意

    ユーザーの非公開イメージの認証情報の Base64 エンコーディング。パスワード部分は非表示になります。

    ****
    DynamicMount DynamicMount

    任意

    動的マウントの構成。

    Tag

    array<object>

    任意

    タグのリスト。

    object

    任意

    タグ。

    Key

    string

    任意

    タグキー。

    tag1
    Value

    string

    任意

    タグ値。

    value1
    UserCommand

    object

    任意

    ユーザー定義の実行コマンド。

    OnStart

    object

    任意

    インスタンスの起動時に毎回実行されるカスタムコマンド。このコマンドは、インスタンス環境の初期化後、jupyter-lab や code-server などのサーバーが開始される前に実行されます。

    Content

    string

    任意

    カスタム起動コマンドの内容。

    OversoldType

    string

    任意

    アイドルリソースのタイプ。有効な値: ForceQuotaOverSold: アイドルリソースのみを使用します。 AcceptQuotaOverSold: アイドルリソースを受け入れます。 ForbiddenQuotaOverSold: 保証リソースを使用します。

    AssignNodeSpec

    object

    任意

    ノードスケジューリングの構成。

    NodeNames

    string

    任意

    スケジューリングの指定ノード: "node-a,node-b"。

    node-a
    AntiAffinityNodeNames

    string

    任意

    スケジューリングの除外ノード: "node-a,node-b"。

    node-b
    SpotSpec

    object

    任意

    スポットインスタンスの構成。

    SpotStrategy

    string

    任意

    スポット戦略。有効な値: SpotWithPriceLimit: スポットインスタンスのカスタム値幅制限を設定します。 SpotAsPriceGo: システムが現在の市場価格で自動的に入札します。

    SpotWithPriceLimit
    SpotPriceLimit

    string

    任意

    スポットインスタンスの最大時間単価。10 進数で小数点以下 3 桁までサポートされています。SpotStrategy が SpotWithPriceLimit の場合に必須です。

    0.12
    SpotDuration

    string

    任意

    スポットインスタンスの保護期間。デフォルト値: 1。保護期間なしの場合は 0 に設定できます。Lingjun インスタンスタイプには適用されません。

    0
    SpotDiscountLimit

    string

    任意

    スポットインスタンスの最大時間割引率。Lingjun インスタンスタイプに必須です。

    0.1
    DockerConfig

    object

    任意

    Enable

    boolean

    任意

    ContainersLimit

    integer

    任意

    10
    MountAccessConfigPath

    string

    任意

    MigrationOptions

    object

    任意

    AccessRestrictionRules

    object

    任意

    string

    任意

    UserMetricsEndpoints

    array

    任意

    UserMetricsEndpoint

    任意

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    実行結果。

    RequestId

    string

    リクエストの ID。

    E7D55162-4489-1619-AAF5-3F97D5FCA948
    Success

    boolean

    操作が成功したかどうかを示します。有効な値:

    • true

    • false

    true
    Message

    string

    返された結果の説明。

    "XXX"
    Code

    string

    状態コード。有効な値:

    • InternalError: 内部エラーが発生しました (パラメーター検証エラー以外のすべてのエラーは内部エラーとして分類されます)。

    • ValidationError: パラメーター検証エラーが発生しました。

    null
    HttpStatusCode

    integer

    HTTP 状態コード。有効な値:

    • 400

    • 404

    • 200

    200
    InstanceId

    string

    インスタンスの ID。

    dsw-730xxxxxxxxxx

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "E7D55162-4489-1619-AAF5-3F97D5FCA948",
  "Success": true,
  "Message": "\"XXX\"",
  "Code": "null",
  "HttpStatusCode": 200,
  "InstanceId": "dsw-730xxxxxxxxxx"
}

    エラーコード

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

    変更履歴

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