Contacts - Create
Vytvoří kontakt.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/contacts/{contactName}?api-version=2022-11-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
contact
|
path | True |
string |
Jméno kontaktu. |
resource
|
path | True |
string |
Název skupiny prostředků. V názvu se rozlišují malá a velká písmena. |
spacecraft
|
path | True |
string |
ID kosmické lodi. |
subscription
|
path | True |
string |
ID cílového předplatného. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
properties.contactProfile | True |
Odkaz na prostředek profilu kontaktu. |
|
properties.groundStationName | True |
string |
Název stanice Azure Ground Station. |
properties.reservationEndTime | True |
string |
Čas ukončení rezervace kontaktu (standard ISO 8601 UTC). |
properties.reservationStartTime | True |
string |
Počáteční čas rezervace kontaktu (standard ISO 8601 UTC). |
properties.provisioningState |
Aktuální stav vytvoření, odstranění nebo úpravy prostředku. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
OK. |
|
201 Created |
Vytvoření proběhlo úspěšně. Operace vrátí výsledný prostředek kontaktu. Headers Azure-AsyncOperation: string |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Příklady
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
}
}
Definice
Name | Description |
---|---|
Antenna |
Konfigurace přidružená k přidělené anténě. |
Contact |
Zákazník vytvoří prostředek kontaktu pro prostředek kosmické lodi. |
Contact |
Odkaz na prostředek profilu kontaktu. |
Contacts |
Stav kontaktu. |
created |
Typ identity, která prostředek vytvořila. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Provisioning |
Aktuální stav vytvoření, odstranění nebo úpravy prostředku. |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
AntennaConfiguration
Konfigurace přidružená k přidělené anténě.
Name | Typ | Description |
---|---|---|
destinationIp |
string |
Cílová IP adresa, do které se paket může odeslat. Jedná se například o koncový bod TCP, do který byste odesílali data. |
sourceIps |
string[] |
Seznam zdrojových IP adres |
Contact
Zákazník vytvoří prostředek kontaktu pro prostředek kosmické lodi.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku} |
name |
string |
Název prostředku |
properties.antennaConfiguration |
Konfigurace přidružená k přidělené anténě. |
|
properties.contactProfile |
Odkaz na prostředek profilu kontaktu. |
|
properties.endAzimuthDegrees |
number |
Azimut antény na konci kontaktu v desetinných stupních. |
properties.endElevationDegrees |
number |
Výška kosmické lodi nad horizontem na kontaktním konci. |
properties.errorMessage |
string |
Jakákoli chybová zpráva při plánování kontaktu |
properties.groundStationName |
string |
Název stanice Azure Ground Station. |
properties.maximumElevationDegrees |
number |
Maximální výška antény během kontaktu v desetinných stupních. |
properties.provisioningState |
Aktuální stav vytvoření, odstranění nebo úpravy prostředku. |
|
properties.reservationEndTime |
string |
Čas ukončení rezervace kontaktu (standard ISO 8601 UTC). |
properties.reservationStartTime |
string |
Počáteční čas rezervace kontaktu (standard ISO 8601 UTC). |
properties.rxEndTime |
string |
Čas ukončení kontaktu (standard ISO 8601 UTC). |
properties.rxStartTime |
string |
Čas zahájení příjmu kontaktu (standard ISO 8601 UTC). |
properties.startAzimuthDegrees |
number |
Azimut antény na začátku kontaktu v desetinných stupních. |
properties.startElevationDegrees |
number |
Výška kosmické lodi nad horizontem při kontaktním startu. |
properties.status |
Stav kontaktu. |
|
properties.txEndTime |
string |
Koncový čas přenosu kontaktu (standard ISO 8601 UTC). |
properties.txStartTime |
string |
Počáteční čas přenosu kontaktu (standard ISO 8601 UTC). |
systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
|
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
ContactProfile
Odkaz na prostředek profilu kontaktu.
Name | Typ | Description |
---|---|---|
id |
string |
ID prostředku. |
ContactsStatus
Stav kontaktu.
Name | Typ | Description |
---|---|---|
cancelled |
string |
|
failed |
string |
|
providerCancelled |
string |
|
scheduled |
string |
|
succeeded |
string |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
ProvisioningState
Aktuální stav vytvoření, odstranění nebo úpravy prostředku.
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která vytvořila prostředek. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Časové razítko poslední změny prostředku (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |