Panoramica delle impostazioni delle risorse

Puoi usare le impostazioni delle risorse per configurare centralmente le impostazioni per il tuo progetti, cartelle e organizzazione di Google Cloud. Queste impostazioni vengono ereditate dai loro discendenti gerarchia delle risorse. Ogni impostazione è create e gestite da Google.

Impostazioni risorse

Le impostazioni delle risorse rappresentano una dimensione di una risorsa o un servizio Google Cloud che puoi configurare. Ad esempio, una località di creazione di un bucket Cloud Storage potrebbe determinare la località predefinita in cui si trovano le nuove risorse del bucket è stato creato.

Ogni impostazione della risorsa ha le seguenti proprietà chiave:

  • Nome: un identificatore univoco globale per l'impostazione utilizzato quando e configurare i valori di un'impostazione.

  • Metadati: informazioni gestite da Google relative all'impostazione della risorsa. I metadati per un'impostazione della risorsa includono i seguenti campi:

    • Tipo di dati: il tipo di valori che possono essere configurati per questa impostazione. I tipi di dati possibili includono booleani, stringhe, insiemi di stringhe e enum.

    • Valore predefinito: il valore predefinito dell'impostazione gestito da Google in caso contrario se un altro valore è impostato nella tua organizzazione.

    • Sola lettura: un flag che indica se Google ha effettuato questa impostazione. sola lettura. Se un'impostazione della risorsa è di sola lettura, i relativi valori. non possono essere modificati. Un'impostazione è resa in sola lettura solo per le migrazioni e i ritiri. Google fornisce un avviso prima di apportare una modifica a questo flag.

  • Valore locale: il valore specifico di un'impostazione associata a una risorsa.

  • Valore effettivo: il valore di un'impostazione dopo la valutazione delle impostazioni ereditate impostazioni delle risorse dalla gerarchia delle risorse.

Devi disporre del Visualizzatore delle impostazioni delle risorse o dell'Amministratore delle impostazioni delle risorse il ruolo Identity and Access Management per visualizzare l'elenco delle impostazioni disponibili per l'utilizzo su un un'organizzazione, una cartella o un progetto. Per ulteriori dettagli su questi ruoli, consulta Autorizzazioni obbligatorie.

La disponibilità delle impostazioni delle risorse può variare da un'organizzazione all'altra, a seconda del di rilascio dell'impostazione della risorsa.

Esempio di impostazione delle risorse

Di seguito è riportato un esempio di come viene visualizzata un'impostazione della risorsa:

# 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" ],
      }
    }
  }
}

Denominazione

Un'impostazione di risorsa ha un nome breve univoco a livello globale, nel formato settings/SETTING_ID. Ad esempio, il nome breve di un dell'impostazione delle risorse per controllare l'immagine di avvio iniziale per una macchina virtuale potrebbe essere settings/compute-vmStartupImage.

Il nome risorsa relativo di un'impostazione aggiunge l'ID risorsa numerico al l'impostazione del nome breve. Ad esempio, il nome risorsa relativo rispetto a quanto riportato sopra L'impostazione settings/compute-vmStartupImage per organizations/12345678901 è organizations/12345678901/settings/compute-vmStartupImage.

Le impostazioni con lo stesso nome breve sono considerate identiche da Google Cloud, anche se hanno nomi relativi di risorse diversi. La risorsa inclusa in un nome risorsa relativo indica solo la disponibilità di quella impostazione alla risorsa denominata.

Valori delle impostazioni locali

Il valore applicato direttamente a una determinata impostazione della risorsa è è il valore dell'impostazione locale. Puoi modificare direttamente il valore locale di un dell'impostazione delle risorse utilizzando API Resource Settings.

Di seguito è riportato un esempio di impostazione delle risorse che include un'impostazione locale valore:

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

Valori effettivi delle impostazioni

Il valore dell'impostazione locale per una risorsa viene ereditato da tutti i parametri discendenti nella gerarchia delle risorse. Se uno di questi discendenti ha un valore di impostazione locale, sostituisce il valore valore dell'impostazione ereditato. Se non hai configurato un valore di impostazione locale su una risorsa o qualsiasi sua discendente, l'impostazione predefinita definita da Google per quell'impostazione .

Vengono valutate le impostazioni delle risorse e il risultato corrisponde al valore dell'impostazione effettiva. Questo valore mostra il risultato finale di tutta l'ereditarietà e del valore locale le impostazioni di una determinata risorsa. Le regole per determinare l'impostazione effettiva vengono valutati come segue:

  1. Se una risorsa ha un valore per una determinata impostazione, il valore effettivo, che sostituisce qualsiasi valore ereditato.

  2. Se la risorsa non presenta un valore per questa impostazione della risorsa, uno dei seguenti i predecessori della risorsa hanno un valore per quella impostazione, il valore associato al predecessore più vicino è il valore effettivo.

  3. Se né questa risorsa né i relativi predecessori hanno un valore per questa risorsa che ha un valore predefinito gestito da Google, valore effettivo.

  4. Se né la risorsa né i relativi predecessori hanno un valore per questa risorsa e il valore non presenta un valore predefinito gestito da Google, non è un valore effettivo per questa impostazione su questa risorsa.

Impostazioni delle risorse senza valore effettivo

Se un'impostazione di una risorsa non ha un valore predefinito gestito da Google, possibile avere una risorsa che non ha un valore effettivo per quella dell'ambientazione. Le nuove impostazioni delle risorse non hanno valori predefiniti gestiti da Google, se presenti possibile farlo in modo compatibile con le versioni precedenti. Di conseguenza, le nuove impostazioni senza interrompere i servizi esistenti.

Valori vuoti e valori non impostati

Il valore di un'impostazione delle risorse è considerato vuoto se presenta un valore di impostazione delle risorse è vuoto. Ad esempio, "" è una stringa vuota. I valori vuoti sono comunque considerati i valori in base alla valutazione di valori effettivi dell'impostazione e e sostituisce l'ereditarietà.

Se non viene configurato alcun valore locale, l'impostazione della risorsa rimane non configurata. questa risorsa eredita il valore dell'impostazione della risorsa.

Passaggi successivi