AWS S3 API

Prev Next

Classic/VPC環境で利用できます。

AWS S3で提供する APIを利用して NAVERクラウドプラットフォームの Archive Storageを使用する例です。このガイドでは Amazon S3 v2006-03-01バージョンを基準に説明します。

参考
  • S3 APIは基本的な機能のみサポートするため、制限的な用途(Get/Listing)のみ使用することをおすすめします。このガイドで案内する他の SDKやコンソールを使用すると、より安定した環境で Archive Storageを使用できます。
  • 大容量オブジェクト管理時 S3 APIが不安定に動作する可能性があります。大容量オブジェクトを管理する場合は、大容量ファイル管理をご参照ください。

呼び出しドメイン(Endpoint)

HTTP/HTTPSプロトコルを全てサポートしていますが、データ保護のため、HTTPSプロトコルの使用を推奨します。

リージョン別の呼び出しドメインは、以下のとおりです。

リージョン リージョン名 呼び出しドメイン
韓国 kr https://kr.archive.ncloudstorage.com
参考

リージョン名は小文字で入力します。

認証キー(Credential)

NAVERクラウドプラットフォームコンソールで作成した API認証キーを使用します。API認証キー情報で Access Key IDは user name、Secret Keyは user passwordで使用します。

参考

オペレーション

NAVERクラウドプラットフォームの Archive Storageでは一部 S3 APIのみ提供します。サポートするオペレーションは以下のとおりです。

アカウント関連オペレーション

アカウント レベルでは、そのアカウントに属したバケットリストを照会するオペレーションのみサポートします。アカウント関連のオペレーションは以下のとおりです。

オペレーション 説明
GET account アカウントに属したバケットリストの照会

バケットオペレーション

バケットを作成、削除、照会、制御するオペレーションは以下のとおりです。

オペレーション 説明
DELETE Bucket 空のバケットの削除
GET Bucket バケットに含まれたオブジェクトの照会。一度に最大1,000個のオブジェクトが羅列される
HEAD Bucket バケットヘッダの照会
GET multipart uploads 完了していなかったりキャンセルされたマルチパートのアップロードの照会
PUT Bucket バケット作成。アカウントあたりのバケット数は1,000個に制限
参考

バケット内のオブジェクトリスト照会 GET Bucket (List Objects) Version 2はサポートしません。

オブジェクトオペレーション

オブジェクトを作成、削除、照会、制御するオペレーションは以下のとおりです。

オペレーション 説明
DELETE Object バケットからオブジェクトを削除
DELETE Multiple Objects バケットからマルチパートオブジェクトを削除
GET Object バケットでオブジェクト照会
HEAD Object オブジェクトヘッダ照会
PUT Object バケットにオブジェクトを追加
PUT Object (Copy) オブジェクトコピーの作成
Initiate Multipart Upload アップロードするパート集合に指定するアップロード IDの作成
Upload Part アップロード IDと関連されたオブジェクトのパートアップロード
Upload Part (Copy) アップロード IDと関連された既存オブジェクトのパートアップロード
Complete Multipart Upload アップロード IDと関連されたパートに分離されたオブジェクト結合
Abort Multipart Upload アップロードを中断し、アップロード IDに関連されたパートを削除
List Parts アップロード IDに関連されたパートリストを返却
注意
  • Archive Storageでディレクトリ(フォルダ)オブジェクトの content-typeは application/directoryを使用します。
  • ディレクトリ(フォルダ)オブジェクトの名前の最後に「/」を使用しないことをおすすめします。