gcloud beta ai-platform jobs submit prediction Stay organized with collections Save and categorize content based on your preferences.
- NAME
- gcloud beta ai-platform jobs submit prediction - start an AI Platform batch prediction job
- SYNOPSIS
gcloud beta ai-platform jobs submit predictionJOB--data-format=DATA_FORMAT--input-paths=INPUT_PATH,[INPUT_PATH,…]--output-path=OUTPUT_PATH--region=REGION(--model=MODEL|--model-dir=MODEL_DIR)[--batch-size=BATCH_SIZE][--labels=[KEY=VALUE,…]][--max-worker-count=MAX_WORKER_COUNT][--runtime-version=RUNTIME_VERSION][--signature-name=SIGNATURE_NAME][--version=VERSION][GCLOUD_WIDE_FLAG …]
- DESCRIPTION
(BETA)Start an AI Platform batch prediction job.- POSITIONAL ARGUMENTS
JOB- Name of the batch prediction job.
- REQUIRED FLAGS
--data-format=DATA_FORMAT- Data format of the input files.
DATA_FORMATmust be oneof:text- Text and JSON files; for text files, seehttps://www.tensorflow.org/guide/datasets#consuming_text_data, for JSON files,seehttps://cloud.google.com/ai-platform/prediction/docs/overview#batch_prediction_input_data
tf-record- TFRecord files; seehttps://www.tensorflow.org/guide/datasets#consuming_tfrecord_data
tf-record-gzip- GZIP-compressed TFRecord files.
--input-paths=INPUT_PATH,[INPUT_PATH,…]- Cloud Storage paths to the instances to run prediction on.
Wildcards (
*) accepted at theendof a path. More thanone path can be specified if multiple file patterns are needed. For example,gs://my-bucket/instances*,gs://my-bucket/other-instances1
will match any objects whose names start with
instancesinmy-bucketas well as theother-instances1bucket,whilegs://my-bucket/instance-dir/*
will match any objects in the
instance-dir"directory" (sincedirectories aren't a first-class Cloud Storage concept) ofmy-bucket. --output-path=OUTPUT_PATH- Cloud Storage path to which to save the output. Example: gs://my-bucket/output.
--region=REGION- The Compute Engine region to run the job in.
- Exactly one of these must be specified:
--model=MODEL- Name of the model to use for prediction.
--model-dir=MODEL_DIR- Cloud Storage location where the model files are located.
- OPTIONAL FLAGS
--batch-size=BATCH_SIZE- The number of records per batch. The service will buffer batch_size number ofrecords in memory before invoking TensorFlow. Defaults to 64 if not specified.
--labels=[KEY=VALUE,…]- List of label KEY=VALUE pairs to add.
Keys must start with a lowercase character and contain only hyphens(
-), underscores (_), lowercase characters, andnumbers. Values must contain only hyphens (-), underscores(_), lowercase characters, and numbers. --max-worker-count=MAX_WORKER_COUNT- The maximum number of workers to be used for parallel processing. Defaults to 10if not specified.
--runtime-version=RUNTIME_VERSION- AI Platform runtime version for this job. Must be specified unless--master-image-uri is specified instead. It is defined in documentation alongwith the list of supported versions:https://cloud.google.com/ai-platform/prediction/docs/runtime-version-list
--signature-name=SIGNATURE_NAME- Name of the signature defined in the SavedModel to use for this job. Defaults toDEFAULT_SERVING_SIGNATURE_DEF_KEY inhttps://www.tensorflow.org/api_docs/python/tf/compat/v1/saved_model/signature_constants,which is "serving_default". Only applies to TensorFlow models.
--version=VERSION- Model version to be used.
This flag may only be given if --model is specified. If unspecified, the defaultversion of the model will be used. To list versions for a model, run
gcloudai-platformversionslist
- GCLOUD WIDE FLAGS
- These flags are available to all commands:
--access-token-file,--account,--billing-project,--configuration,--flags-file,--flatten,--format,--help,--impersonate-service-account,--log-http,--project,--quiet,--trace-token,--user-output-enabled,--verbosity.Run
$gcloud helpfor details. - NOTES
- This command is currently in beta and might change without notice. Thesevariants are also available:
gcloudai-platformjobssubmitpredictiongcloudalphaai-platformjobssubmitprediction
Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-07-22 UTC.