Acciones, recursos y claves de condición para Alexa for Business

Alexa for Business (prefijo de servicio: a4b) proporciona las siguientes claves de contexto de condición, acciones y recursos específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

• Obtenga información para configurar este servicio.

• Vea una lista de las operaciones de API disponibles para este servicio.

• Obtenga información sobre cómo proteger este servicio y sus recursos mediante las políticas de permisos del IAM.

Acciones definidas por Alexa for Business

Puede especificar las siguientes acciones en el elemento Action de una declaración de política de IAM. Utilice políticas para conceder permisos para realizar una operación en AWS. Cuando utiliza una acción en una política, normalmente permite o deniega el acceso a la operación de la API o comandos de la CLI con el mismo nombre. No obstante, en algunos casos, una sola acción controla el acceso a más de una operación. Asimismo, algunas operaciones requieren varias acciones diferentes.

La columna Tipos de recurso de la tabla de Acción indica si cada acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") a los que aplica la política en el elemento Resource de la instrucción de su política. Si la columna incluye un tipo de recurso, puede especificar un ARN de ese tipo en una instrucción con dicha acción. Si la acción tiene uno o más recursos necesarios, la persona que llama debe tener permiso para usar la acción con esos recursos. Los recursos necesarios se indican en la tabla con un asterisco (*). Si limita el acceso a los recursos con el elemento Resource de una política de IAM, debe incluir un ARN o patrón para cada tipo de recurso requerido. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno de los tipos de recursos opcionales.

La columna Claves de condición de la tabla Acciones incluye claves que puede especificar en el elemento Condition de la instrucción de una política. Para obtener más información sobre las claves de condición asociadas a los recursos del servicio, consulte la columna Claves de condición de la tabla Tipos de recursos.

nota

Las claves de condición de recursos se enumeran en la tabla Tipos de recursos. Encontrará un enlace al tipo de recurso que se aplica a una acción en la columna Tipos de recursos (*obligatorio) de la tabla Acciones. El tipo de recurso de la tabla Tipos de recursos incluye la columna Claves de condición, que son las claves de condición del recurso que se aplican a una acción de la tabla Acciones.

Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Acciones.

Acciones	Descripción	Nivel de acceso	Tipos de recursos (*necesarios)	Claves de condición	Acciones dependientes
ApproveSkill	Concede permiso para asociar una habilidad a la organización en la Cuenta de AWS del cliente.	Write
AssociateContactWithAddressBook	Concede permiso para asociar un contacto con una libreta de direcciones determinada	Write	addressbook*
			contact*
AssociateDeviceWithNetworkProfile	Concede permiso para asociar un dispositivo con el perfil de red especificado	Write	device*
			networkprofile*
AssociateDeviceWithRoom	Concede permiso para asociar un dispositivo con una sala determinada	Write	device*
			room*
AssociateSkillGroupWithRoom	Concede permiso para asociar el grupo de habilidades a una habitación determinada	Write	room*
			skillgroup*
