View a markdown version of this page

查看地面站预订 - AWS Ground Station
房源预订预订类型代码示例

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

查看地面站预订

您可以使用 API 查看地面站天线上的预留情况。ListGroundStationReservations预约代表天线上的时间段，包括您的预定联系人。 AWS Ground Station 专用天线客户还会看到维护窗口。

这些信息可以帮助您在计划联系时间表时了解天线的可用性，并提供地面站天线上正在发生的事情的可见性。

房源预订

要列出预订，请致电并ListGroundStationReservations提供地面站标识符和时间范围。API 会返回指定时间窗口内地面站所有天线的预留量。

您看到的预订取决于您的访问级别：

  • 公共 AWS Ground Station 客户-您只能看到自己的联系人预订。不包括其他账户拥有的维护窗口和联系人。

  • AWS Ground Station 专属天线客户 — 您可以在专用天线上查看所有预订，包括维护时段和其他账户安排的联系方式。仅包含您拥有的联系人的联系人标识符。有关更多信息，请参阅 AWS Ground Station 专用天线。

预订类型

每个预留都有一种类型，用于指示天线时间的用途：

  • 联系人-联系人预留代表为卫星通信保留的天线时间。预约开始和结束时间反映了完整的天线预留时间，包括通过前和通过后的时间，而不仅仅是卫星通过窗口。

  • 维护-维护预留代表天线因维护而不可用的时间段。维护预留包括maintenanceType表明维护是计划内还是计划外的。

代码示例

以下示例列出了未来 7 天使用适用于 Python 的 AWS SDK (Boto3) 在地面站进行的预订，包括按预留类型进行筛选。

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