Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Types et paramètres de configuration pris en charge
Resource Groups prend en charge l'utilisation des types de configuration suivants. Chaque type de configuration possède un ensemble de paramètres valides pour ce type.
Rubriques
AWS::ResourceGroups::Generic
Ce type de configuration spécifie les paramètres qui appliquent les exigences d'adhésion au groupe de ressources, plutôt que de configurer le comportement d'un type de ressource spécifique pour un AWS service. Ce type de configuration est automatiquement ajouté par les groupes liés aux services qui en ont besoin, tels que les types AWS::EC2::CapacityReservationPool etAWS::EC2::HostManagment.
Les éléments suivants Parameters sont valides pour le groupe AWS::ResourceGroups::Generic lié à un service. Type
-
allowed-resource-typesCe paramètre indique que le groupe de ressources ne peut être composé que de ressources du ou des types spécifiés.
Type de données des valeurs : Chaîne
Valeurs autorisées :
-
AWS::EC2::Host— Un AConfigurationavec ce paramètre et cette valeur est requis lorsque la configuration du service contient également un typeConfigurationofAWS::EC2::HostManagement. Cela garantit que leHostManagementgroupe ne peut contenir que des hôtes EC2 dédiés Amazon. -
AWS::EC2::CapacityReservation— Un AConfigurationavec ce paramètre et cette valeur est requis lorsque la configuration du service contient également unConfigurationélément de typeAWS::EC2::CapacityReservationPool. Cela garantit qu'unCapacityReservationgroupe ne peut contenir que des EC2 capacités de réservation d'Amazon.
Obligatoire : conditionnel, basé sur d'autres
Configurationéléments attachés au groupe de ressources. Consultez l'entrée précédente pour les valeurs autorisées.L'exemple suivant limite les membres du groupe aux seules instances EC2 hôtes Amazon.
[ { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::Host" ] } ] } ] -
-
deletion-protectionCe paramètre indique que le groupe de ressources ne peut être supprimé que s'il ne contient aucun membre. Pour plus d'informations, voir Supprimer un groupe de ressources hôtes dans le Guide de l'utilisateur de License Manager
Type de données de valeurs : Tableau de chaînes
Valeurs autorisées : La seule valeur autorisée est
[ "UNLESS_EMPTY" ](la valeur doit être en majuscules).Obligatoire : conditionnel, basé sur d'autres
Configurationéléments attachés au groupe de ressources. Ce paramètre n'est obligatoire que lorsque le groupe de ressources possède également un autreConfigurationélément portant le nomTypedeAWS::EC2::HostManagement.L'exemple suivant active la protection contre la suppression pour le groupe, sauf si celui-ci ne compte aucun membre.
[ { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "deletion-protection", "Values": [ "UNLESS_EMPTY" ] } ] } ]
AWS::AppRegistry::Application
Ce Configuration type indique que le groupe de ressources représente une application créée par AWS Service Catalog AppRegistry.
Les groupes de ressources de ce type sont entièrement gérés par le AppRegistry service et ne peuvent être créés, mis à jour ou supprimés par les utilisateurs qu'à l'aide des outils fournis par AppRegistry.
Note
Étant donné que les groupes de ressources de ce type sont automatiquement créés et gérés par l'utilisateur AWS et ne sont pas gérés par celui-ci, ils ne sont pas pris en compte dans votre limite de quota pour le nombre maximum de groupes de ressources que vous pouvez créer dans votre Compte AWS
Pour plus d'informations, consultez la section Utilisation AppRegistry dans le Guide de l'utilisateur du Service Catalog.
Lors de la AppRegistry création d'un groupe de ressources lié à un service de ce type, il crée également automatiquement un groupe CloudFormation lié à un service distinct et supplémentaire pour chaque AWS CloudFormation pile associée à l'application.
AppRegistry nomme automatiquement les groupes liés à un service de ce type qu'il crée avec le préfixe AWS_AppRegistry_Application- suivi du nom de l'application : AWS_AppRegistry_Application-MyAppName
Les paramètres suivants sont pris en charge pour le type de groupe AWS::AppRegistry::Application lié à un service.
-
NameCe paramètre spécifie le nom convivial de l'application qui a été attribué par l'utilisateur lors de sa création dans AppRegistry.
Type de données des valeurs : Chaîne
Valeurs autorisées : toute chaîne de texte autorisée par le AppRegistry service pour le nom d'une application.
Obligatoire : oui
-
ArnCe paramètre spécifie le chemin Amazon Resource Name (ARN) de l'application attribué par AppRegistry.
Type de données des valeurs : Chaîne
Valeurs autorisées : un ARN valide.
Obligatoire : oui
Note
Pour modifier l'un de ces éléments, vous devez modifier l'application à l'aide de la AppRegistry console ou du AWS SDK et des AWS CLI opérations de ce service.
Ce groupe de ressources d'applications inclut automatiquement en tant que membres du groupe les groupes de ressources créés pour les CloudFormation piles associées à l' AppRegistry application. Vous pouvez utiliser cette ListGroupResourcesopération pour voir ces groupes d'enfants.
L'exemple suivant montre à quoi ressemble la section de configuration d'un groupe AWS::AppRegistry::Application lié à un service.
[ { "Type": "AWS::AppRegistry::Application", "Parameters": [ { "Name": "Name", "Values": [ "MyApplication" ] }, { "Name": "Arn", "Values": [ "arn:aws:servicecatalog:us-east-1:123456789012:/applications/<application-id>" ] } ] } ]
AWS::CloudFormation::Stack
Ce Configuration type indique que le groupe représente une AWS CloudFormation pile et que ses membres sont les AWS ressources créées par cette pile.
Les groupes de ressources de ce type sont automatiquement créés pour vous lorsque vous CloudFormation associez une pile au AppRegistry service. Vous ne pouvez pas créer, mettre à jour ou supprimer ces groupes si ce n'est en utilisant les outils fournis par AppRegistry.
AppRegistry nomme automatiquement les groupes liés à un service de ce type qu'il crée avec le préfixe AWS_CloudFormation_Stack- suivi du nom de la pile : AWS_CloudFormation_Stack-MyStackName
Note
Étant donné que les groupes de ressources de ce type sont automatiquement créés et gérés par l'utilisateur AWS et ne sont pas gérés par celui-ci, ils ne sont pas pris en compte dans votre limite de quota pour le nombre maximum de groupes de ressources que vous pouvez créer dans votre Compte AWS
Pour plus d'informations, consultez la section Utilisation AppRegistry dans le Guide de l'utilisateur du Service Catalog.
AppRegistry crée automatiquement un groupe de ressources lié à un service de ce type pour chaque CloudFormation pile que vous associez à l' AppRegistry application. Ces groupes de ressources deviennent des membres enfants du groupe de ressources parent de l' AppRegistryapplication.
Les membres de ce groupe de CloudFormation ressources sont les AWS ressources créées dans le cadre de la pile.
Les paramètres suivants sont pris en charge pour le type de groupe AWS::CloudFormation::Stack lié à un service.
-
NameCe paramètre indique le nom convivial de la CloudFormation pile attribué par l'utilisateur lors de sa création.
Type de données des valeurs : Chaîne
Valeurs autorisées : toute chaîne de texte autorisée par le CloudFormation service pour un nom de pile.
Obligatoire : oui
-
ArnCe paramètre spécifie le chemin Amazon Resource Name (ARN) de la CloudFormation pile attachée à l'application dans AppRegistry.
Type de données des valeurs : Chaîne
Valeurs autorisées : un ARN valide.
Obligatoire : oui
Note
Pour modifier l'un de ces éléments, vous devez modifier l'application à l'aide de la AppRegistry console ou d'un AWS SDK équivalent et d' AWS CLI opérations.
L'exemple suivant montre à quoi ressemble la section de configuration d'un groupe AWS::CloudFormation::Stack lié à un service.
[ { "Type": "AWS::CloudFormation::Stack", "Parameters": [ { "Name": "Name", "Values": [ "MyStack" ] }, { "Name": "Arn", "Values": [ "arn:aws:cloudformation:us-east-1:123456789012:stack/MyStack/<stack-id>" ] } ] } ]
AWS::EC2::CapacityReservationPool
Ce Configuration type indique que le groupe de ressources représente un pool commun de capacités fourni par les membres du groupe. Les membres de ce groupe de ressources doivent obligatoirement effectuer des réservations de EC2 capacité auprès d'Amazon. Un groupe de ressources peut inclure à la fois des réservations de capacité que vous possédez sur votre compte et des réservations de capacité partagées avec vous à partir d'autres comptes à l'aide de AWS Resource Access Manager. Cela vous permet de lancer une EC2 instance Amazon en utilisant ce groupe de ressources comme valeur du paramètre de réservation de capacité. Dans ce cas, l'instance utilise la capacité réservée disponible dans le groupe.
Si le groupe de ressources n'a aucune capacité disponible, l'instance est lancée en tant qu'instance autonome à la demande en dehors du pool, sauf si vous configurez le groupe de ressources pour utiliser Amazon EC2 UltraServer Capacity Blocks. Pour plus d'informations, consultez la section Travailler avec des groupes de réservation de capacité dans le guide de EC2 l'utilisateur Amazon.
Si vous configurez un groupe de ressources lié à un service avec un Configuration élément de ce type, vous devez également spécifier des Configuration éléments distincts avec les valeurs suivantes :
-
Un
AWS::ResourceGroups::Generictype avec un seul paramètre :-
Le paramètre
allowed-resource-typeset une valeur unique deAWS::EC2::CapacityReservation. Cela garantit que seules les réservations EC2 de capacité Amazon peuvent être membres du groupe de ressources.
-
-
AWS::EC2::CapacityReservationPoolType avec deux paramètres :-
reservation-type— Nécessaire uniquement lorsque vous configurez un groupe de réservation de capacité pour Amazon EC2 UltraServer Capacity Blocks. La seule valeur autorisée dans ce champ estcapacity-block. -
instance-type— Nécessaire uniquement lorsque vous configurez un groupe de réservation de capacité pour Amazon EC2 UltraServer Capacity Blocks. Les valeurs autorisées dans ce champ sonttrn2u.48xlargeetp6e-gb200.36xlarge.
-
L'exemple suivant montre la Configuration section d'une réservation de capacité à la demande :
{ "Configuration": [ { "Type": "AWS::EC2::CapacityReservationPool", "Parameters": [] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::CapacityReservation" ] } ] } ] }
L'exemple suivant montre la Configuration section prenant en charge les Amazon EC2 UltraServer Capacity Blocks :
{ "Configuration": [ { "Type": "AWS::EC2::CapacityReservationPool", "Parameters": [ { "Name": "instance-type", "Values": [ "trn2u.48xlarge" ] }, { "Name": "reservation-type", "Values": [ "capacity-block" ] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::CapacityReservation" ] } ] } ] }
Après avoir ajouté instance-type et reservation-type à une configuration de groupe de ressources lorsque vous utilisez Amazon EC2 UltraServer Capacity Blocks, les comportements suivants s'appliquent à ce groupe de ressources :
-
Vous pouvez ajouter des réservations de capacité supplémentaires dans cette configuration de groupe de ressources, mais les réservations supplémentaires doivent également
reservation-typecomporter les valeurs set tocapacity-blocketinstance-typeset totrn2u.48xlargeou.p6e-gb200.48xlarge -
Actuellement, la seule valeur autorisée pour
reservation-typeestcapacity-block, et les seules valeurs autoriséesinstance-typesonttrn2u.48xlargeet.p6e-gb200.48xlarge -
Vous ne pouvez pas ajouter Amazon EC2 Capacity Blocks for ML dans un groupe de ressources qui n'inclut pas les
instance-typeconfigurationsreservation-typeet. -
L'ajout des paramètres
reservation-typeetcapacity-blockde configuration ne modifie pas le processus d'ajout ou de suppression de réservations de groupe. -
Si vous supprimez la réservation de capacité du groupe, ou si vous supprimez le groupe, les réservations au sein du groupe restent utilisées jusqu'à ce que les instances soient résiliées.
-
Actuellement, les groupes de ressources dotés des paramètres
instance-typede configurationreservation-typeet ne peuvent pas être mis à jour après la configuration initiale. Pour modifier ou supprimer la configuration, vous devez supprimer le groupe, puis créer un nouveau groupe avec de nouvelles configurations. -
Vous ne pouvez pas lancer une instance dans un groupe vide ou modifier une instance pour cibler un groupe vide.
AWS::EC2::HostManagement
Cet identifiant spécifie les paramètres de gestion des EC2 hôtes Amazon et AWS License Manager qui sont appliqués aux membres du groupe. Pour plus d'informations, consultez la section Groupes de ressources hôtes dans AWS License Manager.
Si vous configurez un groupe de ressources lié à un service avec un Configuration élément de ce type, vous devez également spécifier des Configuration éléments distincts avec les valeurs suivantes :
-
Un
AWS::ResourceGroups::Generictype, avec un paramètreallowed-resource-typeset une valeur unique deAWS::EC2::Host. Cela garantit que seuls les hôtes EC2 dédiés Amazon peuvent être membres du groupe. -
Un
AWS::ResourceGroups::Generictype, avec un paramètredeletion-protectionet une valeur unique deUNLESS_EMPTY. Cela garantit que le groupe ne peut être supprimé que s'il est vide.
Les paramètres suivants sont pris en charge pour le type de groupe AWS::EC2::HostManagement lié à un service.
-
auto-allocate-hostCe paramètre indique si les instances sont lancées sur un hôte dédié spécifique ou sur un hôte disponible doté d'une configuration correspondante. Pour plus d'informations, consultez Comprendre le placement automatique et l'affinité dans le guide de l' EC2 utilisateur Amazon.
Type de données des valeurs : booléen
Valeurs autorisées : « vrai » ou « faux » (doit être en minuscules).
Obligatoire : non
[ { "Type": "AWS::EC2::HostManagement", "Parameters": [ { "Name": "auto-allocate-host", "Values": [ "true" ] }, { "Name": "any-host-based-license-configuration", "Values": [ "true" ] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::Host" ] }, { "Name": "deletion-protection", "Values": [ "UNLESS_EMPTY" ] } ] } ] -
auto-release-hostCe paramètre indique si un hôte dédié du groupe est automatiquement libéré après l'arrêt de sa dernière instance en cours d'exécution. Pour plus d'informations, consultez la section Releasing Dedicated Hosts dans le guide de EC2 l'utilisateur Amazon.
Type de données des valeurs : booléen
Valeurs autorisées : « vrai » ou « faux » (doit être en minuscules).
Obligatoire : non
[ { "Type": "AWS::EC2::HostManagement", "Parameters": [ { "Name": "auto-release-host", "Values": [ "false" ] }, { "Name": "any-host-based-license-configuration", "Values": [ "true" ] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::Host" ] }, { "Name": "deletion-protection", "Values": [ "UNLESS_EMPTY" ] } ] } ] -
allowed-host-familiesCe paramètre indique quelles familles de types d'instances peuvent être utilisées par les instances membres de ce groupe.
Type de données de valeurs : un tableau de chaînes.
Valeurs autorisées : chacune doit être un identifiant de famille de type d' EC2 instance Amazon valide
C4, tel queM5,P3dn, ouR5d.Obligatoire : non
L'exemple d'élément de configuration suivant indique que les instances lancées ne peuvent être membres que des familles de types d'instances C5 ou M5.
[ { "Type": "AWS::EC2::HostManagement", "Parameters": [ { "Name": "allowed-host-families", "Values": [ "c5", "m5" ] }, { "Name": "any-host-based-license-configuration", "Values": [ "true" ] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::Host" ] }, { "Name": "deletion-protection", "Values": [ "UNLESS_EMPTY" ] } ] } ] -
allowed-host-based-license-configurationsCe paramètre spécifie les chemins Amazon Resource Name (ARN) d'une ou de plusieurs configurations de licence core/socket basées que vous souhaitez appliquer aux membres du groupe.
Type de données de valeurs : un tableau de ARNs.
Valeurs autorisées : chacune doit être un ARN de configuration License Manager valide.
Obligatoire : selon les conditions. Vous devez spécifier soit ce paramètre
any-host-based-license-configuration, soit les deux. Ils s'excluent mutuellement.L'exemple d'élément de configuration suivant indique que les membres du groupe peuvent utiliser les deux configurations de License Manager spécifiées.
[ { "Type": "AWS::EC2::HostManagement", "Parameters": [ { "Name": "allowed-host-based-license-configurations", "Values": [ "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111", "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-8a786a26f50ba416eb658EXAMPLE2222" ] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::Host" ] }, { "Name": "deletion-protection", "Values": [ "UNLESS_EMPTY" ] } ] } ] -
any-host-based-license-configurationCe paramètre indique que vous ne souhaitez pas associer une configuration de licence spécifique à votre groupe. Dans ce cas, toutes les configurations de licence core/socket basées sont disponibles pour les membres de votre groupe de ressources hôte. Utilisez ce paramètre si vous disposez d'un nombre illimité de licences et souhaitez optimiser l'utilisation de l'hôte.
Type de données des valeurs : booléen
Valeurs autorisées : « vrai » ou « faux » (doit être en minuscules).
Obligatoire : selon les conditions. Vous devez spécifier soit ce paramètre
allowed-host-based-license-configurations, soit les deux. Ils s'excluent mutuellement.L'exemple d'élément de configuration suivant indique que les membres du groupe peuvent utiliser n'importe quelle configuration de licence core/socket basée.
[ { "Type": "AWS::EC2::HostManagement", "Parameters": [ { "Name": "any-host-based-license-configuration", "Values": [ "true" ] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::Host" ] }, { "Name": "deletion-protection", "Values": [ "UNLESS_EMPTY" ] } ] } ]
L'exemple suivant montre comment inclure tous les paramètres de gestion de l'hôte dans une configuration unique.
[ { "Type": "AWS::EC2::HostManagement", "Parameters": [ { "Name": "auto-allocate-host", "Values": [ "true" ] }, { "Name": "auto-release-host", "Values": [ "false" ] }, { "Name": "allowed-host-families", "Values": [ "c5", "m5" ] }, { "Name": "allowed-host-based-license-configurations", "Values": [ "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-6eb6586f508a786a2ba41EXAMPLE1111", "arn:aws:license-manager:us-west-2:123456789012:license-configuration:lic-8a786a26f50ba416eb658EXAMPLE2222" ] } ] }, { "Type": "AWS::ResourceGroups::Generic", "Parameters": [ { "Name": "allowed-resource-types", "Values": [ "AWS::EC2::Host" ] }, { "Name": "deletion-protection", "Values": [ "UNLESS_EMPTY" ] } ] } ]
AWS::NetworkFirewall::RuleGroup
Cet identifiant spécifie les paramètres des groupes de AWS Network Firewall règles qui sont appliqués aux membres du groupe. Les administrateurs de pare-feu peuvent spécifier l'ARN d'un groupe de ressources de ce type afin de résoudre automatiquement les adresses IP des membres du groupe pour une règle de pare-feu au lieu d'avoir à répertorier chaque adresse manuellement. Pour plus d'informations, consultez la section Utilisation de groupes de ressources basés sur des balises dans AWS Network Firewall.
Vous pouvez créer des groupes de ressources de ce type de configuration à l'aide de la console Network Firewall ou en exécutant une AWS CLI commande ou une opération du AWS SDK.
Les groupes de ressources de ce type de configuration sont soumis aux restrictions suivantes :
-
Les membres du groupe se composent uniquement de ressources dont les types sont pris en charge par Network Firewall.
-
Le groupe doit contenir une requête basée sur des balises pour gérer les membres du groupe ; toutes les ressources des types pris en charge dont les balises correspondent à la requête sont automatiquement membres du groupe.
-
Ce type de configuration n'est pas
Parameterspris en charge. -
Pour supprimer un groupe de ressources de ce type de configuration, aucun groupe de règles Network Firewall ne peut le référencer.
L'exemple suivant illustre les ResourceQuery sections Configuration et pour un groupe de ce type.
{ "Configuration": [ { "Type": "AWS::NetworkFirewall::RuleGroup", "Parameters": [] } ], "ResourceQuery": { "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"environment\",\"Values\":[\"production\"]}]}", "Type": "TAG_FILTERS_1_0" } }
L'exemple de AWS CLI commande suivant crée un groupe de ressources avec la configuration et la requête précédentes.
$aws resource-groups create-group \ --name test-group \ --resource-query '{"Type": "TAG_FILTERS_1_0", "Query": "{\"ResourceTypeFilters\": [\"AWS::EC2::Instance\"], \"TagFilters\": [{\"Key\": \"environment\", \"Values\": [\"production\"]}]}"}' \ --configuration '[{"Type": "AWS::NetworkFirewall::RuleGroup", "Parameters": []}]'{ "Group":{ "GroupArn":"arn:aws:resource-groups:us-west-2:123456789012:group/test-group", "Name":"test-group", "OwnerId":"123456789012" }, "Configuration": [ { "Type": "AWS::NetworkFirewall::RuleGroup", "Parameters": [] } ], "ResourceQuery": { "Query": "{\"ResourceTypeFilters\":[\"AWS::EC2::Instance\"],\"TagFilters\":[{\"Key\":\"environment\",\"Values\":[\"production\"]}]}", "Type": "TAG_FILTERS_1_0" } }