CloudWatchOmni / Client / get_domain

get_domain

CloudWatchOmni.Client.get_domain(**kwargs)

Retrieves the details of a domain by ID.

See also: AWS API Documentation

Request Syntax

response = client.get_domain(
    domainId='string'
)
Parameters:

domainId (string) –

[REQUIRED]

The unique ID of the domain.

Return type:

dict

Returns:

Response Syntax

{
    'domain': {
        'domainId': 'string',
        'domainArn': 'string',
        'name': 'string',
        'identityProviders': [
            'IAM'|'IDC',
        ],
        'identityProviderConfiguration': {
            'identityCenterConfiguration': {
                'identityCenterInstanceArn': 'string'
            }
        },
        'domainEndpointUrl': 'string',
        'customEndpointUrls': [
            'string',
        ],
        'identityCenterApplicationArn': 'string',
        'region': 'string',
        'createdAt': datetime(2015, 1, 1),
        'updatedAt': datetime(2015, 1, 1),
        'status': 'ACTIVE'
    }
}

Response Structure

  • (dict) –

    • domain (dict) –

      The details of the domain.

      • domainId (string) –

        The unique ID of the domain.

      • domainArn (string) –

        The Amazon Resource Name (ARN) of the domain.

      • name (string) –

        A name that identifies the domain.

      • identityProviders (list) –

        The identity providers configured for the domain.

        • (string) –

          Identity provider type for a domain. Determines which identity mechanisms are active for authentication.

      • identityProviderConfiguration (dict) –

        Identity provider configuration for the domain.

        • identityCenterConfiguration (dict) –

          Identity Center configuration. Required when identityProviders includes IDC.

          • identityCenterInstanceArn (string) –

            Identity Center instance ARN

      • domainEndpointUrl (string) –

        The HTTPS endpoint URL for accessing the domain.

      • customEndpointUrls (list) –

        Additional endpoint URLs derived from the domain name.

        • (string) –

      • identityCenterApplicationArn (string) –

        The ARN of the Identity Center application. Absent for IAM-only domains.

      • region (string) –

        The Region where this domain was created.

      • createdAt (datetime) –

        The timestamp when the domain was created.

      • updatedAt (datetime) –

        The timestamp when the domain was last updated.

      • status (string) –

        Current status of the domain.

Exceptions