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:
-
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 de IAM.
Temas
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 | |||
| CreateCloudConnector | Concede permiso para crear un nuevo conector de nube. | Escritura | |||
| CreateConnectorDestination | Concede permiso para crear un nuevo destino de conector. | Escritura | |||
| CreateCredentialLocker | Concede permiso para crear un casillero de credenciales de productos. | Escritura | |||
| 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 | |||
| CreateNotificationConfiguration | Concede permiso para crear una nueva configuración de notificación. | Escritura | |||
| CreateOtaTask | Concede permiso para crear una nueva tarea OTA. | Escritura | |||
| CreateOtaTaskConfiguration | Concede permiso para crear una nueva configuración de tarea OTA. | Escritura | |||
| CreateProvisioningProfile | Concede permiso para crear un nuevo perfil de aprovisionamiento. | Escritura | |||
| DeleteAccountAssociation | Concede permiso para eliminar una asociación de cuenta. | Escritura | |||
| DeleteCloudConnector | Concede permiso para eliminar un conector de nube. | Escritura | |||
| DeleteConnectorDestination | Concede permiso para eliminar un destino de conector. | Escritura | |||
| DeleteCredentialLocker | Concede permiso para eliminar un casillero de credenciales. | Escritura | |||
| 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 | |||
| DeleteNotificationConfiguration | Concede permiso para eliminar la configuración de notificación. | Escritura | |||
| DeleteOtaTask | Concede permiso para eliminar una tarea OTA. | Escritura | |||
| DeleteOtaTaskConfiguration | Concede permiso para eliminar una configuración de tarea OTA. | Escritura | |||
| DeleteProvisioningProfile | Concede permiso para eliminar un perfil de aprovisionamiento. | Escritura | |||
| DeregisterAccountAssociation | Concede permiso para anular el registro de la asociación de cuenta. | Escritura | |||
| GetAccountAssociation | Concede permiso para obtener información sobre una asociación de cuenta. | Lectura | |||
| 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 | |||
| 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 | |||
| GetManagedThingCapabilities | Concede permiso para obtener el informe de capacidad de un objeto administrado. | Lectura | |||
| GetManagedThingCertificate | Otorga permiso para obtener el certificado PEM de un elemento gestionado | Lectura | |||
| GetManagedThingConnectivityData | Concede permiso para obtener los datos de conectividad de un objeto administrado. | Lectura | |||
| GetManagedThingMetaData | Concede permiso para obtener la información de metadatos de un objeto administrado. | Lectura | |||
| GetManagedThingState | Concede permiso para obtener la información de estado del dispositivo de un objeto administrado. | Lectura | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| 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 | |||
| StartAccountAssociationRefresh | Concede permiso para iniciar una actualización de los tokens de acceso relacionados con una asociación de cuentas. | Escritura | |||
| StartDeviceDiscovery | Concede permiso para detener un descubrimiento de dispositivos. | Escritura | |||
| TagResource | Concede permiso para agregar etiquetas al recurso especificado. | Etiquetado | |||
| UntagResource | Concede permiso para eliminar etiquetas del recurso especificado. | Etiquetado | |||
| UpdateAccountAssociation | Concede permiso para actualizar una asociación de cuentas. | Escritura | |||
| UpdateCloudConnector | Concede permiso para actualizar un conector de la nube. | Escritura | |||
| 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 | |||
| UpdateNotificationConfiguration | Concede permiso para actualizar una configuración de notificación. | Escritura | |||
| UpdateOtaTask | Concede permiso para actualizar una tarea OTA. | Escritura |
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}
|
|
| credential-locker |
arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:credential-locker/${Identifier}
|
|
| managed-thing |
arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:managed-thing/${Identifier}
|
|
| ota-task |
arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:ota-task/${Identifier}
|
|
| provisioning-profile |
arn:${Partition}:iotmanagedintegrations:${Region}:${Account}:provisioning-profile/${Identifier}
|
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 |