View a markdown version of this page

Afficher les réservations de stations au sol - AWS Ground Station
Réservations d'annoncesTypes de réservationExemple de code

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Afficher les réservations de stations au sol

Vous pouvez consulter les réservations via les antennes d'une station au sol à l'aide de l'ListGroundStationReservationsAPI. Les réservations représentent des plages horaires sur les antennes, y compris vos contacts programmés. AWS Ground Station Antennes dédiéesles clients voient également les fenêtres de maintenance.

Ces informations vous aident à comprendre la disponibilité des antennes lors de la planification des horaires de contact et fournissent une visibilité sur ce qui se passe sur les antennes d'une station au sol.

Réservations d'annonces

Pour répertorier les réservations, appelez ListGroundStationReservationsavec un identifiant de station au sol et une plage horaire. L'API renvoie les réservations pour toutes les antennes de la station au sol dans le délai spécifié.

Les réservations que vous voyez dépendent de votre niveau d'accès :

  • AWS Ground Station Clients publics — Vous ne pouvez voir que vos propres réservations de contacts. Les fenêtres de maintenance et les contacts appartenant à d'autres comptes ne sont pas inclus.

  • AWS Ground Station Clients d'antennes dédiées — Vous pouvez consulter toutes les réservations sur vos antennes dédiées, y compris les fenêtres de maintenance et les contacts planifiés par d'autres comptes. Les identifiants de contact ne sont inclus que pour les contacts dont vous êtes le propriétaire. Pour de plus amples informations, veuillez consulter AWS Ground Station Antennes dédiées.

Types de réservation

Chaque réservation possède un type qui indique à quoi sert l'heure de l'antenne :

  • Contact — Une réservation de contact représente le temps d'antenne réservé aux communications par satellite. Les heures de début et de fin de réservation reflètent la réservation complète de l'antenne, y compris l'heure avant et après le passage, et pas seulement le créneau d'accès par satellite.

  • Maintenance — Une réservation de maintenance représente une période pendant laquelle l'antenne n'est pas disponible pour cause de maintenance. Les réservations de maintenance incluent un maintenanceType qui indique si la maintenance était planifiée ou non planifiée.

Exemple de code

L'exemple suivant répertorie les réservations effectuées dans une station au sol pour les 7 prochains jours à l'aide du AWS SDK pour Python (Boto3), y compris le filtrage par type de réservation. 

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