Panoramica delle impostazioni delle risorse

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

Impostazioni risorse

Le impostazioni delle risorse rappresentano una dimensione di una risorsa o di un servizio Google Cloud che puoi configurare. Ad esempio, l'impostazione del percorso di creazione dei 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à della chiave:

  • Nome: un identificatore univoco a livello globale per l'impostazione, utilizzato durante la configurazione dei valori per un'impostazione.

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

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

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

    • Sola lettura: un flag che indica se Google ha reso di sola lettura questa impostazione. Se un'impostazione della risorsa è di sola lettura, i valori per questa impostazione non possono essere modificati. Un'impostazione è in sola lettura per le migrazioni e i ritiri. Google fornisce un avviso prima di modificare 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 una determinata organizzazione, cartella o progetto, devi disporre del ruolo Visualizzatore impostazioni risorse o Amministratore impostazioni risorse. Per maggiori dettagli su questi ruoli, vedi Autorizzazioni richieste.

La disponibilità dell'impostazione delle risorse può variare da un'organizzazione all'altra, a seconda dello stato 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 della 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 di 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 relativa dell'impostazione settings/compute-vmStartupImage precedente per organizations/12345678901 è organizations/12345678901/settings/compute-vmStartupImage.

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

Valori impostazioni locali

Il valore dell'impostazione che viene applicato direttamente a una particolare 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 è riportata un'impostazione della risorsa di esempio 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 dell'impostazione

Il valore dell'impostazione locale per una risorsa viene ereditato da tutti i relativi discendenti nella gerarchia delle risorse. Se uno di questi discendenti ha un valore di impostazione locale, questo sostituisce il valore dell'impostazione ereditata. Se non hai impostato un valore di impostazione locale su una risorsa o sui suoi discendenti, viene utilizzato l'impostazione predefinita definita da Google per l'impostazione.

Le impostazioni della risorsa vengono valutate e il risultato è il valore effettivo dell'impostazione. Questo valore mostra il risultato finale di tutte le impostazioni di ereditarietà e valore locale per una determinata risorsa. Le regole per determinare il valore effettivo dell'impostazione vengono valutate come segue:

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

  2. Se la risorsa non ha un valore per questa impostazione, se uno dei predecessori della risorsa ha un valore per questa 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 impostazione della risorsa e l'impostazione ha un valore predefinito gestito da Google, si tratta del valore effettivo.

  4. Se né la risorsa né i relativi predecessori hanno un valore per questa impostazione della risorsa 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 della risorsa non ha un valore predefinito gestito da Google, è possibile avere una risorsa che non ha 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. Pertanto, le nuove impostazioni non interrompono i servizi esistenti.

Valori vuoti e valori non impostati

Un valore di impostazione della risorsa è considerato vuoto se contiene un valore vuoto. Ad esempio, "" è una stringa vuota. I valori vuoti vengono comunque considerati in base alla valutazione dei valori di impostazione effettivi e sostituiscono l'ereditarietà.

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

Passaggi successivi