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
contactProfileName
path True

string

Název profilu kontaktu.

resourceGroupName
path True

string

Název skupiny prostředků. V názvu se rozlišují malá a velká písmena.

subscriptionId
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

ContactProfileLink[]

Odkazy profilu kontaktu. Popisuje rf propojení, zpracování modemu a koncové body IP.

properties.networkConfiguration True

NetworkConfiguration

Konfigurace sítě virtuální sítě zákazníka

properties.autoTrackingConfiguration

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

ProvisioningState

Aktuální stav vytvoření, odstranění nebo úpravy prostředku.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

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

ContactProfile

Aktualizace proběhla úspěšně. Operace vrátí výsledný prostředek ContactProfile.

201 Created

ContactProfile

Vytvoření proběhlo úspěšně. Operace vrátí výsledný prostředek ContactProfile.

Headers

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

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
AutoTrackingConfiguration

Konfigurace automatického sledování.

ContactProfile

Zákazník vytvoří prostředek profilu kontaktu, který bude obsahovat všechny konfigurace potřebné k naplánování kontaktu.

ContactProfileLink

Odkaz na profil kontaktu.

ContactProfileLinkChannel

Kanál propojení profilu kontaktu.

ContactProfileThirdPartyConfiguration

Kontaktujte profil konfigurace partnera třetí strany.

createdByType

Typ identity, která prostředek vytvořila.

direction

Směr (odchozí nebo downlink).

EndPoint

Koncový bod zákazníka pro ukládání a načítání dat během kontaktu s vesmírnou lodí.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě

ErrorResponse

Chybová odpověď

NetworkConfiguration

Konfigurace sítě virtuální sítě zákazníka

polarization

Polarizace. např. (RHCP, LHCP).

protocol

Protokol udp nebo TCP.

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.

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

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

ContactProfileLink[]

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

NetworkConfiguration

Konfigurace sítě virtuální sítě zákazníka

properties.provisioningState

ProvisioningState

Aktuální stav vytvoření, odstranění nebo úpravy prostředku.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Konfigurace mise třetí strany profilu kontaktu. Popisuje rf propojení, zpracování modemu a koncové body IP.

systemData

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

Odkaz na profil kontaktu.

Name Typ Description
channels

ContactProfileLinkChannel[]

Kanál propojení profilu kontaktu.

direction

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

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

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

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

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

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

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

createdByType

Typ identity, která naposledy změnila prostředek.