Puoi utilizzare le impostazioni delle risorse per configurare centralmente le impostazioni per progetti, cartelle e organizzazione Google Cloud. Queste impostazioni vengono ereditate dai loro discendenti nella gerarchia delle risorse. Ogni impostazione viene creata e gestita da Google.
Impostazioni risorse
Le impostazioni delle risorse rappresentano una dimensione di un servizio o risorsa Google Cloud che puoi configurare. Ad esempio, un'impostazione relativa alla località di creazione del bucket Cloud Storage potrebbe determinare la località predefinita in cui viene creata la nuova risorsa del bucket.
Ogni impostazione delle risorse ha le seguenti proprietà chiave:
Nome: un identificatore univoco globale per l'impostazione, utilizzato quando si configurano i valori per un'impostazione.
Metadati: le informazioni gestite da Google sull'impostazione delle risorse. I metadati di 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 e enum.
Valore predefinito: il valore predefinito gestito da Google dell'impostazione se non è impostato un altro valore all'interno dell'organizzazione.
Sola lettura: un flag che indica se Google ha reso di sola lettura questa impostazione. Se un'impostazione delle risorse è di sola lettura, i valori per questa impostazione non possono essere modificati. Un'impostazione viene resa di sola lettura solo 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 un'organizzazione, una cartella o un progetto specifici, devi avere il ruolo Visualizzatore impostazioni risorse o Amministratore impostazioni delle risorse per Identity and Access Management. Per maggiori dettagli su questi ruoli, consulta Autorizzazioni richieste.
La disponibilità dell'impostazione delle risorse può variare tra le organizzazioni, a seconda dello stato di rilascio dell'impostazione delle risorse.
Esempio di impostazione della risorsa
Di seguito è riportato un esempio di come appare un'impostazione di 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 delle risorse ha un nome breve univoco a livello globale, nel formato
settings/SETTING_ID. Ad esempio, il nome breve di un'impostazione di risorsa per controllare l'immagine di avvio iniziale per una macchina virtuale potrebbe essere settings/compute-vmStartupImage.
Il nome della risorsa relativa di un'impostazione aggiunge l'ID risorsa numerico al nome breve dell'impostazione. Ad esempio, il nome relativo della risorsa dell'impostazione di settings/compute-vmStartupImage sopra organizations/12345678901 è organizations/12345678901/settings/compute-vmStartupImage.
Le impostazioni con lo stesso nome breve sono considerate identiche da Google Cloud, anche se hanno nomi di risorse relativi diversi. La risorsa inclusa nel nome di una risorsa relativa indica solo la disponibilità di quell'impostazione per la risorsa denominata.
Valori delle impostazioni locali
Il valore impostato direttamente per una determinata impostazione di risorsa è chiamato valore per l'impostazione locale. Puoi modificare direttamente il valore locale di un'impostazione della risorsa utilizzando l'API Resource Settings.
Di seguito è riportato un esempio di impostazione di una risorsa 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 di impostazione effettivi
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 di impostazione locale, sostituisce il valore dell'impostazione ereditata. Se non hai impostato un valore di impostazione locale per una risorsa o uno dei suoi discendenti, viene utilizzato il valore predefinito definito da Google per questa impostazione.
Le impostazioni delle risorse 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 dell'impostazione efficace vengono valutate come segue:
Se una risorsa ha un valore per una determinata impostazione di risorsa, questo è il valore effettivo, sostituendo qualsiasi valore ereditato.
Se la risorsa non ha un valore per questa impostazione della risorsa, o se uno dei predecessori della risorsa ha un valore per quell'impostazione, il valore associato al predecessore più vicino è il valore effettivo.
Se né la risorsa né i predecessori hanno un valore per questa impostazione della risorsa e ha un'impostazione predefinita gestita da Google, allora si tratta del valore effettivo.
Se né la risorsa né i predecessori hanno un valore per questa impostazione della risorsa e non ha un valore predefinito gestito da Google, non esiste alcun valore effettivo per questa impostazione nella risorsa.
Impostazioni delle risorse senza valore effettivo
Se un'impostazione delle risorse non ha un valore predefinito gestito da Google, è possibile che abbia una risorsa che non contiene 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 non impostati
Un valore di impostazione delle risorse è considerato vuoto se ha un valore di impostazione delle risorse vuoto. Ad esempio, "" è una stringa vuota. I valori vuoti vengono comunque considerati in base alla valutazione dei valori dell'impostazione effettiva e sostituiscono l'ereditarietà.
Se il valore locale non è configurato, l'impostazione della risorsa rimane non impostata. Questa risorsa eredita il valore dell'impostazione della risorsa.
Passaggi successivi
- Per ulteriori informazioni, consulta la pagina Gestire le impostazioni delle risorse.