共用方式為


Contact Profiles - Create Or Update

建立或更新聯繫人配置檔。

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

URI 參數

名稱 位於 必要 類型 Description
contactProfileName
path True

string

連絡人配置檔名稱。

resourceGroupName
path True

string

資源群組的名稱。 名稱不區分大小寫。

subscriptionId
path True

string

目標訂用帳戶的標識碼。

api-version
query True

string

用於此作業的 API 版本。

要求本文

名稱 必要 類型 Description
location True

string

資源所在的地理位置

properties.links True

ContactProfileLink[]

連絡人配置檔的連結。 描述 RF 連結、數據機處理和 IP 端點。

properties.networkConfiguration True

NetworkConfiguration

客戶虛擬網路的網路設定。

properties.autoTrackingConfiguration

AutoTrackingConfiguration

自動追蹤組態。

properties.eventHubUri

string

用於遙測之事件中樞的 ARM 資源識別碼。 需要授與 Orbital 資源提供者將遙測傳送至中樞的許可權。

properties.minimumElevationDegrees

number

小數點聯繫人的最小可行提高許可權。 用於列出位於指定地面站的可用聯繫人與太空站。

properties.minimumViableContactDuration

string

ISO 8601 格式的最小可行聯繫人持續時間。 用於列出位於指定地面站的可用聯繫人與太空站。

properties.provisioningState

ProvisioningState

資源建立、刪除或修改的目前狀態。

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

聯繫人配置檔的第三方任務組態。 描述 RF 連結、數據機處理和 IP 端點。

tags

object

資源標籤。

回應

名稱 類型 Description
200 OK

ContactProfile

更新成功。 作業會傳回產生的 ContactProfile 資源。

201 Created

ContactProfile

建立成功。 作業會傳回產生的 ContactProfile 資源。

標題

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

描述作業失敗原因的錯誤回應。

範例

Create a contact profile

範例要求

PUT https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP?api-version=2022-11-01

{
  "location": "eastus2",
  "properties": {
    "minimumViableContactDuration": "PT1M",
    "minimumElevationDegrees": 5,
    "autoTrackingConfiguration": "disabled",
    "eventHubUri": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub",
    "networkConfiguration": {
      "subnetId": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"
    },
    "thirdPartyConfigurations": [
      {
        "providerName": "KSAT",
        "missionConfiguration": "Ksat_MissionConfiguration"
      },
      {
        "providerName": "VIASAT",
        "missionConfiguration": "Viasat_Configuration"
      }
    ],
    "links": [
      {
        "name": "contoso-uplink",
        "polarization": "LHCP",
        "direction": "Uplink",
        "gainOverTemperature": 0,
        "eirpdBW": 45,
        "channels": [
          {
            "name": "contoso-uplink-channel",
            "centerFrequencyMHz": 2250,
            "bandwidthMHz": 2,
            "endPoint": {
              "ipAddress": "10.1.0.4",
              "endPointName": "ContosoTest_Uplink",
              "port": "50000",
              "protocol": "TCP"
            }
          }
        ]
      },
      {
        "name": "contoso-downlink",
        "polarization": "RHCP",
        "direction": "Downlink",
        "gainOverTemperature": 25,
        "eirpdBW": 0,
        "channels": [
          {
            "name": "contoso-downlink-channel",
            "centerFrequencyMHz": 8160,
            "bandwidthMHz": 15,
            "endPoint": {
              "ipAddress": "10.1.0.5",
              "endPointName": "ContosoTest_Downlink",
              "port": "50001",
              "protocol": "UDP"
            }
          }
        ]
      }
    ]
  }
}

