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