Route53Profiles / Client / create_profile

create_profile#

Route53Profiles.Client.create_profile(**kwargs)#

Creates an empty Route 53 Profile.

See also: AWS API Documentation

Request Syntax

response = client.create_profile(
    ClientToken='string',
    Name='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters:
  • ClientToken (string) –

    [REQUIRED]

    ClientToken is an idempotency token that ensures a call to CreateProfile completes only once. You choose the value to pass. For example, an issue might prevent you from getting a response from CreateProfile. In this case, safely retry your call to CreateProfile by using the same CreateProfile parameter value.

    This field is autopopulated if not provided.

  • Name (string) –

    [REQUIRED]

    A name for the Profile.

  • Tags (list) –

    A list of the tag keys and values that you want to associate with the Route 53 Profile.

    • (dict) –

      Tag for the Profile.

      • Key (string) – [REQUIRED]

        Key associated with the Tag.

      • Value (string) – [REQUIRED]

        Value for the Tag.

Return type:

dict

Returns:

Response Syntax

{
    'Profile': {
        'Arn': 'string',
        'ClientToken': 'string',
        'CreationTime': datetime(2015, 1, 1),
        'Id': 'string',
        'ModificationTime': datetime(2015, 1, 1),
        'Name': 'string',
        'OwnerId': 'string',
        'ShareStatus': 'NOT_SHARED'|'SHARED_WITH_ME'|'SHARED_BY_ME',
        'Status': 'COMPLETE'|'DELETING'|'UPDATING'|'CREATING'|'DELETED'|'FAILED',
        'StatusMessage': 'string'
    }
}

Response Structure

  • (dict) –

    • Profile (dict) –

      The Profile that you just created.

      • Arn (string) –

        The Amazon Resource Name (ARN) of the Profile.

      • ClientToken (string) –

        The ClientToken value that was assigned when the Profile was created.

      • CreationTime (datetime) –

        The date and time that the Profile was created, in Unix time format and Coordinated Universal Time (UTC).

      • Id (string) –

        ID of the Profile.

      • ModificationTime (datetime) –

        The date and time that the Profile was modified, in Unix time format and Coordinated Universal Time (UTC).

      • Name (string) –

        Name of the Profile.

      • OwnerId (string) –

        Amazon Web Services account ID of the Profile owner.

      • ShareStatus (string) –

        Sharing status for the Profile.

      • Status (string) –

        The status for the Profile.

      • StatusMessage (string) –

        Status message that includes additiona information about the Profile.

Exceptions

  • Route53Profiles.Client.exceptions.LimitExceededException

  • Route53Profiles.Client.exceptions.InvalidParameterException

  • Route53Profiles.Client.exceptions.ThrottlingException

  • Route53Profiles.Client.exceptions.ValidationException

  • Route53Profiles.Client.exceptions.AccessDeniedException