View a markdown version of this page

CloudWatch Esempi di Observability Access Monitor che utilizzano AWS CLI - AWS Esempi di codice SDK
Azioni

Sono disponibili altri esempi di AWS SDK nel repository AWS Doc SDK Examples. GitHub

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

CloudWatch Esempi di Observability Access Monitor che utilizzano AWS CLI

I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with CloudWatch Observability Access Monitor.

Le azioni sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.

Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.

Argomenti

Azioni

L’esempio di codice seguente mostra come utilizzare create-link.

AWS CLI

Come creare un link

L’esempio create-link seguente crea un link tra un account di origine e un sink creato in un account di monitoraggio.

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

Output:

{
    "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": {}
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command CreateLink Reference.

L’esempio di codice seguente mostra come utilizzare create-sink.

AWS CLI

Come creare un sink

L'create-sinkesempio seguente crea un sink nel conto corrente, in modo che possa essere utilizzato come conto di monitoraggio nell'osservabilità CloudWatch tra account.

aws oam create-sink \
    --name DemoSink

Output:

{
    "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Name": "DemoSink",
    "Tags": {}
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command CreateSink Reference.

L’esempio di codice seguente mostra come utilizzare delete-link.

AWS CLI

Come eliminare un link

L’esempio delete-link seguente elimina un link tra un sink dell’account di monitoraggio e un account di origine.

aws oam delete-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command DeleteLink Reference.

L’esempio di codice seguente mostra come utilizzare delete-sink.

AWS CLI

Come eliminare un sink

L’esempio delete-sink seguente elimina un sink. È necessario eliminare tutti i link a un sink prima di poterlo eliminare.

aws oam delete-sink \
    --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command DeleteSink Reference.

L’esempio di codice seguente mostra come utilizzare get-link.

AWS CLI

Come restituire informazioni complete su un link

L’esempio get-link seguente recupera le informazioni relative a un link.

aws oam get-link \
    --identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111

Output:

{
    "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": {}
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command GetLink Reference.

L’esempio di codice seguente mostra come utilizzare get-sink-policy.

AWS CLI

Come restituire l’attuale policy di sink allegata al sink

L’esempio get-sink-policy seguente restituisce la policy di sink corrente associata al sink.

aws oam get-sink-policy \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Output:

{
    "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\"]}}}]}"
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command GetSinkPolicy Reference.

L’esempio di codice seguente mostra come utilizzare get-sink.

AWS CLI

Come recuperare informazioni complete su un sink di monitoraggio tra account

L’esempio get-sink seguente restituisce informazioni complete su un sink dell’account di monitoraggio.

aws oam get-sink \
    --identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Output:

{
    "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
    "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
    "Name": "DemoSink",
    "Tags": {}
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command GetSink Reference.

L’esempio di codice seguente mostra come utilizzare list-attached-links.

AWS CLI

Come restituire un elenco di link agli account di origine collegati a questo sink di account di monitoraggio

L’esempio list-attached-links seguente restituisce un elenco di link dell’account di origine collegati al sink corrente dell’account di monitoraggio.

aws oam list-attached-links \
    --sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Output:

{
    "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"
        ]
    }]
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

L’esempio di codice seguente mostra come utilizzare list-links.

AWS CLI

Come restituire un elenco di link per un sink dell’account di monitoraggio

L’esempio list-links seguente restituisce un elenco di link per un sink dell’account di monitoraggio. Esegui questa operazione in un account di origine per restituire un elenco di link ai sink degli account di monitoraggio di questo account di origine.

aws oam list-links

Output:

{
    "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"
    }]
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command ListLinks Reference.

L’esempio di codice seguente mostra come utilizzare list-sinks.

AWS CLI

Come restituire l’elenco dei sink creati nell’account di monitoraggio

L’esempio list-sinks seguente restituisce un elenco di sink creati nell’account di monitoraggio. Esegui questa operazione in un account di monitoraggio.

aws oam list-sinks

Output:

{
    "Items": [
        {
            "Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
            "Id": "a1b2c3d4-5678-90ab-cdef-example12345",
            "Name": "DemoSink"
        }
    ]
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command ListSinks Reference.

L’esempio di codice seguente mostra come utilizzare list-tags-for-resource.

AWS CLI

Come visualizzare i tag associati a una risorsa

L’esempio list-tags-for-resource seguente visualizza i tag associati a un sink.

aws oam list-tags-for-resource \
    --resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345

Output:

{
    "Tags": {
        "Team": "Devops"
    }
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

L’esempio di codice seguente mostra come utilizzare put-sink-policy.

AWS CLI

Come creare o aggiornare una policy delle risorse

L’esempio put-sink-policy seguente crea la policy di risorse che concede le autorizzazioni agli account di origine per il link al sink dell’account di monitoraggio.

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

Output:

{
    "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\"]}}}]}"
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command PutSinkPolicy Reference.

L’esempio di codice seguente mostra come utilizzare tag-resource.

AWS CLI

Come assegnare uno o più tag a una risorsa specificata

L’esempio tag-resource seguente tagga un sink denominato 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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command TagResource Reference.

L’esempio di codice seguente mostra come utilizzare untag-resource.

AWS CLI

Come rimuovere uno o più tag dalla risorsa specificata.

L’esempio untag-resource seguente rimuove un tag con la chiave team dal sink 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

Questo comando non produce alcun output.

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon CloudWatch User Guide.

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command UntagResource Reference.

L’esempio di codice seguente mostra come utilizzare update-link.

AWS CLI

Come modificare i tipi di dati condivisi da un account di origine al relativo sink dell’account di monitoraggio collegato

L’esempio update-link seguente aggiorna il link arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0 con i tipi di risorsa AWS::CloudWatch::Metric e 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"

Output:

{
    "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": {}
}

Per ulteriori informazioni, consulta l'osservabilità CloudWatch tra account nella Amazon User Guide. CloudWatch

  • Per i dettagli sulle API, consulta la sezione AWS CLI Command UpdateLink Reference.