Spacecrafts - Create Or Update

  • Référence
Service:
Orbital
API Version:
2022-11-01

Crée ou met à jour une ressource de vaisseau spatial.

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

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
 path True

string

Nom du groupe de ressources. Le nom ne respecte pas la casse.
spacecraftName
 path True

string

ID du vaisseau spatial.
subscriptionId
 path True

string

ID de l’abonnement cible.
api-version
 query True

string

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Obligatoire Type Description
location True

string

Emplacement géographique où réside la ressource
properties.links True

SpacecraftLink[]

Liste immuable de liens vaisseaux spatiaux.
properties.titleLine True

string

Ligne de titre de l’ensemble d’éléments à deux lignes (TLE).
properties.tleLine1 True

string

Ligne 1 du jeu d’éléments à deux lignes (TLE).
properties.tleLine2 True

string

Ligne 2 du jeu d’éléments à deux lignes (TLE).
properties.noradId

string

ID NORAD du vaisseau spatial.
properties.provisioningState

ProvisioningState

État actuel de la création, de la suppression ou de la modification de la ressource.
tags

object

Balises de ressource.

Réponses

Nom Type Description
200 OK

Spacecraft

Mise à jour réussie. L’opération retourne la ressource de vaisseau spatial résultante.
201 Created

Spacecraft

Création réussie. L’opération retourne la ressource de vaisseau spatial résultante.

Headers

Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Exemples

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

Définitions

Nom Description
AuthorizedGroundstation

Poste de sol autorisé.
createdByType

Type d’identité qui a créé la ressource.
direction

Direction (liaison montante ou descendante).
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail

Détail de l’erreur.
ErrorResponse

Réponse d’erreur
polarization

Polarisation. par exemple (RHCP, LHCP).
ProvisioningState

État actuel de la création, de la suppression ou de la modification de la ressource.
Spacecraft

Le client crée une ressource de vaisseau spatial pour planifier un contact.
SpacecraftLink

Liste des liaisons de vaisseaux spatiaux autorisées par station terrestre et date d’expiration de l’autorisation.
systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

AuthorizedGroundstation

Poste de sol autorisé.

Nom Type Description
expirationDate

string

Date d’expiration de l’autorisation.
groundStation

string

Nom de la station de terre.

createdByType

Type d’identité qui a créé la ressource.

Nom Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Direction (liaison montante ou descendante).

Nom Type Description
Downlink

string

Uplink

string

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires
type

string

Type d’informations supplémentaires.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.
code

string

Code d'erreur.
details

ErrorDetail[]

Détails de l’erreur.
message

string

Message d’erreur.
target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet error.

polarization

Polarisation. par exemple (RHCP, LHCP).

Nom Type Description
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

ProvisioningState

État actuel de la création, de la suppression ou de la modification de la ressource.

Spacecraft

Le client crée une ressource de vaisseau spatial pour planifier un contact.

Nom Type Description
id

string

ID de ressource complet pour la ressource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Emplacement géographique où réside la ressource
name

string

nom de la ressource.
properties.links

SpacecraftLink[]

Liste immuable de liens vaisseaux spatiaux.
properties.noradId

string

ID NORAD du vaisseau spatial.
properties.provisioningState

ProvisioningState

État actuel de la création, de la suppression ou de la modification de la ressource.
properties.titleLine

string

Ligne de titre de l’ensemble d’éléments à deux lignes (TLE).
properties.tleLine1

string

Ligne 1 du jeu d’éléments à deux lignes (TLE).
properties.tleLine2

string

Ligne 2 du jeu d’éléments à deux lignes (TLE).
systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags

object

Balises de ressource.
type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

Liste des liaisons de vaisseaux spatiaux autorisées par station terrestre et date d’expiration de l’autorisation.

Nom Type Description
authorizations

AuthorizedGroundstation[]

Stations terrestres autorisées
bandwidthMHz

number

Bande passante en MHz.
centerFrequencyMHz

number

Fréquence centrale en MHz.
direction

direction

Direction (liaison montante ou descendante).
name

string

Nom du lien.
polarization

polarization

Polarisation. par exemple (RHCP, LHCP).

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string

Horodatage de la création de ressources (UTC).
createdBy

string

Identité qui a créé la ressource.
createdByType

createdByType

Type d’identité qui a créé la ressource.
lastModifiedAt

string

Horodatage de la dernière modification de la ressource (UTC)
lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.