AssociateSkillWithSkillGroup	Concede permiso para asociar una habilidad a un grupo de habilidades	Write	skillgroup*
AssociateSkillWithUsers	Concede permiso para poner una habilidad privada a disposición de los usuarios inscritos para que la habiliten en sus dispositivos	Write
CompleteRegistration [solo permiso]	Concede permiso para completar la operación de registro de un dispositivo Alexa	Write
CreateAddressBook	Concede permiso para crear una libreta de direcciones con los detalles especificados	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateBusinessReportSchedule	Concede permiso para crear una programación recurrente para entregar informes de uso a la ubicación especificada de S3 con un intervalo diario o semanal determinado	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateConferenceProvider	Concede permiso para agregar un nuevo proveedor de conferencias en la Cuenta de AWS del usuario.	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateContact	Concede permiso para crear un contacto con los detalles especificados	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateGatewayGroup	Concede permiso para crear un grupo de gateway con los detalles especificados	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateNetworkProfile	Concede permiso para crear un perfil de red con los detalles especificados	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateProfile	Concede permiso para crear un nuevo proyecto	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateRoom	Concede permiso para crear una sala con los detalles especificados	Write	profile*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateSkillGroup	Concede permiso para crear un grupo de habilidades con nombre y descripción dados	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreateUser	Concede permiso para crear un usuario	Write	user*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAddressBook	Concede permiso para eliminar una libreta de direcciones por el ARN de la libreta de direcciones	Write	addressbook*
DeleteBusinessReportSchedule	Concede permiso para eliminar la programación recurrente de entrega de informes con el ARN de programación especificado	Write	schedule*
DeleteConferenceProvider	Concede permiso para eliminar un proveedor de conferencia	Write	conferenceprovider*
DeleteContact	Concede permiso para eliminar un contacto mediante el ARN de contactos	Write	contact*
DeleteDevice	Concede permiso para quitar un dispositivo de Alexa For Business	Write	device*
DeleteDeviceUsageData	Concede permiso para eliminar todo el historial anterior del dispositivo de datos de entrada de voz y datos de respuesta asociados	Write	device*
DeleteGatewayGroup	Concede permiso para eliminar un grupo de gateway	Write	gatewaygroup*
DeleteNetworkProfile	Concede permiso para eliminar un perfil de red mediante el ARN del perfil de red	Write	networkprofile*
DeleteProfile	Concede permiso para eliminar perfil mediante el ARN de perfil	Write	profile*
DeleteRoom	Concede permiso para eliminar una sala	Write	room*
DeleteRoomSkillParameter	Concede permiso para eliminar un parámetro de una habilidad y una sala	Write	room*
DeleteSkillAuthorization	Concede permiso para desvincular una cuenta de terceros de una habilidad	Write	room*
DeleteSkillGroup	Concede permiso para eliminar un grupo de habilidades con ARN del grupo de habilidades	Write	skillgroup*
DeleteUser	Concede permiso para eliminar un usuario	Write	user*
DisassociateContactFromAddressBook	Concede permiso para desasociar a un contacto de una libreta de direcciones determinada	Write	addressbook*
			contact*
DisassociateDeviceFromRoom	Concede permiso para desasociar el dispositivo de su sala actual	Write	device*
DisassociateSkillFromSkillGroup	Concede permiso para desasociar una habilidad de un grupo de habilidades	Write	skillgroup*
DisassociateSkillFromUsers	Concede permiso para hacer que una habilidad privada deje de estar disponible para los usuarios inscritos y les impide que la habiliten en sus dispositivos	Write	user*
DisassociateSkillGroupFromRoom	Concede permiso para desasociar al grupo de habilidades de una sala determinada	Write	room*
			skillgroup*
ForgetSmartHomeAppliances	Concede permiso para olvidar electrodomésticos inteligentes asociados a una sala	Write	room*
GetAddressBook	Concede permiso para obtener los detalles de la libreta de direcciones por el ARN de la libreta de direcciones	Read	addressbook*
GetConferencePreference	Concede permiso para recuperar las preferencias de las conferencia existentes	Read
GetConferenceProvider	Concede permiso para obtener detalles sobre un proveedor de conferencias específico	Read	conferenceprovider*
GetContact	Concede permiso para obtener los datos de contacto por el ARN de contacto	Read	contact*
GetDevice	Concede permiso para obtener detalles del dispositivo	Read	device*
GetGateway	Concede permiso para recuperar los detalles de una gateway	Read	gateway*
GetGatewayGroup	Concede permiso para recuperar los detalles de un grupo de gateway	Read	gatewaygroup*
GetInvitationConfiguration	Concede permiso para recuperar los valores configurados para la plantilla de correo electrónico de invitación de inscripción de usuario	Read
GetNetworkProfile	Concede permiso para obtener los detalles del perfil de red por el ARN del perfil de red	Read	networkprofile*
GetProfile	Concede permiso para obtener el perfil cuando se proporciona con ARN de perfil	Read	profile*
GetRoom	Concede permiso para obtener detalles de la sala	Read	room*
GetRoomSkillParameter	Concede permiso para obtener un parámetro existente que se ha establecido para una habilidad y una sala	Read	room*
GetSkillGroup	Concede permiso para obtener detalles del grupo de habilidades con ARN del grupo de habilidades	Read	skillgroup*
ListBusinessReportSchedules	Concede permiso para enumerar los detalles de las programaciones configuradas por un usuario	List
ListConferenceProviders	Concede permiso para enumerar proveedores de conferencias en una Cuenta de AWS específica.	List
ListDeviceEvents	Concede permiso para enumerar el historial de eventos del dispositivo, incluido el estado de conexión de dispositivo, durante un máximo de 30 días	List	device*
ListGatewayGroups	Concede permiso para mostrar resúmenes de grupos de gateway	List
ListGateways	Concede permiso para enumerar resúmenes de gateway	List	gatewaygroup*
ListSkills	Concede permiso para enumerar habilidades	List
ListSkillsStoreCategories	Concede permiso para enumerar todas las categorías en la tienda de habilidades Alexa	List
ListSkillsStoreSkillsByCategory	Concede permiso para enumerar todas las habilidades de la tienda de habilidades de Alexa por categoría	List
ListSmartHomeAppliances	Concede permiso para enumerar todos los electrodomésticos inteligentes asociados a una sala	List	room*
ListTags	Concede permiso para enumerar todas las etiquetas para un recurso	Read	device
			room
			user
