Acciones, recursos y claves de condición para los esquemas de Amazon EventBridge

Los esquemas de Amazon EventBridge (prefijo de servicio: schemas) proporcionan las siguientes claves de contexto de condición, acciones y recursos específicos del servicio para usarlas 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 los esquemas de Amazon EventBridge

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
CreateDiscoverer	Otorga permiso para crear un programa de detección de esquemas de eventos. Una vez creado, los eventos se asignarán automáticamente a los documentos de esquema correspondientes.	Escritura		aws:RequestTag/${TagKey} aws:TagKeys
CreateRegistry	Otorga permiso para crear un nuevo registro de esquemas en su cuenta	Escritura	registry*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateSchema	Otorga permiso para crear un nuevo esquema en su cuenta	Escritura	schema*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteDiscoverer	Otorga permiso para eliminar un programa de detección de su cuenta	Escritura	discoverer*
DeleteRegistry	Otorga permiso para eliminar un registro existente de la cuenta	Escritura	registry*
DeleteResourcePolicy	Otorga permiso para eliminar la política basada en recursos asociada a un registro determinado	Escritura	registry*
DeleteSchema	Otorga permiso para eliminar un esquema existente en su cuenta	Escritura	schema*
DeleteSchemaVersion	Otorga permiso para eliminar una versión específica del esquema de la cuenta	Escritura	schema*
DescribeCodeBinding	Otorga permiso para recuperar metadatos del código generado para un esquema específico de la cuenta	Lectura	schema*
DescribeDiscoverer	Otorga permiso para recuperar metadatos de detección de la cuenta	Lectura	discoverer*
DescribeRegistry	Otorga permiso para describir los metadatos de un registro existentes en la cuenta	Lectura	registry*
DescribeSchema	Otorga permiso para recuperar un esquema existente en la cuenta	Lectura	schema*
ExportSchema	Otorga permiso para exportar el registro de AWS o los esquemas descubiertos en formato OpenAPI 3 al formato JSON Schema	Lectura	registry*
			schema*
GetCodeBindingSource	Otorga permiso para recuperar metadatos del código generado para un esquema específico de la cuenta	Lectura	schema*
GetDiscoveredSchema	Otorga permiso para recuperar el esquema de la lista de eventos de ejemplo proporcionada	Lectura
GetResourcePolicy	Otorga permiso para recuperar la política basada en recursos asociada a un registro determinado	Lectura	registry*
ListDiscoverers	Otorga permiso para mostrar una lista de todos los programas de detección en su cuenta	Enumeración	discoverer*
ListRegistries	Otorga permiso para mostrar una lista de todos los registros de su cuenta	Enumeración	registry*
ListSchemaVersions	Otorga permiso para mostrar una lista de todas las versiones de un esquema	Enumeración	schema*
ListSchemas	Otorga permiso para mostrar una lista de todos los esquemas	Enumeración	schema*
ListTagsForResource	Otorga permiso para mostrar una lista de las etiquetas para un recurso	Lectura	discoverer
			registry
			schema
PutCodeBinding	Otorga permiso para generar un código para un esquema específico de la cuenta	Escritura	schema*
PutResourcePolicy	Otorga permiso para adjuntar una política basada en recursos a un registro determinado	Escritura	registry*
SearchSchemas	Otorga permiso para buscar esquemas en función de palabras clave específicas de la cuenta	Enumeración	schema*
StartDiscoverer	Otorga permiso para iniciar la detección especificada. Una vez iniciado, el programa registra automáticamente los esquemas de los eventos publicados en el origen configurado en la cuenta.	Escritura	discoverer*
StopDiscoverer	Otorga permiso para detener la detección especificada. Una vez iniciada la detección, el programa ya no registra los esquemas de los eventos publicados en el origen configurado en la cuenta	Escritura	discoverer*
TagResource	Concede permiso para etiquetar un recurso	Etiquetado	discoverer
			registry
			schema
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Otorga permiso para eliminar una etiqueta de un recurso.	Etiquetado	discoverer
			registry
			schema
				aws:TagKeys
UpdateDiscoverer	Otorga permiso para actualizar un programa de detección existente en la cuenta	Escritura	discoverer*
UpdateRegistry	Otorga permiso para actualizar los metadatos de un registro existentes en la cuenta	Escritura	registry*
UpdateSchema	Otorga permiso para actualizar un esquema existente en su cuenta	Escritura	schema*

Tipos de recursos definidos por los esquemas de Amazon EventBridge

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
discoverer	arn:${Partition}:schemas:${Region}:${Account}:discoverer/${DiscovererId}	aws:ResourceTag/${TagKey}
registry	arn:${Partition}:schemas:${Region}:${Account}:registry/${RegistryName}	aws:ResourceTag/${TagKey}
schema	arn:${Partition}:schemas:${Region}:${Account}:schema/${RegistryName}/${SchemaName}	aws:ResourceTag/${TagKey}

Claves de condición de los esquemas de Amazon EventBridge

Los esquemas de Amazon EventBridge definen las siguientes claves de condiciones que se pueden utilizar 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 el conjunto de valores permitidos para cada una de las etiquetas	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso según el valor-etiqueta asociado con el recurso	Cadena
aws:TagKeys	Filtra el acceso por la presencia de etiquetas obligatorias en la solicitud	ArrayOfString