View a markdown version of this page

Ver reservas de estaciones terrestres - AWS Ground Station
Publicar reservasTipos de reservaEjemplo de código

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Ver reservas de estaciones terrestres

Puede ver las reservas de las antenas de una estación terrestre mediante la ListGroundStationReservationsAPI. Las reservas representan bloques de tiempo en las antenas, incluidos los contactos programados. AWS Ground Station Antenas dedicadaslos clientes también ven los períodos de mantenimiento.

Esta información le ayuda a comprender la disponibilidad de las antenas a la hora de planificar los horarios de contacto y proporciona visibilidad de lo que sucede en las antenas de una estación terrestre.

Publicar reservas

Para hacer una lista de reservas, llama ListGroundStationReservationscon un identificador de estación terrestre y un intervalo de tiempo. La API devuelve las reservas de todas las antenas de la estación terrestre dentro del intervalo de tiempo especificado.

Las reservas que veas dependen de tu nivel de acceso:

  • AWS Ground Station Clientes públicos: solo puedes ver tus propias reservas de contacto. No se incluyen las ventanas de mantenimiento ni los contactos que son propiedad de otras cuentas.

  • AWS Ground Station Clientes de antenas dedicadas: pueden ver todas las reservas de sus antenas dedicadas, incluidos los períodos de mantenimiento y los contactos programados por otras cuentas. Los identificadores de contacto solo se incluyen para los contactos de tu propiedad. Para obtener más información, consulte AWS Ground Station Antenas dedicadas.

Tipos de reserva

Cada reserva tiene un tipo que indica para qué se utiliza la hora de la antena:

  • Contacto: una reserva de contacto representa el tiempo de antena reservado para la comunicación por satélite. Las horas de inicio y finalización de la reserva reflejan la reserva completa de la antena, incluida la hora previa y posterior al pase, no solo la ventana de pases de satélite.

  • Mantenimiento: una reserva de mantenimiento representa un período de tiempo en el que la antena no está disponible debido a tareas de mantenimiento. Las reservas de mantenimiento incluyen una maintenanceType que indica si el mantenimiento fue planificado o no.

Ejemplo de código

En el siguiente ejemplo, se enumeran las reservas en una estación terrestre para los próximos 7 días mediante el AWS SDK para Python (Boto3), incluido el filtrado por tipo de reserva. 

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