기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 지상국 예약 보기
<a name="locations.reservations"></a>

 [ListGroundStationReservations](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListGroundStationReservations.html) API를 사용하여 지상국의 안테나 간 예약을 볼 수 있습니다. 예약은 예약된 고객 응대를 포함하여 안테나의 시간 블록을 나타냅니다. [AWS Ground Station 전용 안테나](dedicated-antennas.md) 고객은 유지 관리 기간도 볼 수 있습니다.

 이 정보는 고객 응대 일정을 계획할 때 안테나 가용성을 이해하는 데 도움이 되며 지상국의 안테나에서 발생하는 상황에 대한 가시성을 제공합니다.

## 예약 나열
<a name="locations.reservations.listing"></a>

 예약을 나열하려면 지상국 식별자와 시간 범위를 사용하여 [ListGroundStationReservations](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListGroundStationReservations.html)를 호출합니다. API는 지정된 기간 내에 지상국의 모든 안테나에 대한 예약을 반환합니다.

 표시되는 예약은 액세스 수준에 따라 다릅니다.
+  **공개 AWS Ground Station 고객** - 자체 고객 응대 예약만 볼 수 있습니다. 유지 관리 기간 및 다른 계정이 소유한 연락처는 포함되지 않습니다.
+  **AWS Ground Station 전용 안테나 고객** - 유지 관리 기간 및 다른 계정에서 예약한 연락처를 포함하여 전용 안테나에 대한 모든 예약을 볼 수 있습니다. 연락처 식별자는 소유한 연락처에 대해서만 포함됩니다. 자세한 내용은 [AWS Ground Station 전용 안테나](dedicated-antennas.md) 단원을 참조하십시오.

## 예약 유형
<a name="locations.reservations.types"></a>

각 예약에는 안테나 시간이 사용되는 대상을 나타내는 유형이 있습니다.
+  **연락처** - 연락처 예약은 위성 통신용으로 예약된 안테나 시간을 나타냅니다. 예약 시작 및 종료 시간은 위성 패스 기간뿐만 아니라 사전 패스 및 사후 패스 시간을 포함한 전체 안테나 예약을 반영합니다.
+  **유지** 관리 - 유지 관리 예약은 유지 관리로 인해 안테나를 사용할 수 없는 기간을 나타냅니다. 유지 관리 예약에는 유지 관리의 계획 여부를 `maintenanceType` 나타내는가 포함됩니다.

## 코드 예제
<a name="locations.reservations.examples"></a>

 다음 예시에서는 예약 유형별 필터링을 포함하여 Python용 AWS SDK(Boto3)를 사용하여 향후 7일 동안 지상국에서의 예약을 나열합니다.

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