Contact Profiles - Create Or Update
Membuat atau memperbarui profil kontak.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/contactProfiles/{contactProfileName}?api-version=2022-11-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
contact
|
path | True |
string |
Nama Profil Kontak. |
resource
|
path | True |
string |
Nama grup sumber daya. Nama tidak peka huruf besar/kecil. |
subscription
|
path | True |
string |
ID langganan target. |
api-version
|
query | True |
string |
Versi API yang digunakan untuk operasi ini. |
Isi Permintaan
Nama | Diperlukan | Jenis | Deskripsi |
---|---|---|---|
location | True |
string |
Lokasi geografis tempat sumber daya berada |
properties.links | True |
Tautan Profil Kontak. Menjelaskan tautan RF, pemrosesan modem, dan titik akhir IP. |
|
properties.networkConfiguration | True |
Konfigurasi jaringan jaringan virtual pelanggan. |
|
properties.autoTrackingConfiguration |
Konfigurasi pelacakan otomatis. |
||
properties.eventHubUri |
string |
Pengidentifikasi sumber daya ARM dari Pusat Aktivitas yang digunakan untuk telemetri. Mengharuskan pemberian hak kepada Penyedia Sumber Orbital untuk mengirim telemetri ke hub. |
|
properties.minimumElevationDegrees |
number |
Elevasi layak minimum untuk kontak dalam derajat desimal. Digunakan untuk mencantumkan kontak yang tersedia dengan pesawat ruang angkasa di stasiun darat tertentu. |
|
properties.minimumViableContactDuration |
string |
Durasi kontak minimum yang layak dalam format ISO 8601. Digunakan untuk mencantumkan kontak yang tersedia dengan pesawat ruang angkasa di stasiun darat tertentu. |
|
properties.provisioningState |
Status pembuatan, penghapusan, atau modifikasi sumber daya saat ini. |
||
properties.thirdPartyConfigurations |
Konfigurasi misi pihak ketiga dari Profil Kontak. Menjelaskan tautan RF, pemrosesan modem, dan titik akhir IP. |
||
tags |
object |
Tag sumber daya. |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
Pembaruan berhasil. Operasi mengembalikan sumber daya ContactProfile yang dihasilkan. |
|
201 Created |
Buat keberhasilan. Operasi mengembalikan sumber daya ContactProfile yang dihasilkan. Headers Azure-AsyncOperation: string |
|
Other Status Codes |
Respons kesalahan yang menjelaskan mengapa operasi gagal. |
Contoh
Create a contact profile
Sample Request
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"
}
}
]
}
]
}
}
Sample Response
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
}
]
}
]
}
}
Definisi
Nama | Deskripsi |
---|---|
Auto |
Konfigurasi pelacakan otomatis. |
Contact |
Pelanggan membuat Sumber Daya Profil Kontak, yang akan berisi semua konfigurasi yang diperlukan untuk menjadwalkan kontak. |
Contact |
Tautan Profil Kontak. |
Contact |
Hubungi Saluran Tautan Profil. |
Contact |
Hubungi Konfigurasi mitra pihak ketiga Profil. |
created |
Jenis identitas yang membuat sumber daya. |
direction |
Arah (Uplink atau Downlink). |
End |
Titik akhir pelanggan untuk menyimpan dan mengambil data selama kontak dengan pesawat ruang angkasa. |
Error |
Info tambahan kesalahan manajemen sumber daya. |
Error |
Detail kesalahan. |
Error |
Respons kesalahan |
Network |
Konfigurasi jaringan jaringan virtual pelanggan. |
polarization |
Polarisasi. misalnya (RHCP, LHCP). |
protocol |
Protokol baik UDP atau TCP. |
Provisioning |
Status pembuatan, penghapusan, atau modifikasi sumber daya saat ini. |
system |
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya. |
AutoTrackingConfiguration
Konfigurasi pelacakan otomatis.
Nama | Jenis | Deskripsi |
---|---|---|
disabled |
string |
|
sBand |
string |
|
xBand |
string |
ContactProfile
Pelanggan membuat Sumber Daya Profil Kontak, yang akan berisi semua konfigurasi yang diperlukan untuk menjadwalkan kontak.
Nama | Jenis | Deskripsi |
---|---|---|
id |
string |
ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
Lokasi geografis tempat sumber daya berada |
name |
string |
Nama sumber daya. |
properties.autoTrackingConfiguration |
Konfigurasi pelacakan otomatis. |
|
properties.eventHubUri |
string |
Pengidentifikasi sumber daya ARM dari Pusat Aktivitas yang digunakan untuk telemetri. Mengharuskan pemberian hak kepada Penyedia Sumber Orbital untuk mengirim telemetri ke hub. |
properties.links |
Tautan Profil Kontak. Menjelaskan tautan RF, pemrosesan modem, dan titik akhir IP. |
|
properties.minimumElevationDegrees |
number |
Elevasi layak minimum untuk kontak dalam derajat desimal. Digunakan untuk mencantumkan kontak yang tersedia dengan pesawat ruang angkasa di stasiun darat tertentu. |
properties.minimumViableContactDuration |
string |
Durasi kontak minimum yang layak dalam format ISO 8601. Digunakan untuk mencantumkan kontak yang tersedia dengan pesawat ruang angkasa di stasiun darat tertentu. |
properties.networkConfiguration |
Konfigurasi jaringan jaringan virtual pelanggan. |
|
properties.provisioningState |
Status pembuatan, penghapusan, atau modifikasi sumber daya saat ini. |
|
properties.thirdPartyConfigurations |
Konfigurasi misi pihak ketiga dari Profil Kontak. Menjelaskan tautan RF, pemrosesan modem, dan titik akhir IP. |
|
systemData |
Metadata Azure Resource Manager yang berisi informasi createdBy dan modifiedBy. |
|
tags |
object |
Tag sumber daya. |
type |
string |
Jenis sumber daya. Misalnya, "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts" |
ContactProfileLink
Tautan Profil Kontak.
Nama | Jenis | Deskripsi |
---|---|---|
channels |
Hubungi Saluran Tautan Profil. |
|
direction |
Arah (Uplink atau Downlink). |
|
eirpdBW |
number |
Daya Terradiasi Isotropik Efektif (EIRP) di dBW. Ini adalah EIRP yang diperlukan oleh pelanggan. Belum digunakan. |
gainOverTemperature |
number |
Dapatkan suhu kebisingan dalam db/K. Ini adalah G/T yang diperlukan oleh pelanggan. Belum digunakan. |
name |
string |
Nama tautan. |
polarization |
Polarisasi. misalnya (RHCP, LHCP). |
ContactProfileLinkChannel
Hubungi Saluran Tautan Profil.
Nama | Jenis | Deskripsi |
---|---|---|
bandwidthMHz |
number |
Bandwidth di MHz. |
centerFrequencyMHz |
number |
Frekuensi Tengah di MHz. |
decodingConfiguration |
string |
Saat ini tidak digunakan. |
demodulationConfiguration |
string |
Salinan file konfigurasi modem seperti Kratos QRadio atau Kratos QuantumRx. Hanya berlaku untuk petunjuk arah downlink. Jika disediakan, modem terhubung ke titik akhir pelanggan dan mengirim data yang didemodulasikan alih-alih aliran VITA.49. |
encodingConfiguration |
string |
Saat ini tidak digunakan. |
endPoint |
Titik akhir pelanggan untuk menyimpan dan mengambil data selama kontak dengan pesawat ruang angkasa. |
|
modulationConfiguration |
string |
Salinan file konfigurasi modem seperti Kratos QRadio. Hanya berlaku untuk petunjuk arah uplink. Jika disediakan, modem terhubung ke titik akhir pelanggan dan menerima perintah dari pelanggan alih-alih aliran VITA.49. |
name |
string |
Nama saluran. |
ContactProfileThirdPartyConfiguration
Hubungi Konfigurasi mitra pihak ketiga Profil.
Nama | Jenis | Deskripsi |
---|---|---|
missionConfiguration |
string |
Nama string yang mereferensikan konfigurasi yang menjelaskan pengaturan kontak untuk misi tertentu. Nilai yang diharapkan adalah nilai yang telah dibuat bekerja sama dengan jaringan mitra. |
providerName |
string |
Nama penyedia pihak ketiga. |
createdByType
Jenis identitas yang membuat sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
direction
Arah (Uplink atau Downlink).
Nama | Jenis | Deskripsi |
---|---|---|
Downlink |
string |
|
Uplink |
string |
EndPoint
Titik akhir pelanggan untuk menyimpan dan mengambil data selama kontak dengan pesawat ruang angkasa.
Nama | Jenis | Deskripsi |
---|---|---|
endPointName |
string |
Nama titik akhir. |
ipAddress |
string |
Alamat IP (IPv4). |
port |
string |
Port TCP untuk mendengarkan untuk menerima data. |
protocol |
Protokol baik UDP atau TCP. |
ErrorAdditionalInfo
Info tambahan kesalahan manajemen sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
info |
object |
Info tambahan. |
type |
string |
Jenis info tambahan. |
ErrorDetail
Detail kesalahan.
Nama | Jenis | Deskripsi |
---|---|---|
additionalInfo |
Info tambahan kesalahan. |
|
code |
string |
Kode kesalahan. |
details |
Detail kesalahan. |
|
message |
string |
Pesan kesalahan. |
target |
string |
Target kesalahan. |
ErrorResponse
Respons kesalahan
Nama | Jenis | Deskripsi |
---|---|---|
error |
Objek kesalahan. |
NetworkConfiguration
Konfigurasi jaringan jaringan virtual pelanggan.
Nama | Jenis | Deskripsi |
---|---|---|
subnetId |
string |
Pengidentifikasi sumber daya ARM dari subnet yang didelegasikan ke Microsoft.Orbital/orbitalGateways. Harus setidaknya subnet kelas C, dan tidak boleh memiliki IP apa pun yang dibuat di dalamnya. |
polarization
Polarisasi. misalnya (RHCP, LHCP).
Nama | Jenis | Deskripsi |
---|---|---|
LHCP |
string |
|
RHCP |
string |
|
linearHorizontal |
string |
|
linearVertical |
string |
protocol
Protokol baik UDP atau TCP.
Nama | Jenis | Deskripsi |
---|---|---|
TCP |
string |
|
UDP |
string |
ProvisioningState
Status pembuatan, penghapusan, atau modifikasi sumber daya saat ini.
systemData
Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.
Nama | Jenis | Deskripsi |
---|---|---|
createdAt |
string |
Tanda waktu pembuatan sumber daya (UTC). |
createdBy |
string |
Identitas yang membuat sumber daya. |
createdByType |
Jenis identitas yang membuat sumber daya. |
|
lastModifiedAt |
string |
Tanda waktu modifikasi terakhir sumber daya (UTC) |
lastModifiedBy |
string |
Identitas yang terakhir memodifikasi sumber daya. |
lastModifiedByType |
Jenis identitas yang terakhir mengubah sumber daya. |