翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

連絡先と連絡先のバージョニングを更新する

AWS Ground Station では、、SCHEDULED、PREPASSまたは の問い合わせステータスでPASS問い合わせを更新できます。 AWS Ground Station 問い合わせステータスUpdateContact API を使用して、アジマス/標高、OEM、TLE 追跡データなど、問い合わせのエフェメリスオーバーライドを指定でき、キャンセルやスケジュール変更は不要です。これは、コンタクト中にアンテナを別の衛星に再タスクする必要があるジオ同期 (GEO) 衛星操作や、ポイント調整が必要な起動および早期操作 (LEOPs) に役立ちます。

問い合わせを予約または更新するたびに、 は新しい問い合わせバージョン AWS Ground Station を作成します。問い合わせバージョンは、問い合わせに加えられた変更の履歴を提供し、各更新のステータスを追跡できます。

問い合わせのバージョニングの仕組み

ReserveContact を呼び出すと、 は問い合わせの最初のバージョン (バージョン 1) AWS Ground Station を作成し、レスポンスversionIdで を返します。UpdateContact を後から呼び出すたびに、バージョン番号が増分された新しいバージョンが作成されます。

DescribeContact API は、レスポンスの versionフィールドのバージョン情報を含む、現在のACTIVE問い合わせバージョンを返します。ListContacts API には、各問い合わせのバージョン情報も含まれています。

特定のバージョンの問い合わせを表示するには、DescribeContactVersion API を使用します。連絡先のすべてのバージョンを一覧表示するには、ListContactVersions API を使用します。

連絡先の更新

コンタクトが SCHEDULED、PREPASS、または PASS 状態のときに UpdateContact を呼び出すことができます。 API は、次のパラメータを受け入れます。

コンタクト中にターゲット衛星を変更するには、対応する satelliteArnとともに新しい を指定しますtrackingOverrides。コンタクトの開始時刻と終了時刻はこの API では変更されないため、コンタクト中は新しい衛星を地上局から表示する必要があります。新しい衛星も地上局にオンボードされ、ミッションプロファイルに必要なライセンスを持っている必要があります。コンタクトのミッションプロファイルは変更できないため、両方の衛星が同じミッションプロファイルを使用する場合にのみ、衛星の切り替えが適用されます。

UpdateContact API は、 contactIdと新しい を返しますversionId。更新は非同期的に処理されます。DescribeContactVersion を使用して、更新のステータスを確認します。 AWS SDKsと は、バージョンが ACTIVE または FAILED_TO_UPDATE ステータスになるまでポーリングするContactUpdatedウェーター AWS Command Line Interface を提供します。

問い合わせバージョンのステータス

各問い合わせバージョンには、次のいずれかのステータスがあります。

コードの例

次の例は、 AWS SDK for Python (Boto3) で問い合わせバージョニング APIs を使用する方法を示しています。

例: 連絡先を更新する

次の例では、新しい追跡オーバーライドで連絡先を更新し、Boto3 ContactUpdatedウェーターを使用して更新が完了するまで待機します。

import boto3
import uuid

# Create AWS Ground Station client
ground_station_client = boto3.client("groundstation")

# The contact ID of an existing scheduled contact to update
contact_id = "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"

# Generate a unique client token for idempotency.
# If you retry the same request with the same client token,
# the API returns the same response without creating a duplicate version.
client_token = str(uuid.uuid4())

# Update the contact to use a different TLE ephemeris for tracking.
# The UpdateContact API applies all parameters in the request.
# Any parameter set to null is treated as a request to clear that value,
# not to leave it unchanged. Include all desired values in each request.
print(f"Updating contact {contact_id}...")

update_response = ground_station_client.update_contact(
    contactId=contact_id,
    clientToken=client_token,
    satelliteArn="arn:aws:groundstation::111122223333:satellite/a88611b0-f755-404e-b60d-57d8aEXAMPLE",
    trackingOverrides={
        "programTrackSettings": {
            "tle": {"ephemerisId": "b2c3d4e5-6789-01ab-cdef-EXAMPLE22222"}
        }
    },
)

contact_id = update_response["contactId"]
version_id = update_response["versionId"]
print(f"Update submitted. Contact: {contact_id}, Version: {version_id}")