PutConferencePreference	Concede permiso para establecer las preferencias de conferencia de un proveedor de servicios de conferencias en el nivel de cuenta	Write
PutDeviceSetupEvents [solo permiso]	Concede permiso para publicar eventos de configuración de dispositivos Alexa	Write
PutInvitationConfiguration	Concede permiso para configurar la plantilla de correo electrónico para la invitación de inscripción de usuario con los atributos especificados	Write
PutRoomSkillParameter	Concede permiso para poner un parámetro específico de sala para una habilidad	Write	room*
PutSkillAuthorization	Concede permiso para vincular la cuenta de un usuario a un proveedor de habilidades de terceros	Write	room*
RegisterAVSDevice	Concede permiso para registrar un dispositivo con tecnología Alexa desarrollado por un fabricante de equipos originales (Original Equipment Manufacturer, OEM) mediante el servicio de voz de Alexa (Alexa Voice Service, AVS).	Write		aws:RequestTag/${TagKey} aws:TagKeys
RegisterDevice [solo permiso]	Concede permiso para registrar un dispositivo Alexa	Write
RejectSkill	Concede permiso para desvincular una habilidad de la organización en la Cuenta de AWS de un usuario.	Write
ResolveRoom	Concede permiso para resolver la información de la sala	Read
RevokeInvitation	Concede permiso para revocar una invitación	Write	user*
SearchAddressBooks	Concede permiso para buscar en las libretas de direcciones y enumerar las que cumplen un conjunto de criterios de filtrado y ordenación	List
SearchContacts	Concede permiso para buscar contactos y enumerar los que cumplen un conjunto de criterios de filtrado y ordenación	List
SearchDevices	Concede permiso para buscar dispositivos	List
SearchNetworkProfiles	Concede permiso para buscar perfiles de red y enumerar los que cumplen un conjunto de criterios de filtrado y ordenación	List
SearchProfiles	Concede permiso para buscar perfiles	List
SearchRooms	Concede permiso para buscar salas	List
SearchSkillGroups	Concede permiso para buscar grupos de habilidades	List
SearchUsers	Concede permiso para buscar usuarios	List
SendAnnouncement	Concede permiso para activar un flujo asincrónico para enviar mensajes de texto, SSML o anuncios de audio a salas identificadas por una búsqueda o filtro	Write
SendInvitation	Concede permiso para enviar una invitación a un usuario	Write	user*
StartDeviceSync	Concede permiso para restaurar el dispositivo y su cuenta a su configuración predeterminada conocida borrando toda la información y los ajustes establecidos por los usuarios anteriores	Write
StartSmartHomeApplianceDiscovery	Concede permiso para iniciar la detección de los dispositivos de hogar inteligente asociados a la sala	Read	room*
TagResource	Concede permiso para agregar etiquetas de metadatos a un recurso	Etiquetado	device
			room
			user
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Concede permiso para eliminar etiquetas de metadatos de un recurso	Etiquetado	device
			room
			user
