projects

Changed on

Creates a batch job.

post/v1/{+parent}/jobs

Request

  • Base URL: https://storagebatchoperations.googleapis.com
  • URL: https://storagebatchoperations.googleapis.com/v1/{+parent}/jobs
  • Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/cloud-platform) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/cloud-platform)

Path parameters

parentstring required

Required. The value for parent.

Query parameters

jobIdstring

Required. A unique identifier for the job. job_id must be up to 128 characters and must include only characters available in DNS names, as defined by RFC-1123.

requestIdstring

Optional. An optional request ID to identify requests. Specify a unique request ID in case you need to retry your request. Requests with same request_id are ignored for at least 60 minutes since the first request. The request ID must be a valid UUID with the exception that zero UUID isn't supported (00000000-0000-0000-0000-000000000000).

Request body

completeTimestring google-datetime

Output only. The time that the job was completed.

createTimestring google-datetime

Output only. The time that the job was created.

descriptionstring

Optional. A user-provided description for the job. Maximum length: 1024 bytes when unicode-encoded.

dryRunboolean

Optional. If true, the job runs in dry run mode, returning the total object count and, if the object configuration is a prefix list, the bytes found from source. No transformations are performed.

isMultiBucketJobboolean

Output only. If true, this job operates on multiple buckets. Multi-bucket jobs are subject to different quota limits than single-bucket jobs.

namestring

Identifier. The resource name of the job. Format: projects/{project_id}/locations/global/jobs/{job_id}. For example: projects/123456/locations/global/jobs/job01. job_id is unique in a given project.

scheduleTimestring google-datetime

Output only. The time that the job was scheduled.

state'STATE_UNSPECIFIED' | 'RUNNING' | 'SUCCEEDED' | 'CANCELED' | 'FAILED' | 'QUEUED'

Output only. State of the job.

Response

Successful response

Changes

  • d43fb9f83002Revision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status