Présentation des paramètres de ressources

Vous pouvez utiliser les paramètres des ressources pour configurer les paramètres de vos projets, dossiers et organisation Google Cloud de manière centralisée. Ces paramètres sont hérités par leurs descendants dans la hiérarchie des ressources. Chaque paramètre est créé et géré par Google.

Paramètres de ressources

Les paramètres de ressources représentent une dimension d'une ressource ou d'un service Google Cloud que vous pouvez configurer. Par exemple, un paramètre d'emplacement de création de bucket Cloud Storage peut déterminer l'emplacement par défaut où les ressources de bucket sont créées.

Chaque paramètre de ressource possède les propriétés clés suivantes :

  • Nom : identifiant global unique du paramètre utilisé lors de la configuration des valeurs d'un paramètre.

  • Métadonnées : informations gérées par Google pour le paramètre de ressource. Les métadonnées d'un paramètre de ressource incluent les champs suivants :

    • Type de données : type de valeurs pouvant être configurées pour ce paramètre. Les types de données de données possibles incluent des valeurs booléennes, des chaînes, des ensembles de chaînes et des énumérations.

    • Valeur par défaut : valeur par défaut du paramètre gérée par Google si aucune autre valeur n'est définie dans votre organisation.

    • Lecture seule : option indiquant si Google a défini ce paramètre en lecture seule. Si un paramètre de ressource est en lecture seule, les valeurs de ce paramètre ne peuvent pas être modifiées. Un paramètre n'est passé en lecture seule que pour les migrations et les abandons. Google fournit un avertissement avant la modification de cette option.

  • Valeur locale : valeur spécifique d'un paramètre associé à une ressource.

  • Valeur effective : valeur d'un paramètre après l'évaluation des paramètres de ressources hérités de la hiérarchie des ressources.

Vous devez disposer du rôle Identity and Access Management Lecteur des paramètres de ressource ou Administrateur des paramètres de ressources pour afficher la liste des paramètres disponibles pour une organisation, un dossier ou un projet spécifique. Pour en savoir plus sur ces rôles, consultez la section Autorisations requises.

La disponibilité des paramètres de ressource peut varier d'une organisation à l'autre, en fonction de l'état de publication du paramètre de ressource.

Exemple de paramètre de ressource

Voici un exemple de paramètre de ressource :

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

Dénomination

Un paramètre de ressource possède un nom court globalement unique, au format settings/SETTING_ID. Par exemple, le nom court d'un paramètre de ressource permettant de contrôler l'image de démarrage initiale pour une machine virtuelle peut être settings/compute-vmStartupImage.

Le nom de ressource relatif d'un paramètre ajoute l'ID numérique de la ressource au nom court du paramètre. Par exemple, le nom de ressource relatif du paramètre settings/compute-vmStartupImage ci-dessus pour organizations/12345678901 est organizations/12345678901/settings/compute-vmStartupImage.

Les paramètres portant le même nom court sont considérés comme identiques par Google Cloud, même s'ils ont des noms de ressources relatifs différents. La ressource incluse dans un nom de ressource relatif indique uniquement la disponibilité de ce paramètre dans la ressource nommée.

Valeurs des paramètres locaux

La valeur de paramètre appliquée directement à un paramètre de ressource particulier est appelée valeur de paramètre local. Vous pouvez modifier directement la valeur locale d'un paramètre de ressource à l'aide de l'API Resource Settings.

Voici un exemple de paramètre de ressource qui inclut une valeur de paramètre local :

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

Valeurs de paramètres effectives

La valeur du paramètre local d'une ressource est héritée par tous les descendants de cette ressource dans la hiérarchie des ressources. Si l'un de ces descendants possède une valeur de paramètre local, il remplace la valeur du paramètre hérité. Si vous n'avez pas défini de valeur de paramètre local sur une ressource ou l'un de ses descendants, le paramètre par défaut défini par Google pour ce paramètre est utilisé.

Les paramètres de ressource sont évalués et le résultat correspond à la valeur de paramètre effective. Cette valeur indique le résultat final de tous les paramètres de valeur hérités et locaux sur une ressource donnée. Les règles permettant de déterminer la valeur effective du paramètre sont évaluées comme suit :

  1. Si une ressource a une valeur pour un paramètre de ressource donné, il s'agit de la valeur effective qui remplace toute valeur héritée.

  2. Si la ressource n'a pas de valeur pour ce paramètre de ressource et que l'un des ancêtres de la ressource a une valeur pour ce paramètre, la valeur associée à l'ancêtre le plus proche est la valeur effective.

  3. Si ni cette ressource, ni ses ancêtres n'ont de valeur pour ce paramètre de ressource et que le paramètre a une valeur par défaut gérée par Google, il s'agit de la valeur effective.

  4. Si ni la ressource, ni ses ancêtres n'ont de valeur pour ce paramètre de ressource et que la valeur n'a pas de valeur par défaut gérée par Google, il n'existe aucune valeur effective pour ce paramètre sur cette ressource.

Paramètres de ressources sans valeur effective

Si un paramètre de ressource n'a pas de valeur par défaut gérée par Google, il est possible d'avoir une ressource qui n'a pas de valeur effective pour ce paramètre. Les nouveaux paramètres de ressources ne possèdent pas de valeurs par défaut gérées par Google s'il est possible de le faire de manière rétrocompatible. Par conséquent, les nouveaux paramètres n'interrompent pas les services existants.

Valeurs vides et valeurs non définies

Une valeur de paramètre de ressource est considérée comme vide si sa valeur est vide. Par exemple, "" est une chaîne vide. Les valeurs vides sont tout de même considérées comme des valeurs pour ce qui est de l'évaluation des valeurs de paramètres effectives et peuvent remplacer des valeur héritées.

Si aucune valeur locale n'est définie, le paramètre de ressource n'est pas défini. Cette ressource hérite alors de la valeur du paramètre de ressource.

Étape suivante