如何查询L2节点vip列表？
DescribeL2VipsByDomain
描述
- 按域名查询L2节点vip列表。配置白名单后才可以生效
- 注：支持日峰值带宽为 [backcolor=transparent]1Gbps 以上的用户提工单申请该接口调用权限，立即申请
- 使用场景介绍，请了解：CDN的回源地址有哪些？
请求参数
| 参数 | 类型 | 必须 | 描述 |
| Action | String | 是 | 操作接口名，系统规定参数，取值：DescribeL2VipsByDomain |
| DomainName | String | 是 | 域名，取值范围： 只支持单个域名，需加白名单 |
返回参数
| 名称 | 类型 | 描述 |
| DomainName | String | 域名 |
| Vips | Vip[] | Vip列表 |
特定错误码
| ErrorCode 错误码 | Message 错误信息 | HTTP 返回码 | 语义 |
| MissingParameter | The specified value of parameter “DomainName” can not be empty. | 400 | 参数DomainName不能为空 |
示例
请求示例
https://cdn.aliyuncs.com?Action=DescribeL2VipsByDomain&DomainName=xxxx.com&<公共请求参数>
返回示例
{
"Vips": {
"Vip": [
"1.1.1.1/25",
"2.2.2.2/25"
]
},
"RequestId": "820E7900-5CA9-4AEF-B0DD-20ED5F64BE55",
"DomainName": "xxxx.com"
}
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
The DescribeL2VipsByDomain API is a service provided by Alibaba Cloud Content Delivery Network (CDN) that allows users to query the Layer 2 (L2) node VIP list based on a specified domain name. This feature is particularly useful for managing and monitoring CDN configurations, especially when you need to know the IP addresses (VIPs) used at the L2 nodes for your domain's CDN resources.
Usage Scenarios
This API is helpful in scenarios where you want to: - Monitor CDN Infrastructure: Understand which VIPs are serving your content to ensure proper routing and troubleshoot any delivery issues. - Whitelist Management: If you have specific security policies or firewall rules that require whitelisting of IP addresses, this API helps identify the necessary VIPs to include in your whitelist. - Traffic Analysis and Optimization: Gain insights into your CDN network topology, which can aid in traffic management and optimization strategies.
Prerequisites
Before using this API, note the following: - Permission Application: Users with daily peak bandwidth exceeding 1Gbps must submit a ticket to request access to use this API. - Whitelisting: The domain for which you are querying VIPs must be added to a whitelist before this API call can return valid results.
Request Parameters
- Action: String, required. Set this parameter to
DescribeL2VipsByDomain. - DomainName: String, required. Specify the domain name for which you want to retrieve the L2 VIPs. Only one domain at a time is supported.
Response Parameters
- DomainName: The domain name for which the VIPs were queried.
- Vips.Vip[]: An array containing the VIP list associated with the specified domain.
Error Codes
Specific error codes include: - MissingParameter: The error message "The specified value of parameter 'DomainName' can not be empty." indicates that the DomainName parameter was not provided in the request, resulting in a 400 Bad Request HTTP status code.
Example Request
A sample request URL would look like this:
https://cdn.aliyuncs.com?Action=DescribeL2VipsByDomain&DomainName=yourdomain.com
Replace yourdomain.com with the actual domain name you wish to query.
Remember to authenticate your API requests with appropriate access keys and遵循阿里云API调用的最佳实践，包括签名请求、处理响应等。
