AWS ground-station documentation change
Summary
Added documentation for Dedicated Antennas feature and how to view antennas at ground stations using ListAntennas API, including a Python code example
Security assessment
The changes add new feature documentation for Dedicated Antennas (custom-built antenna systems) and API usage examples. There is no evidence of addressing security vulnerabilities or weaknesses. The mention that Dedicated Antenna locations/capabilities are not publicly disclosed is a standard privacy/security measure for custom infrastructure, not a response to a security incident.
Diff
diff --git a/ground-station/latest/ug/aws-ground-station-antenna-locations.md b/ground-station/latest/ug/aws-ground-station-antenna-locations.md index 17a897ae1..f09397b86 100644 --- a//ground-station/latest/ug/aws-ground-station-antenna-locations.md +++ b//ground-station/latest/ug/aws-ground-station-antenna-locations.md @@ -7 +7 @@ -Finding the AWS region for a ground station locationAWS Ground Station supported AWS RegionsDigital twin availability +Finding the AWS region for a ground station locationAWS Ground Station supported AWS RegionsDigital twin availabilityDedicated AntennasViewing antennas at a ground station @@ -41,0 +42,50 @@ You can deliver data and configure your **Contacts** via the AWS SDK or the AWS +## Dedicated Antennas + +In addition to the publicly available ground station locations listed above, AWS Ground Station offers Dedicated Antennas. A Dedicated Antenna is a custom-built antenna system that AWS manages on your behalf. A Dedicated Antenna is not restricted to existing AWS Ground Station ground station locations and can be built with capabilities beyond those of public ground stations as described in [AWS Ground Station Site Capabilities](./locations.capabilities.html). The locations and capabilities of Dedicated Antennas are not publicly disclosed. + +For more information about Dedicated Antennas, see [AWS Ground Station Dedicated Antennas](./dedicated-antennas.html). To learn more or to get started with Dedicated Antennas, contact AWS Support through the [AWS Support Center Console](https://console.aws.amazon.com/support). + +## Viewing antennas at a ground station + +Each ground station location has one or more antennas. You can view the antennas at a ground station by using the [ListAntennas](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListAntennas.html) API. This API returns the antennas at a specified ground station, including each antenna's name. + +Antenna information is useful when combined with the [ListGroundStationReservations](https://docs.aws.amazon.com/ground-station/latest/APIReference/API_ListGroundStationReservations.html) API to understand capacity and availability at a ground station. For more information about viewing reservations, see [View ground station reservations](./locations.reservations.html). + +To call `ListAntennas`, you must have a satellite onboarded to the ground station or have azimuth elevation ephemeris permissions for the ground station. For more information, see [Provide azimuth elevation ephemeris data](./providing-azimuth-elevation-ephemeris-data.html). + +### Example: List antennas at a ground station + +The following example lists all antennas at a ground station using the AWS SDK for Python (Boto3). + + + import boto3 + + # Create AWS Ground Station client + ground_station_client = boto3.client("groundstation") + + # The ground station ID to list antennas for. + # Use the ListGroundStations API to find available ground station IDs. + ground_station_id = "Ohio 1" + + # List all antennas at a ground station. + # This is useful for understanding the capacity of a ground station + # and for planning multi-antenna operations. + print(f"Listing antennas for ground station '{ground_station_id}'...") + + paginator = ground_station_client.get_paginator("list_antennas") + page_iterator = paginator.paginate( + groundStationId=ground_station_id, + PaginationConfig={ + "MaxItems": 100, + "PageSize": 20, + }, + ) + + for page in page_iterator: + for antenna in page["antennaList"]: + print(f" Antenna: {antenna['antennaName']}") + print(f" Ground Station: {antenna['groundStationName']}") + print(f" Region: {antenna['region']}") + print() + + @@ -50 +100 @@ Understand next steps -AWS Ground Station site masks +View ground station reservations