更新DSW實例的屬性。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息，可以在RAM權限策略語句的Action元素中使用，用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下：
- 操作：是指具體的權限點。
- 訪問級別：是指每個操作的訪問級別，取值為寫入（Write）、讀?。≧ead）或列出（List）。
- 資源類型：是指操作中支持授權的資源類型。具體說明如下：
- 對于必選的資源類型，用背景高亮的方式表示。
- 對于不支持資源級授權的操作，用
全部資源表示。
- 條件關鍵字：是指云產品自身定義的條件關鍵字。
- 關聯操作：是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限，操作才能成功。
| 操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
|---|---|---|---|---|
| paidsw:UpdatePostPaidInstance | update |
|
| 無 |
請求語法
PUT /api/v2/instances/{InstanceId} HTTP/1.1
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| InstanceId | string | 是 | 實例 ID。如何獲取實例 ID，請參見 ListInstances 。 | dsw-730xxxxxxxxxx |
| body | object | 否 | 需要更新的實例屬性。 | |
| InstanceName | string | 否 | 實例名稱。格式要求：
| training_data |
| EcsSpec | string | 否 | 實例對應的 ECS 規格。如何獲取 ECS 規格，請參見 ListEcsSpecs 。 | ecs.c6.large |
| ImageId | string | 否 | 鏡像 ID。如何獲取鏡像 ID，請參見 ListImages 。 | image-05cefd0be2exxxx |
| ImageUrl | string | 否 | 鏡像地址。如何獲取鏡像地址，請參見 ListImages 。 | registry.cn-shanghai.aliyuncs.com/pai_product/tensorflow:py36_cpu_tf1.12_ubuntu |
| Datasets | array<object> | 否 | 數據集集合。 | |
| Dataset | object | 否 | 數據集對象。 | |
| DatasetId | string | 否 | 數據集 ID。如何獲取數據集 ID，請參見 ListDatasets 。 | d-vsqjvsjp4orp5l206u |
| MountPath | string | 否 | 容器內掛載路徑。 | /mnt/data |
| Uri | string | 否 | 需要掛載的 OSS 目錄的 Uri，使用時不能同時指定 DatasetId。 | oss://bucket-name.oss-cn-shanghai-internal.aliyuncs.com/data/path/ |
| 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" } |
OptionTypedeprecated | string | 否 | 掛載類型，使用時不能同時指定 Options，目前已廢棄，不建議使用，建議使用 Options 參數。 | ReadOnly |
| UserVpc | object | 否 | User VPC 配置。 | |
| VpcId | string | 否 | VPC ID。 | vpc-xxxxx |
| VSwitchId | string | 否 | 交換機 ID。 | vsw-xxxxx |
| SecurityGroupId | string | 否 | 安全組 ID。 | sg-xxxxxx |
| ExtendedCIDRs | array | 否 | 擴展網段。
| |
| ExtendedCIDR | string | 否 | 擴展網段。 | "172.16.19.0/24","172.16.2.0/24","172.16.12.0/24" |
| DefaultRoute | string | 否 | 默認路由。取值如下：
| eth0 |
| ForwardInfos | array | 否 | Forward Infos | |
| ForwardInfo | 否 | |||
| Accessibility | string | 否 | 工作空間內是否他人可見。取值如下：
| PRIVATE |
| DisassociateDatasets | boolean | 否 | 是否刪除關聯數據集。
| false |
| DisassociateVpc | boolean | 否 | 是否刪除關聯用戶 VPC。 | false |
| DisassociateForwardInfos | boolean | 否 | 是否刪除關聯端口透出信息 | false |
| RequestedResource | object | 否 | 資源配置，彈內或者輕量化時使用。 | |
| CPU | string | 否 | CPU 核數。 | 32 |
| Memory | string | 否 | 內存大小，單位為 GB。 | 32 |
| SharedMemory | string | 否 | 共享內存大小，單位為 GB。 | |
| GPU | string | 否 | GPU 數量。 | 4 |
| GPUType | string | 否 | GPU 顯卡類型。 | v100 |
| WorkspaceSource | string | 否 | 工作空間指向的存儲，如果不指定，則依次使用 NAS，CloudDisk 或者本地磁盤。 | d-123456789 |
| UserId | string | 否 | 實例的使用者，可能是子賬號或者主賬號。 | 16122********** |
| CloudDisks | array<object> | 否 | 云盤列表 | [] |
| CloudDisk | object | 否 | ||
| Capacity | string | 否 | 云盤容量 | 30Gi |
| SubType | string | 否 | 云盤類型, rootfs 掛載為 rootfs | rootfs |
| Priority | long | 否 | 優先級，在分配資源給實例時，優先級越高的實例越優先。取值范圍為 1~9。 1 為最低優先級。 9 為最高優先級。 | 1 |
| Driver | string | 否 | NVIDIA 驅動配置。 | 535.54.03 |
| DisassociateDriver | boolean | 否 | 是否刪除 NVIDIA 驅動配置。 | false |
| CredentialConfig | CredentialConfig | 否 | 憑據配置 | |
| DisassociateCredential | boolean | 否 | 是否刪除 credential 注入信息 | false |
| Affinity | object | 否 | 親和性配置。 | |
| CPU | object | 否 | CPU 親和性配置。僅支持通用計算預付費實例。 | |
| Enable | boolean | 否 | 是否開啟 CPU 親和性。 true：開啟。 false：不開啟。 | true |
| ImageAuth | string | 否 | 用戶私有鏡像的賬號密碼信息 base64 編碼后的值，密碼部分會被隱藏。 | **** |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "E7D55162-4489-1619-AAF5-3F97D5FCA948",
"Success": true,
"Message": "\"XXX\"",
"Code": "null",
"HttpStatusCode": 0,
"InstanceId": "dsw-730xxxxxxxxxx"
}錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2024-08-01 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2024-07-09 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2024-06-24 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2024-01-09 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-12-27 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-12-14 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-11-14 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-09 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-08-08 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2023-03-28 | API 內部配置變更，不影響調用 | 查看變更詳情 |
| 2022-01-20 | OpenAPI 返回結構發生變更 | 查看變更詳情 |