Select your cookie preferences

We use cookies and similar tools to enhance your experience, provide our services, deliver relevant advertising, and make improvements. Approved third parties also use these tools to help us deliver advertising and provide certain site features.

describe_speaker

describe_speaker(**kwargs)

Describes the specified speaker.

See also: AWS API Documentation

Request Syntax

response = client.describe_speaker(
    DomainId='string',
    SpeakerId='string'
)
Parameters
  • DomainId (string) --

    [REQUIRED]

    The identifier of the domain that contains the speaker.

  • SpeakerId (string) --

    [REQUIRED]

    The identifier of the speaker you are describing.

Return type

dict

Returns

Response Syntax

{
    'Speaker': {
        'CreatedAt': datetime(2015, 1, 1),
        'CustomerSpeakerId': 'string',
        'DomainId': 'string',
        'GeneratedSpeakerId': 'string',
        'LastAccessedAt': datetime(2015, 1, 1),
        'Status': 'ENROLLED'|'EXPIRED'|'OPTED_OUT'|'PENDING',
        'UpdatedAt': datetime(2015, 1, 1)
    }
}

Response Structure

  • (dict) --

    • Speaker (dict) --

      Information about the specified speaker.

      • CreatedAt (datetime) --

        A timestamp showing when the speaker is created.

      • CustomerSpeakerId (string) --

        The client-provided identifier for the speaker.

      • DomainId (string) --

        The identifier of the domain that contains the speaker.

      • GeneratedSpeakerId (string) --

        The service-generated identifier for the speaker.

      • LastAccessedAt (datetime) --

        The timestamp when the speaker was last accessed for enrollment, re-enrollment or a successful authentication. This timestamp is accurate to one hour.

      • Status (string) --

        The current status of the speaker.

      • UpdatedAt (datetime) --

        A timestamp showing the speaker's last update.

Exceptions

  • VoiceID.Client.exceptions.ResourceNotFoundException
  • VoiceID.Client.exceptions.ValidationException
  • VoiceID.Client.exceptions.InternalServerException
  • VoiceID.Client.exceptions.ThrottlingException
  • VoiceID.Client.exceptions.AccessDeniedException