CreateNetworkInterfacePermission - Amazon Elastic Compute Cloud

CreateNetworkInterfacePermission

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

You can grant permission to a single AWS 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 AWS account ID.

Type: String

Required: No

AwsService

The AWS 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 AWS SDKs, see the following: