Spacecrafts - List Available Contacts
Gibt eine Liste der verfügbaren Kontakte zurück. Ein Kontakt ist verfügbar, wenn das Raumfahrzeug von der Bodenstation über die im Kontaktprofil angegebene Mindestkontaktdauer sichtbar ist.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/listAvailableContacts?api-version=2022-11-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet. |
spacecraft
|
path | True |
string |
Raumfahrzeug-ID. |
subscription
|
path | True |
string |
Hierbei handelt es sich um die ID des Zielabonnements. |
api-version
|
query | True |
string |
Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version. |
Anforderungstext
Name | Erforderlich | Typ | Beschreibung |
---|---|---|---|
contactProfile | True |
Der Verweis auf die Kontaktprofilressource. |
|
endTime | True |
string |
Endzeit eines Kontakts (ISO 8601 UTC-Standard). |
groundStationName | True |
string |
Name von Azure Ground Station. |
startTime | True |
string |
Startzeit eines Kontakts (ISO 8601 UTC-Standard). |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Anforderung erfolgreich. Der Vorgang gibt eine Liste der verfügbaren Kontaktressourcen zurück. |
|
202 Accepted |
Wird akzeptiert, und der Vorgang wird asynchron abgeschlossen. Header Location: string |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. Wenn die Ressourcengruppe nicht vorhanden ist, wird 404 (NotFound) zurückgegeben. |
Beispiele
List of Contact
Beispielanforderung
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"
}
Beispiel für eine Antwort
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"
}
Definitionen
Name | Beschreibung |
---|---|
Authorized |
Autorisierte Bodenstation. |
Auto |
Automatische Nachverfolgungskonfiguration. |
Available |
Der Kunde ruft die Liste der verfügbaren Kontakte für eine Raumfahrzeugressource ab. Später kann einer der verfügbaren Kontakte ausgewählt werden, um einen Kontakt zu erstellen. |
Available |
Antwort auf den API-Dienstaufruf ListAvailableContacts. |
Contact |
Parameter, die die Kontaktressource definieren. |
Contact |
Der Verweis auf die Kontaktprofilressource. |
Contact |
Der Kunde erstellt eine Kontaktprofilressource, die alle konfigurationen enthält, die für die Planung eines Kontakts erforderlich sind. |
Contact |
Kontaktprofillink. |
Contact |
Kontaktprofillinkkanal |
Contact |
Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource. |
Contact |
Wenden Sie sich an die Profilkonfiguration eines Drittanbieterpartners. |
created |
Der Identitätstyp, der die Ressource erstellt hat. |
direction |
Richtung (Uplink oder Downlink). |
End |
Kundenendpunkt zum Speichern und Abrufen von Daten während eines Kontakts mit dem Raumfahrzeug. |
Error |
Zusätzliche Informationen zum Ressourcenverwaltungsfehler. |
Error |
Die Fehlerdetails. |
Error |
Fehlerantwort |
Network |
Netzwerkkonfiguration des virtuellen Kundennetzwerks. |
polarization |
Polarisation. z. B. (RHCP, LHCP). |
protocol |
Protokoll entweder UDP oder TCP. |
Provisioning |
Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource. |
Spacecraft |
Der Kunde erstellt eine Raumfahrzeugressource, um einen Kontakt zu planen. |
Spacecraft |
Liste der autorisierten Raumfahrzeugverbindungen pro Bodenstation und Ablaufdatum der Genehmigung. |
system |
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen. |
AuthorizedGroundstation
Autorisierte Bodenstation.
Name | Typ | Beschreibung |
---|---|---|
expirationDate |
string |
Datum des Ablaufs der Autorisierung. |
groundStation |
string |
Bodenstationsname. |
AutoTrackingConfiguration
Automatische Nachverfolgungskonfiguration.
Name | Typ | Beschreibung |
---|---|---|
disabled |
string |
|
sBand |
string |
|
xBand |
string |
AvailableContacts
Der Kunde ruft die Liste der verfügbaren Kontakte für eine Raumfahrzeugressource ab. Später kann einer der verfügbaren Kontakte ausgewählt werden, um einen Kontakt zu erstellen.
Name | Typ | Beschreibung |
---|---|---|
groundStationName |
string |
Name von Azure Ground Station. |
properties.endAzimuthDegrees |
number |
Azimut der Antenne am Ende des Kontakts in Dezimalgrad. |
properties.endElevationDegrees |
number |
Raumfahrzeughöhe über dem Horizont am Kontaktende. |
properties.maximumElevationDegrees |
number |
Maximale Höhe der Antenne während des Kontakts in Dezimalgraden. |
properties.rxEndTime |
string |
Zeit für den Verlust des Empfangs eines Signals (ISO 8601 UTC-Standard). |
properties.rxStartTime |
string |
Frühester Zeitpunkt für den Empfang eines Signals (ISO 8601 UTC-Standard). |
properties.startAzimuthDegrees |
number |
Azimut der Antenne am Anfang des Kontakts in Dezimalgrad. |
properties.startElevationDegrees |
number |
Raumfahrzeughöhe über dem Horizont beim Kontaktstart. |
properties.txEndTime |
string |
Zeitpunkt, zu dem die Antennenübertragung deaktiviert wird (ISO 8601 UTC-Standard). |
properties.txStartTime |
string |
Zeitpunkt, zu dem die Antennenübertragung aktiviert wird (ISO 8601 UTC-Standard). |
spacecraft |
Der Verweis auf die Raumfahrzeugressource. |
AvailableContactsListResult
Antwort auf den API-Dienstaufruf ListAvailableContacts.
Name | Typ | Beschreibung |
---|---|---|
nextLink |
string |
Die URL zum Abrufen des nächsten Resultsets. |
value |
Eine Liste der verfügbaren Kontakte. |
ContactParameters
Parameter, die die Kontaktressource definieren.
Name | Typ | Beschreibung |
---|---|---|
contactProfile |
Der Verweis auf die Kontaktprofilressource. |
|
endTime |
string |
Endzeit eines Kontakts (ISO 8601 UTC-Standard). |
groundStationName |
string |
Name von Azure Ground Station. |
startTime |
string |
Startzeit eines Kontakts (ISO 8601 UTC-Standard). |
ContactParameters.ContactProfile
Der Verweis auf die Kontaktprofilressource.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
ContactProfile
Der Kunde erstellt eine Kontaktprofilressource, die alle konfigurationen enthält, die für die Planung eines Kontakts erforderlich sind.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.autoTrackingConfiguration |
Automatische Nachverfolgungskonfiguration. |
|
properties.eventHubUri |
string |
ARM-Ressourcenbezeichner des Event Hubs, der für Telemetriedaten verwendet wird. Erfordert die Gewährung der Rechte des Orbitalressourcenanbieters zum Senden von Telemetriedaten an den Hub. |
properties.links |
Links des Kontaktprofils. Beschreibt RF-Verbindungen, Modemverarbeitung und IP-Endpunkte. |
|
properties.minimumElevationDegrees |
number |
Minimale lebensfähige Höhe für den Kontakt in Dezimalgraden. Wird verwendet, um die verfügbaren Kontakte mit einem Raumfahrzeug auf einer bestimmten Bodenstation aufzulisten. |
properties.minimumViableContactDuration |
string |
Minimale lebensfähige Kontaktdauer im ISO 8601-Format. Wird verwendet, um die verfügbaren Kontakte mit einem Raumfahrzeug auf einer bestimmten Bodenstation aufzulisten. |
properties.networkConfiguration |
Netzwerkkonfiguration des virtuellen Kundennetzwerks. |
|
properties.provisioningState |
Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource. |
|
properties.thirdPartyConfigurations |
Konfiguration der Drittanbietermission des Kontaktprofils. Beschreibt RF-Verbindungen, Modemverarbeitung und IP-Endpunkte. |
|
systemData |
Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen. |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
ContactProfileLink
Kontaktprofillink.
Name | Typ | Beschreibung |
---|---|---|
channels |
Kontaktprofillinkkanal |
|
direction |
Richtung (Uplink oder Downlink). |
|
eirpdBW |
number |
Effektive isotrope Strahlungsleistung (EIRP) in dBW. Es ist die vom Kunden geforderte EIRP. Noch nicht verwendet. |
gainOverTemperature |
number |
Verstärkung der Rauschtemperatur in db/K. Es handelt sich um die vom Kunden geforderte G/T. Noch nicht verwendet. |
name |
string |
Linkname. |
polarization |
Polarisation. z.B. (RHCP, LHCP). |
ContactProfileLinkChannel
Kontaktprofillinkkanal
Name | Typ | Beschreibung |
---|---|---|
bandwidthMHz |
number |
Bandbreite in MHz. |
centerFrequencyMHz |
number |
Mittelfrequenz in MHz. |
decodingConfiguration |
string |
Derzeit nicht verwendet. |
demodulationConfiguration |
string |
Kopie der Modemkonfigurationsdatei wie Kratos QRadio oder Kratos QuantumRx. Nur gültig für Downlink-Richtungen. Falls angegeben, stellt das Modem eine Verbindung mit dem Kundenendpunkt her und sendet demodulierte Daten anstelle eines VITA.49-Streams. |
encodingConfiguration |
string |
Derzeit nicht verwendet. |
endPoint |
Kundenendpunkt zum Speichern und Abrufen von Daten während eines Kontakts mit dem Raumfahrzeug. |
|
modulationConfiguration |
string |
Kopieren Sie die Modemkonfigurationsdatei, z. B. Kratos QRadio. Nur gültig für Uplink-Richtungen. Falls angegeben, stellt das Modem eine Verbindung mit dem Kundenendpunkt her und akzeptiert Befehle vom Kunden anstelle eines VITA.49-Streams. |
name |
string |
Kanalname. |
ContactProfilesProperties.ProvisioningState
Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.
ContactProfileThirdPartyConfiguration
Wenden Sie sich an die Profilkonfiguration eines Drittanbieterpartners.
Name | Typ | Beschreibung |
---|---|---|
missionConfiguration |
string |
Name der Zeichenfolge, die auf die Konfiguration verweist, die die Einrichtung des Kontakts für eine bestimmte Mission beschreibt. Erwartete Werte sind werte, die in Zusammenarbeit mit dem Partnernetzwerk erstellt wurden. |
providerName |
string |
Name des Drittanbieters. |
createdByType
Der Identitätstyp, der die Ressource erstellt hat.
Name | Typ | Beschreibung |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
direction
Richtung (Uplink oder Downlink).
Name | Typ | Beschreibung |
---|---|---|
Downlink |
string |
|
Uplink |
string |
EndPoint
Kundenendpunkt zum Speichern und Abrufen von Daten während eines Kontakts mit dem Raumfahrzeug.
Name | Typ | Beschreibung |
---|---|---|
endPointName |
string |
Name eines Endpunkts. |
ipAddress |
string |
IP-Adresse (IPv4). |
port |
string |
TCP-Port zum Abhören von Daten. |
protocol |
Protokoll entweder UDP oder TCP. |
ErrorAdditionalInfo
Zusätzliche Informationen zum Ressourcenverwaltungsfehler.
Name | Typ | Beschreibung |
---|---|---|
info |
object |
Zusätzliche Informationen. |
type |
string |
Typ der zusätzlichen Informationen. |
ErrorDetail
Die Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
additionalInfo |
Die zusätzlichen Fehlerinformationen. |
|
code |
string |
Der Fehlercode. |
details |
Die Fehlerdetails. |
|
message |
string |
Die Fehlermeldung. |
target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
Name | Typ | Beschreibung |
---|---|---|
error |
Das Fehlerobjekt. |
NetworkConfiguration
Netzwerkkonfiguration des virtuellen Kundennetzwerks.
Name | Typ | Beschreibung |
---|---|---|
subnetId |
string |
ARM-Ressourcenbezeichner des Subnetzes, das an Microsoft.Orbital/orbitalGateways delegiert wurde. Muss mindestens ein Subnetz der Klasse C sein und sollte keine IP-Adresse darin erstellt haben. |
polarization
Polarisation. z. B. (RHCP, LHCP).
Name | Typ | Beschreibung |
---|---|---|
LHCP |
string |
|
RHCP |
string |
|
linearHorizontal |
string |
|
linearVertical |
string |
protocol
Protokoll entweder UDP oder TCP.
Name | Typ | Beschreibung |
---|---|---|
TCP |
string |
|
UDP |
string |
ProvisioningState
Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.
Spacecraft
Der Kunde erstellt eine Raumfahrzeugressource, um einen Kontakt zu planen.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Der geografische Standort, an dem sich die Ressource befindet |
name |
string |
Der Name der Ressource |
properties.links |
Unveränderliche Liste der Raumfahrzeuglinks. |
|
properties.noradId |
string |
NORAD ID des Raumfahrzeugs. |
properties.provisioningState |
Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource. |
|
properties.titleLine |
string |
Titelzeile des zweizeiligen Elementsatzes (TLE). |
properties.tleLine1 |
string |
Zeile 1 des zweizeiligen Elementsatzes (TLE). |
properties.tleLine2 |
string |
Zeile 2 des zweizeiligen Elementsatzes (TLE). |
systemData |
Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen. |
|
tags |
object |
Ressourcentags. |
type |
string |
Der Typ der Ressource. Z.B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts" |
SpacecraftLink
Liste der autorisierten Raumfahrzeugverbindungen pro Bodenstation und Ablaufdatum der Genehmigung.
Name | Typ | Beschreibung |
---|---|---|
authorizations |
Autorisierte Bodenstationen |
|
bandwidthMHz |
number |
Bandbreite in MHz. |
centerFrequencyMHz |
number |
Mittelfrequenz in MHz. |
direction |
Richtung (Uplink oder Downlink). |
|
name |
string |
Linkname. |
polarization |
Polarisation. z. B. (RHCP, LHCP). |
systemData
Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.
Name | Typ | Beschreibung |
---|---|---|
createdAt |
string |
Der Zeitstempel der Ressourcenerstellung (UTC). |
createdBy |
string |
Die Identität, die die Ressource erstellt hat. |
createdByType |
Der Identitätstyp, der die Ressource erstellt hat. |
|
lastModifiedAt |
string |
Der Zeitstempel der letzten Änderung der Ressource (UTC) |
lastModifiedBy |
string |
Die Identität, die die Ressource zuletzt geändert hat. |
lastModifiedByType |
Der Identitätstyp, der die Ressource zuletzt geändert hat. |