Acciones, recursos y claves de condición para Amazon Pinpoint Email Service

Amazon Pinpoint Email Service (prefijo de servicio: ses) proporciona las siguientes claves de contexto de condición, acciones y recursos 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 Amazon Pinpoint Email Service

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
CreateConfigurationSet	Otorga permiso para crear un conjunto de configuración	Write		ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
CreateConfigurationSetEventDestination	Concede permiso para crear un destino para eventos de conjunto de configuración	Write	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
CreateDedicatedIpPool	Concede permiso para crear un grupo de direcciones IP dedicadas nuevo	Write		ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
CreateDeliverabilityTestReport	Concede permiso para crear una prueba de colocación predictiva en la bandeja de entrada nueva	Write	identity*
				ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
CreateEmailIdentity	Concede permiso para iniciar el proceso de verificación de una identidad de correo electrónico	Write		ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
DeleteConfigurationSet	Concede permiso para eliminar un conjunto de configuración existente	Write	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
DeleteConfigurationSetEventDestination	Concede permiso para eliminar un destino de evento	Write	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
DeleteDedicatedIpPool	Concede permiso para eliminar un grupo de IP dedicadas	Write	dedicated-ip-pool*
				ses:ApiVersion aws:ResourceTag/${TagKey}
DeleteEmailIdentity	Otorga permiso para eliminar una identidad de correo electrónico verificada previamente	Write	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetAccount	Otorga permiso para obtener información sobre el estado y las capacidades del envío de correo electrónico	Read		ses:ApiVersion
GetBlacklistReports	Otorga permiso para recuperar una lista de las listas de denegación en las que aparecen sus direcciones IP dedicadas.	Read		ses:ApiVersion
GetConfigurationSet	Concede permiso para obtener información sobre un conjunto de configuración existente	Read	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetConfigurationSetEventDestinations	Concede permiso para recuperar una lista de destinos de eventos que están asociados con un conjunto de configuración	Read	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetDedicatedIp	Concede permiso para obtener información sobre una dirección IP dedicada	Read		ses:ApiVersion
GetDedicatedIps	Otorga permiso para enumerar las direcciones IP dedicadas asociadas a su cuenta	Read	dedicated-ip-pool*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetDeliverabilityDashboardOptions	Concede permiso para obtener el estado del panel de capacidad de entrega	Read		ses:ApiVersion
GetDeliverabilityTestReport	Concede permiso para recuperar los resultados de una prueba de colocación predictiva en la bandeja de entrada	Read	deliverability-test-report*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetDomainDeliverabilityCampaign	Concede permiso para recuperar todos los datos de capacidad de entrega de una campaña específica	Read		ses:ApiVersion
GetDomainStatisticsReport	Concede permiso para recuperar la ubicación de la bandeja de entrada y las tasas de interacción de los dominios que utiliza para enviar correos electrónicos	Read	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
GetEmailIdentity	Otorga permiso para obtener información sobre una identidad específica asociada a su cuenta	Read	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
ListConfigurationSets	Otorga permiso para enumerar todos los conjuntos de configuración asociados a su cuenta	List		ses:ApiVersion
ListDedicatedIpPools	Otorga permiso para enumerar todos los grupos de IP dedicadas que existen en su cuenta	List		ses:ApiVersion
ListDeliverabilityTestReports	Otorga permiso para recuperar una lista de las pruebas predictivas de ubicación de la bandeja de entrada que haya realizado, independientemente de sus estados	List		ses:ApiVersion
ListDomainDeliverabilityCampaigns	Otorga permiso para recuperar datos de capacidad de entrega de todas las campañas que utilizaron un dominio específico a fin de enviar correos electrónicos durante un intervalo de tiempo especificado	Read		ses:ApiVersion
ListEmailIdentities	Otorga permiso para enumerar todas las identidades de correo electrónico asociadas a su cuenta	List		ses:ApiVersion
ListTagsForResource	Otorga permiso para recuperar una lista de las etiquetas (claves y valores) asociadas a un recurso específico	Read	configuration-set
			dedicated-ip-pool
			deliverability-test-report
			identity
				ses:ApiVersion
