Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# CloudWatch Exemplos do Observability Access Monitor usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o 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
```
Saída:
```
{
"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": {}
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [CreateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-link.html)em *Referência de AWS CLI Comandos*.
### `create-sink`
O código de exemplo a seguir mostra como usar `create-sink`.
**AWS CLI**
**Como criar um coletor**
O `create-sink` exemplo a seguir cria um coletor na conta corrente, para que possa ser usado como uma conta de monitoramento na observabilidade CloudWatch entre contas.
```
aws oam create-sink \
--name DemoSink
```
Saída:
```
{
"Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
"Id": "a1b2c3d4-5678-90ab-cdef-example12345",
"Name": "DemoSink",
"Tags": {}
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [CreateSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/create-sink.html)em *Referência de AWS CLI Comandos*.
### `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.
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [DeleteLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-link.html)em *Referência de AWS CLI Comandos*.
### `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.
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [DeleteSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/delete-sink.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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": {}
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [GetLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-link.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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\"]}}}]}"
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [GetSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink-policy.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
"Id": "a1b2c3d4-5678-90ab-cdef-example12345",
"Name": "DemoSink",
"Tags": {}
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [GetSink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/get-sink.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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"
]
}]
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [ListAttachedLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-attached-links.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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"
}]
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [ListLinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-links.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"Items": [
{
"Arn": "arn:aws:oam:us-east-2:123456789012:sink/a1b2c3d4-5678-90ab-cdef-example12345",
"Id": "a1b2c3d4-5678-90ab-cdef-example12345",
"Name": "DemoSink"
}
]
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [ListSinks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-sinks.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"Tags": {
"Team": "Devops"
}
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*.
### `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
```
Saída:
```
{
"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\"]}}}]}"
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [PutSinkPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/put-sink-policy.html)em *Referência de AWS CLI Comandos*.
### `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.
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/tag-resource.html)em *Referência de AWS CLI Comandos*.
### `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.
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/untag-resource.html)em *Referência de AWS CLI Comandos*.
### `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"
```
Saída:
```
{
"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": {}
}
```
Para obter mais informações, consulte a [observabilidade CloudWatch entre contas no Guia CloudWatch ](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html) *do usuário da Amazon*.
+ Para obter detalhes da API, consulte [UpdateLink](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/oam/update-link.html)em *Referência de AWS CLI Comandos*.