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

AWS IoT Events (prefijo de servicio: iotevents) proporciona los siguientes recursos, acciones y claves de contexto de condición 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.

Acciones definidas por AWS IoT Events

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
BatchAcknowledgeAlarm	Concede permiso para enviar una o más solicitudes de acción de confirmación a AWS IoT Events	Escritura	alarmModel*
BatchDeleteDetector	Concede permiso para eliminar una instancia de detector dentro del sistema de AWS IoT Events	Escritura	detectorModel*
BatchDisableAlarm	Concede permiso para desactivar una o más instancias de alarma.	Write	alarmModel*
BatchEnableAlarm	Concede permiso para habilitar una o más instancias de alarma.	Write	alarmModel*
BatchPutMessage	Concede permiso para enviar un conjunto de mensajes al sistema de AWS IoT Events	Write	input*
BatchResetAlarm	Concede permiso para restablecer una o más instancias de alarma.	Write	alarmModel*
BatchSnoozeAlarm	Concede permiso para cambiar una o más instancias de alarma al modo posponer.	Write	alarmModel*
BatchUpdateDetector	Concede permiso para actualizar una instancia de detector dentro del sistema de AWS IoT Events	Write	detectorModel*
CreateAlarmModel	Concede permiso para crear un modelo de alarma para supervisar un atributo de entrada de AWS IoT Events o una propiedad de activo de AWS IoT SiteWise	Write	alarmModel*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateDetectorModel	Concede permiso para crear un modelo de detector para supervisar un atributo de entrada de AWS IoT Events	Write	detectorModel*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateInput	Concede permiso para crear una entrada en IotEvents.	Write	input*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAlarmModel	Concede permiso para eliminar un modelo de alarma.	Write	alarmModel*
DeleteDetectorModel	Concede permiso para eliminar un modelo de detector.	Write	detectorModel*
DeleteInput	Da permiso para eliminar una entrada.	Write	input*
DescribeAlarm	Concede permiso para obtener información acerca de una instancia de alarma.	Read	alarmModel*
DescribeAlarmModel	Concede permiso para obtener información acerca de un modelo de alarma.	Read	alarmModel*
DescribeDetector	Concede permiso para obtener información acerca de una instancia de detector.	Read	detectorModel*
DescribeDetectorModel	Concede permiso para obtener información acerca de un modelo de detector.	Lectura	detectorModel*
DescribeDetectorModelAnalysis	Concede permiso para obtener información acerca del análisis del modelo de detector	Lectura
DescribeInput	Concede permiso para obtener información acerca de la entrada.	Read	input*
DescribeLoggingOptions	Concede permiso para recuperar la configuración actual de las opciones de registro de AWS IoT Events	Lectura
GetDetectorModelAnalysisResults	Concede permiso para recuperar los resultados del análisis del modelo de detector	Lectura
ListAlarmModelVersions	Concede permiso para enumerar todas las versiones de un modelo de alarma.	List	alarmModel*
ListAlarmModels	Concede permiso para enumerar los modelos de alarmas que ha creado.	List
ListAlarms	Concede permiso para obtener información acerca de todas las instancias de alarma por alarmModel.	List	alarmModel*
ListDetectorModelVersions	Concede permiso para enumerar todas las versiones de un modelo de detector.	List	detectorModel*
ListDetectorModels	Concede permiso para enumerar los modelos de detector que ha creado.	List
ListDetectors	Concede permiso para obtener información acerca de todas las instancias de detector por detectormodel.	List	detectorModel*
ListInputRoutings	Concede permiso para enumerar una o varias rutas de entrada	List
ListInputs	Concede permiso para enumerar las entradas que ha creado.	List
ListTagsForResource	Concede permiso para enumerar las etiquetas (metadatos) que ha asignado al recurso.	Read	alarmModel
			detectorModel
			input
PutLoggingOptions	Concede permiso para establecer o actualizar las opciones de registro de AWS IoT Events	Escritura
StartDetectorModelAnalysis	Concede permiso para iniciar el análisis del modelo de detección	Escritura
TagResource	Concede permiso para agregar o modificar las etiquetas del recurso especificado. Las etiquetas son metadatos que se pueden utilizar para administrar un recurso.	Etiquetado	alarmModel
			detectorModel
			input
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Concede permiso para eliminar las etiquetas (metadatos) dadas del recurso.	Etiquetado	alarmModel
			detectorModel
			input
				aws:TagKeys
UpdateAlarmModel	Concede permiso para actualizar un modelo de alarma.	Write	alarmModel*
UpdateDetectorModel	Concede permiso para actualizar un modelo de detector.	Write	detectorModel*
UpdateInput	Da permiso para actualizar una entrada.	Write	input*
UpdateInputRouting	Concede permiso para actualizar el direccionamiento de entrada.	Write	input*

Tipos de recursos definidos por AWS IoT Events

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
detectorModel	arn:${Partition}:iotevents:${Region}:${Account}:detectorModel/${DetectorModelName}	aws:ResourceTag/${TagKey}
alarmModel	arn:${Partition}:iotevents:${Region}:${Account}:alarmModel/${AlarmModelName}	aws:ResourceTag/${TagKey}
input	arn:${Partition}:iotevents:${Region}:${Account}:input/${InputName}	aws:ResourceTag/${TagKey}

Claves de condición para AWS IoT Events

AWS IoT Events 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 el acceso por los pares clave-valor de la etiqueta en la solicitud	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso por las etiquetas asociadas a un recurso	Cadena
aws:TagKeys	Filtra las acciones por las claves de etiqueta en la solicitud	ArrayOfString
iotevents:keyValue	Filtra el acceso por el instanceId (clave-valor) del mensaje.	Cadena