调用ListVpnCertificateAssociations接口查询指定地域下VPN网关实例和证书的绑定关系。
接口说明
在调用 ListVpnCertificateAssociations 时:
- 如果您仅指定了 RegionId 参数的值,则表示您要查询指定地域下所有 VPN 网关实例和 SSL 证书的绑定关系。
- 如果您指定了 RegionId 和 CertificateType 参数的值,则表示您要查询指定地域下 VPN 网关实例与指定证书类型的 SSL 证书的绑定关系。
- 如果您指定了 RegionId 和 VpnGatewayId 参数的值,则表示您要查询指定地域下指定 VPN 网关实例与 SSL 证书的绑定关系。
- 如果您指定了 RegionId 和 CertificateId 参数的值,则表示您要查询指定地域下指定 SSL 证书与 VPN 网关实例的绑定关系。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
授权信息
当前API暂无授权信息透出。
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | VPN 网关所在的地域 ID。 您可以通过调用 DescribeRegions 接口获取地域 ID。 | cn-hangzhou |
CertificateType | string | 否 | 证书类型。取值:
| Signature |
NextToken | string | 否 | 是否拥有下一次查询的令牌(Token)。取值:
| caeba0bbb2be0**** |
MaxResults | integer | 否 | 分批次查询时每次显示的条目数。取值范围:1~20,默认值:10。 | 10 |
VpnGatewayId | array | 否 | VPN 网关实例 ID 列表。 一次最多支持查询 20 个 VPN 网关实例与 SSL 证书的绑定关系。 | |
string | 否 | VPN 网关实例 ID。 一次最多支持查询 20 个 VPN 网关实例与 SSL 证书的绑定关系。 | vpn-bp1q8bgx4xnkm2ogj**** | |
CertificateId | array | 否 | 证书 ID 列表。 一次最多支持查询 20 个 SSL 证书与 VPN 网关实例的绑定关系。 | |
string | 否 | 证书 ID。 一次最多支持查询 20 个 SSL 证书与 VPN 网关实例的绑定关系。 | 848**** |
返回参数
示例
正常返回示例
JSON
格式
{
"NextToken": "caeba0bbb2be****",
"RequestId": "197AF2BD-547F-470C-B29A-8400400233EB",
"TotalCount": 4,
"MaxResults": 10,
"VpnCertificateRelations": [
{
"VpnGatewayId": "vpn-bp1usbiorilk51760****",
"CertificateType": "Signature",
"CertificateId": "6bfe4218-ea1d****",
"AssociationTime": "2020-12-29T09:30:29Z",
"RegionId": "cn-hangzhou"
}
]
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IllegalParam.NextToken | The specified next token (%s) is invalid. | - |
403 | Forbidden | User not authorized to operate on the specified resource. | 您没有权限操作指定资源,请申请权限后再操作。 |
访问错误中心查看更多错误码。