Menu
Amazon Elastic Compute Cloud
API Reference (API Version 2016-04-01)

ModifyIdFormat

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.

Resource

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

Type: String

Required: Yes

UseLongIds

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.

requestId

The ID of the request.

Type: String

return

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

Type: Boolean

Errors

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

Example

Example

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

Sample Request

https://ec2.amazonaws.com/?Action=ModifyIdFormat
&Resource=instance
&UseLongIds=true
&AUTHPARAMS

Sample Response

<ModifyIdFormatResponse xmlns="http://ec2.amazonaws.com/doc/2016-04-01/">
    <requestId>92c1af09-cb4c-410e-8a96-example</requestId>
    <return>true</return>
</ModifyIdFormatResponse>