Udostępnij za pośrednictwem


Spacecrafts - List Available Contacts

Zwraca listę dostępnych kontaktów. Kontakt jest dostępny, jeśli statek kosmiczny jest widoczny ze stacji naziemnej przez więcej niż minimalny realny czas kontaktu podany w profilu kontaktu.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/listAvailableContacts?api-version=2022-11-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.

spacecraftName
path True

string

Identyfikator statku kosmicznego.

subscriptionId
path True

string

Identyfikator subskrypcji docelowej.

api-version
query True

string

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
contactProfile True

ContactProfile

Odwołanie do zasobu profilu kontaktu.

endTime True

string

Godzina zakończenia kontaktu (standard ISO 8601 UTC).

groundStationName True

string

Nazwa stacji naziemnej platformy Azure.

startTime True

string

Godzina rozpoczęcia kontaktu (standard ISO 8601 UTC).

Odpowiedzi

Nazwa Typ Opis
200 OK

AvailableContactsListResult

Żądanie powiodło się. Operacja zwraca listę dostępnych zasobów kontaktów.

202 Accepted

Zaakceptowane i operacja zostanie ukończona asynchronicznie.

Nagłówki

Location: string

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. Jeśli grupa zasobów nie istnieje, zostanie zwrócona wartość 404 (NotFound).

Przykłady

List of Contact

Przykładowe żądanie

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"
}

Przykładowa odpowiedź

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"
}

Definicje

Nazwa Opis
AuthorizedGroundstation

Autoryzowane naziemne.

AutoTrackingConfiguration

Konfiguracja automatycznego śledzenia.

AvailableContacts

Klient pobiera listę dostępnych kontaktów dla zasobu statku kosmicznego. Później można wybrać jeden z dostępnych kontaktów, aby utworzyć kontakt.

AvailableContactsListResult

Odpowiedź wywołania usługi interfejsu API ListAvailableContacts.

ContactParameters

Parametry definiujące zasób kontaktu.

ContactParameters.ContactProfile

Odwołanie do zasobu profilu kontaktu.

ContactProfile

Klient tworzy zasób profilu kontaktu, który będzie zawierać wszystkie konfiguracje wymagane do planowania kontaktu.

ContactProfileLink

Link profilu kontaktu.

ContactProfileLinkChannel

Kanał linku profilu kontaktu.

ContactProfilesProperties.ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

ContactProfileThirdPartyConfiguration

Skontaktuj się z konfiguracją partnera innej firmy.

createdByType

Typ tożsamości, która utworzyła zasób.

direction

Kierunek (link do góry lub do dołu).

EndPoint

Punkt końcowy klienta do przechowywania i pobierania danych podczas kontaktu ze statkiem kosmicznym.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

NetworkConfiguration

Konfiguracja sieci wirtualnej klienta.

polarization

Polaryzacji. np. (RHCP, LHCP).

protocol

Protokół UDP lub TCP.

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

Spacecraft

Klient tworzy zasób statku kosmicznego, aby zaplanować kontakt.

SpacecraftLink

Lista autoryzowanych połączeń statków kosmicznych na stację naziemną i datę wygaśnięcia autoryzacji.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AuthorizedGroundstation

Autoryzowane naziemne.

Nazwa Typ Opis
expirationDate

string

Data wygaśnięcia autoryzacji.

groundStation

string

Nazwa stacji naziemnej.

AutoTrackingConfiguration

Konfiguracja automatycznego śledzenia.

Nazwa Typ Opis
disabled

string

sBand

string

xBand

string

AvailableContacts

Klient pobiera listę dostępnych kontaktów dla zasobu statku kosmicznego. Później można wybrać jeden z dostępnych kontaktów, aby utworzyć kontakt.

Nazwa Typ Opis
groundStationName

string

Nazwa stacji naziemnej platformy Azure.

properties.endAzimuthDegrees

number

Azimuth anteny na końcu kontaktu w stopniach dziesiętnych.

