Method: cases.search

Recherchez des cas à l'aide d'une requête.

EXEMPLES:

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

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Nom de la ressource parente dans laquelle rechercher les demandes.

Paramètres de requête

Paramètres
query

string

Expression utilisée pour filtrer les cas.

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

  • organization: nom d'organisation au format organizations/<organizationId>.
  • project: nom de projet au format projects/<projectId>.
  • 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.

Vous devez spécifier soit organization, soit project.

Pour effectuer une recherche dans displayName, description et dans les commentaires, définissez une restriction globale sans mot clé ni opérateur. Exemple :"my search"

Pour rechercher uniquement les cas mis à jour après une certaine date, utilisez updateTime limité avec cette date, heure et fuseau horaire spécifiques au format date/heure ISO. Exemple :updateTime>"2020-01-01T00:00:00-05:00" updateTime n'accepte que l'opérateur "supérieur à" (>).

Exemples :

  • 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

Nombre maximal de cas récupérés avec chaque requête. La taille de page par défaut est de 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.search.

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