动态与公告

产品动态

产品公告

腾讯云网络总览

产品简介

产品概述

产品优势

应用场景

基本概念

配额限制

购买指南

计费概述

欠费说明

快速入门

网络规划

VPC 连接

快速搭建 IPv4 私有网络

操作指南

网络拓扑

网络性能大盘

私有网络

子网

路由表

弹性公网 IP

高可用虚拟 IP

弹性网卡

共享带宽包

网络连接

安全管理

诊断工具

告警与监控

实践教程

查看单地域按流量计费的总带宽

基础网络迁移至私有网络

安全组变更最佳实践

配置云服务器为公网网关

用 HAVIP+Keepalived 搭建高可用主备集群

通过专线接入和 VPN 连接实现混合云主备冗余通信

通过云联网和 VPN 连接实现混合云主备冗余通信

通过 EIP 实现云服务器访问 Internet

故障处理

无法删除 VPC 或子网

使用云联网打通两个 VPC 后网络不通

同 VPC 下两台云服务器无法 ping 通

API 文档

History

Introduction

API Category

Making API Requests

VPC APIs

Route Table APIs

Elastic Public IP APIs

Elastic IPv6 APIs

Highly Available Virtual IP APIs

ENI APIs

Bandwidth Package APIs

NAT Gateway APIs

Direct Connect Gateway APIs

Cloud Connect Network APIs

Network ACL APIs

Network Parameter Template APIs

Network Detection-Related APIs

Flow Log APIs

Gateway Traffic Monitor APIs

Private Link APIs

Traffic Mirroring APIs

Other APIs

Subnet APIs

VPN Gateway APIs

Security Group APIs

Snapshot Policy APIs

Error Codes

Data Types

常见问题

通用类

连接类

安全类

联系我们

词汇表

InquiryPriceAllocateAddresses

PDF

聚焦模式

字号

最后更新时间： 2025-11-13 20:43:20

1. API Description

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

This API (InquiryPriceAllocateAddresses) is used to query the price of purchasing EIPs.

A maximum of 2 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: InquiryPriceAllocateAddresses.
Version	Yes	String	Common Params. The value used for this API: 2017-03-12.
Region	Yes	String	Common Params. For more information, please see the list of regions supported by the product. This API only supports: ap-bangkok, ap-beijing, ap-chengdu, ap-chongqing, ap-guangzhou, ap-hongkong, ap-jakarta, ap-nanjing, ap-seoul, ap-shanghai, ap-shanghai-fsi, ap-shenzhen-fsi, ap-singapore, ap-tokyo, eu-frankfurt, na-ashburn, na-siliconvalley, sa-saopaulo.
InternetChargeType	Yes	String	EIP billing method. Users with standard account type. Valid values: BANDWIDTH_POSTPAID_BY_HOUR: billed by hourly bandwidth on a pay-as-you-go basis. BANDWIDTH_PREPAID_BY_MONTH: monthly bandwidth subscription. TRAFFIC_POSTPAID_BY_HOUR: billed by hourly traffic on a pay-as-you-go basis. Default value: TRAFFIC_POSTPAID_BY_HOUR.
InternetMaxBandwidthOut	No	Integer	The EIP outbound bandwidth cap, in Mbps. For users with standard account type, the range of optional values depends on the EIP billing method: `BANDWIDTH_POSTPAID_BY_HOUR`: 1 Mbps to 100 Mbps. `BANDWIDTH_PREPAID_BY_MONTH`: 1 Mbps to 200 Mbps `TRAFFIC_POSTPAID_BY_HOUR`: 1 Mbps to 100 Mbps. Default value: 1 Mbps. For users with traditional account type, the EIP outbound bandwidth cap is subject to the public network egress bandwidth limit of the bound instance. No need to pass this parameter.
AddressChargePrepaid	No	AddressChargePrepaid	A required billing parameter for an EIP billed by "BANDWIDTH_PREPAID_BY_MONTH". When the EIP is billed by "BANDWIDTH_PREPAID_BY_MONTH" this parameter is required. For other scenarios, it can be ignored.
AddressType	No	String	EIP type. Default value: EIP. High quality EIP, valid values: HighQualityEIP: high quality EIP Note: High quality EIP is supported only in some regions. High-defense IP, valid values: AntiDDoSEIP: high-defense IP

