Delen via


Spacecrafts - List Available Contacts

Retourneert een lijst met beschikbare contactpersonen. Een contact is beschikbaar als het ruimtevaartuig zichtbaar is vanaf het grondstation voor meer dan de minimale levensvatbare contactduur die in het contactprofiel is opgegeven.

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

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

spacecraftName
path True

string

Ruimtevaartuig-id.

subscriptionId
path True

string

De id van het doelabonnement.

api-version
query True

string

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
contactProfile True

ContactProfile

De verwijzing naar de resource van het contactprofiel.

endTime True

string

Eindtijd van een contactpersoon (ISO 8601 UTC-standaard).

groundStationName True

string

Naam van Azure Ground Station.

startTime True

string

Begintijd van een contactpersoon (ISO 8601 UTC-standaard).

Antwoorden

Name Type Description
200 OK

AvailableContactsListResult

De aanvraag is voltooid. De bewerking retourneert een lijst met beschikbare resources voor contactpersonen.

202 Accepted

Geaccepteerd en de bewerking wordt asynchroon voltooid.

Kopteksten

Location: string

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. Als de resourcegroep niet bestaat, wordt 404 (NotFound) geretourneerd.

Voorbeelden

List of Contact

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
AuthorizedGroundstation

Geautoriseerd grondstation.

AutoTrackingConfiguration

Configuratie voor automatisch bijhouden.

AvailableContacts

De klant haalt een lijst met beschikbare contactpersonen voor een ruimtevaartuigresource op. Later kan een van de beschikbare contactpersonen worden geselecteerd om een contactpersoon te maken.

AvailableContactsListResult

Antwoord voor de Api-serviceaanroep ListAvailableContacts.

ContactParameters

Parameters waarmee de contactpersoonresource wordt gedefinieerd.

ContactParameters.ContactProfile

De verwijzing naar de resource van het contactprofiel.

ContactProfile

De klant maakt een profielresource voor contactpersonen, die alle configuraties bevat die nodig zijn voor het plannen van een contactpersoon.

ContactProfileLink

Profielkoppeling voor contactpersoon.

ContactProfileLinkChannel

Profielkoppelingskanaal voor contactpersonen.

ContactProfilesProperties.ProvisioningState

De huidige status van het maken, verwijderen of wijzigen van de resource.

ContactProfileThirdPartyConfiguration

Neem contact op met Profiel van externe partnerconfiguratie.

createdByType

Het type identiteit waarmee de resource is gemaakt.

direction

Richting (uplink of downlink).

EndPoint

Eindpunt van de klant om gegevens op te slaan en op te halen tijdens contact met het ruimtevaartuig.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

NetworkConfiguration

Netwerkconfiguratie van het virtuele netwerk van de klant.

polarization

Polarisatie. bijvoorbeeld (RHCP, LHCP).

protocol

Protocol UDP of TCP.

ProvisioningState

De huidige status van het maken, verwijderen of wijzigen van de resource.

Spacecraft

De klant maakt een ruimtevaartuigresource om een contactpersoon te plannen.

SpacecraftLink

Lijst van geautoriseerde ruimtevaartuigen per grondstation en de vervaldatum van de autorisatie.

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

AuthorizedGroundstation

Geautoriseerd grondstation.

Name Type Description
expirationDate

string

Vervaldatum van de autorisatie.

groundStation

string

Naam van het grondstation.

AutoTrackingConfiguration

Configuratie voor automatisch bijhouden.

Name Type Description
disabled

string

sBand

string

xBand

string

AvailableContacts

De klant haalt een lijst met beschikbare contactpersonen voor een ruimtevaartuigresource op. Later kan een van de beschikbare contactpersonen worden geselecteerd om een contactpersoon te maken.

Name Type Description
groundStationName

string

Naam van Azure Ground Station.

properties.endAzimuthDegrees

number

Azimut van de antenne aan het einde van het contact in decimale graden.

properties.endElevationDegrees

number

De hoogte van de ruimtevaartuigen boven de horizon bij het contacteinde.

properties.maximumElevationDegrees

number

Maximale hoogte van de antenne tijdens het contact in decimale graden.

