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:
-
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 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 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 |
|---|---|---|---|---|---|
| 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. | Administración de permisos |
iam:PassRole |
||
| BatchAssociateClientDeviceWithCoreDevice | Concede permiso para asociar una lista de dispositivos cliente a un dispositivo principal. | Escritura | |||
| BatchDisassociateClientDeviceFromCoreDevice | Otorga permiso para disociar una lista de dispositivos cliente a un dispositivo principal. | Escritura | |||
| CancelDeployment | Concede permiso para cancelar una implementación. | Escritura |
iot:CancelJob iot:DeleteThingShadow iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow iot:UpdateJob iot:UpdateThingShadow |
||
| CreateComponentVersion | Concede permiso para crear un componente. | Write | |||
| CreateDeployment | Concede permiso para crear una implementación. | Write |
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 | |||
| 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 |
iot:DescribeJobExecution |
||
| DeleteDeployment | Concede permiso para eliminar una implementación. Para eliminar una implementación activa, primero debe cancelarse | Escritura |
iot:DeleteJob |
||
| DescribeComponent | Concede permiso para recuperar metadatos de una versión de un componente. | Leer | |||
| 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. | Lectura | |||
| GetComponentVersionArtifact | Concede permiso para obtener la URL prefirmada para descargar un artefacto de componente público | Leer | |||
| GetConnectivityInfo | Concede permiso para recuperar información de conectividad para un dispositivo central de Greengrass | Leer |
iot:GetThingShadow |
||
| GetCoreDevice | Otorga permiso para recuperar metadatos de un dispositivo central de AWS IoT Greengrass. | Read | |||
| GetDeployment | Concede permiso para obtener una implementación. | Leer |
iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow |
||
| GetServiceRoleForAccount | Concede permiso para recuperar el rol de servicio que está adjuntado a una cuenta | Leer | |||
| ListClientDevicesAssociatedWithCoreDevice | Otorga permiso para recuperar una lista paginada de los dispositivos cliente asociados a un dispositivo principal de AWS IoT Greengrass. | Enumeración | |||
| ListComponentVersions | Concede permiso para recuperar una lista paginada de todas las versiones de un componente. | List | |||
| 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 |
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 | |||
| ListTagsForResource | Concede permiso para enumerar las etiquetas de un recurso | Leer | |||
| ResolveComponentCandidates | Concede permiso para enumerar los componentes que cumplen los requisitos de componente, versión y plataforma de una implementación. | List | |||
| TagResource | Otorga permiso para agregar etiquetas a un recurso. | Etiquetado | |||
| UntagResource | Concede permiso para eliminar etiquetas de un recurso | Etiquetado | |||
| 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 |
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 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 |
|---|---|---|
| connectivityInfo |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/things/${ThingName}/connectivityInfo
|
|
| component |
arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}
|
|
| componentVersion |
arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}:versions:${ComponentVersion}
|
|
| coreDevice |
arn:${Partition}:greengrass:${Region}:${Account}:coreDevices:${CoreDeviceThingName}
|
|
| deployment |
arn:${Partition}:greengrass:${Region}:${Account}:deployments:${DeploymentId}
|
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.
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 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 |