properties.endElevationDegrees

number

Statek kosmiczny wzniesie nad horyzontem na końcu kontaktu.

properties.maximumElevationDegrees

number

Maksymalna wysokość anteny podczas kontaktu w stopniach dziesiętnych.

properties.rxEndTime

string

Czas utraty sygnału (standard ISO 8601 UTC).

properties.rxStartTime

string

Najwcześniejszy czas odbierania sygnału (standard ISO 8601 UTC).

properties.startAzimuthDegrees

number

Azimuth anteny na początku kontaktu w stopniach dziesiętnych.

properties.startElevationDegrees

number

Statek kosmiczny wzniesie nad horyzontem na początku kontaktu.

properties.txEndTime

string

Godzina wyłączenia transmisji anteny (standard ISO 8601 UTC).

properties.txStartTime

string

Godzina włączenia transmisji anteny (standard ISO 8601 UTC).

spacecraft

Spacecraft

Odwołanie do zasobu statku kosmicznego.

AvailableContactsListResult

Odpowiedź wywołania usługi interfejsu API ListAvailableContacts.

Nazwa Typ Opis
nextLink

string

Adres URL umożliwiający uzyskanie następnego zestawu wyników.

value

AvailableContacts[]

Lista dostępnych kontaktów.

ContactParameters

Parametry definiujące zasób kontaktu.

Nazwa Typ Opis
contactProfile

ContactProfile

Odwołanie do zasobu profilu kontaktu.

endTime

string

Godzina zakończenia kontaktu (standard ISO 8601 UTC).

groundStationName

string

Nazwa stacji naziemnej platformy Azure.

startTime

string

Godzina rozpoczęcia kontaktu (standard ISO 8601 UTC).

ContactParameters.ContactProfile

Odwołanie do zasobu profilu kontaktu.

Nazwa Typ Opis
id

string

Identyfikator zasobu.

ContactProfile

Klient tworzy zasób profilu kontaktu, który będzie zawierać wszystkie konfiguracje wymagane do planowania kontaktu.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.autoTrackingConfiguration

AutoTrackingConfiguration

Konfiguracja automatycznego śledzenia.

properties.eventHubUri

string

Identyfikator zasobu usługi ARM centrum zdarzeń używany do telemetrii. Wymaga udzielenia dostawcy zasobów orbitalnych praw do wysyłania danych telemetrycznych do centrum.

properties.links

ContactProfileLink[]

Linki do profilu kontaktu. Opisuje łącza RF, przetwarzanie modemów i punkty końcowe adresów IP.

properties.minimumElevationDegrees

number

Minimalna opłacalna wysokość kontaktu w stopniach dziesiętnych. Służy do wyświetlania dostępnych kontaktów ze statkiem kosmicznym na danej stacji naziemnej.

properties.minimumViableContactDuration

string

Minimalny realny czas trwania kontaktu w formacie ISO 8601. Służy do wyświetlania dostępnych kontaktów ze statkiem kosmicznym na danej stacji naziemnej.

properties.networkConfiguration

NetworkConfiguration

Konfiguracja sieci wirtualnej klienta.

properties.provisioningState

ContactProfilesProperties.ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Konfiguracja misji innej firmy w profilu kontaktowym. Opisuje łącza RF, przetwarzanie modemów i punkty końcowe adresów IP.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

Link profilu kontaktu.

Nazwa Typ Opis
channels

ContactProfileLinkChannel[]

Kanał linku profilu kontaktu.

direction

direction

Kierunek (łącze w górę lub w dół).

eirpdBW

number

Efektywna moc promieniowana izotropowa (EIRP) w dBW. Jest to wymagany EIRP przez klienta. Jeszcze nie użyto.

gainOverTemperature

number

Zyskaj temperaturę szumu w bazie danych/K. Jest to wymagane przez klienta G/T. Jeszcze nie użyto.

name

string

Nazwa łącza.

polarization

polarization

