包周期桌面池切换镜像批量询价
功能介绍
包周期桌面池切换镜像(由不收费镜像变更至收费镜像)批量询价。
调试
您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。
URI
POST /v2/{project_id}/desktop-pool/periodic/inquiry/change-image
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
否 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
Content-Type |
否 |
String |
发送的实体的MIME类型。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
desktop_pool_id |
否 |
String |
桌面池ID。当desktop_pool_id与desktop_ids同时存在时,取desktop_ids的值,两者不可同时为空。 |
desktop_ids |
否 |
Array of strings |
包周期桌面ID列表。 不可同时存在普通桌面和池桌面ID。 |
promotion_plan_id |
否 |
String |
促销计划ID。 |
image_spec_code |
否 |
String |
云市场镜像的specCode,即将停用。image_spec_code与image_id同时存在时取image_id的值,两者不可同时为空。 |
image_id |
否 |
String |
云市场镜像ID,建议使用image_id。 |
响应参数
状态码: 200
参数 |
参数类型 |
描述 |
---|---|---|
currency |
String |
币种,比如CNY。 |
cloud_service_rating_results |
Array of CloudServiceRatingResult objects |
询价结果。 |
参数 |
参数类型 |
描述 |
---|---|---|
order_request_id |
String |
下单请求体中的orderRequestId。 |
official_website_rating_result |
OfficialWebsiteRatingResult object |
结果。 |
optional_discount_rating_results |
Array of OptionalDiscountRatingResult objects |
优惠询价结果。 |
参数 |
参数类型 |
描述 |
---|---|---|
amount |
Number |
订单总额,即最终优惠后的订单金额(预留实例只包含预付部分)。 |
official_website_amount |
Number |
官网价(预留实例只包含预付部分)。 |
original_amount |
Number |
订单原总额,即优惠前订单总额(预留实例只包含预付部分)。 |
official_website_discount_amount |
Number |
官网价优惠额(预留实例只包含预付部分)。 |
optional_discount_amount |
Number |
可选折扣优惠额(预留实例只包含预付部分)。 |
discount_amount |
Number |
总优惠额(预留实例只包含预付部分)。 |
per_amount |
Number |
总分期金额(批量询价的商品分期周期类型一致,才会有总分期金额,分期周期类型不一致,该信息没有)。 |
per_discount_amount |
Number |
总分期金额的优惠额(perDiscountAmount = perOriginalAmount - perAmount)。 |
per_original_amount |
Number |
总分期金额原价。 |
per_period_type |
Integer |
分期周期类型 2:月 4:小时。 |
measure_id |
Integer |
度量单位。 |
product_rating_results |
Array of ProductResult objects |
产品询价结果。 |
参数 |
参数类型 |
描述 |
---|---|---|
discount_id |
String |
折扣优惠Id。 |
amount |
Number |
订单总额,即最终优惠后的订单金额(预留实例只包含预付部分)。 |
official_website_amount |
Number |
官网价(预留实例只包含预付部分)。 |
original_amount |
Number |
订单原总额,即优惠前订单总额(预留实例只包含预付部分)。 |
official_website_discount_amount |
Number |
官网价优惠额(预留实例只包含预付部分)。 |
optional_discount_amount |
Number |
可选折扣优惠额(预留实例只包含预付部分)。 |
discount_amount |
Number |
总优惠额(预留实例只包含预付部分)。 |
per_amount |
Number |
总分期金额(批量询价的商品分期周期类型一致,才会有总分期金额,分期周期类型不一致,该信息没有)。 |
per_discount_amount |
Number |
总分期金额的优惠额(perDiscountAmount = perOriginalAmount - perAmount)。 |
per_original_amount |
Number |
总分期金额原价。 |
per_official_website_amount |
Number |
总分期金额的官网价(批量询价的商品分期周期类型一致,才会有总分期金额的官网价,分期周期类型不一致,该信息没有)。 |
per_official_website_discount_amount |
Number |
总分期金额的官网价官网价优惠额,即: perOfficialWebsiteDiscountAmount =perOriginalAmount-perOfficialWebsiteAmount (批量询价的商品分期周期类型一致,才会有总分期金额的官网价,分期周期类型不一致,该信息没有)。 |
per_optional_discount_amount |
Number |
总分期金额的可选折扣优惠额,如商务折扣、伙伴折扣、促销折扣和折扣券选用时的优惠额 perOptionalDiscountAmount= perOfficialWebsiteAmount- perAmount (批量询价的商品分期周期类型一致,才会有总分期金额的官网价,分期周期类型不一致,该信息没有)。 |
per_period_type |
Integer |
分期周期类型 2:月 4:小时。 |
measure_id |
Integer |
度量单位。 |
discount_type |
Integer |
折扣优惠类型。 |
discount_name |
String |
折扣名称。 |
best_offer |
Integer |
是否为最优折扣0:不是最优折扣;为缺省值。1:是最优折扣;最优折扣:在商务折扣、伙伴折扣和促销折扣中选择(优惠金额相等则按此顺序排优先级),折扣券不参与最优折扣的计算。 |
same_ratio_flag |
Integer |
sameRatioFlag。 |
discount_ratio |
Number |
sameRatioFlag为1时有值,表示该折扣的折扣率。 |
promotion_info |
String |
折扣优惠基本信息;调用者在确定好折扣优惠后、下单时,使用此字段值,填入到订购/变更接口中的promotionInfo字段。 |
product_rating_results |
Array of ProductResult objects |
产品询价结果。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
对应请求体中的ID。 |
product_id |
String |
产品ID。 |
amount |
Number |
总额,即最终优惠后的金额(预留实例只包含预付部分)。 |
discount_amount |
Number |
优惠额(预留实例只包含预付部分)。 |
original_amount |
Number |
原总额,即优惠前总额(预留实例只包含预付部分)。 |
official_website_amount |
Number |
官网价(非所有接口有该字段)(预留实例只包含预付部分)。 |
official_website_discount_amount |
Number |
官网价优惠额(非所有接口有该字段)(预留实例只包含预付部分)。 |
optional_discount_amount |
Number |
可选折扣优惠额(预留实例只包含预付部分),如商务折扣、伙伴折扣、促销折扣和折扣券选用时的优惠额(非所有接口有该字段)。 |
per_amount |
Number |
总分期金额(批量询价的商品分期周期类型一致,才会有总分期金额,分期周期类型不一致,该信息没有)。 |
per_discount_amount |
Number |
总分期金额的优惠额(perDiscountAmount = perOriginalAmount - perAmount)。 |
per_original_amount |
Number |
总分期金额原价。 |
per_official_website_amount |
Number |
分期金额的官网价。 |
per_official_website_discount_amount |
Number |
分期金额的官网价官网价优惠额,即:perOfficialWebsiteDiscountAmount =perOriginalAmount-perOfficialWebsiteAmount。 |
per_optional_discount_amount |
Number |
分期金额的可选折扣优惠额,如商务折扣、伙伴折扣、促销折扣和折扣券选用时的优惠额 perOptionalDiscountAmount= perOfficialWebsiteAmount- perAmount。 |
per_period_type |
Integer |
分期周期类型 2:月 4:小时。 |
measure_id |
Integer |
度量单位。 |
extend_params |
String |
扩展参数。 |
状态码: 400
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
状态码: 409
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
状态码: 500
参数 |
参数类型 |
描述 |
---|---|---|
error_code |
String |
错误码,失败时返回。 |
error_msg |
String |
错误描述。 |
encoded_authorization_message |
String |
加密后的详细拒绝原因,用户可以自行调用STS服务的decode-authorization-message接口进行解密。 |
请求示例
{ "desktop_pool_id" : "string", "desktop_ids" : [ "string" ], "promotion_plan_id" : "string", "image_spec_code" : "string", "image_id" : "string" }
响应示例
状态码: 200
包周期桌面池批量询价响应体。
{ "currency" : "string", "cloud_service_rating_results" : [ { "order_request_id" : "string", "official_website_rating_result" : { "amount" : 0, "official_website_amount" : 0, "original_amount" : 0, "official_website_discount_amount" : 0, "optional_discount_amount" : 0, "discount_amount" : 0, "per_amount" : 0, "per_discount_amount" : 0, "per_original_amount" : 0, "per_period_type" : 0, "measure_id" : 0, "product_rating_results" : [ { "id" : "string", "product_id" : "string", "amount" : 0, "discount_amount" : 0, "original_amount" : 0, "official_website_amount" : 0, "official_website_discount_amount" : 0, "optional_discount_amount" : 0, "per_amount" : 0, "per_discount_amount" : 0, "per_original_amount" : 0, "per_official_website_amount" : 0, "per_official_website_discount_amount" : 0, "per_optional_discount_amount" : 0, "per_period_type" : 0, "measure_id" : 0, "extend_params" : "string" } ] }, "optional_discount_rating_results" : [ { "discount_id" : "string", "amount" : 0, "official_website_amount" : 0, "original_amount" : 0, "official_website_discount_amount" : 0, "optional_discount_amount" : 0, "discount_amount" : 0, "per_amount" : 0, "per_discount_amount" : 0, "per_original_amount" : 0, "per_official_website_amount" : 0, "per_official_website_discount_amount" : 0, "per_optional_discount_amount" : 0, "per_period_type" : 0, "measure_id" : 0, "discount_type" : 0, "discount_name" : "string", "best_offer" : 0, "same_ratio_flag" : 0, "discount_ratio" : 0, "promotion_info" : "string", "product_rating_results" : [ { "id" : "string", "product_id" : "string", "amount" : 0, "discount_amount" : 0, "original_amount" : 0, "official_website_amount" : 0, "official_website_discount_amount" : 0, "optional_discount_amount" : 0, "per_amount" : 0, "per_discount_amount" : 0, "per_original_amount" : 0, "per_official_website_amount" : 0, "per_official_website_discount_amount" : 0, "per_optional_discount_amount" : 0, "per_period_type" : 0, "measure_id" : 0, "extend_params" : "string" } ] } ] } ] }
状态码
状态码 |
描述 |
---|---|
200 |
包周期桌面池批量询价响应体。 |
400 |
由于包含语法错误,当前请求无法被服务器理解。 |
409 |
操作冲突。 |
500 |
服务器内部错误。 |
错误码
请参见错误码。