Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar. Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # CloudWatch Beispiele für Observability Access Monitor mit AWS CLI Die folgenden Codebeispiele zeigen Ihnen, wie Sie AWS Command Line Interface mit CloudWatch Observability Access Monitor Aktionen ausführen und allgemeine Szenarien implementieren. *Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen. Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anweisungen zum Einrichten und Ausführen des Codes im Kodex finden. **Topics** + [Aktionen](#actions) ## Aktionen ### `create-link` Das folgende Codebeispiel zeigt die Verwendung `create-link` von. **AWS CLI** **Um einen Link zu erstellen** Im folgenden Beispiel für `create-link` wird eine Verknüpfung zwischen einem Quellkonto und einem Sink hergestellt, den Sie in einem Überwachungskonto erstellt haben. ``` 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 ``` Ausgabe: ``` { "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": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-link.html)in der *AWS CLI Befehlsreferenz*. ### `create-sink` Das folgende Codebeispiel zeigt die Verwendung`create-sink`. **AWS CLI** **So erstellen Sie einen Sink** Im folgenden `create-sink` Beispiel wird eine Senke in der Leistungsbilanz erstellt, sodass sie als Überwachungskonto für die CloudWatch kontenübergreifende Observability verwendet werden kann. ``` aws oam create-sink \ --name DemoSink ``` Ausgabe: ``` { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink", "Tags": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [CreateSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-sink.html)in der *AWS CLI Befehlsreferenz*. ### `delete-link` Das folgende Codebeispiel zeigt die Verwendung`delete-link`. **AWS CLI** **Um einen Link zu löschen** Im folgenden Beispiel für `delete-link` wird eine Verknüpfung zwischen einem Überwachungskonto-Sink und einem Quellkonto gelöscht. ``` aws oam delete-link \ --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-link.html)in der *AWS CLI Befehlsreferenz*. ### `delete-sink` Das folgende Codebeispiel zeigt die Verwendung`delete-sink`. **AWS CLI** **So löschen Sie einen Sink** Im folgenden Beispiel für `delete-sink` wird ein Sink gelöscht. Sie müssen alle Links zu einem Sink löschen, bevor Sie diesen löschen können. ``` aws oam delete-sink \ --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [DeleteSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-sink.html)in der *AWS CLI Befehlsreferenz*. ### `get-link` Das folgende Codebeispiel zeigt die Verwendung`get-link`. **AWS CLI** **So geben Sie die vollständigen Informationen zu einem einzelnen Link zurück** Im folgenden Beispiel für `get-link` werden komplette Informationen zu einem Link zurückgegeben. ``` aws oam get-link \ --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111 ``` Ausgabe: ``` { "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": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-link.html)in der *AWS CLI Befehlsreferenz*. ### `get-sink-policy` Das folgende Codebeispiel zeigt die Verwendung`get-sink-policy`. **AWS CLI** **So geben Sie die aktuelle Sink-Richtlinie zurück, die an den Sink angehängt ist** Im folgenden Beispiel für `get-sink-policy` wird die aktuelle Sink-Richtlinie zurückgegeben, die an den Sink angehängt ist ``` aws oam get-sink-policy \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "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\"]}}}]}" } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink-policy.html)in der *AWS CLI Befehlsreferenz*. ### `get-sink` Das folgende Codebeispiel zeigt die Verwendung`get-sink`. **AWS CLI** **So geben Sie die vollständigen Informationen über einen einzelnen Überwachungskonto-Sink zurück** Im folgenden Beispiel für `get-sink` werden komplette Informationen zu einem Überwachungskonto-Sink zurückgegeben. ``` aws oam get-sink \ --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink", "Tags": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [GetSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink.html)in der *AWS CLI Befehlsreferenz*. ### `list-attached-links` Das folgende Codebeispiel zeigt die Verwendung`list-attached-links`. **AWS CLI** **So geben Sie eine Liste der Quellkonto-Links zurück, die mit diesem Überwachungskonto-Sink verknüpft sind** Im folgenden Beispiel für `list-attached-links` wird eine Liste von Quellkonten-Links zurückgegeben, die mit diesem Überwachungskonto-Sink verknüpft sind. ``` aws oam list-attached-links \ --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "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" ] }] } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListAttachedLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-attached-links.html)in der *AWS CLI Befehlsreferenz*. ### `list-links` Das folgende Codebeispiel zeigt die Verwendung`list-links`. **AWS CLI** **So geben Sie eine Liste mit Links für einen Überwachungskonto-Sink zurück** Im folgenden Beispiel für `list-links` wird eine Liste von Links für einen Überwachungskonto-Sink zurückgegeben. Führen Sie diese Operation in einem Quellkonto aus, um eine Liste der Links zu Überwachungskonto-Sinks zurückzugeben, die dieses Quellkonto besitzt. ``` aws oam list-links ``` Ausgabe: ``` { "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" }] } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-links.html)in der *AWS CLI Befehlsreferenz*. ### `list-sinks` Das folgende Codebeispiel zeigt die Verwendung`list-sinks`. **AWS CLI** **So geben Sie die Liste der Sinks zurück, die im Überwachungskonto erstellt wurden** Im folgenden Beispiel für `list-sinks` wird eine Liste von Sinks zurückgegeben, die im Überwachungskonto erstellt wurden. Führen Sie diese Operation in einem Überwachungskonto aus. ``` aws oam list-sinks ``` Ausgabe: ``` { "Items": [ { "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345", "Id": "a1b2c3d4-5678-90ab-cdef-example12345", "Name": "DemoSink" } ] } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListSinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-sinks.html)in der *AWS CLI Befehlsreferenz*. ### `list-tags-for-resource` Das folgende Codebeispiel zeigt die Verwendung`list-tags-for-resource`. **AWS CLI** **So zeigen Sie die Tags an, die einer Ressource zugeordnet sind** Im folgenden Beispiel für `list-tags-for-resource` werden die Tags angezeigt, die einem Sink zugeordnet sind. ``` aws oam list-tags-for-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 ``` Ausgabe: ``` { "Tags": { "Team": "Devops" } } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-tags-for-resource.html)in der *AWS CLI Befehlsreferenz*. ### `put-sink-policy` Das folgende Codebeispiel zeigt die Verwendung`put-sink-policy`. **AWS CLI** **So erstellen oder aktualisieren Sie eine Ressourcenrichtlinie** Im folgenden Beispiel für `put-sink-policy` wird die Ressourcenrichtlinie erstellt, die Quellkonten berechtigt, eine Verbindung zum Überwachungskonto-Sink herzustellen. ``` 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 ``` Ausgabe: ``` { "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\"]}}}]}" } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [PutSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/put-sink-policy.html)in der *AWS CLI Befehlsreferenz*. ### `tag-resource` Das folgende Codebeispiel zeigt die Verwendung`tag-resource`. **AWS CLI** **So weisen Sie der angegebenen Ressource einen oder mehrere Tags zu** Im folgenden Beispiel für `tag-resource` wird ein Sink `arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345` mit einem Tag versehen. ``` aws oam tag-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345 \ --tags team=Devops ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/tag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `untag-resource` Das folgende Codebeispiel zeigt die Verwendung`untag-resource`. **AWS CLI** **So entfernen Sie einzelne oder mehrere Tags aus der angegebenen Ressource.** Im folgenden Beispiel für `untag-resource` wird ein Tag mit dem Schlüssel `team` aus dem Sink `arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345` entfernt. ``` aws oam untag-resource \ --resource-arn arn:aws:oam:us-east-2:123456789012:sink/f3f42f60-f0f2-425c-1234-12347bdd821f \ --tag-keys team ``` Mit diesem Befehl wird keine Ausgabe zurückgegeben. Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/untag-resource.html)in der *AWS CLI Befehlsreferenz*. ### `update-link` Das folgende Codebeispiel zeigt die Verwendung`update-link`. **AWS CLI** **So ändern Sie, welche Datentypen von einem Quellkonto an den zugehörigen Überwachungskonto-Sink weitergegeben werden** Im folgenden Beispiel für `update-link` wird der Link `arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0` mit den Ressourcentypen `AWS::CloudWatch::Metric` und `AWS::Logs::LogGroup` aktualisiert. ``` 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" ``` Ausgabe: ``` { "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": {} } ``` Weitere Informationen finden Sie unter [CloudWatch kontoübergreifende Beobachtbarkeit](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) im * CloudWatch Amazon-Benutzerhandbuch*. + Einzelheiten zur API finden Sie [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/update-link.html)in der *AWS CLI Befehlsreferenz*.