tencent cloud

DescribeAllocateConditions

PDF
Modo Foco
Tamanho da Fonte
Última atualização: 2026-04-24 15:08:28

1. API Description

Domain name for API request: billing.intl.tencentcloudapi.com.

This API is used to query the filter conditions of a resource directory.

A maximum of 20 requests can be initiated per second for this API.

We recommend you to use API Explorer
Try it
API Explorer provides a range of capabilities, including online call, signature authentication, SDK code generation, and API quick search. It enables you to view the request, response, and auto-generated examples.

2. Input Parameters

The following request parameter list only provides API request parameters and some common parameters. For the complete common parameter list, see Common Request Parameters.

Parameter Name Required Type Description
Action Yes String Common Params. The value used for this API: DescribeAllocateConditions.
Version Yes String Common Params. The value used for this API: 2018-07-09.
Region No String Common Params. This parameter is not required.
Month No String Bill month, in the format of 2024-02, which is the current month by default if not provided

3. Output Parameters

Parameter Name Type Description
Business Array of BillBusinessLink Product filter list
Product Array of BillProduct Subproduct filter list
Item Array of BillItem Component name filter list
Region Array of BillRegion Region filter list
InstanceType Array of BillInstanceType Instance type filter list
PayMode Array of BillPayMode Billing mode filter list
Project Array of BillProject Project filter list
Tag Array of BillTag Tag filter list
OwnerUin Array of BillOwnerUin User UIN filter list
OperateUin Array of BillOperateUin Operator UIN filter list
ActionType Array of BillActionType Transaction type filter list
RequestId String The unique request ID, generated by the server, will be returned for every request (if the request fails to reach the server for other reasons, the request will not obtain a RequestId). RequestId is required for locating a problem.

4. Example

Example1 Querying Cost Allocation Conditions

This example shows you how to query cost allocation conditions.

Input Example

POST / HTTP/1.1
Host: billing.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: DescribeAllocateConditions
<Common request parameters>

{}

Output Example

