Contact Profiles - Create Or Update
Vytvoří nebo aktualizuje profil kontaktu.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/contactProfiles/{contactProfileName}?api-version=2022-11-01
Parametry identifikátoru URI
Name | V | Vyžadováno | Typ | Description |
---|---|---|---|---|
contact
|
path | True |
string |
Název profilu kontaktu. |
resource
|
path | True |
string |
Název skupiny prostředků. V názvu se rozlišují malá a velká písmena. |
subscription
|
path | True |
string |
ID cílového předplatného. |
api-version
|
query | True |
string |
Verze rozhraní API, která se má použít pro tuto operaci. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
location | True |
string |
Geografické umístění, kde se prostředek nachází |
properties.links | True |
Odkazy profilu kontaktu. Popisuje rf propojení, zpracování modemu a koncové body IP. |
|
properties.networkConfiguration | True |
Konfigurace sítě virtuální sítě zákazníka |
|
properties.autoTrackingConfiguration |
Konfigurace automatického sledování. |
||
properties.eventHubUri |
string |
Identifikátor prostředku ARM centra událostí používaného pro telemetrii. Vyžaduje udělení oprávnění k odesílání telemetrických dat do centra. |
|
properties.minimumElevationDegrees |
number |
Minimální schůdná výška kontaktu v desetinných stupních. Používá se k výpisu dostupných kontaktů s vesmírnou lodí na dané pozemní stanici. |
|
properties.minimumViableContactDuration |
string |
Minimální realizovatelná doba trvání kontaktu ve formátu ISO 8601. Používá se k výpisu dostupných kontaktů s vesmírnou lodí na dané pozemní stanici. |
|
properties.provisioningState |
Aktuální stav vytvoření, odstranění nebo úpravy prostředku. |
||
properties.thirdPartyConfigurations |
Konfigurace mise třetí strany profilu kontaktu. Popisuje rf propojení, zpracování modemu a koncové body IP. |
||
tags |
object |
Značky prostředků. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Aktualizace proběhla úspěšně. Operace vrátí výsledný prostředek ContactProfile. |
|
201 Created |
Vytvoření proběhlo úspěšně. Operace vrátí výsledný prostředek ContactProfile. Headers Azure-AsyncOperation: string |
|
Other Status Codes |
Chybová odpověď popisující, proč operace selhala. |
Příklady
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
}
]
}
]
}
}
Definice
Name | Description |
---|---|
Auto |
Konfigurace automatického sledování. |
Contact |
Zákazník vytvoří prostředek profilu kontaktu, který bude obsahovat všechny konfigurace potřebné k naplánování kontaktu. |
Contact |
Odkaz na profil kontaktu. |
Contact |
Kanál propojení profilu kontaktu. |
Contact |
Kontaktujte profil konfigurace partnera třetí strany. |
created |
Typ identity, která prostředek vytvořila. |
direction |
Směr (odchozí nebo downlink). |
End |
Koncový bod zákazníka pro ukládání a načítání dat během kontaktu s vesmírnou lodí. |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě |
Error |
Chybová odpověď |
Network |
Konfigurace sítě virtuální sítě zákazníka |
polarization |
Polarizace. např. (RHCP, LHCP). |
protocol |
Protokol udp nebo TCP. |
Provisioning |
Aktuální stav vytvoření, odstranění nebo úpravy prostředku. |
system |
Metadata týkající se vytvoření a poslední změny prostředku. |
AutoTrackingConfiguration
Konfigurace automatického sledování.
Name | Typ | Description |
---|---|---|
disabled |
string |
|
sBand |
string |
|
xBand |
string |
ContactProfile
Zákazník vytvoří prostředek profilu kontaktu, který bude obsahovat všechny konfigurace potřebné k naplánování kontaktu.
Name | Typ | Description |
---|---|---|
id |
string |
Plně kvalifikované ID prostředku Příklad : /subscriptions/{id_předplatného}/resourceGroups/{název_skupiny_prostředků}/providers/{resourceProviderNamespace}/{typ_prostředku}/{název_prostředku} |
location |
string |
Geografické umístění, kde se prostředek nachází |
name |
string |
Název prostředku |
properties.autoTrackingConfiguration |
Konfigurace automatického sledování. |
|
properties.eventHubUri |
string |
Identifikátor prostředku ARM centra událostí používaného pro telemetrii. Vyžaduje udělení oprávnění k odesílání telemetrických dat do centra. |
properties.links |
Odkazy profilu kontaktu. Popisuje rf propojení, zpracování modemu a koncové body IP. |
|
properties.minimumElevationDegrees |
number |
Minimální schůdná výška kontaktu v desetinných stupních. Používá se k výpisu dostupných kontaktů s vesmírnou lodí na dané pozemní stanici. |
properties.minimumViableContactDuration |
string |
Minimální realizovatelná doba trvání kontaktu ve formátu ISO 8601. Používá se k výpisu dostupných kontaktů s vesmírnou lodí na dané pozemní stanici. |
properties.networkConfiguration |
Konfigurace sítě virtuální sítě zákazníka |
|
properties.provisioningState |
Aktuální stav vytvoření, odstranění nebo úpravy prostředku. |
|
properties.thirdPartyConfigurations |
Konfigurace mise třetí strany profilu kontaktu. Popisuje rf propojení, zpracování modemu a koncové body IP. |
|
systemData |
Azure Resource Manager metadata obsahující informace createdBy a modifiedBy. |
|
tags |
object |
Značky prostředků. |
type |
string |
Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts |
ContactProfileLink
Odkaz na profil kontaktu.
Name | Typ | Description |
---|---|---|
channels |
Kanál propojení profilu kontaktu. |
|
direction |
Směr (odchozí nebo downlink). |
|
eirpdBW |
number |
Efektivní izotropní radiovaný výkon (EIRP) v dBW. Jedná se o požadovaný EIRP zákazníkem. Zatím se nepoužívá. |
gainOverTemperature |
number |
Zvýšení teploty hluku v db/K. Je to požadovaná G/T zákazníkem. Zatím se nepoužívá. |
name |
string |
Název odkazu. |
polarization |
Polarizace. např. (RHCP, LHCP). |
ContactProfileLinkChannel
Kanál propojení profilu kontaktu.
Name | Typ | Description |
---|---|---|
bandwidthMHz |
number |
Šířka pásma v MHz. |
centerFrequencyMHz |
number |
Středová frekvence v MHz. |
decodingConfiguration |
string |
Aktuálně se nepoužívá. |
demodulationConfiguration |
string |
Kopie konfiguračního souboru modemu, například Kratos QRadio nebo Kratos QuantumRx. Platí pouze pro navigační pokyny pro odkazy dolů. Pokud je k dispozici, modem se připojí ke koncovému bodu zákazníka a odešle demodulovaná data místo streamu VITA.49. |
encodingConfiguration |
string |
Aktuálně se nepoužívá. |
endPoint |
Koncový bod zákazníka pro ukládání a načítání dat během kontaktu s vesmírnou lodí. |
|
modulationConfiguration |
string |
Kopie konfiguračního souboru modemu, například Kratos QRadio. Platí pouze pro směrování odchozího připojení. Pokud je modem zadán, připojí se ke koncovému bodu zákazníka a přijímá příkazy zákazníka místo streamu VITA.49. |
name |
string |
Název kanálu. |
ContactProfileThirdPartyConfiguration
Kontaktujte profil konfigurace partnera třetí strany.
Name | Typ | Description |
---|---|---|
missionConfiguration |
string |
Název řetězce odkazujícího na konfiguraci popisující nastavení kontaktu pro konkrétní misi. Očekávané hodnoty jsou ty, které byly vytvořeny ve spolupráci s partnerskou sítí. |
providerName |
string |
Název poskytovatele třetí strany. |
createdByType
Typ identity, která prostředek vytvořila.
Name | Typ | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
direction
Směr (odchozí nebo downlink).
Name | Typ | Description |
---|---|---|
Downlink |
string |
|
Uplink |
string |
EndPoint
Koncový bod zákazníka pro ukládání a načítání dat během kontaktu s vesmírnou lodí.
Name | Typ | Description |
---|---|---|
endPointName |
string |
Název koncového bodu |
ipAddress |
string |
IP adresa (IPv4). |
port |
string |
Port TCP pro naslouchání při příjmu dat. |
protocol |
Protokol udp nebo TCP. |
ErrorAdditionalInfo
Další informace o chybě správy prostředků
Name | Typ | Description |
---|---|---|
info |
object |
Další informace. |
type |
string |
Typ další informace. |
ErrorDetail
Podrobnosti o chybě
Name | Typ | Description |
---|---|---|
additionalInfo |
Další informace o chybě. |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě. |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Chybová odpověď
Name | Typ | Description |
---|---|---|
error |
Objekt chyby. |
NetworkConfiguration
Konfigurace sítě virtuální sítě zákazníka
Name | Typ | Description |
---|---|---|
subnetId |
string |
Identifikátor prostředku ARM podsítě delegované na Microsoft.Orbital/orbitalGateways. Musí to být alespoň podsíť třídy C a neměla by v ní být vytvořená žádná IP adresa. |
polarization
Polarizace. např. (RHCP, LHCP).
Name | Typ | Description |
---|---|---|
LHCP |
string |
|
RHCP |
string |
|
linearHorizontal |
string |
|
linearVertical |
string |
protocol
Protokol udp nebo TCP.
Name | Typ | Description |
---|---|---|
TCP |
string |
|
UDP |
string |
ProvisioningState
Aktuální stav vytvoření, odstranění nebo úpravy prostředku.
systemData
Metadata týkající se vytvoření a poslední změny prostředku.
Name | Typ | Description |
---|---|---|
createdAt |
string |
Časové razítko vytvoření prostředku (UTC) |
createdBy |
string |
Identita, která vytvořila prostředek. |
createdByType |
Typ identity, která prostředek vytvořila. |
|
lastModifiedAt |
string |
Časové razítko poslední změny prostředku (UTC) |
lastModifiedBy |
string |
Identita, která naposledy změnila prostředek. |
lastModifiedByType |
Typ identity, která naposledy změnila prostředek. |