View a markdown version of this page

檢視地面站點保留 - AWS Ground Station
列出保留保留類型程式碼範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

檢視地面站點保留

您可以使用 ListGroundStationReservations API，在地面工作站檢視跨天線的保留。預留代表天線上的時間區塊，包括您的排程聯絡人。 AWS Ground Station 專用天線 客戶也會看到維護時段。

此資訊可協助您了解規劃聯絡排程時的天線可用性，並讓您了解地面工作站天線上發生的情況。

列出保留

若要列出保留，請呼叫 ListGroundStationReservations，其中包含地面工作站識別符和時間範圍。API 會在指定的時段內，傳回地面工作站所有天線的保留。

您看到的保留取決於您的存取層級：

  • 公有 AWS Ground Station 客戶 — 您只能看到自己的聯絡人保留。不包含其他帳戶擁有的維護時段和聯絡人。

  • AWS Ground Station 專用天線客戶 — 您可以在專用天線上查看所有保留，包括維護時段和其他帳戶排程的聯絡人。僅包含您擁有的聯絡人的聯絡人識別符。如需詳細資訊，請參閱AWS Ground Station 專用天線。

保留類型

每個保留都有一個類型，指出天線時間的用途：

  • 聯絡人 — 聯絡人保留代表為衛星通訊預留的天線時間。保留開始和結束時間反映完整的天線保留，包括傳遞前和傳遞後時間，而不只是衛星傳遞時段。

  • 維護 — 維護保留代表天線因維護而無法使用的期間。維護保留包括maintenanceType指出維護是計劃還是計劃外的 。

程式碼範例

下列範例使用適用於 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']}"
        )