Ressourceneinstellungen – Übersicht

Sie können Ressourceneinstellungen verwenden, um die Einstellungen für Ihre Google Cloud-Projekte, -Ordner und -Organisation zentral zu konfigurieren. Diese Einstellungen werden von ihren untergeordneten Objekten 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: von Google verwaltete Informationen zur Ressourceneinstellung Metadaten für eine Ressourceneinstellung umfassen die folgenden Felder:

    • Datentyp: Der Typ der Werte, die für diese Einstellung konfiguriert werden können. Zu den möglichen Datentypen gehören 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 diese Einstellung schreibgeschützt gemacht hat. Wenn eine Ressourceneinstellung schreibgeschützt ist, können die Werte dieser Einstellung nicht geändert werden. Eine Einstellung wird nur für Migrationen und Einstellungen schreibgeschützt. Google gibt eine Warnung aus, 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 Identitäts- und Zugriffsverwaltungsrolle Betrachter von Ressourceneinstellungen oder Administrator von Ressourceneinstellungen, um die Liste der Einstellungen aufzurufen, die für eine bestimmte Organisation und einen bestimmten Ordner verfügbar sind. oder Projekt. Weitere Informationen zu diesen Rollen finden Sie unter Erforderliche Berechtigungen.

Die Verfügbarkeit von Ressourceneinstellungen kann sich je nach Release-Status von Ressourceneinstellungen unterscheiden.

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 zum Steuern des anfänglichen Start-Images für eine virtuelle Maschine könnte beispielsweise settings/compute-vmStartupImage sein.

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

Einstellungen mit demselben Kurznamen gelten für Google Cloud als identisch, 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 Wert der lokalen Einstellung für eine Ressource wird von allen Nachfolgern dieser Ressource in der Ressourcenhierarchie übernommen. Wenn einer dieser Nachfolger einen lokalen Einstellungswert hat, wird der übernommene Wert überschrieben. Wenn Sie für eine Ressource oder ihre untergeordneten Elemente keinen lokalen Einstellungswert festgelegt haben, wird der von Google definierte Standardwert für diese Einstellung verwendet.

Ressourceneinstellungen werden ausgewertet und das Ergebnis ist der effektive Einstellungswert. Dieser Wert zeigt das Ergebnis aller Einstellungen für die Übernahme und den lokalen Wert der jeweiligen 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. Weder diese Ressource noch ihre Ancestors haben einen Wert für diese Ressourceneinstellung und die Einstellung hat einen von Google verwalteten Standardwert.

  4. Wenn weder die Ressource noch ihre Ancestors einen Wert für diese Ressourceneinstellung haben und der Wert keine von Google verwaltete Standardeinstellung hat, gibt es für diese Einstellung keinen effektiven Wert für diese Ressource.

Ressourceneinstellungen ohne effektiven Wert

Wenn eine Ressourceneinstellung keine von Google verwaltete Standardeinstellung hat, ist es möglich, dass eine Ressource keinen effektiven Wert für diese Einstellung hat. Für neue Ressourceneinstellungen gibt es keine von Google verwalteten Standardeinstellungen, wenn dies abwärtskompatibel ist. Daher werden vorhandene Dienste nicht durch neue Einstellungen unterbrochen.

Leere Werte und nicht festgelegte Werte

Ein Ressourceneinstellungswert wird als leer angesehen, wenn er einen leeren Ressourceneinstellungswert hat. Zum Beispiel ist "" ein leerer String. Leere Werte werden gemäß der Auswertung der Einstellungswerte immer noch berücksichtigt 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