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. # Utilisation de `CreateAssociation` avec une CLI Les exemples de code suivants illustrent comment utiliser `CreateAssociation`. ------ #### [ CLI ] **AWS CLI** **Exemple 1 : association d’un document à l’aide des ID d’instance** Ce qui suit `create-association` example associe un document de configuration à une instance, en utilisant des ID d'instance. ``` aws ssm create-association \ --instance-id {{"i-0cb2b964d3e14fd9f"}} \ --name {{"AWS-UpdateSSMAgent"}} ``` Sortie : ``` { "AssociationDescription": { "Status": { "Date": 1487875500.33, "Message": "Associated with AWS-UpdateSSMAgent", "Name": "Associated" }, "Name": "AWS-UpdateSSMAgent", "InstanceId": "i-0cb2b964d3e14fd9f", "Overview": { "Status": "Pending", "DetailedStatus": "Creating" }, "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DocumentVersion": "$DEFAULT", "LastUpdateAssociationDate": 1487875500.33, "Date": 1487875500.33, "Targets": [ { "Values": [ "i-0cb2b964d3e14fd9f" ], "Key": "InstanceIds" } ] } } ``` Pour plus d'informations, voir [Création d'associations](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations-creating.html) dans le *AWS Guide de l'utilisateur de Systems Manager*. **Exemple 2 : pour associer un document à l’aide des cibles** Ce qui suit `create-association` example associe un document de configuration à une instance, en utilisant des cibles. ``` aws ssm create-association \ --name {{"AWS-UpdateSSMAgent"}} \ --targets {{"Key=instanceids,Values=i-0cb2b964d3e14fd9f"}} ``` Sortie : ``` { "AssociationDescription": { "Status": { "Date": 1487875500.33, "Message": "Associated with AWS-UpdateSSMAgent", "Name": "Associated" }, "Name": "AWS-UpdateSSMAgent", "InstanceId": "i-0cb2b964d3e14fd9f", "Overview": { "Status": "Pending", "DetailedStatus": "Creating" }, "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DocumentVersion": "$DEFAULT", "LastUpdateAssociationDate": 1487875500.33, "Date": 1487875500.33, "Targets": [ { "Values": [ "i-0cb2b964d3e14fd9f" ], "Key": "InstanceIds" } ] } } ``` Pour plus d'informations, voir [Création d'associations](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations-creating.html) dans le *AWS Guide de l'utilisateur de Systems Manager*. **Exemple 3 : pour créer une association qui ne s’exécute qu’une seule fois** Ce qui suit `create-association` L'exemple crée une nouvelle association qui ne s'exécute qu'une seule fois à la date et à l'heure spécifiées. Les associations créées avec une date passée ou présente (au moment du traitement, la date est passée) sont exécutées immédiatement. ``` aws ssm create-association \ --name {{"AWS-UpdateSSMAgent"}} \ --targets {{"Key=instanceids,Values=i-0cb2b964d3e14fd9f"}} \ --schedule-expression {{"at(2020-05-14T15:55:00)"}} \ --apply-only-at-cron-interval ``` Sortie : ``` { "AssociationDescription": { "Status": { "Date": 1487875500.33, "Message": "Associated with AWS-UpdateSSMAgent", "Name": "Associated" }, "Name": "AWS-UpdateSSMAgent", "InstanceId": "i-0cb2b964d3e14fd9f", "Overview": { "Status": "Pending", "DetailedStatus": "Creating" }, "AssociationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "DocumentVersion": "$DEFAULT", "LastUpdateAssociationDate": 1487875500.33, "Date": 1487875500.33, "Targets": [ { "Values": [ "i-0cb2b964d3e14fd9f" ], "Key": "InstanceIds" } ] } } ``` Pour plus d'informations, voir [Création d'associations](https://docs.aws.amazon.com/systems-manager/latest/userguide/state-manager-associations-creating.html) et [Référence : Expressions cron et rate pour Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/reference-cron-and-rate-expressions.html) dans le *AWS Guide de l'utilisateur de Systems Manager*. + Pour plus de détails sur l'API, voir [CreateAssociation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/create-association.html) dans *AWS CLI Référence de commande*. ------ #### [ PowerShell ] **Outils pour PowerShell V4** **Exemple 1 : cet exemple associe un document de configuration à une instance, en utilisant les ID d’instance.** ``` New-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent" ``` **Sortie** : ``` Name : AWS-UpdateSSMAgent InstanceId : i-0000293ffd8c57862 Date : 2/23/2017 6:55:22 PM Status.Name : Associated Status.Date : 2/20/2015 8:31:11 AM Status.Message : Associated with AWS-UpdateSSMAgent Status.AdditionalInfo : ``` **Exemple 2 : cet exemple associe un document de configuration à une instance, en utilisant des cibles.** ``` $target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")} New-SSMAssociation -Name "AWS-UpdateSSMAgent" -Target $target ``` **Sortie** : ``` Name : AWS-UpdateSSMAgent InstanceId : Date : 3/1/2017 6:22:21 PM Status.Name : Status.Date : Status.Message : Status.AdditionalInfo : ``` **Exemple 3 : cet exemple associe un document de configuration à une instance, en utilisant des cibles et des paramètres.** ``` $target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")} $params = @{ "action"="configure" "mode"="ec2" "optionalConfigurationSource"="ssm" "optionalConfigurationLocation"="" "optionalRestart"="yes" } New-SSMAssociation -Name "Configure-CloudWatch" -AssociationName "CWConfiguration" -Target $target -Parameter $params ``` **Sortie** : ``` Name : Configure-CloudWatch InstanceId : Date : 5/17/2018 3:17:44 PM Status.Name : Status.Date : Status.Message : Status.AdditionalInfo : ``` **Exemple 4 : cet exemple crée une association avec toutes les instances de la région, avec `AWS-GatherSoftwareInventory`. Il fournit également des fichiers personnalisés et des emplacements de registre dans les paramètres à collecter** ``` $params = [Collections.Generic.Dictionary[String,Collections.Generic.List[String]]]::new() $params["windowsRegistry"] ='[{"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\MachineImage","Recursive":false,"ValueNames":["AMIName"]}]' $params["files"] = '[{"Path":"C:\Program Files","Pattern":["*.exe"],"Recursive":true}, {"Path":"C:\ProgramData","Pattern":["*.log"],"Recursive":true}]' New-SSMAssociation -AssociationName new-in-mum -Name AWS-GatherSoftwareInventory -Target @{Key="instanceids";Values="*"} -Parameter $params -region ap-south-1 -ScheduleExpression "rate(720 minutes)" ``` **Sortie** : ``` Name : AWS-GatherSoftwareInventory InstanceId : Date : 6/9/2019 8:57:56 AM Status.Name : Status.Date : Status.Message : Status.AdditionalInfo : ``` + Pour plus de détails sur l'API, voir [CreateAssociation](https://docs.aws.amazon.com/powershell/v4/reference) dans *Outils AWS pour PowerShell Référence de l'applet de commande (V4)*. **Outils pour PowerShell V5** **Exemple 1 : cet exemple associe un document de configuration à une instance, en utilisant les ID d’instance.** ``` New-SSMAssociation -InstanceId "i-0cb2b964d3e14fd9f" -Name "AWS-UpdateSSMAgent" ``` **Sortie** : ``` Name : AWS-UpdateSSMAgent InstanceId : i-0000293ffd8c57862 Date : 2/23/2017 6:55:22 PM Status.Name : Associated Status.Date : 2/20/2015 8:31:11 AM Status.Message : Associated with AWS-UpdateSSMAgent Status.AdditionalInfo : ``` **Exemple 2 : cet exemple associe un document de configuration à une instance, en utilisant des cibles.** ``` $target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")} New-SSMAssociation -Name "AWS-UpdateSSMAgent" -Target $target ``` **Sortie** : ``` Name : AWS-UpdateSSMAgent InstanceId : Date : 3/1/2017 6:22:21 PM Status.Name : Status.Date : Status.Message : Status.AdditionalInfo : ``` **Exemple 3 : cet exemple associe un document de configuration à une instance, en utilisant des cibles et des paramètres.** ``` $target = @{Key="instanceids";Values=@("i-0cb2b964d3e14fd9f")} $params = @{ "action"="configure" "mode"="ec2" "optionalConfigurationSource"="ssm" "optionalConfigurationLocation"="" "optionalRestart"="yes" } New-SSMAssociation -Name "Configure-CloudWatch" -AssociationName "CWConfiguration" -Target $target -Parameter $params ``` **Sortie** : ``` Name : Configure-CloudWatch InstanceId : Date : 5/17/2018 3:17:44 PM Status.Name : Status.Date : Status.Message : Status.AdditionalInfo : ``` **Exemple 4 : cet exemple crée une association avec toutes les instances de la région, avec `AWS-GatherSoftwareInventory`. Il fournit également des fichiers personnalisés et des emplacements de registre dans les paramètres à collecter** ``` $params = [Collections.Generic.Dictionary[String,Collections.Generic.List[String]]]::new() $params["windowsRegistry"] ='[{"Path":"HKEY_LOCAL_MACHINE\SOFTWARE\Amazon\MachineImage","Recursive":false,"ValueNames":["AMIName"]}]' $params["files"] = '[{"Path":"C:\Program Files","Pattern":["*.exe"],"Recursive":true}, {"Path":"C:\ProgramData","Pattern":["*.log"],"Recursive":true}]' New-SSMAssociation -AssociationName new-in-mum -Name AWS-GatherSoftwareInventory -Target @{Key="instanceids";Values="*"} -Parameter $params -region ap-south-1 -ScheduleExpression "rate(720 minutes)" ``` **Sortie** : ``` Name : AWS-GatherSoftwareInventory InstanceId : Date : 6/9/2019 8:57:56 AM Status.Name : Status.Date : Status.Message : Status.AdditionalInfo : ``` + Pour plus de détails sur l'API, voir [CreateAssociation](https://docs.aws.amazon.com/powershell/v5/reference) dans *Outils AWS pour PowerShell Référence de l'applet de commande (V5)*. ------ Pour une liste complète des AWS Guides du développeur du SDK et exemples de code, voir [L'utilisation de ce service avec AWS Kit SDK](sdk-general-information-section.md). Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.