View a markdown version of this page

Visualizza le prenotazioni delle stazioni terrestri - AWS Ground Station
Elencare le prenotazioniTipi di prenotazioneEsempio di codice

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Visualizza le prenotazioni delle stazioni terrestri

È possibile visualizzare le prenotazioni tra le antenne di una stazione di terra utilizzando l'ListGroundStationReservationsAPI. Le prenotazioni rappresentano blocchi temporali sulle antenne, inclusi i contatti programmati. AWS Ground Station Antenne dedicatei clienti vedono anche le finestre di manutenzione.

Queste informazioni aiutano a comprendere la disponibilità delle antenne durante la pianificazione degli orari di contatto e forniscono visibilità su ciò che accade sulle antenne di una stazione di terra.

Elencare le prenotazioni

Per elencare le prenotazioni, chiama ListGroundStationReservationscon un identificativo della stazione di terra e un intervallo di tempo. L'API restituisce le prenotazioni su tutte le antenne della stazione di terra entro la finestra temporale specificata.

Le prenotazioni visualizzate dipendono dal tuo livello di accesso:

  • AWS Ground Station Clienti pubblici: puoi vedere solo le tue prenotazioni di contatto. Le finestre di manutenzione e i contatti di proprietà di altri account non sono inclusi.

  • AWS Ground Station Clienti Dedicated Antennas: puoi visualizzare tutte le prenotazioni sulle tue antenne dedicate, comprese le finestre di manutenzione e i contatti programmati da altri account. Gli identificatori di contatto sono inclusi solo per i contatti di tua proprietà. Per ulteriori informazioni, consulta AWS Ground Station Antenne dedicate.

Tipi di prenotazione

Ogni prenotazione ha un tipo che indica per cosa viene utilizzata l'ora dell'antenna:

  • Contatto: una prenotazione di contatto rappresenta l'ora dell'antenna riservata alla comunicazione satellitare. Gli orari di inizio e fine della prenotazione riflettono l'intera prenotazione dell'antenna, compresi gli orari di pre-pass e post-pass, non solo la finestra del pass satellitare.

  • Manutenzione: una prenotazione di manutenzione rappresenta un periodo di tempo in cui l'antenna non è disponibile per manutenzione. Le prenotazioni di manutenzione includono una maintenanceType che indica se la manutenzione è stata pianificata o non pianificata.

Esempio di codice

L'esempio seguente elenca le prenotazioni presso una stazione di terra per i prossimi 7 giorni utilizzando l' AWS SDK for Python (Boto3), incluso il filtraggio per tipo di prenotazione. 

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']}"
        )