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
<a name="locations.reservations"></a>

 Você pode ver as reservas nas antenas em uma estação terrestre usando a [ListGroundStationReservations](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListGroundStationReservations.html)API. As reservas representam blocos de tempo nas antenas, incluindo seus contatos agendados. [AWS Ground Station Antenas dedicadas](dedicated-antennas.md)os 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
<a name="locations.reservations.listing"></a>

 Para listar reservas, ligue [ListGroundStationReservations](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListGroundStationReservations.html)com 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](dedicated-antennas.md). 

## Tipos de reserva
<a name="locations.reservations.types"></a>

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
<a name="locations.reservations.examples"></a>

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