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.

Planer-CLI

Mit dem Instance Scheduler auf der AWS-Befehlszeilenschnittstelle (CLI) können Sie Zeitpläne und Zeiträume konfigurieren und die Kosteneinsparungen für einen bestimmten Zeitplan abschätzen.

Voraussetzungen

Die CLI in dieser Lösung erfordert Python 3.8+ und die neueste Version von boto3.

Erweitern Sie im angezeigten Detailbereich die Option

Um die Scheduler-CLI verwenden zu können, benötigen Sie Anmeldeinformationen für die AWS-CLI. Weitere Informationen finden Sie unter Konfiguration und Einstellungen für Anmeldeinformationsdateien im AWS-CLI-Benutzerhandbuch.

Ihre Anmeldeinformationen müssen über die folgenden Berechtigungen verfügen:

Von der Scheduler-CLI gestellte Anfragen und Antworten werden im AdminCliRequestHandler-yyyymmdd Protokollstream protokolliert.

Installieren Sie die Scheduler-CLI

Befehlsstruktur

Die Scheduler-CLI verwendet eine mehrteilige Struktur in der Befehlszeile. Der nächste Teil spezifiziert das Scheduler-CLI-Python-Skript. Die Scheduler-CLI verfügt über Befehle, die die Operationen spezifizieren, die in Zeiträumen und Zeitplänen ausgeführt werden sollen. Die spezifischen Argumente für eine Operation können in der Befehlszeile in beliebiger Reihenfolge angegeben werden.

scheduler-cli <command> <arguments>

Allgemeine Argumente

Die Scheduler-CLI unterstützt die folgenden Argumente, die alle Befehle verwenden können:

Verfügbare Befehle

Zeitraum erstellen

Beschreibung

Erzeugt eine Periode. Eine Periode muss mindestens eines der folgenden Elemente enthalten:begintime, endtimeweekdays,months, odermonthdays.

Argumente

Beispiel

$ scheduler-cli create-period --name "weekdays" --begintime 09:00 --endtime 18:00 --weekdays mon-fri --stack Scheduler
{
   "Period": {
      "Name": "weekdays",
      "Endtime": "18:00",
      "Type": "period",
      "Begintime": "09:00",
      "Weekdays": [
         "mon-fri"
      ]
   }
    }

Zeitplan erstellen

Beschreibung

Erstellt einen Zeitplan.

Argumente

Beispiel

$ scheduler-cli create-schedule --name LondonOfficeHours --periods weekdays,weekends --timezone Europe/London --stack Scheduler
{
   "Schedule": {
      "Enforced": false,
      "Name": "LondonOfficeHours",
      "StopNewInstances": true,
      "Periods": [
         "weekends",
         "weekdays"
      ],
      "Timezone": "Europe/London",
      "Type": "schedule"
   }
}

Zeitraum löschen

Beispiel

$ scheduler-cli delete-period --name weekdays --stack Scheduler
{
   "Period": "weekdays"
}

Zeitplan löschen

Beschreibung

Löscht einen vorhandenen Zeitplan

Argumente

Beispiel

$ scheduler-cli delete-schedule --name LondonOfficeHours --stack Scheduler
{
   "Schedule": "LondonOfficeHours"
}

Zeiträume beschreiben

Beschreibung

Listet die konfigurierten Zeiträume für den Instance Scheduler-Stack auf

Argumente

Beispiel

$ scheduler-cli describe-periods --stack Scheduler
{
   "Periods": [
      {
         "Name": "first-monday-in-quarter",
         "Months": [
            "jan/3"
         ],
         "Type": "period",
         "Weekdays": [
            "mon#1"
         ],
         "Description": "Every first Monday of each quarter"
      },
      {
         "Description": "Office hours",
         "Weekdays": [
            "mon-fri"
         ],
         "Begintime": "09:00",
         "Endtime": "17:00",
         "Type": "period",
         "Name": "office-hours"
      },

      {
         "Name": "weekdays",
         "Endtime": "18:00",
         "Type": "period",
         "Weekdays": [
            "mon-fri"
         ],
         "Begintime": "09:00"
      },
      {
         "Name": "weekends",
         "Type": "period",
         "Weekdays": [
            "sat-sun"
         ],
         "Description": "Days in weekend"
      }
   ]
}

