Referenz: Erstellen formatierter Datums- und Uhrzeitzeichenfolgen für Systems Manager

AWS Systems Manager APIOperationen akzeptieren Filter, um die Anzahl der von einer Anfrage zurückgegebenen Ergebnisse zu begrenzen. Einige dieser API Operationen akzeptieren Filter, die eine formatierte Zeichenfolge benötigen, um ein bestimmtes Datum und eine bestimmte Uhrzeit darzustellen. Die DescribeSessions API Operation akzeptiert beispielsweise die InvokedBefore Tasten InvokedAfter und als gültige Werte für ein SessionFilter Objekt. Ein anderes Beispiel ist die DescribeAutomationExecutions API Operation, bei der die StartTimeAfter Schlüssel StartTimeBefore und als gültige Werte für ein AutomationExecutionFilter Objekt akzeptiert werden. Die Werte, die Sie beim Filtern Ihrer Anfragen für diese Schlüssel angeben, müssen dem ISO 8601-Standard entsprechen. Informationen zu 8601 finden Sie unter ISO ISO 8601.

Diese formatierten Datums- und Uhrzeitzeichenfolgen sind nicht auf Filter beschränkt. Es gibt auch API Operationen, die eine Zeichenfolge im ISO 8601-Format benötigen, um ein bestimmtes Datum und eine bestimmte Uhrzeit darzustellen, wenn ein Wert für einen Anforderungsparameter bereitgestellt wird. Ein Beispiel ist der Anforderungsparameter AtTime für den Vorgang GetCalendarState. Das Erstellen dieser Zeichenfolgen ist schwierig. Verwenden Sie die Beispiele in diesem Thema, um formatierte Datums- und Uhrzeitzeichenfolgen für Systems Manager API Manager-Operationen zu erstellen.

Formatieren von Datums- und Uhrzeitzeichenfolgen für Systems Manager

Im Folgenden finden Sie ein Beispiel für eine Zeichenfolge mit Datum und Uhrzeit im ISO 8601-Format.

2024-05-08T15:16:43Z

Dies entspricht dem 8. Mai 2024 um 15:16 Uhr der koordinierten Weltzeit (). UTC Der Kalenderdatumsbereich der Zeichenfolge wird durch ein vierstelliges Jahr, einen zweistelligen Monat und einen zweistelligen Tag dargestellt, getrennt durch Bindestriche. Dies kann im folgenden Format dargestellt werden.

YYYY-MM-DD

Der Zeitbereich der Zeichenfolge beginnt mit dem Buchstaben „T“ als Trennzeichen. Er wird durch eine zweistellige Stunde, eine zweistellige Minute und eine zweistellige Sekunde dargestellt, getrennt durch Doppelpunkte. Dies kann im folgenden Format dargestellt werden.

hh:mm:ss

Der Zeitteil der Zeichenfolge endet mit dem Buchstaben „Z“, der den Standard bezeichnet. UTC

Erstellen benutzerdefinierter Datums- und Uhrzeitzeichenfolgen für Systems Manager

Sie können benutzerdefinierte Datums- und Uhrzeitzeichenfolgen auf Ihrem lokalen Computer mit Ihrem bevorzugten Befehlszeilen-Tool erstellen. Die Syntax, die Sie verwenden, um eine Zeichenfolge mit Datum und Uhrzeit im ISO 8601-Format zu erstellen, hängt vom Betriebssystem Ihres lokalen Computers ab. Im Folgenden finden Sie Beispiele dafür, wie Sie die Coreutils date GNU von from unter Linux oder unter Windows verwenden können, um eine Zeichenfolge mit PowerShell Datum und Uhrzeit im ISO 8601-Format zu erstellen.

coreutils

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

PowerShell

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

Wenn Sie mit Systems Manager API Manager-Vorgängen arbeiten, müssen Sie möglicherweise historische Datums- und Uhrzeitzeichenfolgen für Berichts- oder Problembehandlungszwecke erstellen. Im Folgenden finden Sie Beispiele dafür, wie Sie benutzerdefinierte historische Datums- und Uhrzeitzeichenfolgen ISO im 8601-Format für und AWS Command Line Interface ()AWS CLI erstellen AWS Tools for PowerShell und verwenden können.

AWS CLI

• Rufen Sie den Befehlsverlauf der letzten Woche für ein SSM Dokument ab.

  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

• Rufen Sie die letzte Woche des Automatisierungsausführungsverlaufs ab.

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

• Rufen Sie den letzten Monat des Sitzungsverlaufs ab.

  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

• Ruft den Befehlsverlauf der letzten Woche für ein SSM Dokument ab.

  $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

• Rufen Sie die letzte Woche des Automatisierungsausführungsverlaufs ab.

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

• Rufen Sie den letzten Monat des Sitzungsverlaufs ab.

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