Provides read access to your GKE and Kubernetes resources.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Applies a Kubernetes manifest to a cluster using server-side apply. This is similar to running `kubectl apply --server-side`.
Required. The cluster to apply the manifest to. Format: projects/{project}/locations/{location}/clusters/{cluster}
Required. The YAML manifest to apply.
Optional. If true, run in dry-run mode.
Optional. If true, force conflicts resolution when applying.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Applies a Kubernetes manifest to a cluster using server-side apply. This is similar to running `kubectl apply --server-side`.
| Argument | Type | Description |
|---|---|---|
| dryRun | boolean | Optional. If true, run in dry-run mode. |
| parent* | string | Required. The cluster to apply the manifest to. Format: projects/{project}/locations/{location}/clusters/{cluster} |
| yamlManifest* | string | Required. The YAML manifest to apply. |
| forceConflicts | boolean | Optional. If true, force conflicts resolution when applying. |
{
"type": "object",
"required": [
"parent",
"yamlManifest"
],
"properties": {
"dryRun": {
"type": "boolean",
"description": "Optional. If true, run in dry-run mode."
},
"parent": {
"type": "string",
"description": "Required. The cluster to apply the manifest to. Format: projects/{project}/locations/{location}/clusters/{cluster}"
},
"yamlManifest": {
"type": "string",
"description": "Required. The YAML manifest to apply."
},
"forceConflicts": {
"type": "boolean",
"description": "Optional. If true, force conflicts resolution when applying."
}
},
"description": "KubeApplyRequest is the request message for applying Kubernetes manifests."
}Cancels a specific GKE operation.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name (project, location, operation id) of the operation to cancel. Specified in the format `projects/*/locations/*/operations/*`. |
| parent* | string | Required. The parent cluster of the operation. Specified in the format `projects/*/locations/*/clusters/*`. |
{
"type": "object",
"required": [
"name",
"parent"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name (project, location, operation id) of the operation to cancel. Specified in the format `projects/*/locations/*/operations/*`."
},
"parent": {
"type": "string",
"description": "Required. The parent cluster of the operation. Specified in the format `projects/*/locations/*/clusters/*`."
}
},
"description": "MCPCancelOperationRequest cancels an operation."
}Checks whether an action is allowed on a Kubernetes resource. This is similar to running `kubectl auth can-i`.
| Argument | Type | Description |
|---|---|---|
| verb* | string | Required. The verb to check. e.g. "get", "list", "watch", "create", "update", "patch", "delete". |
| parent* | string | Required. The cluster to check authorization against. Format: projects/{project}/locations/{location}/clusters/{cluster} |
| resource | string | Optional. The name of the resource to check. |
| namespace | string | Optional. The namespace of the resource. If not specified, "default" is used for namespace-scoped resources. |
| resourceType* | string | Required. The type of resource to check. e.g. "pods", "deployments", "services". |
{
"type": "object",
"required": [
"parent",
"verb",
"resourceType"
],
"properties": {
"verb": {
"type": "string",
"description": "Required. The verb to check. e.g. \"get\", \"list\", \"watch\", \"create\", \"update\", \"patch\", \"delete\"."
},
"parent": {
"type": "string",
"description": "Required. The cluster to check authorization against. Format: projects/{project}/locations/{location}/clusters/{cluster}"
},
"resource": {
"type": "string",
"description": "Optional. The name of the resource to check."
},
"namespace": {
"type": "string",
"description": "Optional. The namespace of the resource. If not specified, \"default\" is used for namespace-scoped resources."
},
"resourceType": {
"type": "string",
"description": "Required. The type of resource to check. e.g. \"pods\", \"deployments\", \"services\"."
}
},
"description": "Request for checking authorization for a Kubernetes resource."
}Creates a new GKE cluster in a given project and location. It's recommended to read the [GKE documentation](https://docs.cloud.google.com/kubernetes-engine/docs/concepts/configuration-overview) to understand cluster configuration options. Cluster creation will default to Autopilot mode, as recommended by GKE best practices. If the user explicitly wants to create a Standard cluster, you need to set autopilot.enabled=false in the cluster configuration. This is similar to running `gcloud container clusters create-auto` or `gcloud container clusters create`.
| Argument | Type | Description |
|---|---|---|
| parent* | string | Required. The parent (project and location) where the cluster will be created. Specified in the format `projects/*/locations/*`. |
| cluster* | string | Required. A [cluster resource](https://cloud.google.com/container-engine/reference/rest/v1/projects.locations.clusters) represented as a string using JSON format. |
{
"type": "object",
"required": [
"parent",
"cluster"
],
"properties": {
"parent": {
"type": "string",
"description": "Required. The parent (project and location) where the cluster will be created. Specified in the format `projects/*/locations/*`."
},
"cluster": {
"type": "string",
"description": "Required. A [cluster resource](https://cloud.google.com/container-engine/reference/rest/v1/projects.locations.clusters) represented as a string using JSON format."
}
},
"description": "MCPCreateClusterRequest creates a new cluster."
}Creates a node pool for a specific GKE cluster.
| Argument | Type | Description |
|---|---|---|
| parent* | string | Required. The parent (project, location, cluster name) where the node pool will be created. Specified in the format `projects/*/locations/*/clusters/*`. |
| nodePool* | string | Required. The node pool to create represented as a string using JSON format. The full node pool object can be found at https://docs.cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters.nodePools |
{
"type": "object",
"required": [
"parent",
"nodePool"
],
"properties": {
"parent": {
"type": "string",
"description": "Required. The parent (project, location, cluster name) where the node pool will be created. Specified in the format `projects/*/locations/*/clusters/*`."
},
"nodePool": {
"type": "string",
"description": "Required. The node pool to create represented as a string using JSON format. The full node pool object can be found at https://docs.cloud.google.com/kubernetes-engine/docs/reference/rest/v1/projects.locations.clusters.nodePools"
}
},
"description": "MCPCreateNodePoolRequest creates a node pool for a cluster."
}Deletes a Kubernetes resource from a cluster. This is similar to running `kubectl delete`.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name of the resource to delete. |
| dryRun | boolean | Optional. If true, run in dry-run mode. |
| parent* | string | Required. The cluster, which owns this collection of resources. Format: projects/{project}/locations/{location}/clusters/{cluster} |
| cascade | string | Optional. The cascading deletion policy to use. If not specified, 'background' is used. Valid values are 'background', 'foreground', and 'orphan'. |
| namespace | string | Optional. The namespace of the resource. If not specified, "default" is used. |
| resourceType* | string | Required. The type of resource to delete. Kubernetes resource/kind name in singular form, lower case. e.g. "pod", "deployment", "service". |
{
"type": "object",
"required": [
"parent",
"resourceType",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name of the resource to delete."
},
"dryRun": {
"type": "boolean",
"description": "Optional. If true, run in dry-run mode."
},
"parent": {
"type": "string",
"description": "Required. The cluster, which owns this collection of resources. Format: projects/{project}/locations/{location}/clusters/{cluster}"
},
"cascade": {
"type": "string",
"description": "Optional. The cascading deletion policy to use. If not specified, 'background' is used. Valid values are 'background', 'foreground', and 'orphan'."
},
"namespace": {
"type": "string",
"description": "Optional. The namespace of the resource. If not specified, \"default\" is used."
},
"resourceType": {
"type": "string",
"description": "Required. The type of resource to delete. Kubernetes resource/kind name in singular form, lower case. e.g. \"pod\", \"deployment\", \"service\"."
}
},
"description": "Request for deleting Kubernetes resources."
}Shows the details of a specific Kubernetes resource. This is similar to running `kubectl describe`.
| Argument | Type | Description |
|---|---|---|
| name | string | Optional. The name of the resource. |
| parent* | string | Required. The parent cluster. |
| namespace | string | Optional. The namespace of the resource. |
| resourceType* | string | Required. The type of the resource. |
| labelSelector | string | Optional. A label selector to filter resources. |
{
"type": "object",
"required": [
"parent",
"resourceType"
],
"properties": {
"name": {
"type": "string",
"description": "Optional. The name of the resource."
},
"parent": {
"type": "string",
"description": "Required. The parent cluster."
},
"namespace": {
"type": "string",
"description": "Optional. The namespace of the resource."
},
"resourceType": {
"type": "string",
"description": "Required. The type of the resource."
},
"labelSelector": {
"type": "string",
"description": "Optional. A label selector to filter resources."
}
},
"description": "Request message for KubeDescribe."
}Gets the details of a specific GKE cluster.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name (project, location, cluster) of the cluster to retrieve. Specified in the format `projects/*/locations/*/clusters/*`. |
| readMask | string | Optional. The field mask to specify the fields to be returned in the response. Use a single "*" to get all fields. Default: autopilot,createTime,currentMasterVersion,currentNodeCount,currentNodeVersion,description,endpoint,fleet,location,name,network,nodePools.locations,nodePools.name,nodePools.status,nodePools.version,releaseChannel,resourceLabels,selfLink,status,statusMessage,subnetwork. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name (project, location, cluster) of the cluster to retrieve. Specified in the format `projects/*/locations/*/clusters/*`."
},
"readMask": {
"type": "string",
"format": "google-fieldmask",
"pattern": "^(\\s*[^,\\s.]+(\\s*[,.]\\s*[^,\\s.]+)*)?$",
"description": "Optional. The field mask to specify the fields to be returned in the response. Use a single \"*\" to get all fields. Default: autopilot,createTime,currentMasterVersion,currentNodeCount,currentNodeVersion,description,endpoint,fleet,location,name,network,nodePools.locations,nodePools.name,nodePools.status,nodePools.version,releaseChannel,resourceLabels,selfLink,status,statusMessage,subnetwork."
}
},
"description": "MCPGetClusterRequest gets the settings of a cluster."
}Gets cluster endpoint information. This is similar to running `kubectl cluster-info`.
| Argument | Type | Description |
|---|---|---|
| parent* | string | Required. The parent cluster. Format: projects/{project}/locations/{location}/clusters/{cluster} |
{
"type": "object",
"required": [
"parent"
],
"properties": {
"parent": {
"type": "string",
"description": "Required. The parent cluster. Format: projects/{project}/locations/{location}/clusters/{cluster}"
}
},
"description": "Request message for KubeClusterInfo."
}Gets logs from a Kubernetes container in a pod. This is similar to running `kubectl logs`.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name of the resource to retrieve logs from. This can be a pod name (e.g. "my-pod") or a type/name (e.g. "deployment/my-deployment"). If a type is not specified, "pod" is assumed. |
| tail | string | Optional. The number of lines from the end of the logs to show. |
| since | string | Optional. Retrieve logs since this duration ago (e.g. "1h", "10m"). |
| parent* | string | Required. The cluster to retrieve logs from. Format: projects/{project}/locations/{location}/clusters/{cluster} |
| previous | boolean | Optional. If true, retrieve logs from the previous instantiation of the container. |
| container | string | Optional. The name of the container to retrieve logs from. If not specified, logs from the first container are returned. |
| namespace | string | Optional. The namespace of the resource. If not specified, "default" is used. |
Gets one or more Kubernetes resources from a cluster. Resources can be filtered by type, name, namespace, and label selectors. Returns the resources in YAML format. This is similar to running `kubectl get`.
| Argument | Type | Description |
|---|---|---|
| name | string | Optional. The name of the resource to retrieve. If not specified, all resources of the given type are returned. |
| parent* | string | Required. The cluster, which owns this collection of resources. Format: projects/{project}/locations/{location}/clusters/{cluster} |
| pageSize | integer | Optional. The maximum number of resources to return. If not specified, 500 is used. The maximum value is 1000; values above 1000 will be coerced to 1000. |
| namespace | string | Optional. The namespace of the resource. If not specified, all namespaces are searched. |
| pageToken | string | Optional. A page token, received from a previous `GetK8SResource` call. Provide this to retrieve the subsequent page of resources when listing resources. Cannot be used when `name` is specified. |
| outputFormat | string | Optional. The output format. One of: (table, wide, yaml, json). If not specified, defaults to table. When both custom_columns and output_format are specified, output_format is ignored. |
Checks the current rollout status of a Kubernetes resource. This is similar to running `kubectl rollout status`.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name of the resource to check. |
| parent* | string | Required. The cluster to check rollout status in. Format: projects/{project}/locations/{location}/clusters/{cluster} |
| namespace | string | Optional. The namespace of the resource. If not specified, "default" is used for namespace-scoped resources. |
| resourceType* | string | Required. The type of resource to check. e.g. "deployment", "daemonset", "statefulset". |
{
"type": "object",
"required": [
"parent",
"resourceType",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name of the resource to check."
},
"parent": {
"type": "string",
"description": "Required. The cluster to check rollout status in. Format: projects/{project}/locations/{location}/clusters/{cluster}"
},
"namespace": {
"type": "string",
"description": "Optional. The namespace of the resource. If not specified, \"default\" is used for namespace-scoped resources."
},
"resourceType": {
"type": "string",
"description": "Required. The type of resource to check. e.g. \"deployment\", \"daemonset\", \"statefulset\"."
}
},
"description": "Request for checking rollout status of a Kubernetes resource."
}Retrieves Kubernetes client and server versions for a given cluster. This is similar to running `kubectl version`.
| Argument | Type | Description |
|---|---|---|
| parent* | string | Required. The cluster to get version information from, in the format `projects/*/locations/*/clusters/*`. |
{
"type": "object",
"required": [
"parent"
],
"properties": {
"parent": {
"type": "string",
"description": "Required. The cluster to get version information from, in the format `projects/*/locations/*/clusters/*`."
}
},
"description": "KubeVersionRequest is the request message for retrieving Kubernetes server versions."
}Gets the details of a specific node pool within a GKE cluster.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name (project, location, cluster, node pool id) of the node pool to get. Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name (project, location, cluster, node pool id) of the node pool to get. Specified in the format `projects/*/locations/*/clusters/*/nodePools/*`."
}
},
"description": "MCPGetNodePoolRequest retrieves a node pool for a cluster."
}Gets the details of a specific GKE operation.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name (project, location, operation id) of the operation to get. Specified in the format `projects/*/locations/*/operations/*`. |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name (project, location, operation id) of the operation to get. Specified in the format `projects/*/locations/*/operations/*`."
}
},
"description": "MCPGetOperationRequest gets a single operation."
}Lists GKE clusters in a given project and location. Location can be a region, zone, or '-' for all locations.
| Argument | Type | Description |
|---|---|---|
| parent* | string | Required. The parent (project and location) where the clusters will be listed. Specified in the format `projects/*/locations/*`. Location "-" matches all zones and all regions. |
| readMask | string | Optional. The field mask to specify the fields to be returned in the response. Use a single "*" to get all fields. Default: clusters.autopilot,clusters.createTime,clusters.currentMasterVersion,clusters.currentNodeCount,clusters.currentNodeVersion,clusters.description,clusters.endpoint,clusters.fleet,clusters.location,clusters.name,clusters.network,clusters.nodePools.name,clusters.releaseChannel,clusters.resourceLabels,clusters.selfLink,clusters.status,clusters.statusMessage,clusters.subnetwork,missingZones. |
{
"type": "object",
"required": [
"parent"
],
"properties": {
"parent": {
"type": "string",
"description": "Required. The parent (project and location) where the clusters will be listed. Specified in the format `projects/*/locations/*`. Location \"-\" matches all zones and all regions."
},
"readMask": {
"type": "string",
"format": "google-fieldmask",
"pattern": "^(\\s*[^,\\s.]+(\\s*[,.]\\s*[^,\\s.]+)*)?$",
"description": "Optional. The field mask to specify the fields to be returned in the response. Use a single \"*\" to get all fields. Default: clusters.autopilot,clusters.createTime,clusters.currentMasterVersion,clusters.currentNodeCount,clusters.currentNodeVersion,clusters.description,clusters.endpoint,clusters.fleet,clusters.location,clusters.name,clusters.network,clusters.nodePools.name,clusters.releaseChannel,clusters.resourceLabels,clusters.selfLink,clusters.status,clusters.statusMessage,clusters.subnetwork,missingZones."
}
},
"description": "MCPListClustersRequest lists clusters."
}Retrieves the available API groups and resources from a Kubernetes cluster. This is similar to running `kubectl api-resources`.
| Argument | Type | Description |
|---|---|---|
| parent* | string | Required. The cluster, which owns this collection of resource types. Format: projects/{project}/locations/{location}/clusters/{cluster} |
{
"type": "object",
"required": [
"parent"
],
"properties": {
"parent": {
"type": "string",
"description": "Required. The cluster, which owns this collection of resource types. Format: projects/{project}/locations/{location}/clusters/{cluster}"
}
},
"description": "Request for retrieving Kubernetes API resources."
}Retrieves events from a Kubernetes cluster. This is similar to running `kubectl events`.
| Argument | Type | Description |
|---|---|---|
| name | string | Optional. The name of the resource to retrieve events for. |
| limit | string | Optional. The maximum number of events to return. If not specified, 500 is used. |
| parent* | string | Required. The parent cluster. Format: projects/{project}/locations/{location}/clusters/{cluster} |
| namespace | string | Optional. The namespace of the resource. If not specified and all_namespaces is false, "default" is used. |
| resourceType | string | Optional. The type of the resource to retrieve events for. |
| allNamespaces | boolean | Optional. If true, retrieve events from all namespaces. |
{
"type": "object",
"required": [
"parent"
],
"properties": {
"name": {
"type": "string",
"description": "Optional. The name of the resource to retrieve events for."
},
"limit": {
"type": "string",
"format": "int64",
"description": "Optional. The maximum number of events to return. If not specified, 500 is used."
},
"parent": {
"type": "string",
"description": "Required. The parent cluster. Format: projects/{project}/locations/{location}/clusters/{cluster}"
},
"namespace": {
"type": "string",
"description": "Optional. The namespace of the resource. If not specified and all_namespaces is false, \"default\" is used."
},
"resourceType": {
"type": "string",
"description": "Optional. The type of the resource to retrieve events for."
},
"allNamespaces": {
"type": "boolean",
"description": "Optional. If true, retrieve events from all namespaces."
}
},
"description": "Request message for KubeEvents."
}Lists the node pools for a specific GKE cluster.
| Argument | Type | Description |
|---|---|---|
| parent* | string | Required. The parent (project, location, cluster name) where the node pools will be listed. Specified in the format `projects/*/locations/*/clusters/*`. |
{
"type": "object",
"required": [
"parent"
],
"properties": {
"parent": {
"type": "string",
"description": "Required. The parent (project, location, cluster name) where the node pools will be listed. Specified in the format `projects/*/locations/*/clusters/*`."
}
},
"description": "MCPListNodePoolsRequest lists the node pool(s) for a cluster."
}Lists GKE operations in a given project and location. Location can be a region, zone, or '-' for all locations.
| Argument | Type | Description |
|---|---|---|
| parent* | string | Required. The parent (project and location) where the operations will be listed. Specified in the format `projects/*/locations/*`. Location "-" matches all zones and all regions. |
{
"type": "object",
"required": [
"parent"
],
"properties": {
"parent": {
"type": "string",
"description": "Required. The parent (project and location) where the operations will be listed. Specified in the format `projects/*/locations/*`. Location \"-\" matches all zones and all regions."
}
},
"description": "MCPListOperationsRequest lists operations."
}Patches a Kubernetes resource. This is similar to running `kubectl patch`.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name of the resource to patch. |
| patch* | string | Required. The patch to apply in JSON format. |
| parent* | string | Required. The cluster to patch the resource in. Format: projects/{project}/locations/{location}/clusters/{cluster} |
| namespace | string | Optional. The namespace of the resource. If not specified, "default" is used. |
| patchType | string | Optional. The patch strategy to apply. Valid values are "strategic", "merge", or "json". If not specified, "strategic" patch type will be used. |
| resourceType* | string | Required. The type of resource to patch. e.g. "pods", "deployments", "services". |
{
"type": "object",
"required": [
"parent",
"resourceType",
"name",
"patch"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name of the resource to patch."
},
"patch": {
"type": "string",
"description": "Required. The patch to apply in JSON format."
},
"parent": {
"type": "string",
"description": "Required. The cluster to patch the resource in. Format: projects/{project}/locations/{location}/clusters/{cluster}"
},
"namespace": {
"type": "string",
"description": "Optional. The namespace of the resource. If not specified, \"default\" is used."
},
"patchType": {
"type": "string",
"description": "Optional. The patch strategy to apply. Valid values are \"strategic\", \"merge\", or \"json\". If not specified, \"strategic\" patch type will be used."
},
"resourceType": {
"type": "string",
"description": "Required. The type of resource to patch. e.g. \"pods\", \"deployments\", \"services\"."
}
},
"description": "Request for patching a Kubernetes resource."
}Updates a specific GKE cluster.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name (project, location, cluster) of the cluster to update. Specified in the format `projects/*/locations/*/clusters/*`. |
| update* | string | Required. A description of the update represented as a string using JSON format. The full update request object can be found at https://cloud.google.com/container-engine/reference/rest/v1/projects.locations.clusters/update https://docs.cloud.google.com/kubernetes-engine/docs/reference/rest/v1/ClusterUpdate |
{
"type": "object",
"required": [
"name",
"update"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name (project, location, cluster) of the cluster to update. Specified in the format `projects/*/locations/*/clusters/*`."
},
"update": {
"type": "string",
"description": "Required. A description of the update represented as a string using JSON format. The full update request object can be found at https://cloud.google.com/container-engine/reference/rest/v1/projects.locations.clusters/update https://docs.cloud.google.com/kubernetes-engine/docs/reference/rest/v1/ClusterUpdate"
}
},
"description": "MCPUpdateClusterRequest updates a cluster."
}Updates a specific node pool within a GKE cluster.
| Argument | Type | Description |
|---|---|---|
| name* | string | Required. The name (project, location, cluster, node pool) of the node pool to update. Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'. |
| update* | string | Required. A [node pool update request](https://cloud.google.com/container-engine/reference/rest/v1/projects.locations.clusters.nodePools/update) represented as a string using JSON format. |
{
"type": "object",
"required": [
"name",
"update"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name (project, location, cluster, node pool) of the node pool to update. Specified in the format 'projects/*/locations/*/clusters/*/nodePools/*'."
},
"update": {
"type": "string",
"description": "Required. A [node pool update request](https://cloud.google.com/container-engine/reference/rest/v1/projects.locations.clusters.nodePools/update) represented as a string using JSON format."
}
},
"description": "MCPUpdateNodePoolRequest updates a node pool for a cluster."
}| sinceTime |
| string |
| Optional. Retrieve logs since this time (RFC3339). e.g. "2024-08-30T06:00:00Z". |
| timestamps | boolean | Optional. If true, include timestamps in the log output. |
| allContainers | boolean | Optional. If true, retrieve logs from all containers in the pod. |
{
"type": "object",
"required": [
"parent",
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Required. The name of the resource to retrieve logs from. This can be a pod name (e.g. \"my-pod\") or a type/name (e.g. \"deployment/my-deployment\"). If a type is not specified, \"pod\" is assumed."
},
"tail": {
"type": "string",
"format": "int64",
"description": "Optional. The number of lines from the end of the logs to show."
},
"since": {
"type": "string",
"format": "google-duration",
"description": "Optional. Retrieve logs since this duration ago (e.g. \"1h\", \"10m\")."
},
"parent": {
"type": "string",
"description": "Required. The cluster to retrieve logs from. Format: projects/{project}/locations/{location}/clusters/{cluster}"
},
"previous": {
"type": "boolean",
"description": "Optional. If true, retrieve logs from the previous instantiation of the container."
},
"container": {
"type": "string",
"description": "Optional. The name of the container to retrieve logs from. If not specified, logs from the first container are returned."
},
"namespace": {
"type": "string",
"description": "Optional. The namespace of the resource. If not specified, \"default\" is used."
},
"sinceTime": {
"type": "string",
"format": "date-time",
"description": "Optional. Retrieve logs since this time (RFC3339). e.g. \"2024-08-30T06:00:00Z\"."
},
"timestamps": {
"type": "boolean",
"description": "Optional. If true, include timestamps in the log output."
},
"allContainers": {
"type": "boolean",
"description": "Optional. If true, retrieve logs from all containers in the pod."
}
},
"description": "KubeLogsRequest is the request message for retrieving Kubernetes logs."
}| resourceType* | string | Required. The type of resource to retrieve. Kubernetes resource/kind name in singular form, lower case. e.g. "pod", "deployment", "service". |
| customColumns | string | Optional. Custom columns to display in table output. Accepts either kubectl custom-columns format (e.g., "NAME:.metadata.name,IMAGE:.spec.containers[*].image") or comma-separated field names (e.g., "metadata.name,spec.replicas"). When both custom_columns and output_format are specified, output_format is ignored. |
| fieldSelector | string | Optional. A field selector to filter resources. |
| labelSelector | string | Optional. A label selector to filter resources. |
{
"type": "object",
"required": [
"parent",
"resourceType"
],
"properties": {
"name": {
"type": "string",
"description": "Optional. The name of the resource to retrieve. If not specified, all resources of the given type are returned."
},
"parent": {
"type": "string",
"description": "Required. The cluster, which owns this collection of resources. Format: projects/{project}/locations/{location}/clusters/{cluster}"
},
"pageSize": {
"type": "integer",
"format": "int32",
"description": "Optional. The maximum number of resources to return. If not specified, 500 is used. The maximum value is 1000; values above 1000 will be coerced to 1000."
},
"namespace": {
"type": "string",
"description": "Optional. The namespace of the resource. If not specified, all namespaces are searched."
},
"pageToken": {
"type": "string",
"description": "Optional. A page token, received from a previous `GetK8SResource` call. Provide this to retrieve the subsequent page of resources when listing resources. Cannot be used when `name` is specified."
},
"outputFormat": {
"enum": [
"OUTPUT_FORMAT_UNSPECIFIED",
"TABLE",
"WIDE",
"YAML",
"JSON"
],
"type": "string",
"description": "Optional. The output format. One of: (table, wide, yaml, json). If not specified, defaults to table. When both custom_columns and output_format are specified, output_format is ignored.",
"x-google-enum-descriptions": [
"If not specified, defaults to table.",
"Output in table format.",
"Output in wide table format.",
"Output in yaml format.",
"Output in json format."
]
},
"resourceType": {
"type": "string",
"description": "Required. The type of resource to retrieve. Kubernetes resource/kind name in singular form, lower case. e.g. \"pod\", \"deployment\", \"service\"."
},
"customColumns": {
"type": "string",
"description": "Optional. Custom columns to display in table output. Accepts either kubectl custom-columns format (e.g., \"NAME:.metadata.name,IMAGE:.spec.containers[*].image\") or comma-separated field names (e.g., \"metadata.name,spec.replicas\"). When both custom_columns and output_format are specified, output_format is ignored."
},
"fieldSelector": {
"type": "string",
"description": "Optional. A field selector to filter resources."
},
"labelSelector": {
"type": "string",
"description": "Optional. A label selector to filter resources."
}
},
"description": "Request for retrieving Kubernetes resources."
}