Condividi tramite


Spacecrafts - List Available Contacts

Restituisce l'elenco dei contatti disponibili. Un contatto è disponibile se il veicolo spaziale è visibile dalla stazione di terra per più della durata minima di contatto fattibile fornita nel profilo di contatto.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
resourceGroupName
path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

spacecraftName
path True

string

ID veicolo spaziale.

subscriptionId
path True

string

ID della sottoscrizione di destinazione.

api-version
query True

string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome Necessario Tipo Descrizione
contactProfile True

ContactProfile

Riferimento alla risorsa del profilo di contatto.

endTime True

string

Ora di fine di un contatto (standard ISO 8601 UTC).

groundStationName True

string

Nome della stazione di terra di Azure.

startTime True

string

Ora di inizio di un contatto (standard UTC ISO 8601).

Risposte

Nome Tipo Descrizione
200 OK

AvailableContactsListResult

Richiesta completata. L'operazione restituisce un elenco delle risorse dei contatti disponibili.

202 Accepted

Accettato e l'operazione verrà completata in modo asincrono.

Headers

Location: string

Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. Se il gruppo di risorse non esiste, verrà restituito 404 (NotFound).

Esempio

List of Contact

Sample Request

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

Sample Response

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

Definizioni

Nome Descrizione
AuthorizedGroundstation

Stazione di terra autorizzata.

AutoTrackingConfiguration

Configurazione di rilevamento automatico.

AvailableContacts

Il cliente recupera l'elenco dei contatti disponibili per una risorsa del veicolo spaziale. Successivamente, è possibile selezionare uno dei contatti disponibili per creare un contatto.

AvailableContactsListResult

Risposta per la chiamata al servizio API ListAvailableContacts.

ContactParameters

Parametri che definiscono la risorsa contatto.

ContactParameters.ContactProfile

Riferimento alla risorsa del profilo di contatto.

ContactProfile

Il cliente crea una risorsa del profilo di contatto, che conterrà tutte le configurazioni necessarie per la pianificazione di un contatto.

ContactProfileLink

Collegamento del profilo di contatto.

ContactProfileLinkChannel

Canale di collegamento del profilo di contatto.

ContactProfilesProperties.ProvisioningState

Stato corrente della creazione, eliminazione o modifica della risorsa.

ContactProfileThirdPartyConfiguration

Contattare la configurazione del partner di terze parti.

createdByType

Tipo di identità che ha creato la risorsa.

direction

Direzione (Uplink o Downlink).

EndPoint

Punto finale del cliente per archiviare e recuperare i dati durante un contatto con il veicolo spaziale.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

NetworkConfiguration

Configurazione di rete della rete virtuale del cliente.

polarization

Polarizzazione. ad esempio (RHCP, LHCP).

protocol

Protocollo UDP o TCP.

ProvisioningState

Stato corrente della creazione, eliminazione o modifica della risorsa.

Spacecraft

Il cliente crea una risorsa spaziale per pianificare un contatto.

SpacecraftLink

Elenco dei collegamenti di veicoli spaziali autorizzati per stazione di terra e la data di scadenza dell'autorizzazione.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

AuthorizedGroundstation

Stazione di terra autorizzata.

Nome Tipo Descrizione
expirationDate

string

Data di scadenza dell'autorizzazione.

groundStation

string

Nome della stazione di terra.

AutoTrackingConfiguration

Configurazione di rilevamento automatico.

Nome Tipo Descrizione
disabled

string

sBand

string

xBand

string

AvailableContacts

Il cliente recupera l'elenco dei contatti disponibili per una risorsa del veicolo spaziale. Successivamente, è possibile selezionare uno dei contatti disponibili per creare un contatto.

Nome Tipo Descrizione
groundStationName

string

Nome della stazione di Terra di Azure.

properties.endAzimuthDegrees

number

Azimuth dell'antenna alla fine del contatto in gradi decimali.

properties.endElevationDegrees

number

Elevazione del veicolo spaziale sopra l'orizzonte alla fine del contatto.

properties.maximumElevationDegrees

number

Elevazione massima dell'antenna durante il contatto in gradi decimali.

