Acciones, recursos y claves de condición para AWS CodePipeline

AWS CodePipeline (prefijo de servicio: codepipeline) 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.

Acciones definidas por AWS CodePipeline

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
AcknowledgeJob	Otorga permiso para ver información sobre un trabajo específico y si el proceso de trabajo lo ha recibido.	Write
AcknowledgeThirdPartyJob	Otorga permiso para confirmar que un proceso de trabajo ha recibido el trabajo especificado (solo acciones de socios)	Write
CreateCustomActionType	Otorga permiso para crear una acción personalizada que puede utilizar en las canalizaciones asociadas a su Cuenta de AWS	Escritura	actiontype*
				aws:RequestTag/${TagKey} aws:TagKeys
CreatePipeline	Otorga permiso para crear una canalización con nombre único	Escritura	pipeline*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteCustomActionType	Otorga permiso para eliminar una acción personalizada	Write	actiontype*
DeletePipeline	Otorga permiso para eliminar una canalización específica	Write	pipeline*
DeleteWebhook	Otorga permiso para eliminar un webhook específico	Write	webhook*
DeregisterWebhookWithThirdParty	Otorga permiso para eliminar el registro de un webhook con el tercero especificado en su configuración	Write	webhook*
DisableStageTransition	Otorga permiso para evitar que las revisiones pasen a la siguiente etapa de una canalización	Write	stage*
EnableStageTransition	Otorga permiso para permitir que las revisiones pasen a la siguiente etapa de una canalización	Escritura	stage*
GetActionType	Otorga permiso para obtener información sobre un tipo de acción	Lectura
GetJobDetails	Otorga permiso para ver información sobre un trabajo (solo acciones personalizadas)	Read
GetPipeline	Otorga permiso para recuperar información sobre una estructura de canalización	Read	pipeline*
GetPipelineExecution	Otorga permiso para ver información sobre la ejecución de una canalización, como los detalles de los artefactos, el ID de ejecución de la canalización y el nombre, la versión y el estado de la canalización.	Read	pipeline*
GetPipelineState	Otorga permiso para ver información sobre el estado actual de las etapas y acciones de una canalización	Read	pipeline*
GetThirdPartyJobDetails	Otorga permiso para ver los detalles de un trabajo para una acción de terceros (solo acciones de socios)	Read
ListActionExecutions	Otorga permiso para enumerar las ejecuciones de acciones que se han producido en una canalización	Read	pipeline*
ListActionTypes	Otorga permiso para enumerar un resumen de todos los tipos de acción disponibles para las canalizaciones de su cuenta	Read
ListPipelineExecutions	Otorga permiso para enumerar un resumen de las ejecuciones más recientes de una canalización	List	pipeline*
ListPipelines	Otorga permiso para mostrar un resumen de todas las canalizaciones asociadas a su Cuenta de AWS	List
ListTagsForResource	Otorga permiso para enumerar etiquetas para un recurso de CodePipeline	Read	actiontype
			pipeline
			webhook
ListWebhooks	Otorga permiso para enumerar todos los webhooks asociados a su Cuenta de AWS	List	webhook*
PollForJobs	Otorga permiso para ver información sobre cualquier trabajo en el que CodePipeline actúe	Write	actiontype*
PollForThirdPartyJobs	Otorga permiso para determinar si hay trabajos de terceros en los que actúe un proceso de trabajo (solo acciones de socios)	Write
PutActionRevision	Otorga permiso para editar acciones en una canalización	Write	action*
PutApprovalResult	Otorga permiso para proporcionar una respuesta (aprobada o rechazada) a una solicitud de aprobación manual en CodePipeline	Write	action*
PutJobFailureResult	Otorga permiso para representar el error de un trabajo devuelto a la canalización por un proceso de trabajo (solo acciones personalizadas)	Write
PutJobSuccessResult	Otorga permiso para representar el éxito de un trabajo devuelto a la canalización por un proceso de trabajo (solo acciones personalizadas)	Write
PutThirdPartyJobFailureResult	Otorga permiso para representar el error de un trabajo de terceros devuelto a la canalización por un proceso de trabajo (solo acciones de socios)	Write
PutThirdPartyJobSuccessResult	Otorga permiso para representar el éxito de un trabajo de terceros devuelto a la canalización por un proceso de trabajo (solo acciones de socios)	Write
PutWebhook	Otorga permiso para crear o actualizar un webhook	Escritura	pipeline*
			webhook*
				aws:RequestTag/${TagKey} aws:TagKeys
RegisterWebhookWithThirdParty	Otorga permiso para registrar un webhook con el tercero especificado en su configuración	Write	webhook*
RetryStageExecution	Otorga permiso para reanudar la ejecución en la canalización reintentando las últimas acciones erróneas de una etapa	Write	stage*
StartPipelineExecution	Otorga permiso para ejecutar la revisión más reciente a través de la canalización	Write	pipeline*
StopPipelineExecution	Otorga permiso para detener la ejecución de una canalización en curso	Write	pipeline*
TagResource	Otorga permiso para etiquetar un recurso de CodePipeline	Etiquetado	actiontype
			pipeline
			webhook
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Otorga permiso para quitar una etiqueta de un recurso de CodePipeline	Etiquetado	actiontype
			pipeline
			webhook
				aws:TagKeys
UpdateActionType	Otorga permiso para actualizar un tipo de acción	Escritura	actiontype*
UpdatePipeline	Otorga permiso para actualizar una canalización con cambios en la estructura de la canalización	Write	pipeline*

Tipos de recursos definidos por AWS CodePipeline

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
action	arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}/${StageName}/${ActionName}	aws:ResourceTag/${TagKey}
actiontype	arn:${Partition}:codepipeline:${Region}:${Account}:actiontype:${Owner}/${Category}/${Provider}/${Version}	aws:ResourceTag/${TagKey}
pipeline	arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}	aws:ResourceTag/${TagKey}
stage	arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}/${StageName}	aws:ResourceTag/${TagKey}
webhook	arn:${Partition}:codepipeline:${Region}:${Account}:webhook:${WebhookName}	aws:ResourceTag/${TagKey}

Claves de condición para AWS CodePipeline

AWS CodePipeline 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 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