Spacecrafts - List Available Contacts
使用可能な連絡先の一覧を返します。 接触プロファイルで提供される実用最小限の接触期間を超えて、宇宙船が地上局から表示されている場合は、連絡先を使用できます。
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/listAvailableContacts?api-version=2022-11-01
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
resource
|
path | True |
string |
リソース グループの名前。 名前の大文字と小文字は区別されます。 |
spacecraft
|
path | True |
string |
宇宙船 ID。 |
subscription
|
path | True |
string |
ターゲット サブスクリプションの ID。 |
api-version
|
query | True |
string |
この操作に使用する API バージョン。 |
要求本文
名前 | 必須 | 型 | 説明 |
---|---|---|---|
contactProfile | True |
連絡先プロファイル リソースへの参照。 |
|
endTime | True |
string |
連絡先の終了時刻 (ISO 8601 UTC 標準)。 |
groundStationName | True |
string |
Azure グラウンド ステーションの名前。 |
startTime | True |
string |
連絡先の開始時刻 (ISO 8601 UTC 標準)。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
要求が成功しました。 操作は、使用可能な連絡先リソースの一覧を返します。 |
|
202 Accepted |
受け入れられ、操作は非同期的に完了します。 ヘッダー Location: string |
|
Other Status Codes |
操作に失敗した理由を説明するエラー応答。 リソース グループが存在しない場合は、404 (NotFound) が返されます。 |
例
List of Contact
要求のサンプル
POST https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/listAvailableContacts?api-version=2022-11-01
{
"contactProfile": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
},
"groundStationName": "EASTUS2_0",
"startTime": "2022-11-01T11:30:00Z",
"endTime": "2022-11-02T11:30:00Z"
}
応答のサンプル
Location: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"value": [
{
"spacecraft": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT"
},
"groundStationName": "EASTUS2_0",
"properties": {
"maximumElevationDegrees": 26.617297,
"txStartTime": "2022-11-01T11:55:01Z",
"txEndTime": "2022-11-01T12:05:25Z",
"rxStartTime": "2022-11-01T11:55:01Z",
"rxEndTime": "2022-11-01T12:05:25Z",
"startAzimuthDegrees": 201.340472,
"endAzimuthDegrees": 330.489627,
"startElevationDegrees": 5,
"endElevationDegrees": 5.040625
}
},
{
"spacecraft": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT"
},
"groundStationName": "EASTUS2_0",
"properties": {
"maximumElevationDegrees": 85.9796,
"txStartTime": "2022-11-02T10:58:30Z",
"txEndTime": "2022-11-02T11:10:45Z",
"rxStartTime": "2022-11-02T10:58:30Z",
"rxEndTime": "2022-11-02T11:10:45Z",
"startAzimuthDegrees": 165.758896,
"endAzimuthDegrees": 345.848482,
"startElevationDegrees": 5,
"endElevationDegrees": 5.048656
}
}
],
"nextLink": "https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/listAvailableContacts?api-version=2022-11-01&$skiptoken=opaqueString"
}
定義
名前 | 説明 |
---|---|
Authorized |
認定された地上ステーション。 |
Auto |
自動追跡の構成。 |
Available |
顧客は、宇宙船リソースの使用可能な連絡先の一覧を取得します。 後で、使用可能な連絡先の 1 つを選択して、連絡先を作成できます。 |
Available |
ListAvailableContacts API サービス呼び出しの応答。 |
Contact |
連絡先リソースを定義するパラメーター。 |
Contact |
連絡先プロファイル リソースへの参照。 |
Contact |
顧客が連絡先プロファイル リソースを作成します。このリソースには、連絡先のスケジュール設定に必要なすべての構成が含まれます。 |
Contact |
連絡先プロファイル リンク。 |
Contact |
連絡先プロファイル リンク チャネル。 |
Contact |
リソースの作成、削除、または変更の現在の状態。 |
Contact |
プロファイルのサード パーティのパートナー構成にお問い合わせください。 |
created |
リソースを作成した ID の種類。 |
direction |
方向 (アップリンクまたはダウンリンク)。 |
End |
宇宙船との接触中にデータを格納および取得する顧客エンドポイント。 |
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Network |
顧客仮想ネットワークのネットワーク構成。 |
polarization |
偏光。 例: (RHCP、LHCP)。 |
protocol |
UDP または TCP のいずれかのプロトコル。 |
Provisioning |
リソースの作成、削除、または変更の現在の状態。 |
Spacecraft |
顧客は、連絡先をスケジュールするための宇宙船リソースを作成します。 |
Spacecraft |
地上局ごとの許可された宇宙船リンクの一覧と、認可の有効期限。 |
system |
リソースの作成と最後の変更に関連するメタデータ。 |
AuthorizedGroundstation
認定された地上ステーション。
名前 | 型 | 説明 |
---|---|---|
expirationDate |
string |
承認の有効期限の日付。 |
groundStation |
string |
グランドステーション名。 |
AutoTrackingConfiguration
自動追跡の構成。
名前 | 型 | 説明 |
---|---|---|
disabled |
string |
|
sBand |
string |
|
xBand |
string |
AvailableContacts
顧客は、宇宙船リソースの使用可能な連絡先の一覧を取得します。 後で、使用可能な連絡先の 1 つを選択して、連絡先を作成できます。
名前 | 型 | 説明 |
---|---|---|
groundStationName |
string |
Azure グラウンド ステーションの名前。 |
properties.endAzimuthDegrees |
number |
接触の終点にあるアンテナの方位角 (10 進度)。 |
properties.endElevationDegrees |
number |
接触端の水平線の上の宇宙船の標高。 |
properties.maximumElevationDegrees |
number |
接触時のアンテナの最大標高 (10 進度)。 |
properties.rxEndTime |
string |
シグナルの受信が失われるまでの時間 (ISO 8601 UTC 標準)。 |
properties.rxStartTime |
string |
シグナルを受信する最も早い時刻 (ISO 8601 UTC 標準)。 |
properties.startAzimuthDegrees |
number |
接触の開始時のアンテナの方位角 (10 進度)。 |
properties.startElevationDegrees |
number |
接触開始時の水平線の上の宇宙船の標高。 |
properties.txEndTime |
string |
アンテナ送信が無効になる時刻 (ISO 8601 UTC 標準)。 |
properties.txStartTime |
string |
アンテナ送信が有効になる時刻 (ISO 8601 UTC 標準)。 |
spacecraft |
宇宙船リソースへの参照。 |
AvailableContactsListResult
ListAvailableContacts API サービス呼び出しの応答。
名前 | 型 | 説明 |
---|---|---|
nextLink |
string |
次の結果セットを取得する URL。 |
value |
使用可能な連絡先の一覧。 |
ContactParameters
連絡先リソースを定義するパラメーター。
名前 | 型 | 説明 |
---|---|---|
contactProfile |
連絡先プロファイル リソースへの参照。 |
|
endTime |
string |
連絡先の終了時刻 (ISO 8601 UTC 標準)。 |
groundStationName |
string |
Azure グラウンド ステーションの名前。 |
startTime |
string |
連絡先の開始時刻 (ISO 8601 UTC 標準)。 |
ContactParameters.ContactProfile
連絡先プロファイル リソースへの参照。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの ID |
ContactProfile
顧客が連絡先プロファイル リソースを作成します。このリソースには、連絡先のスケジュール設定に必要なすべての構成が含まれます。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
リソースが保存されている地理的な場所 |
name |
string |
リソースの名前 |
properties.autoTrackingConfiguration |
自動追跡の構成。 |
|
properties.eventHubUri |
string |
テレメトリに使用されるイベント ハブの ARM リソース識別子。 Orbital リソース プロバイダーに、ハブにテレメトリを送信する権限を付与する必要があります。 |
properties.links |
連絡先プロファイルのリンク。 RF リンク、モデム処理、IP エンドポイントについて説明します。 |
|
properties.minimumElevationDegrees |
number |
接触の実行可能な最小標高 (10 進度)。 特定の地上局の宇宙船で使用可能な連絡先を一覧表示するために使用されます。 |
properties.minimumViableContactDuration |
string |
ISO 8601 形式の実行可能な最小接触時間。 特定の地上局の宇宙船で使用可能な連絡先を一覧表示するために使用されます。 |
properties.networkConfiguration |
顧客仮想ネットワークのネットワーク構成。 |
|
properties.provisioningState |
リソースの作成、削除、または変更の現在の状態。 |
|
properties.thirdPartyConfigurations |
連絡先プロファイルのサード パーティのミッション構成。 RF リンク、モデム処理、IP エンドポイントについて説明します。 |
|
systemData |
createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。 |
|
tags |
object |
リソース タグ。 |
type |
string |
リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts" |
ContactProfileLink
連絡先プロファイル リンク。
名前 | 型 | 説明 |
---|---|---|
channels |
連絡先プロファイル リンク チャネル。 |
|
direction |
方向 (アップリンクまたはダウンリンク)。 |
|
eirpdBW |
number |
dBWにおける有効等方放射電力(EIRP) これは、顧客が必要とする EIRP です。 まだ使用されていません。 |
gainOverTemperature |
number |
db/K のノイズ温度に対するゲイン。 これは、顧客が必要とする G/T です。 まだ使用されていません。 |
name |
string |
リンク名。 |
polarization |
偏光。 例: (RHCP、LHCP)。 |
ContactProfileLinkChannel
連絡先プロファイル リンク チャネル。
名前 | 型 | 説明 |
---|---|---|
bandwidthMHz |
number |
MHz の帯域幅。 |
centerFrequencyMHz |
number |
MHz の中心周波数。 |
decodingConfiguration |
string |
現在使用されていません。 |
demodulationConfiguration |
string |
Kratos QRadio や Kratos QuantumRx などのモデム構成ファイルのコピー。 下り方向にのみ有効です。 指定した場合、モデムは顧客エンドポイントに接続し、VITA.49 ストリームの代わりに降格されたデータを送信します。 |
encodingConfiguration |
string |
現在使用されていません。 |
endPoint |
宇宙船との接触中にデータを格納および取得する顧客エンドポイント。 |
|
modulationConfiguration |
string |
Kratos QRadio などのモデム構成ファイルのコピー。 アップリンク方向に対してのみ有効です。 指定した場合、モデムは顧客エンドポイントに接続し、VITA.49 ストリームの代わりに顧客からのコマンドを受け入れます。 |
name |
string |
チャネル名。 |
ContactProfilesProperties.ProvisioningState
リソースの作成、削除、または変更の現在の状態。
ContactProfileThirdPartyConfiguration
プロファイルのサード パーティのパートナー構成にお問い合わせください。
名前 | 型 | 説明 |
---|---|---|
missionConfiguration |
string |
特定のミッションの連絡先設定を記述する構成を参照する文字列の名前。 予想される値は、パートナー ネットワークと共同で作成された値です。 |
providerName |
string |
サード パーティプロバイダーの名前。 |
createdByType
リソースを作成した ID の種類。
名前 | 型 | 説明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
direction
方向 (アップリンクまたはダウンリンク)。
名前 | 型 | 説明 |
---|---|---|
Downlink |
string |
|
Uplink |
string |
EndPoint
宇宙船との接触中にデータを格納および取得する顧客エンドポイント。
名前 | 型 | 説明 |
---|---|---|
endPointName |
string |
終点の名前。 |
ipAddress |
string |
IP アドレス (IPv4)。 |
port |
string |
データを受信するためにリッスンする TCP ポート。 |
protocol |
UDP または TCP のいずれかのプロトコル。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
NetworkConfiguration
顧客仮想ネットワークのネットワーク構成。
名前 | 型 | 説明 |
---|---|---|
subnetId |
string |
Microsoft.Orbital/orbitalGateways に委任されたサブネットの ARM リソース識別子。 少なくともクラス C サブネットである必要があり、その中に IP を作成しないでください。 |
polarization
偏光。 例: (RHCP、LHCP)。
名前 | 型 | 説明 |
---|---|---|
LHCP |
string |
|
RHCP |
string |
|
linearHorizontal |
string |
|
linearVertical |
string |
protocol
UDP または TCP のいずれかのプロトコル。
名前 | 型 | 説明 |
---|---|---|
TCP |
string |
|
UDP |
string |
ProvisioningState
リソースの作成、削除、または変更の現在の状態。
Spacecraft
顧客は、連絡先をスケジュールするための宇宙船リソースを作成します。
名前 | 型 | 説明 |
---|---|---|
id |
string |
リソースの完全修飾リソース ID。 例 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
リソースが保存されている地理的な場所 |
name |
string |
リソースの名前 |
properties.links |
宇宙船リンクの不変リスト。 |
|
properties.noradId |
string |
宇宙船の NORAD ID。 |
properties.provisioningState |
リソースの作成、削除、または変更の現在の状態。 |
|
properties.titleLine |
string |
2 行要素セット (TLE) のタイトル行。 |
properties.tleLine1 |
string |
2 行の要素セット (TLE) の 1 行目。 |
properties.tleLine2 |
string |
2 行の要素セット (TLE) の 2 行目。 |
systemData |
createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。 |
|
tags |
object |
リソース タグ。 |
type |
string |
リソースの型。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts" |
SpacecraftLink
地上局ごとの許可された宇宙船リンクの一覧と、認可の有効期限。
名前 | 型 | 説明 |
---|---|---|
authorizations |
認定地上局 |
|
bandwidthMHz |
number |
MHz の帯域幅。 |
centerFrequencyMHz |
number |
MHz の中心周波数。 |
direction |
方向 (アップリンクまたはダウンリンク)。 |
|
name |
string |
リンク名。 |
polarization |
偏光。 例: (RHCP、LHCP)。 |
systemData
リソースの作成と最後の変更に関連するメタデータ。
名前 | 型 | 説明 |
---|---|---|
createdAt |
string |
リソース作成のタイムスタンプ (UTC)。 |
createdBy |
string |
リソースを作成した ID。 |
createdByType |
リソースを作成した ID の種類。 |
|
lastModifiedAt |
string |
リソースの最終変更のタイムスタンプ (UTC) |
lastModifiedBy |
string |
リソースを最後に変更した ID。 |
lastModifiedByType |
リソースを最後に変更した ID の種類。 |