為一個或多個賬號在指定地域下創建資源棧實例。
接口說明
前提條件
請確保您已經創建了資源棧組。具體操作,請參見 CreateStackGroup 。
應用場景
跨賬號創建資源棧
當某企業需要在多個賬號下創建相同的資源時,為提高部署效率,管理員賬號可以在創建資源棧組時,選擇添加多個目標賬號,部署一個地域,從而在同一地域下的不同賬號中創建多個資源棧,實現在多個賬號下創建相同的資源。
跨地域創建資源棧
當某企業需要在多個地域下創建相同的資源時,為提高部署效率,管理員賬號可以在創建資源棧組時,選擇添加一個目標賬號,部署多個地域,從而在同一賬號下的不同地域中創建多個資源棧,實現在多個地域下創建相同的資源。
跨賬號、跨地域創建資源棧
當某企業需要在多個賬號下的多個地域中創建相同的資源,為提高部署效率,管理員賬號可以在創建資源棧組時,選擇添加多個目標賬號,部署多個地域,從而在不同賬號的不同地域下創建多個資源棧,實現在多個賬號下的多個地域中創建相同的資源。
本文將提供一個示例,為杭州地域已有的自助管理權限模式的資源棧組MyStackGroup
,在杭州地域和北京地域的阿里云賬號151266687691****
和141261387191****
中創建資源棧。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
ros:CreateStackInstances | create | *StackInstance acs:ros:{#regionId}:{#accountId}:stackinstance/{#StackGroupName}/{#StackInstanceAccountId}/{#StackInstanceRegionId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 資源棧組所屬的地域 ID。 您可以調用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
StackGroupName | string | 是 | 資源棧組名稱。名稱在單個地域內唯一。 | MyStackGroup |
AccountIds | array | 否 | 使用自助管理權限模式部署資源棧的目標賬號 ID 列表。最多支持添加 30 個目標賬號 ID。 說明
您必須且僅能指定 AccountIds 和DeploymentTargets 其中一個參數。
| |
string | 否 | 使用自助管理權限模式部署資源棧的目標賬號 ID 列表。最多支持添加 30 個目標賬號 ID。 說明
您必須且僅能指定 AccountIds 和DeploymentTargets 其中一個參數。
| ["151266687691****", "141261387191****"] | |
RegionIds | array | 是 | 目標執行地域列表。最多支持添加 20 個地域。 | |
string | 是 | 目標執行地域列表。最多支持添加 20 個地域。 | ["cn-hangzhou","cn-beijing"] | |
ClientToken | string | 否 | 保證請求的冪等性。該值由客戶端生成,并且必須是全局唯一的。 | 123e4567-e89b-12d3-a456-42665544**** |
OperationDescription | string | 否 | 創建資源棧的操作描述。 長度為 1~256 個字符。 | Create stack instances in hangzhou and beijing |
OperationPreferences | object | 否 | 創建資源棧的操作設置。 包含以下參數:
多個參數之間用半角逗號(,)分隔。 說明
| {"FailureToleranceCount": 1, "MaxConcurrentCount": 2} |
TimeoutInMinutes | long | 否 | 創建資源棧的超時時間。
| 10 |
DisableRollback | boolean | 否 | 當創建資源棧失敗時,是否禁用回滾策略。 取值:
| false |
ParameterOverrides | array<object> | 否 | 覆蓋參數列表。 | |
object | 否 | |||
ParameterKey | string | 是 | 覆蓋參數的名稱。如果未指定參數名稱,ROS 將使用創建資源棧組時所指定的模板參數名稱。 N 最大值為 200。 說明
| Amount |
ParameterValue | string | 是 | 覆蓋參數的值。如果未指定參數的值,ROS 將使用創建資源棧組時所指定的模板參數的值。 N 最大值為 200。 說明
| 1 |
DeploymentTargets | object | 否 | 使用服務管理權限模式部署資源棧的部署目標。 說明
您必須且僅能指定 AccountIds 和DeploymentTargets 其中一個參數。
| |
RdFolderIds | array | 是 | 資源目錄的資源夾 ID 列表。最多支持添加 20 個資源夾 ID。 您可以在指定資源夾的所有成員賬號中創建資源棧。如果您選擇的是 Root 資源夾,則會在整個資源目錄的所有成員賬號中創建資源棧。 說明
您可以在資源管理控制臺的概覽頁面查看資源夾 ID。具體操作,請參見查看資源夾基本信息。
| |
string | 否 | 資源目錄的資源夾 ID 列表。最多支持添加 20 個資源夾 ID。 您可以在指定資源夾的所有成員賬號中創建資源棧。如果您選擇的是 Root 資源夾,則會在整個資源目錄的所有成員賬號中創建資源棧。 說明
您可以在資源管理控制臺的概覽頁面查看資源夾 ID。具體操作,請參見查看資源夾基本信息。
| ["fd-4PvlVLOL8v"] | |
AccountIds | array | 否 | 資源目錄中的成員賬號 ID 列表。最多支持添加 30 個成員賬號 ID。 說明
您可以在資源管理控制臺的概覽頁面查看成員賬號 ID。具體操作,請參見查看成員詳情。
| |
string | 否 | 資源目錄中的成員賬號 ID 列表。最多支持添加 30 個成員賬號 ID。 說明
您可以在資源管理控制臺的概覽頁面查看成員賬號 ID。具體操作,請參見查看成員詳情。
| ["151266687691****","141261387191****"] | |
DeploymentOptions | array | 否 | 使用服務管理權限模式部署資源棧的部署選項列表。最多支持 1 個部署選項。 | |
string | 否 | 可選值:
|
關于公共請求參數的詳情,請參見公共參數。
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "14A07460-EBE7-47CA-9757-12CC4761D47A",
"OperationId": "6da106ca-1784-4a6f-a7e1-e723863d****"
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-11-21 | OpenAPI 入參發生變更 | 查看變更詳情 |
2024-06-17 | API 內部配置變更,不影響調用 | 查看變更詳情 |
錯誤代碼 | 錯誤信息 | HTTP 狀態碼 | 描述 |
---|---|---|---|
StackInstanceExists | The StackInstance ({instance}) already exists. | 409 | 該資源棧組在指定的目標賬號和地域存在資源棧。instance 為資源棧所屬的目標賬號和目標地域。 |
StackGroupOperationInProgress | Another Operation on StackGroup ({name}) is in progress. | 409 | 資源棧組存在進行中的操作。name 為資源棧組名稱。 |