翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# アクセスポイントの使用
次の例は、アクセスポイントを使用して、S3 API を使用して FSx for ONTAP ボリュームに保存されているファイルデータにアクセスする方法を示しています。FSx for ONTAP ボリュームにアタッチされたアクセスポイントでサポートされている Amazon S3 API オペレーションの完全なリストについては、「」を参照してください[アクセスポイントの互換性](access-points-for-fsxn-object-api-support.md)。
**注記**
FSx for ONTAP ボリューム上のファイルは、 `StorageClass`の で識別されます`FSX_ONTAP`。
**Topics**
+ [S3 アクセスポイントを使用したファイルのダウンロード](get-object-ap.md)
+ [S3 アクセスポイントを使用したファイルのアップロード](put-object-ap.md)
+ [S3 アクセスポイントを使用したファイルの一覧表示](list-object-ap.md)
+ [S3 アクセスポイントを使用したファイルのタグ付け](add-tag-set-ap.md)
+ [S3 アクセスポイントを使用したファイルの削除](delete-object-ap.md)
# S3 アクセスポイントを使用したファイルのダウンロード
次のコマンド`get-object`例は、 を使用してアクセスポイント経由でファイル AWS CLI をダウンロードする方法を示しています。ダウンロードしたオブジェクトのファイル名である outfile を含める必要があります。
この例では、アクセスポイント*`my-image.jpg`*を介してファイルをリクエスト*`my-ontap-ap`*し、ダウンロードしたファイルを として保存します*`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"
}
```
REST API を使用して、アクセスポイントを介してオブジェクトをダウンロードすることもできます。詳細については、「**Amazon Simple Storage Service API リファレンス」の「[https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html)」を参照してください。
# S3 アクセスポイントを使用したファイルのアップロード
次のコマンド`put-object`例は、 を使用してアクセスポイントを介してファイル AWS CLI をアップロードする方法を示しています。アップロードされたオブジェクトのファイル名である outfile を含める必要があります。
この例では、アクセスポイント*`my-new-image.jpg`*を介してファイルをアップロード*`my-ontap-ap`*し、アップロードしたファイルを として保存します*`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
```
REST API を使用して、アクセスポイントを介してオブジェクトをアップロードすることもできます。詳細については、「**Amazon Simple Storage Service API リファレンス」の「[https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html)」を参照してください。
# S3 アクセスポイントを使用したファイルの一覧表示
次の の例では、リージョン のアカウント ID `my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias`が所有するアクセスポイントエイリアスを介してファイルを一覧表示*`111122223333`*します*`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"
},
]
}
```
REST API を使用してファイルを一覧表示することもできます。詳細については、「**Amazon Simple Storage Service API リファレンス」の「[https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html)」を参照してください。
# S3 アクセスポイントを使用したファイルのタグ付け
次のコマンド`put-object-tagging`例は、 を使用してアクセスポイントを介してタグセット AWS CLI を追加する方法を示しています。各タグはキーバリューのペアです。詳細については、「*Amazon Simple Storage Service ユーザーガイド*」の「[タグを使用してストレージを分類する](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html)」を参照してください。
この例では、アクセスポイント `my-image.jpg`を使用して既存のファイルにタグセットを追加します*`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"}]
```
REST API を使用して、アクセスポイントを介してオブジェクトにタグセットを追加することもできます。詳細については、「**Amazon Simple Storage Service API リファレンス」の「[https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectTagging.html)」を参照してください。
# S3 アクセスポイントを使用したファイルの削除
次のコマンド`delete-object`例は、 を使用してアクセスポイントを介してファイル AWS CLI を削除する方法を示しています。
```
$ aws s3api delete-object --bucket my-ontap-ap-hrzrlukc5m36ft7okagglf3gmwluquse1b-ext-s3alias --key my-image.jpg
```
REST API を使用して、アクセスポイントを介してオブジェクトを削除することもできます。詳細については、「**Amazon Simple Storage Service API リファレンス」の「[https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html)」を参照してください。