D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub . 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. # CloudWatch Exemples d'Observability Access Monitor utilisant AWS CLI Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide du moniteur AWS Command Line Interface d'accès à l' CloudWatch observabilité. Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés. Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte. **Topics** + [Actions](#actions) ## Actions ### `create-link` L'exemple de code suivant montre comment utiliser`create-link`. **AWS CLI** **Pour créer un lien** L’exemple `create-link` suivant crée un lien entre un compte source et un récepteur que vous avez créé dans un compte de surveillance. ``` aws oam create-link \ --label-template sourceAccount \ --resource-types AWS::CloudWatch::Metric \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Sortie : ``` { "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Label": "sourceAccount", "LabelTemplate": "sourceAccount", "ResourceTypes": [ "AWS::CloudWatch::Metric" ], "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Tags": {} } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-link.html)à la section *Référence des AWS CLI commandes*. ### `create-sink` L'exemple de code suivant montre comment utiliser`create-sink`. **AWS CLI** **Pour créer un récepteur** L'`create-sink`exemple suivant crée un puits dans le compte courant, afin qu'il puisse être utilisé comme compte de surveillance dans le cadre de l' CloudWatch observabilité entre comptes. ``` aws oam create-sink \ --name DemoSink ``` Sortie : ``` { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink", "Tags": {} } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [CreateSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-sink.html)à la section *Référence des AWS CLI commandes*. ### `delete-link` L'exemple de code suivant montre comment utiliser`delete-link`. **AWS CLI** **Pour supprimer un lien** L’exemple `delete-link` suivant supprime un lien entre un récepteur de compte de surveillance et un compte source. ``` aws oam delete-link \ --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-link.html)à la section *Référence des AWS CLI commandes*. ### `delete-sink` L'exemple de code suivant montre comment utiliser`delete-sink`. **AWS CLI** **Pour supprimer un récepteur** L’exemple `delete-sink` suivant supprime un récepteur. Vous devez supprimer tous les liens vers un récepteur avant de pouvoir le supprimer. ``` aws oam delete-sink \ --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [DeleteSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-sink.html)à la section *Référence des AWS CLI commandes*. ### `get-link` L'exemple de code suivant montre comment utiliser`get-link`. **AWS CLI** **Pour renvoyer des informations complètes sur un lien** L’exemple `get-link` suivant renvoie des informations complètes sur un lien. ``` aws oam get-link \ --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 ``` Sortie : ``` { "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Label": "sourceAccount", "LabelTemplate": "sourceAccount", "ResourceTypes": [ "AWS::CloudWatch::Metric" ], "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Tags": {} } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [GetLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-link.html)à la section *Référence des AWS CLI commandes*. ### `get-sink-policy` L'exemple de code suivant montre comment utiliser`get-sink-policy`. **AWS CLI** **Pour renvoyer la politique de récepteur actuelle attachée au récepteur** L’exemple `get-sink-policy` suivant renvoie la politique de récepteur actuelle attachée au récepteur. ``` aws oam get-sink-policy \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Sortie : ``` { "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345", "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}" } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [GetSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink-policy.html)à la section *Référence des AWS CLI commandes*. ### `get-sink` L'exemple de code suivant montre comment utiliser`get-sink`. **AWS CLI** **Pour renvoyer des informations complètes sur un récepteur de compte de surveillance** L’exemple `get-sink` suivant renvoie des informations complètes sur un récepteur de compte de surveillance. ``` aws oam get-sink \ --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Sortie : ``` { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink", "Tags": {} } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [GetSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink.html)à la section *Référence des AWS CLI commandes*. ### `list-attached-links` L'exemple de code suivant montre comment utiliser`list-attached-links`. **AWS CLI** **Pour renvoyer une liste des liens de comptes sources liés à ce récepteur de compte de surveillance** L’exemple `list-attached-links` suivant renvoie une liste de liens de comptes source liés à ce récepteur de compte de surveillance. ``` aws oam list-attached-links \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Sortie : ``` { "Items": [{ "Label": "Monitoring account", "LinkArn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "ResourceTypes": [ "AWS::ApplicationInsights::Application", "AWS::Logs::LogGroup", "AWS::CloudWatch::Metric", "AWS::XRay::Trace" ] }] } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [ListAttachedLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-attached-links.html)à la section *Référence des AWS CLI commandes*. ### `list-links` L'exemple de code suivant montre comment utiliser`list-links`. **AWS CLI** **Pour renvoyer une liste de liens pour un récepteur de compte de surveillance** L’exemple `list-links` suivant renvoie une liste de liens pour un récepteur de compte de surveillance. Exécutez cette opération dans un compte source pour renvoyer une liste de liens vers les récepteurs de compte de surveillance de ce compte source. ``` aws oam list-links ``` Sortie : ``` { "Items": [{ "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Label": "sourceAccount", "ResourceTypes": [ "AWS::CloudWatch::Metric" ], "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345" }] } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [ListLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-links.html)à la section *Référence des AWS CLI commandes*. ### `list-sinks` L'exemple de code suivant montre comment utiliser`list-sinks`. **AWS CLI** **Pour renvoyer la liste des récepteurs créés dans le compte de surveillance** L’exemple `list-sinks` suivant renvoie une liste des récepteurs créés dans le compte de surveillance. Exécutez cette opération dans un compte de surveillance. ``` aws oam list-sinks ``` Sortie : ``` { "Items": [ { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink" } ] } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [ListSinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-sinks.html)à la section *Référence des AWS CLI commandes*. ### `list-tags-for-resource` L'exemple de code suivant montre comment utiliser`list-tags-for-resource`. **AWS CLI** **Pour afficher les balises associées à une ressource** L’exemple `list-tags-for-resource` suivant affiche les balises associées à un récepteur. ``` aws oam list-tags-for-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Sortie : ``` { "Tags": { "Team": "Devops" } } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-tags-for-resource.html)à la section *Référence des AWS CLI commandes*. ### `put-sink-policy` L'exemple de code suivant montre comment utiliser`put-sink-policy`. **AWS CLI** **Pour créer ou mettre à jour une politique de ressources** L’exemple `put-sink-policy` suivant crée la politique de ressources qui autorise les comptes source à établir un lien avec le récepteur de compte de surveillance. ``` aws oam put-sink-policy \ --policy '{"Version":"2012-10-17", "Statement":[{"Effect":"Allow","Principal":{"AWS":"arn:aws:iam::123456789111:root"},"Action":["oam:CreateLink","oam:UpdateLink"],"Resource":"*","Condition":{"ForAllValues:StringEquals":{"oam:ResourceTypes":["AWS::Logs::LogGroup","AWS::CloudWatch::Metric","AWS::XRay::Trace","AWS::ApplicationInsights::Application"]}}}]}' \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Sortie : ``` { "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "SinkId": "a1b2c3d4-5678-90ab-cdef-example12345", "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789111:root\"},\"Action\":[\"oam:CreateLink\",\"oam:UpdateLink\"],\"Resource\":\"*\",\"Condition\":{\"ForAllValues:StringEquals\":{\"oam:ResourceTypes\":[\"AWS::Logs::LogGroup\",\"AWS::CloudWatch::Metric\",\"AWS::XRay::Trace\",\"AWS::ApplicationInsights::Application\"]}}}]}" } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [PutSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/put-sink-policy.html)à la section *Référence des AWS CLI commandes*. ### `tag-resource` L'exemple de code suivant montre comment utiliser`tag-resource`. **AWS CLI** **Pour attribuer une ou plusieurs balises à la ressource spécifiée** L’exemple `tag-resource` suivant balise un récepteur `arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345`. ``` aws oam tag-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 \ --tags team=Devops ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/tag-resource.html)à la section *Référence des AWS CLI commandes*. ### `untag-resource` L'exemple de code suivant montre comment utiliser`untag-resource`. **AWS CLI** **Pour supprimer une ou plusieurs balises de la ressource spécifiée.** L’exemple `untag-resource` suivant supprime une balise avec la clé `team` du récepteur `arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345`. ``` aws oam untag-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/f3f42f60-f0f2-425c-1234-12347bdd821f \ --tag-keys team ``` Cette commande ne produit aucune sortie. Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/untag-resource.html)à la section *Référence des AWS CLI commandes*. ### `update-link` L'exemple de code suivant montre comment utiliser`update-link`. **AWS CLI** **Pour modifier les types de données partagés entre un compte source et le récepteur de son compte de surveillance lié** L’exemple `update-link` suivant met à jour le lien `arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0` avec les types de ressources `AWS::CloudWatch::Metric` et `AWS::Logs::LogGroup`. ``` aws oam update-link \ --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 \ --resource-types "AWS::CloudWatch::Metric" "AWS::Logs::LogGroup" ``` Sortie : ``` { "Arn": "arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111", "Id": "a1b2c3d4-5678-90ab-cdef-example11111", "Label": "sourceAccount", "LabelTemplate": "sourceAccount", "ResourceTypes": [ "AWS::CloudWatch::Metric", "AWS::Logs::LogGroup" ], "SinkArn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Tags": {} } ``` Pour plus d'informations, consultez la [CloudWatch section sur l'observabilité entre comptes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) dans le guide de * CloudWatch l'utilisateur Amazon*. + Pour plus de détails sur l'API, reportez-vous [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/update-link.html)à la section *Référence des AWS CLI commandes*.