Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Acciones, recursos y claves de condición para Amazon Elastic Container Service
Amazon Elastic Container Service (prefijo de servicio: ecs) 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.
Temas
Acciones definidas por Amazon Elastic Container 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 |
|---|---|---|---|---|---|
| CreateCapacityProvider | Concede permiso para crear un nuevo proveedor de capacidad. Los proveedores de capacidad están asociados a un clúster de Amazon ECS y se utilizan en estrategias de proveedores de capacidad para facilitar el escalado automático de clústeres. | Write | |||
| CreateCluster | Concede permiso para crear un nuevo clúster de Amazon ECS. | Write | |||
| CreateService | Concede permiso para ejecutar y mantener el número deseado de tareas a partir de una definición de tarea especificada mediante la creación de servicios. | Write | |||
| CreateTaskSet | Concede permiso para crear un nuevo conjunto de tareas de Amazon ECS. | Write | |||
| DeleteAccountSetting | Concede permiso para modificar el formato ARN y de ID de recurso de un recurso para un usuario de IAM especificado, un rol de IAM o el usuario raíz de una cuenta. Puede especificar si el nuevo formato de ID y ARN del recurso está deshabilitado para los nuevos recursos que se crean. | Write | |||
| DeleteAttributes | Concede permiso para eliminar uno o varios atributos personalizados de un recurso de Amazon ECS. | Write | |||
| DeleteCapacityProvider | Concede permiso para eliminar el proveedor de capacidad especificado. | Write | |||
| DeleteCluster | Concede permiso para eliminar el clúster especificado. | Write | |||
| DeleteService | Concede permiso para eliminar un servicio especificado dentro de un clúster. | Escritura | |||
| DeleteTaskDefinitions | Concede permiso para anular las definiciones de tarea especificada por familia y revisión | Escritura | |||
| DeleteTaskSet | Concede permiso para eliminar el conjunto de tareas especificado. | Write | |||
| DeregisterContainerInstance | Concede permiso para anular el registro de una instancia de contenedor de Amazon ECS desde el clúster especificado. | Write | |||
| DeregisterTaskDefinition | Concede permiso para anular el registro de la definición de tarea especificada por familia y revisión. | Write | |||
| DescribeCapacityProviders | Concede permiso para describir uno o varios proveedores de capacidad de Amazon ECS. | Read | |||
| DescribeClusters | Concede permiso para describir uno o varios de los clústeres. | Read | |||
| DescribeContainerInstances | Concede permiso para describir instancias de contenedor de Amazon ECS. | Read | |||
| DescribeServices | Concede permiso para describir los servicios especificados que se ejecutan en el clúster. | Read | |||
| DescribeTaskDefinition | Concede permiso para describir una definición de tarea. Puede especificar una familia y una revisión con el fin de buscar información sobre una definición de tarea específica o puede especificar simplemente la familia para encontrar la última revisión ACTIVE en esa familia. | Read | |||
| DescribeTaskSets | Concede permiso para describir los conjuntos de tareas de Amazon ECS. | Read | |||
| DescribeTasks | Concede permiso para describir una tarea o tareas especificadas. | Read | |||
| DiscoverPollEndpoint | Concede permiso para obtener un punto de enlace para que el agente de Amazon ECS sondee con el objetivo de buscar actualizaciones. | Write | |||
| ExecuteCommand | Concede permiso para ejecutar un comando de forma remota en un contenedor de Amazon ECS. | Escritura | |||
| GetTaskProtection | Concede permiso para recuperar el estado de protección de las tareas en un servicio Amazon ECS | Leer | |||
| ListAccountSettings | Concede permiso para enumerar la configuración de la cuenta de un recurso de Amazon ECS para una entidad principal especificada. | Read | |||
| ListAttributes | Concede permiso para enumerar los atributos de los recursos de Amazon ECS dentro de un clúster y un tipo de destino especificados. | List | |||
| ListClusters | Concede permiso para obtener una lista de clústeres existentes. | List | |||
| ListContainerInstances | Concede permiso para obtener una lista de instancias de contenedor en un clúster especificado. | List | |||
| ListServices | Concede permiso para obtener una lista de servicios que se ejecutan en un clúster especificado. | Enumeración | |||
| ListServicesByNamespace | Otorga permiso para obtener una lista de los servicios que se ejecutan en un espacio de nombres de Nube de AWS mapa específico | Enumeración | |||
| ListTagsForResource | Concede permiso para obtener una lista de etiquetas del recurso especificado. | Read | |||
| ListTaskDefinitionFamilies | Concede permiso para obtener una lista de familias de definición de tareas registradas en su cuenta (que pueden incluir familias de definición de tareas que ya no tienen definiciones de tareas ACTIVE) | List | |||
| ListTaskDefinitions | Concede permiso para obtener una lista de definiciones de tareas registradas en su cuenta. | List | |||
| ListTasks | Concede permiso para obtener una lista de tareas para un clúster especificado. | List | |||
| Poll [solo permiso] | Concede permiso a un agente para conectarse con el servicio Amazon ECS con el fin de informar sobre el estado y obtener comandos. | Write | |||
| PutAccountSetting | Concede permiso para modificar el formato ARN y de ID de recurso de un recurso para un usuario de IAM especificado, un rol de IAM o el usuario raíz de una cuenta. Puede especificar si el nuevo formato de ID y ARN del recurso está habilitado para los nuevos recursos que se creen. La habilitación de esta configuración es necesaria para utilizar nuevas características de Amazon ECS, como el etiquetado de recursos. | Write | |||
| PutAccountSettingDefault | Concede permiso para modificar el formato ARN e ID de recurso de un tipo de recurso a todos los usuarios de IAM de una cuenta para la que no se haya establecido ninguna configuración de cuenta individual. La habilitación de esta configuración es necesaria para utilizar nuevas características de Amazon ECS, como el etiquetado de recursos. | Write | |||
| PutAttributes | Concede permiso para crear o actualizar un atributo en un recurso de Amazon ECS. | Write | |||
| PutClusterCapacityProviders | Concede permiso para modificar los proveedores de capacidad disponibles y la estrategia predeterminada de proveedor de capacidad para un clúster. | Write | |||
| RegisterContainerInstance | Concede permiso para registrar una instancia EC2 en el clúster especificado. | Write | |||
| RegisterTaskDefinition | Concede permiso para registrar una nueva definición de tarea de la familia suministrada y containerDefinitions. | Write | |||
| RunTask | Concede permiso para iniciar una tarea mediante la colocación aleatoria y el programador predeterminado de Amazon ECS. | Write | |||
| StartTask | Concede permiso para iniciar una nueva tarea a partir de la definición de tarea especificada en la instancia o instancias de contenedor especificadas. | Write | |||
| StartTelemetrySession | Concede permiso para iniciar una sesión de telemetría. | Write | |||
| StopTask | Concede permiso para detener una tarea en ejecución. | Write | |||
| SubmitAttachmentStateChanges | Concede permiso para enviar una confirmación de que los archivos adjuntos cambiaron de estado. | Write | |||
| SubmitContainerStateChange | Concede permiso para enviar una confirmación de que un contenedor cambió estados. | Write | |||
| SubmitTaskStateChange | Concede permiso para enviar una confirmación de que una tarea cambió estados. | Write | |||
| TagResource | Concede permiso para etiquetar el recurso especificado | Etiquetado | |||
| UntagResource | Concede permiso para quitar las etiquetas del recurso especificado | Etiquetado | |||
| UpdateCapacityProvider | Concede permiso para actualizar el proveedor de capacidad especificado. | Write | |||
| UpdateCluster | Concede permiso para modificar la configuración o ajustes que se van a utilizar para un clúster. | Write | |||
| UpdateClusterSettings | Concede permiso con el fin de modificar la configuración que se va a utilizar para un clúster. | Write | |||
| UpdateContainerAgent | Concede permiso para actualizar el agente de contenedor de Amazon ECS en una instancia de contenedor especificada. | Write | |||
| UpdateContainerInstancesState | Concede permiso al usuario para modificar el estado de una instancia de contenedor de Amazon ECS. | Write | |||
| UpdateService | Concede permiso para modificar los parámetros de un servicio. | Write | |||
| UpdateServicePrimaryTaskSet | Concede permiso para modificar el conjunto de tareas principal utilizado en un servicio. | Escritura | |||
| UpdateTaskProtection | Concede permiso para modificar el estado de protección de una tarea | Escritura | |||
| UpdateTaskSet | Concede permiso para actualizar el conjunto de tareas especificado. | Write | |||
Tipos de recursos definidos por Amazon Elastic Container 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 |
|---|---|---|
| cluster |
arn:${Partition}:ecs:${Region}:${Account}:cluster/${ClusterName}
|
|
| container-instance |
arn:${Partition}:ecs:${Region}:${Account}:container-instance/${ClusterName}/${ContainerInstanceId}
|
|
| service |
arn:${Partition}:ecs:${Region}:${Account}:service/${ClusterName}/${ServiceName}
|
|
| task |
arn:${Partition}:ecs:${Region}:${Account}:task/${ClusterName}/${TaskId}
|
|
| task-definition |
arn:${Partition}:ecs:${Region}:${Account}:task-definition/${TaskDefinitionFamilyName}:${TaskDefinitionRevisionNumber}
|
|
| capacity-provider |
arn:${Partition}:ecs:${Region}:${Account}:capacity-provider/${CapacityProviderName}
|
|
| task-set |
arn:${Partition}:ecs:${Region}:${Account}:task-set/${ClusterName}/${ServiceName}/${TaskSetId}
|
Claves de condición de Amazon Elastic Container Service
Amazon Elastic Container 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 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 por las etiquetas que se pasan en la solicitud | Cadena |
| aws:ResourceTag/${TagKey} | Filtra el acceso por los pares clave-valor de etiqueta adjuntados al recurso | Cadena |
| aws:TagKeys | Filtra el acceso por las claves de etiquetas que se pasan en la solicitud | ArrayOfString |
| ecs:CreateAction | Filtra el acceso mediante el nombre de una acción de API que crea recursos | Cadena |
| ecs:ResourceTag/${TagKey} | Filtra el acceso por los pares clave-valor de etiqueta adjuntados al recurso | Cadena |
| ecs:account-setting | Filtra el acceso mediante el nombre de la configuración de la cuenta de Amazon ECS. | Cadena |
| ecs:capacity-provider | Filtra el acceso por el ARN de un proveedor de capacidad de Amazon ECS | ARN |
| ecs:cluster | Filtra el acceso por el ARN de un clúster de Amazon ECS. | ARN |
| ecs:container-instances | Filtra el acceso por el ARN de una instancia de contenedor de Amazon ECS | ARN |
| ecs:container-name | Filtra el acceso por el nombre de un contenedor de Amazon ECS que se define en la definición de la tarea de ECS | Cadena |
| ecs:enable-ebs-volumes | Filtra el acceso mediante la capacidad de volumen de Amazon EBS gestionada por Amazon ECS a su tarea o servicio de ECS | Cadena |
| ecs:enable-execute-command | Filtra el acceso por la capacidad de ejecución de comandos de su tarea de Amazon ECS o servicio de Amazon ECS | Cadena |
| ecs:enable-service-connect | Filtra el acceso por el valor del campo de habilitación en la configuración del servicio Connect | Cadena |
| ecs:namespace | Filtra el acceso por el ARN del espacio de nombres del Nube de AWS mapa, que se define en la configuración de Service Connect | ARN |
| ecs:service | Filtra el acceso por el ARN de un servicio de Amazon ECS | ARN |
| ecs:task | Filtra el acceso por el ARN de una tarea de Amazon ECS | ARN |
| ecs:task-definition | Filtra el acceso por el ARN de una definición de tarea de Amazon ECS | ARN |
