Acciones, recursos y claves de condición para Integraciones administradas de AWS IoT - Referencia de autorizaciones de servicio

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Acciones, recursos y claves de condición para Integraciones administradas de AWS IoT

AWS Las integraciones gestionadas de IoT (prefijo de servicio:iotmanagedintegrations) proporcionan los siguientes recursos, acciones y claves de contexto de condiciones específicos del servicio para su uso en las políticas de permisos de IAM.

Referencias:

Acciones definidas por Integraciones administradas de AWS IoT

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 Nivel de acceso de la tabla Acciones describe cómo se clasifica la acción (lista, lectura, administración de permisos o etiquetado). Esta clasificación puede ayudarle a entender el nivel de acceso que una acción concede cuando se utiliza en una política. Para obtener más información sobre los niveles de acceso, consulte Niveles de acceso en los resúmenes de políticas.

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.

La columna Acciones dependientes de la tabla Acciones muestra los permisos adicionales que pueden ser necesarios para llamar a una acción correctamente. Es posible que estos permisos sean necesarios además del permiso para la acción en sí. Cuando una acción especifica acciones dependientes, esas dependencias pueden aplicarse a los recursos adicionales definidos para esa acción, no solo al primer recurso de la tabla.

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
CreateAccountAssociation Concede permiso para crear una nueva asociación de cuenta. Escritura

aws:RequestTag/${TagKey}

aws:TagKeys

iotmanagedintegrations:connectorDestinationId

CreateCloudConnector Concede permiso para crear un nuevo conector de nube. Escritura
CreateConnectorDestination Concede permiso para crear un nuevo destino de conector. Escritura

iotmanagedintegrations:cloudConnectorId

CreateCredentialLocker Concede permiso para crear un casillero de credenciales de productos. Escritura

aws:RequestTag/${TagKey}

aws:TagKeys

CreateDestination Concede permiso para crear un nuevo destino. Escritura
CreateEventLogConfiguration Concede permiso para crear una nueva configuración de evento. Escritura
CreateManagedThing Concede permiso para crear un nuevo objeto administrado. Escritura

credential-locker

aws:RequestTag/${TagKey}

aws:TagKeys

CreateNotificationConfiguration Concede permiso para crear una nueva configuración de notificación. Escritura
CreateOtaTask Concede permiso para crear una nueva tarea OTA. Escritura

aws:RequestTag/${TagKey}

aws:TagKeys

CreateOtaTaskConfiguration Concede permiso para crear una nueva configuración de tarea OTA. Escritura
CreateProvisioningProfile Concede permiso para crear un nuevo perfil de aprovisionamiento. Escritura

aws:RequestTag/${TagKey}

aws:TagKeys

DeleteAccountAssociation Concede permiso para eliminar una asociación de cuenta. Escritura

account-association*

DeleteCloudConnector Concede permiso para eliminar un conector de nube. Escritura

iotmanagedintegrations:cloudConnectorId

DeleteConnectorDestination Concede permiso para eliminar un destino de conector. Escritura
DeleteCredentialLocker Concede permiso para eliminar un casillero de credenciales. Escritura

credential-locker*

DeleteDestination Concede permiso para eliminar un destino. Escritura
DeleteEventLogConfiguration Concede permiso para eliminar una configuración de registro de eventos. Escritura
DeleteManagedThing Concede permiso para eliminar un objeto administrado. Escritura

managed-thing*

DeleteNotificationConfiguration Concede permiso para eliminar la configuración de notificación. Escritura
DeleteOtaTask Concede permiso para eliminar una tarea OTA. Escritura

ota-task*

DeleteOtaTaskConfiguration Concede permiso para eliminar una configuración de tarea OTA. Escritura
DeleteProvisioningProfile Concede permiso para eliminar un perfil de aprovisionamiento. Escritura

provisioning-profile*

DeregisterAccountAssociation Concede permiso para anular el registro de la asociación de cuenta. Escritura

account-association*

managed-thing*

GetAccountAssociation Concede permiso para obtener información sobre una asociación de cuenta. Lectura

