View a markdown version of this page

Reservierungen für Bodenstationen anzeigen - AWS Ground Station
Reservierungen auflistenArten von ReservierungenCodebeispiel

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.

Reservierungen für Bodenstationen anzeigen

Mithilfe der ListGroundStationReservationsAPI können Sie Reservierungen für mehrere Antennen an einer Bodenstation einsehen. Reservierungen stellen Zeitblöcke auf Antennen dar, einschließlich Ihrer geplanten Kontakte. AWS Ground Station Dedizierte AntennenKunden sehen auch Wartungsfenster.

Diese Informationen helfen Ihnen bei der Planung von Kontaktplänen, die Verfügbarkeit von Antennen besser zu verstehen und bieten einen Überblick darüber, was auf den Antennen an einer Bodenstation passiert.

Reservierungen auflisten

Um Reservierungen aufzulisten, rufen Sie ListGroundStationReservationsmit einer Bodenstationskennung und einem Zeitraum an. Die API gibt innerhalb des angegebenen Zeitfensters Reservierungen für alle Antennen an der Bodenstation zurück.

Die Reservierungen, die Sie sehen, hängen von Ihrer Zugriffsebene ab:

  • Öffentliche AWS Ground Station Kunden — Sie können nur Ihre eigenen Kontaktreservierungen sehen. Wartungsfenster und Kontakte, die anderen Konten gehören, sind nicht enthalten.

  • AWS Ground Station Dedizierte Antennen-Kunden — Sie können alle Reservierungen auf Ihren Dedicated Antennas einsehen, einschließlich Wartungsfenster und Kontakte, die von anderen Konten geplant wurden. Kontaktkennungen sind nur für Kontakte enthalten, deren Eigentümer Sie sind. Weitere Informationen finden Sie unter AWS Ground Station Dedizierte Antennen.

Arten von Reservierungen

Jede Reservierung hat einen Typ, der angibt, wofür die Antennenzeit verwendet wird:

  • Kontakt — Eine Kontaktreservierung steht für die Antennenzeit, die für die Satellitenkommunikation reserviert ist. Die Start- und Endzeiten der Reservierung beziehen sich auf die gesamte Antennenreservierung, einschließlich der Zeit vor und nach dem Pass, und nicht nur auf das Zeitfenster für den Satellitenpass.

  • Wartung — Eine Wartungsreservierung steht für einen Zeitraum, in dem die Antenne aufgrund von Wartungsarbeiten nicht verfügbar ist. Zu den Wartungsreservierungen gehört einmaintenanceType, das angibt, ob die Wartung geplant oder ungeplant war.

Codebeispiel

Das folgende Beispiel listet Reservierungen an einer Bodenstation für die nächsten 7 Tage mit dem AWS SDK for Python (Boto3) auf, einschließlich der Filterung nach Reservierungstyp. 

import boto3
from datetime import datetime, timezone, timedelta

# Create AWS Ground Station client
ground_station_client = boto3.client("groundstation")

# The ground station ID to list reservations for
ground_station_id = "Ohio 1"

# Define the time range to query. Reservations include both your
# scheduled contacts and maintenance windows at the ground station.
start_time = datetime.now(timezone.utc)
end_time = start_time + timedelta(days=7)

# List all reservations at a ground station for the next 7 days.
# You can filter by reservation type to see only contacts or
# only maintenance windows.
print(f"Listing reservations for ground station '{ground_station_id}'...")
print(f"Time range: {start_time} to {end_time}")

paginator = ground_station_client.get_paginator("list_ground_station_reservations")
page_iterator = paginator.paginate(
    groundStationId=ground_station_id,
    startTime=start_time,
    endTime=end_time,
    PaginationConfig={
        "MaxItems": 100,
        "PageSize": 20,
    },
)

for page in page_iterator:
    for reservation in page["reservationList"]:
        reservation_type = reservation["reservationType"]
        antenna_name = reservation["antennaName"]
        res_start = reservation["startTime"]
        res_end = reservation["endTime"]

        print(f"  Type: {reservation_type}")
        print(f"    Antenna: {antenna_name}")
        print(f"    Start: {res_start}")
        print(f"    End: {res_end}")

        details = reservation["reservationDetails"]
        if "contact" in details:
            contact_id = details["contact"].get("contactId", "N/A")
            print(f"    Contact ID: {contact_id}")
        elif "maintenance" in details:
            maintenance_type = details["maintenance"]["maintenanceType"]
            print(f"    Maintenance Type: {maintenance_type}")

        print()

# For Dedicated Antenna customers, you can also filter to show only maintenance windows
print("Listing only maintenance reservations...")

page_iterator = paginator.paginate(
    groundStationId=ground_station_id,
    startTime=start_time,
    endTime=end_time,
    reservationTypes=["MAINTENANCE"],
    PaginationConfig={
        "MaxItems": 100,
        "PageSize": 20,
    },
)

for page in page_iterator:
    for reservation in page["reservationList"]:
        maintenance_type = reservation["reservationDetails"]["maintenance"][
            "maintenanceType"
        ]
        print(
            f"  {maintenance_type} maintenance on {reservation['antennaName']}: "
            f"{reservation['startTime']} to {reservation['endTime']}"
        )