Ressourceneinstellungen – Übersicht

Mit den Ressourceneinstellungen können Sie die Einstellungen für Ihre Google Cloud-Projekte, -Ordner und -Organisation zentral konfigurieren. Diese Einstellungen werden von ihren untergeordneten Elementen in der Ressourcenhierarchie übernommen. Jede Einstellung wird von Google erstellt und verwaltet.

Ressourceneinstellungen

Ressourceneinstellungen stellen eine Dimension einer Google Cloud-Ressource oder eines Dienstes dar, die Sie konfigurieren können. Zum Beispiel könnte eine Einstellung für den Erstellungsort eines Cloud Storage-Buckets den Standardort festlegen, an dem neue Bucket-Ressourcen erstellt werden.

Jede Ressourceneinstellung hat die folgenden wichtigen Attribute:

  • Name: eine global eindeutige Kennung für die Einstellung, die bei der Konfiguration von Werten für eine Einstellung verwendet wird.

  • Metadaten: die von Google verwalteten Informationen zur Ressourceneinstellung. Metadaten für eine Ressourceneinstellung enthalten die folgenden Felder:

    • Datentyp: Der Typ der Werte, die für diese Einstellung konfiguriert werden können. Mögliche Datentypen sind boolesche Werte, Strings, Gruppen von Strings und Enums.

    • Standardwert: der von Google verwaltete Standardwert der Einstellung, wenn in Ihrer Organisation kein anderer Wert festgelegt ist.

    • Schreibgeschützt: Ein Flag, das angibt, ob Google für diese Einstellung schreibgeschützt eingestellt hat. Wenn eine Ressourceneinstellung schreibgeschützt ist, können die Werte für diese Einstellung nicht geändert werden. Eine Einstellung kann nur bei Migrationen und der Einstellung von Produkten/Funktionen schreibgeschützt sein. Google sendet eine Warnung, bevor eine Änderung an diesem Flag vorgenommen wird.

  • Lokaler Wert: der spezifische Wert einer Einstellung, die einer Ressource zugeordnet ist.

  • Gültiger Wert: der Wert einer Einstellung, nachdem die übernommenen Ressourceneinstellungen aus der Ressourcenhierarchie ausgewertet wurden.

Sie benötigen die Rolle Betrachter von Ressourceneinstellungen oder die IAM-Rolle Administrator für Ressourceneinstellungen, um die Liste der Einstellungen aufzurufen, die für eine bestimmte Organisation, einen bestimmten Ordner oder ein bestimmtes Projekt verwendet werden können. Weitere Informationen zu diesen Rollen finden Sie unter Erforderliche Berechtigungen.

Die Verfügbarkeit der Ressourceneinstellungen kann je nach Releasestatus der Ressourceneinstellung zwischen Organisationen variieren.

Beispiel für eine Ressourceneinstellung

Das folgende Beispiel zeigt, wie eine Ressourceneinstellung angezeigt wird:

# Setting
{
  "name": "net-preferredDnsServers",
  "metadata": {
    "displayName": "Preferred DNS Servers",
    "description": "The DNS servers to be used by VMs associated with this resource.",
    "read_only": false,
    "data_type" : "STRING_SET",
    "default_value" : {
      "string_set_value" : {
        "values" : [ "8.8.8.8" ],
      }
    }
  }
}

Benennung

Eine Ressourceneinstellung hat einen global eindeutigen Kurznamen im Format settings/SETTING_ID. Der Kurzname einer Ressourceneinstellung zur Steuerung des anfänglichen Start-Images für eine virtuelle Maschine kann beispielsweise settings/compute-vmStartupImage sein.

Der relative Ressourcenname einer Einstellung fügt dem Kurznamen der Einstellung die numerische Ressourcen-ID hinzu. Beispielsweise lautet der relative Ressourcenname der obigen settings/compute-vmStartupImage-Einstellung für organizations/12345678901 organizations/12345678901/settings/compute-vmStartupImage.

Einstellungen mit demselben Kurznamen werden von Google Cloud als identisch betrachtet, auch wenn sie unterschiedliche relative Ressourcennamen haben. Die in einem relativen Ressourcennamen enthaltene Ressource gibt nur die Verfügbarkeit dieser Einstellung für die benannte Ressource an.

Lokale Einstellungswerte

Der Einstellungswert, der direkt auf eine bestimmte Ressourceneinstellung angewendet wird, wird als lokaler Einstellungswert bezeichnet. Sie können den lokalen Wert einer Ressourceneinstellung direkt mit der Resource Settings API ändern.

Das folgende Beispiel zeigt eine Ressourceneinstellung, die einen lokalen Einstellungswert enthält:

# Setting
{
  "name" : "folders/123/settings/net-preferredDnsServers"
  "localValue": {
    "stringSetValue": {
      "values": ["8.8.8.8", "8.8.4.4"]
    }
  }
}

Gültige Einstellungswerte

Der lokale Einstellungswert für eine Ressource wird von allen Nachfolgern dieser Ressource in der Ressourcenhierarchie übernommen. Wenn eines dieser untergeordneten Elemente einen lokalen Einstellungswert hat, wird der übernommene Einstellungswert überschrieben. Wenn Sie keinen lokalen Einstellungswert für eine Ressource oder eines ihrer untergeordneten Elemente festgelegt haben, wird der von Google definierte Standardwert für diese Einstellung verwendet.

Die Ressourceneinstellungen werden ausgewertet und das Ergebnis ist der effektive Einstellungswert. Dieser Wert zeigt das Ergebnis der Endeinstellung aller Einstellungen für die Übernahme und lokalen Werte einer bestimmten Ressource. Die Regeln zur Bestimmung des effektiven Einstellungswerts werden so ausgewertet:

  1. Wenn eine Ressource einen Wert für eine bestimmte Ressourceneinstellung hat, dann ist dies der effektive Wert, der jeden übernommenen Wert überschreibt.

  2. Wenn die Ressource keinen Wert für diese Ressourceneinstellung hat und einer der Ancestors der Ressource einen Wert für diese Einstellung hat, ist der Wert, der dem nächsten Ancestor zugeordnet ist, der effektive Wert.

  3. Wenn weder diese Ressource noch ihre Ancestors einen Wert für diese Ressourceneinstellung haben und die Einstellung einen von Google verwalteten Standardwert hat, ist dies der effektive Wert.

  4. Wenn weder die Ressource noch ihre Ancestors einen Wert für diese Ressourceneinstellung haben und der Wert keinen von Google verwalteten Standardwert hat, gibt es für diese Einstellung keinen gültigen Wert für diese Ressource.

Ressourceneinstellungen ohne effektiven Wert

Wenn eine Ressourceneinstellung keinen von Google verwalteten Standardwert hat, ist es möglich, eine Ressource zu haben, die keinen effektiven Wert für diese Einstellung hat. Für neue Ressourceneinstellungen gelten keine von Google verwalteten Standardeinstellungen, wenn diese abwärtskompatibel vorgenommen werden können. Neue Einstellungen unterbrechen daher keine vorhandenen Dienste.

Leere Werte und nicht festgelegte Werte

Ein Ressourceneinstellungswert wird als leer betrachtet, wenn ein Ressourceneinstellungswert leer ist. Beispiel: "" ist ein leerer String. Leere Werte gelten gemäß der Auswertung der effektiven Einstellungswerte trotzdem als Werte und überschreiben die Übernahme.

Wenn kein lokaler Wert festgelegt ist, bleibt die Ressourceneinstellung nicht festgelegt. Diese Ressource übernimmt den Wert der Ressourceneinstellung.

Nächste Schritte