View a markdown version of this page

Exibir reservas de estações terrestres - AWS Ground Station
Listando reservasTipos de reservaExemplo de código

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Exibir reservas de estações terrestres

Você pode ver as reservas nas antenas em uma estação terrestre usando a ListGroundStationReservationsAPI. As reservas representam blocos de tempo nas antenas, incluindo seus contatos agendados. AWS Ground Station Antenas dedicadasos clientes também veem janelas de manutenção.

Essas informações ajudam você a entender a disponibilidade da antena ao planejar os agendamentos de contato e fornecem visibilidade do que está acontecendo nas antenas de uma estação terrestre.

Listando reservas

Para listar reservas, ligue ListGroundStationReservationscom um identificador de estação terrestre e um intervalo de tempo. A API retorna reservas em todas as antenas na estação terrestre dentro da janela de tempo especificada.

As reservas que você vê dependem do seu nível de acesso:

  • AWS Ground Station Clientes públicos — Você pode ver somente suas próprias reservas de contato. Janelas de manutenção e contatos pertencentes a outras contas não estão incluídos.

  • AWS Ground Station Clientes de antenas dedicadas — Você pode ver todas as reservas em suas antenas dedicadas, incluindo janelas de manutenção e contatos agendados por outras contas. Os identificadores de contato são incluídos somente para contatos que você possui. Para obter mais informações, consulte AWS Ground Station Antenas dedicadas.

Tipos de reserva

Cada reserva tem um tipo que indica para que o tempo da antena está sendo usado:

  • Contato — Uma reserva de contato representa o tempo de antena reservado para comunicação via satélite. Os horários de início e término da reserva refletem a reserva completa da antena, incluindo o tempo antes e depois da passagem, não apenas a janela do passe via satélite.

  • Manutenção — Uma reserva de manutenção representa um período em que a antena está indisponível devido à manutenção. As reservas de manutenção incluem uma maintenanceType que indica se a manutenção foi planejada ou não.

Exemplo de código

O exemplo a seguir lista as reservas em uma estação terrestre para os próximos 7 dias usando o AWS SDK for Python (Boto3), incluindo a filtragem 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']}"
        )