# Exemplos do CloudWatch Observability Access Monitor usando a AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando a AWS Command Line Interface com o CloudWatch Observability Access Monitor.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `create-link`
O código de exemplo a seguir mostra como usar `create-link`.
**AWS CLI**
**Como criar um vínculo**
O exemplo de `create-link` a seguir cria um vínculo entre uma conta de origem e um coletor que você criou em uma conta de monitoramento.
```
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
```
Resultado:
```
{
"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": {}
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Para ver detalhes da API, consulte [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-link.html) na *Referência de comandos da AWS CLI*.
### `create-sink`
O código de exemplo a seguir mostra como usar `create-sink`.
**AWS CLI**
**Como criar um coletor**
O exemplo de `create-sink` a seguir cria um coletor na conta atual para que ele possa ser usado como uma conta de monitoramento na observabilidade entre contas do CloudWatch.
```
aws oam create-sink \
--name DemoSink
```
Resultado:
```
{
"Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
"Id": "a1b2c3d4-5678-90ab-cdef-example12345",
"Name": "DemoSink",
"Tags": {}
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [CreateSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-sink.html) na *Referência de comandos da AWS CLI*.
### `delete-link`
O código de exemplo a seguir mostra como usar `delete-link`.
**AWS CLI**
**Como excluir um vínculo**
O exemplo de `delete-link` a seguir exclui um vínculo entre um coletor da conta de monitoramento e uma conta de origem.
```
aws oam delete-link \
--identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111
```
Este comando não produz saída.
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Para ver detalhes da API, consulte [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-link.html) na *Referência de comandos da AWS CLI*.
### `delete-sink`
O código de exemplo a seguir mostra como usar `delete-sink`.
**AWS CLI**
**Como excluir um coletor**
O exemplo de `delete-sink` a seguir exclui um coletor. Você deve excluir todos os vínculos de um coletor para poder excluí-lo.
```
aws oam delete-sink \
--identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
```
Este comando não produz saída.
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [DeleteSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-sink.html) na *Referência de comandos da AWS CLI*.
### `get-link`
O código de exemplo a seguir mostra como usar `get-link`.
**AWS CLI**
**Como retornar informações completas sobre um vínculo**
O exemplo de `get-link` a seguir retorna informações completas sobre um vínculo.
```
aws oam get-link \
--identifier arn:aws:oam:us-east-2:123456789111:link/a1b2c3d4-5678-90ab-cdef-example11111
```
Resultado:
```
{
"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": {}
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [GetLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-link.html) na *Referência de comandos da AWS CLI*.
### `get-sink-policy`
O código de exemplo a seguir mostra como usar `get-sink-policy`.
**AWS CLI**
**Como retornar a política de coletor atual anexada ao coletor**
O exemplo de `get-sink-policy` a seguir retorna a política de coletor atual anexada ao coletor.
```
aws oam get-sink-policy \
--sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
```
Resultado:
```
{
"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\"]}}}]}"
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [GetSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink-policy.html) na *Referência de comandos da AWS CLI*.
### `get-sink`
O código de exemplo a seguir mostra como usar `get-sink`.
**AWS CLI**
**Como retornar informações completas sobre um vínculo da conta de monitoramento**
O exemplo de `get-sink` a seguir retorna informações completas sobre um coletor da conta de monitoramento.
```
aws oam get-sink \
--identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
```
Resultado:
```
{
"Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
"Id": "a1b2c3d4-5678-90ab-cdef-example12345",
"Name": "DemoSink",
"Tags": {}
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [GetSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink.html) na *Referência de comandos da AWS CLI*.
### `list-attached-links`
O código de exemplo a seguir mostra como usar `list-attached-links`.
**AWS CLI**
**Como retornar uma lista de vínculos de contas de origem com esse coletor da conta de monitoramento**
O exemplo de `list-attached-links` a seguir retorna uma lista de vínculos de contas de origem com esse coletor da conta de monitoramento.
```
aws oam list-attached-links \
--sink-identifier arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
```
Resultado:
```
{
"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"
]
}]
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [ListAttachedLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-attached-links.html) na *Referência de comandos da AWS CLI*.
### `list-links`
O código de exemplo a seguir mostra como usar `list-links`.
**AWS CLI**
**Como retornar uma lista de vínculos para um coletor da conta de monitoramento**
O exemplo de `list-links` a seguir retorna uma lista de vínculos para um coletor da conta de monitoramento. Execute essa operação em uma conta de origem para retornar uma lista de vínculos para coletores das contas de monitoramento que essa conta de origem possui.
```
aws oam list-links
```
Resultado:
```
{
"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"
}]
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [ListLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-links.html) na *Referência de comandos da AWS CLI*.
### `list-sinks`
O código de exemplo a seguir mostra como usar `list-sinks`.
**AWS CLI**
**Como retornar a lista de coletores criados na conta de monitoramento**
O exemplo de `list-sinks` a seguir retorna uma lista de coletores criados na conta de monitoramento. Execute essa operação em uma conta de monitoramento.
```
aws oam list-sinks
```
Resultado:
```
{
"Items": [
{
"Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
"Id": "a1b2c3d4-5678-90ab-cdef-example12345",
"Name": "DemoSink"
}
]
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [ListSinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-sinks.html) na *Referência de comandos da AWS CLI*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Como exibir as tags associadas a um recurso**
O exemplo de `list-tags-for-resource` a seguir exibe as tags associadas a um coletor.
```
aws oam list-tags-for-resource \
--resource-arn arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345
```
Resultado:
```
{
"Tags": {
"Team": "Devops"
}
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Para obter detalhes sobre a API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-tags-for-resource.html) na *AWS CLI Command Reference*.
### `put-sink-policy`
O código de exemplo a seguir mostra como usar `put-sink-policy`.
**AWS CLI**
**Como criar ou atualizar a política de recursos**
O exemplo de `put-sink-policy` a seguir cria a política de recursos que concede permissões às contas de origem para se vincularem ao coletor da conta de monitoramento.
```
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
```
Resultado:
```
{
"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\"]}}}]}"
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [PutSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/put-sink-policy.html) na *Referência de comandos da AWS CLI*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Como atribuir uma ou mais tags ao recurso especificado**
O exemplo de `tag-resource` a seguir marca um coletor `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
```
Este comando não produz saída.
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Consulte detalhes da API em [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/tag-resource.html) na *Referência de comandos da AWS CLI*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Como remover uma ou mais tags do recurso especificado.**
O exemplo de `untag-resource` a seguir remove uma tag com a chave `team` do coletor `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
```
Este comando não produz saída.
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Para obter detalhes sobre a API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/untag-resource.html) na *Referência de comandos da AWS CLI*.
### `update-link`
O código de exemplo a seguir mostra como usar `update-link`.
**AWS CLI**
**Como alterar quais tipos de dados são compartilhados de uma conta de origem para o coletor da conta de monitoramento vinculada**
O exemplo de `update-link` a seguir atualiza o vínculo de `arn:aws:oam:us-east-2:123456789111:link/0123e691-e7ef-43fa-1234-c57c837fced0` com os tipos de recursos `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"
```
Resultado:
```
{
"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": {}
}
```
Consulte mais informações em [Observabilidade entre contas do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) no *Guia do usuário do Amazon CloudWatch*.
+ Para ver detalhes da API, consulte [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/update-link.html) na *Referência de comandos da AWS CLI*.