Method: cases.list

Permet de récupérer toutes les demandes d'un parent, mais pas ses enfants.

Par exemple, si vous répertoriez les demandes d'une organisation, elles ne renvoient que les demandes dont l'organisation est directement responsable. Pour récupérer les demandes d'assistance d'une organisation et de ses projets, utilisez cases.search.

EXEMPLES:

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())

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom d'un parent sous lequel répertorier les cas.

Paramètres de requête

Paramètres
filter

string

Expression utilisée pour filtrer les cas.

S'il s'agit d'une chaîne vide, aucun filtrage n'est effectué. Sinon, le point de terminaison renvoie les demandes correspondant au filtre.

Les expressions utilisent les champs suivants, séparés par AND et spécifiés avec =:

  • state: peut être OPEN ou CLOSED.
  • priority: peut être P0, P1, P2, P3 ou P4. Vous pouvez définir plusieurs valeurs de priorité à l'aide de l'opérateur OR. Exemple : priority=P1 OR priority=P2.
  • creator.email: adresse e-mail du créateur de la demande.

EXEMPLES:

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

integer

Nombre maximal de cas récupérés avec chaque requête. Valeur par défaut : 10
pageToken

string

Jeton identifiant la page des résultats à renvoyer. Si aucune valeur n'est spécifiée, la première page est récupérée.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour le point de terminaison cases.list.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "cases": [
    {
      object (Case)
    }
  ],
  "nextPageToken": string
}
Champs
cases[]

object (Case)

Liste des cas associés au parent après l'application des filtres.
nextPageToken

string

Jeton permettant de récupérer la page de résultats suivante. Définissez ce paramètre dans le champ pageToken des requêtes cases.list ultérieures. Si aucune valeur n'est spécifiée, il n'y a plus de résultats à récupérer.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.