Polaryzacji. np. (RHCP, LHCP).

ContactProfileLinkChannel

Kanał linku profilu kontaktu.

Nazwa Typ Opis
bandwidthMHz

number

Przepustowość w MHz.

centerFrequencyMHz

number

Częstotliwość wyśrodkowania w MHz.

decodingConfiguration

string

Obecnie nieużywane.

demodulationConfiguration

string

Kopia pliku konfiguracji modemu, takiego jak Kratos QRadio lub Kratos QuantumRx. Prawidłowe tylko dla wskazówek łącza do dołu. Jeśli zostanie podany, modem łączy się z punktem końcowym klienta i wysyła zdegradowane dane zamiast strumienia VITA.49.

encodingConfiguration

string

Obecnie nieużywane.

endPoint

EndPoint

Punkt końcowy klienta do przechowywania i pobierania danych podczas kontaktu ze statkiem kosmicznym.

modulationConfiguration

string

Kopia pliku konfiguracji modemu, takiego jak Kratos QRadio. Prawidłowe tylko dla wskazówek pasma. Jeśli zostanie podany, modem łączy się z punktem końcowym klienta i akceptuje polecenia od klienta zamiast strumienia VITA.49.

name

string

Nazwa kanału.

ContactProfilesProperties.ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

ContactProfileThirdPartyConfiguration

Skontaktuj się z konfiguracją partnera innej firmy.

Nazwa Typ Opis
missionConfiguration

string

Nazwa ciągu odwołującego się do konfiguracji opisującej konfigurację kontaktu skonfigurowaną dla określonej misji. Oczekiwane wartości to te, które zostały utworzone we współpracy z siecią partnerów.

providerName

string

Nazwa dostawcy innej firmy.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Kierunek (link do góry lub do dołu).

Nazwa Typ Opis
Downlink

string

Uplink

string

EndPoint

Punkt końcowy klienta do przechowywania i pobierania danych podczas kontaktu ze statkiem kosmicznym.

Nazwa Typ Opis
endPointName

string

Nazwa punktu końcowego.

ipAddress

string

Adres IP (IPv4).

port

string

Port TCP do nasłuchiwania w celu odbierania danych.

protocol

protocol

Protokół UDP lub TCP.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

NetworkConfiguration

Konfiguracja sieci wirtualnej klienta.

Nazwa Typ Opis
subnetId

string

Identyfikator zasobu usługi ARM podsieci delegowanej do bramy Microsoft.Orbital/orbitalGateways. Musi być co najmniej podsiecią C klasy i nie powinna mieć w niej żadnego adresu IP.

polarization

Polaryzacji. np. (RHCP, LHCP).

Nazwa Typ Opis
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

protocol

Protokół UDP lub TCP.

Nazwa Typ Opis
TCP

string

UDP

string

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

Spacecraft

Klient tworzy zasób statku kosmicznego, aby zaplanować kontakt.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.links

SpacecraftLink[]

Niezmienna lista łączy statków kosmicznych.

properties.noradId

string

NORAD ID statku kosmicznego.

properties.provisioningState

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

properties.titleLine

string

Wiersz tytułu zestawu elementów dwuwierszowych (TLE).

properties.tleLine1

string

Linia 1 zestawu elementów dwuwierszowych (TLE).

properties.tleLine2

string

Linia 2 zestawu elementów dwuwierszowych (TLE).

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

Lista autoryzowanych połączeń statków kosmicznych na stację naziemną i datę wygaśnięcia autoryzacji.

Nazwa Typ Opis
authorizations

AuthorizedGroundstation[]

Autoryzowane stacje naziemne

bandwidthMHz

number

Przepustowość w MHz.

centerFrequencyMHz

number

Częstotliwość wyśrodkowania w MHz.

direction

direction

Kierunek (link do góry lub do dołu).

name

string

Nazwa łącza.

polarization

polarization

Polaryzacji. np. (RHCP, LHCP).

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string

Sygnatura czasowa ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.