• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

# Referência: Formatos de strings de data e hora para o Systems Manager
<a name="systems-manager-datetime-strings"></a>

As operações da API do AWS Systems Manager aceitam filtros para limitar o número de resultados retornados por uma solicitação. Algumas dessas operações da API aceitam filtros que exigem uma string formatada para representar uma data e uma hora específicas. Por exemplo, a operação da API `DescribeSessions` aceita as chaves `InvokedBefore` e `InvokedAfter` como alguns valores válidos para um objeto `SessionFilter`. Outro exemplo é a ação da API `DescribeAutomationExecutions`, que aceita as chaves `StartTimeAfter` e `StartTimeBefore` como alguns dos valores válidos para um objeto `AutomationExecutionFilter`. Os valores fornecidos para essas chaves ao filtrar as solicitações devem corresponder ao padrão ISO 8601. Para obter informações sobre o ISO 8601, consulte [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html).

Essas strings de data e hora formatadas não estão limitadas a filtros. Há também operações de API que exigem uma string no formato ISO 8601 para representar uma data e uma hora específicas ao fornecer um valor para um parâmetro de solicitação. Por exemplo, o parâmetro de solicitação `AtTime` da operação `GetCalendarState`. Essas strings são difíceis de criar. Use os exemplos neste tópico para criar strings de data e hora formatadas para usar com operações da API do Systems Manager.

## Formatar strings de data e hora para o Systems Manager
<a name="systems-manager-datetime-strings-format"></a>

Veja a seguir um exemplo de uma string de data e hora no formato ISO 8601.

```
2024-05-08T15:16:43Z
```

Ela representa: 8 de maio de 2024, às 15h16, padrão UTC (Tempo Universal Coordenado). A parte da data do calendário da string é representada por um ano de quatro dígitos, um mês de dois dígitos e um dia de dois dígitos separados por hifens. Isso pode ser representado no formato a seguir.

```
YYYY-MM-DD
```

A parte de hora da string começa com a letra "T" como um delimitador e, depois, é representada por uma hora de dois dígitos, um minuto de dois dígitos e um segundo de dois dígitos, separados por dois pontos. Isso pode ser representado no formato a seguir.

```
hh:mm:ss
```

A parte de hora da string termina com a letra "Z", indicando o padrão UTC.

## Criar strings personalizados de data e hora para o Systems Manager
<a name="systems-manager-datetime-strings-custom"></a>

É possível criar strings personalizadas de data e hora na máquina local usando sua ferramenta de linha de comando preferencial. A sintaxe usada para criar uma string de data e hora no formato ISO 8601 difere dependendo do sistema operacional da máquina local. Veja a seguir exemplos de como você pode usar `date` no coreutils do GNU no Linux ou no PowerShell do Windows para criar uma string de data e hora no formato ISO 8601.

------
#### [ coreutils ]

```
date '+%Y-%m-%dT%H:%M:%SZ'
```

------
#### [ PowerShell ]

```
(Get-Date).ToString("yyyy-MM-ddTH:mm:ssZ")
```

------

Ao trabalhar com operações da API do Systems Manager, talvez seja necessário criar strings históricas de data e hora para fins de geração de relatórios ou solução de problemas. Veja a seguir exemplos de como você pode criar e usar strings históricas e personalizadas de data e hora no formato ISO 8601 para o Ferramentas da AWS para PowerShell e a AWS Command Line Interface (AWS CLI).

------
#### [ AWS CLI ]
+ Recupere a última semana do histórico de comandos para um documento do SSM.

  ```
  lastWeekStamp=$(date '+%Y-%m-%dT%H:%M:%SZ' -d '7 days ago')
  
  docFilter='{"key":"DocumentName","value":"AWS-RunPatchBaseline"}'
  timeFilter='{"key":"InvokedAfter","value":'\"$lastWeekStamp\"'}'
  
  commandFilters=[$docFilter,$timeFilter]
  
  aws ssm list-commands \
      --filters $commandFilters
  ```
+ Recupere a última semana do histórico de execução de automação.

  ```
  lastWeekStamp=$(date '+%Y-%m-%dT%H:%M:%SZ' -d '7 days ago')
  
  aws ssm describe-automation-executions \
      --filters Key=StartTimeAfter,Values=$lastWeekStamp
  ```
+ Recupere o último mês do histórico da sessão.

  ```
  lastWeekStamp=$(date '+%Y-%m-%dT%H:%M:%SZ' -d '30 days ago')
  
  aws ssm describe-sessions \
      --state History \
      --filters key=InvokedAfter,value=$lastWeekStamp
  ```

------
#### [ Ferramentas da AWS para PowerShell ]
+ Recupere a última semana do histórico de comandos para um documento do SSM.

  ```
  $lastWeekStamp = (Get-Date).AddDays(-7).ToString("yyyy-MM-ddTH:mm:ssZ")
  
  $docFilter = @{
      Key="DocumentName"
      Value="AWS-InstallWindowsUpdates"
  }
  $timeFilter = @{
      Key="InvokedAfter"
      Value=$lastWeekStamp
  }
  
  $commandFilters = $docFilter,$timeFilter
  
  Get-SSMCommand `
      -Filters $commandFilters
  ```
+ Recupere a última semana do histórico de execução de automação.

  ```
  $lastWeekStamp = (Get-Date).AddDays(-7).ToString("yyyy-MM-ddTH:mm:ssZ")
  
  Get-SSMAutomationExecutionList `
      -Filters @{Key="StartTimeAfter";Values=$lastWeekStamp}
  ```
+ Recupere o último mês do histórico da sessão.

  ```
  $lastWeekStamp = (Get-Date).AddDays(-30).ToString("yyyy-MM-ddTH:mm:ssZ")
  
  Get-SSMSession `
      -State History `
      -Filters @{Key="InvokedAfter";Value=$lastWeekStamp}
  ```

------