Contacts - Create
Crea un contatto.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/contacts/{contactName}?api-version=2022-11-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
contact
|
path | True |
string |
Nome contatto. |
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 |
---|---|---|---|
properties.contactProfile | True |
Riferimento alla risorsa del profilo di contatto. |
|
properties.groundStationName | True |
string |
Nome della stazione di terra di Azure. |
properties.reservationEndTime | True |
string |
Ora di fine prenotazione di un contatto (standard ISO 8601 UTC). |
properties.reservationStartTime | True |
string |
Ora di inizio prenotazione di un contatto (standard ISO 8601 UTC). |
properties.provisioningState |
Stato corrente della creazione, eliminazione o modifica della risorsa. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
OK. |
|
201 Created |
Creazione riuscita. L'operazione restituisce la risorsa contatto risultante. Headers Azure-AsyncOperation: string |
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Esempio
Create a contact
Sample Request
PUT https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/contacts/contact1?api-version=2022-11-01
{
"properties": {
"reservationStartTime": "2023-02-22T10:58:30Z",
"reservationEndTime": "2023-02-22T11:10:45Z",
"groundStationName": "EASTUS2_0",
"contactProfile": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
}
}
}
Sample Response
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/contacts/contact1",
"name": "contact1",
"type": "Microsoft.Orbital/spacecrafts/contacts",
"properties": {
"status": "scheduled",
"reservationStartTime": "2023-02-22T10:58:30Z",
"reservationEndTime": "2023-02-22T11:10:45Z",
"errorMessage": null,
"groundStationName": "EASTUS2_0",
"contactProfile": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
},
"antennaConfiguration": null,
"maximumElevationDegrees": 85.9796,
"txStartTime": "2023-02-22T10:58:30Z",
"txEndTime": "2023-02-22T11:10:45Z",
"rxStartTime": "2023-02-22T10:58:30Z",
"rxEndTime": "2023-02-22T11:10:45Z",
"startAzimuthDegrees": 165.758896,
"endAzimuthDegrees": 345.848482,
"startElevationDegrees": 5,
"endElevationDegrees": 5.048656
}
}
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/contacts/contact1",
"name": "contact1",
"type": "Microsoft.Orbital/spacecrafts/contacts",
"properties": {
"status": "scheduled",
"reservationStartTime": "2023-02-22T10:58:30Z",
"reservationEndTime": "2023-02-22T11:10:45Z",
"errorMessage": null,
"groundStationName": "EASTUS2_0",
"contactProfile": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
},
"antennaConfiguration": null,
"maximumElevationDegrees": 0,
"txStartTime": null,
"txEndTime": null,
"rxStartTime": null,
"rxEndTime": null,
"startAzimuthDegrees": 0,
"endAzimuthDegrees": 0,
"startElevationDegrees": 0,
"endElevationDegrees": 0
}
}
Definizioni
Nome | Descrizione |
---|---|
Antenna |
Configurazione associata all'antenna allocata. |
Contact |
Il cliente crea una risorsa di contatto per una risorsa spaziale spaziale. |
Contact |
Riferimento alla risorsa del profilo di contatto. |
Contacts |
Stato di un contatto. |
created |
Tipo di identità che ha creato la risorsa. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Provisioning |
Stato corrente della creazione, eliminazione o modifica della risorsa. |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
AntennaConfiguration
Configurazione associata all'antenna allocata.
Nome | Tipo | Descrizione |
---|---|---|
destinationIp |
string |
L'INDIRIZZO IP di destinazione a cui è possibile inviare un pacchetto. Ad esempio, si tratta dell'endpoint TCP a cui inviare i dati. |
sourceIps |
string[] |
Elenco dell'indirizzo IP di origine |
Contact
Il cliente crea una risorsa di contatto per una risorsa spaziale spaziale.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
nome della risorsa. |
properties.antennaConfiguration |
Configurazione associata all'antenna allocata. |
|
properties.contactProfile |
Riferimento alla risorsa del profilo di contatto. |
|
properties.endAzimuthDegrees |
number |
Azimuth dell'antenna alla fine del contatto in gradi decimali. |
properties.endElevationDegrees |
number |
Elevazione del veicolo spaziale al di sopra dell'orizzonte alla fine del contatto. |
properties.errorMessage |
string |
Qualsiasi messaggio di errore durante la pianificazione di un contatto. |
properties.groundStationName |
string |
Nome della stazione di terra di Azure. |
properties.maximumElevationDegrees |
number |
Elevazione massima dell'antenna durante il contatto in gradi decimali. |
properties.provisioningState |
Stato corrente della creazione, eliminazione o modifica della risorsa. |
|
properties.reservationEndTime |
string |
Ora di fine prenotazione di un contatto (standard ISO 8601 UTC). |
properties.reservationStartTime |
string |
Ora di inizio prenotazione di un contatto (standard ISO 8601 UTC). |
properties.rxEndTime |
string |
Ora di fine di un contatto (standard ISO 8601 UTC). |
properties.rxStartTime |
string |
Ricezione dell'ora di inizio di un contatto (standard ISO 8601 UTC). |
properties.startAzimuthDegrees |
number |
Azimuth dell'antenna all'inizio del contatto in gradi decimali. |
properties.startElevationDegrees |
number |
Elevazione spaziale al di sopra dell'orizzonte all'inizio del contatto. |
properties.status |
Stato di un contatto. |
|
properties.txEndTime |
string |
Trasmettere l'ora di fine di un contatto (standard ISO 8601 UTC). |
properties.txStartTime |
string |
Trasmettere l'ora di inizio di un contatto (standard ISO 8601 UTC). |
systemData |
Azure Resource Manager metadati contenenti le informazioni createdBy e modifiedBy. |
|
type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
ContactProfile
Riferimento alla risorsa del profilo di contatto.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa. |
ContactsStatus
Stato di un contatto.
Nome | Tipo | Descrizione |
---|---|---|
cancelled |
string |
|
failed |
string |
|
providerCancelled |
string |
|
scheduled |
string |
|
succeeded |
string |
createdByType
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di 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. |
ProvisioningState
Stato corrente della creazione, eliminazione o modifica della risorsa.
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 volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |