Method: projects.locations.jobs.create

Creates a batch job for a given project.

IAM Permissions:

Requires storagebatchoperations.jobs.create IAM permission on the project.

HTTP request

POST https://storagebatchoperations.googleapis.com/v1/{parent=projects/*/locations/global}/jobs

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. Value for parent.

Query parameters

Parameters
jobId

string

Required. A unique identifier for this job.

If not specified, a server-generated identifier is assigned.

The identifier must meet the following requirements:

  • Maximum length of 128 characters.
  • Characters must be valid in DNS names as defined by RFC 1123.
requestId

string

Optional. A unique identifier for your request. Specify the request ID, if you need to retry the request. If you retry the request with the same ID within 60 minutes, the server ignores the request if it has already completed the original request.

For example, if your initial request times out and you retry the request using the same request ID, the server recognizes the original request and does not process the new request.

The request ID must be a valid UUID and cannot be a zero UUID (00000000-0000-0000-0000-000000000000).

Request body

The request body contains an instance of Job.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the Authentication Overview.