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

AWS CodeBuild (prefijo de servicio:codebuild) proporciona los siguientes recursos, acciones y claves de contexto de condiciones 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 CodeBuild

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
BatchDeleteBuilds	Concede permiso para eliminar una o varias creaciones	Escritura	project*
BatchGetBuildBatches	Concede permiso para obtener información acerca de uno o varios lotes de creaciones	Leer	project*
BatchGetBuilds	Concede permiso para obtener información acerca de una o varias creaciones	Leer	project*
BatchGetFleets	Otorga permiso para devolver una matriz de los objetos de Fleet especificados en el parámetro de entrada	Leer	fleet*
BatchGetProjects	Concede permiso para obtener información sobre uno o más proyectos de creación	Leer	project*
BatchGetReportGroups	Otorga permiso para devolver una matriz de ReportGroup objetos especificada por el reportGroupArns parámetro de entrada	Leer	report-group*
BatchGetReports	Concede permiso para devolver una matriz de objetos Report especificados por el parámetro reportArns de entrada	Leer	report-group*
BatchPutCodeCoverages [solo permiso]	Concede permiso para agregar o actualizar la información sobre un informe	Escritura	report-group*
BatchPutTestCases [solo permiso]	Concede permiso para agregar o actualizar la información sobre un informe	Escritura	report-group*
CreateFleet	Otorga permiso para crear una flota informática	Escritura	fleet*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateProject	Concede permiso para crear un proyecto de creación	Escritura	project*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateReport [solo permiso]	Concede permiso para crear un informe. Un informe se crea cuando las pruebas especificadas en el archivo buildspec para un grupo de informes se ejecutan durante la compilación de un proyecto.	Escritura	report-group*
CreateReportGroup	Concede permiso para crear un grupo de informe	Escritura	report-group*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateWebhook	Concede permiso para crear webhook. En el caso de un proyecto de AWS CodeBuild compilación existente cuyo código fuente esté almacenado en un repositorio GitHub o en Bitbucket, permite empezar AWS CodeBuild a reconstruir el código fuente cada vez que se introduce un cambio de código en el repositorio	Escritura	project*
DeleteBuildBatch	Concede permiso para eliminar un lote de creación	Escritura	project*
DeleteFleet	Otorga permiso para eliminar una flota de procesamiento	Escritura	fleet*
DeleteOAuthToken [solo permiso]	Concede permiso para eliminar un token de OAuth de un proveedor de OAuth de terceros conectado. Solo se usa en la AWS CodeBuild consola	Escritura
DeleteProject	Concede permiso para eliminar un proyecto de creación	Escritura	project*
DeleteReport	Concede permiso para eliminar un informe	Escritura	report-group*
DeleteReportGroup	Concede permiso para eliminar un grupo de informes	Escritura	report-group*
DeleteResourcePolicy	Concede permiso para eliminar una política de recursos para el proyecto o grupo de informes asociado	Administración de permisos	project
			report-group
DeleteSourceCredentials	Otorga permiso para eliminar un conjunto de GitHub credenciales de origen de GitHub Enterprise o Bitbucket	Escritura
DeleteWebhook	Concede permiso para eliminar webhook. En el caso de un proyecto de AWS CodeBuild compilación existente cuyo código fuente esté almacenado en un repositorio GitHub o en Bitbucket, detiene la reconstrucción AWS CodeBuild del código fuente cada vez que se introduce un cambio de código en el repositorio	Escritura	project*
DescribeCodeCoverages	Otorga permiso para devolver una matriz de objetos CodeCoverage	Leer	report-group*
DescribeTestCases	Otorga permiso para devolver una matriz de TestCase objetos	Leer	report-group*
GetReportGroupTrend	Concede permiso para analizar y acumular los valores de los informes de prueba para los informes de prueba en el grupo de informes	Leer	report-group*
GetResourcePolicy	Concede permiso para devolver una política de recursos para el proyecto o grupo de informes especificado	Leer	project
			report-group
ImportSourceCredentials	Otorga permiso para importar las credenciales del repositorio de origen de un AWS CodeBuild proyecto cuyo código fuente esté almacenado en un GitHub repositorio de GitHub Enterprise o Bitbucket	Escritura
InvalidateProjectCache	Concede permiso para restablecer la caché de un proyecto	Escritura	project*
ListBuildBatches	Concede permiso para obtener una lista de identificadores de lote de creación en la que cada ID representa un único lote de creación.	Enumeración
ListBuildBatchesForProject	Concede permiso para obtener una lista de ID de lotes de creación para el proyecto especificado, en la que cada ID representa un solo lote de creación.	Enumeración	project*
ListBuilds	Concede permiso para obtener una lista de ID de creación, en la que cada ID de creación representa una sola creación.	Enumeración
ListBuildsForProject	Concede permiso para obtener una lista de ID de creación para el proyecto de creación especificado, en la que cada ID de creación representa una sola creación.	Enumeración	project*
ListConnectedOAuthAccounts [solo permiso]	Concede permiso para enumerar a los proveedores de OAuth de terceros conectados. Solo se usa en la consola AWS CodeBuild	Enumeración
ListCuratedEnvironmentImages	Otorga permiso para obtener información sobre las imágenes de Docker gestionadas por AWS CodeBuild	Enumeración
ListFleets	Otorga permiso para obtener una lista de los ARN de la flota de cómputo, donde cada ARN de la flota de cómputo representa una sola flota	Enumeración
ListProjects	Concede permiso para obtener una lista de nombres de proyecto de creación, en la que cada nombre representa un solo proyecto de creación	Enumeración
ListReportGroups	Concede permiso para devolver una lista de ARN de grupos de informes. Cada ARN del grupo de informes representa un grupo de informes.	Enumeración
ListReports	Concede permiso para devolver una lista de ARN de informe. Cada ARN de informe representa un informe.	Enumeración
ListReportsForReportGroup	Concede permiso para devolver una lista de ARN de informes que pertenecen al grupo de informes especificado. Cada ARN de informe representa un informe.	Enumeración	report-group*
ListRepositories [solo permiso]	Concede permiso para enumera los repositorios de código de origen de un proveedor de OAuth de terceros conectado. Solo se utiliza en la consola AWS CodeBuild	Enumeración
ListSharedProjects	Concede permiso para devolver una lista de ARN de proyecto que se han compartido con el solicitante. Cada ARN de proyecto representa un proyecto.	Enumeración
ListSharedReportGroups	Concede permiso para devolver una lista de ARN de grupos de informes que se han compartido con el solicitante. Cada ARN del grupo de informes representa un grupo de informes.	Enumeración
ListSourceCredentials	Otorga permiso para devolver una lista de SourceCredentialsInfo objetos	Enumeración
PersistOAuthToken [solo permiso]	Concede permiso para guardar un token de OAuth de un proveedor de OAuth de terceros conectado. Solo se usa en la AWS CodeBuild consola	Escritura
PutResourcePolicy	Concede permiso para crear una política de recursos para el proyecto o grupo de informes asociado	Administración de permisos	project
			report-group
RetryBuild	Concede permiso para reintentar una creación	Escritura	project*
RetryBuildBatch	Concede permiso para reintentar un lote de creación	Escritura	project*
StartBuild	Concede permiso para comenzar a ejecutar una creación	Escritura	project*
StartBuildBatch	Concede permiso para comenzar a ejecutar un lote de creación	Escritura	project*
StopBuild	Concede permiso para intentar detener la ejecución de una creación	Escritura	project*
StopBuildBatch	Concede permiso para intentar detener la ejecución de un lote de creación	Escritura	project*
UpdateFleet	Otorga permiso para cambiar la configuración de una flota informática existente	Escritura	fleet*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateProject	Concede permiso para cambiar la configuración de un proyecto de creación existente	Escritura	project*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateProjectVisibility	Concede permiso para cambiar la visibilidad pública de un proyecto y sus creaciones	Escritura	project*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateReport [solo permiso]	Concede permiso para actualizar la información sobre un informe	Escritura	report-group*
UpdateReportGroup	Concede permiso para cambiar la configuración de un grupo de informes existentes	Escritura	report-group*
				aws:RequestTag/${TagKey} aws:TagKeys
UpdateWebhook	Otorga permiso para actualizar el webhook asociado a un proyecto de AWS CodeBuild compilación	Escritura	project*

Tipos de recursos definidos por AWS CodeBuild

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
build	arn:${Partition}:codebuild:${Region}:${Account}:build/${BuildId}
build-batch	arn:${Partition}:codebuild:${Region}:${Account}:build-batch/${BuildBatchId}
project	arn:${Partition}:codebuild:${Region}:${Account}:project/${ProjectName}	aws:ResourceTag/${TagKey}
report-group	arn:${Partition}:codebuild:${Region}:${Account}:report-group/${ReportGroupName}	aws:ResourceTag/${TagKey}
report	arn:${Partition}:codebuild:${Region}:${Account}:report/${ReportGroupName}:${ReportId}
fleet	arn:${Partition}:codebuild:${Region}:${Account}:fleet/${FleetName}:${FleetId}

Claves de condición de AWS CodeBuild

AWS CodeBuild define las siguientes claves de condición que se pueden utilizar en el Condition elemento 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 acciones en función de la presencia de pares de clave-valor de etiqueta en la solicitud.	Cadena
aws:ResourceTag/${TagKey}	Filtra el acceso mediante acciones en función de pares de clave-valor asociados al recurso.	Cadena
aws:TagKeys	Filtra el acceso mediante acciones en función de la presencia de claves de etiqueta en la solicitud	ArrayOfString