@aws-sdk/client-groundstation 3.918.0 → 3.919.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (29) hide show
  1. package/README.md +1 -4
  2. package/dist-cjs/endpoint/ruleset.js +1 -1
  3. package/dist-cjs/index.js +169 -0
  4. package/dist-es/endpoint/ruleset.js +1 -1
  5. package/dist-es/models/models_0.js +88 -0
  6. package/dist-es/protocols/Aws_restJson1.js +80 -2
  7. package/dist-types/GroundStation.d.ts +1 -4
  8. package/dist-types/GroundStationClient.d.ts +1 -4
  9. package/dist-types/commands/CreateConfigCommand.d.ts +1 -2
  10. package/dist-types/commands/CreateDataflowEndpointGroupCommand.d.ts +1 -5
  11. package/dist-types/commands/CreateEphemerisCommand.d.ts +31 -2
  12. package/dist-types/commands/CreateMissionProfileCommand.d.ts +1 -4
  13. package/dist-types/commands/DeleteEphemerisCommand.d.ts +4 -1
  14. package/dist-types/commands/DescribeContactCommand.d.ts +11 -0
  15. package/dist-types/commands/DescribeEphemerisCommand.d.ts +15 -1
  16. package/dist-types/commands/GetAgentConfigurationCommand.d.ts +1 -4
  17. package/dist-types/commands/GetConfigCommand.d.ts +1 -2
  18. package/dist-types/commands/ListContactsCommand.d.ts +10 -4
  19. package/dist-types/commands/ListEphemeridesCommand.d.ts +4 -2
  20. package/dist-types/commands/RegisterAgentCommand.d.ts +1 -4
  21. package/dist-types/commands/ReserveContactCommand.d.ts +11 -1
  22. package/dist-types/commands/UpdateAgentStatusCommand.d.ts +1 -4
  23. package/dist-types/commands/UpdateConfigCommand.d.ts +1 -3
  24. package/dist-types/commands/UpdateEphemerisCommand.d.ts +1 -1
  25. package/dist-types/commands/UpdateMissionProfileCommand.d.ts +1 -3
  26. package/dist-types/index.d.ts +1 -4
  27. package/dist-types/models/models_0.d.ts +474 -167
  28. package/dist-types/ts3.4/models/models_0.d.ts +196 -8
  29. package/package.json +3 -3