PutAccountDedicatedIpWarmupAttributes	Concede permiso para habilitar o desactivar la característica de preparación automática para direcciones IP dedicadas	Write		ses:ApiVersion
PutAccountSendingAttributes	Otorga permiso para habilitar o desactivar la capacidad de su cuenta para enviar correos electrónicos	Write		ses:ApiVersion
PutConfigurationSetDeliveryOptions	Concede permiso para asociar un conjunto de configuración a un grupo de IP dedicadas	Write	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutConfigurationSetReputationOptions	Concede permiso para habilitar o desactivar la recopilación de métricas de reputación para los correos electrónicos que envía a través de un conjunto de configuración determinado	Write	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutConfigurationSetSendingOptions	Concede permiso para habilitar o desactivar el envío de correos electrónicos para mensajes que utilizan un conjunto de configuración determinado	Write	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutConfigurationSetTrackingOptions	Otorga permiso para especificar un dominio personalizado que se utilizará para los elementos de seguimiento de apertura y clic en el correo electrónico que envíe mediante un conjunto de configuración determinado	Write	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutDedicatedIpInPool	Concede permiso para mover una dirección IP dedicada a un grupo de IP dedicadas existente	Write	dedicated-ip-pool*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutDedicatedIpWarmupAttributes	Otorga permiso para habilitar atributos de preparación de IP dedicadas	Write		ses:ApiVersion
PutDeliverabilityDashboardOption	Concede permiso para habilitar o desactivar el panel de capacidad de entrega	Write		ses:ApiVersion
PutEmailIdentityDkimAttributes	Concede permiso para habilitar o desactivar la autenticación DKIM para una identidad de correo electrónico	Write	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutEmailIdentityFeedbackAttributes	Otorga permiso para habilitar o desactivar el reenvío de comentarios para una identidad	Write	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
PutEmailIdentityMailFromAttributes	Concede permiso para habilitar o desactivar la configuración de dominio MAIL FROM personalizada para una identidad de correo electrónico	Write	identity*
				ses:ApiVersion aws:ResourceTag/${TagKey}
SendEmail	Concede permiso para enviar un mensaje de correo electrónico	Write	identity*
				ses:ApiVersion ses:FeedbackAddress ses:FromAddress ses:FromDisplayName ses:Recipients
TagResource	Concede permiso para agregar una o varias etiquetas (claves y valores) a un recurso especificado	Etiquetado	configuration-set
			dedicated-ip-pool
			deliverability-test-report
			identity
				ses:ApiVersion aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Otorga permiso para eliminar una o más etiquetas (claves y valores) de un recurso especificado	Etiquetado	configuration-set
			dedicated-ip-pool
			deliverability-test-report
			identity
				ses:ApiVersion aws:TagKeys
UpdateConfigurationSetEventDestination	Concede permiso para actualizar la configuración de un destino de eventos para un conjunto de configuración	Write	configuration-set*
				ses:ApiVersion aws:ResourceTag/${TagKey}

Tipos de recurso definidos por Amazon Pinpoint Email Service

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
configuration-set	arn:${Partition}:ses:${Region}:${Account}:configuration-set/${ConfigurationSetName}	aws:ResourceTag/${TagKey}
dedicated-ip-pool	arn:${Partition}:ses:${Region}:${Account}:dedicated-ip-pool/${DedicatedIPPool}	aws:ResourceTag/${TagKey}
deliverability-test-report	arn:${Partition}:ses:${Region}:${Account}:deliverability-test-report/${ReportId}	aws:ResourceTag/${TagKey}
identity	arn:${Partition}:ses:${Region}:${Account}:identity/${IdentityName}	aws:ResourceTag/${TagKey}

Claves de condición de Amazon Pinpoint Email Service

Amazon Pinpoint Email Service define las siguientes claves de condición 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 acciones en función de la presencia de pares de clave-valor de etiqueta en la solicitud.	Cadena
aws:ResourceTag/${TagKey}	Filtra acciones en función de pares de clave-valor de etiqueta adjuntados al recurso	Cadena
aws:TagKeys	Filtra acciones en función de la presencia de claves de etiqueta en la solicitud.	ArrayOfString
ses:ApiVersion	Filtra acciones basadas en la versión de la API de SES	Cadena
ses:FeedbackAddress	Filtra acciones en función de la dirección "Return-Path" (Ruta de devolución), que especifica dónde se envían los mensajes rebotados y las reclamaciones mediante el reenvío de retroalimentación por correo electrónico	Cadena
ses:FromAddress	Filtra acciones en función de la dirección "From" (Origen) de un mensaje	Cadena
ses:FromDisplayName	Filtra acciones en función de la dirección "From" (Origen) que se utiliza como nombre de visualización de un mensaje	Cadena
ses:Recipients	Filtra acciones en función de las direcciones de los destinatarios de un mensaje, que incluyen las direcciones "To" (Destino), "CC" (Copia) y "BCC" (Copia oculta).	ArrayOfString