properties.rxEndTime

string

Tijd om een signaal te verliezen (ISO 8601 UTC-standaard).

properties.rxStartTime

string

Vroegste tijd om een signaal te ontvangen (ISO 8601 UTC-standaard).

properties.startAzimuthDegrees

number

Azimuth van de antenne aan het begin van het contact in decimale graden.

properties.startElevationDegrees

number

Ruimtevaartuigen boven de horizon bij het begin van het contact.

properties.txEndTime

string

Tijdstip waarop antenne-verzending wordt uitgeschakeld (ISO 8601 UTC-standaard).

properties.txStartTime

string

Tijdstip waarop antenne-verzending wordt ingeschakeld (ISO 8601 UTC-standaard).

spacecraft

Spacecraft

De verwijzing naar de resource van het ruimtevaartuig.

AvailableContactsListResult

Antwoord voor de Api-serviceaanroep ListAvailableContacts.

Name Type Description
nextLink

string

De URL voor het ophalen van de volgende set resultaten.

value

AvailableContacts[]

Een lijst met beschikbare contactpersonen.

ContactParameters

Parameters waarmee de contactpersoonresource wordt gedefinieerd.

Name Type Description
contactProfile

ContactProfile

De verwijzing naar de resource van het contactprofiel.

endTime

string

Eindtijd van een contactpersoon (ISO 8601 UTC-standaard).

groundStationName

string

Naam van Azure Ground Station.

startTime

string

Begintijd van een contactpersoon (ISO 8601 UTC-standaard).

ContactParameters.ContactProfile

De verwijzing naar de resource van het contactprofiel.

Name Type Description
id

string

Resource-id.

ContactProfile

De klant maakt een profielresource voor contactpersonen, die alle configuraties bevat die nodig zijn voor het plannen van een contactpersoon.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.autoTrackingConfiguration

AutoTrackingConfiguration

Configuratie voor automatisch bijhouden.

properties.eventHubUri

string

ARM-resource-id van de Event Hub die wordt gebruikt voor telemetrie. Vereist dat Orbital Resource Provider de rechten verleent om telemetriegegevens naar de hub te verzenden.

properties.links

ContactProfileLink[]

Koppelingen van het profiel van de contactpersoon. Beschrijft RF-koppelingen, modemverwerking en IP-eindpunten.

properties.minimumElevationDegrees

number

Minimale levensvatbare verhoging voor de contactpersoon in decimale graden. Wordt gebruikt voor het weergeven van de beschikbare contacten met een ruimtevaartuig op een bepaald grondstation.

properties.minimumViableContactDuration

string

Minimale levensvatbare contactduur in ISO 8601-indeling. Wordt gebruikt voor het weergeven van de beschikbare contacten met een ruimtevaartuig op een bepaald grondstation.

properties.networkConfiguration

NetworkConfiguration

Netwerkconfiguratie van het virtuele netwerk van de klant.

properties.provisioningState

ContactProfilesProperties.ProvisioningState

De huidige status van het maken, verwijderen of wijzigen van de resource.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Configuratie van de missie van derden van het contactprofiel. Beschrijft RF-koppelingen, modemverwerking en IP-eindpunten.

systemData

systemData

Azure Resource Manager metagegevens met informatie over createdBy en modifiedBy.

tags

object

Resourcetags.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

Profielkoppeling voor contactpersoon.

Name Type Description
channels

ContactProfileLinkChannel[]

Profielkoppelingskanaal voor contactpersonen.

direction

direction

Richting (uplink of downlink).

eirpdBW

number

Effectieve Isotropic Radiated Power (EIRP) in dBW. Dit is de vereiste EIRP door de klant. Nog niet gebruikt.

gainOverTemperature

number

Gain tot ruistemperatuur in db/K. Dit is de vereiste G/T door de klant. Nog niet gebruikt.

name

string

Naam van koppeling.

polarization

polarization

Polarisatie. bijvoorbeeld (RHCP, LHCP).

ContactProfileLinkChannel

Profielkoppelingskanaal voor contactpersonen.

Name Type Description
bandwidthMHz