# Wait for the update to complete using the ContactUpdated waiter.
# The waiter polls DescribeContactVersion until the version reaches
# ACTIVE (success) or FAILED_TO_UPDATE (failure) status.
# The waiter raises WaiterError if the version reaches FAILED_TO_UPDATE
# or if MaxAttempts is exceeded, so we use try/except to handle both cases.
print("Waiting for update to complete...")

from botocore.exceptions import WaiterError

waiter = ground_station_client.get_waiter("contact_updated")

try:
    waiter.wait(
        contactId=contact_id,
        versionId=version_id,
        WaiterConfig={
            "Delay": 5,
            "MaxAttempts": 180,
        },
    )
    print(f"Contact updated successfully. Version {version_id} is now active.")
except WaiterError as e:
    # WaiterError is raised when the version reaches FAILED_TO_UPDATE
    # or when MaxAttempts is exceeded. Retrieve the current version to inspect.
    version_response = ground_station_client.describe_contact_version(
        contactId=contact_id,
        versionId=version_id,
    )
    version_status = version_response["version"]["status"]
    if version_status == "FAILED_TO_UPDATE":
        failure_codes = version_response["version"].get("failureCodes", [])
        failure_message = version_response["version"].get("failureMessage", "")
        print(f"Update failed. Codes: {failure_codes}, Message: {failure_message}")
    else:
        print(f"Waiter timed out. Current version status: {version_status}. Error: {e}")

例: 問い合わせバージョンを記述する

次の の例では、ステータス、設定、障害情報など、特定の問い合わせバージョンの詳細を取得します。

import boto3

# Create AWS Ground Station client
ground_station_client = boto3.client("groundstation")

contact_id = "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
version_id = 2

# Describe a specific version of a contact.
# Use this API to check the status of an update or to view the
# configuration that was active at a specific point in time.
print(f"Describing version {version_id} of contact {contact_id}...")

response = ground_station_client.describe_contact_version(
    contactId=contact_id,
    versionId=version_id,
)

# Display version details
version = response["version"]
print(f"Version ID: {version['versionId']}")
print(f"Status: {version['status']}")
print(f"Created: {version.get('created', 'N/A')}")

if version.get("activated"):
    print(f"Activated: {version['activated']}")

if version.get("superseded"):
    print(f"Superseded: {version['superseded']}")

# Display contact details for this version
print(f"\nContact ID: {response['contactId']}")
print(f"Contact Status: {response['contactStatus']}")
print(f"Ground Station: {response['groundStation']}")
print(f"Start Time: {response['startTime']}")
print(f"End Time: {response['endTime']}")

if response.get("satelliteArn"):
    print(f"Satellite ARN: {response['satelliteArn']}")

if response.get("trackingOverrides"):
    print(f"Tracking Overrides: {response['trackingOverrides']}")

# Check for failure details if the version failed to update
if version["status"] == "FAILED_TO_UPDATE":
    failure_codes = version.get("failureCodes", [])
    failure_message = version.get("failureMessage", "")
    print(f"\nFailure Codes: {failure_codes}")
    print(f"Failure Message: {failure_message}")

例: 問い合わせバージョンを一覧表示する

次の の例では、大きな結果セットを処理するためにページ分割を使用して、変更の完全な履歴を表示する問い合わせのすべてのバージョンを一覧表示します。

import boto3

# Create AWS Ground Station client
ground_station_client = boto3.client("groundstation")

contact_id = "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"

# List all versions of a contact to view the full history of changes.
# Results are paginated. Use the nextToken to retrieve additional pages.
print(f"Listing versions for contact {contact_id}...")

paginator = ground_station_client.get_paginator("list_contact_versions")
page_iterator = paginator.paginate(
    contactId=contact_id,
    PaginationConfig={
        "MaxItems": 100,
        "PageSize": 20,
    },
)

for page in page_iterator:
    for version in page["contactVersionsList"]:
        version_id = version["versionId"]
        status = version["status"]
        created = version.get("created", "N/A")

        print(f"  Version {version_id}: status={status}, created={created}")

        if version.get("activated"):
            print(f"    Activated: {version['activated']}")

        if version.get("superseded"):
            print(f"    Superseded: {version['superseded']}")

        if status == "FAILED_TO_UPDATE":
            failure_codes = version.get("failureCodes", [])
            failure_message = version.get("failureMessage", "")
            print(f"    Failure Codes: {failure_codes}")
            print(f"    Failure Message: {failure_message}")

        if status == "UPDATING":
            print(f"    Update is currently in progress.")

考慮事項