Method: projects.locations.instances.diagnose

Erstellt eine Diagnosedatei und führt das Diagnosetool für eine Instanz aus.

HTTP-Anfrage

POST https://notebooks.googleapis.com/v1/{name}:diagnose

Pfadparameter

Parameter
name

string

Erforderlich. Format: projects/{projectId}/locations/{location}/instances/{instanceId}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "diagnosticConfig": {
    object (DiagnosticConfig)
  },
  "timeoutMinutes": integer
}
Felder
diagnosticConfig

object (DiagnosticConfig)

Erforderlich. Definiert Flags, die zum Ausführen des Diagnosetools verwendet werden
timeoutMinutes

integer

Optional. Maximale Zeit in Minuten, bevor für den Vorgang ein Zeitlimit überschritten wird.

Antworttext

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

DiagnosticConfig

Definiert Flags, die zum Ausführen des Diagnosetools verwendet werden

JSON-Darstellung 
{
  "gcsBucket": string,
  "relativePath": string,
  "repairFlagEnabled": boolean,
  "packetCaptureFlagEnabled": boolean,
  "copyHomeFilesFlagEnabled": boolean
}
Felder
gcsBucket

string

Erforderlich. Speicherort des Cloud Storage-Bucket des Nutzers (ERFORDERLICH). Muss mit dem Pfadpräfix (gs://$GCS_BUCKET) formatiert werden.

Berechtigungen: User-Managed Notebooks: - storage.buckets.writer: Muss dem Dienstkonto des Projekts erteilt werden, das an die VM angehängt ist. Google Managed Notebooks: - storage.buckets.writer: Muss dem Dienstkonto des Projekts oder den an die VM angehängten Nutzeranmeldedaten zugewiesen werden, je nach Authentifizierungsmodus.

Cloud Storage-Bucket, in den die Logdatei geschrieben wird: gs://$GCS_BUCKET/$RELATIVE_PATH/$VM_DATE_$TIME.tar.gz
relativePath

string

Optional. Definiert den relativen Speicherpfad im Cloud Storage-Bucket, in den die Diagnoselogbücher geschrieben werden. Der Standardpfad ist das Stammverzeichnis des Cloud Storage-Buckets (gs://$GCS_BUCKET/$DATE_$TIME.tar.gz). Beispiel für den vollständigen Pfad, in den die Logdatei geschrieben wird: gs://$GCS_BUCKET/$RELATIVE_PATH/
repairFlagEnabled

boolean

Optional. Aktiviert das Flag zum Reparieren des Dienstes für die Instanz.
packetCaptureFlagEnabled

boolean

Optional. Aktiviert das Flag, um 30 Sekunden lang Pakete von der Instanz zu erfassen.
copyHomeFilesFlagEnabled

boolean

Optional. Ermöglicht das Kopieren aller Inhalte des Ordners /home/jupyter