オブジェクト ストア レイヤーにデータを公開します

現在 blob 、このサービスは REST API バージョン v1 およびをサポート v2しています。 v1 バージョン管理、インデックス作成、およびストリーム(ストリームペイロードが 1MB より大きい場合)の各レイヤーへのアクセスには、バージョンを使用する必要があります。 v2 オブジェクト ストア レイヤーにアクセスするには、バージョンを使用する必要があります。 正しい API バージョンの応答が返されるように、 API 検索から適切な API バージョンを常に選択してください。 手順については 、『 API Lookup 開発者ガイド』を参照してください。

オブジェクト ストア レイヤーにデータを公開するには、 REST API blobv2を使用します。

一般的なパブリケーションフローは、次の手順で構成されています。

  1. 認可トークンを取得します。
  2. API ベースの URL を取得します。
  3. キーを選択します。
  4. データをアップロードします。

これらの手順については、以下で説明します。

  1. HTTP 要求の認可トークンを取得します。

    認可トークンの取得方法については、を参照してください

    『 ID およびアクセス管理ガイド』を参照してください。

  2. 公開先のカタログのblobv2 API の API ベースの URL を取得します。

    API ベースの URL を取得するには、 API ルックアップサービスを使用します。 手順については、を参照してください

    API 検索開発者ガイド

  3. キーを選択します

    blob オブジェクトストア API を使用してデータをアップロードするに は、 object_key と呼ばれる識別子を選択する必要があります。

    • a ~ z 、 A ~ Z 、 0 ~ 9.[] = (){}/_-` の任意の文字を使用できます。
    • '/' ( スラッシュ ) は、区切り文字によって解釈され、フォルダーに似た構造を定義します。
  4. データをアップロードします

    オブジェクトキーのデータをアップロードします。

    PUT /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keys/<Object Key> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: <Content-Type>
    Cache-Control: no-cache
    
    <Data to Upload>
    

    HTTP 5xx エラーを処理するための再試行ロジックがアプリケーションに含まれていることを推奨します。 再試行ロジックで指数バックオフを使用します。

1 つのパーツのアップロードは、最大 192 MB のオブジェクトに使用できます。 192 MB を超えるデータオブジェクトには、マルチパートアップロードを使用します。

オブジェクトストアのサイズ制限の詳細について は、「ワークスペースの制限とクォータ」を参照してください。

  1. 複数パーツのアップロードを初期化します。
  2. データパーツをアップロードします。
  3. マルチパートのアップロードを完了します。
  4. ステータスを待ちます。

これらの手順については、以下で説明します。

  1. 複数パーツのアップロードを初期化します。

    オブジェクトキーのマルチパートアップロードを初期化します。

    POST /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keys/<Object Key> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: application/json
    Cache-Control: no-cache
    
    {
        "contentType": "<Content-Type>",
        "contentEncoding": "<Content-Encoding>"
    }
    

    応答には multipartToken 、提供されたオブジェクトキーに対するこのマルチパートのアップロードを管理するために使用されたが含まれています。

    {
       "multipartToken": "7767cf80..."
    }
    
  2. データパーツをアップロードします。

    マルチパートのアップロードを初期化したので multipartToken 、前のステップで受信したを使用してデータをアップロードできます。

    192 MB を超えるデータをアップロードする場合は、データをパーツに分割し、各パーツを個別にアップロードする必要があります。 各パーツの最小サイズは 5 MB ですが、最小サイズではない最後のパーツは除きます。 部品内の最大データ量は 5 GB です。 また、クエリ パラメーターでパーツ番号を入力する必要が partNumberあります。パーツ番号は後でデータを再構成するために使用されます。

    192 MB 未満のデータをアップロードする場合は、データを 1 つの部分にアップロードできますが、最小サイズはありません。

    POST /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keysMultipart/<MultipartToken>/parts?partNumber=<Part Number> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: <Content-Type>
    Cache-Control: no-cache
    
    <Data to Upload>
    

    応答に ID は、アップロードされた部品のが含まれています。 マルチパートのアップロードを完了するために必要に応じて、これらを収集し、関連付けられている部品番号と関連付けます。

    { "id": "YTZmMDhkN..." }
    

    HTTP 5xx エラーを処理するための再試行ロジックがアプリケーションに含まれていることを推奨します。 再試行ロジックで指数バックオフを使用します。

  3. マルチパートのアップロードを完了します。

    複数パーツのアップロードを完了するには ID 、この complete リクエストを作成するために指定された URL を使用して、アップロードされたすべてのパーツのおよびパーツ番号を入力します。

    POST /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keysMultipart/<MultipartToken> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: application/json
    Cache-Control: no-cache
    
    {
      "parts": [
        {
          "id": "yJvYmplY..."
          "number": 1
        },
        {
          "id": "1h2h3k4..."
          "number": 2
        }
      ]
    }
    
  4. ステータスを待ちます。

    マルチパートのアップロードが完了したら、アップロードのステータスを要求して完了を待つ必要があります。

    GET /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keysMultipart/<MultipartToken> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: application/json
    Cache-Control: no-cache
    
    {
        "status": "completed"
    }
    

statuscompletedを受け取るまで、データが利用可能になる保証はありません。

  1. キーを選択します

    blob オブジェクトストア API を使用してデータをアップロードするに は、 object_key と呼ばれる識別子を選択する必要があります。

    • a ~ z 、 A ~ Z 、 0 ~ 9.[] = (){}/_-` の任意の文字を使用できます。
    • '/' ( スラッシュ ) は、区切り文字によって解釈され、フォルダーに似た構造を定義します。
  2. データをアップロードします

    オブジェクトキーのデータをアップロードします。

    PUT /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keys/<Object Key> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: <Content-Type>
    Cache-Control: no-cache
    
    <Data to Upload>
    

    HTTP 5xx エラーを処理するための再試行ロジックがアプリケーションに含まれていることを推奨します。 再試行ロジックで指数バックオフを使用します。

