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:

• 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 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 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
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	Concede 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 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
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 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