DescribeNetworkInterfaceAttribute
Describes a network interface attribute. 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 attribute of the network interface. This parameter is required.
Type: String
Valid Values:
description | groupSet | sourceDestCheck | attachment | associatePublicIpAddress
Required: No
- 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 isUnauthorizedOperation
.Type: Boolean
Required: No
- NetworkInterfaceId
-
The ID of the network interface.
Type: String
Required: Yes
Response Elements
The following elements are returned by the service.
- associatePublicIpAddress
-
Indicates whether to assign a public IPv4 address to a network interface. This option can be enabled for any network interface but will only apply to the primary network interface (eth0).
Type: Boolean
- attachment
-
The attachment (if any) of the network interface.
Type: NetworkInterfaceAttachment object
- description
-
The description of the network interface.
Type: AttributeValue object
- groupSet
-
The security groups associated with the network interface.
Type: Array of GroupIdentifier objects
- networkInterfaceId
-
The ID of the network interface.
Type: String
- requestId
-
The ID of the request.
Type: String
- sourceDestCheck
-
Indicates whether source/destination checking is enabled.
Type: AttributeBooleanValue object
Errors
For information about the errors that are common to all actions, see Common client error codes.
Examples
Example
This example describes the sourceDestCheck
attribute of the specified network interface.
Sample Request
https://ec2.amazonaws.com/?Action=DescribeNetworkInterfaceAttribute
&NetworkInterfaceId=eni-686ea200
&Attribute=sourceDestCheck
&AUTHPARAMS
Sample Response
<DescribeNetworkInterfaceAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/">
<requestId>7a20c6b2-d71c-45fb-bba7-37306850544b</requestId>
<networkInterfaceId>eni-686ea200</networkInterfaceId>
<sourceDestCheck>
<value>true</value>
</sourceDestCheck>
</DescribeNetworkInterfaceAttributeResponse>
See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following: