Acciones, recursos y claves de condición para AWS CloudFormation
AWS CloudFormation (prefijo de servicio: cloudformation) 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.
Temas
Acciones definidas por AWS CloudFormation
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 Nivel de acceso de la tabla Acciones describe cómo se clasifica la acción (lista, lectura, administración de permisos o etiquetado). Esta clasificación puede ayudarle a entender el nivel de acceso que una acción concede cuando se utiliza en una política. Para obtener más información sobre los niveles de acceso, consulte Niveles de acceso en los resúmenes de políticas.
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.
La columna Acciones dependientes de la tabla Acciones muestra los permisos adicionales que pueden ser necesarios para llamar a una acción correctamente. Es posible que estos permisos sean necesarios además del permiso para la acción en sí. Cuando una acción especifica acciones dependientes, esas dependencias pueden aplicarse a los recursos adicionales definidos para esa acción, no solo al primer recurso de la tabla.
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 |
|---|---|---|---|---|---|
| ActivateOrganizationsAccess | Concede permiso para activar el acceso fiable entre StackSets y Organizations. Con el acceso de confianza entre StackSets y Organizations habilitado, la cuenta de administración tiene permisos para crear y administrar StackSets para su organización | Escritura | |||
| ActivateType | Concede permiso para activar una extensión pública de terceros, lo que la pone a disposición para su uso en plantillas de pila | Escritura | |||
| BatchDescribeTypeConfigurations | Concede permiso para devolver datos de configuración de las extensiones de CloudFormation especificadas | Lectura | |||
| CancelUpdateStack | Concede permiso para cancelar una actualización en la pila especificada. | Write | |||
| ContinueUpdateRollback | Concede permiso para continuar restaurando una pila que se encuentra en estado UPDATE_ROLLBACK_FAILED al estado UPDATE_ROLLBACK_COMPLETE. | Write | |||
| CreateChangeSet | Concede permiso para crear una lista de cambios para una pila. | Escritura | |||
| CreateGeneratedTemplate | Concede permiso para crear una plantilla a partir de recursos existentes que aún no se administran con CloudFormation | Escritura | |||
| CreateStack | Concede permiso para crear una pila según se especifica en la plantilla. | Write | |||
| CreateStackInstances | Concede permiso para crear instancias de pila para las cuentas especificadas, dentro de las regiones especificadas. | Escritura | |||
| CreateStackRefactor | Concede permiso para crear una refactorización de pila. | Escritura | |||
| CreateStackSet | Concede permiso para crear un conjunto de pila como se especifica en la plantilla. | Write | |||
| CreateUploadBucket [solo permiso] | Concede permiso para cargar plantillas a los buckets de Simple Storage Service (Amazon S3). Únicamente utilizado por la consola de AWS CloudFormation y no está documentado en la referencia de la API. | Escritura | |||
| DeactivateOrganizationsAccess | Concede permiso para desactivar el acceso fiable entre StackSets y Organizations. Si el acceso fiable está desactivado, la cuenta de administración no tiene permisos para crear y administrar StackSets administrados por servicios para su organización | Escritura | |||
| DeactivateType | Concede permiso para desactivar una extensión pública que se había activado anteriormente en esta cuenta y región | Escritura | |||
| DeleteChangeSet | Concede permiso para eliminar el conjunto de cambios especificado. Eliminar conjuntos de cambios garantiza que nadie ejecutará el conjunto de cambios equivocado. | Escritura | |||
| DeleteGeneratedTemplate | Concede permiso para eliminar una plantilla generada | Escritura | |||
| DeleteStack | Concede permiso para eliminar una pila específica. | Write | |||
| DeleteStackInstances | Concede permiso para eliminar instancias de pila para las cuentas especificadas, en las regiones especificadas. | Write | |||
| DeleteStackSet | Concede permiso para eliminar un conjunto de pilas específico. | Write | |||
| DeregisterType | Concede permiso para anular el registro de un tipo o versión de tipo existente de CloudFormation. | Write | |||
| DescribeAccountLimits | Concede permiso para recuperar los límites de AWS CloudFormation de su cuenta. | Read | |||
| DescribeChangeSet | Concede permiso para devolver la descripción del conjunto de cambios especificado. | Lectura | |||
| DescribeChangeSetHooks | Concede permiso para devolver la información de invocación de Hook para el conjunto de cambios especificado | Lectura | |||
| DescribeGeneratedTemplate | Concede permiso para describir una plantilla generada. La salida incluye detalles sobre el avance en la creación de una plantilla generada | Lectura | |||
| DescribeOrganizationsAccess | Concede permiso para devolver información sobre el estado de OrganizationAccess de la cuenta | Lectura | |||
| DescribePublisher | Concede permiso para devolver información acerca de un editor de extensiones de CloudFormation | Lectura | |||
| DescribeResourceScan | Concede permiso para describir detalles de un análisis de recursos | Lectura | |||
| DescribeStackDriftDetectionStatus | Concede permiso para devolver información sobre una operación de detección de desviación de pila. | Read | |||
| DescribeStackEvents | Concede permiso para devolver todos los eventos relacionados con la pila de una pila especificada. | Read | |||
| DescribeStackInstance | Concede permiso para regresar la instancia de pila asociada al conjunto de pilas, la Cuenta de AWS y la región especificados. | Lectura | |||
| DescribeStackRefactor | Concede permiso para devolver la descripción de la refactorización de pila especificada. | Lectura | |||
| DescribeStackResource | Concede permiso para devolver una descripción del recurso especificado en la pila especificada. | Read | |||
| DescribeStackResourceDrifts | Concede permiso para devolver información de desviaciones de los recursos en los que se han comprobado las desviaciones en la pila especificada. | Read | |||
| DescribeStackResources | Concede permiso para regresar descripciones de recursos de AWS para pilas en ejecución y eliminadas. | Read | |||
| DescribeStackSet | Concede permiso para devolver la descripción del conjunto de pilas especificado. | Read | |||
| DescribeStackSetOperation | Concede permiso para devolver la descripción de la operación de conjunto de pilas especificada. | Lectura | |||
| DescribeStacks | Concede permiso para devolver la descripción de la pila especificada, y de todas las pilas cuando se utiliza en combinación con la acción ListStacks | Enumeración |
cloudformation:ListStacks |
||
| DescribeType | Concede permiso para devolver información sobre el tipo de CloudFormation solicitado. | Read | |||
| DescribeTypeRegistration | Concede permiso para devolver información sobre el proceso de registro de un tipo de CloudFormation. | Read | |||
| DetectStackDrift | Concede permiso para detectar si la configuración real de una pila es diferente o se ha desviado de su configuración prevista, tal y como se define en la plantilla de pila y los valores especificados como parámetros de la plantilla. | Read | |||
| DetectStackResourceDrift | Concede permiso para devolver información sobre si la configuración real de un recurso es diferente o se ha desviado de su configuración prevista, tal y como se define en la plantilla de pila y los valores especificados como parámetros de la plantilla. | Read | |||
| DetectStackSetDrift | Concede permiso para permitir a los usuarios detectar la deriva en un conjunto de pila y las instancias de pila que pertenecen a ese conjunto de pila. | Read | |||
| EstimateTemplateCost | Concede permiso para devolver el costo mensual estimado de una plantilla. | Read | |||
| ExecuteChangeSet | Concede permiso para actualizar una pila con la información de entrada que se proporcionó cuando se creó el conjunto de cambios especificado. | Escritura | |||
| ExecuteStackRefactor | Concede permiso para ejecutar una refactorización de pila con la información de entrada que se proporcionó cuando se creó la refactorización de pila especificada. | Escritura | |||
| GetGeneratedTemplate | Concede permiso para recuperar una plantilla generada | Lectura | |||
| GetStackPolicy | Concede permiso para devolver la política de pila para una pila especificada. | Read | |||
| GetTemplate | Concede permiso para devolver el cuerpo de la plantilla para una pila especificada. | Read | |||
| GetTemplateSummary | Concede permiso para devolver información sobre una plantilla nueva o existente. | Lectura | |||
| ImportStacksToStackSet | Concede permiso para permitir a los usuarios importar pilas existentes a un conjunto de pilas nuevo o existente | Escritura | |||
| ListAllHookResults | Concede permiso para devolver la información de los resultados de las invocaciones de enlace para un enlace específico, una combinación de enlace y estado, o todos los enlaces. | Enumeración | |||
| ListChangeSets | Concede permiso para devolver el ID y el estado de cada conjunto de cambios activo de una pila. Por ejemplo, AWS CloudFormation muestra una lista de los conjuntos de cambios que están en los estados CREATE_IN_PROGRESS o CREATE_PENDING. | List | |||
| ListExports | Concede permiso para enumerar todos los valores de salida exportados en la cuenta y la región en la que se llama a esta acción. | Enumeración | |||
| ListGeneratedTemplates | Concede permiso para enumerar las plantillas generadas en esta región | Enumeración | |||
| ListHookResults | Concede permiso para devolver la información de los resultados de las invocaciones de enlace para el destino especificado. | Enumeración | |||
| ListImports | Concede permiso para enumerar todas las pilas que importan un valor de salida exportado. | Enumeración | |||
| ListResourceScanRelatedResources | Concede permiso para enumerar los recursos relacionados para una lista de recursos a partir de un análisis de recursos. La respuesta indica si cada recurso devuelto ya es administrado por CloudFormation | Enumeración | |||
| ListResourceScanResources | Concede permiso para enumerar los recursos de un análisis de recursos. Los resultados se pueden filtrar por identificador de recurso, prefijo de tipo de recurso, clave de etiqueta y valor de etiqueta | Enumeración | |||
| ListResourceScans | Concede permiso para enumerar los análisis de recursos del más reciente al más antiguo. De forma predeterminada, devolverá hasta 10 análisis de recursos | Enumeración | |||
| ListStackInstanceResourceDrifts | Concede permiso para devolver información de desviaciones de los recursos en los que se han comprobado las desviaciones en la instancia de la pila especificada | Enumeración | |||
| ListStackInstances | Concede permiso para devolver información resumida sobre instancias de pila asociadas al conjunto de pilas especificado. | Enumeración | |||
| ListStackRefactorActions | Concede permiso para devolver la lista de acciones de la refactorización de pila especificada. | Enumeración | |||
| ListStackRefactors | Concede permiso para devolver el ID y el estado de cada refactorización de pila activa. | Enumeración | |||
| ListStackResources | Concede permiso para devolver descripciones de todos los recursos de la pila especificada. | Enumeración | |||
| ListStackSetAutoDeploymentTargets | Concede permiso para devolver información resumida sobre los destinos de implementación automática de StackSet | Enumeración | |||
| ListStackSetOperationResults | Concede permiso para devolver información resumida sobre los resultados de una operación de conjunto de pilas. | List | |||
| ListStackSetOperations | Concede permiso para devolver información resumida sobre operaciones realizadas en un conjunto de pilas. | List | |||
| ListStackSets | Concede permiso para devolver información resumida sobre conjuntos de pilas asociados con el usuario. | Enumeración | |||
| ListStacks | Concede permiso para devolver la información resumida de pilas cuyo estado coincide con el valor de StackStatusFilter especificado. En combinación con la acción DescribeStacks, concede permiso para enumerar las descripciones de las pilas | Enumeración | |||
| ListTypeRegistrations | Concede permiso para enumerar los intentos de registro del tipo de CloudFormation. | List | |||
| ListTypeVersions | Concede permiso para enumerar las versiones de un determinado tipo de CloudFormation. | List | |||
| ListTypes | Concede permiso para enumerar los tipos disponibles de CloudFormation. | Enumeración | |||
| PublishType | Concede permiso para publicar la extensión especificada en el registro de CloudFormation como extensión pública de esta región | Escritura | |||
| RecordHandlerProgress | Concede permiso para registrar el progreso del controlador | Escritura | |||
| RegisterPublisher | Concede permiso para registrar una cuenta como editor de extensiones públicas en el registro de CloudFormation | Escritura | |||
| RegisterType | Concede permiso para registrar un nuevo tipo de CloudFormation. | Escritura | |||
| RollbackStack | Concede permiso para revertir la pila al último estado estable | Escritura | |||
| SetStackPolicy | Concede permiso para establecer una política de pila para una pila especificada. | Administración de permisos | |||
| SetTypeConfiguration | Concede permiso para establecer los datos de configuración de una extensión de CloudFormation registrada, en la cuenta y región especificadas | Escritura | |||
| SetTypeDefaultVersion | Concede permiso para establecer qué versión de tipo de CloudFormation se aplica a las operaciones de CloudFormation. | Write | |||
| SignalResource | Concede permiso para enviar una señal al recurso especificado con un estado de éxito o error. | Escritura | |||
| StartResourceScan | Concede permiso para iniciar un análisis de los recursos de esta cuenta en esta región | Escritura | |||
| StopStackSetOperation | Concede permiso para detener una operación en curso en un conjunto de pilas y sus instancias de pila asociadas. | Write | |||
| TagResource | Concede permiso para etiquetar recursos de CloudFormation. | Etiquetado | |||
| TestType | Concede permiso para probar una extensión registrada a fin de asegurarse de que cumple con todos los requisitos necesarios para publicarse en el registro de CloudFormation | Escritura | |||
| UntagResource | Concede permiso para desetiquetar recursos de CloudFormation. | Etiquetado | |||
| UpdateGeneratedTemplate | Concede permiso para actualizar una plantilla generada. Se puede utilizar para cambiar el nombre, agregar y eliminar recursos, actualizar recursos y cambiar la configuración de DeletionPolicy y UpdateReplacePolicy | Escritura | |||
| UpdateStack | Concede permiso para actualizar una pila según se especifica en la plantilla. | Write | |||
| UpdateStackInstances | Concede permiso para actualizar los valores de parámetros de las instancias de pila de las cuentas especificadas, dentro de las regiones especificadas. | Write | |||
| UpdateStackSet | Concede permiso para actualizar un conjunto de pila según se especifica en la plantilla. | Write | |||
| UpdateTerminationProtection | Concede permiso para actualizar la protección de terminación para la pila especificada. | Write | |||
| ValidateTemplate | Concede permiso para validar una plantilla especificada. | Read |
Tipos de recursos definidos por AWS CloudFormation
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 |
|---|---|---|
| changeset |
arn:${Partition}:cloudformation:${Region}:${Account}:changeSet/${ChangeSetName}/${Id}
|
|
| stack |
arn:${Partition}:cloudformation:${Region}:${Account}:stack/${StackName}/${Id}
|
|
| stackset |
arn:${Partition}:cloudformation:${Region}:${Account}:stackset/${StackSetName}:${Id}
|
|
| stackset-target |
arn:${Partition}:cloudformation:${Region}:${Account}:stackset-target/${StackSetTarget}
|
|
| type |
arn:${Partition}:cloudformation:${Region}:${Account}:type/resource/${Type}
|
|
| generatedtemplate |
arn:${Partition}:cloudformation:${Region}:${Account}:generatedTemplate/${Id}
|
|
| resourcescan |
arn:${Partition}:cloudformation:${Region}:${Account}:resourceScan/${Id}
|
Claves de condición para AWS CloudFormation
AWS CloudFormation define las siguientes claves de condición que pueden utilizarse 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.
A fin de ver las claves de condición globales que están disponibles para todos los servicios, consulte AWSClaves de contexto de condición globales.
| Claves de condición | Descripción | Tipo |
|---|---|---|
| aws:RequestTag/${TagKey} | Filtra el acceso por las etiquetas que se pasan en la solicitud | Cadena |
| aws:ResourceTag/${TagKey} | Filtra el acceso por las etiquetas asociadas al recurso | Cadena |
| aws:TagKeys | Filtra el acceso por las claves de etiquetas que se pasan en la solicitud | ArrayOfString |
| cloudformation:ChangeSetName | Filtra el acceso en función de un nombre del conjunto de cambios de AWS CloudFormation. Se utiliza para controlar qué conjuntos de cambios pueden ejecutar o eliminar los usuarios de IAM. | Cadena |
| cloudformation:CreateAction | Filtra el acceso según el nombre de una acción de API que modifica recursos. Se utiliza para controlar qué API pueden usar los usuarios de IAM para agregar o eliminar etiquetas en una pila o un conjunto de pilas. | Cadena |
| cloudformation:ImportResourceTypes | Filtra el acceso en función de los tipos de recursos de plantilla, como AWS::EC2::Instance. Se utiliza para controlar con qué tipos de recursos pueden trabajar los usuarios de IAM cuando desean importar un recurso a una pila. | Cadena |
| cloudformation:ResourceTypes | Filtra el acceso en función de los tipos de recursos de plantilla, como AWS::EC2::Instance. Se utiliza para controlar con qué tipo de recursos pueden trabajar los usuarios de IAM al crear o actualizar una pila. | ArrayOfString |
| cloudformation:RoleArn | Filtra el acceso en función del ARN de una función de servicio de IAM. Se utiliza para controlar qué rol de servicio pueden utilizar los usuarios de IAM para trabajar con conjuntos de cambios o pilas. | ARN |
| cloudformation:StackPolicyUrl | Filtra el acceso en función de una URL de política de pila de Amazon S3. Se utiliza para controlar qué políticas de pila pueden asociar los usuarios de IAM a una pila durante una acción de creación o actualización de la pila. | Cadena |
| cloudformation:TargetRegion | Filtra el acceso por región de destino del conjunto de pila. Se utiliza para controlar qué regiones pueden usar los usuarios de IAM cuando crean o actualizan los conjuntos de pilas. | ArrayOfString |
| cloudformation:TemplateUrl | Filtra el acceso en función de una URL de plantilla de Amazon S3. Se utiliza para controlar qué plantillas pueden usar los usuarios de IAM cuando crean o actualizan pilas. | Cadena |
| cloudformation:TypeArn | Filtra el acceso según el ARN de una extensión de CloudFormation. | ARN |