Object Storageの概要

概要

NAVERクラウドプラットフォーム Object Storageは、ストレージの管理と使用に必要な S3 APIを提供しています。

バージョン: Amazon S3 v2006-03-01

呼び出しドメイン(Endpoint)

HTTPと HTTPSプロトコルのいずれもサポートしていますが、データ保護のため、HTTPSの使用をお勧めします。

リージョン別呼び出しドメイン

提供リージョンは継続して拡大する予定です。

認証キー(Credential)

ポータルのマイページ > アカウント管理 > 認証キー管理で作成した API認証キーを使用します。

以下、S3 APIを利用して NAVERクラウドプラットフォーム Object Storageにアクセスする際に使用できるすべてのオペレーションを説明します。
サンプルコードを含むオペレーション使用方法の詳細は、バケットのオペレーション、オブジェクトのオペレーションページをご参照ください。

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

アカウントレベルでは、そのアカウントに属するバケットリストを照会するオペレーションのみサポートしています。アカウントのバケット数は1,000個に制限されます。

バケットのオペレーション

バケットを作成、削除、照会、制御するオペレーションを説明します。

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

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

オブジェクトを作成、削除、照会、制御するオペレーションを説明します。

共通ヘッダ

共通リクエストヘッダ

次の表で、NAVERクラウドプラットフォーム Object Storageでサポートしている共通リクエストヘッダを説明します。

NAVERクラウドプラットフォーム Object Storageは、次の表に明記されていない共通ヘッダに対し、リクエストが転送された場合でも無視します。

ただし、リクエストの一部は、この文書に定義された通り、他のヘッダをサポートすることがあります。
認証ヘッダ作成の詳細は、「認証の管理」ページで確認できます。

共通レスポンスヘッダ

次の表で、共通レスポンスヘッダを説明します。

レスポンスステータスコード

認証

NAVERクラウドプラットフォーム Object Storage APIの認証は Authorizationヘッダを通じて行われます。認証方法の詳細は、Object Storage APIご利用ガイドで確認できます。

アクセス制御リスト(ACL)

NAVERクラウドプラットフォーム Object Storageサービスを利用中の会員を対象に、バケットとオブジェクトへのアクセス権限を付与できます。

NAVERクラウドプラットフォーム Object Storageご利用の申し込みを完了した会員には、Object Storageで使用可能な IDが発行されます。
この IDは、バケットとオブジェクトのアクセス権限を設定する際に用いられます。

さらに、認証なしでアクセスできるように public-read、public-write権限も設定できます。

次の表で、権限の種類と、その権限が付与された場合に実行可能なオペレーションを説明します。

次の表で、NAVERクラウドプラットフォーム Object Storageでサポートしている基本 ACLを説明します。この表に明示されていない値はサポートしていません。

public-readを含む READ権限がバケットに適用された場合、オブジェクトは照会のみ行えます。オブジェクト自体にはアクセスできません。