AWS Systems ManagerChange Managersteht neuen Kunden nicht mehr offen. Bestandskunden können den Service weiterhin wie gewohnt nutzen. Weitere Informationen finden Sie unter Änderung der AWS Systems ManagerChange Manager Verfügbarkeit.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Referenz: Datums- und Uhrzeitzeichenfolgen für Systems Manager

AWS Systems Manager-API-Vorgänge akzeptieren Filter, um die Anzahl der von einer Anforderung zurückgegebenen Ergebnisse zu begrenzen. Einige dieser API-Vorgänge akzeptieren Filter, die zur Darstellung eines bestimmten Datums und einer bestimmten Uhrzeit eine formatierte Zeichenfolge erfordern. Beispielsweise akzeptiert der API-Vorgang DescribeSessions die Schlüssel InvokedAfter und InvokedBefore als gültige Werte für ein SessionFilter-Objekt. Ein weiteres Beispiel ist der API-Vorgang DescribeAutomationExecutions. Dieser akzeptiert die Schlüssel StartTimeBefore und StartTimeAfter als gültige Werte für ein AutomationExecutionFilter-Objekt. Die Werte, die Sie für diese Schlüssel beim Filtern Ihrer Anforderungen angeben, müssen dem ISO 8601-Standard entsprechen. Weitere Informationen zu ISO 8601 finden Sie unter ISO 8601.

Diese formatierten Datums- und Uhrzeitzeichenfolgen sind nicht auf Filter beschränkt. Es gibt auch API-Vorgänge, die eine im ISO 8601-Format formatierte Zeichenfolge erfordern, um ein bestimmtes Datum und eine bestimmte Uhrzeit darzustellen, wenn ein Wert für einen Anforderungsparameter angegeben wird. Ein Beispiel ist der Anforderungsparameter AtTime für den Vorgang GetCalendarState. Das Erstellen dieser Zeichenfolgen ist schwierig. Die Beispiele in diesem Thema helfen Ihnen, formatierte Datums- und Uhrzeitzeichenfolgen für die Verwendung mit Systems Manager-API-Vorgängen zu erstellen.

Formatieren von Datums- und Uhrzeitzeichenfolgen für Systems Manager

Im Folgenden finden Sie ein Beispiel für eine im ISO 8601-Format formatierte Datums- und Uhrzeitzeichenfolge.

2024-05-08T15:16:43Z

Dies entspricht dem 8. Mai 2024 um 15:16 Uhr koordinierter 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 Zeitbereich der Zeichenfolge endet mit dem Buchstaben „Z“, der den UTC-Standard angibt.

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 zum Erstellen einer im ISO 8601-Format formatierten Datums- und Uhrzeitzeichenfolge verwenden, ist vom Betriebssystem Ihres lokalen Computers abhängig. Im Folgenden finden Sie Beispiele dafür, wie Sie date aus coreutils von GNU unter Linux oder PowerShell unter Windows verwenden, um eine im ISO 8601-Format formatierte Datums- und Uhrzeitzeichenfolge 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-Vorgängen arbeiten, müssen Sie möglicherweise zu Berichts- oder Fehlerbehebungszwecken historische Datums- und Uhrzeitzeichenfolgen erstellen. Im Folgenden finden Sie Beispiele dafür, wie Sie benutzerdefinierte, im ISO 8601-Format formatierte historische Datums- und Uhrzeitzeichenfolgen für den AWS -Tools für PowerShell und die AWS Command Line Interface (AWS CLI) erstellen und verwenden.

AWS CLI

• Rufen Sie die letzte Woche des Befehlsverlaufs 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 für PowerShell

• Rufen Sie die letzte Woche des Befehlsverlaufs 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}