AWS singlesignon: Update CreateGroup API reference: ARN support, Revision, error details
Summary
Added support for identity store ARN, new GroupArn and Revision response fields, updated patterns and length constraints, revised conflict error description, and added GROUP_MEMBERSHIP and RESOURCE_POLICY to resource type enum.
Security assessment
The change updates API documentation for CreateGroup, including input/output formats and error descriptions. It does not address a specific vulnerability or document a security feature; the removal of KMS mention in error description is not a security fix.
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_CreateGroup.md b/singlesignon/latest/IdentityStoreAPIReference/API_CreateGroup.md index 2a8660e..679351c 100644 --- a//singlesignon/latest/IdentityStoreAPIReference/API_CreateGroup.md +++ b//singlesignon/latest/IdentityStoreAPIReference/API_CreateGroup.md @@ -58,0 +59,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`. + @@ -61 +63 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -63 +65 @@ 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})` @@ -70,0 +73 @@ Required: Yes + "GroupArn": "**_string_** ", @@ -72 +75,2 @@ Required: Yes - "IdentityStoreId": "**_string_** " + "IdentityStoreId": "**_string_** ", + "Revision": "**_string_** " @@ -80,0 +85,11 @@ The following data is returned in JSON format by the service. +**GroupArn ** + + +The Amazon Resource Name (ARN) of the newly created group in the identity store. For example, `arn:aws:identitystore:::group/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222`. + +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}` + @@ -88 +103 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 47. +Length Constraints: Minimum length of 1. Maximum length of 100. @@ -90 +105 @@ 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}` @@ -99 +114 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -101 +116,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: `(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 group in the identity store. + +Type: String + +Length Constraints: Minimum length of 1. Maximum length of 64. + +Pattern: `[0-9]+` @@ -139 +165 @@ 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. @@ -188 +214 @@ 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. @@ -262,2 +288,4 @@ This example creates a new group called Developers in the specified identity sto - "GroupId": "1a2b3c4d-5e6f-7g8h-9i0j-1k2l3m4n5o6p", - "IdentityStoreId": "d-1234567890" + "IdentityStoreId": "d-1234567890", + "GroupId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", + "GroupArn": "arn:aws:identitystore:::group/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", + "Revision": "1699564800000"