Spacecrafts - Create Or Update

  • Reference
Service:
Orbital
API Version:
2022-11-01

Vytvoří nebo aktualizuje prostředek kosmické lodi.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
 path True

string

Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.
spacecraftName
 path True

string

ID kosmické lodi.
subscriptionId
 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
location True

string

Geografické umístění, kde se prostředek nachází
properties.links True

SpacecraftLink[]

Neměnný seznam odkazů kosmické lodi.
properties.titleLine True

string

Řádek nadpisu dvouřádkové sady prvků (TLE).
properties.tleLine1 True

string

Řádek 1 sady dvouřádkových prvků (TLE).
properties.tleLine2 True

string

Řádek 2 sady dvouřádkových prvků (TLE).
properties.noradId

string

NORAD ID kosmické lodi.
properties.provisioningState

ProvisioningState

Aktuální stav vytvoření, odstranění nebo úpravy prostředku.
tags

object

Značky prostředků.

Odpovědi

Name Typ Description
200 OK

Spacecraft

Aktualizace proběhla úspěšně. Operace vrátí výsledný prostředek kosmické lodi.
201 Created

Spacecraft

Vytvoření proběhlo úspěšně. Operace vrátí výsledný prostředek kosmické lodi.

Headers

Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Chybová odpověď popisující, proč operace selhala.

Příklady

Create a spacecraft

Sample Request

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

Sample Response

Status code:
200 
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
Response Body
{
  "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"
          }
        ]
      }
    ]
  }
}
Status code:
201 
Azure-AsyncOperation: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
Response Body
{
  "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"
          }
        ]
      }
    ]
  }
}

Definice

Name Description
AuthorizedGroundstation

Autorizovaná podzemní stanice.
createdByType

Typ identity, která prostředek vytvořila.
direction

Směr (odchozí nebo downlink).
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorDetail

Podrobnosti o chybě
ErrorResponse

Chybová odpověď
polarization

Polarizace. např. (RHCP, LHCP).
ProvisioningState

Aktuální stav vytvoření, odstranění nebo úpravy prostředku.
Spacecraft

Zákazník vytvoří prostředek kosmické lodi pro naplánování kontaktu.
SpacecraftLink

Seznam autorizovaných spojení kosmické lodi na pozemní stanici a datum vypršení platnosti povolení.
systemData

Metadata týkající se vytvoření a poslední změny prostředku.

AuthorizedGroundstation

Autorizovaná podzemní stanice.

Name Typ Description
expirationDate

string

Datum vypršení platnosti autorizace
groundStation

string

Název budovy budovy.

createdByType

Typ identity, která prostředek vytvořila.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Směr (odchozí nebo downlink).

Name Typ Description
Downlink

string

Uplink

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

ErrorAdditionalInfo[]

Další informace o chybě.
code

string

Kód chyby
details

ErrorDetail[]

Podrobnosti o chybě.
message

string

Chybová zpráva
target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

polarization

Polarizace. např. (RHCP, LHCP).

Name Typ Description
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

ProvisioningState

Aktuální stav vytvoření, odstranění nebo úpravy prostředku.

Spacecraft

Zákazník vytvoří prostředek kosmické lodi pro naplánování kontaktu.

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}
location

string

Geografické umístění, kde se prostředek nachází
name

string

Název prostředku
properties.links

SpacecraftLink[]

Neměnný seznam odkazů kosmické lodi.
properties.noradId

string

NORAD ID kosmické lodi.
properties.provisioningState

ProvisioningState

Aktuální stav vytvoření, odstranění nebo úpravy prostředku.
properties.titleLine

string

Řádek nadpisu dvouřádkové sady prvků (TLE).
properties.tleLine1

string

Řádek 1 sady dvouřádkových prvků (TLE).
properties.tleLine2

string

Řádek 2 sady dvouřádkových prvků (TLE).
systemData

systemData

Azure Resource Manager metadata obsahující informace createdBy a modifiedBy.
tags

object

Značky prostředků.
type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

Seznam autorizovaných spojení kosmické lodi na pozemní stanici a datum vypršení platnosti povolení.

Name Typ Description
authorizations

AuthorizedGroundstation[]

Autorizované pozemní stanice
bandwidthMHz

number

Šířka pásma v MHz.
centerFrequencyMHz

number

Středová frekvence v MHz.
direction

direction

Směr (odchozí nebo downlink).
name

string

Název odkazu.
polarization

polarization

Polarizace. např. (RHCP, LHCP).

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

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

createdByType

Typ identity, která naposledy změnila prostředek.