Поделиться через

Spacecrafts - Create Or Update

  • Ссылка
Служба:
Orbital
Версия API:
2022-11-01

Создает или обновляет ресурс космического аппарата.

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

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
 path True

string

Имя группы ресурсов. Регистр букв в имени не учитывается.
spacecraftName
 path True

string

Идентификатор космического аппарата.
subscriptionId
 path True

string

Идентификатор целевой подписки.
api-version
 query True

string

Версия API, используемая для данной операции.

Текст запроса

Имя Обязательно Тип Описание
location True

string

Географическое расположение, в котором находится ресурс
properties.links True

SpacecraftLink[]

Неизменяемый список ссылок на космические аппараты.
properties.titleLine True

string

Строка заголовка набора двухстроковых элементов (TLE).
properties.tleLine1 True

string

Строка 1 набора двухстроковых элементов (TLE).
properties.tleLine2 True

string

Строка 2 набора двухстроковых элементов (TLE).
properties.noradId

string

ИДЕНТИФИКАТОР NORAD космического аппарата.
properties.provisioningState

ProvisioningState

Текущее состояние создания, удаления или изменения ресурса.
tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

Spacecraft

Обновление выполнено успешно. Операция возвращает результирующий ресурс космического аппарата.
201 Created

Spacecraft

Создание выполнено успешно. Операция возвращает результирующий ресурс космического аппарата.

Заголовки

Azure-AsyncOperation: string
Other Status Codes

ErrorResponse

Ответ об ошибке, описывающий причину сбоя операции.

Примеры

Create a spacecraft

Образец запроса

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

Пример ответа

Код состояния:
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"
          }
        ]
      }
    ]
  }
}
Код состояния:
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"
          }
        ]
      }
    ]
  }
}

Определения

Имя Описание
AuthorizedGroundstation

Авторизованная заземная станция.
createdByType

Тип удостоверения, создавшего ресурс.
direction

Направление (исходящей или нисходящей).
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail

Сведения об ошибке.
ErrorResponse

Сообщение об ошибке
polarization

Поляризации. например (RHCP, LHCP).
ProvisioningState

Текущее состояние создания, удаления или изменения ресурса.
Spacecraft

Клиент создает ресурс космического аппарата для планирования контакта.
SpacecraftLink

Список разрешенных соединений с космическими аппаратами на наземную станцию и дата окончания срока действия авторизации.
systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

AuthorizedGroundstation

Авторизованная заземная станция.

Имя Тип Описание
expirationDate

string

Дата истечения срока действия авторизации.
groundStation

string

Имя заземления.

createdByType

Тип удостоверения, создавшего ресурс.

Имя Тип Описание
Application

string

Key

string

ManagedIdentity

string

User

string

direction

Направление (исходящей или нисходящей).

Имя Тип Описание
Downlink

string

Uplink

string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

polarization

Поляризации. например (RHCP, LHCP).

Имя Тип Описание
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

ProvisioningState

Текущее состояние создания, удаления или изменения ресурса.

Spacecraft

Клиент создает ресурс космического аппарата для планирования контакта.

Имя Тип Описание
id

string

Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location

string

Географическое расположение, в котором находится ресурс
name

string

Имя ресурса.
properties.links

SpacecraftLink[]

Неизменяемый список ссылок на космические аппараты.
properties.noradId

string

ИДЕНТИФИКАТОР NORAD космического аппарата.
properties.provisioningState

ProvisioningState

Текущее состояние создания, удаления или изменения ресурса.
properties.titleLine

string

Строка заголовка набора двухстроковых элементов (TLE).
properties.tleLine1

string

Строка 1 набора двухстроковых элементов (TLE).
properties.tleLine2

string

Строка 2 набора двухстроковых элементов (TLE).
systemData

systemData

Azure Resource Manager метаданные, содержащие сведения о createdBy и modifiedBy.
tags

object

Теги ресурсов.
type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

Список разрешенных соединений с космическими аппаратами на наземную станцию и дата окончания срока действия авторизации.

Имя Тип Описание
authorizations

AuthorizedGroundstation[]

Авторизованные наземные станции
bandwidthMHz

number

Пропускная способность в МГц.
centerFrequencyMHz

number

Центральная частота в МГц.
direction

direction

Направление (исходящей или нисходящей).
name

string

Имя ссылки.
polarization

polarization

Поляризации. например (RHCP, LHCP).

systemData

Метаданные, относящиеся к созданию и последнему изменению ресурса.

Имя Тип Описание
createdAt

string

Метка времени создания ресурса (UTC).
createdBy

string

Удостоверение, создающее ресурс.
createdByType

createdByType

Тип удостоверения, создавшего ресурс.
lastModifiedAt

string

Метка времени последнего изменения ресурса (UTC)
lastModifiedBy

string

Удостоверение, которое в последний раз изменял ресурс.
lastModifiedByType

createdByType

Тип удостоверения, изменяющего ресурс в последний раз.