Methode: services.disable

Deaktivieren Sie einen Dienst, damit er nicht mehr für ein Projekt verwendet werden kann. Dies verhindert eine unbeabsichtigte Verwendung, die zu unerwarteten Gebühren oder Sicherheitslücken führen kann.

Es ist nicht zulässig, die Deaktivierungsmethode für einen Dienst aufzurufen, der derzeit nicht aktiviert ist. Aufrufer erhalten den Status FAILED_PRECONDITION, wenn der Zieldienst momentan nicht aktiviert ist.

Operation<response: DisableServiceResponse>

HTTP-Anfrage

POST https://serviceusage.googleapis.com/v1/{name=*/*/services/*}:disable

Die URL verwendet die Syntax von Google API HTTP-Anmerkungen.

Pfadparameter

Parameter
name

string

Name des Nutzers und Dienstes, für die der Dienst deaktiviert werden soll.

Die Methoden zum Aktivieren und Deaktivieren unterstützen derzeit nur Projekte.

Ein Beispielname wäre projects/123/services/serviceusage.googleapis.com, wobei 123 die Projektnummer (nicht die Projekt-ID) ist.

Zur Autorisierung wird die folgende Google IAM-Berechtigung für die angegebene Ressource name benötigt:

  • serviceusage.services.disable

Anfragetext

Der Anfragetext enthält Daten mit der folgenden Struktur:

JSON-Darstellung 

{
  "disableDependentServices": boolean
}
Felder
disableDependentServices

boolean

Gibt an, ob aktivierte Dienste, die von diesem Dienst abhängig sind, ebenfalls deaktiviert werden sollen. Wenn nicht festgelegt, wird ein Fehler generiert, falls aktivierte Dienst von dem zu deaktivierenden Dienst abhängig sind. Wenn dieses Feld festgelegt ist, werden der Dienst und alle davon abhängigen aktivierten Dienste zusammen deaktiviert.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.