As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Usar pontos de acesso
Os exemplos a seguir demonstram como usar pontos de acesso para acessar dados de arquivos armazenados em um volume FSx for ONTAP usando a API do S3. Para obter uma lista completa das operações de API do Amazon S3 suportadas por pontos de acesso conectados a um volume FSx for ONTAP, consulte. [Compatibilidade dos pontos de acesso](access-points-for-fsxn-object-api-support.md)
**nota**
Os arquivos ativados FSx para volumes ONTAP são identificados com um `StorageClass` de`FSX_ONTAP`.
**Topics**
+ [Baixar um arquivo usando um ponto de acesso S3](get-object-ap.md)
+ [Carregando um arquivo usando um ponto de acesso S3](put-object-ap.md)
+ [Listando arquivos usando um ponto de acesso S3](list-object-ap.md)
+ [Marcar um arquivo usando um ponto de acesso S3](add-tag-set-ap.md)
+ [Excluindo um arquivo usando um ponto de acesso S3](delete-object-ap.md)
# Baixar um arquivo usando um ponto de acesso S3
O `get-object` exemplo de comando a seguir mostra como você pode usar o AWS CLI para baixar um arquivo por meio de um ponto de acesso. Você deve incluir um arquivo de saída, que é um nome de arquivo para o objeto baixado.
O exemplo solicita o arquivo *`my-image.jpg`* por meio do ponto de acesso *`my-ontap-ap`* e salva o arquivo baixado 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"
}
```
Você também pode usar a API REST para baixar um objeto por meio de um ponto de acesso. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html) na *Referência da API do Amazon Simple Storage Service*.
# Carregando um arquivo usando um ponto de acesso S3
O `put-object` exemplo de comando a seguir mostra como você pode usar o AWS CLI para carregar um arquivo por meio de um ponto de acesso. Você deve incluir um arquivo de saída, que é um nome de arquivo para o objeto carregado.
O exemplo carrega o arquivo *`my-new-image.jpg`* por meio do ponto de acesso *`my-ontap-ap`* e salva o arquivo carregado 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
```
Você também pode usar a API REST para carregar um objeto por meio de um ponto de acesso. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html) na *Referência da API do Amazon Simple Storage Service*.
# Listando arquivos usando um ponto de acesso S3
O exemplo a seguir lista arquivos por meio do alias do ponto de acesso `my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias` pertencente ao ID da conta *`111122223333`* na região*`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"
},
]
}
```
Você também pode usar a API REST para listar seus arquivos. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html) na *Referência da API do Amazon Simple Storage Service*.
# Marcar um arquivo usando um ponto de acesso S3
O `put-object-tagging` exemplo de comando a seguir mostra como você pode usar o AWS CLI para adicionar um conjunto de tags por meio de um ponto de acesso. Cada tag é um par de chave/valor. Para obter mais informações, consulte [Classificação do armazenamento usando tags](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) no *Guia do usuário do Amazon Simple Storage Service*.
O exemplo adiciona um conjunto de tags ao arquivo existente `my-image.jpg` usando o ponto de acesso. *`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"}]
```
Você também pode usar a API REST para adicionar um conjunto de tags a um objeto por meio de um ponto de acesso. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html) na *Referência da API do Amazon Simple Storage Service*.
# Excluindo um arquivo usando um ponto de acesso S3
O `delete-object` exemplo de comando a seguir mostra como você pode usar o AWS CLI para excluir um arquivo por meio de um ponto de acesso.
```
$ aws s3api delete-object --bucket my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias --key my-image.jpg
```
Você também pode usar a API REST para excluir um objeto por meio de um ponto de acesso. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html) na *Referência da API do Amazon Simple Storage Service*.