AWS singlesignon: ListGroups: identity store ID accepts ARN and enum updates
Summary
Updates the ListGroups API reference to allow IdentityStoreId as an ID or ARN, expands length/pattern constraints, adds GROUP_MEMBERSHIP and RESOURCE_POLICY enum values, and refreshes pagination wording and examples.
Security assessment
The change is API reference documentation for parameter formats, pagination wording, enum values, and examples. It does not describe or fix a specific vulnerability, credential handling, authorization boundary, or security best practice.
Evidence
+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`.
Diff
diff --git a/singlesignon/latest/IdentityStoreAPIReference/API_ListGroups.md b/singlesignon/latest/IdentityStoreAPIReference/API_ListGroups.md index 8a498dd..96e8041 100644 --- a//singlesignon/latest/IdentityStoreAPIReference/API_ListGroups.md +++ b//singlesignon/latest/IdentityStoreAPIReference/API_ListGroups.md @@ -55,0 +56,2 @@ The globally unique identifier for the identity store, such as `d-1234567890`. I +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`. + @@ -58 +60 @@ Type: String -Length Constraints: Minimum length of 1. Maximum length of 36. +Length Constraints: Minimum length of 1. Maximum length of 93. @@ -60 +62 @@ 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})` @@ -67 +69 @@ Required: Yes -The maximum number of results to be returned per request. This parameter is used in the ` ListUsers` and `ListGroups` requests to specify how many results to return in one page. The length limit is 50 characters. +The maximum number of results to be returned per request. This parameter is used in all `List` requests to specify how many results to return in one page. @@ -78 +80 @@ Required: No -The pagination token used for the `ListUsers` and `ListGroups` API operations. This value is generated by the identity store service. It is returned in the API response if the total results are more than the size of one page. This token is also returned when it is used in the API request to search for the next page. +The pagination token used for the `ListUsers` and `ListGroups` API operations. This value is generated by the identity store service. It is returned in the API response if the total results are more than the size of one page. This token is also returned when it is used in the API request to retrieve the next page of results. @@ -103,0 +106 @@ Required: No + "[GroupArn](./API_Group.html#singlesignon-Type-Group-GroupArn)": "**_string_** ", @@ -105,0 +109 @@ Required: No + "[Revision](./API_Group.html#singlesignon-Type-Group-Revision)": "**_string_** ", @@ -129 +133 @@ Type: Array of [Group](./API_Group.html) objects -The pagination token used for the `ListUsers` and `ListGroups` API operations. This value is generated by the identity store service. It is returned in the API response if the total results are more than the size of one page. This token is also returned when it is used in the API request to search for the next page. +The pagination token used for the `ListUsers` and `ListGroups` API operations. This value is generated by the identity store service. It is returned in the API response if the total results are more than the size of one page. This token is also returned when it is used in the API request to retrieve the next page of results. @@ -198 +202 @@ 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. @@ -253 +257 @@ This example lists the two groups in the specified identity store. - "NextToken": "", + "NextToken": "" @@ -262,0 +267 @@ This example lists the two groups in the specified identity store. + "IdentityStoreId": "d-1234567890", @@ -263,0 +269 @@ This example lists the two groups in the specified identity store. + "GroupArn": "arn:aws:identitystore:::group/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", @@ -266 +272 @@ This example lists the two groups in the specified identity store. - "IdentityStoreId": "d-1234567890" + "Revision": "1699564800000" @@ -269 +275,3 @@ This example lists the two groups in the specified identity store. - "GroupId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", + "IdentityStoreId": "d-1234567890", + "GroupId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE55555", + "GroupArn": "arn:aws:identitystore:::group/a1b2c3d4-5678-90ab-cdef-EXAMPLE55555", @@ -272 +280 @@ This example lists the two groups in the specified identity store. - "IdentityStoreId": "d-1234567890" + "Revision": "1699564800000" @@ -312 +320 @@ ListGroupMembershipsForMember -ListUsers +ListIdentityStores