account-association*

GetCloudConnector Concede permiso para obtener información sobre un conector de nube. Lectura
GetConnectorDestination Concede permiso para obtener información sobre un destino en la nube. Lectura
GetCredentialLocker Concede permiso para obtener información sobre un casillero de credenciales. Lectura

credential-locker*

GetCustomEndpoint Concede permiso para obtener información sobre un punto de conexión personalizado. Lectura
GetDefaultEncryptionConfiguration Concede permiso para obtener información sobre una configuración de cifrado predeterminada. Lectura
GetDestination Concede permiso para obtener información sobre un destino. Lectura
GetDeviceDiscovery Concede permiso para obtener información sobre el descubrimiento de un dispositivo. Lectura
GetEventLogConfiguration Concede permiso para obtener información sobre la configuración de registro de un evento. Lectura
GetHubConfiguration Concede permiso para obtener información sobre la configuración de un hub. Lectura
GetManagedThing Concede permiso para obtener información sobre un objeto administrado. Lectura

managed-thing*

GetManagedThingCapabilities Concede permiso para obtener el informe de capacidad de un objeto administrado. Lectura

managed-thing*

GetManagedThingCertificate Otorga permiso para obtener el certificado PEM de un elemento gestionado Lectura

managed-thing*

GetManagedThingConnectivityData Concede permiso para obtener los datos de conectividad de un objeto administrado. Lectura

managed-thing*

GetManagedThingMetaData Concede permiso para obtener la información de metadatos de un objeto administrado. Lectura

managed-thing*

GetManagedThingState Concede permiso para obtener la información de estado del dispositivo de un objeto administrado. Lectura

managed-thing*

GetNotificationConfiguration Concede permiso para obtener información para una configuración de una notificación. Lectura
GetOtaTask Concede permiso para obtener información para una tarea OTA. Lectura

ota-task*

GetOtaTaskConfiguration Concede permiso para obtener información para la configuración de una tarea OTA. Lectura
GetProvisioningProfile Concede permiso para obtener información para un perfil de aprovisionamiento. Lectura

provisioning-profile*

GetRuntimeLogConfiguration Concede permiso para obtener información para la configuración de registro de tiempo de ejecución. Lectura
GetSchemaVersion Concede permiso para obtener información para una versión de un esquema. Lectura
ListAccountAssociations Concede permiso para enumerar información para asociaciones de cuenta. Enumeración
ListCloudConnectors Concede permiso para enumerar información para conectores de la nube. Enumeración
ListConnectorDestinations Concede permiso para enumerar información para destinos de conector. Enumeración
ListCredentialLockers Concede permiso para enumerar información para casilleros de credenciales. Enumeración
ListDestinations Concede permiso para enumerar información para destinos. Enumeración
ListDeviceDiscoveries Concede permiso para enumerar información para el descubrimiento de dispositivos. Enumeración
ListDiscoveredDevices Concede permiso para enumerar información para el dispositivo detectado en un descubrimiento de dispositivos. Lectura
ListEventLogConfigurations Concede permiso para enumerar información para las configuraciones del registro de eventos. Lectura
ListManagedThingAccountAssociations Concede permiso para enumerar información para asociaciones entre objetos administrados y asociaciones de cuenta. Enumeración
ListManagedThingSchemas Concede permiso para enumerar esquemas asociados a un objeto administrado. Lectura

managed-thing*

ListManagedThings Concede permiso para enumerar información para objetos administrados. Enumeración
ListNotificationConfigurations Concede permiso para enumerar información para las configuraciones de notificaciones. Lectura
ListOtaTaskConfigurations Concede permiso para enumerar información para las configuraciones de tareas OTA. Lectura
ListOtaTaskExecutions Concede permiso para enumerar información para ejecuciones de tareas OTA. Lectura

ota-task*

ListOtaTasks Concede permiso para enumerar información para tareas OTA. Enumeración
ListProvisioningProfiles Concede permiso para enumerar información para perfiles de aprovisionamiento. Enumeración
ListSchemaVersions Concede permiso para enumerar información para esquemas. Enumeración
ListTagsForResource Concede permiso para enumerar las etiquetas del recurso especificado Lectura

