機械翻訳について

移動

• リクエスト
• レスポンス
• 例

オブジェクトの作成または置換

put

/v1/{account}/{container}/{object}

データの内容およびメタデータでオブジェクトを作成するか、既存のオブジェクトをデータの内容およびメタデータで置換します。

オブジェクトのコピーについては、Oracle Cloud Infrastructure Object Storage Classicの使用の「オブジェクトのコピー」を参照してください。

リクエスト

パス・パラメータ

• account: string
  アカウントの一意の名前。 アカウントはプロジェクトまたはテナントとも呼ばれます。
• container: string
  コンテナの一意の名前。 コンテナ名は1から256文字の長さにする必要があり、任意の文字から開始でき、任意のパターンを含むことができます。 文字セットはUTF-8である必要があります。 スラッシュ(/)文字はコンテナとオブジェクト名を区切るため、コンテナ名に含めることはできません。 たとえば、/account/container/object。
• object: string
  オブジェクトの一意の名前。

問合せパラメータ

• multipart-manifest(optional): string
  ?multipart-manifest=putの場合、オブジェクトは静的ラージ・オブジェクトのマニフェストであり、本文にマニフェストが含まれます。
• 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-Length(optional): integer
  最小値: 0

  オブジェクトの内容の長さに設定します。 チャンク転送エンコーディングが使用されている場合は設定しないでください。
• Content-Type(optional): string
  オブジェクトのMIMEタイプを変更します。
• ETag(optional): string
  リクエスト本文のMD5チェックサム値。 たとえば、オブジェクトの内容のMD5チェックサム値。 オブジェクトの内容のMD5チェックサム値を計算し、その値をリクエストに含めることをお薦めします。 これによって、Object Storage APIでアップロードの整合性を確認できます。 値は引用符で囲まれません。
• If-None-Match(optional): string
  Expect: 100-Continueと組み合せて、If-None-Match: *ヘッダーを指定し、データを送信する前にサーバーにオブジェクトのコピーがすでにあるかどうかを問い合せます。
• Transfer-Encoding(optional): string
  チャンク転送エンコーディングを有効にするには、chunkedに設定します。 使用する場合は、Content-Lengthヘッダーをゼロ以外の値に設定しないでください。
• X-Auth-Token(optional): string
  認証トークン。 temp_url_sigおよびtemp_url_expiresが存在する場合は指定されません。 それ以外の場合は、このヘッダーを省略すると、アカウント所有者がアクセス制御リスト(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}ヘッダーを指定する必要があります。

• X-Worm-Expiration-At(optional): integer
  最小値: 0

  アップロードされたオブジェクトが削除可能になるまで存在する必要があるEpoch時間。 値は現在のEpoch時間より大きくする必要があります。

  コンテナにX-Worm-Expiration-Daysポリシーがある場合、X-Worm-Expiration-Atでは現在のEpoch時間+ X-Worm-Expiration-Daysより大きいEpoch時間を指定する必要があります。

• X-Worm-Expiration-Days(optional): integer
  最小値: 1

  PUTまたはPOSTで上書きまたは削除できるようになるまでに、オブジェクトがアップロードされた後にコンテナに存在する必要がある最小日数。

トップに戻る

レスポンス

サポートされているメディア・タイプ

• application/json

201レスポンス

正常な書込み

ヘッダー