1 つのパーツのアップロードは、最大 192 MB のオブジェクトに使用できます。 192 MB を超えるデータオブジェクトには、マルチパートアップロードを使用します。

  1. 複数パーツのアップロードを初期化します。
  2. データパーツをアップロードします。
  3. マルチパートのアップロードを完了します。
  4. ステータスを待ちます。

これらの手順については、以下で説明します。

  1. 複数パーツのアップロードを初期化します。

    オブジェクトキーのマルチパートアップロードを初期化します。

    POST /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keys/<Object Key> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: application/json
    Cache-Control: no-cache
    
    {
        "contentType": "<Content-Type>",
        "contentEncoding": "<Content-Encoding>"
    }
    

    応答には multipartToken 、提供されたオブジェクトキーに対するこのマルチパートのアップロードを管理するために使用されたが含まれています。

    {
       "multipartToken": "7767cf80..."
    }
    
  2. データパーツをアップロードします。

    マルチパートのアップロードを初期化したので multipartToken 、前のステップで受信したを使用してデータをアップロードできます。

    192 MB を超えるデータをアップロードする場合は、データをパーツに分割し、各パーツを個別にアップロードする必要があります。 各パーツの最小サイズは 5 MB ですが、最小サイズではない最後のパーツは除きます。 部品内の最大データ量は 5 GB です。 また、クエリ パラメーターでパーツ番号を入力する必要が partNumberあります。パーツ番号は後でデータを再構成するために使用されます。

    192 MB 未満のデータをアップロードする場合は、データを 1 つの部分にアップロードできますが、最小サイズはありません。

    POST /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keysMultipart/<MultipartToken>/parts?partNumber=<Part Number> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: <Content-Type>
    Cache-Control: no-cache
    
    <Data to Upload>
    

    応答に ID は、アップロードされた部品のが含まれています。 マルチパートのアップロードを完了するために必要に応じて、これらを収集し、関連付けられている部品番号と関連付けます。

    { "id": "YTZmMDhkN..." }
    

    HTTP 5xx エラーを処理するための再試行ロジックがアプリケーションに含まれていることを推奨します。 再試行ロジックで指数バックオフを使用します。

  3. マルチパートのアップロードを完了します。

    複数パーツのアップロードを完了するには ID 、この complete リクエストを作成するために指定された URL を使用して、アップロードされたすべてのパーツのおよびパーツ番号を入力します。

    POST /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keysMultipart/<MultipartToken> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: application/json
    Cache-Control: no-cache
    
    {
      "parts": [
        {
          "id": "yJvYmplY..."
          "number": 1
        },
        {
          "id": "1h2h3k4..."
          "number": 2
        }
      ]
    }
    
  4. ステータスを待ちます。

    マルチパートのアップロードが完了したら、アップロードのステータスを要求して完了を待つ必要があります。

    GET /<Base path for the blob API from the API Lookup Service>/layers/<Layer ID>/keysMultipart/<MultipartToken> HTTP/1.1
    Host: <Hostname for the blob API from the API Lookup Service>
    Authorization: Bearer <Authorization Token>
    Content-Type: application/json
    Cache-Control: no-cache
    
    {
        "status": "completed"
    }
    

statuscompletedを受け取るまで、データが利用可能になる保証はありません。

」に一致する結果は 件です

    」に一致する結果はありません