Interface CaseServiceGrpc.AsyncService (0.47.0)

A service to manage Google Cloud support cases.

Close a case. EXAMPLES: cURL: <code><code>shell case="projects/some-project/cases/43595344" curl &#92; --request POST &#92; --header "Authorization: Bearer $(gcloud auth print-access-token)" &#92; "https://cloudsupport.googleapis.com/v2/$case:close" </code></code><code> Python: </code><code><code>python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().close( name="projects/some-project/cases/43595344" ) print(request.execute()) </code></code>

Create a new case and associate it with a parent. It must have the following fields set: display_name, description, classification, and priority. If you're just testing the API and don't want to route your case to an agent, set testCase=true. EXAMPLES: cURL: <code><code>shell parent="projects/some-project" curl &#92; --request POST &#92; --header "Authorization: Bearer $(gcloud auth print-access-token)" &#92; --header 'Content-Type: application/json' &#92; --data '{ "display_name": "Test case created by me.", "description": "a random test case, feel free to close", "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, "time_zone": "-07:00", "subscriber_email_addresses": [ "foo&#64;domain.com", "bar&#64;domain.com" ], "testCase": true, "priority": "P3" }' &#92; "https://cloudsupport.googleapis.com/v2/$parent/cases" </code></code><code> Python: </code><code><code>python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().create( parent="projects/some-project", body={ "displayName": "A Test Case", "description": "This is a test case.", "testCase": True, "priority": "P2", "classification": { "id": "100IK2AKCLHMGRJ9CDGMOCGP8DM6UTB4BT262T31BT1M2T31DHNMENPO6KS36CPJ786L2TBFEHGN6NPI64R3CDHN8880G08I1H3MURR7DHII0GRCDTQM8" }, }, ) print(request.execute()) </code></code>

Escalate a case, starting the Google Cloud Support escalation management process. This operation is only available for some support services. Go to https://cloud.google.com/support and look for 'Technical support escalations' in the feature list to find out which ones let you do that. EXAMPLES: cURL: <code><code>shell case="projects/some-project/cases/43595344" curl &#92; --request POST &#92; --header "Authorization: Bearer $(gcloud auth print-access-token)" &#92; --header "Content-Type: application/json" &#92; --data '{ "escalation": { "reason": "BUSINESS_IMPACT", "justification": "This is a test escalation." } }' &#92; "https://cloudsupport.googleapis.com/v2/$case:escalate" </code></code><code> Python: </code><code><code>python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().escalate( name="projects/some-project/cases/43595344", body={ "escalation": { "reason": "BUSINESS_IMPACT", "justification": "This is a test escalation.", }, }, ) print(request.execute()) </code></code>

Retrieve a case. EXAMPLES: cURL: <code><code>shell case="projects/some-project/cases/16033687" curl &#92; --header "Authorization: Bearer $(gcloud auth print-access-token)" &#92; "https://cloudsupport.googleapis.com/v2/$case" </code></code><code> Python: </code><code><code>python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().get( name="projects/some-project/cases/43595344", ) print(request.execute()) </code></code>

Retrieve all cases under a parent, but not its children. For example, listing cases under an organization only returns the cases that are directly parented by that organization. To retrieve cases under an organization and its projects, use cases.search. EXAMPLES: cURL: <code><code>shell parent="projects/some-project" curl &#92; --header "Authorization: Bearer $(gcloud auth print-access-token)" &#92; "https://cloudsupport.googleapis.com/v2/$parent/cases" </code></code><code> Python: </code><code><code>python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().list(parent="projects/some-project") print(request.execute()) </code></code>

Retrieve valid classifications to use when creating a support case. Classifications are hierarchical. Each classification is a string containing all levels of the hierarchy separated by " > ". For example, "Technical Issue > Compute > Compute Engine". Classification IDs returned by this endpoint are valid for at least six months. When a classification is deactivated, this endpoint immediately stops returning it. After six months, case.create requests using the classification will fail. EXAMPLES: cURL: <code><code>shell curl &#92; --header "Authorization: Bearer $(gcloud auth print-access-token)" &#92; 'https://cloudsupport.googleapis.com/v2/caseClassifications:search?query=display_name:"*Compute%20Engine*"' </code></code><code> Python: </code><code><code>python import googleapiclient.discovery supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version="v2", discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version=v2", ) request = supportApiService.caseClassifications().search( query='display_name:"*Compute Engine*"' ) print(request.execute()) </code></code>

Search for cases using a query. EXAMPLES: cURL: <code><code>shell parent="projects/some-project" curl &#92; --header "Authorization: Bearer $(gcloud auth print-access-token)" &#92; "https://cloudsupport.googleapis.com/v2/$parent/cases:search" </code></code><code> Python: </code><code><code>python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().search( parent="projects/some-project", query="state=OPEN" ) print(request.execute()) </code></code>

Update a case. Only some fields can be updated. EXAMPLES: cURL: <code><code>shell case="projects/some-project/cases/43595344" curl &#92; --request PATCH &#92; --header "Authorization: Bearer $(gcloud auth print-access-token)" &#92; --header "Content-Type: application/json" &#92; --data '{ "priority": "P1" }' &#92; "https://cloudsupport.googleapis.com/v2/$case?updateMask=priority" </code></code><code> Python: </code><code><code>python import googleapiclient.discovery api_version = "v2" supportApiService = googleapiclient.discovery.build( serviceName="cloudsupport", version=api_version, discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={api_version}", ) request = supportApiService.cases().patch( name="projects/some-project/cases/43112854", body={ "displayName": "This is Now a New Title", "priority": "P2", }, ) print(request.execute()) </code></code>