オブジェクトの作成

コンセプトに移動

このページでは、ソース オブジェクトを作成して複合オブジェクトを作成する方法について説明します。1 つのリクエストで 1~32 個のソース オブジェクトを作成できます。

複合オブジェクトを作成するには:

Console

Cloud Console では、オブジェクト作成の実行はサポートされていません。代わりに gsutil を使用してください。

gsutil

gsutil compose コマンドを使用します。

gsutil compose gs://[BUCKET_NAME]/[SOURCE_OBJECT_1] gs://[BUCKET_NAME]/[SOURCE_OBJECT_2] gs://[BUCKET_NAME]/[COMPOSITE_OBJECT_NAME]

ここで

  • [BUCKET_NAME] は、ソース オブジェクトを含むバケットの名前です。
  • [SOURCE_OBJECT_1][SOURCE_OBJECT_2] は、オブジェクト作成で使用するソース オブジェクトの名前です。
  • [COMPOSITE_OBJECT_NAME] は、オブジェクト作成の結果に付ける名前です。

REST API

JSON API

  1. OAuth 2.0 Playground から承認アクセス トークンを取得します。固有の OAuth 認証情報を使用するようにプレイグラウンドを構成します。
  2. 次の情報が含まれる .json ファイルを作成します。

    {
      "sourceObjects": [
        {
          "name": "[SOURCE_OBJECT_1]"
        },
        {
          "name": "[SOURCE_OBJECT_2]"
        }
      ],
      "destination": {
        "contentType": "[COMPOSITE_OBJECT_CONTENT_TYPE]"
      }
    }

    ここで

    • [SOURCE_OBJECT_1][SOURCE_OBJECT_2] は、オブジェクト作成で使用するソース オブジェクトの名前です。
    • [COMPOSITE_OBJECT_CONTENT_TYPE] は、結果として得られる複合オブジェクトのコンテンツ タイプです。
  3. cURL を使用して、POST Object リクエストで JSON API を呼び出します。

    curl -X POST --data-binary @[JSON_FILE_NAME].json \
      -H "Authorization: Bearer [OAUTH2_TOKEN]" \
      -H "Content-Type: application/json" \
      "https://storage.googleapis.com/storage/v1/b/[BUCKET_NAME]/o/[COMPOSITE_OBJECT_NAME]/compose"

    ここで

    • [JSON_FILE_NAME] は、前の手順で作成したファイルの名前です。
    • [OAUTH2_TOKEN] は、ガイドの早い段階で生成したアクセス トークンです。
    • [BUCKET_NAME] は、ソース オブジェクトを含むバケットの名前です。
    • [COMPOSITE_OBJECT_NAME] は、オブジェクト作成の結果に付ける名前です。

成功した場合、レスポンスは結果として得られる複合オブジェクトのオブジェクト リソースです。

XML API

  1. OAuth 2.0 Playground から承認アクセス トークンを取得します。固有の OAuth 認証情報を使用するようにプレイグラウンドを構成します。
  2. 次の情報を含む .xml ファイルを作成します。

      <ComposeRequest>
        <Component>
          <Name>[SOURCE_OBJECT_1]</Name>
        </Component>
        <Component>
          <Name>[SOURCE_OBJECT_2]</Name>
        </Component>
      </ComposeRequest>

    ここで

    • [SOURCE_OBJECT_1][SOURCE_OBJECT_2] は、オブジェクト作成で使用するソース オブジェクトの名前です。
  3. cURL を使用して、PUT Object リクエストと compose クエリ文字列パラメータを含めた XML API を呼び出します。

    curl -X PUT --data-binary @[XML_FILE_NAME].xml \
      -H "Authorization: Bearer [OAUTH2_TOKEN]" \
      -H "Content-Type: [COMPOSITE_OBJECT_CONTENT_TYPE]" \
      "https://storage.googleapis.com/[BUCKET_NAME]/[COMPOSITE_OBJECT_NAME]?compose"

    ここで

    • [XML_FILE_NAME] は、前の手順で作成したファイルの名前です。
    • [OAUTH2_TOKEN] は、ガイドの早い段階で生成したアクセス トークンです。
    • [COMPOSITE_OBJECT_CONTENT_TYPE] は、結果として得られる複合オブジェクトのコンテンツ タイプです。
    • [BUCKET_NAME] は、ソース オブジェクトを含むバケットの名前です。
    • [COMPOSITE_OBJECT_NAME] は、オブジェクト作成の結果に付ける名前です。

成功した場合は、空のレスポンス本文が返されます。

次のステップ