Udostępnij za pośrednictwem

Spacecrafts - Create Or Update

  • Odwołanie
Usługa:
Orbital
Wersja interfejsu API:
2022-11-01

Tworzy lub aktualizuje zasób statku kosmicznego.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}?api-version=2022-11-01

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
resourceGroupName
 path True

string

Nazwa grupy zasobów. W nazwie jest uwzględniana wielkość liter.
spacecraftName
 path True

string

Identyfikator statku kosmicznego.
subscriptionId
 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
location True

string

Lokalizacja geograficzna, w której znajduje się zasób
properties.links True

SpacecraftLink[]

Niezmienna lista łączy statków kosmicznych.
properties.titleLine True

string

Wiersz tytułu zestawu elementów dwuwierszowych (TLE).
properties.tleLine1 True

string

Linia 1 zestawu elementów dwuwierszowych (TLE).
properties.tleLine2 True

string

Linia 2 zestawu elementów dwuwierszowych (TLE).
properties.noradId

string

NORAD ID statku kosmicznego.
properties.provisioningState

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.
tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

Spacecraft

Aktualizacja zakończyła się pomyślnie. Operacja zwraca wynikowy zasób statku kosmicznego.
201 Created

Spacecraft

Tworzenie zakończyło się pomyślnie. Operacja zwraca wynikowy zasób statku kosmicznego.

Nagłówki

Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Przykłady

Create a spacecraft

Przykładowe żądanie

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"
      }
    ]
  }
}

Przykładowa odpowiedź

Kod stanu:
200 
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"
          }
        ]
      }
    ]
  }
}
Kod stanu:
201 
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"
          }
        ]
      }
    ]
  }
}

Definicje

Nazwa Opis
AuthorizedGroundstation

Autoryzowane naziemne.
createdByType

Typ tożsamości, która utworzyła zasób.
direction

Kierunek (łącze w górę lub w dół).
ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail

Szczegóły błędu.
ErrorResponse

Odpowiedź na błąd
polarization

Polaryzacji. np. (RHCP, LHCP).
ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.
Spacecraft

Klient tworzy zasób statku kosmicznego, aby zaplanować kontakt.
SpacecraftLink

Lista autoryzowanych łączy statków kosmicznych na stację naziemną i datę wygaśnięcia autoryzacji.
systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AuthorizedGroundstation

Autoryzowane naziemne.

Nazwa Typ Opis
expirationDate

string

Data wygaśnięcia autoryzacji.
groundStation

string

Nazwa stacji naziemnej.

createdByType

Typ tożsamości, która utworzyła zasób.

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Kierunek (łącze w górę lub w dół).

Nazwa Typ Opis
Downlink

string

Uplink

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

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.
code

string

Kod błędu.
details

ErrorDetail[]

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

ErrorDetail

Obiekt błędu.

polarization

Polaryzacji. np. (RHCP, LHCP).

Nazwa Typ Opis
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

Spacecraft

Klient tworzy zasób statku kosmicznego, aby zaplanować kontakt.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex — /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Lokalizacja geograficzna, w której znajduje się zasób
name

string

Nazwa zasobu
properties.links

SpacecraftLink[]

Niezmienna lista łączy statków kosmicznych.
properties.noradId

string

NORAD ID statku kosmicznego.
properties.provisioningState

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.
properties.titleLine

string

Wiersz tytułu zestawu elementów dwuwierszowych (TLE).
properties.tleLine1

string

Linia 1 zestawu elementów dwuwierszowych (TLE).
properties.tleLine2

string

Linia 2 zestawu elementów dwuwierszowych (TLE).
systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.
tags

object

Tagi zasobów.
type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

Lista autoryzowanych łączy statków kosmicznych na stację naziemną i datę wygaśnięcia autoryzacji.

Nazwa Typ Opis
authorizations

AuthorizedGroundstation[]

Autoryzowane stacje naziemne
bandwidthMHz

number

Przepustowość w MHz.
centerFrequencyMHz

number

Częstotliwość środkowa w MHz.
direction

direction

Kierunek (łącze w górę lub w dół).
name

string

Nazwa łącza.
polarization

polarization

Polaryzacji. np. (RHCP, LHCP).

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobu (UTC).
createdBy

string

Tożsamość, która utworzyła zasób.
createdByType

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

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.