Descripción general de la configuración de recursos

Puede usar la Configuración de recursos para establecer la configuración de forma centralizada en sus proyectos, carpetas y organización de Google Cloud. Esta configuración se hereda por sus descendientes en jerarquía de recursos. Cada parámetro de configuración creadas y administradas por Google.

Configuración de recursos

La configuración de recursos representa una dimensión de un recurso o servicio de Google Cloud que puedes configurar. Por ejemplo, una configuración de ubicación de creación de buckets de Cloud Storage podría determinar la ubicación predeterminada en la que se crean los recursos de buckets nuevos.

Cada configuración de recursos tiene las siguientes propiedades clave:

  • Nombre: Un identificador global único para la configuración que se usa en la configuración de los valores de un parámetro.

  • Metadatos: La información administrada por Google sobre la configuración de recursos. Los metadatos de una configuración de recursos incluyen los siguientes campos:

    • Tipo de datos: Es el tipo de valores que se pueden configurar para este parámetro. Los tipos de datos posibles incluyen booleanos, cadenas, conjuntos de cadenas y enums.

    • Valor predeterminado: El valor predeterminado administrado por Google de la configuración, si no hay ningún valor otro valor se establezca en tu organización.

    • Solo lectura: Una marca que indica si Google estableció este parámetro de configuración. es de solo lectura. Si una configuración de recurso es de solo lectura, los valores de esta configuración no se pueden modificar. Un parámetro de configuración es de solo lectura para migraciones y bajas de nivel de servicio. Google muestra una advertencia antes de hacer un cambio en esta marca.

  • Valor local: El valor específico de una configuración asociada con un recurso.

  • Valor efectivo: Es el valor de un parámetro de configuración después de evaluar la configuración heredada. la configuración de los recursos desde la jerarquía de recursos.

Necesitas el Visualizador de configuración de recursos o el Administrador de configuración de recursos. rol de Identity and Access Management para ver la lista de parámetros de configuración disponibles para usar en un organización, carpeta o proyecto. Para obtener más información sobre estos roles, consulta Permisos necesarios.

La disponibilidad de la configuración de recursos puede variar entre organizaciones, dependiendo de del archivo de configuración del recurso.

Ejemplo de configuración de recursos

El siguiente es un ejemplo de cómo aparece la configuración de un recurso:

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

Nombre

Una configuración de recursos tiene un nombre corto único a nivel global en el formato settings/SETTING_ID. Por ejemplo, el nombre corto de una configuración de recursos para controlar la imagen de inicio inicial de una máquina virtual podría ser settings/compute-vmStartupImage.

El nombre de recurso relativo de un parámetro de configuración agrega el ID de recurso numérico al estableciendo nombre corto. Por ejemplo, el nombre de recurso relativo del anterior El parámetro de configuración de settings/compute-vmStartupImage para organizations/12345678901 es organizations/12345678901/settings/compute-vmStartupImage.

Google Cloud considera que los parámetros de configuración con el mismo nombre corto son idénticos. incluso si tienen diferentes nombres de recursos relativos. El recurso incluido en Un nombre de recurso relativo solo indica la disponibilidad de ese parámetro de configuración recurso con nombre.

Valores de configuración locales

El valor de configuración que se aplica directamente a la configuración de un recurso en particular es llamado valor de la configuración local. Puedes modificar directamente el valor local de un la configuración de recursos API de Resource Settings.

El siguiente es un ejemplo de configuración de recursos que incluye un parámetro de configuración local valor:

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

Valores de configuración efectivos

Todas las instancias de ese recurso heredan el valor de configuración local de un recurso. elementos subordinados en la jerarquía de recursos. Si uno de estos elementos subordinados tiene un valor de configuración local, este anula el de configuración heredado. Si no estableciste un valor de configuración local en un recurso o cualquiera de sus elementos subordinados, el valor predeterminado definido por Google para esa configuración y control sobre el uso de sus datos.

Se evalúa la configuración del recurso y el resultado es el valor de configuración efectivo. Este valor muestra el resultado final de toda la herencia y el valor local configuración en un recurso determinado. Las reglas para determinar el escenario efectivo se evalúan de la siguiente manera:

  1. Si un recurso tiene un valor para una configuración de recursos determinada, ese es el valor un valor efectivo que anula cualquier valor heredado.

  2. Si el recurso no tiene un valor para esta configuración de recurso, si alguna de los principales del recurso tienen un valor para ese parámetro de configuración; luego, el valor asociado con el principal más cercano es el valor efectivo.

  3. Si ni este recurso ni sus elementos principales tienen un valor para este recurso y el parámetro tiene un valor predeterminado administrado por Google, ese es el un valor efectivo.

  4. Si ni el recurso ni sus elementos principales tienen un valor para este recurso y el valor no tiene un valor predeterminado administrado por Google, no es un valor efectivo para esta configuración en este recurso.

Configuración de recursos sin valor efectivo

Si una configuración de recursos no tiene un valor predeterminado administrado por Google, entonces posible tener un recurso que no tiene un valor efectivo para ese del lugar. Si es así, la nueva configuración de recursos no tiene una configuración predeterminada administrada por Google posible hacerlo de una manera compatible con versiones anteriores. Por lo tanto, hay una nueva configuración no interrumpan los servicios existentes.

Valores vacíos y no establecidos

Un valor de configuración de recurso se considera vacío si tiene un valor de configuración de recursos. que está vacío. Por ejemplo: "" es una cadena vacía. Los valores vacíos siguen considerado valores de acuerdo con la evaluación de valores de establecimiento eficaces y anular la herencia.

Si no se establece ningún valor local, la configuración de recursos permanece sin establecer; este recurso hereda el valor de configuración del recurso.

¿Qué sigue?