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 utilizzando 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.
**Topics**
+ [Azioni](#actions)
## Azioni
### `create-link`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-link.html)Reference*.
### `create-sink`
Il seguente esempio di codice mostra come utilizzare`create-sink`.
**AWS CLI**
**Come creare un sink**
L'`create-sink`esempio seguente crea un sink nell'account corrente, in modo che possa essere utilizzato come account 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [CreateSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-sink.html)Reference*.
### `delete-link`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-link.html)Reference*.
### `delete-sink`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [DeleteSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-sink.html)Reference*.
### `get-link`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [GetLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-link.html)Reference*.
### `get-sink-policy`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [GetSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink-policy.html)Reference*.
### `get-sink`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [GetSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink.html)Reference*.
### `list-attached-links`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [ListAttachedLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-attached-links.html)Reference*.
### `list-links`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [ListLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-links.html)Reference*.
### `list-sinks`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [ListSinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-sinks.html)Reference*.
### `list-tags-for-resource`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-tags-for-resource.html)Reference*.
### `put-sink-policy`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [PutSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/put-sink-policy.html)Reference*.
### `tag-resource`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/tag-resource.html)Reference*.
### `untag-resource`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/untag-resource.html)Reference*.
### `update-link`
Il seguente esempio di codice 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](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) nella *Amazon CloudWatch User Guide*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/update-link.html)Reference*.