DescribeInternetGateways

GET /?Action=DescribeInternetGateways
Description

Describes one or more of your Internet gateways.
An Internet gateway enables your instances launched in a VPC to connect to the Internet. By default, a VPC includes an Internet gateway, and each subnet is public. Every instance launched within a default subnet has a private and a public IP addresses.
You can use the Filter.N parameter to filter the described Internet gateways on the following properties:

  • attachment.state: The current state of the attachment between the Internet gateway and the VPC.

  • attachment.vpc-id: The ID of an attached VPC.

  • internet-gateway-id: The ID of the Internet gateway.

  • tag-key: The key of a tag associated with the resource.

  • tag-value: The value of a tag associated with the resource.

  • tag:XXXX: The value of a tag associated with the resource, where XXXX is the key of the tag.

Note

If you exceed the number of identical requests allowed for a configured time period, the RequestLimitExceeded error message is returned.
Body parameter

Required: false
Name: DescribeInternetGatewaysRequest

Name Description Required Schema Default Example

Filter.N

One or more filters. Example:
osc-cli fcu DescribeInternetGateways \
  --Filter.1.Name "tag:KEYOFTHETAG" \
  --Filter.1.Value.1 "VALUEOFTHETAG"

false

Filter

InternetGatewayId.N

One or more Internet gateways IDs.

false

string
Responses
HTTP Code 200
HTTP Code Description Schema

200

DescribeInternetGatewaysResult

Response 200

Response 200

Name Description Required Schema Default Example

internetGatewaySet.N

Information about one or more Internet gateways.

false

InternetGateway

requestId

The ID of the request.

false

string