Queries the detailed information of a customer gateway.

Debug

By using API Explorer, you can easily debug APIs, automatically generate SDK code examples, and quickly search for APIs.

Request parameters

Parameter Type Required? Example value Description
Action String Yes DescribeCustomerGateway

The name of this action. Value:

DescribeCustomerGateway
CustomerGatewayId String Yes vpn-bp1q8bgx4xnkm2ogj0fiu

The ID of the customer gateway.
RegionId String Yes cn-shanghai

The ID of the region to which the customer gateway belongs.

To query the region ID, call DescribeRegions.

Response parameters

Parameter Type Example value Description
CustomerGatewayId String cgw-bp1pvpl9r9adju6l5nxck

The ID of the customer gateway.
Name String test

The name of the customer gateway.

Description String test

The description of the customer gateway.

IpAddress String 139.196.32.xxx

The IP address of the customer gateway.
RequestId String 99506ECB-218F-45A5-AE8E-79518451F615

The ID of the request.

CreateTime Long 1492747187000

The time at which the customer gateway was created.

Examples

Request example


https://vpc.aliyuncs.com/?Action=DescribeCustomerGateway
&CustomerGatewayId=vpn-bp1q8bgx4xnkm2ogj0fiu
&RegionId=cn-shanghai
&<CommonParameters>
Response example

  • XML format

    <DescribeCustomerGatewayResponse>
  <Name>test</Name>
  <CustomerGatewayId>cgw-bp1pvpl9r9adju6l5nxck</CustomerGatewayId>
  <CreateTime>1492747187000</CreateTime>
  <RequestId>99506ECB-218F-45A5-AE8E-79518451F615</RequestId>
  <IpAddress>139.196.32.xxx</IpAddress>
</DescribeCustomerGatewayResponse>

  • JSON format

    {
	"Name":"test",
	"CustomerGatewayId":"cgw-bp1pvpl9r9adju6l5nxck",
	"CreateTime":1492747187000,
	"RequestId":"A0457BC9-6C0F-4437-AB9D-FB2EABC1D6A2",
	"IpAddress":"139.196.32.xxx"
}

Error codes

HTTP status code Error code Error message Description
403 Forbbiden.SubUser User not authorized to operate on the specified resource as your account is created by another user. You are not authorized to operate on this resource. Please apply for the permission and try again later.
403 Forbidden User not authorized to operate on the specified resource. You are not authorized to operate on this resource. For more information, open a ticket.
404 InvalidCustomerGatewayInstanceId.NotFound The specified customer gateway instance id does not exist. The specified instance does not exist.

See common error codes