全部产品
Search
文档中心

资源编排:获取待导入资源的标识符属性

更新时间:Dec 22, 2023

资源导入时,需要提供资源标识符属性。本文以ALIYUN::VPC::EIP为例,为您介绍如何调用GetResourceTypeTemplate和GetTemplateSummary接口,获取待导入资源的标识符属性。

操作步骤

  1. 登录OpenAPI开发者门户

  2. 调用GetResourceTypeTemplate接口查询ALIYUN::VPC::EIP的模板(TemplateBody)。

    1. 搜索GetResourceTypeTemplate接口。

    2. ResourceType设置为ALIYUN::VPC::EIP,然后单击发起调用

      说明

      更多资源类型,请参见资源类型索引

      调用结果如下:

      {
       "RequestId": "4EE61317-00F7-4DB6-9FBD-E12ECC79805A",
       "TemplateBody": {
        "Parameters": {
         "Description": {
          "Type": "String",
          "Description": "Optional. The description of the EIP. The description must be 2 to 256 characters in length. It must start with a letter. It cannot start with http://  or https://."
         },
         "ResourceGroupId": {
          "Type": "String",
          "Description": "Resource group id."
         },
         "InstanceChargeType": {
          "Type": "String",
          "Description": "The resource charge type. Default value is Postpaid",
          "AllowedValues": [
           "Prepaid",
           "Postpaid"
          ],
          "Default": "Postpaid"
         },
         "PricingCycle": {
          "Type": "String",
          "Description": "Price cycle of the resource. This property has no default value. If ChargeType is specified as Postpaid, this value will be ignore.",
          "AllowedValues": [
           "Month",
           "Year"
          ],
          "Default": "Month"
         },
         "Isp": {
          "Type": "String",
          "Description": "ISP tag for finance cloud region. only for cn-hangzhou and cn-qingdao region), if you are not finance cloud user, this value will be ignore."
         },
         "Period": {
          "Type": "Number",
          "Description": "Prepaid time period. While choose by pay by month, it could be from 1 to 9. While choose pay by year, it could be from 1 to 3.",
          "MinValue": 1,
          "MaxValue": 9,
          "Default": 1
         },
         "DeletionProtection": {
          "Type": "Boolean",
          "Description": "Whether to enable deletion protection.\nDefault to False.",
          "AllowedValues": [
           "True",
           "true",
           "False",
           "false"
          ],
          "Default": false
         },
         "AutoPay": {
          "Type": "Boolean",
          "Description": "Automatic Payment. Default is false.",
          "AllowedValues": [
           "True",
           "true",
           "False",
           "false"
          ],
          "Default": false
         },
         "Name": {
          "Type": "String",
          "Description": "The name of the EIP. The name must be 2 to 128 characters in length. It must start with a letter. It can contain numbers, periods (.), underscores (_), and hyphens (-). It cannot start with http://  or https://"
         },
         "InternetChargeType": {
          "Type": "String",
          "Description": "The network charge type. Support 'PayByBandwidth' and 'PayByTraffic' only. Default is PayByBandwidth. PayByTraffic will charge by hour, PayByBandwidth will charge by day. ",
          "AllowedValues": [
           "PayByBandwidth",
           "PayByTraffic"
          ],
          "Default": "PayByBandwidth"
         },
         "Netmode": {
          "Type": "String",
          "Description": "The network type. Valid value: public (public network)."
         },
         "Bandwidth": {
          "Type": "Number",
          "Description": "Bandwidth for the output network. Default is 5MB.",
          "Default": 5
         },
         "Tags": {
          "Type": "Json",
          "Description": "Tags to attach to eip. Max support 20 tags to add during create eip. Each tag with two properties Key and Value, and Key is required.",
          "MaxLength": 20
         }
        },
        "ROSTemplateFormatVersion": "2015-09-01",
        "Outputs": {
         "AllocationId": {
          "Description": "ID that Aliyun assigns to represent the allocation of the address for use with VPC. Returned only for VPC elastic IP addresses.",
          "Value": {
           "Fn::GetAtt": [
            "ElasticIp",
            "AllocationId"
           ]
          }
         },
         "EipAddress": {
          "Description": "IP address of created EIP.",
          "Value": {
           "Fn::GetAtt": [
            "ElasticIp",
            "EipAddress"
           ]
          }
         },
         "OrderId": {
          "Description": "Order ID of prepaid EIP instance.",
          "Value": {
           "Fn::GetAtt": [
            "ElasticIp",
            "OrderId"
           ]
          }
         }
        },
        "Resources": {
         "ElasticIp": {
          "Type": "ALIYUN::VPC::EIP",
          "Properties": {
           "Description": {
            "Ref": "Description"
           },
           "ResourceGroupId": {
            "Ref": "ResourceGroupId"
           },
           "InstanceChargeType": {
            "Ref": "InstanceChargeType"
           },
           "PricingCycle": {
            "Ref": "PricingCycle"
           },
           "Isp": {
            "Ref": "Isp"
           },
           "Period": {
            "Ref": "Period"
           },
           "DeletionProtection": {
            "Ref": "DeletionProtection"
           },
           "AutoPay": {
            "Ref": "AutoPay"
           },
           "Name": {
            "Ref": "Name"
           },
           "InternetChargeType": {
            "Ref": "InternetChargeType"
           },
           "Netmode": {
            "Ref": "Netmode"
           },
           "Bandwidth": {
            "Ref": "Bandwidth"
           },
           "Tags": {
            "Ref": "Tags"
           }
          }
         }
        }
       }
      }
  3. 调用GetTemplateSummary接口获取模板信息,查询资源导入标识符。

    1. 搜索GetTemplateSummary接口。

    2. 选择RegionId,将TemplateBody设置为从步骤2中获取的ALIYUN::VPC::EIP资源模板中的TemplateBody模板,然后单击发起调用

      调用结果如下:

      {
       "ResourceTypes": [
        "ALIYUN::VPC::EIP"
       ],
       "Description": "No description",
       "Parameters": [
        {
         "NoEcho": "false",
         "Type": "Boolean",
         "Description": "Whether to enable deletion protection.\nDefault to False.",
         "AllowedValues": [
          "True",
          "true",
          "False",
          "false"
         ],
         "Label": "DeletionProtection",
         "Default": false,
         "ParameterKey": "DeletionProtection"
        },
        {
         "NoEcho": "false",
         "Type": "String",
         "Description": "Optional. The description of the EIP. The description must be 2 to 256 characters in length. It must start with a letter. It cannot start with http://  or https://.",
         "Label": "Description",
         "ParameterKey": "Description"
        },
        {
         "NoEcho": "false",
         "Type": "Json",
         "Description": "Tags to attach to eip. Max support 20 tags to add during create eip. Each tag with two properties Key and Value, and Key is required.",
         "Label": "Tags",
         "MaxLength": 20,
         "ParameterKey": "Tags"
        },
        {
         "NoEcho": "false",
         "Type": "String",
         "Description": "ISP tag for finance cloud region. only for cn-hangzhou and cn-qingdao region), if you are not finance cloud user, this value will be ignore.",
         "Label": "Isp",
         "ParameterKey": "Isp"
        },
        {
         "NoEcho": "false",
         "Type": "Number",
         "Description": "Prepaid time period. While choose by pay by month, it could be from 1 to 9. While choose pay by year, it could be from 1 to 3.",
         "Label": "Period",
         "MinValue": 1,
         "MaxValue": 9,
         "Default": 1,
         "ParameterKey": "Period"
        },
        {
         "NoEcho": "false",
         "Type": "String",
         "Description": "Resource group id.",
         "Label": "ResourceGroupId",
         "ParameterKey": "ResourceGroupId"
        },
        {
         "NoEcho": "false",
         "Type": "Boolean",
         "Description": "Automatic Payment. Default is false.",
         "AllowedValues": [
          "True",
          "true",
          "False",
          "false"
         ],
         "Label": "AutoPay",
         "Default": false,
         "ParameterKey": "AutoPay"
        },
        {
         "NoEcho": "false",
         "Type": "String",
         "Description": "The resource charge type. Default value is Postpaid",
         "AllowedValues": [
          "Prepaid",
          "Postpaid"
         ],
         "Label": "InstanceChargeType",
         "Default": "Postpaid",
         "ParameterKey": "InstanceChargeType"
        },
        {
         "NoEcho": "false",
         "Type": "String",
         "Description": "Price cycle of the resource. This property has no default value. If ChargeType is specified as Postpaid, this value will be ignore.",
         "AllowedValues": [
          "Month",
          "Year"
         ],
         "Label": "PricingCycle",
         "Default": "Month",
         "ParameterKey": "PricingCycle"
        },
        {
         "NoEcho": "false",
         "Type": "String",
         "Description": "The network charge type. Support 'PayByBandwidth' and 'PayByTraffic' only. Default is PayByBandwidth. PayByTraffic will charge by hour, PayByBandwidth will charge by day. ",
         "AllowedValues": [
          "PayByBandwidth",
          "PayByTraffic"
         ],
         "Label": "InternetChargeType",
         "Default": "PayByBandwidth",
         "ParameterKey": "InternetChargeType"
        },
        {
         "NoEcho": "false",
         "Type": "Number",
         "Description": "Bandwidth for the output network. Default is 5MB.",
         "Label": "Bandwidth",
         "Default": 5,
         "ParameterKey": "Bandwidth"
        },
        {
         "NoEcho": "false",
         "Type": "String",
         "Description": "The network type. Valid value: public (public network).",
         "Label": "Netmode",
         "ParameterKey": "Netmode"
        },
        {
         "NoEcho": "false",
         "Type": "String",
         "Description": "The name of the EIP. The name must be 2 to 128 characters in length. It must start with a letter. It can contain numbers, periods (.), underscores (_), and hyphens (-). It cannot start with http://  or https://",
         "Label": "Name",
         "ParameterKey": "Name"
        }
       ],
       "RequestId": "2AA4188A-15D8-4BB4-9C26-847ED8315D20",
       "Version": "2015-09-01",
       "Metadata": {},
       "ResourceIdentifierSummaries": [
        {
         "LogicalResourceIds": [
          "ElasticIp"
         ],
         "ResourceType": "ALIYUN::VPC::EIP",
         "ResourceIdentifiers": [
          "AllocationId"
         ]
        }
       ]
      }
    3. 查看ResourceIdentifierSummariesResourceIdentifiers的取值,即为待导入资源的标识符属性。

      例如:本示例中ResourceIdentifiers取值为AllocationId,表示ALIYUN::VPC::EIP资源的标识符属性为弹性公网IP的ID。

相关文档