• Content-Length: integer
  最小値: 0

  最大値: 0

  この値はゼロ(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値はトークンの有効期限が切れないことを示します。

• ETag: string
  5 GBより小さいオブジェクトの場合、この値はアップロードされたオブジェクトの内容のMD5チェックサムです。 値は引用符で囲まれません。

  ETagリクエスト・ヘッダーを指定し、操作が成功した場合、値は同じです。

  ETagリクエスト・ヘッダーを指定しなかった場合は、アップロードしたオブジェクトの内容に対するETagレスポンス・ヘッダー値を確認してください。

  静的ラージ・オブジェクトの場合、この値は、マニフェスト内の各セグメントのMD5チェックサムとETagの連結文字列のMD5チェックサムであり、ダウンロードされた内容のMD5チェックサムではありません。 また、値は二重引用符で囲まれます。 動的ラージ・オブジェクトの場合、値は空の文字列のMD5チェックサムです。

• Last-Modified: string(date-time)
  オブジェクトが前回変更された日付と時刻。

  日付と時刻のスタンプ形式はISO 8601です。

  CCYY-MM-DDThh:mm:ss±hh:mm

  たとえば、2015-08-27T09:49:58-05:00のようになります。

  ±hh:mm値(含まれている場合)は、UTCからのオフセットとしてのタイム・ゾーンです。 前述の例では、オフセット値は-05:00です。

• X-Timestamp: integer(timestamp)
  最小値: 0

  アカウント、コンテナまたはオブジェクトが現在のバージョンとして最初に作成されたUNIX Epochタイムスタンプ形式での日付と時刻。

  たとえば、1440619048はMon, Wed, 26 Aug 2015 19:57:28 GMTと同等です。

• X-Trans-Id: string(uuid)
  このリクエストの一意のトランザクションID。 サービス・プロバイダに問題を報告するときに、この値が必要な場合があります。

400レスポンス

失敗 このエラーは、次のいずれかの条件が原因で発生することがあります: X-Worm-Expiration-DaysまたはX-Worm-Expiration-Atヘッダーの値が無効な整数であるか、0以下です。 コンテナにはX-Worm-Expiration-DaysまたはX-Worm-Expiration-Atメタデータがすでに指定されています。 コンテナにはX-Worm-Expiration-Daysが指定されており、オブジェクトをアップロードし、X-Worm-Expiration-DaysまたはX-Worm-Expiration-Atを指定して、コンテナX-Worm-Expiration-Days金額より前の失効になるオブジェクトをアップロードします。

ヘッダー

• Content-Length: integer
  最小値: 1

  この値はレスポンス本文のエラー・テキストの長さです。
• 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-Trans-Id: string(uuid)
  このリクエストの一意のトランザクション識別子。 サービス・プロバイダに問題を報告するときに、この値が必要な場合があります。

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: string
  レスポンス本文のエラー・テキストの長さ。
• Content-Type: string
  レスポンス本文のエラー・テキストのMIMEタイプ。

408 レスポンス

リクエスト・タイムアウト

ヘッダー

• Content-Length: integer
  最小値: 0

  レスポンス本文のエラー・テキストの長さ。
• Content-Type: string
  レスポンス本文のエラー・テキストのMIMEタイプ。

411レスポンス

リクエストのTransfer-EncodingまたはContent-Lengthヘッダーのいずれかがありません

ヘッダー

• Content-Length: integer
  最小値: 0

  レスポンス本文のエラー・テキストの長さ。
• Content-Type: string
  レスポンス本文のエラー・テキストのMIMEタイプ。

413レスポンス

操作が次のいずれかの制限を超えています。

• オブジェクト・サイズが5GBより大きい
• 追加のオブジェクト・データがアカウントの未使用の割当て制限を超えています
• (コンテナ割当て制限を設定している場合)追加のオブジェクト・データまたはオブジェクト数がコンテナの未使用の割当て制限を超えています。

ヘッダー

• Content-Length: string
  レスポンス本文のエラー・テキストの長さ。
• Content-Type: string
  レスポンス本文のエラー・テキストのMIMEタイプ。

422レスポンス

アップロード・リクエストで指定したETagヘッダーの値がHTTPレスポンスのMD5チェックサムと一致しません。

ヘッダー

• Content-Length: integer
  最小値: 0

  レスポンス本文のエラー・テキストの長さ。
• Content-Type: string
  レスポンス本文のエラー・テキストのMIMEタイプ。

トップに戻る

例

cURLコマンド

次の例は、cURLを使用してRESTリソースにPUTリクエストを送信して、Oracle Cloud Infrastructure Object Storage Classic内のアカウントのコンテナにオブジェクトを作成する方法を示しています。 cURLの詳細は、「cURLの使用」を参照してください。

curl -v -X PUT \
     -H "X-Auth-Token: AUTH_tkb4fdf39c92e9f62cca9b7c196f8b6e6b" \
     -T myFile.txt \
     https://foo.storage.oraclecloud.com/v1/myservice-bar/FirstContainer/myObject

レスポンスのサンプル

次に、このコマンドのレスポンスのサンプルを示します。

HTTP/1.1 201 Created
Date: Mon, 09 Mar 2015 11:26:57 GMT
Last-Modified: Mon, 09 Mar 2015 11:26:58 GMT
Content-Length: 0
Etag: 846fa9d298be05e5f598703f0c3d6f51
Content-Type: text/html; charset=UTF-8
X-Trans-Id: tx2a97f34acb7048679ae3b-0054fd8381
Content-Language: en

トップに戻る