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

Acciones, recursos y claves de condición para AWS IoT Greengrass V2

AWS IoT Greengrass V2 (prefijo de servicio: greengrass) 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 Greengrass V2

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
AssociateServiceRoleToAccount Concede permiso para asociar un rol a su cuenta. AWS IoT Greengrass utiliza este rol para acceder a sus funciones de Lambda y recursos de AWS IoT. Permissions management

iam:PassRole

BatchAssociateClientDeviceWithCoreDevice Concede permiso para asociar una lista de dispositivos cliente a un dispositivo principal. Escritura

coreDevice*

BatchDisassociateClientDeviceFromCoreDevice Otorga permiso para disociar una lista de dispositivos cliente a un dispositivo principal. Escritura

coreDevice*

CancelDeployment Concede permiso para cancelar una implementación. Write

deployment*

iot:CancelJob

iot:DeleteThingShadow

iot:DescribeJob

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

iot:UpdateJob

iot:UpdateThingShadow

CreateComponentVersion Concede permiso para crear un componente. Write

component*

aws:RequestTag/${TagKey}

aws:TagKeys

CreateDeployment Concede permiso para crear una implementación. Write

aws:RequestTag/${TagKey}

aws:TagKeys

iot:CancelJob

iot:CreateJob

iot:DeleteThingShadow

iot:DescribeJob

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

iot:UpdateJob

iot:UpdateThingShadow

DeleteComponent Concede el permiso para eliminar un componente. Write

componentVersion*

DeleteCoreDevice Otorga permiso para eliminar un dispositivo central de AWS IoT Greengrass, que es un objeto de AWS IoT. Esta operación elimina el dispositivo central de la lista de dispositivos centrales. Esta operación no elimina el objeto de AWS IoT. Escritura

coreDevice*

iot:DescribeJobExecution

DeleteDeployment Concede permiso para eliminar una implementación. Para eliminar una implementación activa, primero debe cancelarse Escritura

deployment*

iot:DeleteJob

DescribeComponent Concede permiso para recuperar metadatos de una versión de un componente. Lectura

componentVersion*

DisassociateServiceRoleFromAccount Concede permiso para desasociar el rol de servicio de una cuenta. Sin un rol de servicio, las implementaciones no funcionarán Escritura
GetComponent Concede permiso para obtener la receta de una versión de un componente. Read

componentVersion*

GetComponentVersionArtifact Concede permiso para obtener la URL prefirmada para descargar un artefacto de componente público Lectura

componentVersion*

GetConnectivityInfo Concede permiso para recuperar información de conectividad para un dispositivo central de Greengrass Lectura

connectivityInfo*

iot:GetThingShadow

GetCoreDevice Otorga permiso para recuperar metadatos de un dispositivo central de AWS IoT Greengrass. Read

coreDevice*

GetDeployment Concede permiso para obtener una implementación. Lectura

deployment*

iot:DescribeJob

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

GetServiceRoleForAccount Concede permiso para recuperar el rol de servicio que está adjuntado a una cuenta Lectura
ListClientDevicesAssociatedWithCoreDevice Otorga permiso para recuperar una lista paginada de los dispositivos cliente asociados a un dispositivo principal de AWS IoT Greengrass. List

coreDevice*

ListComponentVersions Concede permiso para recuperar una lista paginada de todas las versiones de un componente. List

component*

ListComponents Concede permiso para recuperar una lista paginada de los resúmenes de componentes. List
ListCoreDevices Otorga permiso para recuperar una lista paginada de los dispositivos centrales de AWS IoT Greengrass. List
ListDeployments Concede permiso para recuperar una lista paginada de las implementaciones. List

iot:DescribeJob

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

ListEffectiveDeployments Otorga permiso para recuperar una lista paginada de los trabajos de implementación que AWS IoT Greengrass envía a los dispositivos centrales de AWS IoT Greengrass. List

coreDevice*

iot:DescribeJob

iot:DescribeJobExecution

iot:DescribeThing

iot:DescribeThingGroup

iot:GetThingShadow

ListInstalledComponents Otorga permiso para recuperar una lista paginada de los componentes que ejecuta un dispositivo central de AWS IoT Greengrass. List

coreDevice*

ListTagsForResource Concede permiso para enumerar las etiquetas de un recurso Lectura

component

componentVersion

coreDevice

deployment

aws:RequestTag/${TagKey}

aws:TagKeys

ResolveComponentCandidates Concede permiso para enumerar los componentes que cumplen los requisitos de componente, versión y plataforma de una implementación. List

componentVersion*

TagResource Otorga permiso para agregar etiquetas a un recurso. Etiquetado

component

componentVersion

coreDevice

deployment

aws:RequestTag/${TagKey}

aws:TagKeys

UntagResource Concede permiso para eliminar etiquetas de un recurso Etiquetado

component

componentVersion

coreDevice

deployment

aws:RequestTag/${TagKey}

aws:TagKeys

UpdateConnectivityInfo Concede permiso para actualizar la información de conectividad de un núcleo de Greengrass. Los dispositivos que pertenezcan al grupo que tiene este núcleo recibirán esta información para poder encontrar la ubicación del núcleo y conectarse a este Escritura

connectivityInfo*

iot:GetThingShadow

iot:UpdateThingShadow

Tipos de recursos definidos por AWS IoT Greengrass V2

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
connectivityInfo arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/things/${ThingName}/connectivityInfo
component arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}

aws:ResourceTag/${TagKey}

componentVersion arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}:versions:${ComponentVersion}

aws:ResourceTag/${TagKey}

coreDevice arn:${Partition}:greengrass:${Region}:${Account}:coreDevices:${CoreDeviceThingName}

aws:ResourceTag/${TagKey}

deployment arn:${Partition}:greengrass:${Region}:${Account}:deployments:${DeploymentId}

aws:ResourceTag/${TagKey}

Claves de condición para AWS IoT Greengrass V2

AWS IoT Greengrass V2 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.

A fin de 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 el acceso mediante la verificación de pares de clave-valor de etiqueta incluidos en la solicitud. Cadena
aws:ResourceTag/${TagKey} Filtra el acceso mediante la verificación de pares clave-valor de etiqueta asociados a un recurso específico. Cadena
aws:TagKeys Filtra el acceso mediante la verificación de claves de etiquetas que se pasan en la solicitud. ArrayOfString