Partilhar via

Spacecrafts - Create Or Update

  • Referência
Serviço:
Orbital
Versão da API:
2022-11-01

Cria ou atualiza um recurso de nave espacial.

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

Parâmetros do URI

Name Em Necessário Tipo Description
resourceGroupName
 path True

string

O nome do grupo de recursos. O nome não é sensível a maiúsculas e minúsculas.
spacecraftName
 path True

string

ID da nave espacial.
subscriptionId
 path True

string

O ID da subscrição de destino.
api-version
 query True

string

A versão da API a utilizar para esta operação.

Corpo do Pedido

Name Necessário Tipo Description
location True

string

A localização geográfica onde o recurso se encontra
properties.links True

SpacecraftLink[]

Lista imutável de ligações de naves espaciais.
properties.titleLine True

string

Linha de título do conjunto de elementos de duas linhas (TLE).
properties.tleLine1 True

string

Linha 1 do conjunto de elementos de duas linhas (TLE).
properties.tleLine2 True

string

Linha 2 do conjunto de elementos de duas linhas (TLE).
properties.noradId

string

ID NORAD da nave espacial.
properties.provisioningState

ProvisioningState

O estado atual da criação, eliminação ou modificação do recurso.
tags

object

Etiquetas de recursos.

Respostas

Name Tipo Description
200 OK

Spacecraft

Atualização com êxito. A operação devolve o recurso de nave espacial resultante.
201 Created

Spacecraft

Crie com êxito. A operação devolve o recurso de nave espacial resultante.

Cabeçalhos

Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Resposta de erro que descreve a razão pela qual a operação falhou.

Exemplos

Create a spacecraft

Pedido de amostra

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

Resposta da amostra

Código de estado:
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"
          }
        ]
      }
    ]
  }
}
Código de estado:
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"
          }
        ]
      }
    ]
  }
}

Definições

Name Description
AuthorizedGroundstation

Estação de terra autorizada.
createdByType

O tipo de identidade que criou o recurso.
direction

Direção (Uplink ou Downlink).
ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.
ErrorDetail

O detalhe do erro.
ErrorResponse

Resposta a erros
polarization

Polarização. por exemplo, (RHCP, LHCP).
ProvisioningState

O estado atual da criação, eliminação ou modificação do recurso.
Spacecraft

O cliente cria um recurso de nave espacial para agendar um contacto.
SpacecraftLink

Lista de ligações de naves espaciais autorizadas por estação terrestre e a data de expiração da autorização.
systemData

Metadados relativos à criação e última modificação do recurso.

AuthorizedGroundstation

Estação de terra autorizada.

Name Tipo Description
expirationDate

string

Data de expiração da autorização.
groundStation

string

Nome da estação de terra.

createdByType

O tipo de identidade que criou o recurso.

Name Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Direção (Uplink ou Downlink).

Name Tipo Description
Downlink

string

Uplink

string

ErrorAdditionalInfo

Informações adicionais sobre o erro de gestão de recursos.

Name Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Name Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
code

string

O código de erro.
details

ErrorDetail[]

Os detalhes do erro.
message

string

A mensagem de erro.
target

string

O destino do erro.

ErrorResponse

Resposta a erros

Name Tipo Description
error

ErrorDetail

O objeto de erro.

polarization

Polarização. por exemplo, (RHCP, LHCP).

Name Tipo Description
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

ProvisioningState

O estado atual da criação, eliminação ou modificação do recurso.

Spacecraft

O cliente cria um recurso de nave espacial para agendar um contacto.

Name Tipo Description
id

string

ID de recurso completamente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

A localização geográfica onde o recurso se encontra
name

string

O nome do recurso
properties.links

SpacecraftLink[]

Lista imutável de ligações de naves espaciais.
properties.noradId

string

ID NORAD da nave espacial.
properties.provisioningState

ProvisioningState

O estado atual da criação, eliminação ou modificação do recurso.
properties.titleLine

string

Linha de título do conjunto de elementos de duas linhas (TLE).
properties.tleLine1

string

Linha 1 do conjunto de elementos de duas linhas (TLE).
properties.tleLine2

string

Linha 2 do conjunto de elementos de duas linhas (TLE).
systemData

systemData

O Azure Resource Manager metadados que contêm informações createdBy e modifiedBy.
tags

object

Etiquetas de recursos.
type

string

O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

Lista de ligações de naves espaciais autorizadas por estação terrestre e a data de expiração da autorização.

Name Tipo Description
authorizations

AuthorizedGroundstation[]

Estações Terrestres Autorizadas
bandwidthMHz

number

Largura de banda em MHz.
centerFrequencyMHz

number

Frequência Central no MHz.
direction

direction

Direção (Uplink ou Downlink).
name

string

Nome da ligação.
polarization

polarization

Polarização. por exemplo, (RHCP, LHCP).

systemData

Metadados relativos à criação e última modificação do recurso.

Name Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).
createdBy

string

A identidade que criou o recurso.
createdByType

createdByType

O tipo de identidade que criou o recurso.
lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy

string

A identidade que modificou o recurso pela última vez.
lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.