IdentitystoreClient

The Identity Store service used by IAM Identity Center provides a single place to retrieve all of your identities (users and groups). For more information, see the IAM Identity Center User Guide.

This reference guide describes the identity store operations that you can call programmatically and includes detailed information about data types and errors.

IAM Identity Center uses the sso and identitystore API namespaces.

Properties

Link copied to clipboard
abstract override val config: IdentitystoreClient.Config

IdentitystoreClient's configuration

Functions

Link copied to clipboard
abstract suspend fun createGroup(input: CreateGroupRequest): CreateGroupResponse

Creates a group within the specified identity store.

Link copied to clipboard

Creates a relationship between a member and a group. The following identifiers must be specified: GroupId, IdentityStoreId, and MemberId.

Link copied to clipboard
abstract suspend fun createUser(input: CreateUserRequest): CreateUserResponse

Creates a user within the specified identity store.

Link copied to clipboard
abstract suspend fun deleteGroup(input: DeleteGroupRequest): DeleteGroupResponse

Delete a group within an identity store given GroupId.

Link copied to clipboard

Delete a membership within a group given MembershipId.

Link copied to clipboard
abstract suspend fun deleteUser(input: DeleteUserRequest): DeleteUserResponse

Deletes a user within an identity store given UserId.

Link copied to clipboard

Retrieves the group metadata and attributes from GroupId in an identity store.

Link copied to clipboard

Retrieves membership metadata and attributes from MembershipId in an identity store.

Link copied to clipboard

Retrieves the user metadata and attributes from the UserId in an identity store.

Link copied to clipboard
abstract suspend fun getGroupId(input: GetGroupIdRequest): GetGroupIdResponse

Retrieves GroupId in an identity store.

Link copied to clipboard

Retrieves the MembershipId in an identity store.

Link copied to clipboard
abstract suspend fun getUserId(input: GetUserIdRequest): GetUserIdResponse

Retrieves the UserId in an identity store.

Link copied to clipboard

Checks the user's membership in all requested groups and returns if the member exists in all queried groups.

Link copied to clipboard

For the specified group in the specified identity store, returns the list of all GroupMembership objects and returns results in paginated form.

Link copied to clipboard

For the specified member in the specified identity store, returns the list of all GroupMembership objects and returns results in paginated form.

Link copied to clipboard
abstract suspend fun listGroups(input: ListGroupsRequest): ListGroupsResponse

Lists all groups in the identity store. Returns a paginated list of complete Group objects. Filtering for a Group by the DisplayName attribute is deprecated. Instead, use the GetGroupId API action.

Link copied to clipboard
abstract suspend fun listUsers(input: ListUsersRequest): ListUsersResponse

Lists all users in the identity store. Returns a paginated list of complete User objects. Filtering for a User by the UserName attribute is deprecated. Instead, use the GetUserId API action.

Link copied to clipboard
abstract suspend fun updateGroup(input: UpdateGroupRequest): UpdateGroupResponse

For the specified group in the specified identity store, updates the group metadata and attributes.

Link copied to clipboard
abstract suspend fun updateUser(input: UpdateUserRequest): UpdateUserResponse

For the specified user in the specified identity store, updates the user metadata and attributes.

Inherited functions

Link copied to clipboard
expect abstract fun close()
Link copied to clipboard

Creates a group within the specified identity store.

Link copied to clipboard

Creates a relationship between a member and a group. The following identifiers must be specified: GroupId, IdentityStoreId, and MemberId.

Link copied to clipboard

Creates a user within the specified identity store.

Link copied to clipboard

Delete a group within an identity store given GroupId.

Link copied to clipboard

Delete a membership within a group given MembershipId.

Link copied to clipboard

Deletes a user within an identity store given UserId.

Link copied to clipboard

Retrieves the group metadata and attributes from GroupId in an identity store.

Link copied to clipboard

Retrieves membership metadata and attributes from MembershipId in an identity store.

Link copied to clipboard

Retrieves the user metadata and attributes from the UserId in an identity store.

Link copied to clipboard

Retrieves GroupId in an identity store.

Link copied to clipboard

Retrieves the MembershipId in an identity store.

Link copied to clipboard
inline suspend fun IdentitystoreClient.getUserId(crossinline block: GetUserIdRequest.Builder.() -> Unit): GetUserIdResponse

Retrieves the UserId in an identity store.

Link copied to clipboard

Checks the user's membership in all requested groups and returns if the member exists in all queried groups.

Link copied to clipboard

For the specified group in the specified identity store, returns the list of all GroupMembership objects and returns results in paginated form.

Link copied to clipboard

For the specified member in the specified identity store, returns the list of all GroupMembership objects and returns results in paginated form.

Link copied to clipboard

Lists all groups in the identity store. Returns a paginated list of complete Group objects. Filtering for a Group by the DisplayName attribute is deprecated. Instead, use the GetGroupId API action.

Link copied to clipboard
inline suspend fun IdentitystoreClient.listUsers(crossinline block: ListUsersRequest.Builder.() -> Unit): ListUsersResponse

Lists all users in the identity store. Returns a paginated list of complete User objects. Filtering for a User by the UserName attribute is deprecated. Instead, use the GetUserId API action.

Link copied to clipboard

For the specified group in the specified identity store, updates the group metadata and attributes.

Link copied to clipboard

For the specified user in the specified identity store, updates the user metadata and attributes.

Link copied to clipboard

Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.