properties.rxEndTime

string

Tempo per perdere la ricezione di un segnale (standard UTC ISO 8601).

properties.rxStartTime

string

Prima ora di ricevere un segnale (standard UTC ISO 8601).

properties.startAzimuthDegrees

number

Azimuth dell'antenna all'inizio del contatto in gradi decimali.

properties.startElevationDegrees

number

Elevazione del veicolo spaziale sopra l'orizzonte all'inizio del contatto.

properties.txEndTime

string

Ora in cui la trasmissione dell'antenna sarà disabilitata (standard UTC ISO 8601).

properties.txStartTime

string

Ora in cui la trasmissione dell'antenna sarà abilitata (standard UTC ISO 8601).

spacecraft

Spacecraft

Riferimento alla risorsa del veicolo spaziale.

AvailableContactsListResult

Risposta per la chiamata al servizio API ListAvailableContacts.

Nome Tipo Descrizione
nextLink

string

URL per ottenere il set successivo di risultati.

value

AvailableContacts[]

Elenco dei contatti disponibili.

ContactParameters

Parametri che definiscono la risorsa contatto.

Nome Tipo Descrizione
contactProfile

ContactProfile

Riferimento alla risorsa del profilo di contatto.

endTime

string

Ora di fine di un contatto (standard UTC ISO 8601).

groundStationName

string

Nome della stazione di Terra di Azure.

startTime

string

Ora di inizio di un contatto (standard UTC ISO 8601).

ContactParameters.ContactProfile

Riferimento alla risorsa del profilo di contatto.

Nome Tipo Descrizione
id

string

ID risorsa.

ContactProfile

Il cliente crea una risorsa del profilo di contatto, che conterrà tutte le configurazioni necessarie per la pianificazione di un contatto.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Posizione geografica in cui vive la risorsa

name

string

nome della risorsa.

properties.autoTrackingConfiguration

AutoTrackingConfiguration

Configurazione di rilevamento automatico.

properties.eventHubUri

string

Identificatore di risorsa ARM dell'hub eventi usato per i dati di telemetria. Richiede la concessione dei diritti di invio dei dati di telemetria nell'hub.

properties.links

ContactProfileLink[]

Collegamenti del profilo di contatto. Descrive i collegamenti RF, l'elaborazione del modem e gli endpoint IP.

properties.minimumElevationDegrees

number

Elevazione minima valida per il contatto in gradi decimali. Usato per elencare i contatti disponibili con un veicolo spaziale in una determinata stazione di terra.

properties.minimumViableContactDuration

string

Durata minima del contatto valida nel formato ISO 8601. Usato per elencare i contatti disponibili con un veicolo spaziale in una determinata stazione di terra.

properties.networkConfiguration

NetworkConfiguration

Configurazione di rete della rete virtuale del cliente.

properties.provisioningState

ContactProfilesProperties.ProvisioningState

Stato corrente della creazione, eliminazione o modifica della risorsa.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Configurazione della missione di terze parti del profilo di contatto. Descrive i collegamenti RF, l'elaborazione del modem e gli endpoint IP.

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createBy e modificateBy.

tags

object

Tag di risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

Collegamento del profilo di contatto.

Nome Tipo Descrizione
channels

ContactProfileLinkChannel[]

Canale di collegamento del profilo di contatto.

direction

direction

Direzione (Uplink o Downlink).

eirpdBW

number

Potenza EIRP (Isotropic Radiated Power) efficace in dBW. È l'EIRP richiesto dal cliente. Non ancora usato.

gainOverTemperature

number

Ottenere la temperatura del rumore in db/K. È il G/T richiesto dal cliente. Non usato ancora.

name

string

Nome collegamento.

polarization

polarization

Polarizzazione. ad esempio (RHCP, LHCP).

ContactProfileLinkChannel

Canale di collegamento del profilo di contatto.

Nome Tipo Descrizione
bandwidthMHz

number

Larghezza di banda in MHz.

centerFrequencyMHz

number

Frequenza centrale in MHz.

decodingConfiguration

string

Attualmente inutilizzato.

demodulationConfiguration

string