範例回覆

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/contactProfiles/CONTOSO-CP",
  "name": "CONTOSO-CP",
  "type": "Microsoft.Orbital/contactProfiles",
  "properties": {
    "provisioningState": "updating",
    "minimumViableContactDuration": "PT1M",
    "minimumElevationDegrees": 5,
    "autoTrackingConfiguration": "disabled",
    "eventHubUri": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub",
    "networkConfiguration": {
      "subnetId": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"
    },
    "thirdPartyConfigurations": [
      {
        "providerName": "KSAT",
        "missionConfiguration": "Ksat_MissionConfiguration"
      },
      {
        "providerName": "VIASAT",
        "missionConfiguration": "Viasat_Configuration"
      }
    ],
    "links": [
      {
        "name": "contoso-uplink",
        "polarization": "LHCP",
        "direction": "Uplink",
        "gainOverTemperature": 0,
        "eirpdBW": 45,
        "channels": [
          {
            "name": "contoso-uplink-channel",
            "centerFrequencyMHz": 2250,
            "bandwidthMHz": 2,
            "endPoint": {
              "ipAddress": "10.1.0.4",
              "endPointName": "ContosoTest_Uplink",
              "port": "50000",
              "protocol": "TCP"
            },
            "modulationConfiguration": null,
            "demodulationConfiguration": null,
            "encodingConfiguration": null,
            "decodingConfiguration": null
          }
        ]
      },
      {
        "name": "contoso-downlink",
        "polarization": "RHCP",
        "direction": "Downlink",
        "gainOverTemperature": 25,
        "eirpdBW": 0,
        "channels": [
          {
            "name": "contoso-downlink-channel",
            "centerFrequencyMHz": 8160,
            "bandwidthMHz": 15,
            "endPoint": {
              "ipAddress": "10.1.0.5",
              "endPointName": "ContosoTest_Downlink",
              "port": "50001",
              "protocol": "UDP"
            },
            "modulationConfiguration": null,
            "demodulationConfiguration": null,
            "encodingConfiguration": null,
            "decodingConfiguration": null
          }
        ]
      }
    ]
  }
}
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/contactProfiles/CONTOSO-CP",
  "name": "CONTOSO-CP",
  "type": "Microsoft.Orbital/contactProfiles",
  "properties": {
    "provisioningState": "succeeded",
    "minimumViableContactDuration": "PT1M",
    "minimumElevationDegrees": 5,
    "autoTrackingConfiguration": "disabled",
    "eventHubUri": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.EventHub/namespaces/contosoHub/eventhubs/contosoHub",
    "networkConfiguration": {
      "subnetId": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Network/virtualNetworks/contoso-vnet/subnets/orbital-delegated-subnet"
    },
    "thirdPartyConfigurations": [
      {
        "providerName": "KSAT",
        "missionConfiguration": "Ksat_MissionConfiguration"
      },
      {
        "providerName": "VIASAT",
        "missionConfiguration": "Viasat_Configuration"
      }
    ],
    "links": [
      {
        "name": "contoso-uplink",
        "polarization": "LHCP",
        "direction": "Uplink",
        "gainOverTemperature": 0,
        "eirpdBW": 45,
        "channels": [
          {
            "name": "contoso-uplink-channel",
            "centerFrequencyMHz": 2250,
            "bandwidthMHz": 2,
            "endPoint": {
              "ipAddress": "10.1.0.4",
              "endPointName": "ContosoTest_Uplink",
              "port": "50000",
              "protocol": "TCP"
            },
            "modulationConfiguration": null,
            "demodulationConfiguration": null,
            "encodingConfiguration": null,
            "decodingConfiguration": null
          }
        ]
      },
      {
        "name": "contoso-downlink",
        "polarization": "RHCP",
        "direction": "Downlink",
        "gainOverTemperature": 25,
        "eirpdBW": 0,
        "channels": [
          {
            "name": "contoso-downlink-channel",
            "centerFrequencyMHz": 8160,
            "bandwidthMHz": 15,
            "endPoint": {
              "ipAddress": "10.1.0.5",
              "endPointName": "ContosoTest_Downlink",
              "port": "50001",
              "protocol": "UDP"
            },
            "modulationConfiguration": null,
            "demodulationConfiguration": null,
            "encodingConfiguration": null,
            "decodingConfiguration": null
          }
        ]
      }
    ]
  }
}

定義

名稱 Description
AutoTrackingConfiguration

自動追蹤組態。

ContactProfile

客戶會建立聯繫人配置檔資源,其中包含排程聯繫人所需的所有設定。

ContactProfileLink

連絡人配置檔連結。

ContactProfileLinkChannel

連絡配置文件連結通道。

ContactProfileThirdPartyConfiguration

請連絡配置檔第三方合作夥伴設定。

createdByType

建立資源的身分識別類型。

direction

方向 (上行或下行連結) 。

EndPoint

用戶端點,用來儲存和擷取數據,並在與太空人連絡期間擷取數據。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

NetworkConfiguration

客戶虛擬網路的網路設定。

polarization

極化。 例如 (RHCP、LHCP) 。

protocol

通訊協定 UDP 或 TCP。

ProvisioningState

資源建立、刪除或修改的目前狀態。

systemData

與建立和上次修改資源相關的元數據。

AutoTrackingConfiguration

