Contacts - Create
Létrehoz egy névjegyet.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/contacts/{contactName}?api-version=2022-11-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
contact
|
path | True |
string |
Partner neve. |
resource
|
path | True |
string |
Az erőforráscsoport neve. A név megkülönbözteti a kis- és nagybetűket. |
spacecraft
|
path | True |
string |
Űrhajó azonosítója. |
subscription
|
path | True |
string |
A cél-előfizetés azonosítója. |
api-version
|
query | True |
string |
A művelethez használandó API-verzió. |
Kérelem törzse
Name | Kötelező | Típus | Description |
---|---|---|---|
properties.contactProfile | True |
A partnerprofil-erőforrásra mutató hivatkozás. |
|
properties.groundStationName | True |
string |
Az Azure Ground Station neve. |
properties.reservationEndTime | True |
string |
Partner foglalásának befejezési időpontja (ISO 8601 UTC szabvány). |
properties.reservationStartTime | True |
string |
Partner foglalási kezdési időpontja (ISO 8601 UTC szabvány). |
properties.provisioningState |
Az erőforrás létrehozásának, törlésének vagy módosításának aktuális állapota. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK gombra. |
|
201 Created |
Sikeres létrehozás. A művelet az eredményül kapott kapcsolati erőforrást adja vissza. Headers Azure-AsyncOperation: string |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Példák
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
}
}
Definíciók
Name | Description |
---|---|
Antenna |
A lefoglalt antennához társított konfiguráció. |
Contact |
Az ügyfél létrehoz egy kapcsolati erőforrást egy űrhajó-erőforráshoz. |
Contact |
A partnerprofil-erőforrásra mutató hivatkozás. |
Contacts |
Partner állapota. |
created |
Az erőforrást létrehozó identitás típusa. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
Provisioning |
Az erőforrás létrehozásának, törlésének vagy módosításának aktuális állapota. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
AntennaConfiguration
A lefoglalt antennához társított konfiguráció.
Name | Típus | Description |
---|---|---|
destinationIp |
string |
A csomag cél IP-címe. Ez lehet például az a TCP-végpont, amelyre adatokat küldene. |
sourceIps |
string[] |
Forrás IP-címének listája |
Contact
Az ügyfél létrehoz egy kapcsolati erőforrást egy űrhajó-erőforráshoz.
Name | Típus | Description |
---|---|---|
id |
string |
Az erőforrás teljes erőforrás-azonosítója. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Az erőforrás neve |
properties.antennaConfiguration |
A lefoglalt antennához társított konfiguráció. |
|
properties.contactProfile |
A partnerprofil-erőforrásra mutató hivatkozás. |
|
properties.endAzimuthDegrees |
number |
Az antenna azimuth értéke a kapcsolat végén decimális fokban. |
properties.endElevationDegrees |
number |
Az űrhajó a horizont felett emelkedik a kapcsolat végén. |
properties.errorMessage |
string |
Névjegy ütemezése közben megjelenő hibaüzenetek. |
properties.groundStationName |
string |
Az Azure Ground Station neve. |
properties.maximumElevationDegrees |
number |
Az antenna maximális emelkedése a kapcsolat során decimális fokban. |
properties.provisioningState |
Az erőforrás létrehozásának, törlésének vagy módosításának aktuális állapota. |
|
properties.reservationEndTime |
string |
Partner foglalásának befejezési időpontja (ISO 8601 UTC szabvány). |
properties.reservationStartTime |
string |
Partner foglalási kezdési időpontja (ISO 8601 UTC szabvány). |
properties.rxEndTime |
string |
Egy partner befejezési időpontjának fogadása (ISO 8601 UTC szabvány). |
properties.rxStartTime |
string |
Partner kezdési időpontjának fogadása (ISO 8601 UTC szabvány). |
properties.startAzimuthDegrees |
number |
Az antenna az azimuth értéke a kapcsolat kezdetekor decimális fokban. |
properties.startElevationDegrees |
number |
Az űrhajó a horizont felett emelkedik a kapcsolat kezdetekor. |
properties.status |
Partner állapota. |
|
properties.txEndTime |
string |
Egy partner befejezési időpontjának továbbítása (ISO 8601 UTC szabvány). |
properties.txStartTime |
string |
Kapcsolattartó kezdési időpontjának továbbítása (ISO 8601 UTC szabvány). |
systemData |
Az Azure Resource Manager createdBy és modifiedBy adatokat tartalmazó metaadatok. |
|
type |
string |
Az erőforrás típusa. Például "Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts" |
ContactProfile
A partnerprofil-erőforrásra mutató hivatkozás.
Name | Típus | Description |
---|---|---|
id |
string |
Erőforrás-azonosító. |
ContactsStatus
Partner állapota.
Name | Típus | Description |
---|---|---|
cancelled |
string |
|
failed |
string |
|
providerCancelled |
string |
|
scheduled |
string |
|
succeeded |
string |
createdByType
Az erőforrást létrehozó identitás típusa.
Name | Típus | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Az erőforrás-kezelési hiba további információi.
Name | Típus | Description |
---|---|---|
info |
object |
A további információk. |
type |
string |
A további információtípus. |
ErrorDetail
A hiba részletei.
Name | Típus | Description |
---|---|---|
additionalInfo |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hibacél. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
A hibaobjektum. |
ProvisioningState
Az erőforrás létrehozásának, törlésének vagy módosításának aktuális állapota.
systemData
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.
Name | Típus | Description |
---|---|---|
createdAt |
string |
Az erőforrás-létrehozás időbélyege (UTC). |
createdBy |
string |
Az erőforrást létrehozó identitás. |
createdByType |
Az erőforrást létrehozó identitás típusa. |
|
lastModifiedAt |
string |
Az erőforrás utolsó módosításának időbélyege (UTC) |
lastModifiedBy |
string |
Az az identitás, amely legutóbb módosította az erőforrást. |
lastModifiedByType |
Az erőforrást legutóbb módosító identitás típusa. |