---
title: "POST /v1/projects/{projectId}/regions/{region}/clusters/{clusterName}:diagnose"
method: POST
path: "/v1/projects/{projectId}/regions/{region}/clusters/{clusterName}:diagnose"
tags: ["projects"]
---

# POST /v1/projects/{projectId}/regions/{region}/clusters/{clusterName}:diagnose

`POST /v1/projects/{projectId}/regions/{region}/clusters/{clusterName}:diagnose`

Gets cluster diagnostic information. The returned Operation.metadata will be ClusterOperationMetadata (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#clusteroperationmetadata). After the operation completes, Operation.response contains DiagnoseClusterResults (https://cloud.google.com/dataproc/docs/reference/rpc/google.cloud.dataproc.v1#diagnoseclusterresults).

## Path parameters

- `projectId` string, required
- `region` string, required
- `clusterName` string, required

## Request body

- DiagnoseClusterRequest — A request to collect cluster diagnostic information.
  - `yarnApplicationId` string — Optional. DEPRECATED Specifies the yarn application on which diagnosis is to be performed.
  - `tarballAccess` 'TARBALL_ACCESS_UNSPECIFIED' | 'GOOGLE_CLOUD_SUPPORT' | 'GOOGLE_DATAPROC_DIAGNOSE' — Optional. (Optional) The access type to the diagnostic tarball. If not specified, falls back to default access of the bucket
  - `diagnosisInterval` Interval — Represents a time interval, encoded as a Timestamp start (inclusive) and a Timestamp end (exclusive).The start must be less than or equal to the end. When the start equals the end, the interval is empty (matches no time). When both start and end are unspecified, the interval matches any time.
    - `endTime` string, google-datetime — Optional. Exclusive end of the interval.If specified, a Timestamp matching this interval will have to be before the end.
    - `startTime` string, google-datetime — Optional. Inclusive start of the interval.If specified, a Timestamp matching this interval will have to be the same or after the start.
  - `tarballGcsDir` string — Optional. (Optional) The output Cloud Storage directory for the diagnostic tarball. If not specified, a task-specific directory in the cluster's staging bucket will be used.
  - `job` string — Optional. DEPRECATED Specifies the job on which diagnosis is to be performed. Format: projects/{project}/regions/{region}/jobs/{job}
  - `jobs` string[] — Optional. Specifies a list of jobs on which diagnosis is to be performed. Format: projects/{project}/regions/{region}/jobs/{job}
  - `yarnApplicationIds` string[] — Optional. Specifies a list of yarn applications on which diagnosis is to be performed.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/dataproc.md) · [All operations](https://skmtc.net/google/apis/dataproc/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/dataproc/revisions/15847ccbcf7d/schema)