AWS Security ChangesHomeSearch

AWS singlesignon: Update CreateGroup API reference: ARN support, Revision, error details

Service: singlesignon · 2026-10-01 · Documentation low

File: singlesignon/latest/IdentityStoreAPIReference/API_CreateGroup.md

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"