@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AmazonAlexaForBusinessClient extends AmazonWebServiceClient implements AmazonAlexaForBusiness
Alexa for Business makes it easy for you to use Alexa in your organization. Alexa for Business gives you the tools you need for managing Alexa devices, enroll your users, and assign skills, at scale. You can build your own context-aware voice skills using the Alexa Skills Kit and the Alexa for Business API operations. You can make also these available as private skills for your organization. Alexa for Business makes it easy to voice-enable your products and services, providing context-aware voice experiences for your customers.
LOGGING_AWS_REQUEST_METRIC
ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
AssociateContactWithAddressBookResult |
associateContactWithAddressBook(AssociateContactWithAddressBookRequest request)
Associates a contact with a given address book.
|
AssociateDeviceWithRoomResult |
associateDeviceWithRoom(AssociateDeviceWithRoomRequest request)
Associates a device with a given room.
|
AssociateSkillGroupWithRoomResult |
associateSkillGroupWithRoom(AssociateSkillGroupWithRoomRequest request)
Associates a skill group with a given room.
|
static AmazonAlexaForBusinessClientBuilder |
builder() |
CreateAddressBookResult |
createAddressBook(CreateAddressBookRequest request)
Creates an address book with the specified details.
|
CreateContactResult |
createContact(CreateContactRequest request)
Creates a contact with the specified details.
|
CreateProfileResult |
createProfile(CreateProfileRequest request)
Creates a new room profile with the specified details.
|
CreateRoomResult |
createRoom(CreateRoomRequest request)
Creates a room with the specified details.
|
CreateSkillGroupResult |
createSkillGroup(CreateSkillGroupRequest request)
Creates a skill group with a specified name and description.
|
CreateUserResult |
createUser(CreateUserRequest request)
Creates a user.
|
DeleteAddressBookResult |
deleteAddressBook(DeleteAddressBookRequest request)
Deletes an address book by the address book ARN.
|
DeleteContactResult |
deleteContact(DeleteContactRequest request)
Deletes a contact by the contact ARN.
|
DeleteProfileResult |
deleteProfile(DeleteProfileRequest request)
Deletes a room profile by the profile ARN.
|
DeleteRoomResult |
deleteRoom(DeleteRoomRequest request)
Deletes a room by the room ARN.
|
DeleteRoomSkillParameterResult |
deleteRoomSkillParameter(DeleteRoomSkillParameterRequest request)
Deletes room skill parameter details by room, skill, and parameter key ID.
|
DeleteSkillGroupResult |
deleteSkillGroup(DeleteSkillGroupRequest request)
Deletes a skill group by skill group ARN.
|
DeleteUserResult |
deleteUser(DeleteUserRequest request)
Deletes a specified user by user ARN and enrollment ARN.
|
DisassociateContactFromAddressBookResult |
disassociateContactFromAddressBook(DisassociateContactFromAddressBookRequest request)
Disassociates a contact from a given address book.
|
DisassociateDeviceFromRoomResult |
disassociateDeviceFromRoom(DisassociateDeviceFromRoomRequest request)
Disassociates a device from its current room.
|
DisassociateSkillGroupFromRoomResult |
disassociateSkillGroupFromRoom(DisassociateSkillGroupFromRoomRequest request)
Disassociates a skill group from a specified room.
|
GetAddressBookResult |
getAddressBook(GetAddressBookRequest request)
Gets address the book details by the address book ARN.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful, request, typically used for debugging issues
where a service isn't acting as expected.
|
GetContactResult |
getContact(GetContactRequest request)
Gets the contact details by the contact ARN.
|
GetDeviceResult |
getDevice(GetDeviceRequest request)
Gets the details of a device by device ARN.
|
GetProfileResult |
getProfile(GetProfileRequest request)
Gets the details of a room profile by profile ARN.
|
GetRoomResult |
getRoom(GetRoomRequest request)
Gets room details by room ARN.
|
GetRoomSkillParameterResult |
getRoomSkillParameter(GetRoomSkillParameterRequest request)
Gets room skill parameter details by room, skill, and parameter key ARN.
|
GetSkillGroupResult |
getSkillGroup(GetSkillGroupRequest request)
Gets skill group details by skill group ARN.
|
ListDeviceEventsResult |
listDeviceEvents(ListDeviceEventsRequest request)
Lists the device event history, including device connection status, for up to 30 days.
|
ListSkillsResult |
listSkills(ListSkillsRequest request)
Lists all enabled skills in a specific skill group.
|
ListTagsResult |
listTags(ListTagsRequest request)
Lists all tags for the specified resource.
|
PutRoomSkillParameterResult |
putRoomSkillParameter(PutRoomSkillParameterRequest request)
Updates room skill parameter details by room, skill, and parameter key ID.
|
ResolveRoomResult |
resolveRoom(ResolveRoomRequest request)
Determines the details for the room from which a skill request was invoked.
|
RevokeInvitationResult |
revokeInvitation(RevokeInvitationRequest request)
Revokes an invitation and invalidates the enrollment URL.
|
SearchAddressBooksResult |
searchAddressBooks(SearchAddressBooksRequest request)
Searches address books and lists the ones that meet a set of filter and sort criteria.
|
SearchContactsResult |
searchContacts(SearchContactsRequest request)
Searches contacts and lists the ones that meet a set of filter and sort criteria.
|
SearchDevicesResult |
searchDevices(SearchDevicesRequest request)
Searches devices and lists the ones that meet a set of filter criteria.
|
SearchProfilesResult |
searchProfiles(SearchProfilesRequest request)
Searches room profiles and lists the ones that meet a set of filter criteria.
|
SearchRoomsResult |
searchRooms(SearchRoomsRequest request)
Searches rooms and lists the ones that meet a set of filter and sort criteria.
|
SearchSkillGroupsResult |
searchSkillGroups(SearchSkillGroupsRequest request)
Searches skill groups and lists the ones that meet a set of filter and sort criteria.
|
SearchUsersResult |
searchUsers(SearchUsersRequest request)
Searches users and lists the ones that meet a set of filter and sort criteria.
|
SendInvitationResult |
sendInvitation(SendInvitationRequest request)
Sends an enrollment invitation email with a URL to a user.
|
StartDeviceSyncResult |
startDeviceSync(StartDeviceSyncRequest request)
Resets a device and its account to the known default settings, by clearing all information and settings set by
previous users.
|
TagResourceResult |
tagResource(TagResourceRequest request)
Adds metadata tags to a specified resource.
|
UntagResourceResult |
untagResource(UntagResourceRequest request)
Removes metadata tags from a specified resource.
|
UpdateAddressBookResult |
updateAddressBook(UpdateAddressBookRequest request)
Updates address book details by the address book ARN.
|
UpdateContactResult |
updateContact(UpdateContactRequest request)
Updates the contact details by the contact ARN.
|
UpdateDeviceResult |
updateDevice(UpdateDeviceRequest request)
Updates the device name by device ARN.
|
UpdateProfileResult |
updateProfile(UpdateProfileRequest request)
Updates an existing room profile by room profile ARN.
|
UpdateRoomResult |
updateRoom(UpdateRoomRequest request)
Updates room details by room ARN.
|
UpdateSkillGroupResult |
updateSkillGroup(UpdateSkillGroupRequest request)
Updates skill group details by skill group ARN.
|
addRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, shutdown, withEndpoint, withRegion, withRegion, withTimeOffset
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
shutdown
public static AmazonAlexaForBusinessClientBuilder builder()
public AssociateContactWithAddressBookResult associateContactWithAddressBook(AssociateContactWithAddressBookRequest request)
Associates a contact with a given address book.
associateContactWithAddressBook
in interface AmazonAlexaForBusiness
associateContactWithAddressBookRequest
- LimitExceededException
- You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400public AssociateDeviceWithRoomResult associateDeviceWithRoom(AssociateDeviceWithRoomRequest request)
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.
associateDeviceWithRoom
in interface AmazonAlexaForBusiness
associateDeviceWithRoomRequest
- LimitExceededException
- You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400DeviceNotRegisteredException
- The request failed because this device is no longer registered and therefore no longer managed by this
account.public AssociateSkillGroupWithRoomResult associateSkillGroupWithRoom(AssociateSkillGroupWithRoomRequest request)
Associates a skill group with a given room. This enables all skills in the associated skill group on all devices in the room.
associateSkillGroupWithRoom
in interface AmazonAlexaForBusiness
associateSkillGroupWithRoomRequest
- public CreateAddressBookResult createAddressBook(CreateAddressBookRequest request)
Creates an address book with the specified details.
createAddressBook
in interface AmazonAlexaForBusiness
createAddressBookRequest
- AlreadyExistsException
- The resource being created already exists. HTTP Status Code: 400LimitExceededException
- You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400public CreateContactResult createContact(CreateContactRequest request)
Creates a contact with the specified details.
createContact
in interface AmazonAlexaForBusiness
createContactRequest
- AlreadyExistsException
- The resource being created already exists. HTTP Status Code: 400LimitExceededException
- You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400public CreateProfileResult createProfile(CreateProfileRequest request)
Creates a new room profile with the specified details.
createProfile
in interface AmazonAlexaForBusiness
createProfileRequest
- LimitExceededException
- You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400AlreadyExistsException
- The resource being created already exists. HTTP Status Code: 400public CreateRoomResult createRoom(CreateRoomRequest request)
Creates a room with the specified details.
createRoom
in interface AmazonAlexaForBusiness
createRoomRequest
- AlreadyExistsException
- The resource being created already exists. HTTP Status Code: 400LimitExceededException
- You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400public CreateSkillGroupResult createSkillGroup(CreateSkillGroupRequest request)
Creates a skill group with a specified name and description.
createSkillGroup
in interface AmazonAlexaForBusiness
createSkillGroupRequest
- AlreadyExistsException
- The resource being created already exists. HTTP Status Code: 400LimitExceededException
- You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400public CreateUserResult createUser(CreateUserRequest request)
Creates a user.
createUser
in interface AmazonAlexaForBusiness
createUserRequest
- ResourceInUseException
- The resource in the request is already in use. HTTP Status Code: 400LimitExceededException
- You are performing an action that would put you beyond your account's limits. HTTP Status Code: 400public DeleteAddressBookResult deleteAddressBook(DeleteAddressBookRequest request)
Deletes an address book by the address book ARN.
deleteAddressBook
in interface AmazonAlexaForBusiness
deleteAddressBookRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public DeleteContactResult deleteContact(DeleteContactRequest request)
Deletes a contact by the contact ARN.
deleteContact
in interface AmazonAlexaForBusiness
deleteContactRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public DeleteProfileResult deleteProfile(DeleteProfileRequest request)
Deletes a room profile by the profile ARN.
deleteProfile
in interface AmazonAlexaForBusiness
deleteProfileRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public DeleteRoomResult deleteRoom(DeleteRoomRequest request)
Deletes a room by the room ARN.
deleteRoom
in interface AmazonAlexaForBusiness
deleteRoomRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public DeleteRoomSkillParameterResult deleteRoomSkillParameter(DeleteRoomSkillParameterRequest request)
Deletes room skill parameter details by room, skill, and parameter key ID.
deleteRoomSkillParameter
in interface AmazonAlexaForBusiness
deleteRoomSkillParameterRequest
- public DeleteSkillGroupResult deleteSkillGroup(DeleteSkillGroupRequest request)
Deletes a skill group by skill group ARN.
deleteSkillGroup
in interface AmazonAlexaForBusiness
deleteSkillGroupRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public DeleteUserResult deleteUser(DeleteUserRequest request)
Deletes a specified user by user ARN and enrollment ARN.
deleteUser
in interface AmazonAlexaForBusiness
deleteUserRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public DisassociateContactFromAddressBookResult disassociateContactFromAddressBook(DisassociateContactFromAddressBookRequest request)
Disassociates a contact from a given address book.
disassociateContactFromAddressBook
in interface AmazonAlexaForBusiness
disassociateContactFromAddressBookRequest
- public DisassociateDeviceFromRoomResult disassociateDeviceFromRoom(DisassociateDeviceFromRoomRequest request)
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.
disassociateDeviceFromRoom
in interface AmazonAlexaForBusiness
disassociateDeviceFromRoomRequest
- DeviceNotRegisteredException
- The request failed because this device is no longer registered and therefore no longer managed by this
account.public DisassociateSkillGroupFromRoomResult disassociateSkillGroupFromRoom(DisassociateSkillGroupFromRoomRequest request)
Disassociates a skill group from a specified room. This disables all skills in the skill group on all devices in the room.
disassociateSkillGroupFromRoom
in interface AmazonAlexaForBusiness
disassociateSkillGroupFromRoomRequest
- public GetAddressBookResult getAddressBook(GetAddressBookRequest request)
Gets address the book details by the address book ARN.
getAddressBook
in interface AmazonAlexaForBusiness
getAddressBookRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public GetContactResult getContact(GetContactRequest request)
Gets the contact details by the contact ARN.
getContact
in interface AmazonAlexaForBusiness
getContactRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public GetDeviceResult getDevice(GetDeviceRequest request)
Gets the details of a device by device ARN.
getDevice
in interface AmazonAlexaForBusiness
getDeviceRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public GetProfileResult getProfile(GetProfileRequest request)
Gets the details of a room profile by profile ARN.
getProfile
in interface AmazonAlexaForBusiness
getProfileRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public GetRoomResult getRoom(GetRoomRequest request)
Gets room details by room ARN.
getRoom
in interface AmazonAlexaForBusiness
getRoomRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public GetRoomSkillParameterResult getRoomSkillParameter(GetRoomSkillParameterRequest request)
Gets room skill parameter details by room, skill, and parameter key ARN.
getRoomSkillParameter
in interface AmazonAlexaForBusiness
getRoomSkillParameterRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public GetSkillGroupResult getSkillGroup(GetSkillGroupRequest request)
Gets skill group details by skill group ARN.
getSkillGroup
in interface AmazonAlexaForBusiness
getSkillGroupRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public ListDeviceEventsResult listDeviceEvents(ListDeviceEventsRequest request)
Lists the device event history, including device connection status, for up to 30 days.
listDeviceEvents
in interface AmazonAlexaForBusiness
listDeviceEventsRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public ListSkillsResult listSkills(ListSkillsRequest request)
Lists all enabled skills in a specific skill group.
listSkills
in interface AmazonAlexaForBusiness
listSkillsRequest
- public ListTagsResult listTags(ListTagsRequest request)
Lists all tags for the specified resource.
listTags
in interface AmazonAlexaForBusiness
listTagsRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public PutRoomSkillParameterResult putRoomSkillParameter(PutRoomSkillParameterRequest request)
Updates room skill parameter details by room, skill, and parameter key ID. Not all skills have a room skill parameter.
putRoomSkillParameter
in interface AmazonAlexaForBusiness
putRoomSkillParameterRequest
- public ResolveRoomResult resolveRoom(ResolveRoomRequest request)
Determines the details for the room from which a skill request was invoked. This operation is used by skill developers.
resolveRoom
in interface AmazonAlexaForBusiness
resolveRoomRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public RevokeInvitationResult revokeInvitation(RevokeInvitationRequest request)
Revokes an invitation and invalidates the enrollment URL.
revokeInvitation
in interface AmazonAlexaForBusiness
revokeInvitationRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public SearchAddressBooksResult searchAddressBooks(SearchAddressBooksRequest request)
Searches address books and lists the ones that meet a set of filter and sort criteria.
searchAddressBooks
in interface AmazonAlexaForBusiness
searchAddressBooksRequest
- public SearchContactsResult searchContacts(SearchContactsRequest request)
Searches contacts and lists the ones that meet a set of filter and sort criteria.
searchContacts
in interface AmazonAlexaForBusiness
searchContactsRequest
- public SearchDevicesResult searchDevices(SearchDevicesRequest request)
Searches devices and lists the ones that meet a set of filter criteria.
searchDevices
in interface AmazonAlexaForBusiness
searchDevicesRequest
- public SearchProfilesResult searchProfiles(SearchProfilesRequest request)
Searches room profiles and lists the ones that meet a set of filter criteria.
searchProfiles
in interface AmazonAlexaForBusiness
searchProfilesRequest
- public SearchRoomsResult searchRooms(SearchRoomsRequest request)
Searches rooms and lists the ones that meet a set of filter and sort criteria.
searchRooms
in interface AmazonAlexaForBusiness
searchRoomsRequest
- public SearchSkillGroupsResult searchSkillGroups(SearchSkillGroupsRequest request)
Searches skill groups and lists the ones that meet a set of filter and sort criteria.
searchSkillGroups
in interface AmazonAlexaForBusiness
searchSkillGroupsRequest
- public SearchUsersResult searchUsers(SearchUsersRequest request)
Searches users and lists the ones that meet a set of filter and sort criteria.
searchUsers
in interface AmazonAlexaForBusiness
searchUsersRequest
- public SendInvitationResult sendInvitation(SendInvitationRequest request)
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.
sendInvitation
in interface AmazonAlexaForBusiness
sendInvitationRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400InvalidUserStatusException
- The attempt to update a user is invalid due to the user's current status. HTTP Status Code: 400public StartDeviceSyncResult startDeviceSync(StartDeviceSyncRequest request)
Resets a device and its account to the known default settings, by clearing all information and settings set by previous users.
startDeviceSync
in interface AmazonAlexaForBusiness
startDeviceSyncRequest
- DeviceNotRegisteredException
- The request failed because this device is no longer registered and therefore no longer managed by this
account.public TagResourceResult tagResource(TagResourceRequest request)
Adds metadata tags to a specified resource.
tagResource
in interface AmazonAlexaForBusiness
tagResourceRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public UntagResourceResult untagResource(UntagResourceRequest request)
Removes metadata tags from a specified resource.
untagResource
in interface AmazonAlexaForBusiness
untagResourceRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public UpdateAddressBookResult updateAddressBook(UpdateAddressBookRequest request)
Updates address book details by the address book ARN.
updateAddressBook
in interface AmazonAlexaForBusiness
updateAddressBookRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400NameInUseException
- The name sent in the request is already in use. HTTP Status Code: 400public UpdateContactResult updateContact(UpdateContactRequest request)
Updates the contact details by the contact ARN.
updateContact
in interface AmazonAlexaForBusiness
updateContactRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400public UpdateDeviceResult updateDevice(UpdateDeviceRequest request)
Updates the device name by device ARN.
updateDevice
in interface AmazonAlexaForBusiness
updateDeviceRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400DeviceNotRegisteredException
- The request failed because this device is no longer registered and therefore no longer managed by this
account.public UpdateProfileResult updateProfile(UpdateProfileRequest request)
Updates an existing room profile by room profile ARN.
updateProfile
in interface AmazonAlexaForBusiness
updateProfileRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400NameInUseException
- The name sent in the request is already in use. HTTP Status Code: 400public UpdateRoomResult updateRoom(UpdateRoomRequest request)
Updates room details by room ARN.
updateRoom
in interface AmazonAlexaForBusiness
updateRoomRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400NameInUseException
- The name sent in the request is already in use. HTTP Status Code: 400public UpdateSkillGroupResult updateSkillGroup(UpdateSkillGroupRequest request)
Updates skill group details by skill group ARN.
updateSkillGroup
in interface AmazonAlexaForBusiness
updateSkillGroupRequest
- NotFoundException
- The resource is not found. HTTP Status Code: 400NameInUseException
- The name sent in the request is already in use. HTTP Status Code: 400public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing the request.
getCachedResponseMetadata
in interface AmazonAlexaForBusiness
request
- The originally executed requestCopyright © 2013 Amazon Web Services, Inc. All Rights Reserved.