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

지상국 예약 보기

ListGroundStationReservations API를 사용하여 지상국의 안테나 간 예약을 볼 수 있습니다. 예약은 예약된 고객 응대를 포함하여 안테나의 시간 블록을 나타냅니다. AWS Ground Station 전용 안테나 고객은 유지 관리 기간도 볼 수 있습니다.

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

예약 나열

예약을 나열하려면 지상국 식별자와 시간 범위를 사용하여 ListGroundStationReservations를 호출합니다. API는 지정된 기간 내에 지상국의 모든 안테나에 대한 예약을 반환합니다.

표시되는 예약은 액세스 수준에 따라 다릅니다.

예약 유형

각 예약에는 안테나 시간이 사용되는 대상을 나타내는 유형이 있습니다.

코드 예제

다음 예시에서는 예약 유형별 필터링을 포함하여 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']}"
        )