Menu
Amazon Elastic Compute Cloud
API Reference (API Version 2016-11-15)

DescribeVpcAttribute

Describes the specified attribute of the specified VPC. You can specify only one attribute at a time.

Request Parameters

The following parameters are for this specific action. For more information about required and optional parameters that are common to all actions, see Common Query Parameters.

Attribute

The VPC attribute.

Type: String

Valid Values: enableDnsSupport | enableDnsHostnames

Required: Yes

DryRun

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Type: Boolean

Required: No

VpcId

The ID of the VPC.

Type: String

Required: Yes

Response Elements

The following elements are returned by the service.

enableDnsHostnames

Indicates whether the instances launched in the VPC get DNS hostnames. If this attribute is true, instances in the VPC get DNS hostnames; otherwise, they do not.

Type: AttributeBooleanValue object

enableDnsSupport

Indicates whether DNS resolution is enabled for the VPC. If this attribute is true, the Amazon DNS server resolves DNS hostnames for your instances to their corresponding IP addresses; otherwise, it does not.

Type: AttributeBooleanValue object

requestId

The ID of the request.

Type: String

vpcId

The ID of the VPC.

Type: String

Errors

For information about the errors that are common to all actions, see Common Client Errors.

Examples

Example 1

This example describes the enableDnsSupport attribute of the specified VPC. The sample response indicates that DNS resolution is supported.

Sample Request

https://ec2.amazonaws.com/?Action=DescribeVpcAttribute
&VpcId=vpc-1a2b3c4d
&Attribute=enableDnsSupport
&AUTHPARAMS

Sample Response

<DescribeVpcAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
  <requestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</requestId>
  <vpcId>vpc-1a2b3c4d</vpcId>
  <enableDnsSupport>
    <value>true</value>
  </enableDnsSupport>
</DescribeVpcAttributeResponse>

Example 2

This request describes the enableDnsHostnames attribute of the specified VPC. The sample response indicates that DNS hostnames are supported.

Sample Request

https://ec2.amazonaws.com/?Action=DescribeVpcAttribute
&VpcId=vpc-1a2b3c4d
&Attribute=enableDnsHostnames
&AUTHPARAMS

Sample Response

<DescribeVpcAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
  <requestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</requestId>
  <vpcId>vpc-1a2b3c4d</vpcId>
   <enableDnsHostnames>
    <value>true</value>
   </enableDnsHostnames>
</DescribeVpcAttributeResponse>

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: