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 de registros 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 with CloudWatch Logs.
*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-log-group`
O código de exemplo a seguir mostra como usar `create-log-group`.
**AWS CLI**
O seguinte comando cria um grupo de logs chamado `my-logs`:
```
aws logs create-log-group --log-group-name {{my-logs}}
```
+ Para obter detalhes da API, consulte [CreateLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-group.html)em *Referência de AWS CLI Comandos*.
### `create-log-stream`
O código de exemplo a seguir mostra como usar `create-log-stream`.
**AWS CLI**
O seguinte comando cria um fluxo de logs `20150601` no grupo de logs `my-logs`:
```
aws logs create-log-stream --log-group-name {{my-logs}} --log-stream-name {{20150601}}
```
+ Para obter detalhes da API, consulte [CreateLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/create-log-stream.html)em *Referência de AWS CLI Comandos*.
### `delete-log-group`
O código de exemplo a seguir mostra como usar `delete-log-group`.
**AWS CLI**
O seguinte comando exclui um grupo de logs chamado `my-logs`:
```
aws logs delete-log-group --log-group-name {{my-logs}}
```
+ Para obter detalhes da API, consulte [DeleteLogGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-group.html)em *Referência de AWS CLI Comandos*.
### `delete-log-stream`
O código de exemplo a seguir mostra como usar `delete-log-stream`.
**AWS CLI**
O seguinte comando exclui um fluxo de logs chamado `20150531` de um grupo de logs chamado `my-logs`:
```
aws logs delete-log-stream --log-group-name {{my-logs}} --log-stream-name {{20150531}}
```
+ Para obter detalhes da API, consulte [DeleteLogStream](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-log-stream.html)em *Referência de AWS CLI Comandos*.
### `delete-retention-policy`
O código de exemplo a seguir mostra como usar `delete-retention-policy`.
**AWS CLI**
O comando a seguir remove a política de retenção que foi aplicada anteriormente a um grupo de logs chamado `my-logs`:
```
aws logs delete-retention-policy --log-group-name {{my-logs}}
```
+ Para obter detalhes da API, consulte [DeleteRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/delete-retention-policy.html)em *Referência de AWS CLI Comandos*.
### `describe-log-groups`
O código de exemplo a seguir mostra como usar `describe-log-groups`.
**AWS CLI**
O seguinte comando descreve um grupo de logs chamado `my-logs`:
```
aws logs describe-log-groups --log-group-name-prefix {{my-logs}}
```
Saída:
```
{
"logGroups": [
{
"storedBytes": 0,
"metricFilterCount": 0,
"creationTime": 1433189500783,
"logGroupName": "my-logs",
"retentionInDays": 5,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:*"
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeLogGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-groups.html)em *Referência de AWS CLI Comandos*.
### `describe-log-streams`
O código de exemplo a seguir mostra como usar `describe-log-streams`.
**AWS CLI**
O comando a seguir mostra todos os fluxos de log começando com o prefixo `2015` no grupo de logs `my-logs`:
```
aws logs describe-log-streams --log-group-name {{my-logs}} --log-stream-name-prefix {{2015}}
```
Saída:
```
{
"logStreams": [
{
"creationTime": 1433189871774,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150531",
"logStreamName": "20150531",
"storedBytes": 0
},
{
"creationTime": 1433189873898,
"arn": "arn:aws:logs:us-west-2:0123456789012:log-group:my-logs:log-stream:20150601",
"logStreamName": "20150601",
"storedBytes": 0
}
]
}
```
+ Para obter detalhes da API, consulte [DescribeLogStreams](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-log-streams.html)em *Referência de AWS CLI Comandos*.
### `get-log-events`
O código de exemplo a seguir mostra como usar `get-log-events`.
**AWS CLI**
O seguinte comando recupera eventos de logs de um fluxo de logs chamado `20150601` no grupo de logs `my-logs`:
```
aws logs get-log-events --log-group-name {{my-logs}} --log-stream-name {{20150601}}
```
Saída:
```
{
"nextForwardToken": "f/31961209122447488583055879464742346735121166569214640130",
"events": [
{
"ingestionTime": 1433190494190,
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"ingestionTime": 1433190516679,
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"ingestionTime": 1433190494190,
"timestamp": 1433190184358,
"message": "Example Event 2"
}
],
"nextBackwardToken": "b/31961209122358285602261756944988674324553373268216709120"
}
```
+ Para obter detalhes da API, consulte [GetLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/get-log-events.html)em *Referência de AWS CLI Comandos*.
### `put-log-events`
O código de exemplo a seguir mostra como usar `put-log-events`.
**AWS CLI**
O seguinte comando define eventos de logs de um fluxo de logs chamado `20150601` no grupo de logs `my-logs`:
```
aws logs put-log-events --log-group-name {{my-logs}} --log-stream-name {{20150601}} --log-events {{file://events}}
```
Saída:
```
{
"nextSequenceToken": "49542672486831074009579604567656788214806863282469607346"
}
```
O exemplo acima lê uma matriz JSON de eventos de um arquivo chamado `events` no diretório atual:
```
[
{
"timestamp": 1433190184356,
"message": "Example Event 1"
},
{
"timestamp": 1433190184358,
"message": "Example Event 2"
},
{
"timestamp": 1433190184360,
"message": "Example Event 3"
}
]
```
Cada chamada subsequente exige que o próximo token de sequência fornecido pela chamada anterior seja especificado com a opção de token de sequência:
```
aws logs put-log-events --log-group-name {{my-logs}} --log-stream-name {{20150601}} --log-events {{file://events2}} --sequence-token {{"49542672486831074009579604567656788214806863282469607346"}}
```
Saída:
```
{
"nextSequenceToken": "49542672486831074009579604567900991230369019956308219826"
}
```
+ Para obter detalhes da API, consulte [PutLogEvents](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-log-events.html)em *Referência de AWS CLI Comandos*.
### `put-retention-policy`
O código de exemplo a seguir mostra como usar `put-retention-policy`.
**AWS CLI**
O comando a seguir adiciona uma política de retenção de 5 dias a um grupo de logs chamado `my-logs`:
```
aws logs put-retention-policy --log-group-name {{my-logs}} --retention-in-days {{5}}
```
+ Para obter detalhes da API, consulte [PutRetentionPolicy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/put-retention-policy.html)em *Referência de AWS CLI Comandos*.