Menu
Amazon Elastic Compute Cloud
API Reference (API Version 2015-10-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 or as an IAM role that has permission to use this action, then these settings apply to the entire account, unless an IAM user explicitly overrides these settings for themselves. For more information, see Controlling Access to Longer ID Settings in the Amazon Elastic Compute Cloud User Guide.

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

Request Parameters

For information about the common parameters that all actions use, see Common Query Parameters.

Resource

The type of resource.

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.

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.

Examples

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/2015-10-01/">
    <requestId>92c1af09-cb4c-410e-8a96-example</requestId>
    <return>true</return>
</ModifyIdFormatResponse>