AlexaForBusiness

Table of Contents

Client

class AlexaForBusiness.Client

A low-level client representing Alexa For Business:

import boto3

client = boto3.client('alexaforbusiness')

These are the available methods:

associate_contact_with_address_book(**kwargs)

Associates a contact with a given address book.

See also: AWS API Documentation

Request Syntax

response = client.associate_contact_with_address_book(
    ContactArn='string',
    AddressBookArn='string'
)
Parameters
  • ContactArn (string) --

    [REQUIRED]

    The ARN of the contact to associate with an address book.

  • AddressBookArn (string) --

    [REQUIRED]

    The ARN of the address book with which to associate the contact.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

associate_device_with_room(**kwargs)

Associates a device with a given room. This applies all the settings from the room profile to the device, and all the skills in any skill groups added to that room. This operation requires the device to be online, or else a manual sync is required.

See also: AWS API Documentation

Request Syntax

response = client.associate_device_with_room(
    DeviceArn='string',
    RoomArn='string'
)
Parameters
  • DeviceArn (string) -- The ARN of the device to associate to a room. Required.
  • RoomArn (string) -- The ARN of the room with which to associate the device. Required.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

associate_skill_group_with_room(**kwargs)

Associates a skill group with a given room. This enables all skills in the associated skill group on all devices in the room.

See also: AWS API Documentation

Request Syntax

response = client.associate_skill_group_with_room(
    SkillGroupArn='string',
    RoomArn='string'
)
Parameters
  • SkillGroupArn (string) -- The ARN of the skill group to associate with a room. Required.
  • RoomArn (string) -- The ARN of the room with which to associate the skill group. Required.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

can_paginate(operation_name)

Check if an operation can be paginated.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Returns
True if the operation can be paginated, False otherwise.
create_address_book(**kwargs)

Creates an address book with the specified details.

See also: AWS API Documentation

Request Syntax

response = client.create_address_book(
    Name='string',
    Description='string',
    ClientRequestToken='string'
)
Parameters
  • Name (string) --

    [REQUIRED]

    The name of the address book.

  • Description (string) -- The description of the address book.
  • ClientRequestToken (string) --

    A unique, user-specified identifier for the request that ensures idempotency.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'AddressBookArn': 'string'
}

Response Structure

  • (dict) --

    • AddressBookArn (string) --

      The ARN of the newly created address book.

create_contact(**kwargs)

Creates a contact with the specified details.

See also: AWS API Documentation

Request Syntax

response = client.create_contact(
    DisplayName='string',
    FirstName='string',
    LastName='string',
    PhoneNumber='string',
    ClientRequestToken='string'
)
Parameters
  • DisplayName (string) -- The name of the contact to display on the console.
  • FirstName (string) --

    [REQUIRED]

    The first name of the contact that is used to call the contact on the device.

  • LastName (string) -- The last name of the contact that is used to call the contact on the device.
  • PhoneNumber (string) --

    [REQUIRED]

    The phone number of the contact in E.164 format.

  • ClientRequestToken (string) --

    A unique, user-specified identifier for this request that ensures idempotency.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'ContactArn': 'string'
}

Response Structure

  • (dict) --

    • ContactArn (string) --

      The ARN of the newly created address book.

create_profile(**kwargs)

Creates a new room profile with the specified details.

See also: AWS API Documentation

Request Syntax

response = client.create_profile(
    ProfileName='string',
    Timezone='string',
    Address='string',
    DistanceUnit='METRIC'|'IMPERIAL',
    TemperatureUnit='FAHRENHEIT'|'CELSIUS',
    WakeWord='ALEXA'|'AMAZON'|'ECHO'|'COMPUTER',
    ClientRequestToken='string',
    SetupModeDisabled=True|False,
    MaxVolumeLimit=123,
    PSTNEnabled=True|False
)
Parameters
  • ProfileName (string) --

    [REQUIRED]

    The name of a room profile.

  • Timezone (string) --

    [REQUIRED]

    The time zone used by a room profile.

  • Address (string) --

    [REQUIRED]

    The valid address for the room.

  • DistanceUnit (string) --

    [REQUIRED]

    The distance unit to be used by devices in the profile.

  • TemperatureUnit (string) --

    [REQUIRED]

    The temperature unit to be used by devices in the profile.

  • WakeWord (string) --

    [REQUIRED]

    A wake word for Alexa, Echo, Amazon, or a computer.

  • ClientRequestToken (string) --

    The user-specified token that is used during the creation of a profile.

    This field is autopopulated if not provided.

  • SetupModeDisabled (boolean) -- Whether room profile setup is enabled.
  • MaxVolumeLimit (integer) -- The maximum volume limit for a room profile.
  • PSTNEnabled (boolean) -- Whether PSTN calling is enabled.
Return type

dict

Returns

Response Syntax

{
    'ProfileArn': 'string'
}

Response Structure

  • (dict) --

    • ProfileArn (string) --

      The ARN of the newly created room profile in the response.

create_room(**kwargs)

Creates a room with the specified details.

See also: AWS API Documentation

Request Syntax