{
    "Response": {
        "Business": [
            {
                "BusinessCode": "p_cvm",
                "Children": [
                    {
                        "ProductCode": "sp_cvm_s1",
"ProductCodeName": "Cloud Virtual Machine (CVM)-standard type S1",
                        "Children": [
                            {
                                "ItemCode": "sv_cvm_bandwidth_prepay",
"ItemCodeName": "Bandwidth - Billed by Bandwidth"
                            },
                            {
                                "ItemCode": "sv_cvm_rootdisk_cbspremium",
"ItemCodeName": "Premium Cloud System Disk"
                            },
                            {
                                "ItemCode": "virtual_v_cvm_compute_s1",
"ItemCodeName": "Computing component"
                            },
                            {
                                "ItemCode": "sv_cvm_rootdisk_local",
"ItemCodeName": "Local system disk"
                            }
                        ]
                    },
                    {
                        "ProductCode": "sp_cvm_s2",
"ProductCodeName": "Cloud Virtual Machine (CVM) - Standard S2"
                        "Children": [
                            {
                                "ItemCode": "virtual_v_cvm_compute_s2",
"ItemCodeName": "Computing component"
                            },
                            {
                                "ItemCode": "sv_cvm_rootdisk_local",
"ItemCodeName": "Local system disk"
                            },
                            {
                                "ItemCode": "sv_cvm_rootdisk_cbspremium",
"ItemCodeName": "Premium cloud system disk"
                            },
                            {
                                "ItemCode": "sv_cvm_bandwidth_prepay",
"ItemCodeName": "Bandwidth - Billed by Bandwidth"
                            }
                        ]
                    }
                ],
"BusinessCodeName": "Cloud Virtual Machine (CVM)"
            },
            {
                "BusinessCode": "p_cbs",
                "Children": [
                    {
                        "ProductCode": "sp_cbs_premium",
"ProductCodeName": "High-performance CBS"
                        "Children": [
                            {
                                "ItemCode": "sv_cbs_memspace_premium",
"ItemCodeName": "High-performance CBS - Storage Space"
                            }
                        ]
                    }
                ],
"BusinessCodeName": "CBS"
            },
            {
                "BusinessCode": "p_cos",
                "Children": [
                    {
                        "ProductCode": "sp_cos_pkg_std_new",
"ProductCodeName": "Cloud Object Storage (COS) Standard Storage Capacity Package new"
                        "Children": [
                            {
                                "ItemCode": "sv_cos_pkg_std_new_20",
"ItemCodeName": "COS Standard Storage Capacity Package 20GB new"
                            },
                            {
                                "ItemCode": "sv_cos_pkg_std_new_10",
"ItemCodeName": "COS Standard Storage Capacity Package 10GB new"
                            }
                        ]
                    }
                ],
"BusinessCodeName": "Cloud Object Storage (COS)"
            },
            {
                "BusinessCode": "p_rav",
                "Children": [
                    {
                        "ProductCode": "sp_rav_audio_video",
"ProductCodeName": "Tencent Real-Time Communication (TRTC) - Audio/Video Call"
                        "Children": [
                            {
                                "ItemCode": "sv_rav_audio_video_custom_free",
"ItemCodeName": "Audio/Video Call - Gift Package"
                            },
                            {
                                "ItemCode": "sv_rav_audio_video_assign_formal",
"ItemCodeName": "TRTC - Audio/Video Call - Fixed Package"
                            }
                        ]
                    }
                ],
"BusinessCodeName": "Tencent Real-Time Communication (TRTC)"
            },
            {
                "BusinessCode": "p_cdn",
                "Children": [
                    {
                        "ProductCode": "sp_cdn_cn_flux_package",
"ProductCodeName": "Content Delivery Network (CDN) Traffic Package for China"
                        "Children": [
                            {
                                "ItemCode": "sv_cdn_cn_flux_package",
"ItemCodeName": "Content Delivery Network (CDN) Traffic Package - Traffic"
                            }
                        ]
                    }
                ],
"BusinessCodeName": "Content Delivery Network (CDN)"
            },
            {
                "BusinessCode": "p_ci",
                "Children": [
                    {
                        "ProductCode": "sp_ci_pkg_im_com",
"ProductCodeName": "CI Image Compression Resource Package"
                        "Children": [
                            {
                                "ItemCode": "sv_ci_pkg_im_com_10",
"ItemCodeName": "CI Image Compression Resource Package 100K Times"
                            }
                        ]
                    },
                    {
                        "ProductCode": "sp_ci_pkg_co_re",
"ProductCodeName": "Tencent Cloud Object Storage - Content Recognition Resource Pack",
                        "Children": [
                            {
                                "ItemCode": "sv_ci_pkg_co_re_10",
"ItemCodeName": "Tencent Cloud COS - Content Recognition Resource Pack 100K"
                            }
                        ]
                    }
                ],
"BusinessCodeName": "Cloud Infinite"
            },
            {
                "BusinessCode": "p_redis",
                "Children": [
                    {
                        "ProductCode": "sp_redis_single",
"ProductCodeName": "TencentDB for Redis - Community Edition"
                        "Children": [
                            {
                                "ItemCode": "sv_redis_mem_single",
"ItemCodeName": "TencentDB for Redis - Community Edition - Memory"
                            }
                        ]
                    }
                ],
"BusinessCodeName": "TencentDB for Redis"
            }
        ],
        "OwnerUin": [
            {
                "OwnerUin": "700000384179"
            }
        ],
        "OperateUin": [
            {
                "OperateUin": "700000384179"
            }
        ],
        "Product": [
            {
                "ProductCode": "sp_cvm_s1",
"ProductCodeName": "Cloud Virtual Machine (CVM)-standard type S1"
            },
            {
                "ProductCode": "sp_cbs_premium",
"ProductCodeName": "High-performance CBS"
            },
            {
                "ProductCode": "sp_cos_pkg_std_new",
"ProductCodeName": "Cloud Object Storage (COS) Standard Storage Capacity Package new"
            },
            {
                "ProductCode": "sp_cvm_s2",
"ProductCodeName": "Cloud Virtual Machine (CVM) - Standard S2"
            },
            {
                "ProductCode": "sp_rav_audio_video",
"ProductCodeName": "Tencent Real-Time Communication (TRTC) - Audio/Video Call"
            },
            {
                "ProductCode": "sp_cdn_cn_flux_package",
"ProductCodeName": "Content Delivery Network (CDN) Traffic Package for China"
            },
            {
                "ProductCode": "sp_ci_pkg_im_com",
"ProductCodeName": "CI Image Compression Resource Package"
            },
            {
                "ProductCode": "sp_redis_single",
"ProductCodeName": "TencentDB for Redis - Community Edition"
            },
            {
                "ProductCode": "sp_ci_pkg_co_re",
"ProductCodeName": "Tencent Cloud COS - Content Recognition Resource Pack"
            }
        ],
        "ActionType": [
            {
                "ActionType": "prepay_purchase",
"ActionTypeName": "Monthly Subscription New Purchase"
            },
            {
                "ActionType": "prepay_return",
"ActionTypeName": "Monthly Subscription Refund"
            },
            {
                "ActionType": "prepay_modify",
"ActionTypeName": "Monthly Subscription Configuration Change"
            },
            {
                "ActionType": "prepay_renew",
"ActionTypeName": "Monthly Subscription Renewal"
            }
        ],
        "Item": [
            {
                "ItemCode": "sv_cvm_bandwidth_prepay",
"ItemCodeName": "Bandwidth - Bill by Bandwidth"
            },
            {
                "ItemCode": "sv_cbs_memspace_premium",
"ItemCodeName": "High-performance CBS - Storage Space"
            },
            {
                "ItemCode": "sv_cos_pkg_std_new_20",
"ItemCodeName": "COS Standard Storage Capacity Package 20GB new"
            },
            {
                "ItemCode": "virtual_v_cvm_compute_s2",
"ItemCodeName": "Computing component"
            },
            {
                "ItemCode": "sv_cvm_rootdisk_cbspremium",
"ItemCodeName": "Premium cloud system disk"
            },
            {
                "ItemCode": "sv_rav_audio_video_custom_free",
"ItemCodeName": "Audio/Video Call - Gift Package"
            },
            {
                "ItemCode": "sv_cvm_rootdisk_local",
"ItemCodeName": "Local system disk"
            },
            {
                "ItemCode": "virtual_v_cvm_compute_s1",
"ItemCodeName": "Computing component"
            },
            {
                "ItemCode": "sv_cdn_cn_flux_package",
"ItemCodeName": "Content Delivery Network (CDN) Traffic Package - Traffic"
            },
            {
                "ItemCode": "sv_ci_pkg_im_com_10",
"ItemCodeName": "CI Image Compression Resource Package 100K Times"
            },
            {
                "ItemCode": "sv_redis_mem_single",
"ItemCodeName": "TencentDB for Redis - Community Edition - Memory"
            },
            {
                "ItemCode": "sv_ci_pkg_co_re_10",
"ItemCodeName": "Tencent Cloud COS - Content Recognition Resource Pack 100K Times"
            },
            {
                "ItemCode": "sv_rav_audio_video_assign_formal",
"ItemCodeName": "TRTC - Audio/Video Call - Fixed Package"
            },
            {
                "ItemCode": "sv_cos_pkg_std_new_10",
"ItemCodeName": "COS Standard Storage Capacity Package 10GB new"
            }
        ],
        "InstanceType": [
            {
                "InstanceType": "ri",
"InstanceTypeName": "Reserved Instances"
            },
            {
                "InstanceType": "svp",
"InstanceTypeName": "Savings Plan"
            },
            {
                "InstanceType": "si",
"InstanceTypeName": "Spot Instances"
            },
            {
                "InstanceType": "rp",
"InstanceTypeName": "Resource Package"
            },
            {
                "InstanceType": "capacityReserve",
"InstanceTypeName": "Capacity Reservation"
            }
        ],
        "Region": [
            {
                "RegionId": 0,
"RegionName": "Other"
            },
            {
                "RegionId": 1,
"RegionName": "South China region (Guangzhou)"
            },
            {
                "RegionId": 3,
"RegionName": "North China region (Beijing (Beijing Zone 1, formerly Tianjin))"
            },
            {
                "RegionId": 4,
"RegionName": "East China (Shanghai)"
            },
            {
                "RegionId": 5,
"RegionName": "Hong Kong, Macao, and Taiwan region (Hong Kong (China))"
            },
            {
                "RegionId": 7,
"RegionName": "East China (Shanghai Finance)"
            },
            {
                "RegionId": 8,
"RegionName": "North China region (Beijing)"
            },
            {
                "RegionId": 9,
"RegionName": "Southeast Asia (Singapore)"
            },
            {
                "RegionId": 11,
"RegionName": "South China (Shenzhen Finance)"
            },
            {
                "RegionId": 12,
"RegionName": "South China (Guangzhou OPEN)"
            },
            {
                "RegionId": 15,
"RegionName": "Western United States (Silicon Valley, USA)"
            },
            {
                "RegionId": 16,
"RegionName": "Southwest China (Chengdu)"
            },
            {
                "RegionId": 17,
"RegionName": "Europe (Frankfurt)"
            },
            {
                "RegionId": 18,
"RegionName": "Asia Pacific (Seoul)"
            },
            {
                "RegionId": 19,
"RegionName": "Southwest China (Chongqing)"
            },
            {
                "RegionId": 21,
"RegionName": "Asia Pacific (India)"
            },
            {
                "RegionId": 22,
"RegionName": "US East (Virginia)"
            },
            {
                "RegionId": 23,
"RegionName": "Asia Pacific (Thailand)"
            },
            {
                "RegionId": 24,
"RegionName": "Europe (Northeastern Europe)"
            },
            {
                "RegionId": 25,
"RegionName": "Asia Pacific (Japan)"
            },
            {
                "RegionId": 31,
"RegionName": "East China (Jinan)"
            },
            {
                "RegionId": 32,
"RegionName": "East China (Hangzhou)"
            },
            {
                "RegionId": 33,
"RegionName": "East China (Nanjing)"
            },
            {
                "RegionId": 34,
"RegionName": "East China (Fuzhou)"
            },
            {
                "RegionId": 35,
"RegionName": "Central China (Wuhan)"
            },
            {
                "RegionId": 36,
"RegionName": "North China (Tianjin)"
            },
            {
                "RegionId": 37,
"RegionName": "South China (Shenzhen)"
            },
            {
                "RegionId": 39,
"RegionName": "Hong Kong, Macao, and Taiwan region (Taipei (China))"
            },
            {
                "RegionId": 41,
"RegionName": "Middle East (Dubai)"
            },
            {
                "RegionId": 42,
"RegionName": "Southern United States (Los Angeles)"
            },
            {
                "RegionId": 43,
"RegionName": "South America (São Paulo Internet exchange zone, Brazil)"
            },
            {
                "RegionId": 44,
"RegionName": "Australia (Sydney)"
            },
            {
                "RegionId": 45,
"RegionName": "Central China (Changsha)"
            },
            {
                "RegionId": 46,
"RegionName": "North China (Beijing Finance)"
            },
            {
                "RegionId": 47,
"RegionName": "Other Regions (Other)"
            },
            {
                "RegionId": 53,
"RegionName": "North China (Shijiazhuang)"
            },
            {
                "RegionId": 54,
"RegionName": "South China (Qingyuan)"
            },
            {
                "RegionId": 55,
"RegionName": "East China (Hefei)"
            },
            {
                "RegionId": 56,
"RegionName": "Northeast China (Shenyang)"
            },
            {
                "RegionId": 57,
"RegionName": "Northwest China (Xi'an)"
            },
            {
                "RegionId": 58,
"RegionName": "Northwest China (Northwest)"
            },
            {
                "RegionId": 71,
"RegionName": "Central China (Zhengzhou)"
            },
            {
                "RegionId": 72,
"RegionName": "Southeast Asia (Jakarta)"
            },
            {
                "RegionId": 73,
"RegionName": "South China region (Qingyuan Xinan)"
            },
            {
                "RegionId": 74,
"RegionName": "South America (São Paulo)"
            },
            {
                "RegionId": 76,
"RegionName": "Southwest China (Guiyang)"
            },
            {
                "RegionId": 77,
"RegionName": "South China region (Shenzhen Shenyu Tenpay)"
            },
            {
                "RegionId": 78,
"RegionName": "East China (Shanghai Self-driving Cloud)"
            },
            {
                "RegionId": 79,
"RegionName": "South China (Shenzhen Financial Zone (TCE))"
            },
            {
                "RegionId": 81,
"RegionName": "East China (Shanghai Financial Zone (TCE))"
            },
            {
                "RegionId": 1001,
"RegionName": "Asia Pacific region (Asia Pacific zone 1)"
            },
            {
                "RegionId": 1002,
"RegionName": "Asia Pacific region (Asia Pacific zone 2)"
            },
            {
                "RegionId": 1003,
"RegionName": "Asia Pacific region (Asia Pacific zone 3)"
            },
            {
                "RegionId": 1004,
"RegionName": "Middle East (Middle East)"
            },
            {
                "RegionId": 1005,
"RegionName": "Europe (Europe)"
            },
            {
                "RegionId": 1006,
"RegionName": "North America (North America)"
            },
            {
                "RegionId": 1007,
"RegionName": "South America (South America)"
            },
            {
                "RegionId": 1008,
"RegionName": "Africa (Africa)"
            },
            {
                "RegionId": 1009,
"RegionName": "Chinese Mainland (Chinese Mainland)"
            },
            {
                "RegionId": 1010,
"RegionName": "Custom Zone (Custom Zone)"
            },
            {
                "RegionId": 2009,
"RegionName": "Domestic (Universal in the Chinese Mainland)"
            },
            {
                "RegionId": 2010,
"RegionName": "Overseas (Universal for Hong Kong (China), Macao (China), Taiwan (China), and Overseas)"
            }
        ],
        "PayMode": [
            {
                "PayMode": "prePay",
"PayModeName": "Monthly Subscription"
            },
            {
                "PayMode": "postPay",
"PayModeName": "Pay-as-you-go"
            },
            {
                "PayMode": "riPay",
"PayModeName": "Reserved Instances"
            }
        ],
        "Project": [
            {
                "ProjectId": 0,
"ProjectName": "Default Project"
            }
        ],
        "Tag": [
            {
                "TagKey": "yzd_key2",
                "TagValue": "yzd_value2"
            },
            {
                "TagKey": "key1",
                "TagValue": "value1"
            },
            {
                "TagKey": "key2",
                "TagValue": "value2"
            },
            {
                "TagKey": "key3",
                "TagValue": "value3"
            },
            {
                "TagKey": "yzd_key1",
                "TagValue": "yzd_value2"
            }
        ],
        "RequestId": "da214fee-dcee-4b23-96b7-8dcd6cab1345"
    }
}

5. Developer Resources

SDK

TencentCloud API 3.0 integrates SDKs that support various programming languages to make it easier for you to call APIs.

Command Line Interface

6. Error Code

The following only lists the error codes related to the API business logic. For other error codes, see Common Error Codes.

Error Code Description
AuthFailure CAM signature/authentication error.
AuthFailure.UnauthorizedOperation No permission.
InternalError Internal error.
InvalidParameter Invalid parameter.
InvalidParameterValue Invalid parameter value.
MissingParameter Parameters are missing

Ajuda e Suporte

Esta página foi útil?

comentários