GetTerraformPricingMappings - 批量获取Terraform资源询价映射

更新时间:
复制 MD 格式

按 Terraform 资源类型批量获取询价 mapping 目录(供 RunIaC plan 阶段成本预估)

接口说明

获取 Terraform alicloud provider 中 schema 属性 与 OpenAPI 参数之间的映射关系

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求语法

POST /api/v1/price/terraform-mappings HTTP/1.1

请求参数

名称

类型

必填

描述

示例值

body

object

否

请求体:resourceTypes(Terraform 资源类型列表,如 alicloud_instance),单次最多 200 个

{ "resourceTypes": [ "alicloud_instance", "alicloud_vpc" ] }

返回参数

名称

类型

描述

示例值

object

Schema of Response

schemaVersion

string

mapping 目录 schema 版本,当前为 1.0;消费方按此判断兼容性

1.0

mappingVersion

string

mapping 内容版本(数据最近变更时间戳),用于消费方缓存与审计

1786000000000

mappings

array<object>

命中的 mapping 列表:每项含 resourceType 与 pricingTargets(询价目标与参数抽取规则,规则内 $after/$before 引用 Terraform plan 的资源属性)

array<object>

单个资源类型的询价 mapping

resourceType

string

Terraform 资源类型,如 alicloud_instance

alicloud_instance

pricingTargets

array<object>

询价目标列表:每项含 actions(create/update)、popCode/popVersion/apiName、pricingUnit、params(参数抽取规则:from=$after.xxx / const / default / expand)、when/whenChanged 条件

object

单个询价目标:一次询价调用所需的 API 三元组与参数抽取规则

{"actions":["create"],"popCode":"Ecs","popVersion":"2014-05-26","apiName":"RunInstances","params":{"InstanceType":{"from":"$after.instance_type"}}}

missingResourceTypes

array

请求中未注册 mapping 的资源类型;消费方必须按费用未知处理,不得当作免费

string

未注册 mapping 的 Terraform 资源类型,费用未知(不等于免费)

alicloud_brand_new

unsupportedResourceTypes

array

已确认不支持询价的资源类型(如纯免费或无询价面),与 missing 区分

string

已确认无询价面的 Terraform 资源类型,如纯免费资源

alicloud_security_group

requestId

string

Id of the request

1AF0AD89-ED4F-5E9E-8B7B-9A3B27CE9E1B

示例

正常返回示例

JSON格式

{
  "schemaVersion": "1.0",
  "mappingVersion": "1786000000000",
  "mappings": [
    {
      "resourceType": "alicloud_instance",
      "pricingTargets": [
        {
          "actions": [
            "create"
          ],
          "popCode": "Ecs",
          "popVersion": "2014-05-26",
          "apiName": "RunInstances",
          "params": {
            "InstanceType": {
              "from": "$after.instance_type"
            }
          }
        }
      ]
    }
  ],
  "missingResourceTypes": [
    "alicloud_brand_new"
  ],
  "unsupportedResourceTypes": [
    "alicloud_security_group"
  ],
  "requestId": "1AF0AD89-ED4F-5E9E-8B7B-9A3B27CE9E1B"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息,参考变更详情。