response = client.create_room(
    RoomName='string',
    Description='string',
    ProfileArn='string',
    ProviderCalendarId='string',
    ClientRequestToken='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters
  • RoomName (string) --

    [REQUIRED]

    The name for the room.

  • Description (string) -- The description for the room.
  • ProfileArn (string) -- The profile ARN for the room.
  • ProviderCalendarId (string) -- The calendar ARN for the room.
  • ClientRequestToken (string) --

    A unique, user-specified identifier for this request that ensures idempotency.

    This field is autopopulated if not provided.

  • Tags (list) --

    The tags for the room.

    • (dict) --

      A key-value pair that can be associated with a resource.

      • Key (string) --

        The key of a tag. Tag keys are case-sensitive.

      • Value (string) --

        The value of a tag. Tag values are case-sensitive and can be null.

Return type

dict

Returns

Response Syntax

{
    'RoomArn': 'string'
}

Response Structure

  • (dict) --

    • RoomArn (string) --

      The ARN of the newly created room in the response.

create_skill_group(**kwargs)

Creates a skill group with a specified name and description.

See also: AWS API Documentation

Request Syntax

response = client.create_skill_group(
    SkillGroupName='string',
    Description='string',
    ClientRequestToken='string'
)
Parameters
  • SkillGroupName (string) --

    [REQUIRED]

    The name for the skill group.

  • Description (string) -- The description for the skill group.
  • ClientRequestToken (string) --

    A unique, user-specified identifier for this request that ensures idempotency.

    This field is autopopulated if not provided.

Return type

dict

Returns

Response Syntax

{
    'SkillGroupArn': 'string'
}

Response Structure

  • (dict) --

    • SkillGroupArn (string) --

      The ARN of the newly created skill group in the response.

create_user(**kwargs)

Creates a user.

See also: AWS API Documentation

Request Syntax

response = client.create_user(
    UserId='string',
    FirstName='string',
    LastName='string',
    Email='string',
    ClientRequestToken='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters
  • UserId (string) --

    [REQUIRED]

    The ARN for the user.

  • FirstName (string) -- The first name for the user.
  • LastName (string) -- The last name for the user.
  • Email (string) -- The email address for the user.
  • ClientRequestToken (string) --

    A unique, user-specified identifier for this request that ensures idempotency.

    This field is autopopulated if not provided.

  • Tags (list) --

    The tags for the user.

    • (dict) --

      A key-value pair that can be associated with a resource.

      • Key (string) --

        The key of a tag. Tag keys are case-sensitive.

      • Value (string) --

        The value of a tag. Tag values are case-sensitive and can be null.

Return type

dict

Returns

Response Syntax

{
    'UserArn': 'string'
}

Response Structure

  • (dict) --

    • UserArn (string) --

      The ARN of the newly created user in the response.

delete_address_book(**kwargs)

Deletes an address book by the address book ARN.

See also: AWS API Documentation

Request Syntax

response = client.delete_address_book(
    AddressBookArn='string'
)
Parameters
AddressBookArn (string) --

[REQUIRED]

The ARN of the address book to delete.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --
delete_contact(**kwargs)

Deletes a contact by the contact ARN.

See also: AWS API Documentation

Request Syntax

response = client.delete_contact(
    ContactArn='string'
)
Parameters
ContactArn (string) --

[REQUIRED]

The ARN of the contact to delete.

Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --
delete_profile(**kwargs)

Deletes a room profile by the profile ARN.

See also: AWS API Documentation

Request Syntax

response = client.delete_profile(
    ProfileArn='string'
)
Parameters
ProfileArn (string) -- The ARN of the room profile to delete. Required.
Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --
delete_room(**kwargs)

Deletes a room by the room ARN.

See also: AWS API Documentation

Request Syntax

response = client.delete_room(
    RoomArn='string'
)
Parameters
RoomArn (string) -- The ARN of the room to delete. Required.
Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --
delete_room_skill_parameter(**kwargs)

Deletes room skill parameter details by room, skill, and parameter key ID.

See also: AWS API Documentation

Request Syntax

response = client.delete_room_skill_parameter(
    RoomArn='string',
    SkillId='string',
    ParameterKey='string'
)
Parameters
  • RoomArn (string) -- The ARN of the room from which to remove the room skill parameter details.
  • SkillId (string) --

    [REQUIRED]

    The ID of the skill from which to remove the room skill parameter details.

  • ParameterKey (string) --

    [REQUIRED]

    The room skill parameter key for which to remove details.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

delete_skill_group(**kwargs)

Deletes a skill group by skill group ARN.

See also: AWS API Documentation

Request Syntax

response = client.delete_skill_group(
    SkillGroupArn='string'
)
Parameters
SkillGroupArn (string) -- The ARN of the skill group to delete. Required.
Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --
delete_user(**kwargs)

Deletes a specified user by user ARN and enrollment ARN.

See also: AWS API Documentation

Request Syntax

response = client.delete_user(
    UserArn='string',
    EnrollmentId='string'
)
Parameters
  • UserArn (string) -- The ARN of the user to delete in the organization. Required.
  • EnrollmentId (string) --

    [REQUIRED]

    The ARN of the user's enrollment in the organization. Required.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

disassociate_contact_from_address_book(**kwargs)

Disassociates a contact from a given address book.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_contact_from_address_book(
    ContactArn='string',
    AddressBookArn='string'
)
Parameters
  • ContactArn (string) --

    [REQUIRED]

    The ARN of the contact to disassociate from an address book.

  • AddressBookArn (string) --

    [REQUIRED]

    The ARN of the address from which to disassociate the contact.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

disassociate_device_from_room(**kwargs)

Disassociates a device from its current room. The device continues to be connected to the Wi-Fi network and is still registered to the account. The device settings and skills are removed from the room.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_device_from_room(
    DeviceArn='string'
)
Parameters
DeviceArn (string) -- The ARN of the device to disassociate from a room. Required.
Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --
disassociate_skill_group_from_room(**kwargs)

Disassociates a skill group from a specified room. This disables all skills in the skill group on all devices in the room.

See also: AWS API Documentation

Request Syntax

response = client.disassociate_skill_group_from_room(
    SkillGroupArn='string',
    RoomArn='string'
)
Parameters
  • SkillGroupArn (string) -- The ARN of the skill group to disassociate from a room. Required.
  • RoomArn (string) -- The ARN of the room from which the skill group is to be disassociated. Required.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

generate_presigned_url(ClientMethod, Params=None, ExpiresIn=3600, HttpMethod=None)

Generate a presigned url given a client, its method, and arguments

Parameters
  • ClientMethod (string) -- The client method to presign for
  • Params (dict) -- The parameters normally passed to ClientMethod.
  • ExpiresIn (int) -- The number of seconds the presigned url is valid for. By default it expires in an hour (3600 seconds)
  • HttpMethod (string) -- The http method to use on the generated url. By default, the http method is whatever is used in the method's model.
Returns

The presigned url

get_address_book(**kwargs)

Gets address the book details by the address book ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_address_book(
    AddressBookArn='string'
)
Parameters
AddressBookArn (string) --

[REQUIRED]

The ARN of the address book for which to request details.

Return type
dict
Returns
Response Syntax
{
    'AddressBook': {
        'AddressBookArn': 'string',
        'Name': 'string',
        'Description': 'string'
    }
}

Response Structure

  • (dict) --
    • AddressBook (dict) --

      The details of the requested address book.

      • AddressBookArn (string) --

        The ARN of the address book.

      • Name (string) --

        The name of the address book.

      • Description (string) --

        The description of the address book.

get_contact(**kwargs)

Gets the contact details by the contact ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_contact(
    ContactArn='string'
)
Parameters
ContactArn (string) --

[REQUIRED]

The ARN of the contact for which to request details.

Return type
dict
Returns
Response Syntax
{
    'Contact': {
        'ContactArn': 'string',
        'DisplayName': 'string',
        'FirstName': 'string',
        'LastName': 'string',
        'PhoneNumber': 'string'
    }
}

Response Structure

  • (dict) --
    • Contact (dict) --

      The details of the requested contact.

      • ContactArn (string) --

        The ARN of the contact.

      • DisplayName (string) --

        The name of the contact to display on the console.

      • FirstName (string) --

        The first name of the contact, used to call the contact on the device.

      • LastName (string) --

        The last name of the contact, used to call the contact on the device.

      • PhoneNumber (string) --

        The phone number of the contact.

get_device(**kwargs)

Gets the details of a device by device ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_device(
    DeviceArn='string'
)
Parameters
DeviceArn (string) -- The ARN of the device for which to request details. Required.
Return type
dict
Returns
Response Syntax
{
    'Device': {
        'DeviceArn': 'string',
        'DeviceSerialNumber': 'string',
        'DeviceType': 'string',
        'DeviceName': 'string',
        'SoftwareVersion': 'string',
        'MacAddress': 'string',
        'RoomArn': 'string',
        'DeviceStatus': 'READY'|'PENDING'|'WAS_OFFLINE'|'DEREGISTERED',
        'DeviceStatusInfo': {
            'DeviceStatusDetails': [
                {
                    'Code': 'DEVICE_SOFTWARE_UPDATE_NEEDED'|'DEVICE_WAS_OFFLINE'
                },
            ],
            'ConnectionStatus': 'ONLINE'|'OFFLINE'
        }
    }
}

Response Structure

  • (dict) --
    • Device (dict) --

      The details of the device requested. Required.

      • DeviceArn (string) --

        The ARN of a device.

      • DeviceSerialNumber (string) --

        The serial number of a device.

      • DeviceType (string) --

        The type of a device.

      • DeviceName (string) --

        The name of a device.

      • SoftwareVersion (string) --

        The software version of a device.

      • MacAddress (string) --

        The MAC address of a device.

      • RoomArn (string) --

        The room ARN of a device.

      • DeviceStatus (string) --

        The status of a device. If the status is not READY, check the DeviceStatusInfo value for details.

      • DeviceStatusInfo (dict) --

        Detailed information about a device's status.

        • DeviceStatusDetails (list) --

          One or more device status detail descriptions.

          • (dict) --

            Details of a device’s status.

            • Code (string) --

              The device status detail code.

        • ConnectionStatus (string) --

          The latest available information about the connection status of a device.

get_paginator(operation_name)

Create a paginator for an operation.

Parameters
operation_name (string) -- The operation name. This is the same name as the method name on the client. For example, if the method name is create_foo, and you'd normally invoke the operation as client.create_foo(**kwargs), if the create_foo operation can be paginated, you can use the call client.get_paginator("create_foo").
Raises OperationNotPageableError
Raised if the operation is not pageable. You can use the client.can_paginate method to check if an operation is pageable.
Return type
L{botocore.paginate.Paginator}
Returns
A paginator object.
get_profile(**kwargs)

Gets the details of a room profile by profile ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_profile(
    ProfileArn='string'
)
Parameters
ProfileArn (string) -- The ARN of the room profile for which to request details. Required.
Return type
dict
Returns
Response Syntax
{
    'Profile': {
        'ProfileArn': 'string',
        'ProfileName': 'string',
        'Address': 'string',
        'Timezone': 'string',
        'DistanceUnit': 'METRIC'|'IMPERIAL',
        'TemperatureUnit': 'FAHRENHEIT'|'CELSIUS',
        'WakeWord': 'ALEXA'|'AMAZON'|'ECHO'|'COMPUTER',
        'SetupModeDisabled': True|False,
        'MaxVolumeLimit': 123,
        'PSTNEnabled': True|False
    }
}

Response Structure

  • (dict) --
    • Profile (dict) --

      The details of the room profile requested. Required.

      • ProfileArn (string) --

        The ARN of a room profile.

      • ProfileName (string) --

        The name of a room profile.

      • Address (string) --

        The address of a room profile.

      • Timezone (string) --

        The time zone of a room profile.

      • DistanceUnit (string) --

        The distance unit of a room profile.

      • TemperatureUnit (string) --

        The temperature unit of a room profile.

      • WakeWord (string) --

        The wake word of a room profile.

      • SetupModeDisabled (boolean) --

        The setup mode of a room profile.

      • MaxVolumeLimit (integer) --

        The max volume limit of a room profile.

      • PSTNEnabled (boolean) --

        The PSTN setting of a room profile.

get_room(**kwargs)

Gets room details by room ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_room(
    RoomArn='string'
)
Parameters
RoomArn (string) -- The ARN of the room for which to request details. Required.
Return type
dict
Returns
Response Syntax
{
    'Room': {
        'RoomArn': 'string',
        'RoomName': 'string',
        'Description': 'string',
        'ProviderCalendarId': 'string',
        'ProfileArn': 'string'
    }
}

Response Structure

  • (dict) --
    • Room (dict) --

      The details of the room requested.

      • RoomArn (string) --

        The ARN of a room.

      • RoomName (string) --

        The name of a room.

      • Description (string) --

        The description of a room.

      • ProviderCalendarId (string) --

        The provider calendar ARN of a room.

      • ProfileArn (string) --

        The profile ARN of a room.

get_room_skill_parameter(**kwargs)

Gets room skill parameter details by room, skill, and parameter key ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_room_skill_parameter(
    RoomArn='string',
    SkillId='string',
    ParameterKey='string'
)
Parameters
  • RoomArn (string) -- The ARN of the room from which to get the room skill parameter details.
  • SkillId (string) --

    [REQUIRED]

    The ARN of the skill from which to get the room skill parameter details. Required.

  • ParameterKey (string) --

    [REQUIRED]

    The room skill parameter key for which to get details. Required.

Return type

dict

Returns

Response Syntax

{
    'RoomSkillParameter': {
        'ParameterKey': 'string',
        'ParameterValue': 'string'
    }
}

Response Structure

  • (dict) --

    • RoomSkillParameter (dict) --

      The details of the room skill parameter requested. Required.

      • ParameterKey (string) --

        The parameter key of a room skill parameter. ParameterKey is an enumerated type that only takes “DEFAULT” or “SCOPE” as valid values.

      • ParameterValue (string) --

        The parameter value of a room skill parameter.

get_skill_group(**kwargs)

Gets skill group details by skill group ARN.

See also: AWS API Documentation

Request Syntax

response = client.get_skill_group(
    SkillGroupArn='string'
)
Parameters
SkillGroupArn (string) -- The ARN of the skill group for which to get details. Required.
Return type
dict
Returns
Response Syntax
{
    'SkillGroup': {
        'SkillGroupArn': 'string',
        'SkillGroupName': 'string',
        'Description': 'string'
    }
}

Response Structure

  • (dict) --
    • SkillGroup (dict) --

      The details of the skill group requested. Required.

      • SkillGroupArn (string) --

        The ARN of a skill group.

      • SkillGroupName (string) --

        The name of a skill group.

      • Description (string) --

        The description of a skill group.

get_waiter(waiter_name)

Returns an object that can wait for some condition.

Parameters
waiter_name (str) -- The name of the waiter to get. See the waiters section of the service docs for a list of available waiters.
Returns
The specified waiter object.
Return type
botocore.waiter.Waiter
list_device_events(**kwargs)

Lists the device event history, including device connection status, for up to 30 days.

See also: AWS API Documentation

Request Syntax

response = client.list_device_events(
    DeviceArn='string',
    EventType='CONNECTION_STATUS'|'DEVICE_STATUS',
    NextToken='string',
    MaxResults=123
)
Parameters
  • DeviceArn (string) --

    [REQUIRED]

    The ARN of a device.

  • EventType (string) -- The event type to filter device events. If EventType isn't specified, this returns a list of all device events in reverse chronological order. If EventType is specified, this returns a list of device events for that EventType in reverse chronological order.
  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response only includes results beyond the token, up to the value specified by MaxResults. When the end of results is reached, the response has a value of null.
  • MaxResults (integer) -- The maximum number of results to include in the response. The default value is 50. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
Return type

dict

Returns

Response Syntax

{
    'DeviceEvents': [
        {
            'Type': 'CONNECTION_STATUS'|'DEVICE_STATUS',
            'Value': 'string',
            'Timestamp': datetime(2015, 1, 1)
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • DeviceEvents (list) --

      The device events requested for the device ARN.

      • (dict) --

        The list of device events.

        • Type (string) --

          The type of device event.

        • Value (string) --

          The value of the event.

        • Timestamp (datetime) --

          The time (in epoch) when the event occurred.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

list_skills(**kwargs)

Lists all enabled skills in a specific skill group.

See also: AWS API Documentation

Request Syntax

response = client.list_skills(
    SkillGroupArn='string',
    NextToken='string',
    MaxResults=123
)
Parameters
  • SkillGroupArn (string) -- The ARN of the skill group for which to list enabled skills. Required.
  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults . Required.
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. Required.
Return type

dict

Returns

Response Syntax

{
    'SkillSummaries': [
        {
            'SkillId': 'string',
            'SkillName': 'string',
            'SupportsLinking': True|False
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • SkillSummaries (list) --

      The list of enabled skills requested. Required.

      • (dict) --

        The summary of skills.

        • SkillId (string) --

          The ARN of the skill summary.

        • SkillName (string) --

          The name of the skill.

        • SupportsLinking (boolean) --

          Linking support for a skill.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

list_tags(**kwargs)

Lists all tags for the specified resource.

See also: AWS API Documentation

Request Syntax

response = client.list_tags(
    Arn='string',
    NextToken='string',
    MaxResults=123
)
Parameters
  • Arn (string) --

    [REQUIRED]

    The ARN of the specified resource for which to list tags.

  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults .
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
Return type

dict

Returns

Response Syntax

{
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) --

    • Tags (list) --

      The tags requested for the specified resource.

      • (dict) --

        A key-value pair that can be associated with a resource.

        • Key (string) --

          The key of a tag. Tag keys are case-sensitive.

        • Value (string) --

          The value of a tag. Tag values are case-sensitive and can be null.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

put_room_skill_parameter(**kwargs)

Updates room skill parameter details by room, skill, and parameter key ID. Not all skills have a room skill parameter.

See also: AWS API Documentation

Request Syntax

response = client.put_room_skill_parameter(
    RoomArn='string',
    SkillId='string',
    RoomSkillParameter={
        'ParameterKey': 'string',
        'ParameterValue': 'string'
    }
)
Parameters
  • RoomArn (string) -- The ARN of the room associated with the room skill parameter. Required.
  • SkillId (string) --

    [REQUIRED]

    The ARN of the skill associated with the room skill parameter. Required.

  • RoomSkillParameter (dict) --

    [REQUIRED]

    The updated room skill parameter. Required.

    • ParameterKey (string) -- [REQUIRED]

      The parameter key of a room skill parameter. ParameterKey is an enumerated type that only takes “DEFAULT” or “SCOPE” as valid values.

    • ParameterValue (string) -- [REQUIRED]

      The parameter value of a room skill parameter.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

resolve_room(**kwargs)

Determines the details for the room from which a skill request was invoked. This operation is used by skill developers.

See also: AWS API Documentation

Request Syntax

response = client.resolve_room(
    UserId='string',
    SkillId='string'
)
Parameters
  • UserId (string) --

    [REQUIRED]

    The ARN of the user. Required.

  • SkillId (string) --

    [REQUIRED]

    The ARN of the skill that was requested. Required.

Return type

dict

Returns

Response Syntax

{
    'RoomArn': 'string',
    'RoomName': 'string',
    'RoomSkillParameters': [
        {
            'ParameterKey': 'string',
            'ParameterValue': 'string'
        },
    ]
}

Response Structure

  • (dict) --

    • RoomArn (string) --

      The ARN of the room from which the skill request was invoked.

    • RoomName (string) --

      The name of the room from which the skill request was invoked.

    • RoomSkillParameters (list) --

      Response to get the room profile request. Required.

      • (dict) --

        A skill parameter associated with a room.

        • ParameterKey (string) --

          The parameter key of a room skill parameter. ParameterKey is an enumerated type that only takes “DEFAULT” or “SCOPE” as valid values.

        • ParameterValue (string) --

          The parameter value of a room skill parameter.

revoke_invitation(**kwargs)

Revokes an invitation and invalidates the enrollment URL.

See also: AWS API Documentation

Request Syntax

response = client.revoke_invitation(
    UserArn='string',
    EnrollmentId='string'
)
Parameters
  • UserArn (string) -- The ARN of the user for whom to revoke an enrollment invitation. Required.
  • EnrollmentId (string) -- The ARN of the enrollment invitation to revoke. Required.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

search_address_books(**kwargs)

Searches address books and lists the ones that meet a set of filter and sort criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_address_books(
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ],
    NextToken='string',
    MaxResults=123
)
Parameters
  • Filters (list) --

    The filters to use to list a specified set of address books. The supported filter key is AddressBookName.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of address books. The supported sort key is AddressBookName.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response only includes results beyond the token, up to the value specified by MaxResults.
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
Return type

dict

Returns

Response Syntax

{
    'AddressBooks': [
        {
            'AddressBookArn': 'string',
            'Name': 'string',
            'Description': 'string'
        },
    ],
    'NextToken': 'string',
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • AddressBooks (list) --

      The address books that meet the specified set of filter criteria, in sort order.

      • (dict) --

        Information related to an address book.

        • AddressBookArn (string) --

          The ARN of the address book.

        • Name (string) --

          The name of the address book.

        • Description (string) --

          The description of the address book.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

    • TotalCount (integer) --

      The total number of address books returned.

search_contacts(**kwargs)

Searches contacts and lists the ones that meet a set of filter and sort criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_contacts(
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ],
    NextToken='string',
    MaxResults=123
)
Parameters
  • Filters (list) --

    The filters to use to list a specified set of address books. The supported filter keys are DisplayName, FirstName, LastName, and AddressBookArns.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of contacts. The supported sort keys are DisplayName, FirstName, and LastName.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response only includes results beyond the token, up to the value specified by MaxResults.
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
Return type

dict

Returns

Response Syntax

{
    'Contacts': [
        {
            'ContactArn': 'string',
            'DisplayName': 'string',
            'FirstName': 'string',
            'LastName': 'string',
            'PhoneNumber': 'string'
        },
    ],
    'NextToken': 'string',
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Contacts (list) --

      The contacts that meet the specified set of filter criteria, in sort order.

      • (dict) --

        Information related to a contact.

        • ContactArn (string) --

          The ARN of the contact.

        • DisplayName (string) --

          The name of the contact to display on the console.

        • FirstName (string) --

          The first name of the contact, used to call the contact on the device.

        • LastName (string) --

          The last name of the contact, used to call the contact on the device.

        • PhoneNumber (string) --

          The phone number of the contact.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

    • TotalCount (integer) --

      The total number of contacts returned.

search_devices(**kwargs)

Searches devices and lists the ones that meet a set of filter criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_devices(
    NextToken='string',
    MaxResults=123,
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ]
)
Parameters
  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults .
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
  • Filters (list) --

    The filters to use to list a specified set of devices. Supported filter keys are DeviceName, DeviceStatus, DeviceStatusDetailCode, RoomName, DeviceType, DeviceSerialNumber, UnassociatedOnly, and ConnectionStatus (ONLINE and OFFLINE).

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of devices. Supported sort keys are DeviceName, DeviceStatus, RoomName, DeviceType, DeviceSerialNumber, and ConnectionStatus.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

Return type

dict

Returns

Response Syntax

{
    'Devices': [
        {
            'DeviceArn': 'string',
            'DeviceSerialNumber': 'string',
            'DeviceType': 'string',
            'DeviceName': 'string',
            'SoftwareVersion': 'string',
            'MacAddress': 'string',
            'DeviceStatus': 'READY'|'PENDING'|'WAS_OFFLINE'|'DEREGISTERED',
            'RoomArn': 'string',
            'RoomName': 'string',
            'DeviceStatusInfo': {
                'DeviceStatusDetails': [
                    {
                        'Code': 'DEVICE_SOFTWARE_UPDATE_NEEDED'|'DEVICE_WAS_OFFLINE'
                    },
                ],
                'ConnectionStatus': 'ONLINE'|'OFFLINE'
            }
        },
    ],
    'NextToken': 'string',
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Devices (list) --

      The devices that meet the specified set of filter criteria, in sort order.

      • (dict) --

        Device attributes.

        • DeviceArn (string) --

          The ARN of a device.

        • DeviceSerialNumber (string) --

          The serial number of a device.

        • DeviceType (string) --

          The type of a device.

        • DeviceName (string) --

          The name of a device.

        • SoftwareVersion (string) --

          The software version of a device.

        • MacAddress (string) --

          The MAC address of a device.

        • DeviceStatus (string) --

          The status of a device.

        • RoomArn (string) --

          The room ARN associated with a device.

        • RoomName (string) --

          The name of the room associated with a device.

        • DeviceStatusInfo (dict) --

          Detailed information about a device's status.

          • DeviceStatusDetails (list) --

            One or more device status detail descriptions.

            • (dict) --

              Details of a device’s status.

              • Code (string) --

                The device status detail code.

          • ConnectionStatus (string) --

            The latest available information about the connection status of a device.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

    • TotalCount (integer) --

      The total number of devices returned.

search_profiles(**kwargs)

Searches room profiles and lists the ones that meet a set of filter criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_profiles(
    NextToken='string',
    MaxResults=123,
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ]
)
Parameters
  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults .
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
  • Filters (list) --

    The filters to use to list a specified set of room profiles. Supported filter keys are ProfileName and Address. Required.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of room profiles. Supported sort keys are ProfileName and Address.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

Return type

dict

Returns

Response Syntax

{
    'Profiles': [
        {
            'ProfileArn': 'string',
            'ProfileName': 'string',
            'Address': 'string',
            'Timezone': 'string',
            'DistanceUnit': 'METRIC'|'IMPERIAL',
            'TemperatureUnit': 'FAHRENHEIT'|'CELSIUS',
            'WakeWord': 'ALEXA'|'AMAZON'|'ECHO'|'COMPUTER'
        },
    ],
    'NextToken': 'string',
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Profiles (list) --

      The profiles that meet the specified set of filter criteria, in sort order.

      • (dict) --

        The data of a room profile.

        • ProfileArn (string) --

          The ARN of a room profile.

        • ProfileName (string) --

          The name of a room profile.

        • Address (string) --

          The address of a room profile.

        • Timezone (string) --

          The timezone of a room profile.

        • DistanceUnit (string) --

          The distance unit of a room profile.

        • TemperatureUnit (string) --

          The temperature unit of a room profile.

        • WakeWord (string) --

          The wake word of a room profile.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

    • TotalCount (integer) --

      The total number of room profiles returned.

search_rooms(**kwargs)

Searches rooms and lists the ones that meet a set of filter and sort criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_rooms(
    NextToken='string',
    MaxResults=123,
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ]
)
Parameters
  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults .
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
  • Filters (list) --

    The filters to use to list a specified set of rooms. The supported filter keys are RoomName and ProfileName.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of rooms. The supported sort keys are RoomName and ProfileName.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

Return type

dict

Returns

Response Syntax

{
    'Rooms': [
        {
            'RoomArn': 'string',
            'RoomName': 'string',
            'Description': 'string',
            'ProviderCalendarId': 'string',
            'ProfileArn': 'string',
            'ProfileName': 'string'
        },
    ],
    'NextToken': 'string',
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Rooms (list) --

      The rooms that meet the specified set of filter criteria, in sort order.

      • (dict) --

        The data of a room.

        • RoomArn (string) --

          The ARN of a room.

        • RoomName (string) --

          The name of a room.

        • Description (string) --

          The description of a room.

        • ProviderCalendarId (string) --

          The provider calendar ARN of a room.

        • ProfileArn (string) --

          The profile ARN of a room.

        • ProfileName (string) --

          The profile name of a room.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

    • TotalCount (integer) --

      The total number of rooms returned.

search_skill_groups(**kwargs)

Searches skill groups and lists the ones that meet a set of filter and sort criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_skill_groups(
    NextToken='string',
    MaxResults=123,
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ]
)
Parameters
  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults . Required.
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved.
  • Filters (list) --

    The filters to use to list a specified set of skill groups. The supported filter key is SkillGroupName.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of skill groups. The supported sort key is SkillGroupName.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

Return type

dict

Returns

Response Syntax

{
    'SkillGroups': [
        {
            'SkillGroupArn': 'string',
            'SkillGroupName': 'string',
            'Description': 'string'
        },
    ],
    'NextToken': 'string',
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • SkillGroups (list) --

      The skill groups that meet the filter criteria, in sort order.

      • (dict) --

        The attributes of a skill group.

        • SkillGroupArn (string) --

          The skill group ARN of a skill group.

        • SkillGroupName (string) --

          The skill group name of a skill group.

        • Description (string) --

          The description of a skill group.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

    • TotalCount (integer) --

      The total number of skill groups returned.

search_users(**kwargs)

Searches users and lists the ones that meet a set of filter and sort criteria.

See also: AWS API Documentation

Request Syntax

response = client.search_users(
    NextToken='string',
    MaxResults=123,
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ]
)
Parameters
  • NextToken (string) -- An optional token returned from a prior request. Use this token for pagination of results from this action. If this parameter is specified, the response includes only results beyond the token, up to the value specified by MaxResults . Required.
  • MaxResults (integer) -- The maximum number of results to include in the response. If more results exist than the specified MaxResults value, a token is included in the response so that the remaining results can be retrieved. Required.
  • Filters (list) --

    The filters to use for listing a specific set of users. Required. Supported filter keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the filtered set of users. Required. Supported sort keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

Return type

dict

Returns

Response Syntax

{
    'Users': [
        {
            'UserArn': 'string',
            'FirstName': 'string',
            'LastName': 'string',
            'Email': 'string',
            'EnrollmentStatus': 'INITIALIZED'|'PENDING'|'REGISTERED'|'DISASSOCIATING'|'DEREGISTERING',
            'EnrollmentId': 'string'
        },
    ],
    'NextToken': 'string',
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Users (list) --

      The users that meet the specified set of filter criteria, in sort order.

      • (dict) --

        Information related to a user.

        • UserArn (string) --

          The ARN of a user.

        • FirstName (string) --

          The first name of a user.

        • LastName (string) --

          The last name of a user.

        • Email (string) --

          The email of a user.

        • EnrollmentStatus (string) --

          The enrollment status of a user.

        • EnrollmentId (string) --

          The enrollment ARN of a user.

    • NextToken (string) --

      The token returned to indicate that there is more data available.

    • TotalCount (integer) --

      The total number of users returned.

send_invitation(**kwargs)

Sends an enrollment invitation email with a URL to a user. The URL is valid for 72 hours or until you call this operation again, whichever comes first.

See also: AWS API Documentation

Request Syntax

response = client.send_invitation(
    UserArn='string'
)
Parameters
UserArn (string) -- The ARN of the user to whom to send an invitation. Required.
Return type
dict
Returns
Response Syntax
{}

Response Structure

  • (dict) --
start_device_sync(**kwargs)

Resets a device and its account to the known default settings, by clearing all information and settings set by previous users.

See also: AWS API Documentation

Request Syntax

response = client.start_device_sync(
    RoomArn='string',
    DeviceArn='string',
    Features=[
        'BLUETOOTH'|'VOLUME'|'NOTIFICATIONS'|'LISTS'|'SKILLS'|'ALL',
    ]
)
Parameters
  • RoomArn (string) -- The ARN of the room with which the device to sync is associated. Required.
  • DeviceArn (string) -- The ARN of the device to sync. Required.
  • Features (list) --

    [REQUIRED]

    Request structure to start the device sync. Required.

    • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

tag_resource(**kwargs)

Adds metadata tags to a specified resource.

See also: AWS API Documentation

Request Syntax

response = client.tag_resource(
    Arn='string',
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters
  • Arn (string) --

    [REQUIRED]

    The ARN of the resource to which to add metadata tags. Required.

  • Tags (list) --

    [REQUIRED]

    The tags to be added to the specified resource. Do not provide system tags. Required.

    • (dict) --

      A key-value pair that can be associated with a resource.

      • Key (string) --

        The key of a tag. Tag keys are case-sensitive.

      • Value (string) --

        The value of a tag. Tag values are case-sensitive and can be null.

Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

untag_resource(**kwargs)

Removes metadata tags from a specified resource.

See also: AWS API Documentation

Request Syntax

response = client.untag_resource(
    Arn='string',
    TagKeys=[
        'string',
    ]
)
Parameters
  • Arn (string) --

    [REQUIRED]

    The ARN of the resource from which to remove metadata tags. Required.

  • TagKeys (list) --

    [REQUIRED]

    The tags to be removed from the specified resource. Do not provide system tags. Required.

    • (string) --
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

update_address_book(**kwargs)

Updates address book details by the address book ARN.

See also: AWS API Documentation

Request Syntax

response = client.update_address_book(
    AddressBookArn='string',
    Name='string',
    Description='string'
)
Parameters
  • AddressBookArn (string) --

    [REQUIRED]

    The ARN of the room to update.

  • Name (string) -- The updated name of the room.
  • Description (string) -- The updated description of the room.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

update_contact(**kwargs)

Updates the contact details by the contact ARN.

See also: AWS API Documentation

Request Syntax

response = client.update_contact(
    ContactArn='string',
    DisplayName='string',
    FirstName='string',
    LastName='string',
    PhoneNumber='string'
)
Parameters
  • ContactArn (string) --

    [REQUIRED]

    The ARN of the contact to update.

  • DisplayName (string) -- The updated display name of the contact.
  • FirstName (string) -- The updated first name of the contact.
  • LastName (string) -- The updated last name of the contact.
  • PhoneNumber (string) -- The updated phone number of the contact.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

update_device(**kwargs)

Updates the device name by device ARN.

See also: AWS API Documentation

Request Syntax

response = client.update_device(
    DeviceArn='string',
    DeviceName='string'
)
Parameters
  • DeviceArn (string) -- The ARN of the device to update. Required.
  • DeviceName (string) -- The updated device name. Required.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

update_profile(**kwargs)

Updates an existing room profile by room profile ARN.

See also: AWS API Documentation

Request Syntax

response = client.update_profile(
    ProfileArn='string',
    ProfileName='string',
    Timezone='string',
    Address='string',
    DistanceUnit='METRIC'|'IMPERIAL',
    TemperatureUnit='FAHRENHEIT'|'CELSIUS',
    WakeWord='ALEXA'|'AMAZON'|'ECHO'|'COMPUTER',
    SetupModeDisabled=True|False,
    MaxVolumeLimit=123,
    PSTNEnabled=True|False
)
Parameters
  • ProfileArn (string) -- The ARN of the room profile to update. Required.
  • ProfileName (string) -- The updated name for the room profile.
  • Timezone (string) -- The updated timezone for the room profile.
  • Address (string) -- The updated address for the room profile.
  • DistanceUnit (string) -- The updated distance unit for the room profile.
  • TemperatureUnit (string) -- The updated temperature unit for the room profile.
  • WakeWord (string) -- The updated wake word for the room profile.
  • SetupModeDisabled (boolean) -- Whether the setup mode of the profile is enabled.
  • MaxVolumeLimit (integer) -- The updated maximum volume limit for the room profile.
  • PSTNEnabled (boolean) -- Whether the PSTN setting of the room profile is enabled.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

update_room(**kwargs)

Updates room details by room ARN.

See also: AWS API Documentation

Request Syntax

response = client.update_room(
    RoomArn='string',
    RoomName='string',
    Description='string',
    ProviderCalendarId='string',
    ProfileArn='string'
)
Parameters
  • RoomArn (string) -- The ARN of the room to update.
  • RoomName (string) -- The updated name for the room.
  • Description (string) -- The updated description for the room.
  • ProviderCalendarId (string) -- The updated provider calendar ARN for the room.
  • ProfileArn (string) -- The updated profile ARN for the room.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

update_skill_group(**kwargs)

Updates skill group details by skill group ARN.

See also: AWS API Documentation

Request Syntax

response = client.update_skill_group(
    SkillGroupArn='string',
    SkillGroupName='string',
    Description='string'
)
Parameters
  • SkillGroupArn (string) -- The ARN of the skill group to update.
  • SkillGroupName (string) -- The updated name for the skill group.
  • Description (string) -- The updated description for the skill group.
Return type

dict

Returns

Response Syntax

{}

Response Structure

  • (dict) --

Paginators

The available paginators are:

class AlexaForBusiness.Paginator.ListSkills
paginator = client.get_paginator('list_skills')
paginate(**kwargs)

Creates an iterator that will paginate through responses from AlexaForBusiness.Client.list_skills().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    SkillGroupArn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • SkillGroupArn (string) -- The ARN of the skill group for which to list enabled skills. Required.
  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'SkillSummaries': [
        {
            'SkillId': 'string',
            'SkillName': 'string',
            'SupportsLinking': True|False
        },
    ],

}

Response Structure

  • (dict) --

    • SkillSummaries (list) --

      The list of enabled skills requested. Required.

      • (dict) --

        The summary of skills.

        • SkillId (string) --

          The ARN of the skill summary.

        • SkillName (string) --

          The name of the skill.

        • SupportsLinking (boolean) --

          Linking support for a skill.

class AlexaForBusiness.Paginator.ListTags
paginator = client.get_paginator('list_tags')
paginate(**kwargs)

Creates an iterator that will paginate through responses from AlexaForBusiness.Client.list_tags().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Arn='string',
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • Arn (string) --

    [REQUIRED]

    The ARN of the specified resource for which to list tags.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'Tags': [
        {
            'Key': 'string',
            'Value': 'string'
        },
    ],

}

Response Structure

  • (dict) --

    • Tags (list) --

      The tags requested for the specified resource.

      • (dict) --

        A key-value pair that can be associated with a resource.

        • Key (string) --

          The key of a tag. Tag keys are case-sensitive.

        • Value (string) --

          The value of a tag. Tag values are case-sensitive and can be null.

class AlexaForBusiness.Paginator.SearchDevices
paginator = client.get_paginator('search_devices')
paginate(**kwargs)

Creates an iterator that will paginate through responses from AlexaForBusiness.Client.search_devices().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • Filters (list) --

    The filters to use to list a specified set of devices. Supported filter keys are DeviceName, DeviceStatus, DeviceStatusDetailCode, RoomName, DeviceType, DeviceSerialNumber, UnassociatedOnly, and ConnectionStatus (ONLINE and OFFLINE).

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of devices. Supported sort keys are DeviceName, DeviceStatus, RoomName, DeviceType, DeviceSerialNumber, and ConnectionStatus.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'Devices': [
        {
            'DeviceArn': 'string',
            'DeviceSerialNumber': 'string',
            'DeviceType': 'string',
            'DeviceName': 'string',
            'SoftwareVersion': 'string',
            'MacAddress': 'string',
            'DeviceStatus': 'READY'|'PENDING'|'WAS_OFFLINE'|'DEREGISTERED',
            'RoomArn': 'string',
            'RoomName': 'string',
            'DeviceStatusInfo': {
                'DeviceStatusDetails': [
                    {
                        'Code': 'DEVICE_SOFTWARE_UPDATE_NEEDED'|'DEVICE_WAS_OFFLINE'
                    },
                ],
                'ConnectionStatus': 'ONLINE'|'OFFLINE'
            }
        },
    ],
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Devices (list) --

      The devices that meet the specified set of filter criteria, in sort order.

      • (dict) --

        Device attributes.

        • DeviceArn (string) --

          The ARN of a device.

        • DeviceSerialNumber (string) --

          The serial number of a device.

        • DeviceType (string) --

          The type of a device.

        • DeviceName (string) --

          The name of a device.

        • SoftwareVersion (string) --

          The software version of a device.

        • MacAddress (string) --

          The MAC address of a device.

        • DeviceStatus (string) --

          The status of a device.

        • RoomArn (string) --

          The room ARN associated with a device.

        • RoomName (string) --

          The name of the room associated with a device.

        • DeviceStatusInfo (dict) --

          Detailed information about a device's status.

          • DeviceStatusDetails (list) --

            One or more device status detail descriptions.

            • (dict) --

              Details of a device’s status.

              • Code (string) --

                The device status detail code.

          • ConnectionStatus (string) --

            The latest available information about the connection status of a device.

    • TotalCount (integer) --

      The total number of devices returned.

class AlexaForBusiness.Paginator.SearchProfiles
paginator = client.get_paginator('search_profiles')
paginate(**kwargs)

Creates an iterator that will paginate through responses from AlexaForBusiness.Client.search_profiles().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • Filters (list) --

    The filters to use to list a specified set of room profiles. Supported filter keys are ProfileName and Address. Required.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of room profiles. Supported sort keys are ProfileName and Address.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'Profiles': [
        {
            'ProfileArn': 'string',
            'ProfileName': 'string',
            'Address': 'string',
            'Timezone': 'string',
            'DistanceUnit': 'METRIC'|'IMPERIAL',
            'TemperatureUnit': 'FAHRENHEIT'|'CELSIUS',
            'WakeWord': 'ALEXA'|'AMAZON'|'ECHO'|'COMPUTER'
        },
    ],
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Profiles (list) --

      The profiles that meet the specified set of filter criteria, in sort order.

      • (dict) --

        The data of a room profile.

        • ProfileArn (string) --

          The ARN of a room profile.

        • ProfileName (string) --

          The name of a room profile.

        • Address (string) --

          The address of a room profile.

        • Timezone (string) --

          The timezone of a room profile.

        • DistanceUnit (string) --

          The distance unit of a room profile.

        • TemperatureUnit (string) --

          The temperature unit of a room profile.

        • WakeWord (string) --

          The wake word of a room profile.

    • TotalCount (integer) --

      The total number of room profiles returned.

class AlexaForBusiness.Paginator.SearchRooms
paginator = client.get_paginator('search_rooms')
paginate(**kwargs)

Creates an iterator that will paginate through responses from AlexaForBusiness.Client.search_rooms().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • Filters (list) --

    The filters to use to list a specified set of rooms. The supported filter keys are RoomName and ProfileName.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of rooms. The supported sort keys are RoomName and ProfileName.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'Rooms': [
        {
            'RoomArn': 'string',
            'RoomName': 'string',
            'Description': 'string',
            'ProviderCalendarId': 'string',
            'ProfileArn': 'string',
            'ProfileName': 'string'
        },
    ],
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Rooms (list) --

      The rooms that meet the specified set of filter criteria, in sort order.

      • (dict) --

        The data of a room.

        • RoomArn (string) --

          The ARN of a room.

        • RoomName (string) --

          The name of a room.

        • Description (string) --

          The description of a room.

        • ProviderCalendarId (string) --

          The provider calendar ARN of a room.

        • ProfileArn (string) --

          The profile ARN of a room.

        • ProfileName (string) --

          The profile name of a room.

    • TotalCount (integer) --

      The total number of rooms returned.

class AlexaForBusiness.Paginator.SearchSkillGroups
paginator = client.get_paginator('search_skill_groups')
paginate(**kwargs)

Creates an iterator that will paginate through responses from AlexaForBusiness.Client.search_skill_groups().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • Filters (list) --

    The filters to use to list a specified set of skill groups. The supported filter key is SkillGroupName.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the specified set of skill groups. The supported sort key is SkillGroupName.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'SkillGroups': [
        {
            'SkillGroupArn': 'string',
            'SkillGroupName': 'string',
            'Description': 'string'
        },
    ],
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • SkillGroups (list) --

      The skill groups that meet the filter criteria, in sort order.

      • (dict) --

        The attributes of a skill group.

        • SkillGroupArn (string) --

          The skill group ARN of a skill group.

        • SkillGroupName (string) --

          The skill group name of a skill group.

        • Description (string) --

          The description of a skill group.

    • TotalCount (integer) --

      The total number of skill groups returned.

class AlexaForBusiness.Paginator.SearchUsers
paginator = client.get_paginator('search_users')
paginate(**kwargs)

Creates an iterator that will paginate through responses from AlexaForBusiness.Client.search_users().

See also: AWS API Documentation

Request Syntax

response_iterator = paginator.paginate(
    Filters=[
        {
            'Key': 'string',
            'Values': [
                'string',
            ]
        },
    ],
    SortCriteria=[
        {
            'Key': 'string',
            'Value': 'ASC'|'DESC'
        },
    ],
    PaginationConfig={
        'MaxItems': 123,
        'PageSize': 123,
        'StartingToken': 'string'
    }
)
Parameters
  • Filters (list) --

    The filters to use for listing a specific set of users. Required. Supported filter keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

    • (dict) --

      A filter name and value pair that is used to return a more specific list of results. Filters can be used to match a set of resources by various criteria.

      • Key (string) -- [REQUIRED]

        The key of a filter.

      • Values (list) -- [REQUIRED]

        The values of a filter.

        • (string) --
  • SortCriteria (list) --

    The sort order to use in listing the filtered set of users. Required. Supported sort keys are UserId, FirstName, LastName, Email, and EnrollmentStatus.

    • (dict) --

      An object representing a sort criteria.

      • Key (string) -- [REQUIRED]

        The sort key of a sort object.

      • Value (string) -- [REQUIRED]

        The sort value of a sort object.

  • PaginationConfig (dict) --

    A dictionary that provides parameters to control pagination.

    • MaxItems (integer) --

      The total number of items to return. If the total number of items available is more than the value specified in max-items then a NextToken will be provided in the output that you can use to resume pagination.

    • PageSize (integer) --

      The size of each page.

    • StartingToken (string) --

      A token to specify where to start paginating. This is the NextToken from a previous response.

Return type

dict

Returns

Response Syntax

{
    'Users': [
        {
            'UserArn': 'string',
            'FirstName': 'string',
            'LastName': 'string',
            'Email': 'string',
            'EnrollmentStatus': 'INITIALIZED'|'PENDING'|'REGISTERED'|'DISASSOCIATING'|'DEREGISTERING',
            'EnrollmentId': 'string'
        },
    ],
    'TotalCount': 123
}

Response Structure

  • (dict) --

    • Users (list) --

      The users that meet the specified set of filter criteria, in sort order.

      • (dict) --

        Information related to a user.

        • UserArn (string) --

          The ARN of a user.

        • FirstName (string) --

          The first name of a user.

        • LastName (string) --

          The last name of a user.

        • Email (string) --

          The email of a user.

        • EnrollmentStatus (string) --

          The enrollment status of a user.

        • EnrollmentId (string) --

          The enrollment ARN of a user.

    • TotalCount (integer) --

      The total number of users returned.