REST Resource: cases

Ressource: Fall

Eine Supportanfrage ist ein Objekt, das die Details einer Supportanfrage enthält. Es enthält Felder für den Zeitpunkt der Erstellung, seine Priorität, seine Klassifizierung usw. Anfragen können auch Kommentare und Anhänge enthalten, die im Laufe der Zeit hinzugefügt werden.

Einem Fall ist eine Google Cloud-Organisation oder ein Google Cloud-Projekt übergeordnet.

Organisationen werden durch eine Nummer identifiziert, sodass der Name einer Supportanfrage, die einer Organisation übergeordnet ist, wie folgt aussehen würde:

organizations/123/cases/456

Projekte haben zwei eindeutige Kennungen, eine ID und eine Nummer, und sie sehen so aus:

projects/abc/cases/456

projects/123/cases/456

Sie können beide beim Aufrufen der API verwenden. Weitere Informationen zu Projektkennungen finden Sie unter AIP-2510.

JSON-Darstellung 
{
  "name": string,
  "displayName": string,
  "description": string,
  "classification": {
    object (CaseClassification)
  },
  "timeZone": string,
  "subscriberEmailAddresses": [
    string
  ],
  "state": enum (State),
  "createTime": string,
  "updateTime": string,
  "creator": {
    object (Actor)
  },
  "contactEmail": string,
  "escalated": boolean,
  "testCase": boolean,
  "languageCode": string,
  "priority": enum (Priority)
}
Felder
name

string

Der Ressourcenname für den Fall.
displayName

string

Eine kurze Zusammenfassung des in diesem Fall gemeldeten Problems.
description

string

Eine ausführliche Beschreibung des Problems.
classification

object (CaseClassification)

Die in diesem Fall anwendbare Problemklassifizierung.
timeZone

string

Die Zeitzone des Nutzers, der die Supportanfrage erstellt hat. Sie muss ein Format haben, das von IANA erkannt wird: https://www.iana.org/time-zones. Eine zusätzliche Validierung durch die API ist nicht erforderlich.
subscriberEmailAddresses[]

string

Die E-Mail-Adressen, an die Updates zu diesem Fall gesendet werden sollen.
state

enum (State)

Nur Ausgabe. Der aktuelle Status der Supportanfrage.
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem dieser Fall erstellt wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem dieser Fall zuletzt aktualisiert wurde.

Ein Zeitstempel im Format RFC3339 UTC „Zulu“ mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
creator

object (Actor)

Den Nutzer, der die Anfrage erstellt hat.

Hinweis: Name und E-Mail-Adresse werden verschleiert, wenn die Anfrage vom Google-Support erstellt wurde.
contactEmail

string

Eine vom Nutzer angegebene E-Mail-Adresse, für die Benachrichtigungen über Fallaktualisierungen gesendet werden. Es sollte nur in BYOID-Abläufen verwendet werden, bei denen wir die E-Mail-Adresse des Nutzers nicht direkt aus den EUCs ableiten können.
escalated

boolean

Ob der Fall derzeit eskaliert ist.
testCase

boolean

Gibt an, ob diese Anfrage für interne API-Tests erstellt wurde und vom Supportteam nicht bearbeitet werden soll.
languageCode

string

Die Sprache, in der der Nutzer Support angefordert hat. Dies sollte ein BCP 47-Sprachcode sein (z.B. "en", "zh-CN", "zh-TW", "ja", "ko"). Wenn keine Sprache oder eine nicht unterstützte Sprache angegeben ist, wird standardmäßig Englisch (en) verwendet.

Die Auswahl der Sprache bei der Fallerstellung kann sich auf Ihre verfügbaren Supportoptionen auswirken. Eine Liste der unterstützten Sprachen und der Geschäftszeiten des Supports finden Sie unter https://cloud.google.com/support/docs/language-working-hours.
priority

enum (Priority)

Die Priorität dieses Falls.

Status

Der Status einer Supportanfrage.

Enums
STATE_UNSPECIFIED Der Status des Falls ist unbekannt.
NEW Die Anfrage wurde erstellt, aber es ist noch niemand mit der Bearbeitung beauftragt.
IN_PROGRESS_GOOGLE_SUPPORT Die Anfrage wird derzeit vom Google-Support bearbeitet.
ACTION_REQUIRED Google wartet auf eine Antwort.
SOLUTION_PROVIDED Für den Fall wurde bereits eine Lösung angeboten, diese ist aber noch nicht abgeschlossen.
CLOSED Der Fall wurde gelöst.

Priorität

Die Fallpriorität. P0 ist am dringendsten und P4 die am wenigsten.

Enums
PRIORITY_UNSPECIFIED Die Priorität ist nicht definiert oder wurde noch nicht festgelegt.
P0 Extreme Auswirkungen auf einen Produktionsdienst. Der Dienst ist ausgefallen.
P1 Kritische Auswirkungen auf einen Produktionsdienst. Der Dienst kann derzeit nicht genutzt werden.
P2 Erhebliche Auswirkungen auf einen Produktionsdienst. Der Dienst ist nutzungsfreundlich, aber stark eingeschränkt.
P3 Mittlere Auswirkungen auf einen Produktionsdienst. Service ist verfügbar, aber nur mäßig eingeschränkt.
P4 Allgemeine Fragen oder kleinere Probleme Der Produktionsdienst ist vollständig verfügbar.

Methoden

close

 Schließen Sie eine Supportanfrage.

create

 Erstellen Sie einen neuen Fall und verknüpfen Sie ihn mit einem übergeordneten Fall.

escalate

 Eskalieren Sie einen Fall und starten Sie den Eskalationsmanagementprozess des Google Cloud-Supports.

get

 Rufen Sie einen Fall ab.

list

 Rufen Sie alle Fälle unter einem übergeordneten Element ab, aber nicht seine untergeordneten Elemente.

patch

 Aktualisieren Sie einen Fall.
Suchen Sie mit einer Abfrage nach Fällen.