AWS singlesignon: CreateUser: ARN support, Revision/UserArn fields, conflict reasons
Summary
IdentityStoreId and UserId now accept either an ID or an ARN (expanded length limits and regex patterns), the response adds Revision and UserArn fields, the ConflictException reason description is rewritten to cover UNIQUENESS_CONSTRAINT_VIOLATION and CONCURRENT_MODIFICATION, and ResourceType enum values are expanded.
Security assessment
This is an API reference update for a new feature set (ARN-form identifiers plus a Revision value used for optimistic concurrency control). The new Revision/UserArn response fields and the CONCURRENT_MODIFICATION conflict reason improve data-integrity semantics, but nothing here fixes a specific vulnerability, changes authorization, or documents a security control, so it is a low-severity documentation change.
Evidence
+Indicates the reason for the conflict error. `UNIQUENESS_CONSTRAINT_VIOLATION` indicates that the request would violate an existing uniqueness constraint, such as a user name or other unique attribute that is already in use. `CONCURRENT_MODIFICATION` indicates that the resource was modified by another request during this operation.
Diff
diff --git a/singlesignon/latest/IdentityStoreAPIReference/API_CreateUser.md b/singlesignon/latest/IdentityStoreAPIReference/API_CreateUser.md index 3ef0ed6..5806fa1 100644 --- a//singlesignon/latest/IdentityStoreAPIReference/API_CreateUser.md +++ b//singlesignon/latest/IdentityStoreAPIReference/API_CreateUser.md @@ -156,0 +157,2 @@ The globally unique identifier for the identity store. +You can specify the identity store by ID or by Amazon Resource Name (ARN). For example, identity store ID `d-1234567890` or identity store ARN `arn:aws:identitystore::111122223333:identitystore/d-1234567890`. + @@ -159 +161 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -161 +163 @@ Length Constraints: Minimum length of 1. Maximum length of 36. -Pattern: `d-[0-9a-f]{10}$|^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` +Pattern: `(arn:aws[a-z-]*:identitystore::\d{12}:identitystore/)?(d-[0-9a-f]{10}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})` @@ -328,0 +331,2 @@ Required: No + "Revision": "**_string_** ", + "UserArn": "**_string_** ", @@ -345 +349,12 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. + +Pattern: `(arn:aws[a-z-]*:identitystore::\d{12}:identitystore/)?(d-[0-9a-f]{10}|[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})` + +**Revision ** + + +The revision of the newly created user in the identity store. + +Type: String + +Length Constraints: Minimum length of 1. Maximum length of 64. @@ -347 +362,12 @@ Length Constraints: Minimum length of 1. Maximum length of 36. -Pattern: `d-[0-9a-f]{10}$|^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}` +Pattern: `[0-9]+` + +**UserArn ** + + +The Amazon Resource Name (ARN) of the newly created user in the identity store. For example, `arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`. + +Type: String + +Length Constraints: Minimum length of 60. Maximum length of 100. + +Pattern: `arn:aws[a-z-]*:identitystore:::(user|group|membership)/([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}` @@ -356 +382 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -358 +384 @@ Length Constraints: Minimum length of 1. Maximum length of 47. -Pattern: `([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}` +Pattern: `(arn:aws[a-z-]*:identitystore:::(user|group|membership)/)?([0-9a-f]{10}-|)[A-Fa-f0-9]{8}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{4}-[A-Fa-f0-9]{12}` @@ -396 +422 @@ This request cannot be completed for one of the following reasons: -Indicates the reason for a conflict error when the service is unable to access a Customer Managed KMS key. For non-KMS permission errors, this field is not included. +Indicates the reason for the conflict error. `UNIQUENESS_CONSTRAINT_VIOLATION` indicates that the request would violate an existing uniqueness constraint, such as a user name or other unique attribute that is already in use. `CONCURRENT_MODIFICATION` indicates that the resource was modified by another request during this operation. @@ -445 +471 @@ The identifier for a resource in the identity store that can be used as `UserId` -An enum object indicating the type of resource in the identity store service. Valid values include USER, GROUP, and IDENTITY_STORE. +An enum object indicating the type of resource in the identity store service. Valid values include USER, GROUP, GROUP_MEMBERSHIP, RESOURCE_POLICY, and IDENTITY_STORE. @@ -571,0 +598 @@ This example creates a new user in the specified identity store. + "IdentityStoreId": "d-1234567890", @@ -573 +600,2 @@ This example creates a new user in the specified identity store. - "IdentityStoreId": "d-1234567890" + "UserArn": "arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", + "Revision": "1699564800000"