CreateNetworkInterfacePermission - Amazon Elastic Compute Cloud
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

CreateNetworkInterfacePermission

Grants an Amazon-authorized account permission to attach the specified network interface to an instance in their account.

You can grant permission to a single Amazon Web Services account only, and only one account 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.

AwsAccountId

The Amazon Web Services account ID.

Type: String

Required: No

AwsService

The Amazon service. Currently not supported.

Type: String

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 is UnauthorizedOperation.

Type: Boolean

Required: No

NetworkInterfaceId

The ID of the network interface.

Type: String

Required: Yes

Permission

The type of permission to grant.

Type: String

Valid Values: INSTANCE-ATTACH | EIP-ASSOCIATE

Required: Yes

Response Elements

The following elements are returned by the service.

interfacePermission

Information about the permission for the network interface.

Type: NetworkInterfacePermission object

requestId

The ID of the request.

Type: String

Errors

For information about the errors that are common to all actions, see Common client error codes.

Examples

Example 1

This example grants permission to account 123456789012 to attach network interface eni-1a2b3c4d to an instance.

Sample Request

https://ec2.amazonaws.com/?Action=CreateNetworkInterfacePermission &NetworkInterfaceId=eni-1a2b3c4d &AwsAccountId=123456789012 &Permission=INSTANCE-ATTACH &AUTHPARAMS

Sample Response

<CreateNetworkInterfacePermissionResponse xmlns="http://ec2.amazonaws.com/doc/2016-11-15/"> <requestId>e9633d41-093e-4944-981b-ca7example</requestId> <interfacePermission> <awsAccountId>123456789012</awsAccountId> <networkInterfaceId>eni-1a2b3c4d</networkInterfaceId> <networkInterfacePermissionId>eni-perm-06fd19020ede149ea</networkInterfacePermissionId> <permission>INSTANCE-ATTACH</permission> <permissionState> <state>GRANTED</state> </permissionState> </interfacePermission> </CreateNetworkInterfacePermissionResponse>

See Also

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