Stay organized with collections
Save and categorize content based on your preferences.
The Workflows connector defines the built-in
functions that can be used to access other Google Cloud products within a
workflow.
This page provides an overview of the individual connector.
There is no need to import or load connector libraries in a workflow—connectors
work out of the box when used in a call step.
Cloud Run Admin API
Deploy and manage user provided container images that scale automatically based on incoming requests. The Cloud Run Admin API v1 follows the Knative Serving API specification, while v2 is aligned with Google Cloud AIP-based API standards, as described in https://google.aip.dev/.
To learn more, see the Cloud Run Admin API documentation.
For the YAML representation of the
Service and
Job objects
in the Cloud Run Admin API, see the
Cloud Run YAML reference. Note that the YAML maps
exactly to the API, and you can modify the YAML specifications to configure your
Cloud Run service.
Authentication
All Cloud Run services are deployed privately by default, which means that they
can't be accessed without providing authentication credentials in the request.
Learn more about invoking Cloud Run and
sending authenticated requests.
Replace a job. Only the spec and metadata labels and annotations are
modifiable. After the Replace request, Cloud Run will work to make the
'status' match the requested 'spec'. May provide
metadata.resourceVersion to enforce update from last read for optimistic
concurrency control.
Replaces a service. Only the spec and metadata labels and annotations
are modifiable. After the Update request, Cloud Run will work to make
the 'status' match the requested 'spec'. May provide
metadata.resourceVersion to enforce update from last read for optimistic
concurrency control.
Deletes a long-running operation. This method indicates that the client
is no longer interested in the operation result. It does not cancel the
operation. If the server doesn't support this method, it returns
google.rpc.Code.UNIMPLEMENTED.
Gets the latest state of a long-running operation. Clients can use this
method to poll the operation result at intervals as recommended by the
API service.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Cloud Run Admin API Connector Overview\n\nThe Workflows connector defines the built-in\nfunctions that can be used to access other Google Cloud products within a\nworkflow.\n\nThis page provides an overview of the individual connector.\nThere is no need to import or load connector libraries in a workflow---connectors\nwork out of the box when used in a call step.\n\nCloud Run Admin API\n-------------------\n\nDeploy and manage user provided container images that scale automatically based on incoming requests. The Cloud Run Admin API v1 follows the Knative Serving API specification, while v2 is aligned with Google Cloud AIP-based API standards, as described in https://google.aip.dev/.\nTo learn more, see the [Cloud Run Admin API documentation](https://cloud.google.com/run/).\n\nFor the YAML representation of the\n[Service](/workflows/docs/reference/googleapis/run/v1/Overview#service) and\n[Job](/workflows/docs/reference/googleapis/run/v1/Overview#job) objects\nin the Cloud Run Admin API, see the\n[Cloud Run YAML reference](/run/docs/reference/yaml/v1). Note that the YAML maps\nexactly to the API, and you can modify the YAML specifications to configure your\nCloud Run service.\n\nAuthentication\n--------------\n\nAll Cloud Run services are deployed privately by default, which means that they\ncan't be accessed without providing authentication credentials in the request.\nLearn more about [invoking Cloud Run](/workflows/docs/calling-run-functions) and\nsending authenticated requests.\n\nContainer image\n---------------\n\nLearn how to [build a container image](/run/docs/building/containers)\nlike the one used in the following sample.\n\nCloud Run Admin connector sample\n--------------------------------\n\n### YAML\n\n # This workflow demonstrates how to use the Cloud Run connector:\n # Create a new service and then delete it\n # A location must be specified\n # Expected output is the `delete_service` response with a \"Success\" status\n - init:\n assign:\n - service_name: \"test-service\"\n - project: ${sys.get_env(\"GOOGLE_CLOUD_PROJECT_ID\")}\n - create_service:\n call: googleapis.run.v1.namespaces.services.create\n args:\n location: \"us-central1\"\n parent: ${\"namespaces/\" + project}\n body:\n apiVersion: \"serving.knative.dev/v1\"\n kind: \"Service\"\n metadata:\n name: ${service_name}\n namespace: ${project}\n spec:\n traffic:\n latest_revision: true\n percent: 100\n template:\n metadata:\n labels:\n serving.knative.dev/type: \"container\"\n spec:\n containers:\n - image: \"us-docker.pkg.dev/cloudrun/container/hello:latest\"\n result: create_response\n - get_service:\n call: googleapis.run.v1.namespaces.services.get\n args:\n name: ${\"namespaces/\" + project + \"/services/\" + service_name}\n location: \"us-central1\"\n result: get_response\n - delete_service:\n call: googleapis.run.v1.namespaces.services.delete\n args:\n location: \"us-central1\"\n name: ${\"namespaces/\" + project + \"/services/\" + service_name}\n result: delete_response\n - return:\n return: ${delete_response}\n\n### JSON\n\n [\n {\n \"init\": {\n \"assign\": [\n {\n \"service_name\": \"test-service\"\n },\n {\n \"project\": \"your-project-id\"\n }\n ]\n }\n },\n {\n \"create_service\": {\n \"call\": \"googleapis.run.v1.namespaces.services.create\",\n \"args\": {\n \"location\": \"us-central1\",\n \"parent\": \"${\\\"namespaces/\\\" + project}\",\n \"body\": {\n \"apiVersion\": \"serving.knative.dev/v1\",\n \"kind\": \"Service\",\n \"metadata\": {\n \"name\": \"${service_name}\",\n \"namespace\": \"${project}\"\n },\n \"spec\": {\n \"traffic\": {\n \"latest_revision\": true,\n \"percent\": 100\n },\n \"template\": {\n \"metadata\": {\n \"labels\": {\n \"serving.knative.dev/type\": \"container\"\n }\n },\n \"spec\": {\n \"containers\": [\n {\n \"image\": \"us-docker.pkg.dev/cloudrun/container/hello:latest\"\n }\n ]\n }\n }\n }\n }\n },\n \"result\": \"create_rsp\"\n }\n },\n {\n \"get_service\": {\n \"call\": \"googleapis.run.v1.namespaces.services.get\",\n \"args\": {\n \"name\": \"${\\\"namespaces/\\\" + project + \\\"/services/\\\" + service_name}\",\n \"location\": \"us-central1\"\n },\n \"result\": \"get_resp\"\n }\n },\n {\n \"delete_service\": {\n \"call\": \"googleapis.run.v1.namespaces.services.delete\",\n \"args\": {\n \"location\": \"us-central1\",\n \"name\": \"${\\\"namespaces/\\\" + project + \\\"/services/\\\" + service_name}\"\n },\n \"result\": \"delete_rsp\"\n }\n },\n {\n \"return\": {\n \"return\": \"${delete_rsp}\"\n }\n }\n ]\n\nModule: googleapis.run.v1.namespaces.authorizeddomains\n------------------------------------------------------\n\nModule: googleapis.run.v1.namespaces.configurations\n---------------------------------------------------\n\nModule: googleapis.run.v1.namespaces.domainmappings\n---------------------------------------------------\n\nModule: googleapis.run.v1.namespaces.executions\n-----------------------------------------------\n\nModule: googleapis.run.v1.namespaces.jobs\n-----------------------------------------\n\nModule: googleapis.run.v1.namespaces.revisions\n----------------------------------------------\n\nModule: googleapis.run.v1.namespaces.routes\n-------------------------------------------\n\nModule: googleapis.run.v1.namespaces.services\n---------------------------------------------\n\nModule: googleapis.run.v1.namespaces.tasks\n------------------------------------------\n\nModule: googleapis.run.v1.projects.locations\n--------------------------------------------\n\nModule: googleapis.run.v1.projects.locations.jobs\n-------------------------------------------------\n\nModule: googleapis.run.v1.projects.locations.services\n-----------------------------------------------------\n\nModule: googleapis.run.v2.projects.locations.jobs\n-------------------------------------------------\n\nModule: googleapis.run.v2.projects.locations.jobs.executions\n------------------------------------------------------------\n\nModule: googleapis.run.v2.projects.locations.jobs.executions.tasks\n------------------------------------------------------------------\n\nModule: googleapis.run.v2.projects.locations.operations\n-------------------------------------------------------\n\nModule: googleapis.run.v2.projects.locations.services\n-----------------------------------------------------\n\nModule: googleapis.run.v2.projects.locations.services.revisions\n---------------------------------------------------------------"]]