View a markdown version of this page

Lihat reservasi stasiun bumi - AWS Ground Station
Reservasi daftarJenis reservasiContoh kode

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Lihat reservasi stasiun bumi

Anda dapat melihat reservasi di seluruh antena di stasiun bumi dengan menggunakan API. ListGroundStationReservations Reservasi mewakili blok waktu pada antena, termasuk kontak terjadwal Anda. AWS Ground Station Antena Khususpelanggan juga melihat jendela pemeliharaan.

Informasi ini membantu Anda memahami ketersediaan antena saat merencanakan jadwal kontak dan memberikan visibilitas ke apa yang terjadi pada antena di stasiun bumi.

Reservasi daftar

Untuk membuat daftar reservasi, hubungi ListGroundStationReservationsdengan pengenal stasiun bumi dan rentang waktu. API mengembalikan reservasi di semua antena di stasiun bumi dalam jangka waktu yang ditentukan.

Reservasi yang Anda lihat tergantung pada tingkat akses Anda:

  • AWS Ground Station Pelanggan publik — Anda hanya dapat melihat reservasi kontak Anda sendiri. Jendela pemeliharaan dan kontak yang dimiliki oleh akun lain tidak termasuk.

  • AWS Ground Station Pelanggan Antena Khusus — Anda dapat melihat semua pemesanan di Antena Khusus Anda, termasuk jendela pemeliharaan dan kontak yang dijadwalkan oleh akun lain. Pengidentifikasi kontak hanya disertakan untuk kontak yang Anda miliki. Untuk informasi selengkapnya, lihat AWS Ground Station Antena Khusus.

Jenis reservasi

Setiap reservasi memiliki jenis yang menunjukkan untuk apa waktu antena digunakan:

  • Kontak - Reservasi kontak mewakili waktu antena yang disediakan untuk komunikasi satelit. Waktu mulai dan akhir reservasi mencerminkan reservasi antena penuh, termasuk waktu pra-pass dan pasca-lulus, bukan hanya jendela pass satelit.

  • Pemeliharaan - Reservasi pemeliharaan mewakili periode waktu ketika antena tidak tersedia karena pemeliharaan. Reservasi pemeliharaan termasuk a maintenanceType yang menunjukkan apakah pemeliharaan direncanakan atau tidak direncanakan.

Contoh kode

Contoh berikut mencantumkan reservasi di stasiun bumi selama 7 hari ke depan menggunakan AWS SDK for Python (Boto3), termasuk pemfilteran berdasarkan jenis reservasi. 

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