UpdateAddressBook	Concede permiso para actualizar los detalles de la libreta de direcciones por el ARN de la libreta	Write	addressbook*
UpdateBusinessReportSchedule	Concede permiso para actualizar la configuración de la programación de entrega de informes con el ARN de programación especificado	Write	schedule*
UpdateConferenceProvider	Concede permiso para actualizar la configuración de un proveedor de conferencia existente	Write	conferenceprovider*
UpdateContact	Concede permiso para actualizar los datos de contacto por el ARN de contacto	Write	contact*
UpdateDevice	Concede permiso para actualizar el nombre del dispositivo	Write	device*
UpdateGateway	Concede permiso para actualizar los detalles de una gateway	Write	gateway*
UpdateGatewayGroup	Concede permiso para actualizar los detalles de un grupo de gateway	Write	gatewaygroup*
UpdateNetworkProfile	Concede permiso para actualizar un perfil de red mediante el ARN del perfil de red	Write	networkprofile*
UpdateProfile	Concede permiso para actualizar un perfil existente	Write	profile*
UpdateRoom	Concede permiso para actualizar detalles de la habitación	Write	room*
UpdateSkillGroup	Concede permiso para actualizar los detalles del grupo de habilidades con ARN del grupo de habilidades	Write	skillgroup*

Tipos de recursos definidos por Alexa for Business

Los siguientes tipos de recurso están definidos por este servicio y se pueden utilizar en el elemento Resource de las instrucciones de política de permisos de IAM. Cada acción de la tabla Acciones identifica los tipos de recursos que se pueden especificar con dicha acción. Un tipo de recurso también puede definir qué claves de condición se pueden incluir en una política. Estas claves se muestran en la última columna de la tabla Tipos de recursos. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Tipos de recurso.

Tipos de recurso	ARN	Claves de condición
profile	arn:${Partition}:a4b:${Region}:${Account}:profile/${ResourceId}
room	arn:${Partition}:a4b:${Region}:${Account}:room/${ResourceId}	aws:ResourceTag/${TagKey}
device	arn:${Partition}:a4b:${Region}:${Account}:device/${ResourceId}	aws:ResourceTag/${TagKey}
skillgroup	arn:${Partition}:a4b:${Region}:${Account}:skill-group/${ResourceId}
user	arn:${Partition}:a4b:${Region}:${Account}:user/${ResourceId}	aws:ResourceTag/${TagKey}
addressbook	arn:${Partition}:a4b:${Region}:${Account}:address-book/${ResourceId}
conferenceprovider	arn:${Partition}:a4b:${Region}:${Account}:conference-provider/${ResourceId}
contact	arn:${Partition}:a4b:${Region}:${Account}:contact/${ResourceId}
schedule	arn:${Partition}:a4b:${Region}:${Account}:schedule/${ResourceId}
networkprofile	arn:${Partition}:a4b:${Region}:${Account}:network-profile/${ResourceId}
gateway	arn:${Partition}:a4b:${Region}:${Account}:gateway/${ResourceId}
gatewaygroup	arn:${Partition}:a4b:${Region}:${Account}:gateway-group/${ResourceId}

Claves de condición para Alexa for Business

Alexa for Business define las siguientes claves de condiciones que se pueden utilizar en el elemento Condition de una política de IAM. Puede utilizar estas claves para ajustar más las condiciones en las que se aplica la instrucción de política. Para obtener información detallada sobre las columnas de la siguiente tabla, consulte Tabla Claves de condición.

Para ver las claves de condición globales que están disponibles para todos los servicios, consulte Claves de condición globales disponibles.

Claves de condición	Descripción	Tipo
a4b:amazonId	Filtra acciones en función del ID de Amazon en la solicitud.	Cadena
a4b:filters_deviceType	Filtra acciones en función del tipo de dispositivo en la solicitud.	ArrayOfString
aws:RequestTag/${TagKey}	Filtra acciones en función del conjunto de valores permitidos para cada una de las etiquetas.	Cadena
aws:ResourceTag/${TagKey}	Filtra acciones en función del valor-etiqueta asociado con el recurso.	Cadena
aws:TagKeys	Filtra acciones en función de la presencia de etiquetas obligatorias en la solicitud.	ArrayOfString