オブジェクト・メタデータの作成または更新
post
/v1/{account}/{container}/{object}
オブジェクト・メタデータを作成または更新します。
リクエスト
パス・パラメータ
- account: string
アカウントの一意の名前。 アカウントはプロジェクトまたはテナントとも呼ばれます。
- container: string
コンテナの一意の名前。 コンテナ名は1から256文字の長さにする必要があり、任意の文字から開始でき、任意のパターンを含むことができます。 文字セットはUTF-8である必要があります。 スラッシュ(
/)文字はコンテナとオブジェクト名を区切るため、コンテナ名に含めることはできません。 たとえば、/account/container/object。 - object: string
オブジェクトの一意の名前。
問合せパラメータ
- temp_url_expires: integer(timestamp)
最小値:
0一時URLの署名の有効期限が切れるUNIX Epochタイムスタンプ形式での日付と時刻。たとえば、
1440619048はMon, Wed, 26 Aug 2015 19:57:28 GMTと同等です。 - temp_url_sig: string
一時URLとともに使用して、許可されるHTTPメソッド、有効期限日、オブジェクトへのフル・パス、および一時URLの秘密キーを定義するHMAC-SHA1暗号署名付きリクエストに署名します。
ヘッダー・パラメータ
- Content-Disposition(optional): string
設定した場合、ブラウザの上書き動作を指定します。 たとえば、このヘッダーは、このファイルを表示する(デフォルト)のではなく、ブラウザがダウンロード・プログラムを使用してこのファイルを保存することを指定します。
- Content-Encoding(optional): string
設定した場合、
Content-Encodingメタデータの値。 - Content-Type(optional): string
オブジェクトのMIMEタイプを変更します。
- X-Auth-Token(optional): string
認証トークン。 このヘッダーを省略すると、アクセス制御リスト(ACL)によるアクセス権をアカウント所有者に付与されないかぎり、リクエストは失敗します。
- X-Delete-After(optional): integer
最小値:
0最小値:> trueシステムがオブジェクトを削除するまでの秒数。 内部で、Object Storageシステムはこの値をX-Delete-Atメタデータ・アイテムに格納します。 - X-Delete-At(optional): integer(timestamp)
最小値:
0システムがオブジェクトを削除するUNIX Epochタイムスタンプ形式での日付と時刻。たとえば、
1440619048はMon, Wed, 26 Aug 2015 19:57:28 GMTと同等です。 - X-Object-Meta-{name}(optional): string
オブジェクト・メタデータであり、
{name}はメタデータ・アイテムの名前です。追加または更新する各メタデータ
{name}アイテムに対してX-Object-Meta-{name}ヘッダーを指定する必要があります。
レスポンス
サポートされているメディア・タイプ
- application/json
202レスポンス
確定済
ヘッダー
- Content-Length: integer
最小値:
0この値はレスポンス本文のレスポンス・テキストの長さです。 - Content-Type: string
オブジェクトのMIMEタイプ。
- 日付: string(date-time)
トランザクションの日付と時刻。
日付と時刻のスタンプ形式はISO 8601です。
CCYY-MM-DDThh:mm:ss±hh:mm
たとえば、2015-08-27T09:49:58-05:00のようになります。±hh:mm値(含まれている場合)は、UTCからのオフセットとしてのタイム・ゾーンです。 前述の例では、オフセット値は-05:00です。null値はトークンの有効期限が切れないことを示します。 - X-Timestamp: integer(timestamp)
最小値:
0アカウント、コンテナまたはオブジェクトが現在のバージョンとして最初に作成されたUNIX Epochタイムスタンプ形式での日付と時刻。たとえば、
1440619048はMon, Wed, 26 Aug 2015 19:57:28 GMTと同等です。 - X-Trans-Id: string(uuid)
このリクエストの一意のトランザクションID。 サービス・プロバイダに問題を報告するときに、この値が必要な場合があります。
401レスポンス
リクエストに認証トークンが含まれていないか、リクエストで指定した認証トークンが無効です。 期限切れになっている可能性があります。 認証トークンは30分後に失効します。
ヘッダー
- Content-Length: integer
最小値:
0レスポンス本文のエラー・テキストの長さ。 - Content-Type: string
レスポンス本文のエラー・テキストのMIMEタイプ。
403レスポンス
禁止。 考えられる原因:
- Oracle Cloud My Servicesでサービスにデータ・センターが選択されていません。
- リクエストが誤ったデータ・センターに送信されました。 たとえば、サービスのデータ・センターはChicago (us2)ですが、リクエストはAshburn (us6)データ・センターに対応するURLに送信されました。
- 指定されたコンテナに対して操作を実行するために必要な権限がありません。 たとえば、ユーザーに割り当てられたロールや、リクエストに指定されたコンテナのアクセス権定義が変更される場合があります。
- 指定した操作は、アーカイブ済オブジェクトまたはストレージ・クラスが
Archiveのコンテナに対して許可されていません - 期限切れになっていないオブジェクトをPUT、POSTまたはDELETEしようとするか、既存のコンテナ・レベルWORMポリシーを更新しようとして、コンテナまたはオブジェクト・レベルWORMポリシーに違反しています。
ヘッダー
- Content-Length: integer
最小値:
0レスポンス本文のエラー・テキストの長さ。 - Content-Type: string
レスポンス本文のエラー・テキストのMIMEタイプ。
404レスポンス
オブジェクトが存在しないか、作成されたばかりで3つのすべてのノード間でレプリケートされていません。
ヘッダー
- Content-Length: integer
最小値:
0レスポンス本文のエラー・テキストの長さ。 - Content-Type: string
レスポンス本文のエラー・テキストのMIMEタイプ。
例
cURLコマンド
次の例は、cURLを使用してRESTリソースにPOSTリクエストを送信することによって、Oracle Cloud Infrastructure Object Storage Classic内のアカウントのコンテナ内のオブジェクトに必要なカスタムまたは任意のメタデータ(この例ではX-Object-Meta-Language: english)を作成および更新する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。
curl -v -X POST \
-H "X-Auth-Token: AUTH_tkb4fdf39c92e9f62cca9b7c196f8b6e6b" \
-H "X-Object-Meta-Language: english" \
https://foo.storage.oraclecloud.com/v1/myservice-bar/FirstContainer/myObject
レスポンスのサンプル
次に、このコマンドのレスポンスのサンプルを示します。
HTTP/1.1 202 Accepted Date: Mon, 09 Mar 2015 11:46:34 GMT Content-Length: 76 Content-Type: text/html; charset=UTF-8 X-Trans-Id: tx23a1084b8c674fdeae8d4-0054f982ac Content-Language: en