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

Acciones, recursos y claves de condición para AWS IoT 1-Click

AWS IoT 1-Click (prefijo de servicio: iot1click) proporciona los siguientes recursos, acciones y claves de contexto de condición específicos del servicio para usarse en las políticas de permisos de IAM.

Referencias:

Acciones definidas por AWS IoT 1-Click

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 Resource types (Tipos de recurso) indica si la acción admite permisos de nivel de recursos. Si no hay ningún valor para esta columna, debe especificar todos los recursos ("*") en el elemento Resource de la instrucción de la 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. Los recursos necesarios se indican en la tabla con un asterisco (*). Si especifica un ARN de permiso de recursos en una instrucción mediante esta acción, deberá ser de este tipo. Algunas acciones admiten varios tipos de recursos. Si el tipo de recurso es opcional (no se indica como obligatorio), puede elegir utilizar uno pero no el otro.

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
AssociateDeviceWithPlacement Otorga permiso para asociar un dispositivo a una ubicación Write

project*

ClaimDevicesByClaimCode Otorga permiso para reclamar un lote de dispositivos con un código de reclamación Read
CreatePlacement Otorga permiso para crear una nueva ubicación en un proyecto Write

project*

CreateProject Otorga permiso para crear un nuevo proyecto Write

project*

aws:RequestTag/${TagKey}

aws:TagKeys

DeletePlacement Otorga permiso para eliminar una ubicación de un proyecto Write

project*

DeleteProject Concede permiso para eliminar un proyecto Write

project*

DescribeDevice Otorga permiso para describir un dispositivo Read

device*

DescribePlacement Otorga permiso para describir una ubicación Read

project*

DescribeProject Concede permiso para describir un proyecto Read

project*

DisassociateDeviceFromPlacement Otorga permiso para desasociar un dispositivo de una ubicación Write

project*

FinalizeDeviceClaim Otorga permiso para finalizar la reclamación de un dispositivo Read

device*

aws:RequestTag/${TagKey}

aws:TagKeys

GetDeviceMethods Otorga permiso para obtener los métodos disponibles de un dispositivo Read

device*

GetDevicesInPlacement Otorga permiso para obtener dispositivos asociados a una ubicación Read

project*

InitiateDeviceClaim Otorga permiso para iniciar la reclamación de un dispositivo Read

device*

InvokeDeviceMethod Otorga permiso para invocar un método de dispositivo Write

device*

ListDeviceEvents Otorga permiso para enumerar eventos pasados publicados por un dispositivo Read

device*

ListDevices Otorga permiso para enumerar todos los dispositivos List
ListPlacements Otorga permiso para enumerar ubicaciones en un proyecto Read

project*

ListProjects Otorga permiso para enumerar todos los proyectos List
ListTagsForResource Otorga permiso para enumerar las etiquetas de un recurso. Read

device

project

TagResource Otorga permisos para agregar o modificar las etiquetas de un recurso. Etiquetado

device

project

aws:RequestTag/${TagKey}

aws:TagKeys

UnclaimDevice Otorga permiso para anular la reclamación de un dispositivo Read

device*

UntagResource Otorga permiso para eliminar las etiquetas (metadatos) dadas de un recurso. Etiquetado

device

project

aws:TagKeys

UpdateDeviceState Otorga permiso para actualizar el estado del dispositivo Write

device*

UpdatePlacement Otorga permiso para actualizar una ubicación Write

project*

UpdateProject Actualiza un proyecto. Write

project*

Tipos de recursos definidos por AWS IoT 1-Click

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. 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
device arn:${Partition}:iot1click:${Region}:${Account}:devices/${DeviceId}

aws:ResourceTag/${TagKey}

project arn:${Partition}:iot1click:${Region}:${Account}:projects/${ProjectName}

aws:ResourceTag/${TagKey}

Claves de condición para AWS IoT 1-Click

AWS IoT 1-Click define las siguientes claves de condición que pueden utilizarse 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
aws:RequestTag/${TagKey} Filtra acciones basadas en las etiquetas que se pasan en la solicitud Cadena
aws:ResourceTag/${TagKey} Filtra acciones en función de la etiqueta asociada con el recurso. Cadena
aws:TagKeys Filtra acciones basadas en las claves de etiqueta que se pasan en la solicitud ArrayOfString