Referensi: Membuat string tanggal dan waktu yang diformat untuk Systems Manager

AWS Systems Manager APIoperasi menerima filter untuk membatasi jumlah hasil yang dikembalikan oleh permintaan. Beberapa API operasi ini menerima filter yang memerlukan string yang diformat untuk mewakili tanggal dan waktu tertentu. Misalnya, DescribeSessions API operasi menerima InvokedBefore kunci InvokedAfter dan sebagai beberapa nilai yang valid untuk suatu SessionFilter objek. Contoh lain adalah DescribeAutomationExecutions API operasi, yang menerima StartTimeAfter kunci StartTimeBefore dan sebagai beberapa nilai yang valid untuk suatu AutomationExecutionFilter objek. Nilai yang Anda berikan untuk kunci ini saat memfilter permintaan Anda harus sesuai dengan standar ISO 8601. Untuk informasi tentang ISO 8601, lihat ISO 8601.

String tanggal dan waktu yang diformat ini tidak terbatas pada filter. Ada juga API operasi yang memerlukan string berformat ISO 8601 untuk mewakili tanggal dan waktu tertentu saat memberikan nilai untuk parameter permintaan. Misalnya, parameter permintaan AtTime untuk operasi GetCalendarState. String ini sulit dibuat. Gunakan contoh dalam topik ini untuk membuat string tanggal dan waktu yang diformat untuk digunakan dengan operasi Systems ManagerAPI.

Memformat string tanggal dan waktu untuk Systems Manager

Berikut ini adalah contoh dari string tanggal dan waktu yang diformat ISO 8601.

2024-05-08T15:16:43Z

Ini mewakili 8 Mei 2024 pukul 15:16 Waktu Universal Terkoordinasi (). UTC Bagian tanggal kalender pada string diwakili oleh empat digit tahun, dua digit bulan, dan dua digit hari dipisahkan oleh tanda hubung. Hal ini dapat diwakili dalam format berikut.

YYYY-MM-DD

Bagian waktu pada string dimulai dengan huruf "T" sebagai pembatas, dan kemudian diwakili oleh dua digit jam, dua digit menit, dan dua digit detik yang dipisahkan oleh titik dua. Hal ini dapat diwakili dalam format berikut.

hh:mm:ss

Bagian waktu string berakhir dengan huruf “Z”, yang menunjukkan standar. UTC

Membuat string tanggal dan waktu kustom untuk Systems Manager

Anda dapat membuat string tanggal dan waktu kustom dari mesin lokal Anda menggunakan alat baris perintah pilihan Anda. Sintaks yang Anda gunakan untuk membuat string tanggal dan waktu yang diformat ISO 8601 berbeda tergantung pada sistem operasi mesin lokal Anda. Berikut ini adalah contoh bagaimana Anda dapat menggunakan coreutils date from GNU di Linux, atau di Windows untuk membuat string PowerShell tanggal dan waktu yang diformat ISO 8601.

coreutils

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

PowerShell

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

Saat bekerja dengan API operasi Systems Manager, Anda mungkin perlu membuat string tanggal dan waktu historis untuk tujuan pelaporan atau pemecahan masalah. Berikut ini adalah contoh bagaimana Anda dapat membuat dan menggunakan string tanggal dan waktu berformat ISO 8601 historis kustom untuk dan (). AWS Tools for PowerShell AWS Command Line Interface AWS CLI

AWS CLI

• Ambil minggu terakhir riwayat perintah untuk SSM dokumen.

  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

• Mengambil minggu terakhir riwayat eksekusi otomatisasi.

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

• Mengambil bulan terakhir riwayat sesi.

  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

• Ambil minggu terakhir riwayat perintah untuk SSM dokumen.

  $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

• Mengambil minggu terakhir riwayat eksekusi otomatisasi.

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

• Mengambil bulan terakhir riwayat sesi.

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