Spacecrafts - Create Or Update
Crea o aggiorna una risorsa spaziale.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}?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 |
---|---|---|---|
location | True |
string |
Posizione geografica in cui vive la risorsa |
properties.links | True |
Elenco non modificabile dei collegamenti del veicolo spaziale. |
|
properties.titleLine | True |
string |
Riga titolo del set di elementi a due righe (TLE). |
properties.tleLine1 | True |
string |
Riga 1 del set di elementi a due righe (TLE). |
properties.tleLine2 | True |
string |
Riga 2 del set di elementi a due righe (TLE). |
properties.noradId |
string |
NORAD ID del veicolo spaziale. |
|
properties.provisioningState |
Stato corrente della creazione, eliminazione o modifica della risorsa. |
||
tags |
object |
Tag di risorse. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Aggiornamento riuscito. L'operazione restituisce la risorsa del veicolo spaziale risultante. |
|
201 Created |
Creare correttamente. L'operazione restituisce la risorsa del veicolo spaziale risultante. Intestazioni Azure-AsyncOperation: string |
|
Other Status Codes |
Risposta di errore che descrive perché l'operazione non è riuscita. |
Esempio
Create a spacecraft
Esempio di richiesta
PUT https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT?api-version=2022-11-01
{
"location": "eastus2",
"properties": {
"noradId": "36411",
"titleLine": "CONTOSO_SAT",
"tleLine1": "1 27424U 02022A 22167.05119303 .00000638 00000+0 15103-3 0 9994",
"tleLine2": "2 27424 98.2477 108.9546 0000928 92.9194 327.0802 14.57300770 69982",
"links": [
{
"name": "uplink_lhcp1",
"centerFrequencyMHz": 2250,
"bandwidthMHz": 2,
"direction": "Uplink",
"polarization": "LHCP"
},
{
"name": "downlink_rhcp1",
"centerFrequencyMHz": 8160,
"bandwidthMHz": 15,
"direction": "Downlink",
"polarization": "RHCP"
}
]
}
}
Risposta di esempio
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"location": "eastus2",
"tags": null,
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT",
"name": "CONTOSO_SAT",
"type": "Microsoft.Orbital/spacecrafts",
"properties": {
"provisioningState": "updating",
"noradId": "36411",
"titleLine": "CONTOSO_SAT",
"tleLine1": "1 27424U 02022A 22167.05119303 .00000638 00000+0 15103-3 0 9994",
"tleLine2": "2 27424 98.2477 108.9546 0000928 92.9194 327.0802 14.57300770 69982",
"links": [
{
"name": "uplink_lhcp1",
"centerFrequencyMHz": 2250,
"bandwidthMHz": 2,
"direction": "Uplink",
"polarization": "LHCP",
"authorizations": [
{
"groundStation": "EASTUS2_0",
"expirationDate": "2023-06-02"
}
]
},
{
"name": "downlink_rhcp1",
"centerFrequencyMHz": 8160,
"bandwidthMHz": 15,
"direction": "Downlink",
"polarization": "RHCP",
"authorizations": [
{
"groundStation": "EASTUS2_0",
"expirationDate": "2023-06-02"
}
]
}
]
}
}
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"location": "eastus2",
"tags": null,
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT",
"name": "CONTOSO_SAT",
"type": "Microsoft.Orbital/spacecrafts",
"properties": {
"provisioningState": "creating",
"noradId": "36411",
"titleLine": "CONTOSO_SAT",
"tleLine1": "1 27424U 02022A 22167.05119303 .00000638 00000+0 15103-3 0 9994",
"tleLine2": "2 27424 98.2477 108.9546 0000928 92.9194 327.0802 14.57300770 69982",
"links": [
{
"name": "uplink_lhcp1",
"centerFrequencyMHz": 2250,
"bandwidthMHz": 2,
"direction": "Uplink",
"polarization": "LHCP",
"authorizations": [
{
"groundStation": "EASTUS2_0",
"expirationDate": "2023-06-02"
}
]
},
{
"name": "downlink_rhcp1",
"centerFrequencyMHz": 8160,
"bandwidthMHz": 15,
"direction": "Downlink",
"polarization": "RHCP",
"authorizations": [
{
"groundStation": "EASTUS2_0",
"expirationDate": "2023-06-02"
}
]
}
]
}
}
Definizioni
Nome | Descrizione |
---|---|
Authorized |
Stazione di terra autorizzata. |
created |
Tipo di identità che ha creato la risorsa. |
direction |
Direzione (Uplink o Downlink). |
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
polarization |
Polarizzazione. ad esempio (RHCP, LHCP). |
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. |
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 |
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. |
polarization
Polarizzazione. ad esempio (RHCP, LHCP).
Nome | Tipo | Descrizione |
---|---|---|
LHCP |
string |
|
RHCP |
string |
|
linearHorizontal |
string |
|
linearVertical |
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 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. |