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.
# Usar puntos de acceso
Los siguientes ejemplos muestran cómo utilizar los puntos de acceso para acceder a los datos de archivos almacenados en un FSx volumen de ONTAP mediante la API S3. Para obtener una lista completa de las operaciones de la API de Amazon S3 compatibles con los puntos de acceso adjuntos a un volumen FSx de ONTAP, consulte[Compatibilidad con puntos de acceso](access-points-for-fsxn-object-api-support.md).
**nota**
Los archivos de FSx los volúmenes de ONTAP se identifican con un `StorageClass` de. `FSX_ONTAP`
**Topics**
+ [Descargar un archivo mediante un punto de acceso S3](get-object-ap.md)
+ [Cargar un archivo mediante un punto de acceso S3](put-object-ap.md)
+ [Listar archivos mediante un punto de acceso S3](list-object-ap.md)
+ [Etiquetar un archivo mediante un punto de acceso S3](add-tag-set-ap.md)
+ [Eliminar un archivo mediante un punto de acceso S3](delete-object-ap.md)
# Descargar un archivo mediante un punto de acceso S3
El siguiente comando de `get-object` ejemplo muestra cómo se puede utilizar AWS CLI para descargar un archivo a través de un punto de acceso. Debe incluir un archivo de salida, que es el nombre de archivo del objeto descargado.
En el ejemplo, se solicita el archivo *`my-image.jpg`* a través del punto de acceso *`my-ontap-ap`* y se guarda el archivo descargado como*`download.jpg`*.
```
$ aws s3api get-object --key my-image.jpg --bucket my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias download.jpg
{
"AcceptRanges": "bytes",
"LastModified": "Mon, 14 Oct 2024 17:01:48 GMT",
"ContentLength": 141756,
"ETag": "\"00751974dc146b76404bb7290f8f51bb-1\"",
"ContentType": "binary/octet-stream",
"ServerSideEncryption": "SSE_FSX",
"Metadata": {},
"StorageClass": "FSX_ONTAP"
}
```
También puedes usar la API REST para descargar 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_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) en la *Referencia de la API de Amazon Simple Storage Service*.
# Cargar un archivo mediante un punto de acceso S3
El siguiente comando de `put-object` ejemplo muestra cómo se puede utilizar AWS CLI para cargar un archivo a través de un punto de acceso. Debe incluir un archivo de salida, que es el nombre de archivo del objeto cargado.
En el ejemplo, se carga el archivo *`my-new-image.jpg`* a través del punto de acceso *`my-ontap-ap`* y se guarda el archivo cargado como. *`my-new-image.jpg`*
```
$ aws s3api put-object --bucket my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias --key my-new-image.jpg --body my-new-image.jpg
```
También puedes usar la API 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*.
# Listar archivos mediante un punto de acceso S3
En el siguiente ejemplo, se enumeran los archivos a través del alias del punto de acceso `my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias` propiedad del ID de cuenta *`111122223333`* en la región*`us-east-2`*.
```
$ aws s3api list-objects-v2 --bucket my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias
{
"Contents": [
{
"Key": ".hidden-dir-with-data/file.txt",
"LastModified": "2024-10-29T14:22:05.4359",
"ETag": "\"88990077ab44cd55ef66aa77-1\"",
"Size": 18,
"StorageClass": "FSX_ONTAP"
},
{
"Key": "documents/report.rtf",
"LastModified": "2024-11-02T10:18:15.6621",
"ETag": "\"ab12cd34ef56a89219zg6aa77-1\"",
"Size": 1048576,
"StorageClass": "FSX_ONTAP"
},
]
}
```
También puedes usar la API REST para enumerar tus archivos. Para obtener más información, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html) en la *Referencia de la API de Amazon Simple Storage Service*.
# Etiquetar un archivo mediante un punto de acceso S3
El siguiente comando de `put-object-tagging` ejemplo muestra cómo se puede utilizar AWS CLI para añadir un conjunto de etiquetas a través de un punto de acceso. Cada etiqueta es un par clave-valor. Para obtener información, consulte [Categorización del almacenamiento mediante etiquetas](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) en la *Guía del usuario de Amazon Simple Storage Service*.
El ejemplo agrega un conjunto de etiquetas al archivo existente `my-image.jpg` mediante el punto de acceso. *`my-ontap-ap`*
```
$ aws s3api put-object-tagging --bucket my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias --key my-image.jpg --tagging TagSet=[{Key="finance",Value="true"}]
```
También puedes usar la API REST para añadir un conjunto de etiquetas a 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_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) en la *Referencia de la API de Amazon Simple Storage Service*.
# Eliminar un archivo mediante un punto de acceso S3
El siguiente comando de `delete-object` ejemplo muestra cómo se puede utilizar AWS CLI para eliminar un archivo a través de un punto de acceso.
```
$ aws s3api delete-object --bucket my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias --key my-image.jpg
```
También puedes usar la API REST para eliminar 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_DeleteObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html) en la *Referencia de la API de Amazon Simple Storage Service*.