CloudWatchOmni / Client / create_domain

create_domain

CloudWatchOmni.Client.create_domain(**kwargs)

Creates a domain with identity provider configuration.

Use GetDomain to retrieve the domain, UpdateDomain to change its configuration, and CreateSpace to add spaces within it.

See also: AWS API Documentation

Request Syntax

response = client.create_domain(
    name='string',
    identityProviders=[
        'IAM'|'IDC',
    ],
    identityProviderConfiguration={
        'identityCenterConfiguration': {
            'identityCenterInstanceArn': 'string'
        }
    },
    tags={
        'string': 'string'
    },
    clientToken='string'
)
Parameters:

  • name (string) –

    [REQUIRED]

    A name that identifies the domain. Must be 3-63 characters: lowercase letters, numbers, and hyphens. It must begin and end with a letter or number and cannot contain consecutive hyphens.

  • identityProviders (list) –

    [REQUIRED]

    The identity providers to configure 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

  • tags (dict) –

    The tags to associate with the domain.

    • (string) –

      Tag key. Must be non-empty; AWS-standard maximum length. Constraining the key (rather than a bare String) rejects empty-key payloads at the edge with a 400 ValidationException instead of faulting downstream as a 500.

      • (string) –

        Tag value. AWS-standard maximum length; may be empty.

  • clientToken (string) –

    Idempotency token for safe retries. Repeated requests with the same token return the original result instead of creating a duplicate.

    This field is autopopulated if not provided.

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 created 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