Getting Information About Your Internet Gateways
You can get information about one or more of your Internet gateways, like its attachment state or the Virtual Private Cloud (VPC) it is attached to.
Getting Information About Your Internet Gateways Using Cockpit v1
See VPC User Interface. |
Getting Information About Your Internet Services Using Cockpit v2-beta
See the Internet Services dashboard. |
Getting Information About Your Internet Services Using OSC CLI
See the ReadInternetServices command sample in the documentation of the OUTSCALE API. |
Getting Information About Your Internet Gateways Using AWS CLI
To get information about one or more Internet gateways, use the describe-internet-gateways command following this syntax:
$ aws ec2 describe-internet-gateways \
--profile YOUR_PROFILE \
[--internet-gateway-ids NOT_SPECIFIED] \
--filters "Name=attachment.state,values=available" \
--endpoint https://fcu.eu-west-2.outscale.com
This command contains the following attributes that you need to specify:
-
(optional)
profile
: The named profile you want to use, created when configuring AWS CLI. For more information, see Installing and Configuring AWS CLI. -
(optional)
internet-gateway-ids
: One or more IDs of Internet gateways. -
(optional)
filters
: One or more filters, in the "Name=X,Values=Y" format.You can specify several values for a same filter using the "Name=X,Values=Y, Z" format.
The following filters are available:
-
attachment.state
: The current state of the attachment between the Internet gateway and the VPC (onlyavailable
, if the Internet gateway is attached to a VPC). -
attachment.vpc-id
: The ID of the VPC the Internet gateway is attached to. -
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, whereXXXX
is the key of the tag.To filter a tag whose key is
XXXX
and value isYYYY
, you can therefore use either of the following two formats:-
--filters Name=tag-key,Values=XXXX Name=tag-value,Values=YYYY
-
--filters Name=tag:XXXX,Values=YYYY
-
-
-
endpoint
: The endpoint corresponding to the Region you want to send the request to.
The describe-internet-gateways command returns the following elements:
-
InternetGateways
: Information about one or more Internet gateways. This element contains the following information:-
Tags
: One or more tags associated with the Internet gateway. This element contains the following information:-
Value
: The value of the tag. -
Key
: The key of the tag.
-
-
InternetGatewayId
: The ID of the Internet gateway. -
Attachments
: Information about the attachment to a VPC. This element contains the following information:-
State
: The state of the attachment (onlyavailable
, if the Internet gateway is attached to a VPC). -
VpcId
: The ID of the VPC the Internet gateway is attached to.
-
-
{
"InternetGateways": [
{
"Tags":[
{
"Value": "VPC1",
"Key": "Name"
}
],
"InternetGatewayId": "igw-12345678",
"Attachments": [
{
"State": "available",
"VpcId": "vpc-12345678"
}
]
}
]
}
Related Pages
Corresponding API Methods
-
DescribeInternetGateways (FCU) AWS™ and Amazon Web Services™ are trademarks of Amazon Technologies, Inc or its affiliates in the United States and/or other countries.