AWS singlesignon: DeleteUser: adds Revision conditional-delete parameter and ARN identifier support
Summary
Adds an optional Revision request parameter that makes deletion conditional on the current revision of the user (failing with ConflictException on mismatch), documents ARN forms for IdentityStoreId and UserId with updated length constraints and patterns, rewrites the ConflictException reason description, adds GROUP_MEMBERSHIP and RESOURCE_POLICY to the resource-type enum, and updates the example to include Revision.
Security assessment
The Revision parameter is an optimistic-concurrency control that guards against lost updates/race conditions during user deletion, which is a data-integrity hardening measure rather than a fix for a specific vulnerability; the remaining edits are identifier-format and enum documentation. No CVE, credential, or authz change is referenced.
Evidence
+The expected current revision of the user. When you provide this value, the user is deleted only if it matches the current revision of the user in the identity store. If the value doesn't match, the operation fails with a `ConflictException`. If you don't provide this value, the user is deleted regardless of its current revision.
Diff
diff --git a/singlesignon/latest/IdentityStoreAPIReference/API_DeleteUser.md b/singlesignon/latest/IdentityStoreAPIReference/API_DeleteUser.md index 7c09720..81fa3ec 100644 --- a//singlesignon/latest/IdentityStoreAPIReference/API_DeleteUser.md +++ b//singlesignon/latest/IdentityStoreAPIReference/API_DeleteUser.md @@ -17,0 +18 @@ Deletes a user within an identity store given `UserId`. + "Revision": "string", @@ -31,0 +33,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`. + @@ -34 +37 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -36 +39 @@ 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})` @@ -39,0 +43,13 @@ Required: Yes +**Revision ** + + +The expected current revision of the user. When you provide this value, the user is deleted only if it matches the current revision of the user in the identity store. If the value doesn't match, the operation fails with a `ConflictException`. If you don't provide this value, the user is deleted regardless of its current revision. + +Type: String + +Length Constraints: Minimum length of 1. Maximum length of 64. + +Pattern: `[0-9]+` + +Required: No + @@ -44,0 +61,2 @@ The identifier for a user in the identity store. +You can specify the user by ID or by Amazon Resource Name (ARN). For example, user ID `a1b2c3d4-5678-90ab-cdef-EXAMPLE11111` or user ARN `arn:aws:identitystore:::user/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111`. + @@ -47 +65 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -49 +67 @@ 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}` @@ -93 +111 @@ 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. @@ -142 +160 @@ 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. @@ -196 +214,2 @@ This example removes the specified user from the identity store. - "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" + "UserId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", + "Revision": "1699564800000"