Acciones, recursos y claves de condición para Amazon S3 Express
Amazon S3 Express (prefijo de servicio: s3express) proporciona las siguientes acciones, recursos y claves de contexto de condición específicos del servicio para usarlos 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 S3 Express
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 |
|---|---|---|---|---|---|
| CreateAccessPoint | Concede permiso para crear una aplicación nueva | Write | |||
|
s3express:DataAccessPointAccount s3express:AccessPointNetworkOrigin |
|||||
| CreateBucket | Concede permiso para crear un nuevo bucket | Escritura | |||
| CreateSession | Concede permiso para crear un token de sesión que se utiliza para las API de objetos como PutObject, GetObject, etc. | Escritura | |||
|
s3express:x-amz-content-sha256 s3express:x-amz-server-side-encryption s3express:x-amz-server-side-encryption-aws-kms-key-id |
|||||
| DeleteAccessPoint | Concede permiso para eliminar el punto de acceso nombrado en el URI | Write | |||
|
s3express:DataAccessPointAccount |
|||||
| DeleteAccessPointPolicy | Concede permiso para eliminar la política en un punto de acceso especificado | Administración de permisos | |||
|
s3express:DataAccessPointAccount |
|||||
| DeleteAccessPointScope | Concede permiso para eliminar la configuración de ámbito en un punto de acceso especificado. | Administración de permisos | |||
|
s3express:DataAccessPointAccount |
|||||
| DeleteBucket | Concede permiso para eliminar el bucket nombrado en el URI | Write | |||
| DeleteBucketPolicy | Concede permiso para eliminar la política en un bucket especificado | Administración de permisos | |||
| GetAccessPoint | Concede permiso para devolver información acerca de la configuración especificada | Lectura | |||
|
s3express:DataAccessPointAccount |
|||||
| GetAccessPointPolicy | Concede permiso para devolver la política de punto de acceso asociada al punto de acceso especificado. | Lectura | |||
|
s3express:DataAccessPointAccount |
|||||
| GetAccessPointScope | Concede permiso para devolver la configuración de ámbito asociada al punto de acceso especificado. | Lectura | |||
|
s3express:DataAccessPointAccount |
|||||
| GetBucketPolicy | Concede permiso para devolver la política del bucket especificado | Lectura | |||
| GetEncryptionConfiguration | Concede permiso para devolver la configuración de cifrado predeterminada para un bucket de directorio | Lectura | |||
| GetLifecycleConfiguration | Concede permiso para devolver la información de configuración del ciclo de vida establecida en un bucket de directorio. | Lectura | |||
| ListAccessPointsForDirectoryBuckets | Otorga permiso para enumerar puntos de acceso | Enumeración | |||
| ListAllMyDirectoryBuckets | Concede permiso para enumerar todos los buckets de directorio propiedad del remitente autenticado de la solicitud | Enumeración | |||
| ListTagsForResource | Concede permiso para enumerar todas las etiquetas de un recurso específico. | Enumeración | |||
| PutAccessPointPolicy | Otorga permiso para asociar una política de acceso a un punto de acceso especificado | Administración de permisos | |||
|
s3express:DataAccessPointAccount |
|||||
| PutAccessPointScope | Concede permiso para asociar un punto de acceso a una configuración de alcance de punto de acceso especificado. | Administración de permisos | |||
|
s3express:DataAccessPointAccount |
|||||
| PutBucketPolicy | Otorga permiso para agregar o reemplazar una política de bucket | Administración de permisos | |||
| PutEncryptionConfiguration | Concede permiso para establecer la configuración de cifrado para un bucket de directorio | Escritura | |||
| PutLifecycleConfiguration | Concede permiso para crear una nueva configuración de ciclo de vida para el bucket de directorio o reemplazar una configuración de ciclo de vida existente. | Escritura | |||
| TagResource | Concede permiso para crear una nueva etiqueta definida por el usuario o actualizar una etiqueta existente. | Etiquetado | |||
| UntagResource | Concede permiso para eliminar las etiquetas especificadas definidas por el usuario de un recurso de S3. | Etiquetado | |||
Tipos de recurso definidos por Amazon S3 Express
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 |
|---|---|---|
| bucket |
arn:${Partition}:s3express:${Region}:${Account}:bucket/${BucketName}
|
|
| accesspoint |
arn:${Partition}:s3express:${Region}:${Account}:accesspoint/${AccessPointName}
|
Claves de condición de Amazon S3 Express
Amazon S3 Express 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.
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 |
| s3express:AccessPointNetworkOrigin | Filtra el acceso por el origen de la red (Internet o VPC) | Cadena |
| s3express:AccessPointTag/${TagKey} | Filtra el acceso por los pares de clave-valor de etiqueta adjuntos al punto de acceso. | Cadena |
| s3express:AllAccessRestrictedToLocalZoneGroup | Filtra el acceso por grupo o grupos fronterizos de la red de AWS Local Zone que se proporcionan en esta clave de condición. | Cadena |
| s3express:BucketTag/${TagKey} | Filtra el acceso por los pares de clave-valor de etiqueta adjuntos al bucket. | Cadena |
| s3express:DataAccessPointAccount | Filtra el acceso según el ID de la cuenta de AWS propietaria del punto de acceso. | Cadena |
| s3express:DataAccessPointArn | Filtra el acceso por un punto de acceso Nombre de recurso de Amazon (ARN) | ARN |
| s3express:LocationName | Filtra el acceso por un ID de zona local o zona de disponibilidad específico. | Cadena |
| s3express:Permissions | Filtra el acceso por el permiso solicitado por la configuración de alcance del punto de acceso, como GetObject y PutObject. | ArrayOfString |
| s3express:ResourceAccount | Filtra el acceso por el ID de la Cuenta de AWS del propietario del recurso | Cadena |
| s3express:SessionMode | Filtra el acceso según el permiso solicitado por la API CreateSession, como ReadOnly y ReadWrite | Cadena |
| s3express:TlsVersion | Filtra el acceso por la versión de TLS utilizada por el cliente | Numérico |
| s3express:authType | Filtra el acceso por método de autenticación | Cadena |
| s3express:signatureAge | Filtra el acceso por la antigüedad en milisegundos de la firma de la solicitud | Numérico |
| s3express:signatureversion | Filtra el acceso por la versión de AWS Signature utilizada en la solicitud | Cadena |
| s3express:x-amz-content-sha256 | Filtra el acceso en función del contenido sin firmar en el bucket | Cadena |
| s3express:x-amz-server-side-encryption | Filtra el acceso por cifrado en el lado del servidor | Cadena |
| s3express:x-amz-server-side-encryption-aws-kms-key-id | Filtra el acceso por clave administrada por el cliente de AWS KMS para el cifrado del lado del servidor | ARN |