3. Output Parameters

Parameter Name	Type	Description
Price	InternetPrice	EIP price
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 Inquiring About an Elastic IP Billed by Hourly Traffic

This example shows you how to inquire about an elastic IP billed by hourly traffic.

Input Example

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

{
    "AddressType": "EIP",
    "InternetMaxBandwidthOut": "1",
    "InternetChargeType": "TRAFFIC_POSTPAID_BY_HOUR"
}

Output Example

{
    "Response": {
        "Price": {
            "AddressPrice": {
                "ChargeUnit": "HOUR",
                "UnitPrice": 0.8,
                "DiscountPrice": 0.8
            }
        },
        "RequestId": "90d508a8-9ee8-4220-9c8e-9faeedce3ab4"
    }
}

Example2 Hourly Bandwidth Billing Mode Elastic IP Inquiry

This example shows you how to inquire about an elastic IP billed by hourly bandwidth.

Input Example

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

{
    "AddressType": "EIP",
    "InternetMaxBandwidthOut": "1",
    "InternetChargeType": "BANDWIDTH_POSTPAID_BY_HOUR"
}

Output Example

{
    "Response": {
        "Price": {
            "AddressPrice": {
                "UnitPrice": 0.063,
                "DiscountPrice": 0.063,
                "ChargeUnit": "HOUR"
            }
        },
        "RequestId": "ebc826be-ec1a-4522-b08f-8da3fe5adedc"
    }
}

Example3 Monthly Bandwidth Billing Mode Elastic IP Inquiry

This example shows you how to inquire about Elastic IP in monthly bandwidth billing mode.

Input Example

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

{
    "AddressChargePrepaid": {
        "Period": 1
    },
    "AddressType": "EIP",
    "InternetChargeType": "BANDWIDTH_PREPAID_BY_MONTH",
    "InternetMaxBandwidthOut": 1
}

Output Example

{
    "Response": {
        "Price": {
            "AddressPrice": {
                "OriginalPrice": 20,
                "DiscountPrice": 20
            }
        },
        "RequestId": "136605f0-ca35-4d22-9b77-e053168fa25f"
    }
}

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

Tencent Cloud CLI 3.0

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
FailedOperation.InvalidRegion	Unsupported region.
InvalidAccount.NotSupported	This account is not supported.
InvalidParameterConflict	The two parameters cannot be specified at the same time, nor exist concurrently. EIP can only be bound to the instances or the specified private IPs of the specified ENIs.
InvalidParameterValue.BandwidthOutOfRange	The bandwidth exceeds the limit.
InvalidParameterValue.Combination	Invalid input parameters
InvalidParameterValue.InvalidEgress
InvalidParameterValue.UnavailableZone	This availability zone is unavailable.
InvalidParameterValue.UnsupportedEgress
MissingParameter	Missing parameter.
UnsupportedOperation.ActionNotFound	The port does not exist.
UnsupportedOperation.UnsupportedRegion	The service is not available in this country/region.

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

tencent cloud

私有网络

InquiryPriceAllocateAddresses

1. API Description

2. Input Parameters

3. Output Parameters

4. Example

Example1 Inquiring About an Elastic IP Billed by Hourly Traffic

Input Example

Output Example

Example2 Hourly Bandwidth Billing Mode Elastic IP Inquiry

Input Example

Output Example

Example3 Monthly Bandwidth Billing Mode Elastic IP Inquiry

Input Example

Output Example

5. Developer Resources

SDK

Command Line Interface

6. Error Code

帮助和支持