自動追蹤組態。

名稱 類型 Description
disabled

string

sBand

string

xBand

string

ContactProfile

客戶會建立聯繫人配置檔資源,其中包含排程聯繫人所需的所有設定。

名稱 類型 Description
id

string

資源的完整資源識別碼。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

資源所在的地理位置

name

string

資源的名稱

properties.autoTrackingConfiguration

AutoTrackingConfiguration

自動追蹤組態。

properties.eventHubUri

string

用於遙測之事件中樞的 ARM 資源識別碼。 需要授與 Orbital 資源提供者將遙測傳送至中樞的許可權。

properties.links

ContactProfileLink[]

連絡人配置檔的連結。 描述 RF 連結、數據機處理和 IP 端點。

properties.minimumElevationDegrees

number

小數點聯繫人的最小可行提高許可權。 用於列出位於指定地面站的可用聯繫人與太空站。

properties.minimumViableContactDuration

string

ISO 8601 格式的最小可行聯繫人持續時間。 用於列出位於指定地面站的可用聯繫人與太空站。

properties.networkConfiguration

NetworkConfiguration

客戶虛擬網路的網路設定。

properties.provisioningState

ProvisioningState

資源建立、刪除或修改的目前狀態。

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

聯繫人配置檔的第三方任務組態。 描述 RF 連結、數據機處理和 IP 端點。

systemData

systemData

Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。

tags

object

資源標籤。

type

string

資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts”

連絡人配置檔連結。

名稱 類型 Description
channels

ContactProfileLinkChannel[]

連絡配置文件連結通道。

direction

direction

方向 (上行或下行連結) 。

eirpdBW

number

dBW 中有效的 Isotropic Radiated Power (EIRP) 。 這是客戶所需的EIRP。 尚未使用。

gainOverTemperature

number

取得 db/K 中的雜訊溫度。 這是客戶所需的 G/T。 尚未使用。

name

string

連結名稱。

polarization

polarization

極化。 例如 (RHCP、LHCP) 。

ContactProfileLinkChannel

連絡配置文件連結通道。

名稱 類型 Description
bandwidthMHz

number

MHz 中的頻寬。

centerFrequencyMHz

number

MHz 中的中心頻率。

decodingConfiguration

string

目前未使用。

demodulationConfiguration

string

數據機組態檔的複本,例如 Kratos QRadio 或 Kratos QuantumRx。 僅適用於下行連結方向。 如果提供,數據流機到用戶端點,並傳送降級的數據,而不是 VITA.49 數據流。

encodingConfiguration

string

目前未使用。

endPoint

EndPoint

用戶端點,用來儲存和擷取數據,並在與太空人連絡期間擷取數據。

modulationConfiguration

string

數據機組態檔的複本,例如 Kratos QRadio。 僅適用於上行路線指示。 如果提供,數據流機到用戶端點,並接受來自客戶的命令,而不是 VITA.49 資料流。

name

string

通道名稱。

ContactProfileThirdPartyConfiguration

請連絡配置檔第三方合作夥伴設定。

名稱 類型 Description
missionConfiguration

string

參考特定任務聯繫人設定之組態的字串名稱。 預期的值為已與合作夥伴網路共同建立的值。

providerName

string

第三方提供者的名稱。

createdByType

建立資源的身分識別類型。

名稱 類型 Description
Application

string

Key

string

ManagedIdentity

string

User

string

direction

方向 (上行或下行連結) 。

名稱 類型 Description
Downlink

string

Uplink

string

EndPoint

用戶端點,用來儲存和擷取數據,並在與太空人連絡期間擷取數據。

名稱 類型 Description
endPointName

string

端點的名稱。

ipAddress

string

IP 位址 (IPv4) 。

port

string

要接聽以接收數據的 TCP 埠。

protocol

protocol

通訊協定 UDP 或 TCP。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

NetworkConfiguration

客戶虛擬網路的網路設定。

名稱 類型 Description
subnetId

string

委派給 Microsoft.Orbital/orbitalGateways 之子網的 ARM 資源識別符。 至少必須是類別 C 子網,而且不應該在其中建立任何 IP。

polarization

極化。 例如 (RHCP、LHCP) 。

名稱 類型 Description
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

protocol

通訊協定 UDP 或 TCP。

名稱 類型 Description
TCP

string

UDP

string

ProvisioningState

資源建立、刪除或修改的目前狀態。

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string

資源建立的時間戳 (UTC) 。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。