再開可能なアップロードを開始する

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