Cloud Run Admin API (run:v2)

2026-01-22

6 new methods

Additions

    Methods
  • run.projects.locations.instances.create

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/instances

      HTTP Method : POST

      Description : Creates an Instance.

      Path : v2/{+parent}/instances

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Parameter Order : parent

      Parameters :

        parent

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Type : string

          Location : path

          Required : Yes

        instanceId

          Type : string

          Description : Required. The unique identifier for the Instance. It must begin with letter, and cannot end with hyphen; must contain fewer than 50 characters. The name of the instance becomes {parent}/instances/{instance_id}.

          Location : query

        validateOnly

          Description : Optional. Indicates that the request should be validated and default values populated, without persisting the request or creating any resources.

          Location : query

          Type : boolean

  • run.projects.locations.instances.start

      Parameters :

        name

          Pattern : ^projects/[^/]+/locations/[^/]+/instances/[^/]+$

          Description : Required. The name of the Instance to stop. Format: `projects/{project}/locations/{location}/instances/{instance}`, where `{project}` can be project id or number.

          Type : string

          Location : path

          Required : Yes

      HTTP Method : POST

      Path : v2/{+name}:start

      Parameter Order : name

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:start

      Description : Starts an Instance.

      Scopes : https://www.googleapis.com/auth/cloud-platform

  • run.projects.locations.instances.stop

      HTTP Method : POST

      Parameters :

        name

          Type : string

          Description : Required. The name of the Instance to stop. Format: `projects/{project}/locations/{location}/instances/{instance}`, where `{project}` can be project id or number.

          Pattern : ^projects/[^/]+/locations/[^/]+/instances/[^/]+$

          Location : path

          Required : Yes

      Description : Stops an Instance.

      Parameter Order : name

      Path : v2/{+name}:stop

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}:stop

      Scopes : https://www.googleapis.com/auth/cloud-platform

  • run.projects.locations.instances.delete

      HTTP Method : DELETE

      Description : Deletes a Instance

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Path : v2/{+name}

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}

      Parameter Order : name

      Parameters :

        validateOnly

          Location : query

          Type : boolean

          Description : Optional. Indicates that the request should be validated without actually deleting any resources.

        etag

          Location : query

          Type : string

          Description : Optional. A system-generated fingerprint for this version of the resource. May be used to detect modification conflict during updates.

        name

          Pattern : ^projects/[^/]+/locations/[^/]+/instances/[^/]+$

          Required : Yes

          Type : string

          Location : path

  • run.projects.locations.instances.list

      Description : Lists Instances. Results are sorted by creation time, descending.

      Parameter Order : parent

      Path : v2/{+parent}/instances

      HTTP Method : GET

      Parameters :

        pageSize

          Format : int32

          Type : integer

          Description : Optional. Maximum number of Instances to return in this call.

          Location : query

        pageToken

          Description : Optional. A page token received from a previous call to ListInstances. All other parameters must match.

          Location : query

          Type : string

        parent

          Location : path

          Pattern : ^projects/[^/]+/locations/[^/]+$

          Required : Yes

          Description : Required. The location and project to list resources on. Format: projects/{project}/locations/{location}, where {project} can be project id or number.

          Type : string

        showDeleted

          Location : query

          Description : Optional. If true, returns deleted (but unexpired) resources along with active ones.

          Type : boolean

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/instances

  • run.projects.locations.instances.get

      Description : Gets a Instance

      Parameters :

        name

          Location : path

          Required : Yes

          Pattern : ^projects/[^/]+/locations/[^/]+/instances/[^/]+$

          Type : string

      Parameter Order : name

      Path : v2/{+name}

      Scopes : https://www.googleapis.com/auth/cloud-platform

      Flat Path : v2/projects/{projectsId}/locations/{locationsId}/instances/{instancesId}

      HTTP Method : GET