Zeitpläne beschreiben

Beschreibung

Listet die konfigurierten Zeitpläne für den Instance Scheduler-Stack auf.

Argumente

Beispiel

$ scheduler-cli describe-schedules --stack Scheduler

{
   "Schedules": [
      {
         "OverrideStatus": "running",
         "Type": "schedule",
         "Name": "Running",
         "UseMetrics": false
      },
      {
         "Timezone": "UTC",
         "Type": "schedule",
         "Periods": [
            "working-days@t2.micro",
            "weekends@t2.nano"
         ],
         "Name": "scale-up-down"
      },
      {
         "Timezone": "US/Pacific",
         "Type": "schedule",
         "Periods": [
            "office-hours"
         ],
         "Name": "seattle-office-hours"
      },
      {
         "OverrideStatus": "stopped",
         "Type": "schedule",
         "Name": "stopped",
         "UseMetrics": true
      }
   ]
}

describe-schedule-usage

Beschreibung

Listet alle Perioden auf, die innerhalb eines Zeitplans laufen, und berechnet die Abrechnungsstunden für Instanzen. Verwenden Sie diesen Befehl, um einen Zeitplan zur Berechnung potenzieller Einsparungen und Laufzeiten nach der Erstellung oder Aktualisierung eines Zeitplans zu simulieren.

Argumente

Beispiel

$ scheduler-cli describe-schedule-usage --stack InstanceScheduler --name seattle-office-hours
{
   "Usage": {
      "2017-12-04": {
         "BillingHours": 8,
         "RunningPeriods": {
            "Office-hours": {
               "Begin": "12/04/17 09:00:00",
               "End": "12/04/17 17:00:00",
               "BillingHours": 8,
               "BillingSeconds": 28800
            }
         },
         "BillingSeconds": 28800
      }
   },
   "Schedule": "seattle-office-hours"

Aktualisierungszeitraum

Beschreibung

Aktualisiert einen bestehenden Zeitraum

Argumente

Der update-period Befehl unterstützt dieselben Argumente wie der create-period Befehl. Weitere Informationen zu den Argumenten finden Sie im Befehl create period.

Zeitplan für die Aktualisierung

Beschreibung

Aktualisiert einen vorhandenen Zeitplan

Argumente

Der update-schedule Befehl unterstützt dieselben Argumente wie der create-schedule Befehl. Weitere Informationen zu den Argumenten finden Sie im Befehl create schedule.

help

Beschreibung

Zeigt eine Liste gültiger Befehle und Argumente für die Scheduler-CLI an.

Beispiel

$ scheduler-cli --help
usage: scheduler-cli [-h] [--version]
                     {create-period,create-schedule,delete-period,delete-schedule,describe-periods,describe-schedule-usage,describe-schedules,update-period,update-schedule}
                     ...

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit

subcommands:
  Valid subcommands

  {create-period,create-schedule,delete-period,delete-schedule,describe-periods,describe-schedule-usage,describe-schedules,update-period,update-schedule}
                        Commands help
    create-period       Creates a period
    create-schedule     Creates a schedule
    delete-period       Deletes a period
    delete-schedule     Deletes a schedule
    describe-periods    Describes configured periods
    describe-schedule-usage
                        Calculates periods and billing hours in which
                        instances are running
    describe-schedules  Described configured schedules
    update-period       Updates a period
    update-schedule     Updates a schedule

Bei Verwendung mit einem bestimmten Befehl zeigt das --help Argument gültige Unterbefehle und Argumente für diesen Befehl an.

Beispiel für einen bestimmten Befehl

$ scheduler-cli describe-schedules --help
usage: scheduler-cli describe-schedules [-h] [--name NAME] [--query QUERY]
                                        [--region REGION] --stack STACK

optional arguments:
  -h, --help         show this help message and exit
  --name NAME        Name of the schedule
  --query QUERY      JMESPath query to transform or filter the result
  --region REGION    Region in which the Instance Scheduler stack is
                        deployed
  --stack STACK, -s STACK
                     Name of the Instance Scheduler stack