Acciones, recursos y claves de condición para Alexa for Business - Referencia de autorizaciones de servicio
ActionsTipos de recursoClaves de condición

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:

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 de 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