Freigeben über


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
resourceGroupName
path True

string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

spacecraftName
path True

string

Raumfahrzeug-ID.

subscriptionId
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

ContactProfile

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

AvailableContactsListResult

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

ErrorResponse

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
AuthorizedGroundstation

Autorisierte Bodenstation.

AutoTrackingConfiguration

Automatische Nachverfolgungskonfiguration.

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.

AvailableContactsListResult

Antwort auf den API-Dienstaufruf ListAvailableContacts.

ContactParameters

Parameter, die die Kontaktressource definieren.

ContactParameters.ContactProfile

Der Verweis auf die Kontaktprofilressource.

ContactProfile

Der Kunde erstellt eine Kontaktprofilressource, die alle konfigurationen enthält, die für die Planung eines Kontakts erforderlich sind.

ContactProfileLink

Kontaktprofillink.

ContactProfileLinkChannel

Kontaktprofillinkkanal

ContactProfilesProperties.ProvisioningState

Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.

ContactProfileThirdPartyConfiguration

Wenden Sie sich an die Profilkonfiguration eines Drittanbieterpartners.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

direction

Richtung (Uplink oder Downlink).

EndPoint

Kundenendpunkt zum Speichern und Abrufen von Daten während eines Kontakts mit dem Raumfahrzeug.

ErrorAdditionalInfo

Zusätzliche Informationen zum Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

NetworkConfiguration

Netzwerkkonfiguration des virtuellen Kundennetzwerks.

polarization

Polarisation. z. B. (RHCP, LHCP).

protocol

Protokoll entweder UDP oder TCP.

ProvisioningState

Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.

Spacecraft

Der Kunde erstellt eine Raumfahrzeugressource, um einen Kontakt zu planen.

SpacecraftLink

Liste der autorisierten Raumfahrzeugverbindungen pro Bodenstation und Ablaufdatum der Genehmigung.

systemData

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

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

AvailableContacts[]

Eine Liste der verfügbaren Kontakte.

ContactParameters

Parameter, die die Kontaktressource definieren.

Name Typ Beschreibung
contactProfile

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

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

ContactProfileLink[]

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

NetworkConfiguration

Netzwerkkonfiguration des virtuellen Kundennetzwerks.

properties.provisioningState

ContactProfilesProperties.ProvisioningState

Der aktuelle Status der Erstellung, Löschung oder Änderung der Ressource.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Konfiguration der Drittanbietermission des Kontaktprofils. Beschreibt RF-Verbindungen, Modemverarbeitung und IP-Endpunkte.

systemData

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"

Kontaktprofillink.

Name Typ Beschreibung
channels

ContactProfileLinkChannel[]

Kontaktprofillinkkanal

direction

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

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

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

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

ErrorAdditionalInfo[]

Die zusätzlichen Fehlerinformationen.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

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

SpacecraftLink[]

Unveränderliche Liste der Raumfahrzeuglinks.

properties.noradId

string

NORAD ID des Raumfahrzeugs.

properties.provisioningState

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

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"

Liste der autorisierten Raumfahrzeugverbindungen pro Bodenstation und Ablaufdatum der Genehmigung.

Name Typ Beschreibung
authorizations

AuthorizedGroundstation[]

Autorisierte Bodenstationen

bandwidthMHz

number

Bandbreite in MHz.

centerFrequencyMHz

number

Mittelfrequenz in MHz.

direction

direction

Richtung (Uplink oder Downlink).

name

string

Linkname.

polarization

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

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

createdByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.