number

Bandbreedte in MHz.

centerFrequencyMHz

number

Middenfrequentie in MHz.

decodingConfiguration

string

Momenteel niet gebruikt.

demodulationConfiguration

string

Kopie van het modemconfiguratiebestand, zoals Kratos QRadio of Kratos QuantumRx. Alleen geldig voor routebeschrijvingen voor downlinks. Indien opgegeven, maakt het modem verbinding met het eindpunt van de klant en verzendt gedemoduleerde gegevens in plaats van een VITA.49-stream.

encodingConfiguration

string

Momenteel niet gebruikt.

endPoint

EndPoint

Eindpunt van de klant om gegevens op te slaan en op te halen tijdens contact met het ruimtevaartuig.

modulationConfiguration

string

Kopie van het modemconfiguratiebestand, zoals Kratos QRadio. Alleen geldig voor routebeschrijvingen voor uplinks. Indien opgegeven, maakt de modem verbinding met het eindpunt van de klant en accepteert opdrachten van de klant in plaats van een VITA.49-stream.

name

string

Kanaalnaam.

ContactProfilesProperties.ProvisioningState

De huidige status van het maken, verwijderen of wijzigen van de resource.

ContactProfileThirdPartyConfiguration

Neem contact op met Profiel van externe partnerconfiguratie.

Name Type Description
missionConfiguration

string

De naam van de tekenreeks die verwijst naar de configuratie die het instellen van contactpersonen voor een bepaalde missie beschrijft. Verwachte waarden zijn de waarden die zijn gemaakt in samenwerking met het partnernetwerk.

providerName

string

Naam van de externe provider.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Richting (uplink of downlink).

Name Type Description
Downlink

string

Uplink

string

EndPoint

Eindpunt van de klant om gegevens op te slaan en op te halen tijdens contact met het ruimtevaartuig.

Name Type Description
endPointName

string

Naam van een eindpunt.

ipAddress

string

IP-adres (IPv4).

port

string

TCP-poort waarop moet worden geluisterd om gegevens te ontvangen.

protocol

protocol

Protocol UDP of TCP.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

NetworkConfiguration

Netwerkconfiguratie van het virtuele netwerk van de klant.

Name Type Description
subnetId

string

ARM-resource-id van het subnet dat is gedelegeerd aan de Microsoft.Orbital/orbitalGateways. Moet ten minste een subnet van klasse C zijn en er mag geen IP-adres zijn gemaakt.

polarization

Polarisatie. bijvoorbeeld (RHCP, LHCP).

Name Type Description
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

protocol

Protocol UDP of TCP.

Name Type Description
TCP

string

UDP

string

ProvisioningState

De huidige status van het maken, verwijderen of wijzigen van de resource.

Spacecraft

De klant maakt een ruimtevaartuigresource om een contactpersoon te plannen.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.links

SpacecraftLink[]

Onveranderbare lijst met koppelingen naar ruimtevaartuigen.

properties.noradId

string

NORAD ID van het ruimtevaartuig.

properties.provisioningState

ProvisioningState

De huidige status van het maken, verwijderen of wijzigen van de resource.

properties.titleLine

string

Titelregel van de tweeregelige elementenset (TLE).

properties.tleLine1

string

Regel 1 van de tweeregelige elementenset (TLE).

properties.tleLine2

string

Regel 2 van de tweeregelige elementenset (TLE).

systemData

systemData

Azure Resource Manager metagegevens met informatie over createdBy en modifiedBy.

tags

object

Resourcetags.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

Lijst van geautoriseerde ruimtevaartuigen per grondstation en de vervaldatum van de autorisatie.

Name Type Description
authorizations

AuthorizedGroundstation[]

Geautoriseerde grondstations

bandwidthMHz

number

Bandbreedte in MHz.

centerFrequencyMHz

number

Middenfrequentie in MHz.

direction

direction

Richting (uplink of downlink).

name

string

Naam van koppeling.

polarization

polarization

Polarisatie. bijvoorbeeld (RHCP, LHCP).

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name Type Description
createdAt

string

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit die de resource heeft gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

Het tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.