日本熟妇hd丰满老熟妇,中文字幕一区二区三区在线不卡 ,亚洲成片在线观看,免费女同在线一区二区

CreateStack - 創建資源棧

使用資源編排模板創建資源棧,完成一組資源的創建。

接口說明

資源棧是針對 ROS 資源的管理單元,您可通過創建資源棧來創建一組資源。關于資源棧的更多信息,請參見概覽
使用限制:

  • 每個阿里云賬號最多創建 200 個資源棧。
  • 每個資源棧中最多創建 200 個資源。

本文將提供一個示例,在杭州地域創建一個名為MyStack的資源棧,并將資源棧的模板TemplateBody設置為{"ROSTemplateFormatVersion":"2015-09-01"}

調試

您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。

授權信息

下表是API對應的授權信息,可以在RAM權限策略語句的Action元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:

  • 操作:是指具體的權限點。
  • 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
  • 資源類型:是指操作中支持授權的資源類型。具體說明如下:
    • 對于必選的資源類型,用背景高亮的方式表示。
    • 對于不支持資源級授權的操作,用全部資源表示。
  • 條件關鍵字:是指云產品自身定義的條件關鍵字。
  • 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作訪問級別資源類型條件關鍵字關聯操作
ros:CreateStackcreate
*Stack
acs:ros:{#regionId}:{#accountId}:stack/*

請求參數

名稱類型必填描述示例值
DisableRollbackboolean

當創建資源棧失敗時,是否禁用回滾。

取值:

  • true:禁用回滾,即在創建資源棧失敗時不進行回滾。
  • false(默認值):不禁用回滾,即在創建資源棧失敗時進行回滾。
false
TemplateBodystring

模板主體的結構。長度為 1~524,288 個字節。如果長度較長,則建議通過 HTTP POST+Body Param 的方式,將參數放在請求體中進行傳遞,避免因 URL 過長而導致請求失敗。

說明 您必須且僅能指定 TemplateBody、TemplateURL、TemplateId 或 TemplateScratchId 其中一個參數。
{"ROSTemplateFormatVersion":"2015-09-01"}
StackPolicyURLstring

包含資源棧策略的文件的位置。URL 必須指向位于 Web 服務器(HTTP 或 HTTPS)或阿里云 OSS 存儲空間(例如:oss://ros/stack-policy/demo、oss://ros/stack-policy/demo?RegionId=cn-hangzhou)中的策略,策略文件最大長度為 16,384 個字節。如未指定 OSS 地域,默認與接口參數 RegionId 相同。

說明 您僅能指定 StackPolicyBody 或 StackPolicyURL 其中一個參數。

URL 最大長度為 1350 個字節。

oss://ros-stack-policy/demo
TimeoutInMinuteslong

創建資源棧的超時時間。

  • 默認值:60。

  • 單位:分鐘。

  • 取值范圍:10~1440。

10
StackPolicyBodystring

包含資源棧策略主體的結構,長度為 1~16,384 個字節。

說明 您僅能指定 StackPolicyBody 或 StackPolicyURL 其中一個參數。
{"Statement": [{"Action": "Update:*", "Resource": "*", "Effect": "Allow", "Principal": "*"}]}
StackNamestring

資源棧名稱。
長度不超過 255 個字符,必須以英文字母開頭,可包含數字、英文字母、短劃線(-)和下劃線(_)。

MyStack
RegionIdstring

資源棧所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou
ClientTokenstring

保證請求的冪等性。該值由客戶端生成,并且必須是全局唯一的。長度不超過 64 個字符,可包含英文字母、數字、短劃線(-)和下劃線(_)。

更多信息,請參見如何保證冪等性

123e4567-e89b-12d3-a456-42665544****
TemplateURLstring

包含模板主體的文件的位置。URL 必須指向位于 Web 服務器(HTTP 或 HTTPS)或阿里云 OSS 存儲空間(例如:oss://ros/stack-policy/demo、oss://ros/stack-policy/demo?RegionId=cn-hangzhou)中的模板,模板的最大長度為 524,288 個字節。如未指定 OSS 地域,默認與 RegionId 取值相同。

說明 您必須且僅能指定 TemplateBody、TemplateURL、TemplateId 或 TemplateScratchId 其中一個參數。
oss://ros-template/demo
RamRoleNamestring

RAM 角色名稱。ROS 會扮演該角色創建資源棧,使用角色的憑證代表用戶進行接口調用。
ROS 始終將此角色用于資源棧上將進行的操作。只要用戶有權在資源棧上進行操作,即使用戶無權使用角色,ROS 也會使用此角色,確保角色授予最少的權限。關于如何使用 RAM 角色,請參見使用資源棧角色

如果用戶未指定該值,ROS 將使用以前與資源棧關聯的角色。如果沒有可用角色,ROS 將使用從您的用戶憑證中生成的臨時憑證。

RAM 角色名稱最大長度為 64 個字符。

test-role
DeletionProtectionstring

是否開啟資源棧刪除保護。取值:

  • Enabled:開啟資源棧刪除保護。
  • Disabled(默認):關閉資源棧刪除保護。此時支持通過控制臺或 API(DeleteStack)釋放資源棧。
說明 嵌套資源棧刪除保護與根資源棧一致。
Enabled
CreateOptionstring

創建選項,用于控制創建資源棧的行為。取值:

  • KeepStackOnCreationComplete(默認值):創建資源棧成功后保留資源棧及資源棧中的資源,占用 ROS 允許創建的資源棧數量限額。

  • AbandonStackOnCreationComplete:創建資源棧成功后刪除資源棧,但保留所有資源,不占用 ROS 允許創建的資源棧數量限額。如果創建資源棧失敗,資源棧會保留。

  • AbandonStackOnCreationRollbackComplete:創建資源棧回滾成功后刪除資源棧,不占用 ROS 允許創建的資源棧數量限額。其他情況則保留資源棧。

  • ManuallyPay:在創建資源棧過程中手動支付包年包月的資源。目前支持手動支付的資源類型包括ALIYUN::ECS::InstanceGroupALIYUN::RDS::DBInstanceALIYUN::SLB::LoadBalancerALIYUN::VPC::EIPALIYUN::VPC::VpnGateway

說明 僅能指定 CreateOption 和 CreateOptions 其中一個參數。
KeepStackOnCreationComplete
CreateOptionsarray

創建選項列表。

string

創建選項,用于控制創建資源棧的行為。取值:

  • KeepStackOnCreationComplete(默認值):創建資源棧成功后保留資源棧及資源棧中的資源,占用 ROS 允許創建的資源棧數量限額。
  • AbandonStackOnCreationComplete:創建資源棧成功后刪除資源棧,但保留所有資源,不占用 ROS 允許創建的資源棧數量限額。如果創建資源棧失敗,資源棧會保留。
  • AbandonStackOnCreationRollbackComplete:創建資源棧回滾成功后刪除資源棧,不占用 ROS 允許創建的資源棧數量限額。其他情況則保留資源棧。
  • ManuallyPay:在創建資源棧過程中手動支付包年包月的資源。目前支持手動支付的資源類型包括ALIYUN::ECS::InstanceGroupALIYUN::RDS::DBInstanceALIYUN::SLB::LoadBalancerALIYUN::VPC::EIPALIYUN::VPC::VpnGateway
說明
  • 僅能指定 CreateOption 和 CreateOptions 其中一個參數。
  • 創建選項不可重復,且 KeepStackOnCreationComplete 與 AbandonStackOnCreationComplete、AbandonStackOnCreationRollbackComplete 兩個選項互斥。
  • N 最大值為 2。
  • KeepStackOnCreationComplete
    TemplateIdstring

    模板 ID。支持共享模板和私有模板。

    說明 您必須且僅能指定 TemplateBody、TemplateURL、TemplateId 或 TemplateScratchId 其中一個參數。
    5ecd1e10-b0e9-4389-a565-e4c15efc****
    TemplateVersionstring

    模板版本。僅在指定 TemplateId 時生效。

    v1
    Parametersarray<object>

    模板中已定義的參數。

    object
    ParameterKeystring

    模板中已定義的參數的名稱。如果未指定參數的名稱和值,則 ROS 將使用模板中指定的默認值。

    N 最大值為 200。
    長度為 1~128 個字符,不能以aliyunacs:開頭,不能包含http://或者https://

    說明 Parameters 為可選參數。如果需要指定 Parameters,則 Parameters.N.ParameterKey 和 Parameters.N.ParameterValue 必須同時指定。
    InstanceId
    ParameterValuestring

    模板中已定義的參數的取值。

    N 最大值為 200。
    長度為 0~128 個字符,不能以aliyunacs:開頭,不能包含http://或者https://

    說明 Parameters 為可選參數。如果需要指定 Parameters,則 Parameters.N.ParameterKey 和 Parameters.N.ParameterValue 必須同時指定。
    i-xxxxxx
    NotificationURLsarray

    接收資源棧事件的回調地址。取值:

    • HTTP POST URL
      每個 URL 最大長度為 1024 個字節。

    • eventbridge
      資源棧狀態變更會通知到事件總線(EventBridge)服務。您可以在事件總線控制臺查看事件信息。

    說明 當前支持華東 1(杭州)、華東 2(上海)、華北 2(北京)、中國(香港)、華北 3(張家口)五個地域。

    N 最大值為 5。資源棧的狀態發生變化時,會進行通知。當資源棧啟用回滾時,CREATE_FAILED(創建失敗)和 UPDATE_FAILED(更新失敗)不會通知,而 CREATE_ROLLBACK(創建失敗回滾)和 ROLLBACK(更新失敗回滾)會進行通知。IN_PROGRESS 狀態不會通知。
    無論資源棧是否定義了 Outputs 都會進行通知。通知內容示例如下:

    {
       "Outputs": [
           {
               "Description": "No description given",
               "OutputKey": "InstanceId",
               "OutputValue": "i-xxx"
           }
       ],
       "StackId": "80bd6b6c-e888-4573-ae3b-93d29113****",
       "StackName": "test-notification-url",
       "Status": "CREATE_COMPLETE"
    }
    
    string

    接收資源棧事件的回調地址。取值:

    • HTTP POST URL
      每個 URL 最大長度為 1024 個字節。

    • eventbridge
      資源棧狀態變更會通知到事件總線(EventBridge)服務。您可以在事件總線控制臺查看事件信息。

    說明 當前支持華東 1(杭州)、華東 2(上海)、華北 2(北京)、中國(香港)、華北 3(張家口)五個地域。

    N 最大值為 5。資源棧的狀態發生變化時,會進行通知。當資源棧啟用回滾時,CREATE_FAILED(創建失敗)和 UPDATE_FAILED(更新失敗)不會通知,而 CREATE_ROLLBACK(創建失敗回滾)和 ROLLBACK(更新失敗回滾)會進行通知。IN_PROGRESS 狀態不會通知。
    無論資源棧是否定義了 Outputs 都會進行通知。通知內容示例如下:

    {
       "Outputs": [
           {
               "Description": "No description given",
               "OutputKey": "InstanceId",
               "OutputValue": "i-xxx"
           }
       ],
       "StackId": "80bd6b6c-e888-4573-ae3b-93d29113****",
       "StackName": "test-notification-url",
       "Status": "CREATE_COMPLETE"
    }
    
    http://example.com/ros-event
    Tagsarray<object>

    資源棧的標簽。

    object
    Keystring

    資源棧的標簽鍵。

    N 的取值范圍為 1~20。

    說明
  • Tags 為可選參數。如果需要指定 Tags,則 Tags.N.Key 必須指定。
  • 此標簽會傳遞到資源棧中每個支持標簽的資源中。更多信息,請參見標簽傳遞
  • usage
    Valuestring

    資源棧的標簽值。

    N 的取值范圍為 1~20。

    說明 此標簽會傳遞到資源棧中每個支持標簽的資源中。更多信息,請參見標簽傳遞
    test
    ResourceGroupIdstring

    資源組 ID。如果不指定該參數,資源棧將加入默認資源組。

    關于資源組的更多信息,請參見什么是資源組

    rg-acfmxazb4ph6aiy****
    Parallelismlong

    資源最大并發數。

    默認為空,用戶可以輸入大于等于零的整數。

    說明
  • 若設置為大于零的整數,則使用該整數;若設置為零或者不設置,對于 ROS 類型資源棧不限制,Terraform 類型資源棧使用 Terraform 默認值(通常為 10)。
  • 若設置了該值,將與資源棧進行關聯,影響資源棧的后續操作,比如更新資源棧。
  • 1
    TemplateScratchIdstring

    資源場景 ID。

    關于如何獲取資源場景 ID,請參見 ListTemplateScratches

    說明 您必須且僅能指定 TemplateBody、TemplateURL、TemplateId 或 TemplateScratchId 其中一個參數。
    ts-aa9c62feab844a6b****
    TemplateScratchRegionIdstring

    資源場景所屬的地域 ID,默認與 RegionId 取值相同。

    您可以調用 DescribeRegions 查看最新的阿里云地域列表。

    cn-hangzhou

    關于公共請求參數的詳情,請參見公共參數

    返回參數

    名稱類型描述示例值
    object
    RequestIdstring

    請求 ID。

    B288A0BE-D927-4888-B0F7-B35EF84B6E6F
    StackIdstring

    資源棧 ID。

    4a6c9851-3b0f-4f5f-b4ca-a14bf691****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
      "StackId": "4a6c9851-3b0f-4f5f-b4ca-a14bf691****"
    }

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    變更時間變更內容概要操作
    2024-01-11API 內部配置變更,不影響調用查看變更詳情
    2023-04-13OpenAPI 入參發生變更查看變更詳情
    錯誤代碼錯誤信息HTTPS 狀態碼描述
    CircularDependencyCircular Dependency Found: {reason}.400模板包含循環引用,reason 為具體原因。
    InvalidSchema{reason}.400模板格式不正確,reason 為具體原因。
    InvalidTemplateAttributeThe Referenced Attribute ({resource} {name}) is incorrect.400模板包含不正確的資源屬性(輸出)引用,resource 為資源名,name 為屬性名。
    InvalidTemplatePropertyTypeThe specified value type of ({resource} {section}) is incorrect.400模板字段中定義的資源屬性類型不正確。resource 為資源名,section 為字段名。
    InvalidTemplateReferenceThe specified reference "{name}" (in {referencer}) is incorrect.400模板包含不正確的引用,name 為引用名,referencer 為引用者。
    InvalidTemplateSectionThe template section is invalid: {section}.400模板包含無效的字段,section 為字段名。
    InvalidTemplateVersionThe template version is invalid: {reason}.400模板版本不正確,reason 為具體原因。
    StackValidationFailed{reason}.400資源棧校驗失敗,reason 為具體原因。
    UnknownUserParameterThe Parameter ({name}) was not defined in template.400傳遞的參數在模板中未定義,name 為參數名。
    UserParameterMissingThe Parameter {name} was not provided.400參數在模板中已定義,但未傳遞值,name 為參數名。
    ActionInProgressStack {name} already has an action ({action}) in progress.409資源棧在變更中,name 為資源棧名稱或 ID,action 為變更操作。
    StackExistsThe Stack ({name}) already exists.409同名資源棧已存在,name 為資源棧名稱。
    TemplateNotFoundThe Template ({ ID }) could not be found.404模板不存在。ID 為模板 ID。
    TemplateNotFoundThe Template { ID } with version { version } could not be found.404模板或指定版本不存在。ID 為模板 ID,version 為模板版本。