Riferimento: creazione di stringhe di data e ora formattate per Systems Manager

AWS Systems Manager APIle operazioni accettano filtri per limitare il numero di risultati restituiti da una richiesta. Alcune di queste API operazioni accettano filtri che richiedono una stringa formattata per rappresentare una data e un'ora specifiche. Ad esempio, l'DescribeSessionsAPIoperazione accetta le InvokedBefore chiavi InvokedAfter and come valori validi per un SessionFilter oggetto. Un altro esempio è l'DescribeAutomationExecutionsAPIoperazione, che accetta le StartTimeAfter chiavi StartTimeBefore and come valori validi per un AutomationExecutionFilter oggetto. I valori forniti per queste chiavi durante il filtraggio delle richieste devono corrispondere allo standard ISO 8601. Per informazioni su ISO 8601, vedere 8601. ISO

Queste stringhe di data e ora formattate non sono limitate ai filtri. Esistono anche API operazioni che richiedono una stringa formattata ISO 8601 per rappresentare una data e un'ora specifiche quando si fornisce un valore per un parametro di richiesta. Ad esempio, il parametro di richiesta AtTime per l'operazione GetCalendarState. Queste stringhe sono difficili da creare. Usa gli esempi in questo argomento per creare stringhe di data e ora formattate da utilizzare con le operazioni di Systems ManagerAPI.

Formattazione di stringhe di data e ora per Systems Manager

Di seguito è riportato un esempio di stringa di data e ora in formato ISO 8601.

2024-05-08T15:16:43Z

Rappresenta l'8 maggio 2024 alle 15:16 Coordinated Universal Time (). UTC La parte della data del calendario della stringa è rappresentata da un anno a quattro cifre, un mese a due cifre e un giorno a due cifre separati da trattini. Questo può essere rappresentato nel seguente formato.

YYYY-MM-DD

La parte temporale della stringa inizia con la lettera «T» come delimitatore, quindi è rappresentata da un'ora a due cifre, un minuto a due cifre e un secondo a due cifre separati da due punti. Questo può essere rappresentato nel seguente formato.

hh:mm:ss

La parte temporale della stringa termina con la lettera «Z», che indica lo standard. UTC

Creazione di stringhe di data e ora personalizzate per Systems Manager

È possibile creare stringhe di data e ora personalizzate dal computer locale utilizzando lo strumento da riga di comando preferito. La sintassi utilizzata per creare una stringa di data e ora in formato ISO 8601 varia a seconda del sistema operativo del computer locale. Di seguito sono riportati alcuni esempi di come è possibile utilizzare i coreutils GNU di date from su Linux o Windows per creare una stringa di PowerShell data e ora in formato ISO 8601.

coreutils

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

PowerShell

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

Quando si lavora con API le operazioni di Systems Manager, potrebbe essere necessario creare stringhe cronologiche di data e ora per scopi di reporting o risoluzione dei problemi. Di seguito sono riportati alcuni esempi di come è possibile creare e utilizzare stringhe di data e ora storiche personalizzate in formato ISO 8601 per and (). AWS Tools for PowerShell AWS Command Line Interface AWS CLI

AWS CLI

• Recupera l'ultima settimana di cronologia dei comandi per un documento. 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

• Recuperare l'ultima settimana di cronologia di esecuzione dell'automazione.

  lastWeekStamp=$(date '+%Y-%m-%dT%H:%M:%SZ' -d '7 days ago')
  
  aws ssm describe-automation-executions \
      --filters Key=StartTimeAfter,Values=$lastWeekStamp

• Recuperare l'ultimo mese di cronologia delle sessioni.

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

AWS Tools for PowerShell

• Recupera l'ultima settimana di cronologia dei comandi per un SSM documento.

  $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

• Recuperare l'ultima settimana di cronologia di esecuzione dell'automazione.

  $lastWeekStamp = (Get-Date).AddDays(-7).ToString("yyyy-MM-ddTH:mm:ssZ")
  
  Get-SSMAutomationExecutionList `
      -Filters @{Key="StartTimeAfter";Values=$lastWeekStamp}

• Recuperare l'ultimo mese di cronologia delle sessioni.

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