DescribeSubnets

GET /?Action=DescribeSubnets
Description

Describes one or more of your subnets.
If you do not specify any subnet ID, this action describes all of your subnets.
You can use the Filter.N parameter to filter the subnets on the following properties:

  • subnet-id: The ID of the subnet.

  • vpc-id: The ID of the VPC in which the subnet is.

  • state: The state of the subnet (pending | available).

  • cidr: The exact CIDR block of the subnet (similar to cidr-block).

  • cidr-block: The exact CIDR block of the subnet (similar to cidr).

  • available-ip-address-count: The number of available IP addresses in the subnet.

  • availability-zone: The Availability Zone in which the subnets are located.

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: DescribeSubnetsRequest

Name Description Required Schema Default Example

Filter.N

One or more filters.

false

Filter

SubnetId.N

One or more subnet IDs.

false

string
Responses
HTTP Code 200
HTTP Code Description Schema

200

DescribeSubnetsResult

Response 200

Response 200

Name Description Required Schema Default Example

requestId

The ID of the request.

false

string

subnetSet.N

Information about one or more of your subnets.

false

Subnet