Method: projects.locations.batches.create

非同期で実行されるバッチ ワークロードを作成します。

HTTP リクエスト

POST https://dataproc.googleapis.com/v1/{parent=projects/*/locations/*}/batches

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
parent

string

必須。このバッチが作成される親リソース。

認可には、指定されたリソース parent に対する次の IAM の権限が必要です。

  • dataproc.batches.create

クエリ パラメータ

パラメータ
batchId

string

省略可。バッチに使用する ID。バッチのリソース名の最終的なコンポーネントになります。

この値は 4 ~ 63 文字にする必要があります。有効な文字は /[a-z][0-9]-/ です。

requestId

string

省略可。リクエストの識別に使用される一意の ID。サービスが同じ requestId を持つ 2 つの CreateBatchRequest を受信した場合、2 番目のリクエストは無視され、バックエンドで作成されて保存された最初のバッチに対応するオペレーションが返されます。

推奨: この値は UUID に設定します。

値に使用できるのは、英字(a ~ z、A ~ Z)、数字(0 ~ 9)、アンダースコア(_)、ハイフン(-)のみです。最大長は 40 文字です。

リクエストの本文

リクエストの本文には Batch のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/cloud-platform

詳細については、認証の概要をご覧ください。