Attribute der gcloud CLI verwalten

Attribute sind Einstellungen, die das Verhalten der gcloud CLI steuern.

Sie können Attribute verwenden, um eine Einstellung pro Produkt oder pro Dienst zu definieren, z. B. das Konto, das von der gcloud-Befehlszeile für die Autorisierung verwendet wird, die Standardregion, die bei der Arbeit mit Compute Engine-Ressourcen verwendet werden soll, oder die Option zum Deaktivieren der automatischen Prüfung von Komponentenupdates für die gcloud CLI. Attribute können auch verwendet werden, um gcloud CLI-Einstellungen wie den Ausführlichkeitsgrad und die Konfiguration von Eingabeaufforderungen für gcloud CLI-Befehle zu definieren.

Attribute und Flags

Die gcloud CLI unterstützt einige globale Flags und Befehls-Flags, die die gleichen Auswirkungen wie die Attribute der gcloud CLI haben. Die gcloud-Befehlszeile unterstützt beispielsweise sowohl das Flag --project als auch das Attribut project. Sie können mithilfe von Attributen die gleichen Einstellungen für alle Befehlsausführungen beibehalten, während Flags das Befehlsverhalten pro Aufruf beeinflussen. Flags überschreiben Properties, wenn beide festgelegt sind.

Konfigurationen

Eine Konfiguration ist eine benannte Reihe von Attributen der gcloud-Befehlszeile. Die gcloud CLI verwendet eine Konfiguration mit dem Namen default als erste aktive Konfiguration. Die Konfiguration default eignet sich für die meisten Anwendungsfälle. Sie können jedoch auch zusätzliche Konfigurationen erstellen und bei Bedarf zwischen diesen wechseln.

Attribute auflisten

Führen Sie gcloud config list aus, um die Attribute in der aktiven Konfiguration aufzulisten:

gcloud config list

Die gcloud-Befehlszeile gibt eine Liste der Attribute zurück:

[compute]
region = us-east1
zone = us-east1-d
[core]
account = user@google.com
disable_usage_reporting = False
project = example-project
[metrics]
command_name = gcloud.config.list

Attribute festlegen

Führen Sie gcloud config set aus, um ein Attribut in der aktiven Konfiguration festzulegen. Im folgenden Beispiel wird das Attribut project festgelegt, wobei PROJECT_ID die eindeutige ID für Ihr Projekt ist.

gcloud config set project PROJECT_ID

Wenn Sie Attribute festlegen möchten, die sich nicht im Attributabschnitt core befinden, müssen Sie vor dem Attributnamen den jeweiligen Abschnitt gefolgt von einem Schrägstrich angeben. Im folgenden Beispiel wird der Zonenname auf us-east1-b festgelegt.

gcloud config set compute/zone us-east1-b

Attribute mithilfe von Umgebungsvariablen festlegen

Sie können Attribute auch mit Umgebungsvariablen festlegen. Jedes Attribut hat eine entsprechende Umgebungsvariable, mit der es festgelegt werden kann. Der Name der Umgebungsvariable folgt dem Muster CLOUDSDK_SECTION_NAME_PROPERTY_NAME. Sie können beispielsweise die Attribute core/project und compute/zone so festlegen:

CLOUDSDK_CORE_PROJECT=PROJECT_NAME

CLOUDSDK_COMPUTE_ZONE=ZONE_NAME

Festlegung von Attributen aufheben

Mit gcloud config unset heben Sie die Festlegung eines Attributs in der aktiven Konfiguration auf:

gcloud config unset disable_usage_reporting

Verfügbare Attribute

Die Liste aller Attribute finden Sie, indem Sie gcloud topic configurations oder gcloud config set --help ausführen und nach dem Abschnitt "Verfügbare Attribute" suchen.

Nächste Schritte