AWS Systems ManagerChange Managernon è più aperto a nuovi clienti. I clienti esistenti possono continuare a utilizzare il servizio normalmente. Per ulteriori informazioni, consulta AWS Systems ManagerChange Managerla pagina Modifica della disponibilità.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riferimento: formati di stringhe di data e ora per Systems Manager

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

Queste stringhe di data e ora formattate non sono limitate ai filtri. Esistono anche operazioni API 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. Utilizzare gli esempi in questo argomento per creare stringhe di data e ora formattate da utilizzare con le operazioni API di Systems Manager.

Formattazione di stringhe di data e ora per Systems Manager

Di seguito è riportato un esempio di una stringa di data e ora formattata secondo lo standard ISO 8601.

2024-05-08T15:16:43Z

Rappresenta l'8 maggio 2024 alle 15:16 del Tempo Coordinato Universale (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 formattata secondo lo standard ISO 8601 varia a seconda del sistema operativo del computer locale. Di seguito sono riportati esempi di come è possibile utilizzare date dal pacchetto coreutils di GNU su Linux, o la PowerShell su Windows per creare una stringa di data e ora formattata secondo lo standard ISO 8601.

coreutils

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

PowerShell

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

Quando si utilizzano le operazioni API di Systems Manager, potrebbe essere necessario creare stringhe di data e ora cronologiche a scopo di reporting o risoluzione dei problemi. Di seguito sono riportati esempi di come è possibile creare e utilizzare stringhe di data e ora cronologiche personalizzate formattate secondo lo standard ISO 8601 per AWS Strumenti per PowerShell e AWS Command Line Interface (AWS CLI).

AWS CLI

• Recuperare 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 Strumenti per PowerShell

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

• 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}