Contacts - Create
Tworzy kontakt.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/contacts/{contactName}?api-version=2022-11-01
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
contact
|
path | True |
string |
Nazwa kontaktu. |
resource
|
path | True |
string |
Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter. |
spacecraft
|
path | True |
string |
Identyfikator statku kosmicznego. |
subscription
|
path | True |
string |
Identyfikator subskrypcji docelowej. |
api-version
|
query | True |
string |
Wersja interfejsu API do użycia dla tej operacji. |
Treść żądania
Nazwa | Wymagane | Typ | Opis |
---|---|---|---|
properties.contactProfile | True |
Odwołanie do zasobu profilu kontaktu. |
|
properties.groundStationName | True |
string |
Nazwa stacji naziemnej platformy Azure. |
properties.reservationEndTime | True |
string |
Godzina zakończenia rezerwacji kontaktu (standard ISO 8601 UTC). |
properties.reservationStartTime | True |
string |
Czas rozpoczęcia rezerwacji kontaktu (standard ISO 8601 UTC). |
properties.provisioningState |
Bieżący stan tworzenia, usuwania lub modyfikacji zasobu. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
OK. |
|
201 Created |
Tworzenie powiodło się. Operacja zwraca wynikowy zasób kontaktu. Headers Azure-AsyncOperation: string |
|
Other Status Codes |
Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się. |
Przykłady
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
}
}
Definicje
Nazwa | Opis |
---|---|
Antenna |
Konfiguracja skojarzona z przydzieloną anteną. |
Contact |
Klient tworzy zasób kontaktowy dla zasobu statku kosmicznego. |
Contact |
Odwołanie do zasobu profilu kontaktu. |
Contacts |
Stan kontaktu. |
created |
Typ tożsamości, która utworzyła zasób. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
Provisioning |
Bieżący stan tworzenia, usuwania lub modyfikacji zasobu. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
AntennaConfiguration
Konfiguracja skojarzona z przydzieloną anteną.
Nazwa | Typ | Opis |
---|---|---|
destinationIp |
string |
Docelowy adres IP, do którego można wysłać pakiet. Może to być na przykład punkt końcowy TCP, do którego będą wysyłane dane. |
sourceIps |
string[] |
Lista źródłowego adresu IP |
Contact
Klient tworzy zasób kontaktowy dla zasobu statku kosmicznego.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
name |
string |
Nazwa zasobu |
properties.antennaConfiguration |
Konfiguracja skojarzona z przydzieloną anteną. |
|
properties.contactProfile |
Odwołanie do zasobu profilu kontaktu. |
|
properties.endAzimuthDegrees |
number |
Azymut anteny na końcu kontaktu w stopniach dziesiętnych. |
properties.endElevationDegrees |
number |
Statek kosmiczny podniesie się nad horyzontem na końcu kontaktu. |
properties.errorMessage |
string |
Każdy komunikat o błędzie podczas planowania kontaktu. |
properties.groundStationName |
string |
Nazwa stacji naziemnej platformy Azure. |
properties.maximumElevationDegrees |
number |
Maksymalna wysokość anteny podczas kontaktu w stopniach dziesiętnych. |
properties.provisioningState |
Bieżący stan tworzenia, usuwania lub modyfikacji zasobu. |
|
properties.reservationEndTime |
string |
Godzina zakończenia rezerwacji kontaktu (standard ISO 8601 UTC). |
properties.reservationStartTime |
string |
Czas rozpoczęcia rezerwacji kontaktu (standard ISO 8601 UTC). |
properties.rxEndTime |
string |
Czas zakończenia kontaktu (standard ISO 8601 UTC). |
properties.rxStartTime |
string |
Czas rozpoczęcia kontaktu (standard ISO 8601 UTC). |
properties.startAzimuthDegrees |
number |
Azymut anteny na początku kontaktu w stopniach dziesiętnych. |
properties.startElevationDegrees |
number |
Statek kosmiczny podniesie się nad horyzontem na początku kontaktu. |
properties.status |
Stan kontaktu. |
|
properties.txEndTime |
string |
Przesyłaj czas zakończenia kontaktu (standard ISO 8601 UTC). |
properties.txStartTime |
string |
Przesyłaj czas rozpoczęcia kontaktu (standard ISO 8601 UTC). |
systemData |
Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy. |
|
type |
string |
Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts" |
ContactProfile
Odwołanie do zasobu profilu kontaktu.
Nazwa | Typ | Opis |
---|---|---|
id |
string |
Identyfikator zasobu. |
ContactsStatus
Stan kontaktu.
Nazwa | Typ | Opis |
---|---|---|
cancelled |
string |
|
failed |
string |
|
providerCancelled |
string |
|
scheduled |
string |
|
succeeded |
string |
createdByType
Typ tożsamości, która utworzyła zasób.
Nazwa | Typ | Opis |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
Dodatkowe informacje o błędzie zarządzania zasobami.
Nazwa | Typ | Opis |
---|---|---|
info |
object |
Dodatkowe informacje. |
type |
string |
Dodatkowy typ informacji. |
ErrorDetail
Szczegóły błędu.
Nazwa | Typ | Opis |
---|---|---|
additionalInfo |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
Szczegóły błędu. |
|
message |
string |
Komunikat o błędzie. |
target |
string |
Element docelowy błędu. |
ErrorResponse
Odpowiedź na błąd
Nazwa | Typ | Opis |
---|---|---|
error |
Obiekt error. |
ProvisioningState
Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.
systemData
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
Nazwa | Typ | Opis |
---|---|---|
createdAt |
string |
Sygnatura czasowa tworzenia zasobów (UTC). |
createdBy |
string |
Tożsamość, która utworzyła zasób. |
createdByType |
Typ tożsamości, która utworzyła zasób. |
|
lastModifiedAt |
string |
Sygnatura czasowa ostatniej modyfikacji zasobu (UTC) |
lastModifiedBy |
string |
Tożsamość, która ostatnio zmodyfikowała zasób. |
lastModifiedByType |
Typ tożsamości, która ostatnio zmodyfikowała zasób. |