Method: cases.list

Recupera tutte le richieste di un elemento padre, ma non le relative istanze secondarie.

Ad esempio, l'elenco delle richieste all'interno di un'organizzazione restituisce solo le richieste che sono direttamente padre dell'organizzazione. Per recuperare le richieste in un'organizzazione e nei relativi progetti, utilizza cases.search.

ESEMPI:

cURL:

parent="projects/some-project"
curl \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://cloudsupport.googleapis.com/v2/$parent/cases"

Python:

import googleapiclient.discovery

apiVersion = "v2"
supportApiService = googleapiclient.discovery.build(
    serviceName="cloudsupport",
    version=apiVersion,
    discoveryServiceUrl=f"https://cloudsupport.googleapis.com/$discovery/rest?version={apiVersion}",
)

request =
  supportApiService.cases().list(parent="projects/some-project")
print(request.execute())

Richiesta HTTP

GET https://cloudsupport.googleapis.com/v2/{parent=*/*}/cases

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome di un padre per l'elenco delle richieste.

I parametri di ricerca

Parametri
filter

string

Un'espressione utilizzata per filtrare le richieste.

Se è una stringa vuota, non viene applicato alcun filtro. In caso contrario, l'endpoint restituisce le richieste che corrispondono al filtro.

Le espressioni utilizzano i seguenti campi separati da AND e specificati con =:

  • state: può essere OPEN o CLOSED.
  • priority: può essere P0, P1, P2, P3 o P4. Puoi specificare più valori per la priorità utilizzando l'operatore OR. Ad esempio, priority=P1 OR priority=P2.
  • creator.email: l'indirizzo email dell'autore della richiesta.

ESEMPI:

  • state=CLOSED
  • state=OPEN AND creator.email="tester@example.com"
  • state=OPEN AND (priority=P0 OR priority=P1)
pageSize

integer

Il numero massimo di richieste recuperate con ogni richiesta. Il valore predefinito è 10.
pageToken

string

Un token che identifica la pagina dei risultati da restituire. Se non specificati, viene recuperata la prima pagina.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Il messaggio di risposta per l'endpoint Cases.list.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "cases": [
    {
      object (Case)
    }
  ],
  "nextPageToken": string
}
Campi
cases[]

object (Case)

L'elenco delle richieste associate all'account principale dopo l'applicazione di eventuali filtri.
nextPageToken

string

Un token per recuperare la pagina dei risultati successiva. Imposta questa opzione nel campo pageToken delle successive richieste cases.list. Se questa impostazione non è specificata, non ci sono altri risultati da recuperare.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloudsupport
  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.