Ressources d'enregistrement avec AWS CLI - AWS Config

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.

Ressources d'enregistrement avec AWS CLI

Vous pouvez utiliser le AWS CLI pour sélectionner les types de ressources que vous AWS Config souhaitez enregistrer. Pour cela, créez un enregistreur de configuration, qui enregistre les types de ressources que vous spécifiez dans un groupe d'enregistrement. Dans le groupe d'enregistrement, vous spécifiez si vous souhaitez enregistrer tous les types de ressources pris en charge ou si vous souhaitez inclure ou exclure des types de ressources spécifiques.

Record all current and future supported resource types

Configuré AWS Config pour enregistrer les modifications de configuration pour tous les types de ressources pris en charge actuels et futurs dans cette région. Pour plus d'informations, consultez Types de ressources pris en charge.

  1. Utilisez la commande put-configuration-recorder suivante :

    $ aws configservice put-configuration-recorder \ --configuration-recorder file://configurationRecorder.json \ --recording-group file://recordingGroup.json

    Cette commande utilise les ---recording-group champs --configuration-recorder et.

    Note

    Groupe d'enregistrement et enregistreur de configuration

    Le champ --recording-group indique les types de ressources enregistrés.

    Le --configuration-recorder champ indique name et roleArn la fréquence d'enregistrement par défaut pour l'enregistreur de configuration (recordingMode). Vous pouvez également utiliser ce champ pour remplacer la fréquence d’enregistrement de types de ressources spécifiques.

    1. put-configuration-recorder utilise les champs suivants pour le paramètre --recording-group :

      • allSupported=true— AWS Config enregistre les modifications de configuration pour tous les types de ressources pris en charge, à l'exception IAM des types de ressources globaux. Lorsque AWS Config la prise en charge d'un nouveau type de ressource est ajoutée, AWS Config commence à enregistrer automatiquement les ressources de ce type.

      • includeGlobalResourceTypes=true— Cette option est un ensemble qui s'applique uniquement aux types de IAM ressources globaux : IAM utilisateurs, groupes, rôles et politiques gérées par le client. Ces types de IAM ressources globaux ne peuvent être enregistrés que AWS Config dans les régions où AWS Config ils étaient disponibles avant février 2022. Vous ne pouvez pas enregistrer les types de IAM ressources globaux dans les régions prises en charge AWS Config après février 2022. Pour une liste de ces régions, voir AWS Ressources d'enregistrement | Ressources mondiales.

        Important

        Les clusters globaux Aurora sont enregistrés dans toutes les régions activées

        Le type de AWS::RDS::GlobalCluster ressource sera enregistré dans toutes les AWS Config régions prises en charge où l'enregistreur de configuration est activé, même s'il n'includeGlobalResourceTypesest pas défini surtrue. L'includeGlobalResourceTypesoption est un ensemble qui s'applique uniquement aux IAM utilisateurs, aux groupes, aux rôles et aux politiques gérées par le client.

        Si vous ne souhaitez pas enregistrer AWS::RDS::GlobalCluster dans toutes les régions activées, utilisez l'une des politiques d'enregistrement suivantes :

        1. Enregistrer tous les types de ressources actuels et futurs, à l’exception des types que vous spécifiez (EXCLUSION_BY_RESOURCE_TYPES), ou

        2. Enregistrer des types de ressources spécifiques (INCLUSION_BY_RESOURCE_TYPES).

        Pour plus d’informations, consultez Sélection des ressources qui sont enregistrées | Ressources régionales et mondiales.

        Important

        includeGlobalResourceLes types et la stratégie d'enregistrement des exclusions

        Le includeGlobalResourceTypes champ n'a aucun impact sur la stratégie EXCLUSION_BY_RESOURCE_TYPES d'enregistrement. Cela signifie que les types de IAM ressources globaux (IAMutilisateurs, groupes, rôles et politiques gérées par le client) ne seront pas automatiquement ajoutés en tant qu'exclusions pour le exclusionByResourceTypes moment includeGlobalResourceTypes défini surfalse.

        Le includeGlobalResourceTypes champ ne doit être utilisé que pour modifier le AllSupported champ, car le champ par défaut est d'enregistrer les AllSupported modifications de configuration pour tous les types de ressources pris en charge, à l'exception IAM des types de ressources globaux. Pour inclure les types de IAM ressources globaux lorsque AllSupported ce paramètre est défini surtrue, assurez-vous de le includeGlobalResourceTypes définir surtrue.

        Pour exclure les types de IAM ressources globaux pour la stratégie EXCLUSION_BY_RESOURCE_TYPES d'enregistrement, vous devez les ajouter manuellement resourceTypes dans le champ deexclusionByResourceTypes.

        Note

        Champs obligatoires et facultatifs

        Avant de définir includeGlobalResourceTypes sur true, définissez le champ allSupported sur true.

        Vous pouvez éventuellement définir le champ useOnly de RecordingStrategy sur ALL_SUPPORTED_RESOURCE_TYPES (facultatif).

        Note

        Champs de remplacement

        Si vous définissez cette includeGlobalResourceTypes option, false mais que vous listez les types de IAM ressources globaux dans le resourceTypes champ de RecordingGroup, les modifications de configuration pour les types de ressources spécifiés AWS Config seront toujours enregistrées, que vous ayez défini le includeGlobalResourceTypes champ sur false ou non.

        Si vous ne souhaitez pas enregistrer les modifications de configuration apportées aux types de IAM ressources globaux (IAMutilisateurs, groupes, rôles et politiques gérées par le client), veillez à ne pas les répertorier dans le resourceTypes champ en plus de définir le includeGlobalResourceTypes champ sur false.

      Le fichier recordingGroup.json spécifie les types de ressources qui seront enregistrés par AWS Config .

      { "allSupported": true, "recordingStrategy": { "useOnly": "ALL_SUPPORTED_RESOURCE_TYPES" }, "includeGlobalResourceTypes": true }
    2. put-configuration-recorder utilise les champs suivants pour le paramètre --configuration-recorder :

      • name— Nom de l'enregistreur de configuration. AWS Config attribue automatiquement le nom « par défaut » lors de la création de l'enregistreur de configuration.

      • roleARN— Amazon Resource Name (ARN) du IAM rôle assumé AWS Config et utilisé par l'enregistreur de configuration.

      • recordingMode— Spécifie la fréquence d'enregistrement par défaut AWS Config utilisée pour enregistrer les modifications de configuration. AWS Config prend en charge l'enregistrement continu et l'enregistrement quotidien. L’enregistrement en continu vous permet d’enregistrer les modifications de configuration en continu, chaque fois qu’un changement a lieu. L’enregistrement quotidien vous permet de recevoir un élément de configuration représentant l’état le plus récent de vos ressources au cours des dernières 24 heures, uniquement s’il diffère de l’élément de configuration enregistré précédemment.

        • recordingFrequency— Fréquence d'enregistrement par défaut AWS Config utilisée pour enregistrer les modifications de configuration.

          Note

          AWS Firewall Manager dépend de l'enregistrement continu pour surveiller vos ressources. Si vous utilisez Firewall Manager, il est recommandé de définir la fréquence d’enregistrement sur Continu.

        • recordingModeOverrides : ce champ vous permet de définir vos exclusions pour le mode d’enregistrement. Il s’agit d’un tableau d’objets recordingModeOverride. Chaque objet recordingModeOverride du tableau recordingModeOverrides comprend trois champs :

          • description : description que vous fournissez pour l’exclusion.

          • recordingFrequency : fréquence d’enregistrement qui sera appliquée à tous les types de ressources spécifiés dans l’exclusion.

          • resourceTypes— Une liste séparée par des virgules qui indique les types de ressources AWS Config inclus dans la dérogation.

      Note

      Champs obligatoires et facultatifs

      Le champ recordingMode pour put-configuration-recorder est facultatif. Par défaut, la fréquence d’enregistrement de l’enregistreur de configuration est définie sur Enregistrement en continu.

      Note

      Restrictions

      L’enregistrement quotidien ne prend pas en charge les types de ressources suivants :

      • AWS::Config::ResourceCompliance

      • AWS::Config::ConformancePackCompliance

      • AWS::Config::ConfigurationRecorder

      Pour la stratégie d’enregistrement Enregistrer tous les types de ressources actuels et futurs pris en charge (ALL_SUPPORTED_RESOURCE_TYPES), ces types de ressources seront définis sur Enregistrement en continu.

      Le configurationRecorder.json fichier spécifie name et roleArn la fréquence d'enregistrement par défaut pour l'enregistreur de configuration (recordingMode). Vous pouvez également utiliser ce champ pour remplacer la fréquence d’enregistrement de types de ressources spécifiques.

      { "name": "default", "roleARN": "arn:aws:iam::123456789012:role/config-role", "recordingMode": { "recordingFrequency": CONTINUOUS or DAILY, "recordingModeOverrides": [ { "description": "Description you provide for the override", "recordingFrequency": CONTINUOUS or DAILY, "resourceTypes": [ Comma-separated list of resource types to include in the override ] } ] } }
  2. (Facultatif) Pour vérifier que votre enregistreur de configuration présente les paramètres souhaités, utilisez la commande describe-configuration-recorders.

    $ aws configservice describe-configuration-recorders

    Voici un exemple de réponse.

    { "ConfigurationRecorders": [ { "name": "default" "recordingGroup": { "allSupported": true, "exclusionByResourceTypes": { "resourceTypes": [] }, "includeGlobalResourceTypes": true, "recordingStrategy": { "useOnly": "ALL_SUPPORTED_RESOURCE_TYPES" }, "resourceTypes": [], }, "recordingMode": { "recordingFrequency": CONTINUOUS or DAILY, "recordingModeOverrides": [ { "description": "Description you provide for the override, "recordingFrequency": CONTINUOUS or DAILY, "resourceTypes": [ Comma-separated list of resource types to include in the override] } ] }, "roleARN": "arn:aws:iam::123456789012:role/config-role" } ] }
Record all current and future supported resources types excluding the types you specify

Configurez AWS Config pour enregistrer les modifications de configuration pour tous les types de ressources pris en charge actuels et futurs, y compris les types de ressources globaux, à l'exception des types de ressources que vous spécifiez pour exclure de l'enregistrement. Si vous choisissez d'arrêter l'enregistrement pour un type de ressource, les éléments de configuration déjà enregistrés resteront inchangés. Pour plus d'informations, consultez Types de ressources pris en charge.

Cette commande utilise les ---recording-group champs --configuration-recorder et.

$ aws configservice put-configuration-recorder \ --configuration-recorder file://configurationRecorder.json \ --recording-group file://recordingGroup.json
Note

Groupe d'enregistrement et enregistreur de configuration

Le champ --recording-group indique les types de ressources enregistrés.

Le --configuration-recorder champ indique name et roleArn la fréquence d'enregistrement par défaut pour l'enregistreur de configuration (recordingMode). Vous pouvez également utiliser ce champ pour remplacer la fréquence d’enregistrement de types de ressources spécifiques.

  1. Utilisez la commande put-configuration-recorder et spécifiez un ou plusieurs types de ressources à exclure dans le champ resourceTypes de exclusionByResourceTypes, comme indiqué dans l'exemple suivant.

    1. Le fichier recordingGroup.json spécifie les types de ressources qui seront enregistrés par AWS Config .

      { "allSupported": false, "exclusionByResourceTypes": { "resourceTypes": [ "AWS::Redshift::ClusterSnapshot", "AWS::RDS::DBClusterSnapshot", "AWS::CloudFront::StreamingDistribution" ] }, "includeGlobalResourceTypes": false, "recordingStrategy": { "useOnly": "EXCLUSION_BY_RESOURCE_TYPES" }, }

      Avant de pouvoir spécifier les types de ressources à exclure de l'enregistrement :

      • Vous devez définir les champs allSupported et includeGlobalResourceTypes du paramètre --recording-group sur false ou les omettre.

      • Vous devez définir le champ useOnly de RecordingStrategy sur EXCLUSION_BY_RESOURCE_TYPES.

      Note

      Champs de remplacement

      Si vous choisissez EXCLUSION_BY_RESOURCE_TYPES pour la politique d'enregistrement, le champ exclusionByResourceTypes remplacera les autres propriétés de la requête.

      Par exemple, même si vous définissez includeGlobalResourceTypes la valeur sur false, les types de IAM ressources globaux seront toujours automatiquement enregistrés dans cette option, sauf si ces types de ressources sont spécifiquement répertoriés en tant qu'exclusions dans le resourceTypes champ deexclusionByResourceTypes.

      Note

      Types de ressources globales et politique d'enregistrement des exclusions de ressources

      Par défaut, si vous choisissez la stratégie EXCLUSION_BY_RESOURCE_TYPES d'enregistrement, when AWS Config ajoute la prise en charge d'un nouveau type de ressource dans la région où vous avez configuré l'enregistreur de configuration, y compris les types de ressources globaux, AWS Config commence à enregistrer automatiquement les ressources de ce type.

      Sauf mention contraire dans la liste des exclusions, ils AWS::RDS::GlobalCluster seront enregistrés automatiquement dans toutes les AWS Config régions prises en charge où l'enregistreur de configuration est activé.

      IAMles utilisateurs, les groupes, les rôles et les politiques gérées par le client seront enregistrés dans la région dans laquelle vous avez configuré l'enregistreur de configuration s'il AWS Config s'agit d'une région disponible avant février 2022. Vous ne pouvez pas enregistrer les types de IAM ressources globaux dans les régions prises en charge AWS Config après février 2022. Pour une liste de ces régions, voir AWS Ressources d'enregistrement | Ressources mondiales.

    2. put-configuration-recorder utilise les champs suivants pour le paramètre --configuration-recorder :

      • name— Nom de l'enregistreur de configuration. AWS Config attribue automatiquement le nom « par défaut » lors de la création de l'enregistreur de configuration.

      • roleARN— Amazon Resource Name (ARN) du IAM rôle assumé AWS Config et utilisé par l'enregistreur de configuration.

      • recordingMode— Spécifie la fréquence d'enregistrement par défaut AWS Config utilisée pour enregistrer les modifications de configuration. AWS Config prend en charge l'enregistrement continu et l'enregistrement quotidien. L’enregistrement en continu vous permet d’enregistrer les modifications de configuration en continu, chaque fois qu’un changement a lieu. L’enregistrement quotidien vous permet de recevoir un élément de configuration représentant l’état le plus récent de vos ressources au cours des dernières 24 heures, uniquement s’il diffère de l’élément de configuration enregistré précédemment.

        • recordingFrequency— Fréquence d'enregistrement par défaut AWS Config utilisée pour enregistrer les modifications de configuration.

          Note

          AWS Firewall Manager dépend de l'enregistrement continu pour surveiller vos ressources. Si vous utilisez Firewall Manager, il est recommandé de définir la fréquence d’enregistrement sur Continu.

        • recordingModeOverrides : ce champ vous permet de définir vos exclusions pour le mode d’enregistrement. Il s’agit d’un tableau d’objets recordingModeOverride. Chaque objet recordingModeOverride du tableau recordingModeOverrides comprend trois champs :

          • description : description que vous fournissez pour l’exclusion.

          • recordingFrequency : fréquence d’enregistrement qui sera appliquée à tous les types de ressources spécifiés dans l’exclusion.

          • resourceTypes— Une liste séparée par des virgules qui indique les types de ressources AWS Config inclus dans la dérogation.

      Note

      Champs obligatoires et facultatifs

      Le champ recordingMode pour put-configuration-recorder est facultatif. Par défaut, la fréquence d’enregistrement de l’enregistreur de configuration est définie sur Enregistrement en continu.

      Note

      Restrictions

      L’enregistrement quotidien ne prend pas en charge les types de ressources suivants :

      • AWS::Config::ResourceCompliance

      • AWS::Config::ConformancePackCompliance

      • AWS::Config::ConfigurationRecorder

      Pour la stratégie d’enregistrement Enregistrer tous les types de ressources actuels et futurs pris en charge (ALL_SUPPORTED_RESOURCE_TYPES), ces types de ressources seront définis sur Enregistrement en continu.

      Le configurationRecorder.json fichier spécifie name et roleArn la fréquence d'enregistrement par défaut pour l'enregistreur de configuration (recordingMode). Vous pouvez également utiliser ce champ pour remplacer la fréquence d’enregistrement de types de ressources spécifiques.

      { "name": "default", "roleARN": "arn:aws:iam::123456789012:role/config-role", "recordingMode": { "recordingFrequency": CONTINUOUS or DAILY, "recordingModeOverrides": [ { "description": "Description you provide for the override", "recordingFrequency": CONTINUOUS or DAILY, "resourceTypes": [ Comma-separated list of resource types to include in the override ] } ] } }
  2. (Facultatif) Pour vérifier que votre enregistreur de configuration présente les paramètres souhaités, utilisez la commande describe-configuration-recorders.

    $ aws configservice describe-configuration-recorders

    Voici un exemple de réponse.

    { "ConfigurationRecorders": [ { "name": "default", "recordingGroup": { "allSupported": false, "exclusionByResourceTypes": { "resourceTypes": [ "AWS::Redshift::ClusterSnapshot", "AWS::RDS::DBClusterSnapshot", "AWS::CloudFront::StreamingDistribution" ] }, "includeGlobalResourceTypes": false, "recordingStrategy": { "useOnly": "EXCLUSION_BY_RESOURCE_TYPES" }, "resourceTypes": [], }, "recordingMode": { "recordingFrequency": CONTINUOUS or DAILY, "recordingModeOverrides": [ { "description": "Description you provide for the override, "recordingFrequency": CONTINUOUS or DAILY, "resourceTypes": [ Comma-separated list of resource types to include in the override] } ] }, "roleARN": "arn:aws:iam::123456789012:role/config-role" } ] }
Record specific resource types

Configurez AWS Config pour enregistrer les modifications de configuration uniquement pour les types de ressources que vous spécifiez. Si vous choisissez d'arrêter l'enregistrement pour un type de ressource, les éléments de configuration déjà enregistrés resteront inchangés.

Cette commande utilise les ---recording-group champs --configuration-recorder et.

$ aws configservice put-configuration-recorder \ --configuration-recorder file://configurationRecorder.json \ --recording-group file://recordingGroup.json
Note

Groupe d'enregistrement et enregistreur de configuration

Le champ --recording-group indique les types de ressources enregistrés.

Le --configuration-recorder champ indique name et roleArn la fréquence d'enregistrement par défaut pour l'enregistreur de configuration (recordingMode). Vous pouvez également utiliser ce champ pour remplacer la fréquence d’enregistrement de types de ressources spécifiques.

  1. Utilisez la commande put-configuration-recorder et spécifiez un ou plusieurs types de ressources dans le champ resourceTypes de recordingGroup, comme indiqué dans l'exemple suivant.

    1. Le fichier recordingGroup.json spécifie les types de ressources qui seront enregistrés par AWS Config .

      { "allSupported": false, "recordingStrategy": { "useOnly": "INCLUSION_BY_RESOURCE_TYPES" }, "includeGlobalResourceTypes": false, "resourceTypes": [ "AWS::EC2::EIP", "AWS::EC2::Instance", "AWS::EC2::NetworkAcl", "AWS::EC2::SecurityGroup", "AWS::CloudTrail::Trail", "AWS::EC2::Volume", "AWS::EC2::VPC", "AWS::IAM::User", "AWS::IAM::Policy" ] }
      Note

      Champs obligatoires et facultatifs

      Avant de pouvoir spécifier les types de ressources à inclure dans l'enregistrement, vous devez définir les champs allSupported et includeGlobalResourceTypes sur false ou les omettre.

      Le champ recordingStrategy est facultatif lorsque vous répertoriez les types de ressources dans le champ resourceTypes de --recording-group.

      Note

      Disponibilité dans les Régions

      Avant de spécifier un type de ressource AWS Config à suivre, vérifiez la disponibilité des ressources par région pour voir si le type de ressource est pris en charge dans la AWS région où vous l'avez configuré AWS Config. Si un type de ressource est pris AWS Config en charge par au moins une région, vous pouvez activer l'enregistrement de ce type de ressource dans toutes les régions prises en charge AWS Config, même si le type de ressource spécifié n'est pas pris en charge dans la AWS région où vous l'avez configuré AWS Config.

    2. put-configuration-recorder utilise les champs suivants pour le paramètre --configuration-recorder :

      • name— Nom de l'enregistreur de configuration. AWS Config attribue automatiquement le nom « par défaut » lors de la création de l'enregistreur de configuration.

      • roleARN— Amazon Resource Name (ARN) du IAM rôle assumé AWS Config et utilisé par l'enregistreur de configuration.

      • recordingMode— Spécifie la fréquence d'enregistrement par défaut AWS Config utilisée pour enregistrer les modifications de configuration. AWS Config prend en charge l'enregistrement continu et l'enregistrement quotidien. L’enregistrement en continu vous permet d’enregistrer les modifications de configuration en continu, chaque fois qu’un changement a lieu. L’enregistrement quotidien vous permet de recevoir un élément de configuration représentant l’état le plus récent de vos ressources au cours des dernières 24 heures, uniquement s’il diffère de l’élément de configuration enregistré précédemment.

        • recordingFrequency— Fréquence d'enregistrement par défaut AWS Config utilisée pour enregistrer les modifications de configuration.

          Note

          AWS Firewall Manager dépend de l'enregistrement continu pour surveiller vos ressources. Si vous utilisez Firewall Manager, il est recommandé de définir la fréquence d’enregistrement sur Continu.

        • recordingModeOverrides : ce champ vous permet de définir vos exclusions pour le mode d’enregistrement. Il s’agit d’un tableau d’objets recordingModeOverride. Chaque objet recordingModeOverride du tableau recordingModeOverrides comprend trois champs :

          • description : description que vous fournissez pour l’exclusion.

          • recordingFrequency : fréquence d’enregistrement qui sera appliquée à tous les types de ressources spécifiés dans l’exclusion.

          • resourceTypes— Une liste séparée par des virgules qui indique les types de ressources AWS Config inclus dans la dérogation.

      Note

      Champs obligatoires et facultatifs

      Le champ recordingMode pour put-configuration-recorder est facultatif. Par défaut, la fréquence d’enregistrement de l’enregistreur de configuration est définie sur Enregistrement en continu.

      Note

      Restrictions

      L’enregistrement quotidien ne prend pas en charge les types de ressources suivants :

      • AWS::Config::ResourceCompliance

      • AWS::Config::ConformancePackCompliance

      • AWS::Config::ConfigurationRecorder

      Pour la stratégie d’enregistrement Enregistrer tous les types de ressources actuels et futurs pris en charge (ALL_SUPPORTED_RESOURCE_TYPES), ces types de ressources seront définis sur Enregistrement en continu.

      Le configurationRecorder.json fichier spécifie name et roleArn la fréquence d'enregistrement par défaut pour l'enregistreur de configuration (recordingMode). Vous pouvez également utiliser ce champ pour remplacer la fréquence d’enregistrement de types de ressources spécifiques.

      { "name": "default", "roleARN": "arn:aws:iam::123456789012:role/config-role", "recordingMode": { "recordingFrequency": CONTINUOUS or DAILY, "recordingModeOverrides": [ { "description": "Description you provide for the override", "recordingFrequency": CONTINUOUS or DAILY, "resourceTypes": [ Comma-separated list of resource types to include in the override ] } ] } }
  2. (Facultatif) Pour vérifier que votre enregistreur de configuration présente les paramètres souhaités, utilisez la commande describe-configuration-recorders.

    $ aws configservice describe-configuration-recorders

    Voici un exemple de réponse.

    { "ConfigurationRecorders": [ { "name": "default", "recordingGroup": { "allSupported": false, "exclusionByResourceTypes": { "resourceTypes": [] }, "includeGlobalResourceTypes": false "recordingStrategy": { "useOnly": "INCLUSION_BY_RESOURCE_TYPES" }, "resourceTypes": [ "AWS::EC2::EIP", "AWS::EC2::Instance", "AWS::EC2::NetworkAcl", "AWS::EC2::SecurityGroup", "AWS::CloudTrail::Trail", "AWS::EC2::Volume", "AWS::EC2::VPC", "AWS::IAM::User", "AWS::IAM::Policy" ] }, "recordingMode": { "recordingFrequency": CONTINUOUS or DAILY, "recordingModeOverrides": [ { "description": "Description you provide for the override, "recordingFrequency": CONTINUOUS or DAILY, "resourceTypes": [ Comma-separated list of resource types to include in the override] } ] }, "roleARN": "arn:aws:iam::123456789012:role/config-role" } ] }