AWS::ResourceGroups::Generic AWS::AppRegistry::Application AWS::CloudFormation::Stack AWS::EC2::CapacityReservationPool AWS::EC2::HostManagement AWS::NetworkFirewall::RuleGroup

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.

`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-types

Ce 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 A Configuration avec ce paramètre et cette valeur est requis lorsque la configuration du service contient également un type Configuration ofAWS::EC2::HostManagement. Cela garantit que le HostManagement groupe ne peut contenir que des hôtes EC2 dédiés Amazon.
- AWS::EC2::CapacityReservation— Un A Configuration avec ce paramètre et cette valeur est requis lorsque la configuration du service contient également un Configuration élément de typeAWS::EC2::CapacityReservationPool. Cela garantit qu'un CapacityReservation groupe 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-protection

Ce 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 autre Configuration élément portant le nom Type deAWS::EC2::HostManagement.

L'exemple suivant active la protection contre la suppression pour le groupe, sauf si le groupe 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 AWS 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.

Name

Ce 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

Arn

Ce 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 : validesARN.

Obligatoire : oui

Note

Pour modifier l'un de ces éléments, vous devez modifier l'application à l'aide de la AppRegistry console ou des AWS CLI opérations AWS SDK 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 AWS 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 AWS 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

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 AWS 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 AWS 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.

Name

Ce paramètre indique le nom convivial de la AWS 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 AWS CloudFormation service pour un nom de pile.

Obligatoire : oui

Arn

Ce paramètre spécifie le chemin Amazon Resource Name (ARN) de la AWS CloudFormation pile attachée à l'application dans AppRegistry.

Type de données des valeurs : Chaîne

Valeurs autorisées : validesARN.

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 équivalent AWS SDK et AWS CLI des 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 en utilisant AWS Resource Access Manager. Cela vous permet de lancer une EC2 instance Amazon en utilisant ce groupe de ressources comme valeur pour le 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. 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::Generic type avec un seul paramètre :
- Le paramètre allowed-resource-types et une valeur unique deAWS::EC2::CapacityReservation. Cela garantit que seules les réservations EC2 de capacité Amazon peuvent être membres du groupe de ressources.

L'AWS::EC2::CapacityReservationPoolélément d'une configuration de groupe ne prend en charge aucun paramètre.

L'exemple suivant montre à quoi ressemble la Configuration section d'un tel groupe.


[
    {
        "Type": "AWS::EC2::CapacityReservationPool"
    },
    {
        "Type": "AWS::ResourceGroups::Generic",
        "Parameters": [
            {
                "Name": "allowed-resource-types",
                "Values": [ "AWS::EC2::CapacityReservation" ]
            }
        ]
    }
]

`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.

Un AWS::ResourceGroups::Generic type, avec un paramètre allowed-resource-types et 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::Generic type, avec un paramètre deletion-protection et 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-host

Ce 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 la section Comprendre le placement automatique et l'affinité 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-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-host

Ce 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-families

Ce 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'EC2instance Amazon valideC4, 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-configurations

Ce paramètre spécifie les chemins Amazon Resource Name (ARN) d'une ou de plusieurs configurations de licence basées sur le noyau/le socket que vous souhaitez appliquer aux membres du groupe.

Type de données de valeurs : un tableau deARNs.

Valeurs autorisées : chacune doit être une configuration de License Manager valideARN.

Obligatoire : selon les conditions. Vous devez spécifier soit ce paramètreany-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-configuration

Ce 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 basées sur le noyau/le socket 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 que vous 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ètreallowed-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 basée sur le noyau/le socket.
```
[
    {
        "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 le nom 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 AWS SDK opération.

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 Parameters pris 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"
    }
}

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Configurations de service

Création de groupes