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 |
---|---|---|---|---|
contact
|
path | True |
string |
連絡人配置檔名稱。 |
resource
|
path | True |
string |
資源群組的名稱。 名稱不區分大小寫。 |
subscription
|
path | True |
string |
目標訂用帳戶的標識碼。 |
api-version
|
query | True |
string |
用於此作業的 API 版本。 |
要求本文
名稱 | 必要 | 類型 | Description |
---|---|---|---|
location | True |
string |
資源所在的地理位置 |
properties.links | True |
連絡人配置檔的連結。 描述 RF 連結、數據機處理和 IP 端點。 |
|
properties.networkConfiguration | True |
客戶虛擬網路的網路設定。 |
|
properties.autoTrackingConfiguration |
自動追蹤組態。 |
||
properties.eventHubUri |
string |
用於遙測之事件中樞的 ARM 資源識別碼。 需要授與 Orbital 資源提供者將遙測傳送至中樞的許可權。 |
|
properties.minimumElevationDegrees |
number |
小數點聯繫人的最小可行提高許可權。 用於列出位於指定地面站的可用聯繫人與太空站。 |
|
properties.minimumViableContactDuration |
string |
ISO 8601 格式的最小可行聯繫人持續時間。 用於列出位於指定地面站的可用聯繫人與太空站。 |
|
properties.provisioningState |
資源建立、刪除或修改的目前狀態。 |
||
properties.thirdPartyConfigurations |
聯繫人配置檔的第三方任務組態。 描述 RF 連結、數據機處理和 IP 端點。 |
||
tags |
object |
資源標籤。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
更新成功。 作業會傳回產生的 ContactProfile 資源。 |
|
201 Created |
建立成功。 作業會傳回產生的 ContactProfile 資源。 標題 Azure-AsyncOperation: string |
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
範例
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 |
---|---|
Auto |
自動追蹤組態。 |
Contact |
客戶會建立聯繫人配置檔資源,其中包含排程聯繫人所需的所有設定。 |
Contact |
連絡人配置檔連結。 |
Contact |
連絡配置文件連結通道。 |
Contact |
請連絡配置檔第三方合作夥伴設定。 |
created |
建立資源的身分識別類型。 |
direction |
方向 (上行或下行連結) 。 |
End |
用戶端點,用來儲存和擷取數據,並在與太空人連絡期間擷取數據。 |
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
Network |
客戶虛擬網路的網路設定。 |
polarization |
極化。 例如 (RHCP、LHCP) 。 |
protocol |
通訊協定 UDP 或 TCP。 |
Provisioning |
資源建立、刪除或修改的目前狀態。 |
system |
與建立和上次修改資源相關的元數據。 |
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 |
自動追蹤組態。 |
|
properties.eventHubUri |
string |
用於遙測之事件中樞的 ARM 資源識別碼。 需要授與 Orbital 資源提供者將遙測傳送至中樞的許可權。 |
properties.links |
連絡人配置檔的連結。 描述 RF 連結、數據機處理和 IP 端點。 |
|
properties.minimumElevationDegrees |
number |
小數點聯繫人的最小可行提高許可權。 用於列出位於指定地面站的可用聯繫人與太空站。 |
properties.minimumViableContactDuration |
string |
ISO 8601 格式的最小可行聯繫人持續時間。 用於列出位於指定地面站的可用聯繫人與太空站。 |
properties.networkConfiguration |
客戶虛擬網路的網路設定。 |
|
properties.provisioningState |
資源建立、刪除或修改的目前狀態。 |
|
properties.thirdPartyConfigurations |
聯繫人配置檔的第三方任務組態。 描述 RF 連結、數據機處理和 IP 端點。 |
|
systemData |
Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。 |
|
tags |
object |
資源標籤。 |
type |
string |
資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts” |
ContactProfileLink
連絡人配置檔連結。
名稱 | 類型 | Description |
---|---|---|
channels |
連絡配置文件連結通道。 |
|
direction |
方向 (上行或下行連結) 。 |
|
eirpdBW |
number |
dBW 中有效的 Isotropic Radiated Power (EIRP) 。 這是客戶所需的EIRP。 尚未使用。 |
gainOverTemperature |
number |
取得 db/K 中的雜訊溫度。 這是客戶所需的 G/T。 尚未使用。 |
name |
string |
連結名稱。 |
polarization |
極化。 例如 (RHCP、LHCP) 。 |
ContactProfileLinkChannel
連絡配置文件連結通道。
名稱 | 類型 | Description |
---|---|---|
bandwidthMHz |
number |
MHz 中的頻寬。 |
centerFrequencyMHz |
number |
MHz 中的中心頻率。 |
decodingConfiguration |
string |
目前未使用。 |
demodulationConfiguration |
string |
數據機組態檔的複本,例如 Kratos QRadio 或 Kratos QuantumRx。 僅適用於下行連結方向。 如果提供,數據流機到用戶端點,並傳送降級的數據,而不是 VITA.49 數據流。 |
encodingConfiguration |
string |
目前未使用。 |
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 |
通訊協定 UDP 或 TCP。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細資料。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
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 |
建立資源的身分識別類型。 |
|
lastModifiedAt |
string |
上次修改的資源時間戳 (UTC) |
lastModifiedBy |
string |
上次修改資源的身分識別。 |
lastModifiedByType |
上次修改資源的身分識別類型。 |