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


Modifies the ID format for the specified resource on a per-region basis. You can specify that resources should receive longer IDs (17-character IDs) when they are created. The following resource types support longer IDs: instance | reservation | snapshot | volume.

This setting applies to the IAM user who makes the request; it does not apply to the entire AWS account. By default, an IAM user defaults to the same settings as the root user. If you're using this action as the root user, then these settings apply to the entire account, unless an IAM user explicitly overrides these settings for themselves. For more information, see Resource IDs in the Amazon Elastic Compute Cloud User Guide.

Resources created with longer IDs are visible to all IAM roles and users, regardless of these settings and provided that they have permission to use the relevant Describe command for the resource type.

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.


The type of resource: instance | reservation | snapshot | volume

Type: String

Required: Yes


Indicate whether the resource should use longer IDs (17-character IDs).

Type: Boolean

Required: Yes

Response Elements

The following elements are returned by the service.


The ID of the request.

Type: String


Is true if the request succeeds, and an error otherwise.

Type: Boolean


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



This example sets the UseLongIds parameter to true for instances, so that instances you launch receive longer IDs.

Sample Request &Resource=instance &UseLongIds=true &AUTHPARAMS

Sample Response

<ModifyIdFormatResponse xmlns=""> <requestId>92c1af09-cb4c-410e-8a96-example</requestId> <return>true</return> </ModifyIdFormatResponse>

See Also

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