调用ListVpnCertificateAssociations接口查询指定地域下VPN网关实例和SSL证书的绑定关系。

使用说明

在调用ListVpnCertificateAssociations时：

  • 如果您仅指定了RegionId参数的值，则表示您要查询指定地域下所有VPN网关实例和SSL证书的绑定关系。
  • 如果您指定了RegionId和CertificateType参数的值，则表示您要查询指定地域下VPN网关实例与指定证书类型的SSL证书的绑定关系。
  • 如果您指定了RegionId和VpnGatewayId参数的值，则表示您要查询指定地域下指定VPN网关实例与SSL证书的绑定关系。
  • 如果您指定了RegionId和CertificateId参数的值，则表示您要查询指定地域下指定SSL证书与VPN网关实例的绑定关系。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 ListVpnCertificateAssociations

系统规定参数。取值：ListVpnCertificateAssociations。

RegionId String 是 cn-hangzhou

VPN网关所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

CertificateType String 否 Signature

证书类型。取值：

  • Encryption：加密证书。
  • Signature：签名证书。
NextToken String 否 caeba0bbb2be0****

是否拥有下一次查询的令牌（Token）。取值：

  • 第一次查询和没有下一次查询时，均无需填写。
  • 如果有下一次查询，取值为上一次API调用返回的NextToken值。
MaxResults Integer 否 10

分批次查询时每次显示的条目数。取值范围：1~20，默认值：10。

VpnGatewayId.N String 否 vpn-bp1q8bgx4xnkm2ogj****

VPN网关实例ID。

一次最多支持查询20个VPN网关实例与SSL证书的绑定关系。
CertificateId.N String 否 848****

证书ID。

一次最多支持查询20个SSL证书与VPN网关实例的绑定关系。

返回数据

名称 类型 示例值 描述
NextToken String caeba0bbb2be****

是否拥有下一次查询的令牌（Token）。取值：

  • 如果NextToken为空表示没有下一次查询。
  • 如果NextToken有返回值，该取值表示下一次查询开始的令牌。
RequestId String 197AF2BD-547F-470C-B29A-8400400233EB

请求ID。
TotalCount Integer 4

绑定关系总条目数。
MaxResults Integer 10

分批次查询时每次显示的条目数。
VpnCertificateRelations Array of VpnCertificateRelation

绑定关系列表。
VpnGatewayId String vpn-bp1usbiorilk51760****

VPN网关实例ID。
CertificateType String Signature

证书类型。

  • Encryption：加密证书。
  • Signature：签名证书。
CertificateId String 6bfe4218-ea1d****

证书ID。
AssociationTime String 2020-12-29T09:30:29Z

绑定时间。

时间按照ISO8601标准表示，并使用UTC时间。格式为：YYYY-MM-DDThh:mmZ。
RegionId String cn-hangzhou

VPN网关所在地域ID。

示例

请求示例

http(s)://[Endpoint]/?Action=ListVpnCertificateAssociations
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<ListVpnCertificateAssociationsResponse>
    <TotalCount>4</TotalCount>
    <RequestId>197AF2BD-547F-470C-B29A-8400400233EB</RequestId>
    <VpnCertificateRelations>
        <CertificateType>Signature</CertificateType>
        <AssociationTime>2020-12-29T09:30:29Z</AssociationTime>
        <VpnGatewayId>vpn-bp1usbiorilk51760****</VpnGatewayId>
        <CertificateId>848****</CertificateId>
        <RegionId>cn-hangzhou</RegionId>
    </VpnCertificateRelations>
    <VpnCertificateRelations>
        <CertificateType>Encryption</CertificateType>
        <AssociationTime>2020-12-29T09:30:16Z</AssociationTime>
        <VpnGatewayId>vpn-bp1usbiorilk51760****</VpnGatewayId>
        <CertificateId>848****</CertificateId>
        <RegionId>cn-hangzhou</RegionId>
    </VpnCertificateRelations>
    <VpnCertificateRelations>
        <CertificateType>Signature</CertificateType>
        <AssociationTime>2020-12-09T02:36:23Z</AssociationTime>
        <VpnGatewayId>vpn-bp1mrlw7134czer3l****</VpnGatewayId>
        <CertificateId>848****</CertificateId>
        <RegionId>cn-hangzhou</RegionId>
    </VpnCertificateRelations>
    <VpnCertificateRelations>
        <CertificateType>Encryption</CertificateType>
        <AssociationTime>2020-12-09T02:35:50Z</AssociationTime>
        <VpnGatewayId>vpn-bp1mrlw7134czer3l****</VpnGatewayId>
        <CertificateId>848****</CertificateId>
        <RegionId>cn-hangzhou</RegionId>
    </VpnCertificateRelations>
    <MaxResults>10</MaxResults>
</ListVpnCertificateAssociationsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 4,
  "RequestId" : "197AF2BD-547F-470C-B29A-8400400233EB",
  "VpnCertificateRelations" : [ {
    "CertificateType" : "Signature",
    "AssociationTime" : "2020-12-29T09:30:29Z",
    "VpnGatewayId" : "vpn-bp1usbiorilk51760****",
    "CertificateId" : "848****",
    "RegionId" : "cn-hangzhou"
  }, {
    "CertificateType" : "Encryption",
    "AssociationTime" : "2020-12-29T09:30:16Z",
    "VpnGatewayId" : "vpn-bp1usbiorilk51760****",
    "CertificateId" : "848****",
    "RegionId" : "cn-hangzhou"
  }, {
    "CertificateType" : "Signature",
    "AssociationTime" : "2020-12-09T02:36:23Z",
    "VpnGatewayId" : "vpn-bp1mrlw7134czer3l****",
    "CertificateId" : "848****",
    "RegionId" : "cn-hangzhou"
  }, {
    "CertificateType" : "Encryption",
    "AssociationTime" : "2020-12-09T02:35:50Z",
    "VpnGatewayId" : "vpn-bp1mrlw7134czer3l****",
    "CertificateId" : "848****",
    "RegionId" : "cn-hangzhou"
  } ],
  "MaxResults" : 10
}

错误码

HttpCode 错误码 错误信息 描述
403 Forbidden User not authorized to operate on the specified resource. 您没有权限操作指定资源，请申请权限后再操作。

访问错误中心查看更多错误码。