# Carga de un objeto mediante un punto de acceso para un bucket de propósito general
En esta sección se explica cómo cargar un objeto a través de un punto de acceso para un bucket de propósito general mediante la Consola de administración de AWS, la AWS Command Line Interface o la API de REST.
## Uso de la consola de S3
**Carga de un objeto a través de un punto de acceso en la Cuenta de AWS**
1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. En la barra de navegación de la parte superior de la página, elija el nombre de la Región de AWS que aparece. A continuación, elija la región para la que desee enumerar los puntos de acceso.
1. En el panel de navegación del lado izquierdo de la consola, elija **Puntos de acceso**.
1. (Opcional) Busque puntos de acceso por nombre. Aquí solo aparecerán los puntos de acceso de la Región de AWS seleccionada.
1. Elija el nombre del punto de acceso que desea administrar o utilizar.
1. En la pestaña **Objetos**, seleccione **Cargar**.
1. Arrastre y suelte aquí los archivos y carpetas que desee cargar o elija **Agregar archivos** o **Agregar carpeta**.
**nota**
El tamaño máximo de un archivo que puede cargar con la consola de Amazon S3 es de 160 GB. Para cargar un archivo que sobrepase los 160 GB de tamaño, utilice la AWS Command Line Interface (AWS CLI), el SDK de AWS o la API de REST de Amazon S3.
1. Para cambiar los permisos de la lista de control de acceso, elija **Permissions (Permisos)**.
1. En **Access control list (ACL) (Lista de control de acceso [ACL])**, edite los permisos.
Para obtener información acerca de los permisos de acceso a objetos, consulte [Uso de la consola S3 para establecer permisos de ACL para un objeto](managing-acls.md#set-object-permissions). Puede conceder acceso de lectura a los objetos al público (a todo el mundo) para todos los archivos que esté cargando. Sin embargo, recomendamos no cambiar la configuración predeterminada para el acceso de lectura pública. Otorgar acceso de lectura público es aplicable a un pequeño conjunto de casos de uso, por ejemplo cuando los buckets se utilizan para sitios web. Siempre puede cambiar los permisos del objeto después de cargarlo.
1. Para configurar otras propiedades, elija **Propiedades**.
1. En la sección **Clase de almacenamiento**, elija la clase de almacenamiento para los archivos que esté cargando.
Para obtener más información acerca de las clases de almacenamiento, consulte [Descripción y administración de clases de almacenamiento de Amazon S3](storage-class-intro.md).
1. Para actualizar la configuración de cifrado de los objetos, en **Server-side encryption settings** (Configuración de cifrado del lado del servidor), haga lo siguiente.
1. Elija **Specify an encryption key (Especificar una clave de cifrado)**.
1. En **Configuración del cifrado**, elija **Usar la configuración del bucket para el cifrado predeterminado** o **Anular la configuración del bucket para el cifrado predeterminado**.
1. Si elige **Anular la configuración del bucket para el cifrado predeterminado**, debe configurar los siguientes ajustes de cifrado.
+ Para cifrar los archivos cargados con claves que administra Amazon S3, seleccione **Clave administrada de Amazon S3 (SSE-S3)**.
Para obtener más información, consulte [Uso del cifrado del servidor con claves administradas por Amazon S3 (SSE-S3)](UsingServerSideEncryption.md).
+ Si desea cifrar los archivos cargados mediante claves almacenadas en AWS Key Management Service (AWS KMS), elija la **Clave de AWS Key Management Service (SSE-KMS)**. A continuación, elija una de las siguientes opciones para la **clave de AWS KMS**:
+ Para seleccionar en una lista de claves de KMS disponibles, marque **Elija entre sus claves de AWS KMS keys** y seleccione su **clave de KMS** de la lista de claves disponibles.
En esta lista aparecen tanto la Clave administrada de AWS (`aws/s3`) como las claves administradas por el cliente. Para obtener más información acerca de las claves administradas por el cliente, consulte [Claves de cliente y claves de AWS](https://docs.aws.amazon.com//kms/latest/developerguide/concepts.html#key-mgmt) en la *Guía para desarrolladores de AWS Key Management Service*.
+ Para introducir el ARN de la clave de KMS, elija **Introducir el ARN de la clave de AWS KMS key** e introduzca el ARN de la clave de KMS en el campo que aparece.
+ Para crear una nueva clave administrada por el cliente en la consola de AWS KMS, elija **Crear una clave de KMS**.
Para obtener más información acerca de cómo crear una AWS KMS key, consulte [Creación de claves](https://docs.aws.amazon.com//kms/latest/developerguide/create-keys.html) en la *AWS Key Management Service Guía para desarrolladores*.
**importante**
Solo puede utilizar las claves de KMS que estén disponibles en la misma Región de AWS del bucket. La consola de Amazon S3 solo muestra las primeras 100 claves de KMS de la misma región del bucket. Para utilizar una clave de KMS que no aparezca en la lista, debe introducir el ARN de la clave de KMS. Si desea utilizar una clave de KMS propiedad de una cuenta de diferente, primero debe tener permiso para utilizar la clave y, después, debe introducir el ARN de la clave de KMS.
Amazon S3 admite solo claves de KMS de cifrado simétricas y no claves de KMS asimétricas. Para obtener más información, consulte [Identificación de claves de KMS simétricas y asimétricas](https://docs.aws.amazon.com//kms/latest/developerguide/find-symm-asymm.html) en la *Guía para desarrolladores de AWS Key Management Service*.
1. Para utilizar sumas de comprobación adicionales, elija **On (Activado)**. A continuación, en **Checksum function (Función de suma de comprobación)**, elija la función que desearía utilizar. Amazon S3 calcula y almacena el valor de la suma de comprobación después de recibir todo el objeto. Puede utilizar el recuadro **Precalculated value (Valor precalculado)** para proporcionar un valor precalculado. Si lo hace, Amazon S3 compara el valor que proporcionó con el valor que calcula. Si los valores no coinciden, Amazon S3 genera un error.
Las sumas de comprobación adicionales le permiten especificar el algoritmo de suma de comprobación que desea utilizar para verificar los datos. Para obtener más información sobre sumas de comprobación adicionales, consulte [Comprobación de la integridad de objetos en Amazon S3](checking-object-integrity.md).
1. Para agregar etiquetas a todos los objetos que va a cargar, elija **Add tag** (Agregar etiqueta). Escriba un nombre de etiqueta en el campo **Clave**. Ingrese un valor para la etiqueta.
El etiquetado de objetos le permite categorizar el almacenamiento. Cada etiqueta es un par clave-valor. Los valores de clave y de etiqueta distinguen entre mayúsculas y minúsculas. Puede tener hasta 10 etiquetas por cada objeto. Una clave de etiqueta puede tener una longitud de hasta 128 caracteres Unicode y los valores de etiqueta pueden tener una longitud de hasta 255 caracteres Unicode. Para obtener más información acerca de las etiquetas de objeto, consulte [Categorización de los objetos mediante etiquetas](object-tagging.md).
1. Para agregar metadatos, elija **Agregar metadatos**.
1. En **Tipo**, elija **Definidos por el sistema** o **Definidos por el usuario**.
Para los metadatos definidos por el sistema, puede seleccionar encabezados HTTP comunes, como **Tipo de contenido** y **Disposición de contenido**. Para obtener una lista de metadatos definidos por el sistema e información sobre si puede agregar el valor, consulte [Metadatos de objetos definidos por el sistema](UsingMetadata.md#SysMetadata). Cualquier metadato que comience con el prefijo `x-amz-meta-` se trata como metadato definido por el usuario. Los metadatos definidos por el usuario se almacenan con el objeto y se devuelven cuando lo descarga. Tanto las claves como sus valores deben cumplir los estándares ASCII de EE. UU. Los metadatos definidos por el usuario pueden tener un tamaño de hasta 2 KB. Para obtener más información acerca de los metadatos definidos por el sistema y por el usuario, consulte [Trabajar con metadatos de objeto](UsingMetadata.md).
1. En **Clave**, elija una clave.
1. Escriba un valor para la clave.
1. Para cargar los objetos, seleccione **Cargar**.
Amazon S3 carga su objeto. Cuando finalice la carga, puede ver un mensaje de éxito en la página **Cargar: estado**.
## Uso de AWS CLI
El siguiente comando `put-object` de ejemplo muestra cómo puede utilizar la AWS CLI para cargar un objeto a través de un punto de acceso.
El siguiente comando carga el objeto `puppy.jpg` para la Cuenta de AWS *111122223333* mediante el punto de acceso *my-access-point*.
```
aws s3api put-object --bucket arn:aws:s3:Región de AWS:111122223333:accesspoint/my-access-point --key puppy.jpg --body puppy.jpg
```
**nota**
S3 genera automáticamente alias de punto de acceso para todos los puntos de acceso y los alias de punto de acceso se pueden utilizar en cualquier lugar donde se utilice un nombre de bucket para realizar operaciones a nivel de objeto. Para obtener más información, consulte [Alias de punto de acceso](access-points-naming.md#access-points-alias).
Para obtener más información y ejemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object.html) en la *referencia de comandos de AWS CLI*.
## Uso de la API de REST
Puede utilizar la API de REST para cargar un objeto a través de un punto de acceso. Para obtener más información, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) en la *Referencia de la API de Amazon Simple Storage Service*.
## Uso de los AWS SDK
Puede utilizar el AWS SDK para Python para cargar un objeto a través de un punto de acceso.
------
#### [ Python ]
En el siguiente ejemplo, se descarga el archivo denominado `hello.txt` se carga para la cuenta de AWS *111122223333* mediante el punto de acceso denominado *my-access-point*.
```
import boto3
s3 = boto3.client('s3')
s3.upload_file('/tmp/hello.txt', 'arn:aws:s3:us-east-1:111122223333:accesspoint/my-access-point', 'hello.txt')
```
------