Copia del file di configurazione del modem, ad esempio Kratos QRadio o Kratos QuantumRx. Valido solo per le direzioni downlink. Se specificato, il modem si connette all'endpoint del cliente e invia dati demodulati anziché un flusso VITA.49.

encodingConfiguration

string

Attualmente inutilizzato.

endPoint

EndPoint

Punto finale del cliente per archiviare e recuperare i dati durante un contatto con il veicolo spaziale.

modulationConfiguration

string

Copia del file di configurazione del modem, ad esempio Kratos QRadio. Valido solo per le direzioni uplink. Se specificato, il modem si connette all'endpoint del cliente e accetta i comandi del cliente anziché un flusso VITA.49.

name

string

Nome del canale.

ContactProfilesProperties.ProvisioningState

Stato corrente della creazione, eliminazione o modifica della risorsa.

ContactProfileThirdPartyConfiguration

Contattare la configurazione del partner di terze parti.

Nome Tipo Descrizione
missionConfiguration

string

Nome della stringa che fa riferimento alla configurazione che descrive la configurazione del contatto per una determinata missione. I valori previsti sono quelli creati in collaborazione con la rete partner.

providerName

string

Nome del provider di terze parti.

createdByType

Tipo di identità che ha creato la risorsa.

Nome Tipo Descrizione
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Direzione (Uplink o Downlink).

Nome Tipo Descrizione
Downlink

string

Uplink

string

EndPoint

Punto finale del cliente per archiviare e recuperare i dati durante un contatto con il veicolo spaziale.

Nome Tipo Descrizione
endPointName

string

Nome di un punto finale.

ipAddress

string

Indirizzo IP (IPv4).

port

string

Porta TCP su cui rimanere in ascolto per ricevere i dati.

protocol

protocol

Protocollo UDP o TCP.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

NetworkConfiguration

Configurazione di rete della rete virtuale del cliente.

Nome Tipo Descrizione
subnetId

string

Identificatore della risorsa ARM della subnet delegata a Microsoft.Orbital/orbitalGateways. Deve essere almeno una subnet C di classe e non deve avere alcun indirizzo IP creato.

polarization

Polarizzazione. ad esempio (RHCP, LHCP).

Nome Tipo Descrizione
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

protocol

Protocollo UDP o TCP.

Nome Tipo Descrizione
TCP

string

UDP

string

ProvisioningState

Stato corrente della creazione, eliminazione o modifica della risorsa.

Spacecraft

Il cliente crea una risorsa spaziale per pianificare un contatto.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Posizione geografica in cui vive la risorsa

name

string

nome della risorsa.

properties.links

SpacecraftLink[]

Elenco non modificabile dei collegamenti del veicolo spaziale.

properties.noradId

string

NORAD ID del veicolo spaziale.

properties.provisioningState

ProvisioningState

Stato corrente della creazione, eliminazione o modifica della risorsa.

properties.titleLine

string

Riga titolo del set di elementi a due righe (TLE).

properties.tleLine1

string

Riga 1 del set di elementi a due righe (TLE).

properties.tleLine2

string

Riga 2 del set di elementi a due righe (TLE).

systemData

systemData

Metadati di Azure Resource Manager contenenti le informazioni createBy e modificateBy.

tags

object

Tag di risorse.

type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

Elenco dei collegamenti di veicoli spaziali autorizzati per stazione di terra e la data di scadenza dell'autorizzazione.

Nome Tipo Descrizione
authorizations

AuthorizedGroundstation[]

Stazioni di terra autorizzate

bandwidthMHz

number

Larghezza di banda in MHz.

centerFrequencyMHz

number

Frequenza centrale in MHz.

direction

direction

Direzione (Uplink o Downlink).

name

string

Nome del collegamento.

polarization

polarization

Polarizzazione. ad esempio (RHCP, LHCP).

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome Tipo Descrizione
createdAt

string

Timestamp della creazione di risorse (UTC).

createdBy

string

Identità che ha creato la risorsa.

createdByType

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt

string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy

string

Identità che ha modificato l'ultima risorsa.

lastModifiedByType

createdByType

Tipo di identità che ha modificato l'ultima risorsa.