您可以調用API CreateEai創建一個EAIS，并將EAIS實例綁定到客戶端實例（ECS實例或ECI實例）上來靈活地為客戶端實例提供業務所需的GPU資源并節省成本。以ECS實例為例，您可以通過在ECS實例（非GPU實例）上綁定一個彈性加速計算實例EAIS，即可生成一款新規格的GPU實例，且使用該方式相比直接購買GPU實例，可以實現GPU資源的彈性使用（您可以根據實際需要綁定、解綁或釋放EAIS實例），有效為您降低部署成本和使用成本。
接口說明
請確保在使用該接口前，已充分了解 EAIS 產品的計費說明。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| RegionId | string | 是 | 實例所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-shenzhen |
| InstanceType | string | 是 | EAIS 實例的規格。取值范圍：
| eais.ei-a6.2xlarge |
| ClientToken | string | 否 | 冪等參數，保證請求冪等性。從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken 只支持 ASCII 字符，且不能超過 64 個字符。更多信息，請參見如何保證冪等性。 | 123e4567-e89b-12d3-a456-426655440000 |
| InstanceName | string | 否 | EAIS 實例的名稱。長度為 2~128 個字符，支持 Unicode 中 letter 分類下的字符（其中包括英文、中文和數字等）。可以包含半角冒號（:）、下劃線（_）、半角句號（.）或者短劃線（-）。 | eais-test01 |
| SecurityGroupId | string | 是 | 實例所屬的安全組 ID。 | sg-uf66jeqopgqa9hdn**** |
| VSwitchId | string | 是 | 實例所屬的虛擬交換機 ID。 說明
交換機網段內 IP 的個數決定了該交換機最大可支持創建的 EAIS 實例個數，請務必提前規劃好網段設置。
| vsw-uf6h3rbwbm90urjwa**** |
| ResourceGroupId | string | 否 | 實例所屬的資源組 ID。 | rg-acfmvpuy4a5**** |
| Image | string | 否 | EAIS 實例鏡像。默認使用 EAIS 內部鏡像提供服務，用戶也可以通過指定 Image 參數使用自己的鏡像。自定義鏡像使用限制如下：
說明
鏡像太大可能會導致下載鏡像的過程太長，造成創建超時失敗。
| ubuntu:20.04 |
返回參數
示例
正常返回示例
JSON格式
{
"ElasticAcceleratedInstanceId": "eais-sz8t15a7gt7z7j7i****",
"RequestId": "F5FEB9AA-C108-577C-AB3D-D13524AF****"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | CheckTimeout | Check timed out. | 檢查超時。 |
| 400 | CustomTag.NumberExceed | The maximum number of system tags for each resource is 20. | 每個資源最多允許綁定20個用戶標簽。 |
| 400 | Duplicate.TagKey | The Tag.N.Key contains a duplicated key. | 傳入的TagKey重復。 |
| 400 | InvalidInstanceType | The instance type is invalid. | 無效的實例類型。 |
| 400 | InvalidParameter.TagKey | The specified Tag.n.Key is invalid. | TagKey為非法值。 |
| 400 | InvalidParameter.TagValue | The specified Tag.n.Value is invalid. | TagValue為非法值。 |
| 400 | InvalidRegionId | The service does not support the region. You can call the DescribeRegions API to view the supported regions. | 無效的地域，您可以調用DescribeRegions API查看服務支持的地域。 |
| 400 | NumberExceed.Tags | The maximum number of Tags is exceeded. The maximum is 20. | 傳入的Tag數量達到上限，最多支持20個。 |
| 400 | Timeout | Operation timed out. | 操作超時。 |
| 401 | CallRamApiFailed | Failed to call the Alibaba Cloud RAM service. | 調用阿里云RAM失敗。 |
| 403 | CreateOrderFailed | Create order failed: %s. | 創建訂單失敗，請嘗試重新創建。 |
| 403 | InDebt | The current user has an overdue payment. Please top up first. | 當前用戶欠費中，請充值后再操作。 |
| 403 | NoPermission | You are not authorized to perform this operation. %s | 您沒有權限執行此操作。 |
| 403 | NoPermission | You do not have permission to create the service linked role AliyunServiceRoleForEais. | 您沒有權限創建服務關聯角色AliyunServiceRoleForEais。 |
| 403 | NoResources | The current regional resources are insufficient. | 當前地域資源不足。 |
| 403 | OperationDenied.KeyValueNotNull | The key value cannot be null. | 標簽值不能為空。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-08-23 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-04-10 | OpenAPI 入參發生變更 | 查看變更詳情 |