Panoramica delle impostazioni delle risorse

Puoi utilizzare le impostazioni delle risorse per configurare centralmente le impostazioni per i progetti, le cartelle e l'organizzazione di Google Cloud. Queste impostazioni sono ereditate dai rispettivi discendenti nella gerarchia delle risorse. Ogni impostazione viene creata e gestita da Google.

Impostazioni risorse

Le impostazioni delle risorse rappresentano una dimensione di una risorsa o un servizio Google Cloud che puoi configurare. Ad esempio, l'impostazione della località di creazione di un bucket Cloud Storage potrebbe determinare la località predefinita in cui vengono create le nuove risorse del bucket.

Ogni impostazione della risorsa ha le seguenti proprietà chiave:

  • Nome: un identificatore univoco globale per l'impostazione che viene utilizzato durante la configurazione dei valori per 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 valori booleani, stringhe, insiemi di stringhe e enum.

    • Valore predefinito: il valore predefinito gestito da Google dell'impostazione se non è impostato nessun altro valore all'interno della tua organizzazione.

    • Sola lettura: un flag che indica se Google ha reso questa impostazione di 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 deprecamenti. 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 aver valutato le impostazioni delle risorse ereditate dalla gerarchia delle risorse.

Per visualizzare l'elenco delle impostazioni disponibili per l'utilizzo in un'organizzazione, una cartella o un progetto specifici, devi disporre del ruolo Visualizzatore impostazioni risorse o Amministratore impostazioni risorse. Per maggiori dettagli su questi ruoli, consulta Autorizzazioni obbligatorie.

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

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'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 nome breve dell'impostazione. Ad esempio, il nome della risorsa relativo dell'impostazione settings/compute-vmStartupImage precedente per organizations/12345678901 è organizations/12345678901/settings/compute-vmStartupImage.

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

Valori delle impostazioni locali

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

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

# 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 discendenti della risorsa nella gerarchia delle risorse. Se uno di questi discendenti ha un valore dell'impostazione locale, sostituisce il valore dell'impostazione ereditato. Se non hai configurato un valore di impostazione locale su una risorsa o sui relativi discendenti, viene utilizzato il valore predefinito definito da Google per l'impostazione.

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

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

  2. Se la risorsa non ha un valore per questa impostazione della risorsa, se uno dei predecessori della risorsa ha un valore per tale impostazione, il valore associato al predecessore più vicino è il valore effettivo.

  3. Se né questa risorsa né i relativi predecessori presentano un valore per questa impostazione delle risorse e l'impostazione ha un valore predefinito gestito da Google, questo è il valore effettivo.

  4. Se né la risorsa né i relativi predecessori presentano un valore per questa impostazione delle risorse e il valore non ha un valore predefinito gestito da Google, non esiste 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 che abbia una risorsa che non abbia un valore effettivo per quell'impostazione. Le nuove impostazioni delle risorse non hanno valori predefiniti gestiti da Google se è possibile farlo in modo compatibile con le versioni precedenti. Di conseguenza, le nuove impostazioni non interrompono i servizi esistenti.

Valori vuoti e valori non impostati

Un valore dell'impostazione delle risorse è considerato vuoto se il relativo valore è vuoto. Ad esempio, "" è una stringa vuota. I valori vuoti vengono comunque considerati valori in base alla valutazione dei valori delle impostazioni effettive e sostituiscono l'ereditarietà.

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

Passaggi successivi