POST リクエストを使用して再開可能なアップロードを開始します。この最初のリクエストは、データのアップロードを行う後続の PUT リクエストで使用するセッション URI を生成します。最初のリクエストでは、オブジェクトのメタデータも指定できます。再開可能なアップロードが完了すると、アップロードしたオブジェクトは同じ名前のオブジェクトを置き換えます。Cloud Storage にアップロードするためのヒントについては、ベスト プラクティスをご覧ください。
XML API を使用したシンプルなアップロードでは、POST オブジェクトを使用せずに PUT Object リクエストを作成します。
クエリ文字列パラメータ
通常、このリクエストにはクエリ文字列パラメータは含まれません。
署名付き URL を作成して使用するときに指定するパラメータについては、署名付き URL クエリ文字列パラメータをご覧ください。
リクエスト ヘッダー
次のリクエスト ヘッダーを使用できます。
| ヘッダー | 説明 | 必須 |
|---|---|---|
Authorization |
リクエストの認証文字列。 | ○ |
Cache-Control |
一般公開のオブジェクトをキャッシュに保存する条件。Cache-Control は、オブジェクトを変換できるかどうかを判別するためにも使用されます。 |
× |
Content-Disposition |
オブジェクト データの転送方法に関するプレゼンテーション情報を指定するヘッダー。 | × |
Content-Encoding |
アップロードするオブジェクトの圧縮に使用された圧縮アルゴリズム。 | × |
Content-Language |
コンテンツの ISO 639-1 言語コード。 | × |
Content-Length |
ヘッダーを含まないリクエストの本文の長さ（バイト単位）。再開可能なアップロードを開始する場合、この値は 0 です。 |
○ |
Content-Type |
アップロードするオブジェクトの MIME タイプ。コンテンツ タイプを指定しない場合、Cloud Storage はオブジェクトを提供するときにデフォルトの application/octet-stream を使用します。 |
×（推奨） |
Date |
リクエストの日時。 | ○ |
Host |
Cloud Storage の URI。詳しくは、リクエスト エンドポイントをご覧ください。 | ○ |
x-goog-acl |
オブジェクトに適用する定義済みの ACL。 | × |
x-goog-custom-time |
ユーザーが指定した日時。 | × |
x-goog-encryption-kms-key-name |
オブジェクトの暗号化に使用する顧客管理の暗号鍵。 | × |
x-goog-if-generation-match |
指定した世代が置換されるオブジェクトと同じ場合、オブジェクトは置換されます。特別なオブジェクトとして 0 を指定すると、既存のオブジェクトが存在しない場合にのみ新しいオブジェクトが作成されることを示すことができます。 | × |
x-goog-if-metageneration-match |
指定したメタ世代が、更新するオブジェクトと同じである場合、オブジェクトのメタデータが更新されます。これは、x-goog-if-generation が指定されている場合にのみ使用できます。これらの 2 つのプロパティを組み合わせることで、安全な読み取り - 変更 - 書き込みの更新を実装できます。 |
× |
x-goog-meta- |
カスタム メタデータの保存に使用できる拡張ヘッダー。 | × |
x-goog-resumable |
このリクエストは再開可能なアップロードを開始することを示します。このヘッダーには値 start を使用する必要があります |
○ |
x-goog-storage-class |
関連するバケットのデフォルト ストレージ クラス以外のストレージ クラスをオブジェクトに付与します。 | × |
x-goog-user-project |
リクエストに関連する料金の請求先となるプロジェクト。 | × |
オブジェクトのアップロードと一緒に顧客指定の暗号鍵を指定するには、リクエスト内の顧客指定の暗号鍵ページにあるヘッダーを使用します。
リクエストの本文の要素
このリクエストの本文に XML ドキュメントは含まれません。
レスポンス ヘッダー
レスポンスには、オブジェクト データをアップロードするときに使用するセッション URI を示す Location ヘッダーが含まれます。
レスポンスの本文の要素
このレスポンスの本文に XML ドキュメントは含まれません。
例
次の例では、travel-maps という名前のバケット内にある paris.jpg という名前のオブジェクトをアップロードします。
リクエスト
POST /paris.jpg HTTP/2 Host: travel-maps.storage.googleapis.com Date: Thu, 10 Dec 2020 18:11:50 GMT Content-Type: image/jpg Content-Length: 0 X-Goog-Resumable: start Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
レスポンス
HTTP/2 201 Content-Type: text/plain; charset=utf-8 X-Guploader-Uploadid: ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE Location: https://storage.googleapis.com/nstocktest/xmltestinit.jpg?upload_id=ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE Content-Length: 0 Date: Thu, 10 Dec 2020 18:11:53 GMT Server: UploadServer