Google Cloud Run · Schema

Google Cloud Run Service

Represents a Cloud Run service, which is a serverless application that runs stateless containers invocable via HTTP requests.

Cloud RunContainersGoogle CloudServerless

Properties

Name Type Description
name string The fully qualified name of the service in the format projects/{project}/locations/{location}/services/{service}.
description string User-provided description of the service.
uid string Output only. Server-assigned unique identifier for the service.
generation string Output only. A number that monotonically increases every time the user modifies the service.
labels object Unstructured key-value map for user-defined labels.
annotations object Unstructured key-value map for user-defined annotations.
createTime string Output only. The creation time.
updateTime string Output only. The last-modified time.
ingress string Provides the ingress settings for this service.
launchStage string The launch stage as defined by Google Cloud Platform Launch Stages.
template object The template used to create revisions for this service.
traffic array Specifies how to distribute traffic over a collection of revisions.
uri string Output only. The main URI where the service is serving traffic.
latestReadyRevision string Output only. Name of the latest revision that is serving traffic.
latestCreatedRevision string Output only. Name of the last created revision.
View JSON Schema on GitHub

JSON Schema

google-cloud-run-service-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/google-cloud-run/refs/heads/main/json-schema/google-cloud-run-service-schema.json",
  "title": "Google Cloud Run Service",
  "description": "Represents a Cloud Run service, which is a serverless application that runs stateless containers invocable via HTTP requests.",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "The fully qualified name of the service in the format projects/{project}/locations/{location}/services/{service}."
    },
    "description": {
      "type": "string",
      "description": "User-provided description of the service."
    },
    "uid": {
      "type": "string",
      "description": "Output only. Server-assigned unique identifier for the service."
    },
    "generation": {
      "type": "string",
      "description": "Output only. A number that monotonically increases every time the user modifies the service."
    },
    "labels": {
      "type": "object",
      "additionalProperties": { "type": "string" },
      "description": "Unstructured key-value map for user-defined labels."
    },
    "annotations": {
      "type": "object",
      "additionalProperties": { "type": "string" },
      "description": "Unstructured key-value map for user-defined annotations."
    },
    "createTime": {
      "type": "string",
      "format": "date-time",
      "description": "Output only. The creation time."
    },
    "updateTime": {
      "type": "string",
      "format": "date-time",
      "description": "Output only. The last-modified time."
    },
    "ingress": {
      "type": "string",
      "enum": [
        "INGRESS_TRAFFIC_UNSPECIFIED",
        "INGRESS_TRAFFIC_ALL",
        "INGRESS_TRAFFIC_INTERNAL_ONLY",
        "INGRESS_TRAFFIC_INTERNAL_LOAD_BALANCER"
      ],
      "description": "Provides the ingress settings for this service."
    },
    "launchStage": {
      "type": "string",
      "enum": ["LAUNCH_STAGE_UNSPECIFIED", "UNIMPLEMENTED", "PRELAUNCH", "EARLY_ACCESS", "ALPHA", "BETA", "GA", "DEPRECATED"],
      "description": "The launch stage as defined by Google Cloud Platform Launch Stages."
    },
    "template": {
      "type": "object",
      "description": "The template used to create revisions for this service.",
      "properties": {
        "revision": { "type": "string" },
        "scaling": {
          "type": "object",
          "properties": {
            "minInstanceCount": { "type": "integer" },
            "maxInstanceCount": { "type": "integer" }
          }
        },
        "timeout": { "type": "string" },
        "serviceAccount": { "type": "string" },
        "containers": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "name": { "type": "string" },
              "image": { "type": "string", "description": "Container image URI." },
              "command": { "type": "array", "items": { "type": "string" } },
              "args": { "type": "array", "items": { "type": "string" } },
              "env": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": { "type": "string" },
                    "value": { "type": "string" }
                  }
                }
              },
              "resources": {
                "type": "object",
                "properties": {
                  "limits": {
                    "type": "object",
                    "additionalProperties": { "type": "string" }
                  },
                  "cpuIdle": { "type": "boolean" },
                  "startupCpuBoost": { "type": "boolean" }
                }
              },
              "ports": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": { "type": "string" },
                    "containerPort": { "type": "integer" }
                  }
                }
              }
            },
            "required": ["image"]
          }
        },
        "maxInstanceRequestConcurrency": { "type": "integer" },
        "executionEnvironment": {
          "type": "string",
          "enum": ["EXECUTION_ENVIRONMENT_UNSPECIFIED", "EXECUTION_ENVIRONMENT_GEN1", "EXECUTION_ENVIRONMENT_GEN2"]
        }
      }
    },
    "traffic": {
      "type": "array",
      "description": "Specifies how to distribute traffic over a collection of revisions.",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": ["TRAFFIC_TARGET_ALLOCATION_TYPE_UNSPECIFIED", "TRAFFIC_TARGET_ALLOCATION_TYPE_LATEST", "TRAFFIC_TARGET_ALLOCATION_TYPE_REVISION"]
          },
          "revision": { "type": "string" },
          "percent": { "type": "integer" },
          "tag": { "type": "string" }
        }
      }
    },
    "uri": {
      "type": "string",
      "format": "uri",
      "description": "Output only. The main URI where the service is serving traffic."
    },
    "latestReadyRevision": {
      "type": "string",
      "description": "Output only. Name of the latest revision that is serving traffic."
    },
    "latestCreatedRevision": {
      "type": "string",
      "description": "Output only. Name of the last created revision."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/google-cloud-run-service"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.