Panoramica delle impostazioni delle risorse

Puoi utilizzare le impostazioni delle risorse per configurare in modo centralizzato le impostazioni per i progetti, le cartelle e l'organizzazione 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 di 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 a livello globale per l'impostazione utilizzato per 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 possibili tipi di dati includono valori booleani, stringhe, insiemi di stringhe e enumerazioni.

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

    • Sola lettura: un flag che indica se Google ha effettuato questa impostazione. sola lettura. Se un'impostazione della risorsa è di sola lettura, i valori di questa impostazione non possono essere modificati. Un'impostazione viene impostata come di sola lettura solo per le migrazioni e il ritiro. 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 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 di Identity and Access Management. 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 lo 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 formatosettings/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 della risorsa relativa di un'impostazione aggiunge l'ID numerico della risorsa al nome breve dell'impostazione. Ad esempio, il nome della risorsa relativa all'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 di risorse relative diversi. La risorsa inclusa in un nome risorsa relativo indica solo la disponibilità di quella impostazione 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 della risorsa utilizzando l'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 di impostazione effettivi

Il valore dell'impostazione locale di una risorsa viene ereditato da tutti i suoi 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 suoi antenati hanno un valore per questa imposta della risorsa e l'impostazione ha un valore predefinito gestito da Google, questo è il valore effettivo.

  4. Se né la risorsa né i suoi antenati 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 in 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 impostazioni delle nuove risorse non hanno i 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 ha un valore di impostazione della risorsa 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 impostato alcun valore locale, l'impostazione della risorsa rimane non impostata; questa risorsa eredita il valore dell'impostazione della risorsa.

Passaggi successivi