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 |
---|---|---|---|---|
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
spacecraft
|
path | True |
string |
Identyfikator statku kosmicznego. |
subscription
|
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 |
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 |
Żą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 |
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 |
---|---|
Authorized |
Autoryzowane naziemne. |
Auto |
Konfiguracja automatycznego śledzenia. |
Available |
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. |
Available |
Odpowiedź wywołania usługi interfejsu API ListAvailableContacts. |
Contact |
Parametry definiujące zasób kontaktu. |
Contact |
Odwołanie do zasobu profilu kontaktu. |
Contact |
Klient tworzy zasób profilu kontaktu, który będzie zawierać wszystkie konfiguracje wymagane do planowania kontaktu. |
Contact |
Link profilu kontaktu. |
Contact |
Kanał linku profilu kontaktu. |
Contact |
Bieżący stan tworzenia, usuwania lub modyfikacji zasobu. |
Contact |
Skontaktuj się z konfiguracją partnera innej firmy. |
created |
Typ tożsamości, która utworzyła zasób. |
direction |
Kierunek (link do góry lub do dołu). |
End |
Punkt końcowy klienta do przechowywania i pobierania danych podczas kontaktu ze statkiem kosmicznym. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Network |
Konfiguracja sieci wirtualnej klienta. |
polarization |
Polaryzacji. np. (RHCP, LHCP). |
protocol |
Protokół UDP lub TCP. |
Provisioning |
Bieżący stan tworzenia, usuwania lub modyfikacji zasobu. |
Spacecraft |
Klient tworzy zasób statku kosmicznego, aby zaplanować kontakt. |
Spacecraft |
Lista autoryzowanych połączeń statków kosmicznych na stację naziemną i datę wygaśnięcia autoryzacji. |
system |
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 |
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 |
Lista dostępnych kontaktów. |
ContactParameters
Parametry definiujące zasób kontaktu.
Nazwa | Typ | Opis |
---|---|---|
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 |
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 |
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 |
Konfiguracja sieci wirtualnej klienta. |
|
properties.provisioningState |
Bieżący stan tworzenia, usuwania lub modyfikacji zasobu. |
|
properties.thirdPartyConfigurations |
Konfiguracja misji innej firmy w profilu kontaktowym. Opisuje łącza RF, przetwarzanie modemów i punkty końcowe adresów IP. |
|
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" |
ContactProfileLink
Link profilu kontaktu.
Nazwa | Typ | Opis |
---|---|---|
channels |
Kanał linku profilu kontaktu. |
|
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 |
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 |
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 |
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 |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
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 |
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 |
Niezmienna lista łączy statków kosmicznych. |
|
properties.noradId |
string |
NORAD ID statku kosmicznego. |
properties.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 |
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" |
SpacecraftLink
Lista autoryzowanych połączeń statków kosmicznych na stację naziemną i datę wygaśnięcia autoryzacji.
Nazwa | Typ | Opis |
---|---|---|
authorizations |
Autoryzowane stacje naziemne |
|
bandwidthMHz |
number |
Przepustowość w MHz. |
centerFrequencyMHz |
number |
Częstotliwość wyśrodkowania w MHz. |
direction |
Kierunek (link do góry lub do dołu). |
|
name |
string |
Nazwa łącza. |
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 |
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 |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |