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 |
---|---|---|---|---|
resource
|
path | True |
string |
Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole. |
spacecraft
|
path | True |
string |
ID veicolo spaziale. |
subscription
|
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 |
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 |
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 |
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 |
---|---|
Authorized |
Stazione di terra autorizzata. |
Auto |
Configurazione di rilevamento automatico. |
Available |
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. |
Available |
Risposta per la chiamata al servizio API ListAvailableContacts. |
Contact |
Parametri che definiscono la risorsa contatto. |
Contact |
Riferimento alla risorsa del profilo di contatto. |
Contact |
Il cliente crea una risorsa del profilo di contatto, che conterrà tutte le configurazioni necessarie per la pianificazione di un contatto. |
Contact |
Collegamento del profilo di contatto. |
Contact |
Canale di collegamento del profilo di contatto. |
Contact |
Stato corrente della creazione, eliminazione o modifica della risorsa. |
Contact |
Contattare la configurazione del partner di terze parti. |
created |
Tipo di identità che ha creato la risorsa. |
direction |
Direzione (Uplink o Downlink). |
End |
Punto finale del cliente per archiviare e recuperare i dati durante un contatto con il veicolo spaziale. |
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Network |
Configurazione di rete della rete virtuale del cliente. |
polarization |
Polarizzazione. ad esempio (RHCP, LHCP). |
protocol |
Protocollo UDP o TCP. |
Provisioning |
Stato corrente della creazione, eliminazione o modifica della risorsa. |
Spacecraft |
Il cliente crea una risorsa spaziale per pianificare un contatto. |
Spacecraft |
Elenco dei collegamenti di veicoli spaziali autorizzati per stazione di terra e la data di scadenza dell'autorizzazione. |
system |
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 |
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 |
Elenco dei contatti disponibili. |
ContactParameters
Parametri che definiscono la risorsa contatto.
Nome | Tipo | Descrizione |
---|---|---|
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 |
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 |
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 |
Configurazione di rete della rete virtuale del cliente. |
|
properties.provisioningState |
Stato corrente della creazione, eliminazione o modifica della risorsa. |
|
properties.thirdPartyConfigurations |
Configurazione della missione di terze parti del profilo di contatto. Descrive i collegamenti RF, l'elaborazione del modem e gli endpoint IP. |
|
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" |
ContactProfileLink
Collegamento del profilo di contatto.
Nome | Tipo | Descrizione |
---|---|---|
channels |
Canale di collegamento del profilo di contatto. |
|
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 |
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 |
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 |
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 |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
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 |
Elenco non modificabile dei collegamenti del veicolo spaziale. |
|
properties.noradId |
string |
NORAD ID del veicolo spaziale. |
properties.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 |
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" |
SpacecraftLink
Elenco dei collegamenti di veicoli spaziali autorizzati per stazione di terra e la data di scadenza dell'autorizzazione.
Nome | Tipo | Descrizione |
---|---|---|
authorizations |
Stazioni di terra autorizzate |
|
bandwidthMHz |
number |
Larghezza di banda in MHz. |
centerFrequencyMHz |
number |
Frequenza centrale in MHz. |
direction |
Direzione (Uplink o Downlink). |
|
name |
string |
Nome del collegamento. |
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 |
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 |
Tipo di identità che ha modificato l'ultima risorsa. |