Method: cases.search

Cerca richieste utilizzando una query.

ESEMPI:

cURL:

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

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().search(
    parent="projects/some-project", query="state=OPEN"
)
print(request.execute())

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Il nome della risorsa padre in cui cercare le richieste.

I parametri di ricerca

Parametri
query

string

Un'espressione utilizzata per filtrare le richieste.

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

  • organization: il nome di un'organizzazione nel formato organizations/<organizationId>.
  • project: un nome di progetto nel formato projects/<projectId>.
  • 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.

Devi specificare organization o project.

Per eseguire ricerche in displayName, description e nei commenti, utilizza una limitazione globale senza parola chiave o operatore. Ad esempio: "my search".

Per cercare solo i casi aggiornati dopo una determinata data, utilizza updateTime con limitazioni con la data, l'ora e il fuso orario specifici nel formato data/ora ISO. Ad esempio, updateTime>"2020-01-01T00:00:00-05:00". updateTime supporta solo l'operatore maggiore di (>).

Esempi:

  • organization="organizations/123456789"
  • project="projects/my-project-id"
  • project="projects/123456789"
  • organization="organizations/123456789" AND state=CLOSED
  • project="projects/my-project-id" AND creator.email="tester@example.com"
  • project="projects/my-project-id" AND (priority=P0 OR priority=P1)
pageSize

integer

Il numero massimo di richieste recuperate con ogni richiesta. La dimensione predefinita della pagina è 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.search.

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.search. 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.