Attribute sind Einstellungen, die das Verhalten der gcloud CLI steuern.
Mit Attributen können Sie eine produkt- oder dienstspezifische Einstellung definieren, z. B. das von der gcloud CLI zur Autorisierung verwendete Konto, die Standardregion für die Arbeit mit Compute Engine-Ressourcen oder die Option, die automatische Prüfung auf Aktualisierungen von gcloud CLI-Komponenten zu deaktivieren. Mit Attributen können auch gcloud CLI-Einstellungen wie der Ausführlichkeitsgrad und die Eingabeaufforderungskonfiguration für gcloud CLI-Befehle definiert werden.
Attribute und Flags
Die gcloud CLI unterstützt einige globale Flags und Befehls-Flags, die dieselbe Wirkung wie gcloud CLI-Attribute haben. Die gcloud CLI 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 Gruppe von gcloud CLI-Attributen. Die gcloud CLI verwendet eine Konfiguration mit dem Namen default als anfängliche aktive Konfiguration. Die default-Konfiguration ist für die meisten Anwendungsfälle geeignet. 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 CLI gibt die 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
Wenn Sie ein Attribut in der aktiven Konfiguration festlegen möchten, führen Sie gcloud config set aus. 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 nicht im Abschnitt core enthalten sind, müssen Sie den Abschnitt gefolgt von einem Schrägstrich vor dem Attributnamen 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
- Weitere Informationen zu Konfigurationen finden Sie unter gcloud CLI-Konfigurationen.