Skip to main content

custom_jobs

Overview

Namecustom_jobs
TypeResource
Idgoogle.aiplatform.custom_jobs

Fields

NameDatatypeDescription
namestringOutput only. Resource name of a CustomJob.
createTimestringOutput only. Time when the CustomJob was created.
displayNamestringRequired. The display name of the CustomJob. The name can be up to 128 characters long and can consist of any UTF-8 characters.
encryptionSpecobjectRepresents a customer-managed encryption key spec that can be applied to a top-level resource.
endTimestringOutput only. Time when the CustomJob entered any of the following states: JOB_STATE_SUCCEEDED, JOB_STATE_FAILED, JOB_STATE_CANCELLED.
errorobjectThe Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.
jobSpecobjectRepresents the spec of a CustomJob.
labelsobjectThe labels with user-defined metadata to organize CustomJobs. 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.
startTimestringOutput only. Time when the CustomJob for the first time entered the JOB_STATE_RUNNING state.
statestringOutput only. The detailed state of the job.
updateTimestringOutput only. Time when the CustomJob was most recently updated.
webAccessUrisobjectOutput only. URIs for accessing interactive shells (one URI for each training node). Only available if job_spec.enable_web_access is true. The keys are names of each node in the training job; for example, workerpool0-0 for the primary node, workerpool1-0 for the first node in the second worker pool, and workerpool1-1 for the second node in the second worker pool. The values are the URIs for each node's interactive shell.

Methods

NameAccessible byRequired ParamsDescription
getSELECTcustomJobsId, locationsId, projectsIdGets a CustomJob.
listSELECTlocationsId, projectsIdLists CustomJobs in a Location.
createINSERTlocationsId, projectsIdCreates a CustomJob. A created CustomJob right away will be attempted to be run.
deleteDELETEcustomJobsId, locationsId, projectsIdDeletes a CustomJob.
_listEXEClocationsId, projectsIdLists CustomJobs in a Location.
cancelEXECcustomJobsId, locationsId, projectsIdCancels a CustomJob. Starts asynchronous cancellation on the CustomJob. The server makes a best effort to cancel the job, but success is not guaranteed. Clients can use JobService.GetCustomJob or other methods to check whether the cancellation succeeded or whether the job completed despite cancellation. On successful cancellation, the CustomJob is not deleted; instead it becomes a job with a CustomJob.error value with a google.rpc.Status.code of 1, corresponding to Code.CANCELLED, and CustomJob.state is set to CANCELLED.