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

ValidateTemplate - 驗證將要創建資源棧的模板

通過指定模板地址或模板內容驗證將要創建資源棧的模板。

接口說明

該接口不涉及用戶數據,只對模板進行校驗,無需進行 RAM 鑒權。

本文將提供一個示例,驗證將要創建資源棧的模板,包含模板主體的文件的位置TemplateURLoss://ros/template/demo

調試

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

授權信息

當前API暫無授權信息透出。

請求參數

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

包含模板主體的文件的位置。URL 必須指向位于 HTTP Web 服務器或阿里云 OSS 存儲空間(例如:oss://ros/template/demo、oss://ros/template/demo?RegionId=cn-hangzhou)中的模板,模板最大為 524,288 個字節。

說明 如果 OSS 地域未指定,默認與接口參數 RegionId 相同。

您可以指定 TemplateBody 或 TemplateURL 參數,但不能同時指定。
URL 的最大長度為:1024 個字節。

oss://ros/template/demo
RegionIdstring

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

cn-hangzhou
TemplateBodystring

模板主體的結構。長度為 1~524,288 個字節。
如果長度較大,建議通過 HTTP POST+Body Param 的方式,將參數放在請求體中進行傳遞,避免 URL 過長而導致請求失敗。
您可以指定 TemplateBody 或 TemplateURL 參數,但不能同時指定。

{"ROSTemplateFormatVersion":"2015-09-01"}
ClientTokenstring

保證請求的冪等性。該值由客戶端生成,并且必須是全局唯一的。

長度不超過 64 個字符,可包含英文字母、數字、短劃線(-)和下劃線(_)。

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

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

是否對模板開啟額外校驗。取值:

  • None(默認值):不開啟額外校驗。

  • EnableTerraformValidation:對于 Terraform 類型模板,使用 Terraform CLI 的terraform validate命令開啟額外校驗。

  • EnableFastTerraformValidation:對于 Terraform 類型模板,使用一種類似于 Terraform CLI 的terraform validate命令開啟額外校驗。

說明 EnableFastTerraformValidation 與 EnableTerraformValidation 相比速度較快,但校驗完整性稍有不足。
None
UpdateInfoOptionsarray

更新信息選項列表。列表最大長度為 2。

string

更新信息選項,用于控制資源棧更新的相關信息的生成。取值:

  • Disabled:不生成資源棧更新的相關信息。

  • ConsiderCondition:生成資源棧更新的相關信息時,考慮條件的影響。建議使用該選項。否則,條件會進行計算,計算時涉及的參數的取值為參數的默認值或 null。

  • EnableReplacement:生成資源棧更新的相關信息時,考慮替換更新的影響。

ConsiderCondition

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

返回參數

名稱類型描述示例值
object
Descriptionstring

描述此資源棧模板的相關信息。

No description
Parametersarray<object>

輸入參數列表。

object

輸入參數。
輸入參數中,定義了通過此模板創建資源棧時需要指定的參數,這些參數用來指定每次資源棧創建的細節,例如:用戶名、密碼、環境相關的 ECS 規格等。

[{"Description": "", "Label": "param_integer", "NoEcho": "false", "ParameterKey": "param_integer", "Type": "Number"},{ "Description": "", "Label": "param_float", "NoEcho": "false", "ParameterKey": "param_float", "Type": "Number"}]
RequestIdstring

請求 ID。

B288A0BE-D927-4888-B0F7-B35EF84B6E6F
Outputsarray<object>

模板輸出列表。

object
OutputKeystring

模板輸出名稱。

instance_id
Descriptionstring

模板輸出描述。

The instance ID of my ECS.
Labelstring

模板輸出別名。

Instance ID
ResourceTypesobject

模板中用到的資源類型信息。

Resourcesarray

普通資源類型列表(已去重)。

string

普通資源類型。

ALIYUN::ECS::InstanceGroup
DataSourcesarray

數據源資源類型列表(已去重)。

string

數據源資源類型。

DATASOURCE::VPC::Vpcs
Resourcesarray<object>

模板中定義的普通資源列表。

說明
  • 對于 ROS 模板,資源定義中包含Count字段的資源不會展開。
  • 對于 Terraform 模板,資源定義中包含countfor_each的資源不會展開。
  • object
    ResourceTypestring

    普通資源類型。

    ALIYUN::ECS::InstanceGroup
    ResourcePathstring

    普通資源路徑。通常與資源名稱相同。

    server
    LogicalResourceIdPatternstring

    普通資源邏輯 ID 的字符串匹配模式。

    對于 ROS 模板,存在如下兩種情況:

    • 資源定義中不包含Count字段:假定模板中定義的資源名稱為server,則該字段取值為server,對應的ResourcePathserver。
    • 資源定義中包含Count字段:假定模板中定義的資源名稱為server,則該字段取值為server[*],對應的ResourcePathserver。

    對于 Terraform 模板中的資源和模塊,存在如下兩種情況:

    • 定義中不包含countfor_each:假定名稱為server,則該字段取值為server,對應的ResourcePathserver。
    • 定義中包含countfor_each:假定名稱為server,則該字段取值為server[*],對應的ResourcePathserver。

    Terraform 模板示例如下:

    • 頂層模塊中的資源:
      • server:未使用countfor_each,對應的ResourcePathserver
      • server[*]:使用了countfor_each,對應的ResourcePathserver
    • 子模塊中的資源:
      • app.serverapp模塊未使用countfor_each,server資源未使用countfor_each,對應的ResourcePathapp.server
      • app.server[*]app模塊未使用countfor_eachserver資源使用了countfor_each,對應的ResourcePathapp.server
      • app[*].serverapp模塊使用了countfor_eachserver資源未使用countfor_each,對應的ResourcePathapp.server
      • app[*].server[*]app模塊使用了countfor_each,server資源使用了countfor_each,對應的ResourcePathapp.server
      • app.app_group[*].serverapp模塊未使用countfor_each,app_group模塊使用了countfor_eachapp_group模塊是app模塊的子模塊),server資源未使用countfor_each,對應的ResourcePathapp.app_group.server。
    server
    UpdateInfoobject

    資源棧更新的相關信息。若 UpdateInfoOptions 包含 Disabled,則不返回。

    ParametersAllowedToBeModifiedarray

    允許修改的參數的列表。

    string

    允許修改的參數。更新資源棧時,若模板保持不變,僅修改參數取值不會引發校驗錯誤。

    param1
    ParametersCauseInterruptionIfModifiedarray

    一定會引發資源中斷的參數的列表。

    說明
  • 目前僅支持少量資源類型。
  • 僅適用于更新 ROS 類型資源棧。
  • string

    一定會引發資源中斷的參數。更新資源棧時,若模板保持不變,僅修改參數取值一定會引發資源中斷。

    param1
    ParametersConditionallyAllowedToBeModifiedarray

    可能允許修改的參數的列表。

    string

    可能允許修改的參數。更新資源棧時,若模板保持不變,僅修改參數取值,修改該參數是否引發校驗錯誤,取決于參數的取值。

    param2
    ParametersConditionallyCauseInterruptionIfModifiedarray

    可能會引發資源中斷的參數的列表。

    說明
  • 目前僅支持少量資源類型。
  • 僅適用于更新 ROS 類型資源棧。
  • string

    可能會引發資源中斷的參數。更新資源棧時,若模板保持不變,僅修改參數取值可能會引發資源中斷,取決于參數的取值和資源的更新行為。

    param2
    ParametersNotAllowedToBeModifiedarray

    不允許修改的參數的列表。

    string

    不允許修改的參數。更新資源棧時,若模板保持不變,僅修改參數取值一定會引發校驗錯誤。

    param3
    ParametersUncertainlyAllowedToBeModifiedarray

    不確定是否允許修改的參數的列表。

    string

    不確定是否允許修改的參數。更新資源棧時,若模板保持不變,僅修改參數取值,運行時才能確定修改該參數是否會引發校驗錯誤。

    param4
    ParametersUncertainlyCauseInterruptionIfModifiedarray

    不確定是否會引發資源中斷的參數的列表。

    說明
  • 目前僅支持少量資源類型。
  • 僅適用于更新 ROS 類型資源棧。
  • string

    不確定是否會引發資源中斷的參數。更新資源棧時,若模板保持不變,僅修改參數取值,運行時才能確定該參數是否會引發資源中斷。

    param4
    ParametersCauseReplacementIfModifiedarray

    一定會引發資源替換更新的參數的列表。

    說明
  • 僅在 UpdateInfoOptions 包含 EnableReplacement 時返回。
  • 僅適用于更新 ROS 類型資源棧。
  • string

    一定會引發資源替換更新的參數。更新資源棧時,若模板保持不變,僅修改參數取值一定會引發資源替換更新。

    param5
    ParametersConditionallyCauseReplacementIfModifiedarray

    可能會引發資源替換更新的參數的列表。

    說明
  • 僅在 UpdateInfoOptions 包含 EnableReplacement 時返回。
  • 僅適用于更新 ROS 類型資源棧。
  • string

    可能會引發資源替換更新的參數。更新資源棧時,若模板保持不變,僅修改參數取值可能會引發資源替換更新,取決于參數的取值。

    param6
    ParametersUncertainlyCauseReplacementIfModifiedarray

    不確定是否會引發資源替換更新的參數的列表。

    說明
  • 僅在 UpdateInfoOptions 包含 EnableReplacement 時返回。
  • 僅適用于更新 ROS 類型資源棧。
  • string

    不確定是否會引發資源替換更新的參數。更新資源棧時,若模板保持不變,僅修改參數取值,運行時才能確定該參數是否會引發資源替換更新。

    param7

    示例

    正常返回示例

    JSON格式

    {
      "Description": "No description",
      "Parameters": [
        [
          {
            "Description": "",
            "Label": "param_integer",
            "NoEcho": "false",
            "ParameterKey": "param_integer",
            "Type": "Number"
          },
          {
            "Description": "",
            "Label": "param_float",
            "NoEcho": "false",
            "ParameterKey": "param_float",
            "Type": "Number"
          }
        ]
      ],
      "RequestId": "B288A0BE-D927-4888-B0F7-B35EF84B6E6F",
      "Outputs": [
        {
          "OutputKey": "instance_id",
          "Description": "The instance ID of my ECS.",
          "Label": "Instance ID"
        }
      ],
      "ResourceTypes": {
        "Resources": [
          "ALIYUN::ECS::InstanceGroup"
        ],
        "DataSources": [
          "DATASOURCE::VPC::Vpcs"
        ]
      },
      "Resources": [
        {
          "ResourceType": "ALIYUN::ECS::InstanceGroup",
          "ResourcePath": "server",
          "LogicalResourceIdPattern": "server"
        }
      ],
      "UpdateInfo": {
        "ParametersAllowedToBeModified": [
          "param1"
        ],
        "ParametersCauseInterruptionIfModified": [
          "param1"
        ],
        "ParametersConditionallyAllowedToBeModified": [
          "param2"
        ],
        "ParametersConditionallyCauseInterruptionIfModified": [
          "param2"
        ],
        "ParametersNotAllowedToBeModified": [
          "param3"
        ],
        "ParametersUncertainlyAllowedToBeModified": [
          "param4"
        ],
        "ParametersUncertainlyCauseInterruptionIfModified": [
          "param4"
        ],
        "ParametersCauseReplacementIfModified": [
          "param5"
        ],
        "ParametersConditionallyCauseReplacementIfModified": [
          "param6"
        ],
        "ParametersUncertainlyCauseReplacementIfModified": [
          "param7"
        ]
      }
    }

    錯誤碼

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

    變更歷史

    變更時間變更內容概要操作
    2023-07-27OpenAPI 入參發生變更、OpenAPI 返回結構發生變更查看變更詳情
    2023-03-28API 內部配置變更,不影響調用查看變更詳情
    錯誤代碼錯誤信息HTTP 狀態碼描述
    InvalidTemplate{reason}.400模板不正確,reason 為具體原因。
    IInvalidParameter{reason}.400模板參數不正確,reason 為具體原因。