Skip to main content

identity_pools

Creates, updates, deletes, gets or lists a identity_pools resource.

Overview

Nameidentity_pools
TypeResource
Idconfluent.iam.identity_pools

Fields

NameDatatypeDescription
idstringID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object kinds or objects of the same kind within a different scope/namespace ("space").
descriptionstringA description of how this IdentityPool is used
api_versionstringAPIVersion defines the schema version of this representation of a resource.
display_namestringThe name of the IdentityPool.
filterstringA filter expression in Supported Common Expression Language (CEL) that specifies which identities can authenticate using your identity pool (see Set identity pool filters for more details).
identity_claimstringThe JSON Web Token (JWT) claim to extract the authenticating identity to Confluent resources from (see Registered Claim Names for more details). This appears in the audit log records, showing, for example, that "identity Z used identity pool X to access topic A".
kindstringKind defines the object this REST resource represents.
metadata``ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.
principalstringRepresents the federated identity associated with this pool.
statestringThe current state of the identity pool

Methods

NameAccessible byRequired ParamsDescription
get_iam_v2identity_poolSELECTid, provider_idGeneral Availability Make a request to read an identity pool.
list_iam_v2identity_poolsSELECTprovider_idGeneral Availability Retrieve a sorted, filtered, paginated list of all identity pools.
create_iam_v2identity_poolINSERTprovider_idGeneral Availability Make a request to create an identity pool.
delete_iam_v2identity_poolDELETEid, provider_idGeneral Availability Make a request to delete an identity pool.
update_iam_v2identity_poolUPDATEid, provider_idGeneral Availability Make a request to update an identity pool.

SELECT examples

General Availability Retrieve a sorted, filtered, paginated list of all identity pools.

SELECT
id,
description,
api_version,
display_name,
filter,
identity_claim,
kind,
metadata,
principal,
state
FROM confluent.iam.identity_pools
WHERE provider_id = '{{ provider_id }}';

INSERT example

Use the following StackQL query and manifest file to create a new identity_pools resource.

/*+ create */
INSERT INTO confluent.iam.identity_pools (
data__display_name,
data__description,
data__identity_claim,
data__filter,
provider_id
)
SELECT
'{{ display_name }}',
'{{ description }}',
'{{ identity_claim }}',
'{{ filter }}',
'{{ provider_id }}'
;

UPDATE example

Updates a identity_pools resource.

/*+ update */
UPDATE confluent.iam.identity_pools
SET
display_name = '{{ display_name }}',
description = '{{ description }}',
identity_claim = '{{ identity_claim }}',
filter = '{{ filter }}'
WHERE
id = '{{ id }}'
AND provider_id = '{{ provider_id }}';

DELETE example

Deletes the specified identity_pools resource.

/*+ delete */
DELETE FROM confluent.iam.identity_pools
WHERE id = '{{ id }}'
AND provider_id = '{{ provider_id }}';