projects

Changed on

Submits a build in a given project.

post/v2/{+parent}/builds:submit

Request

  • Base URL: https://run.googleapis.com
  • URL: https://run.googleapis.com/v2/{+parent}/builds:submit
  • Auth: one of:
    • 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)
    • OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/run) 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/run)

Path parameters

parentstring required

Required. The project and location to build in. Location must be a region, e.g., 'us-central1' or 'global' if the global builder is to be used. Format: projects/{project}/locations/{location}

Request body

clientstring

Optional. The client that initiated the build request.

dockerBuildGoogleCloudRunV2DockerBuild

Build the source using Docker. This means the source has a Dockerfile.

imageUristring

Required. Artifact Registry URI to store the built image.

machineTypestring

Optional. The machine type from default pool to use for the build. If left blank, cloudbuild will use a sensible default. Currently only E2_HIGHCPU_8 is supported. If worker_pool is set, this field will be ignored.

releaseTrack'LAUNCH_STAGE_UNSPECIFIED' | 'UNIMPLEMENTED' | 'PRELAUNCH' | 'EARLY_ACCESS' | 'ALPHA' | 'BETA' | 'GA' | 'DEPRECATED'

Optional. The release track of the client that initiated the build request.

serviceAccountstring

Optional. The service account to use for the build. If not set, the default Cloud Build service account for the project will be used.

tagsstring[]

Optional. Additional tags to annotate the build.

workerPoolstring

Optional. Name of the Cloud Build Custom Worker Pool that should be used to build the function. The format of this field is projects/{project}/locations/{region}/workerPools/{workerPool} where {project} and {region} are the project id and region respectively where the worker pool is defined and {workerPool} is the short name of the worker pool.

Response

Successful response

Changes

  • 1a01967de4feRevision changes
    • breaking

      removed the request body

    • breaking

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

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/run was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/run was removed from the endpoint's security scheme Oauth2c

  • c9c90e09a8d6Revision changes
    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/cloud-platform was added to the endpoint's security scheme Oauth2c

    • info

      the security scope https://www.googleapis.com/auth/run was removed from the endpoint's security scheme Oauth2

    • info

      the security scope https://www.googleapis.com/auth/run was removed from the endpoint's security scheme Oauth2c