@@ -108,10 +108,7 @@ export interface AgentDetails {
108
108
  */
109
109
  instanceType: string | undefined;
110
110
  /**
111
- * <note>
112
- * <p>This field should not be used. Use agentCpuCores instead.</p>
113
- * </note>
114
- * <p>List of CPU cores reserved for processes other than the agent running on the EC2 instance.</p>
111
+ * <note> <p>This field should not be used. Use agentCpuCores instead.</p> </note> <p>List of CPU cores reserved for processes other than the agent running on the EC2 instance.</p>
115
112
  * @public
116
113
  */
117
114
  reservedCpuCores?: number[] | undefined;
@@ -325,18 +322,7 @@ export type BandwidthUnits = (typeof BandwidthUnits)[keyof typeof BandwidthUnits
325
322
  */
326
323
  export interface FrequencyBandwidth {
327
324
  /**
328
- * <p>Frequency bandwidth value. AWS Ground Station currently has the following bandwidth limitations:</p>
329
- * <ul>
330
- * <li>
331
- * <p>For <code>AntennaDownlinkDemodDecodeconfig</code>, valid values are between 125 kHz to 650 MHz.</p>
332
- * </li>
333
- * <li>
334
- * <p>For <code>AntennaDownlinkconfig</code>, valid values are between 10 kHz to 54 MHz.</p>
335
- * </li>
336
- * <li>
337
- * <p>For <code>AntennaUplinkConfig</code>, valid values are between 10 kHz to 54 MHz.</p>
338
- * </li>
339
- * </ul>
325
+ * <p>Frequency bandwidth value. AWS Ground Station currently has the following bandwidth limitations:</p> <ul> <li> <p>For <code>AntennaDownlinkDemodDecodeconfig</code>, valid values are between 125 kHz to 650 MHz.</p> </li> <li> <p>For <code>AntennaDownlinkconfig</code>, valid values are between 10 kHz to 54 MHz.</p> </li> <li> <p>For <code>AntennaUplinkConfig</code>, valid values are between 10 kHz to 54 MHz.</p> </li> </ul>
340
326
  * @public
341
327
  */
342
328
  value: number | undefined;
@@ -399,18 +385,7 @@ export interface SpectrumConfig {
399
385
  */
400
386
  centerFrequency: Frequency | undefined;
401
387
  /**
402
- * <p>Bandwidth of a spectral <code>Config</code>. AWS Ground Station currently has the following bandwidth limitations:</p>
403
- * <ul>
404
- * <li>
405
- * <p>For <code>AntennaDownlinkDemodDecodeconfig</code>, valid values are between 125 kHz to 650 MHz.</p>
406
- * </li>
407
- * <li>
408
- * <p>For <code>AntennaDownlinkconfig</code> valid values are between 10 kHz to 54 MHz.</p>
409
- * </li>
410
- * <li>
411
- * <p>For <code>AntennaUplinkConfig</code>, valid values are between 10 kHz to 54 MHz.</p>
412
- * </li>
413
- * </ul>
388
+ * <p>Bandwidth of a spectral <code>Config</code>. AWS Ground Station currently has the following bandwidth limitations:</p> <ul> <li> <p>For <code>AntennaDownlinkDemodDecodeconfig</code>, valid values are between 125 kHz to 650 MHz.</p> </li> <li> <p>For <code>AntennaDownlinkconfig</code> valid values are between 10 kHz to 54 MHz.</p> </li> <li> <p>For <code>AntennaUplinkConfig</code>, valid values are between 10 kHz to 54 MHz.</p> </li> </ul>
414
389
  * @public
415
390
  */
416
391
  bandwidth: FrequencyBandwidth | undefined;
@@ -421,8 +396,7 @@ export interface SpectrumConfig {
421
396
  polarization?: Polarization | undefined;
422
397
  }
423
398
  /**
424
- * <p>Information about how AWS Ground Station should configure an
425
- * antenna for downlink during a contact.</p>
399
+ * <p>Information about how AWS Ground Station should configure an antenna for downlink during a contact.</p>
426
400
  * @public
427
401
  */
428
402
  export interface AntennaDownlinkConfig {
@@ -662,6 +636,181 @@ export interface AwsGroundStationAgentEndpoint {
662
636
  */
663
637
  auditResults?: AuditResults | undefined;
664
638
  }
639
+ /**
640
+ * <p>Time-tagged azimuth elevation pointing data.</p> <p>Specifies the antenna pointing direction at a specific time offset from the segment's reference epoch.</p>
641
+ * @public
642
+ */
643
+ export interface TimeAzEl {
644
+ /**
645
+ * <p>Time offset in atomic seconds from the segment's reference epoch.</p> <p>All <code>dt</code> values within a segment must be in ascending order with no duplicates.</p> <p> <code>dt</code> values may be:</p> <ul> <li> <p>negative</p> </li> <li> <p>expressed as fractions of a second</p> </li> <li> <p>expressed in scientific notation</p> </li> </ul>
646
+ * @public
647
+ */
648
+ dt: number | undefined;
649
+ /**
650
+ * <p>Azimuth angle at the specified time.</p> <p>Valid ranges by unit:</p> <ul> <li> <p> <code>DEGREE_ANGLE</code>: -180 to 360 degrees, measured clockwise from true north</p> </li> <li> <p> <code>RADIAN</code>: -π to 2π radians, measured clockwise from true north</p> </li> </ul>
651
+ * @public
652
+ */
653
+ az: number | undefined;
654
+ /**
655
+ * <p>Elevation angle at the specified time.</p> <p>Valid ranges by unit:</p> <ul> <li> <p> <code>DEGREE_ANGLE</code>: -90 to 90 degrees, where 0 is the horizon, 90 is zenith, and negative values are below the horizon </p> </li> <li> <p> <code>RADIAN</code>: -π/2 to π/2 radians, where 0 is the horizon, π/2 is zenith, and negative values are below the horizon </p> </li> </ul>
656
+ * @public
657
+ */
658
+ el: number | undefined;
659
+ }
660
+ /**
661
+ * <p>Time range specified using ISO 8601 format timestamps.</p>
662
+ * @public
663
+ */
664
+ export interface ISO8601TimeRange {
665
+ /**
666
+ * <p>Start time in ISO 8601 format in Coordinated Universal Time (UTC).</p> <p>Example: <code>2026-11-15T10:28:48.000Z</code> </p>
667
+ * @public
668
+ */
669
+ startTime: Date | undefined;
670
+ /**
671
+ * <p>End time in ISO 8601 format in Coordinated Universal Time (UTC).</p> <p>Example: <code>2024-01-15T12:00:00.000Z</code> </p>
672
+ * @public
673
+ */
674
+ endTime: Date | undefined;
675
+ }
676
+ /**
677
+ * <p>A time segment containing azimuth elevation pointing data.</p> <p> Each segment defines a continuous time period with pointing angle data points. AWS Ground Station uses 4th order Lagrange interpolation between the provided points, so each segment must contain at least five data points. </p>
678
+ * @public
679
+ */
680
+ export interface AzElSegment {
681
+ /**
682
+ * <p>The reference time for this segment in ISO 8601 format in Coordinated Universal Time (UTC).</p> <p>All time values within the segment's <a>AzElSegment$azElList</a> are specified as offsets in atomic seconds from this reference epoch.</p> <p>Example: <code>2024-01-15T12:00:00.000Z</code> </p>
683
+ * @public
684
+ */
685
+ referenceEpoch: Date | undefined;
686
+ /**
687
+ * <p>The valid time range for this segment.</p> <p> Specifies the start and end timestamps in ISO 8601 format in Coordinated Universal Time (UTC). The segment's pointing data must cover this entire time range. </p>
688
+ * @public
689
+ */
690
+ validTimeRange: ISO8601TimeRange | undefined;
691
+ /**
692
+ * <p>List of time-tagged azimuth elevation data points.</p> <p> Must contain at least five points to support 4th order Lagrange interpolation. Points must be in chronological order with no duplicates. </p>
693
+ * @public
694
+ */
695
+ azElList: TimeAzEl[] | undefined;
696
+ }
697
+ /**
698
+ * <p>Azimuth elevation segment collection.</p> <p>Contains five or more time-ordered segments that define antenna pointing angles over the ephemeris validity period.</p>
699
+ * @public
700
+ */
701
+ export interface AzElSegments {
702
+ /**
703
+ * <p>The unit of measure for azimuth and elevation angles. All angles in all segments must use the same unit.</p>
704
+ * @public
705
+ */
706
+ angleUnit: AngleUnits | undefined;
707
+ /**
708
+ * <p>List of azimuth elevation segments.</p> <p>Must contain between 1 and 100 segments. Segments must be in chronological order with no overlaps.</p>
709
+ * @public
710
+ */
711
+ azElSegmentList: AzElSegment[] | undefined;
712
+ }
713
+ /**
714
+ * <p>Object stored in Amazon S3 containing ephemeris data.</p>
715
+ * @public
716
+ */
717
+ export interface S3Object {
718
+ /**
719
+ * <p>An Amazon S3 Bucket name.</p>
720
+ * @public
721
+ */
722
+ bucket?: string | undefined;
723
+ /**
724
+ * <p>An Amazon S3 key for the ephemeris.</p>
725
+ * @public
726
+ */
727
+ key?: string | undefined;
728
+ /**
729
+ * <p>For versioned Amazon S3 objects, the version to use for the ephemeris.</p>
730
+ * @public
731
+ */
732
+ version?: string | undefined;
733
+ }
734
+ /**
735
+ * <p>Container for azimuth elevation segment data.</p> <p>Specify either <a>AzElSegmentsData$s3Object</a> to reference data in Amazon S3, or <a>AzElSegmentsData$azElData</a> to provide data inline.</p>
736
+ * @public
737
+ */
738
+ export type AzElSegmentsData = AzElSegmentsData.AzElDataMember | AzElSegmentsData.S3ObjectMember | AzElSegmentsData.$UnknownMember;
739
+ /**
740
+ * @public
741
+ */
742
+ export declare namespace AzElSegmentsData {
743
+ /**
744
+ * <p>The Amazon S3 object containing azimuth elevation segment data.</p> <p>The Amazon S3 object must contain JSON-formatted azimuth elevation data matching the <a>AzElSegments</a> structure.</p>
745
+ * @public
746
+ */
747
+ interface S3ObjectMember {
748
+ s3Object: S3Object;
749
+ azElData?: never;
750
+ $unknown?: never;
751
+ }
752
+ /**
753
+ * <p>Azimuth elevation segment data provided directly in the request.</p> <p>Use this option for smaller datasets or when Amazon S3 access is not available.</p>
754
+ * @public
755
+ */
756
+ interface AzElDataMember {
757
+ s3Object?: never;
758
+ azElData: AzElSegments;
759
+ $unknown?: never;
760
+ }
761
+ /**
762
+ * @public
763
+ */
764
+ interface $UnknownMember {
765
+ s3Object?: never;
766
+ azElData?: never;
767
+ $unknown: [string, any];
768
+ }
769
+ interface Visitor<T> {
770
+ s3Object: (value: S3Object) => T;
771
+ azElData: (value: AzElSegments) => T;
772
+ _: (name: string, value: any) => T;
773
+ }
774
+ const visit: <T>(value: AzElSegmentsData, visitor: Visitor<T>) => T;
775
+ }
776
+ /**
777
+ * <p>Azimuth elevation ephemeris data.</p> <p> Use this ephemeris type to provide pointing angles directly, rather than satellite orbital elements. Use this when you need precise antenna pointing but have imprecise or unknown satellite trajectory information. </p> <p> The azimuth elevation data specifies the antenna pointing direction at specific times relative to a ground station location. AWS Ground Station uses 4th order Lagrange interpolation to compute pointing angles between the provided data points. </p> <p> AWS Ground Station automatically filters interpolated pointing angles, including only those that are above the site mask elevation of the specified ground station. </p> <p> For more detail about providing azimuth elevation ephemerides to AWS Ground Station, see the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/providing-azimuth-elevation-ephemeris-data.html">azimuth elevation ephemeris section</a> of the AWS Ground Station User Guide. </p>
778
+ * @public
779
+ */
780
+ export interface AzElEphemeris {
781
+ /**
782
+ * <p>The ground station name for which you're providing azimuth elevation data.</p> <p>This ephemeris is specific to this ground station and can't be used at other locations.</p>
783
+ * @public
784
+ */
785
+ groundStation: string | undefined;
786
+ /**
787
+ * <p>Azimuth elevation segment data.</p> <p>You can provide data inline in the request or through an Amazon S3 object reference.</p>
788
+ * @public
789
+ */
790
+ data: AzElSegmentsData | undefined;
791
+ }
792
+ /**
793
+ * <p>Filter for selecting contacts that use a specific <a>AzElEphemeris</a>.</p>
794
+ * @public
795
+ */
796
+ export interface AzElEphemerisFilter {
797
+ /**
798
+ * <p>Unique identifier of the azimuth elevation ephemeris.</p>
799
+ * @public
800
+ */
801
+ id: string | undefined;
802
+ }
803
+ /**
804
+ * <p>Program track settings for <a>AzElEphemeris</a>.</p>
805
+ * @public
806
+ */
807
+ export interface AzElProgramTrackSettings {
808
+ /**
809
+ * <p>Unique identifier of the azimuth elevation ephemeris.</p>
810
+ * @public
811
+ */
812
+ ephemerisId: string | undefined;
813
+ }
665
814
  /**
666
815
  * <p/>
667
816
  * @public
@@ -802,8 +951,7 @@ export declare const Criticality: {
802
951
  */
803
952
  export type Criticality = (typeof Criticality)[keyof typeof Criticality];
804
953
  /**
805
- * <p>Object that determines whether tracking should be used during a contact
806
- * executed with this <code>Config</code> in the mission profile.</p>
954
+ * <p>Object that determines whether tracking should be used during a contact executed with this <code>Config</code> in the mission profile.</p>
807
955
  * @public
808
956
  */
809
957
  export interface TrackingConfig {
@@ -814,10 +962,7 @@ export interface TrackingConfig {
814
962
  autotrack: Criticality | undefined;
815
963
  }
816
964
  /**
817
- * <p>Information about an uplink echo <code>Config</code>.</p>
818
- * <p>Parameters from the <code>AntennaUplinkConfig</code>, corresponding to the
819
- * specified <code>AntennaUplinkConfigArn</code>, are used when this <code>UplinkEchoConfig</code>
820
- * is used in a contact.</p>
965
+ * <p>Information about an uplink echo <code>Config</code>.</p> <p>Parameters from the <code>AntennaUplinkConfig</code>, corresponding to the specified <code>AntennaUplinkConfigArn</code>, are used when this <code>UplinkEchoConfig</code> is used in a contact.</p>
821
966
  * @public
822
967
  */
823
968
  export interface UplinkEchoConfig {
@@ -833,8 +978,7 @@ export interface UplinkEchoConfig {
833
978
  antennaUplinkConfigArn: string | undefined;
834
979
  }
835
980
  /**
836
- * <p>Object containing the parameters of a <code>Config</code>.</p>
837
- * <p>See the subtype definitions for what each type of <code>Config</code> contains.</p>
981
+ * <p>Object containing the parameters of a <code>Config</code>.</p> <p>See the subtype definitions for what each type of <code>Config</code> contains.</p>
838
982
  * @public
839
983
  */
840
984
  export type ConfigTypeData = ConfigTypeData.AntennaDownlinkConfigMember | ConfigTypeData.AntennaDownlinkDemodDecodeConfigMember | ConfigTypeData.AntennaUplinkConfigMember | ConfigTypeData.DataflowEndpointConfigMember | ConfigTypeData.S3RecordingConfigMember | ConfigTypeData.TrackingConfigMember | ConfigTypeData.UplinkEchoConfigMember | ConfigTypeData.$UnknownMember;
@@ -913,8 +1057,7 @@ export declare namespace ConfigTypeData {
913
1057
  $unknown?: never;
914
1058
  }
915
1059
  /**
916
- * <p>Information about an uplink echo <code>Config</code>.</p>
917
- * <p>Parameters from the <code>AntennaUplinkConfig</code>, corresponding to the specified <code>AntennaUplinkConfigArn</code>, are used when this <code>UplinkEchoConfig</code> is used in a contact.</p>
1060
+ * <p>Information about an uplink echo <code>Config</code>.</p> <p>Parameters from the <code>AntennaUplinkConfig</code>, corresponding to the specified <code>AntennaUplinkConfigArn</code>, are used when this <code>UplinkEchoConfig</code> is used in a contact.</p>
918
1061
  * @public
919
1062
  */
920
1063
  interface UplinkEchoConfigMember {
@@ -1047,8 +1190,7 @@ export interface GetConfigResponse {
1047
1190
  */
1048
1191
  configId: string | undefined;
1049
1192
  /**
1050
- * <p>ARN of a <code>Config</code>
1051
- * </p>
1193
+ * <p>ARN of a <code>Config</code> </p>
1052
1194
  * @public
1053
1195
  */
1054
1196
  configArn: string | undefined;
@@ -1398,8 +1540,7 @@ export interface Source {
1398
1540
  */
1399
1541
  configId?: string | undefined;
1400
1542
  /**
1401
- * <p>Additional details for a <code>Config</code>, if type is <code>dataflow-endpoint</code> or <code>antenna-downlink-demod-decode</code>
1402
- * </p>
1543
+ * <p>Additional details for a <code>Config</code>, if type is <code>dataflow-endpoint</code> or <code>antenna-downlink-demod-decode</code> </p>
1403
1544
  * @public
1404
1545
  */
1405
1546
  configDetails?: ConfigDetails | undefined;
@@ -1430,6 +1571,36 @@ export interface DataflowDetail {
1430
1571
  */
1431
1572
  errorMessage?: string | undefined;
1432
1573
  }
1574
+ /**
1575
+ * @public
1576
+ * @enum
1577
+ */
1578
+ export declare const EphemerisType: {
1579
+ readonly AZ_EL: "AZ_EL";
1580
+ readonly OEM: "OEM";
1581
+ readonly SERVICE_MANAGED: "SERVICE_MANAGED";
1582
+ readonly TLE: "TLE";
1583
+ };
1584
+ /**
1585
+ * @public
1586
+ */
1587
+ export type EphemerisType = (typeof EphemerisType)[keyof typeof EphemerisType];
1588
+ /**
1589
+ * <p>Ephemeris data for a contact.</p>
1590
+ * @public
1591
+ */
1592
+ export interface EphemerisResponseData {
1593
+ /**
1594
+ * <p>Unique identifier of the ephemeris. Appears only for custom ephemerides.</p>
1595
+ * @public
1596
+ */
1597
+ ephemerisId?: string | undefined;
1598
+ /**
1599
+ * <p>Type of ephemeris.</p>
1600
+ * @public
1601
+ */
1602
+ ephemerisType: EphemerisType | undefined;
1603
+ }
1433
1604
  /**
1434
1605
  * <p>Elevation angle of the satellite in the sky during a contact.</p>
1435
1606
  * @public
@@ -1446,6 +1617,47 @@ export interface Elevation {
1446
1617
  */
1447
1618
  unit: AngleUnits | undefined;
1448
1619
  }
1620
+ /**
1621
+ * <p>Program track settings for an antenna during a contact.</p>
1622
+ * @public
1623
+ */
1624
+ export type ProgramTrackSettings = ProgramTrackSettings.AzElMember | ProgramTrackSettings.$UnknownMember;
1625
+ /**
1626
+ * @public
1627
+ */
1628
+ export declare namespace ProgramTrackSettings {
1629
+ /**
1630
+ * <p>Program track settings for <a>AzElEphemeris</a>.</p>
1631
+ * @public
1632
+ */
1633
+ interface AzElMember {
1634
+ azEl: AzElProgramTrackSettings;
1635
+ $unknown?: never;
1636
+ }
1637
+ /**
1638
+ * @public
1639
+ */
1640
+ interface $UnknownMember {
1641
+ azEl?: never;
1642
+ $unknown: [string, any];
1643
+ }
1644
+ interface Visitor<T> {
1645
+ azEl: (value: AzElProgramTrackSettings) => T;
1646
+ _: (name: string, value: any) => T;
1647
+ }
1648
+ const visit: <T>(value: ProgramTrackSettings, visitor: Visitor<T>) => T;
1649
+ }
1650
+ /**
1651
+ * <p>Overrides the default tracking configuration on an antenna during a contact.</p>
1652
+ * @public
1653
+ */
1654
+ export interface TrackingOverrides {
1655
+ /**
1656
+ * <p>Program track settings to override for antenna tracking during the contact.</p>
1657
+ * @public
1658
+ */
1659
+ programTrackSettings: ProgramTrackSettings | undefined;
1660
+ }
1449
1661
  /**
1450
1662
  * <p/>
1451
1663
  * @public
@@ -1522,25 +1734,55 @@ export interface DescribeContactResponse {
1522
1734
  */
1523
1735
  dataflowList?: DataflowDetail[] | undefined;
1524
1736
  /**
1525
- * <p>
1526
- * Projected time in UTC your satellite will rise above the
1527
- * <a href="https://docs.aws.amazon.com/ground-station/latest/ug/site-masks.html">receive mask</a>.
1528
- * This time is based on the satellite's current active ephemeris for future contacts and the ephemeris that was
1529
- * active during contact execution for completed contacts.
1530
- * </p>
1737
+ * <p> Projected time in UTC your satellite will rise above the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/site-masks.html">receive mask</a>. This time is based on the satellite's current active ephemeris for future contacts and the ephemeris that was active during contact execution for completed contacts. </p>
1531
1738
  * @public
1532
1739
  */
1533
1740
  visibilityStartTime?: Date | undefined;
1534
1741
  /**
1535
- * <p>
1536
- * Projected time in UTC your satellite will set below the
1537
- * <a href="https://docs.aws.amazon.com/ground-station/latest/ug/site-masks.html">receive mask</a>.
1538
- * This time is based on the satellite's current active ephemeris for future contacts and the ephemeris that was
1539
- * active during contact execution for completed contacts.
1540
- * </p>
1742
+ * <p> Projected time in UTC your satellite will set below the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/site-masks.html">receive mask</a>. This time is based on the satellite's current active ephemeris for future contacts and the ephemeris that was active during contact execution for completed contacts. </p>
1541
1743
  * @public
1542
1744
  */
1543
1745
  visibilityEndTime?: Date | undefined;
1746
+ /**
1747
+ * <p>Tracking configuration overrides specified when the contact was reserved.</p>
1748
+ * @public
1749
+ */
1750
+ trackingOverrides?: TrackingOverrides | undefined;
1751
+ /**
1752
+ * <p>The ephemeris that determines antenna pointing directions for the contact.</p>
1753
+ * @public
1754
+ */
1755
+ ephemeris?: EphemerisResponseData | undefined;
1756
+ }
1757
+ /**
1758
+ * <p>Filter for selecting contacts that use a specific ephemeris".</p>
1759
+ * @public
1760
+ */
1761
+ export type EphemerisFilter = EphemerisFilter.AzElMember | EphemerisFilter.$UnknownMember;
1762
+ /**
1763
+ * @public
1764
+ */
1765
+ export declare namespace EphemerisFilter {
1766
+ /**
1767
+ * <p>Filter for <a>AzElEphemeris</a>.</p>
1768
+ * @public
1769
+ */
1770
+ interface AzElMember {
1771
+ azEl: AzElEphemerisFilter;
1772
+ $unknown?: never;
1773
+ }
1774
+ /**
1775
+ * @public
1776
+ */
1777
+ interface $UnknownMember {
1778
+ azEl?: never;
1779
+ $unknown: [string, any];
1780
+ }
1781
+ interface Visitor<T> {
1782
+ azEl: (value: AzElEphemerisFilter) => T;
1783
+ _: (name: string, value: any) => T;
1784
+ }
1785
+ const visit: <T>(value: EphemerisFilter, visitor: Visitor<T>) => T;
1544
1786
  }
1545
1787
  /**
1546
1788
  * <p/>
@@ -1587,6 +1829,11 @@ export interface ListContactsRequest {
1587
1829
  * @public
1588
1830
  */
1589
1831
  missionProfileArn?: string | undefined;
1832
+ /**
1833
+ * <p>Filter for selecting contacts that use a specific ephemeris".</p>
1834
+ * @public
1835
+ */
1836
+ ephemeris?: EphemerisFilter | undefined;
1590
1837
  }
1591
1838
  /**
1592
1839
  * <p>Data describing a contact.</p>
@@ -1659,27 +1906,20 @@ export interface ContactData {
1659
1906
  */
1660
1907
  tags?: Record<string, string> | undefined;
1661
1908
  /**
1662
- * <p>
1663
- * Projected time in UTC your satellite will rise above the
1664
- * <a href="https://docs.aws.amazon.com/ground-station/latest/ug/site-masks.html">receive mask</a>.
1665
- * This time is based on the satellite's current active ephemeris for future contacts and the ephemeris that was
1666
- * active during contact execution for completed contacts.
1667
- * <i>This field is not present for contacts with a <code>SCHEDULING</code> or <code>SCHEDULED</code> status.</i>
1668
- * </p>
1909
+ * <p> Projected time in UTC your satellite will rise above the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/site-masks.html">receive mask</a>. This time is based on the satellite's current active ephemeris for future contacts and the ephemeris that was active during contact execution for completed contacts. <i>This field is not present for contacts with a <code>SCHEDULING</code> or <code>SCHEDULED</code> status.</i> </p>
1669
1910
  * @public
1670
1911
  */
1671
1912
  visibilityStartTime?: Date | undefined;
1672
1913
  /**
1673
- * <p>
1674
- * Projected time in UTC your satellite will set below the
1675
- * <a href="https://docs.aws.amazon.com/ground-station/latest/ug/site-masks.html">receive mask</a>.
1676
- * This time is based on the satellite's current active ephemeris for future contacts and the ephemeris that was
1677
- * active during contact execution for completed contacts.
1678
- * <i>This field is not present for contacts with a <code>SCHEDULING</code> or <code>SCHEDULED</code> status.</i>
1679
- * </p>
1914
+ * <p> Projected time in UTC your satellite will set below the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/site-masks.html">receive mask</a>. This time is based on the satellite's current active ephemeris for future contacts and the ephemeris that was active during contact execution for completed contacts. <i>This field is not present for contacts with a <code>SCHEDULING</code> or <code>SCHEDULED</code> status.</i> </p>
1680
1915
  * @public
1681
1916
  */
1682
1917
  visibilityEndTime?: Date | undefined;
1918
+ /**
1919
+ * <p>The ephemeris that determines antenna pointing for the contact.</p>
1920
+ * @public
1921
+ */
1922
+ ephemeris?: EphemerisResponseData | undefined;
1683
1923
  }
1684
1924
  /**
1685
1925
  * <p/>
@@ -1711,7 +1951,7 @@ export interface ReserveContactRequest {
1711
1951
  * <p>ARN of a satellite</p>
1712
1952
  * @public
1713
1953
  */
1714
- satelliteArn: string | undefined;
1954
+ satelliteArn?: string | undefined;
1715
1955
  /**
1716
1956
  * <p>Start time of a contact in UTC.</p>
1717
1957
  * @public
@@ -1732,6 +1972,11 @@ export interface ReserveContactRequest {
1732
1972
  * @public
1733
1973
  */
1734
1974
  tags?: Record<string, string> | undefined;
1975
+ /**
1976
+ * <p>Tracking configuration overrides for the contact.</p>
1977
+ * @public
1978
+ */
1979
+ trackingOverrides?: TrackingOverrides | undefined;
1735
1980
  }
1736
1981
  /**
1737
1982
  * <p/>
@@ -1739,15 +1984,7 @@ export interface ReserveContactRequest {
1739
1984
  */
1740
1985
  export interface CreateDataflowEndpointGroupRequest {
1741
1986
  /**
1742
- * <p>Endpoint details of each endpoint in the dataflow endpoint group.
1743
- *
1744
- * All dataflow endpoints within a single dataflow endpoint group must be of the same type.
1745
- * You cannot mix <a href="https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AwsGroundStationAgentEndpoint.html">
1746
- * AWS Ground Station Agent endpoints</a> with
1747
- * <a href="https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html">Dataflow endpoints</a> in the same group.
1748
- * If your use case requires both types of endpoints, you must create separate dataflow endpoint
1749
- * groups for each type.
1750
- * </p>
1987
+ * <p>Endpoint details of each endpoint in the dataflow endpoint group. All dataflow endpoints within a single dataflow endpoint group must be of the same type. You cannot mix <a href="https://docs.aws.amazon.com/ground-station/latest/APIReference/API_AwsGroundStationAgentEndpoint.html"> AWS Ground Station Agent endpoints</a> with <a href="https://docs.aws.amazon.com/ground-station/latest/APIReference/API_DataflowEndpoint.html">Dataflow endpoints</a> in the same group. If your use case requires both types of endpoints, you must create separate dataflow endpoint groups for each type. </p>
1751
1988
  * @public
1752
1989
  */
1753
1990
  endpointDetails: EndpointDetails[] | undefined;
@@ -1779,43 +2016,17 @@ export interface DataflowEndpointGroupIdResponse {
1779
2016
  dataflowEndpointGroupId?: string | undefined;
1780
2017
  }
1781
2018
  /**
1782
- * <p>Object stored in S3 containing ephemeris data.</p>
1783
- * @public
1784
- */
1785
- export interface S3Object {
1786
- /**
1787
- * <p>An Amazon S3 Bucket name.</p>
1788
- * @public
1789
- */
1790
- bucket?: string | undefined;
1791
- /**
1792
- * <p>An Amazon S3 key for the ephemeris.</p>
1793
- * @public
1794
- */
1795
- key?: string | undefined;
1796
- /**
1797
- * <p>For versioned S3 objects, the version to use for the ephemeris.</p>
1798
- * @public
1799
- */
1800
- version?: string | undefined;
1801
- }
1802
- /**
1803
- * <p>
1804
- * Ephemeris data in Orbit Ephemeris Message (OEM) format.
1805
- * </p>
1806
- * <p>
1807
- * AWS Ground Station processes OEM Customer Provided Ephemerides according to the <a href="https://public.ccsds.org/Pubs/502x0b3e1.pdf">CCSDS standard</a> with some extra restrictions. OEM files should be in KVN format. For more detail about the OEM format that AWS Ground Station supports, see <a href="https://docs.aws.amazon.com/ground-station/latest/ug/providing-custom-ephemeris-data.html#oem-ephemeris-format">OEM ephemeris format</a> in the AWS Ground Station user guide.
1808
- * </p>
2019
+ * <p>Ephemeris data in Orbit Ephemeris Message (OEM) format.</p> <p> AWS Ground Station processes OEM ephemerides according to the <a href="https://ccsds.org/wp-content/uploads/gravity_forms/5-448e85c647331d9cbaf66c096458bdd5/2025/01//502x0b3e1.pdf">CCSDS standard</a> with some extra restrictions. OEM files should be in KVN format. For more detail about the OEM format that AWS Ground Station supports, see <a href="https://docs.aws.amazon.com/ground-station/latest/ug/providing-oem-ephemeris-data.html#oem-ephemeris-format">OEM ephemeris format</a> in the AWS Ground Station user guide. </p>
1809
2020
  * @public
1810
2021
  */
1811
2022
  export interface OEMEphemeris {
1812
2023
  /**
1813
- * <p>Identifies the S3 object to be used as the ephemeris.</p>
2024
+ * <p>The Amazon S3 object that contains the ephemeris data.</p>
1814
2025
  * @public
1815
2026
  */
1816
2027
  s3Object?: S3Object | undefined;
1817
2028
  /**
1818
- * <p>The data for an OEM ephemeris, supplied directly in the request rather than through an S3 object.</p>
2029
+ * <p>OEM data that you provide directly instead of using an Amazon S3 object.</p>
1819
2030
  * @public
1820
2031
  */
1821
2032
  oemData?: string | undefined;
@@ -1826,12 +2037,12 @@ export interface OEMEphemeris {
1826
2037
  */
1827
2038
  export interface TimeRange {
1828
2039
  /**
1829
- * <p>Time in UTC at which the time range starts.</p>
2040
+ * <p>Unix epoch timestamp in UTC at which the time range starts.</p>
1830
2041
  * @public
1831
2042
  */
1832
2043
  startTime: Date | undefined;
1833
2044
  /**
1834
- * <p>Time in UTC at which the time range ends.</p>
2045
+ * <p>Unix epoch timestamp in UTC at which the time range ends.</p>
1835
2046
  * @public
1836
2047
  */
1837
2048
  endTime: Date | undefined;
@@ -1852,23 +2063,23 @@ export interface TLEData {
1852
2063
  */
1853
2064
  tleLine2: string | undefined;
1854
2065
  /**
1855
- * <p>The valid time range for the TLE. Gaps or overlap are not permitted.</p>
2066
+ * <p>The valid time range for the TLE. Time ranges must be continuous without gaps or overlaps.</p>
1856
2067
  * @public
1857
2068
  */
1858
2069
  validTimeRange: TimeRange | undefined;
1859
2070
  }
1860
2071
  /**
1861
- * <p>Two-line element set (TLE) ephemeris.</p>
2072
+ * <p>Two-line element set (TLE) ephemeris.</p> <p> For more detail about providing Two-line element sets to AWS Ground Station, see the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/providing-tle-ephemeris-data.html">TLE section</a> of the AWS Ground Station user guide. </p>
1862
2073
  * @public
1863
2074
  */
1864
2075
  export interface TLEEphemeris {
1865
2076
  /**
1866
- * <p>Identifies the S3 object to be used as the ephemeris.</p>
2077
+ * <p>The Amazon S3 object that contains the ephemeris data.</p>
1867
2078
  * @public
1868
2079
  */
1869
2080
  s3Object?: S3Object | undefined;
1870
2081
  /**
1871
- * <p>The data for a TLE ephemeris, supplied directly in the request rather than through an S3 object.</p>
2082
+ * <p>TLE data that you provide directly instead of using an Amazon S3 object.</p>
1872
2083
  * @public
1873
2084
  */
1874
2085
  tleData?: TLEData[] | undefined;
@@ -1877,32 +2088,39 @@ export interface TLEEphemeris {
1877
2088
  * <p>Ephemeris data.</p>
1878
2089
  * @public
1879
2090
  */
1880
- export type EphemerisData = EphemerisData.OemMember | EphemerisData.TleMember | EphemerisData.$UnknownMember;
2091
+ export type EphemerisData = EphemerisData.AzElMember | EphemerisData.OemMember | EphemerisData.TleMember | EphemerisData.$UnknownMember;
1881
2092
  /**
1882
2093
  * @public
1883
2094
  */
1884
2095
  export declare namespace EphemerisData {
1885
2096
  /**
1886
- * <p>Two-line element set (TLE) ephemeris.</p>
2097
+ * <p>Two-line element set (TLE) ephemeris.</p> <p> For more detail about providing Two-line element sets to AWS Ground Station, see the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/providing-tle-ephemeris-data.html">TLE section</a> of the AWS Ground Station user guide. </p>
1887
2098
  * @public
1888
2099
  */
1889
2100
  interface TleMember {
1890
2101
  tle: TLEEphemeris;
1891
2102
  oem?: never;
2103
+ azEl?: never;
1892
2104
  $unknown?: never;
1893
2105
  }
1894
2106
  /**
1895
- * <p>
1896
- * Ephemeris data in Orbit Ephemeris Message (OEM) format.
1897
- * </p>
1898
- * <p>
1899
- * AWS Ground Station processes OEM Customer Provided Ephemerides according to the <a href="https://public.ccsds.org/Pubs/502x0b3e1.pdf">CCSDS standard</a> with some extra restrictions. OEM files should be in KVN format. For more detail about the OEM format that AWS Ground Station supports, see <a href="https://docs.aws.amazon.com/ground-station/latest/ug/providing-custom-ephemeris-data.html#oem-ephemeris-format">OEM ephemeris format</a> in the AWS Ground Station user guide.
1900
- * </p>
2107
+ * <p>Ephemeris data in Orbit Ephemeris Message (OEM) format.</p> <p> AWS Ground Station processes OEM ephemerides according to the <a href="https://ccsds.org/wp-content/uploads/gravity_forms/5-448e85c647331d9cbaf66c096458bdd5/2025/01//502x0b3e1.pdf">CCSDS standard</a> with some extra restrictions. OEM files should be in KVN format. For more detail about the OEM format that AWS Ground Station supports, see <a href="https://docs.aws.amazon.com/ground-station/latest/ug/providing-oem-ephemeris-data.html#oem-ephemeris-format">OEM ephemeris format</a> in the AWS Ground Station user guide. </p>
1901
2108
  * @public
1902
2109
  */
1903
2110
  interface OemMember {
1904
2111
  tle?: never;
1905
2112
  oem: OEMEphemeris;
2113
+ azEl?: never;
2114
+ $unknown?: never;
2115
+ }
2116
+ /**
2117
+ * <p>Azimuth elevation ephemeris data.</p> <p> Use this ephemeris type to provide pointing angles directly, rather than satellite orbital elements. Use this when you need precise antenna pointing but have imprecise or unknown satellite trajectory information. </p> <p> The azimuth elevation data specifies the antenna pointing direction at specific times relative to a ground station location. AWS Ground Station uses 4th order Lagrange interpolation to compute pointing angles between the provided data points. </p> <p> AWS Ground Station automatically filters interpolated pointing angles, including only those that are above the site mask elevation of the specified ground station. </p> <p> For more detail about providing azimuth elevation ephemerides to AWS Ground Station, see the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/providing-azimuth-elevation-ephemeris-data.html">azimuth elevation ephemeris section</a> of the AWS Ground Station User Guide. </p>
2118
+ * @public
2119
+ */
2120
+ interface AzElMember {
2121
+ tle?: never;
2122
+ oem?: never;
2123
+ azEl: AzElEphemeris;
1906
2124
  $unknown?: never;
1907
2125
  }
1908
2126
  /**
@@ -1911,11 +2129,13 @@ export declare namespace EphemerisData {
1911
2129
  interface $UnknownMember {
1912
2130
  tle?: never;
1913
2131
  oem?: never;
2132
+ azEl?: never;
1914
2133
  $unknown: [string, any];
1915
2134
  }
1916
2135
  interface Visitor<T> {
1917
2136
  tle: (value: TLEEphemeris) => T;
1918
2137
  oem: (value: OEMEphemeris) => T;
2138
+ azEl: (value: AzElEphemeris) => T;
1919
2139
  _: (name: string, value: any) => T;
1920
2140
  }
1921
2141
  const visit: <T>(value: EphemerisData, visitor: Visitor<T>) => T;
@@ -1925,20 +2145,17 @@ export declare namespace EphemerisData {
1925
2145
  */
1926
2146
  export interface CreateEphemerisRequest {
1927
2147
  /**
1928
- * <p>AWS Ground Station satellite ID for this ephemeris.</p>
2148
+ * <p>The satellite ID that associates this ephemeris with a satellite in AWS Ground Station.</p>
1929
2149
  * @public
1930
2150
  */
1931
- satelliteId: string | undefined;
2151
+ satelliteId?: string | undefined;
1932
2152
  /**
1933
- * <p>Whether to set the ephemeris status to <code>ENABLED</code> after validation.</p>
1934
- * <p>Setting this to false will set the ephemeris status to <code>DISABLED</code> after validation.</p>
2153
+ * <p>Set to <code>true</code> to enable the ephemeris after validation. Set to <code>false</code> to keep it disabled.</p>
1935
2154
  * @public
1936
2155
  */
1937
2156
  enabled?: boolean | undefined;
1938
2157
  /**
1939
- * <p>Customer-provided priority score to establish the order in which overlapping ephemerides should be used.</p>
1940
- * <p>The default for customer-provided ephemeris priority is 1, and higher numbers take precedence.</p>
1941
- * <p>Priority must be 1 or greater</p>
2158
+ * <p>A priority score that determines which ephemeris to use when multiple ephemerides overlap.</p> <p>Higher numbers take precedence. The default is 1. Must be 1 or greater.</p>
1942
2159
  * @public
1943
2160
  */
1944
2161
  priority?: number | undefined;
@@ -1948,12 +2165,12 @@ export interface CreateEphemerisRequest {
1948
2165
  */
1949
2166
  expirationTime?: Date | undefined;
1950
2167
  /**
1951
- * <p>A name string associated with the ephemeris. Used as a human-readable identifier for the ephemeris.</p>
2168
+ * <p>A name that you can use to identify the ephemeris.</p>
1952
2169
  * @public
1953
2170
  */
1954
2171
  name: string | undefined;
1955
2172
  /**
1956
- * <p>The ARN of a KMS key used to encrypt the ephemeris in Ground Station.</p>
2173
+ * <p>The ARN of the KMS key to use for encrypting the ephemeris.</p>
1957
2174
  * @public
1958
2175
  */
1959
2176
  kmsKeyArn?: string | undefined;
@@ -2060,9 +2277,7 @@ export interface CreateMissionProfileRequest {
2060
2277
  */
2061
2278
  minimumViableContactDurationSeconds: number | undefined;
2062
2279
  /**
2063
- * <p>A list of lists of ARNs. Each list of ARNs is an edge, with a <i>from</i>
2064
- * <code>Config</code> and a <i>to</i>
2065
- * <code>Config</code>.</p>
2280
+ * <p>A list of lists of ARNs. Each list of ARNs is an edge, with a <i>from</i> <code>Config</code> and a <i>to</i> <code>Config</code>.</p>
2066
2281
  * @public
2067
2282
  */
2068
2283
  dataflowEdges: string[][] | undefined;
@@ -2214,6 +2429,18 @@ export interface DeleteEphemerisRequest {
2214
2429
  */
2215
2430
  ephemerisId: string | undefined;
2216
2431
  }
2432
+ /**
2433
+ * <p>The specified resource is in use by non-terminal state contacts and cannot be modified or deleted.</p>
2434
+ * @public
2435
+ */
2436
+ export declare class ResourceInUseException extends __BaseException {
2437
+ readonly name: "ResourceInUseException";
2438
+ readonly $fault: "client";
2439
+ /**
2440
+ * @internal
2441
+ */
2442
+ constructor(opts: __ExceptionOptionType<ResourceInUseException, __BaseException>);
2443
+ }
2217
2444
  /**
2218
2445
  * <p/>
2219
2446
  * @public
@@ -2235,6 +2462,70 @@ export interface DescribeEphemerisRequest {
2235
2462
  */
2236
2463
  ephemerisId: string | undefined;
2237
2464
  }
2465
+ /**
2466
+ * @public
2467
+ * @enum
2468
+ */
2469
+ export declare const EphemerisErrorCode: {
2470
+ readonly AZ_EL_SEGMENTS_OUT_OF_ORDER: "AZ_EL_SEGMENTS_OUT_OF_ORDER";
2471
+ readonly AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME: "AZ_EL_SEGMENT_END_TIME_BEFORE_START_TIME";
2472
+ readonly AZ_EL_SEGMENT_END_TIME_INVALID: "AZ_EL_SEGMENT_END_TIME_INVALID";
2473
+ readonly AZ_EL_SEGMENT_END_TIME_TOO_LATE: "AZ_EL_SEGMENT_END_TIME_TOO_LATE";
2474
+ readonly AZ_EL_SEGMENT_LIST_MISSING: "AZ_EL_SEGMENT_LIST_MISSING";
2475
+ readonly AZ_EL_SEGMENT_REFERENCE_EPOCH_INVALID: "AZ_EL_SEGMENT_REFERENCE_EPOCH_INVALID";
2476
+ readonly AZ_EL_SEGMENT_START_TIME_INVALID: "AZ_EL_SEGMENT_START_TIME_INVALID";
2477
+ readonly AZ_EL_SEGMENT_TIMES_OVERLAP: "AZ_EL_SEGMENT_TIMES_OVERLAP";
2478
+ readonly AZ_EL_SEGMENT_VALID_TIME_RANGE_INVALID: "AZ_EL_SEGMENT_VALID_TIME_RANGE_INVALID";
2479
+ readonly AZ_EL_TOTAL_DURATION_EXCEEDED: "AZ_EL_TOTAL_DURATION_EXCEEDED";
2480
+ readonly CENTER_BODY_UNSUPPORTED: "CENTER_BODY_UNSUPPORTED";
2481
+ readonly CREATION_DATE_MISSING: "CREATION_DATE_MISSING";
2482
+ readonly END_TIME_IN_PAST: "END_TIME_IN_PAST";
2483
+ readonly EXPIRATION_TIME_TOO_EARLY: "EXPIRATION_TIME_TOO_EARLY";
2484
+ readonly FILE_FORMAT_INVALID: "FILE_FORMAT_INVALID";
2485
+ readonly INSUFFICIENT_KMS_PERMISSIONS: "INSUFFICIENT_KMS_PERMISSIONS";
2486
+ readonly INSUFFICIENT_TIME_AZ_EL: "INSUFFICIENT_TIME_AZ_EL";
2487
+ readonly INTERNAL_ERROR: "INTERNAL_ERROR";
2488
+ readonly INTERPOLATION_DEGREE_INVALID: "INTERPOLATION_DEGREE_INVALID";
2489
+ readonly INTERPOLATION_MISSING: "INTERPOLATION_MISSING";
2490
+ readonly MEAN_MOTION_INVALID: "MEAN_MOTION_INVALID";
2491
+ readonly MISMATCHED_SATCAT_ID: "MISMATCHED_SATCAT_ID";
2492
+ readonly OBJECT_ID_MISSING: "OBJECT_ID_MISSING";
2493
+ readonly OBJECT_NAME_MISSING: "OBJECT_NAME_MISSING";
2494
+ readonly OEM_VERSION_UNSUPPORTED: "OEM_VERSION_UNSUPPORTED";
2495
+ readonly ORIGINATOR_MISSING: "ORIGINATOR_MISSING";
2496
+ readonly REF_FRAME_EPOCH_UNSUPPORTED: "REF_FRAME_EPOCH_UNSUPPORTED";
2497
+ readonly REF_FRAME_UNSUPPORTED: "REF_FRAME_UNSUPPORTED";
2498
+ readonly START_TIME_IN_FUTURE: "START_TIME_IN_FUTURE";
2499
+ readonly START_TIME_METADATA_TOO_EARLY: "START_TIME_METADATA_TOO_EARLY";
2500
+ readonly STOP_TIME_METADATA_TOO_LATE: "STOP_TIME_METADATA_TOO_LATE";
2501
+ readonly TIME_AZ_EL_ANGLE_UNITS_INVALID: "TIME_AZ_EL_ANGLE_UNITS_INVALID";
2502
+ readonly TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID: "TIME_AZ_EL_AZ_DEGREE_RANGE_INVALID";
2503
+ readonly TIME_AZ_EL_AZ_RADIAN_RANGE_INVALID: "TIME_AZ_EL_AZ_RADIAN_RANGE_INVALID";
2504
+ readonly TIME_AZ_EL_EL_DEGREE_RANGE_INVALID: "TIME_AZ_EL_EL_DEGREE_RANGE_INVALID";
2505
+ readonly TIME_AZ_EL_EL_RADIAN_RANGE_INVALID: "TIME_AZ_EL_EL_RADIAN_RANGE_INVALID";
2506
+ readonly TIME_AZ_EL_ITEMS_OUT_OF_ORDER: "TIME_AZ_EL_ITEMS_OUT_OF_ORDER";
2507
+ readonly TIME_SYSTEM_UNSUPPORTED: "TIME_SYSTEM_UNSUPPORTED";
2508
+ };
2509
+ /**
2510
+ * @public
2511
+ */
2512
+ export type EphemerisErrorCode = (typeof EphemerisErrorCode)[keyof typeof EphemerisErrorCode];
2513
+ /**
2514
+ * <p>Detailed error information for ephemeris validation failures.</p> <p>Provides an error code and descriptive message to help diagnose and resolve validation issues.</p>
2515
+ * @public
2516
+ */
2517
+ export interface EphemerisErrorReason {
2518
+ /**
2519
+ * <p>The error code identifying the type of validation failure.</p> <p>See the <a href="https://docs.aws.amazon.com/ground-station/latest/ug/troubleshooting-invalid-ephemerides.html">Troubleshooting Invalid Ephemerides guide</a> for error code details.</p>
2520
+ * @public
2521
+ */
2522
+ errorCode: EphemerisErrorCode | undefined;
2523
+ /**
2524
+ * <p>A human-readable message describing the validation failure.</p> <p>Provides specific details about what failed and may include suggestions for remediation.</p>
2525
+ * @public
2526
+ */
2527
+ errorMessage: string | undefined;
2528
+ }
2238
2529
  /**
2239
2530
  * @public
2240
2531
  * @enum
@@ -2287,7 +2578,7 @@ export type EphemerisStatus = (typeof EphemerisStatus)[keyof typeof EphemerisSta
2287
2578
  */
2288
2579
  export interface EphemerisDescription {
2289
2580
  /**
2290
- * <p>Source S3 object used for the ephemeris.</p>
2581
+ * <p>Source Amazon S3 object used for the ephemeris.</p>
2291
2582
  * @public
2292
2583
  */
2293
2584
  sourceS3Object?: S3Object | undefined;
@@ -2301,7 +2592,7 @@ export interface EphemerisDescription {
2301
2592
  * <p/>
2302
2593
  * @public
2303
2594
  */
2304
- export type EphemerisTypeDescription = EphemerisTypeDescription.OemMember | EphemerisTypeDescription.TleMember | EphemerisTypeDescription.$UnknownMember;
2595
+ export type EphemerisTypeDescription = EphemerisTypeDescription.AzElMember | EphemerisTypeDescription.OemMember | EphemerisTypeDescription.TleMember | EphemerisTypeDescription.$UnknownMember;
2305
2596
  /**
2306
2597
  * @public
2307
2598
  */
@@ -2313,6 +2604,7 @@ export declare namespace EphemerisTypeDescription {
2313
2604
  interface TleMember {
2314
2605
  tle: EphemerisDescription;
2315
2606
  oem?: never;
2607
+ azEl?: never;
2316
2608
  $unknown?: never;
2317
2609
  }
2318
2610
  /**
@@ -2322,6 +2614,17 @@ export declare namespace EphemerisTypeDescription {
2322
2614
  interface OemMember {
2323
2615
  tle?: never;
2324
2616
  oem: EphemerisDescription;
2617
+ azEl?: never;
2618
+ $unknown?: never;
2619
+ }
2620
+ /**
2621
+ * <p>Description of ephemeris.</p>
2622
+ * @public
2623
+ */
2624
+ interface AzElMember {
2625
+ tle?: never;
2626
+ oem?: never;
2627
+ azEl: EphemerisDescription;
2325
2628
  $unknown?: never;
2326
2629
  }
2327
2630
  /**
@@ -2330,11 +2633,13 @@ export declare namespace EphemerisTypeDescription {
2330
2633
  interface $UnknownMember {
2331
2634
  tle?: never;
2332
2635
  oem?: never;
2636
+ azEl?: never;
2333
2637
  $unknown: [string, any];
2334
2638
  }
2335
2639
  interface Visitor<T> {
2336
2640
  tle: (value: EphemerisDescription) => T;
2337
2641
  oem: (value: EphemerisDescription) => T;
2642
+ azEl: (value: EphemerisDescription) => T;
2338
2643
  _: (name: string, value: any) => T;
2339
2644
  }
2340
2645
  const visit: <T>(value: EphemerisTypeDescription, visitor: Visitor<T>) => T;
@@ -2359,9 +2664,7 @@ export interface DescribeEphemerisResponse {
2359
2664
  */
2360
2665
  status?: EphemerisStatus | undefined;
2361
2666
  /**
2362
- * <p>Customer-provided priority score to establish the order in which overlapping ephemerides should be used.</p>
2363
- * <p>The default for customer-provided ephemeris priority is 1, and higher numbers take precedence.</p>
2364
- * <p>Priority must be 1 or greater</p>
2667
+ * <p>A priority score that determines which ephemeris to use when multiple ephemerides overlap.</p> <p>Higher numbers take precedence. The default is 1. Must be 1 or greater.</p>
2365
2668
  * @public
2366
2669
  */
2367
2670
  priority?: number | undefined;
@@ -2376,7 +2679,7 @@ export interface DescribeEphemerisResponse {
2376
2679
  */
2377
2680
  enabled?: boolean | undefined;
2378
2681
  /**
2379
- * <p>A name string associated with the ephemeris. Used as a human-readable identifier for the ephemeris.</p>
2682
+ * <p>A name that you can use to identify the ephemeris.</p>
2380
2683
  * @public
2381
2684
  */
2382
2685
  name?: string | undefined;
@@ -2391,10 +2694,15 @@ export interface DescribeEphemerisResponse {
2391
2694
  */
2392
2695
  suppliedData?: EphemerisTypeDescription | undefined;
2393
2696
  /**
2394
- * <p>Reason that an ephemeris failed validation. Only provided for ephemerides with <code>INVALID</code> status.</p>
2697
+ * <p>Reason that an ephemeris failed validation. Appears only when the status is <code>INVALID</code>.</p>
2395
2698
  * @public
2396
2699
  */
2397
2700
  invalidReason?: EphemerisInvalidReason | undefined;
2701
+ /**
2702
+ * <p>Detailed error information for ephemerides with <code>INVALID</code> status.</p> <p>Provides specific error codes and messages to help diagnose validation failures.</p>
2703
+ * @public
2704
+ */
2705
+ errorReasons?: EphemerisErrorReason[] | undefined;
2398
2706
  }
2399
2707
  /**
2400
2708
  * <p>Ephemeris item.</p>
@@ -2406,15 +2714,18 @@ export interface EphemerisItem {
2406
2714
  * @public
2407
2715
  */
2408
2716
  ephemerisId?: string | undefined;
2717
+ /**
2718
+ * <p>The type of ephemeris.</p>
2719
+ * @public
2720
+ */
2721
+ ephemerisType?: EphemerisType | undefined;
2409
2722
  /**
2410
2723
  * <p>The status of the ephemeris.</p>
2411
2724
  * @public
2412
2725
  */
2413
2726
  status?: EphemerisStatus | undefined;
2414
2727
  /**
2415
- * <p>Customer-provided priority score to establish the order in which overlapping ephemerides should be used.</p>
2416
- * <p>The default for customer-provided ephemeris priority is 1, and higher numbers take precedence.</p>
2417
- * <p>Priority must be 1 or greater</p>
2728
+ * <p>A priority score that determines which ephemeris to use when multiple ephemerides overlap.</p> <p>Higher numbers take precedence. The default is 1. Must be 1 or greater.</p>
2418
2729
  * @public
2419
2730
  */
2420
2731
  priority?: number | undefined;
@@ -2429,12 +2740,12 @@ export interface EphemerisItem {
2429
2740
  */
2430
2741
  creationTime?: Date | undefined;
2431
2742
  /**
2432
- * <p>A name string associated with the ephemeris. Used as a human-readable identifier for the ephemeris.</p>
2743
+ * <p>A name that you can use to identify the ephemeris.</p>
2433
2744
  * @public
2434
2745
  */
2435
2746
  name?: string | undefined;
2436
2747
  /**
2437
- * <p>Source S3 object used for the ephemeris.</p>
2748
+ * <p>Source Amazon S3 object used for the ephemeris.</p>
2438
2749
  * @public
2439
2750
  */
2440
2751
  sourceS3Object?: S3Object | undefined;
@@ -2447,14 +2758,19 @@ export interface ListEphemeridesRequest {
2447
2758
  * <p>The AWS Ground Station satellite ID to list ephemeris for.</p>
2448
2759
  * @public
2449
2760
  */
2450
- satelliteId: string | undefined;
2761
+ satelliteId?: string | undefined;
2762
+ /**
2763
+ * <p>Filter ephemerides by type. If not specified, all ephemeris types will be returned.</p>
2764
+ * @public
2765
+ */
2766
+ ephemerisType?: EphemerisType | undefined;
2451
2767
  /**
2452
- * <p>The start time to list in UTC. The operation will return an ephemeris if its expiration time is within the time range defined by the <code>startTime</code> and <code>endTime</code>.</p>
2768
+ * <p>The start time for the list operation in UTC. Returns ephemerides with expiration times within your specified time range.</p>
2453
2769
  * @public
2454
2770
  */
2455
2771
  startTime: Date | undefined;
2456
2772
  /**
2457
- * <p>The end time to list in UTC. The operation will return an ephemeris if its expiration time is within the time range defined by the <code>startTime</code> and <code>endTime</code>.</p>
2773
+ * <p>The end time for the list operation in UTC. Returns ephemerides with expiration times within your specified time range.</p>
2458
2774
  * @public
2459
2775
  */
2460
2776
  endTime: Date | undefined;
@@ -2499,19 +2815,17 @@ export interface UpdateEphemerisRequest {
2499
2815
  */
2500
2816
  ephemerisId: string | undefined;
2501
2817
  /**
2502
- * <p>Whether the ephemeris is enabled or not. Changing this value will not require the ephemeris to be re-validated.</p>
2818
+ * <p>Enable or disable the ephemeris. Changing this value doesn't require re-validation.</p>
2503
2819
  * @public
2504
2820
  */
2505
2821
  enabled: boolean | undefined;
2506
2822
  /**
2507
- * <p>A name string associated with the ephemeris. Used as a human-readable identifier for the ephemeris.</p>
2823
+ * <p>A name that you can use to identify the ephemeris.</p>
2508
2824
  * @public
2509
2825
  */
2510
2826
  name?: string | undefined;
2511
2827
  /**
2512
- * <p>Customer-provided priority score to establish the order in which overlapping ephemerides should be used.</p>
2513
- * <p>The default for customer-provided ephemeris priority is 1, and higher numbers take precedence.</p>
2514
- * <p>Priority must be 1 or greater</p>
2828
+ * <p>A priority score that determines which ephemeris to use when multiple ephemerides overlap.</p> <p>Higher numbers take precedence. The default is 1. Must be 1 or greater.</p>
2515
2829
  * @public
2516
2830
  */
2517
2831
  priority?: number | undefined;
@@ -2539,20 +2853,17 @@ export interface EphemerisMetaData {
2539
2853
  */
2540
2854
  source: EphemerisSource | undefined;
2541
2855
  /**
2542
- * <p>UUID of a customer-provided ephemeris.</p>
2543
- * <p>This field is not populated for default ephemerides from Space Track.</p>
2856
+ * <p>UUID of a customer-provided ephemeris.</p> <p>This field is not populated for default ephemerides from Space Track.</p>
2544
2857
  * @public
2545
2858
  */
2546
2859
  ephemerisId?: string | undefined;
2547
2860
  /**
2548
- * <p>The epoch of a default, ephemeris from Space Track in UTC.</p>
2549
- * <p>This field is not populated for customer-provided ephemerides.</p>
2861
+ * <p>The epoch of a default, ephemeris from Space Track in UTC.</p> <p>This field is not populated for customer-provided ephemerides.</p>
2550
2862
  * @public
2551
2863
  */
2552
2864
  epoch?: Date | undefined;
2553
2865
  /**
2554
- * <p>A name string associated with the ephemeris. Used as a human-readable identifier for the ephemeris.</p>
2555
- * <p>A name is only returned for customer-provider ephemerides that have a name associated.</p>
2866
+ * <p>A name string associated with the ephemeris. Used as a human-readable identifier for the ephemeris.</p> <p>A name is only returned for customer-provider ephemerides that have a name associated.</p>
2556
2867
  * @public
2557
2868
  */
2558
2869
  name?: string | undefined;
@@ -2656,9 +2967,7 @@ export interface GetMissionProfileResponse {
2656
2967
  */
2657
2968
  minimumViableContactDurationSeconds?: number | undefined;
2658
2969
  /**
2659
- * <p>A list of lists of ARNs. Each list of ARNs is an edge, with a <i>from</i>
2660
- * <code>Config</code> and a <i>to</i>
2661
- * <code>Config</code>.</p>
2970
+ * <p>A list of lists of ARNs. Each list of ARNs is an edge, with a <i>from</i> <code>Config</code> and a <i>to</i> <code>Config</code>.</p>
2662
2971
  * @public
2663
2972
  */
2664
2973
  dataflowEdges?: string[][] | undefined;
@@ -2894,9 +3203,7 @@ export interface UpdateMissionProfileRequest {
2894
3203
  */
2895
3204
  minimumViableContactDurationSeconds?: number | undefined;
2896
3205
  /**
2897
- * <p>A list of lists of ARNs. Each list of ARNs is an edge, with a <i>from</i>
2898
- * <code>Config</code> and a <i>to</i>
2899
- * <code>Config</code>.</p>
3206
+ * <p>A list of lists of ARNs. Each list of ARNs is an edge, with a <i>from</i> <code>Config</code> and a <i>to</i> <code>Config</code>.</p>
2900
3207
  * @public
2901
3208
  */
2902
3209
  dataflowEdges?: string[][] | undefined;