Compartir a través de

Spacecrafts - Create Or Update

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

Crea o actualiza un 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 de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
 path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
spacecraftName
 path True

string

Id. de nave espacial.
subscriptionId
 path True

string

Identificador de la suscripción de destino.
api-version
 query True

string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación geográfica donde reside el recurso
properties.links True

SpacecraftLink[]

Lista inmutable de enlaces de nave espacial.
properties.titleLine True

string

Línea de título del conjunto de elementos de dos líneas (TLE).
properties.tleLine1 True

string

Línea 1 del conjunto de elementos de dos líneas (TLE).
properties.tleLine2 True

string

Línea 2 del conjunto de elementos de dos líneas (TLE).
properties.noradId

string

NORAD ID de la nave espacial.
properties.provisioningState

ProvisioningState

Estado actual de la creación, eliminación o modificación del recurso.
tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

Spacecraft

La actualización se realizó correctamente. La operación devuelve el recurso de nave espacial resultante.
201 Created

Spacecraft

Cree correctamente. La operación devuelve el recurso de nave espacial resultante.

Headers

Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Ejemplos

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

Definiciones

Nombre Description
AuthorizedGroundstation

Estación terrestre autorizada.
createdByType

Tipo de identidad que creó el recurso.
direction

Dirección (vínculo superior o vínculo descendente).
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorDetail

Detalle del error.
ErrorResponse

Respuesta de error
polarization

Polarización. Por ejemplo, (RHCP, LHCP).
ProvisioningState

Estado actual de la creación, eliminación o modificación del recurso.
Spacecraft

El cliente crea un recurso de nave espacial para programar un contacto.
SpacecraftLink

Lista de enlaces de naves espaciales autorizadas por estación terrestre y la fecha de expiración de la autorización.
systemData

Metadatos relacionados con la creación y la última modificación del recurso.

AuthorizedGroundstation

Estación terrestre autorizada.

Nombre Tipo Description
expirationDate

string

Fecha de expiración de la autorización.
groundStation

string

Nombre de la estación de tierra.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Dirección (vínculo superior o vínculo descendente).

Nombre Tipo Description
Downlink

string

Uplink

string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorDetail[]

Los detalles del error.
message

string

El mensaje de error.
target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

polarization

Polarización. Por ejemplo, (RHCP, LHCP).

Nombre Tipo Description
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

ProvisioningState

Estado actual de la creación, eliminación o modificación del recurso.

Spacecraft

El cliente crea un recurso de nave espacial para programar un contacto.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Ubicación geográfica donde reside el recurso
name

string

Nombre del recurso.
properties.links

SpacecraftLink[]

Lista inmutable de enlaces de nave espacial.
properties.noradId

string

NORAD ID de la nave espacial.
properties.provisioningState

ProvisioningState

Estado actual de la creación, eliminación o modificación del recurso.
properties.titleLine

string

Línea de título del conjunto de elementos de dos líneas (TLE).
properties.tleLine1

string

Línea 1 del conjunto de elementos de dos líneas (TLE).
properties.tleLine2

string

Línea 2 del conjunto de elementos de dos líneas (TLE).
systemData

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.
tags

object

Etiquetas del recurso.
type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

Lista de enlaces de naves espaciales autorizadas por estación terrestre y la fecha de expiración de la autorización.

Nombre Tipo Description
authorizations

AuthorizedGroundstation[]

Estaciones terrestres autorizadas
bandwidthMHz

number

Ancho de banda en MHz.
centerFrequencyMHz

number

Frecuencia central en MHz.
direction

direction

Dirección (vínculo superior o vínculo descendente).
name

string

Nombre del vínculo.
polarization

polarization

Polarización. Por ejemplo, (RHCP, LHCP).

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).
createdBy

string

Identidad que creó el recurso.
createdByType

createdByType

Tipo de identidad que creó el recurso.
lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy

string

Identidad que modificó por última vez el recurso.
lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.