account-association

credential-locker

managed-thing

ota-task

provisioning-profile

aws:ResourceTag/${TagKey}

PutDefaultEncryptionConfiguration Concede permiso para actualizar los ajustes predeterminados de una configuración de cifrado. Escritura
PutHubConfiguration Concede permiso para actualizar la configuración de un hub. Escritura
PutRuntimeLogConfiguration Concede permiso para actualizar una configuración de registro de tiempo de ejecución. Escritura
RegisterAccountAssociation Concede permiso para registrar una asociación de cuentas a un objeto administrado. Escritura

account-association*

managed-thing*

RegisterCustomEndpoint Concede permiso para registrar un punto de conexión personalizado. Escritura
ResetRuntimeLogConfiguration Concede permiso para restablecer una configuración de registro de tiempo de ejecución. Escritura
SendConnectorEvent Concede permiso para enviar un evento de conector. Escritura
SendManagedThingCommand Concede permiso para enviar un comando a un objeto administrado. Escritura

managed-thing*

account-association

StartAccountAssociationRefresh Concede permiso para iniciar una actualización de los tokens de acceso relacionados con una asociación de cuentas. Escritura

account-association*

StartDeviceDiscovery Concede permiso para detener un descubrimiento de dispositivos. Escritura

account-association

managed-thing

TagResource Concede permiso para agregar etiquetas al recurso especificado. Etiquetado

account-association

credential-locker

managed-thing

ota-task

provisioning-profile

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

UntagResource Concede permiso para eliminar etiquetas del recurso especificado. Etiquetado

account-association

credential-locker

managed-thing

ota-task

provisioning-profile

aws:ResourceTag/${TagKey}

aws:TagKeys

UpdateAccountAssociation Concede permiso para actualizar una asociación de cuentas. Escritura

account-association*

UpdateCloudConnector Concede permiso para actualizar un conector de la nube. Escritura

iotmanagedintegrations:cloudConnectorId

UpdateConnectorDestination Concede permiso para actualizar un destino de conector. Escritura
UpdateDestination Otorga permiso para actualizar un destino. Escritura
UpdateEventLogConfiguration Concede permiso para actualizar una configuración de registro de eventos. Escritura
UpdateManagedThing Concede permiso para actualizar un objeto administrado. Escritura

managed-thing*

credential-locker

UpdateNotificationConfiguration Concede permiso para actualizar una configuración de notificación. Escritura
UpdateOtaTask Concede permiso para actualizar una tarea OTA. Escritura

ota-task*

Tipos de recurso definidos por Integraciones administradas de AWS IoT

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
account-association arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:account-association/${AccountAssociationId}

aws:ResourceTag/${TagKey}

credential-locker arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:credential-locker/${Identifier}

aws:ResourceTag/${TagKey}

managed-thing arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:managed-thing/${Identifier}

aws:ResourceTag/${TagKey}

ota-task arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:ota-task/${Identifier}

aws:ResourceTag/${TagKey}

provisioning-profile arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:provisioning-profile/${Identifier}

aws:ResourceTag/${TagKey}

Claves de condición para Integraciones administradas de AWS IoT

AWS Las integraciones gestionadas de IoT definen las siguientes claves de condición que se pueden utilizar en el Condition elemento 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.

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

Claves de condición Descripción Tipo
aws:RequestTag/${TagKey} Filtra el acceso mediante una clave de etiqueta y un par de valores permitidos en la solicitud Cadena
aws:ResourceTag/${TagKey} Filtra el acceso por par de clave y valor de etiqueta de un recurso Cadena
aws:TagKeys Filtra el acceso por las claves de etiquetas que se pasan en la solicitud ArrayOfString
iotmanagedintegrations:cloudConnectorId Filtra el acceso por CloudConnectorId Cadena
iotmanagedintegrations:connectorDestinationId Filtra el acceso por parte del ConnectorDestinationId Cadena