Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-132661,4471.5 MB
batchPredictionJobs

Creates a BatchPredictionJob. A BatchPredictionJob once created will right away be attempted to start.

post/v1/batchPredictionJobs

Query parameters

parentstring

Required. The resource name of the Location to create the BatchPredictionJob in. Format: projects/{project}/locations/{location}

Request body

updateTimestring google-datetime

Output only. Time when the BatchPredictionJob was most recently updated.

labelsobject

The labels with user-defined metadata to organize BatchPredictionJobs. Label keys and values can be no longer than 64 characters (Unicode codepoints), can only contain lowercase letters, numeric characters, underscores and dashes. International characters are allowed. See https://goo.gl/xmQnxf for more information and examples of labels.

generateExplanationboolean

Generate explanation with the batch prediction results. When set to true, the batch prediction output changes based on the predictions_format field of the BatchPredictionJob.output_config object: * bigquery: output includes a column named explanation. The value is a struct that conforms to the Explanation object. * jsonl: The JSON objects on each line include an additional entry keyed explanation. The value of the entry is a JSON object that conforms to the Explanation object. * csv: Generating explanations for CSV format is not supported. If this field is set to true, either the Model.explanation_spec or explanation_spec must be populated.

namestring

Output only. Resource name of the BatchPredictionJob.

displayNamestring

Required. The user-defined name of this BatchPredictionJob.

disableContainerLoggingboolean

For custom-trained Models and AutoML Tabular Models, the container of the DeployedModel instances will send stderr and stdout streams to Cloud Logging by default. Please note that the logs incur cost, which are subject to Cloud Logging pricing. User can disable container logging by setting this flag to true.

satisfiesPziboolean

Output only. Reserved for future use.

modelstring

The name of the Model resource that produces the predictions via this job, must share the same ancestor Location. Starting this job has no impact on any existing deployments of the Model and their resources. Exactly one of model, unmanaged_container_model, or endpoint must be set. The model resource name may contain version id or version alias to specify the version. Example: projects/{project}/locations/{location}/models/{model}@2 or projects/{project}/locations/{location}/models/{model}@golden if no version is specified, the default version will be deployed. The model resource could also be a publisher model. Example: publishers/{publisher}/models/{model} or projects/{project}/locations/{location}/publishers/{publisher}/models/{model}

serviceAccountstring

The service account that the DeployedModel's container runs as. If not specified, a system generated one will be used, which has minimal permissions and the custom container, if used, may not have enough permission to access other Google Cloud resources. Users deploying the Model must have the iam.serviceAccounts.actAs permission on this service account.

satisfiesPzsboolean

Output only. Reserved for future use.

modelVersionIdstring

Output only. The version ID of the Model that produces the predictions via this job.

createTimestring google-datetime

Output only. Time when the BatchPredictionJob was created.

state'JOB_STATE_UNSPECIFIED' | 'JOB_STATE_QUEUED' | 'JOB_STATE_PENDING' | 'JOB_STATE_RUNNING' | 'JOB_STATE_SUCCEEDED' | 'JOB_STATE_FAILED' | 'JOB_STATE_CANCELLING' | 'JOB_STATE_CANCELLED' | 'JOB_STATE_PAUSED' | 'JOB_STATE_EXPIRED' | 'JOB_STATE_UPDATING' | 'JOB_STATE_PARTIALLY_SUCCEEDED'

Output only. The detailed state of the job.

{"stackTrail":"components:schemas:GoogleCloudAiplatformV1BatchPredictionJob:properties:modelParameters","oasType":"schema","type":"unknown","description":"The parameters that govern the predictions. The schema of the parameters may be specified via the Model's PredictSchemata's parameters_schema_uri."}
startTimestring google-datetime

Output only. Time when the BatchPredictionJob for the first time entered the JOB_STATE_RUNNING state.

endTimestring google-datetime

Output only. Time when the BatchPredictionJob entered any of the following states: JOB_STATE_SUCCEEDED, JOB_STATE_FAILED, JOB_STATE_CANCELLED.

Response

Successful response