按 Terraform 资源类型批量获取询价 mapping 目录(供 RunIaC plan 阶段成本预估)
接口说明
获取 Terraform alicloud provider 中 schema 属性 与 OpenAPI 参数之间的映射关系
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求语法
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"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。