Udostępnij za pośrednictwem


Contact Profiles - Create Or Update

Tworzy lub aktualizuje profil kontaktu.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
contactProfileName
path True

string

Nazwa profilu kontaktu.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.

subscriptionId
path True

string

minLength: 1

Identyfikator subskrypcji docelowej.

api-version
query True

string

minLength: 1

Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja geograficzna, w której znajduje się zasób

properties.links True

ContactProfileLink[]

Linki profilu kontaktu. Opisuje łącza RF, przetwarzanie modemów i punkty końcowe ip.

properties.networkConfiguration True

NetworkConfiguration

Konfiguracja sieciowa sieci wirtualnej klienta.

properties.autoTrackingConfiguration

AutoTrackingConfiguration

Konfiguracja automatycznego śledzenia.

properties.eventHubUri

string

Identyfikator zasobu usługi ARM centrum zdarzeń używany do telemetrii. Wymaga przyznania dostawcy zasobów orbitalnych prawa do wysyłania danych telemetrycznych do koncentratora.

properties.minimumElevationDegrees

number

Minimalna opłacalna wysokość kontaktu w stopniach dziesiętnych. Służy do wyświetlania listy dostępnych kontaktów z statkiem kosmicznym na danej stacji naziemnej.

properties.minimumViableContactDuration

string

Minimalny możliwy czas trwania kontaktu w formacie ISO 8601. Służy do wyświetlania listy dostępnych kontaktów z statkiem kosmicznym na danej stacji naziemnej.

properties.provisioningState

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Konfiguracja misji innej firmy w profilu kontaktowym. Opisuje łącza RF, przetwarzanie modemów i punkty końcowe ip.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

ContactProfile

Aktualizacja powiodła się. Operacja zwraca wynikowy zasób ContactProfile.

201 Created

ContactProfile

Tworzenie powiodło się. Operacja zwraca wynikowy zasób ContactProfile.

Nagłówki

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Przykłady

Create a contact profile

Przykładowe żądanie

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"
            }
          }
        ]
      }
    ]
  }
}

Przykładowa odpowiedź

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
          }
        ]
      }
    ]
  }
}

Definicje

Nazwa Opis
AutoTrackingConfiguration

Konfiguracja automatycznego śledzenia.

ContactProfile

Klient tworzy zasób profilu kontaktu, który będzie zawierać wszystkie konfiguracje wymagane do planowania kontaktu.

ContactProfileLink

Link profilu kontaktu.

ContactProfileLinkChannel

Kanał linku profilu kontaktu.

ContactProfileThirdPartyConfiguration

Skontaktuj się z konfiguracją partnera innej firmy.

createdByType

Typ tożsamości, która utworzyła zasób.

direction

Kierunek (pasma lub odsuń).

EndPoint

Punkt końcowy klienta do przechowywania i pobierania danych podczas kontaktu ze statkiem kosmicznym.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

ErrorDetail

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd

NetworkConfiguration

Konfiguracja sieciowa sieci wirtualnej klienta.

polarization

Polaryzacji. np. (RHCP, LHCP).

protocol

Protokół UDP lub TCP.

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

AutoTrackingConfiguration

Konfiguracja automatycznego śledzenia.

Wartość Opis
disabled
sBand
xBand

ContactProfile

Klient tworzy zasób profilu kontaktu, który będzie zawierać wszystkie konfiguracje wymagane do planowania kontaktu.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Lokalizacja geograficzna, w której znajduje się zasób

name

string

Nazwa zasobu

properties.autoTrackingConfiguration

AutoTrackingConfiguration

Konfiguracja automatycznego śledzenia.

properties.eventHubUri

string

Identyfikator zasobu usługi ARM centrum zdarzeń używany do telemetrii. Wymaga przyznania dostawcy zasobów orbitalnych prawa do wysyłania danych telemetrycznych do koncentratora.

properties.links

ContactProfileLink[]

Linki profilu kontaktu. Opisuje łącza RF, przetwarzanie modemów i punkty końcowe ip.

properties.minimumElevationDegrees

number

Minimalna opłacalna wysokość kontaktu w stopniach dziesiętnych. Służy do wyświetlania listy dostępnych kontaktów z statkiem kosmicznym na danej stacji naziemnej.

properties.minimumViableContactDuration

string

Minimalny możliwy czas trwania kontaktu w formacie ISO 8601. Służy do wyświetlania listy dostępnych kontaktów z statkiem kosmicznym na danej stacji naziemnej.

properties.networkConfiguration

NetworkConfiguration

Konfiguracja sieciowa sieci wirtualnej klienta.

properties.provisioningState

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Konfiguracja misji innej firmy w profilu kontaktowym. Opisuje łącza RF, przetwarzanie modemów i punkty końcowe ip.

systemData

systemData

Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

Link profilu kontaktu.

Nazwa Typ Opis
channels

ContactProfileLinkChannel[]

Kanał linku profilu kontaktu.

direction

direction

Kierunek (pasma lub odsuń).

eirpdBW

number

Efektywna moc promieniowana izotropowa (EIRP) w dBW. Jest to wymagany EIRP przez klienta. Jeszcze nie użyto.

gainOverTemperature

number

Zyskaj temperaturę szumu w db/K. Jest to wymagane przez klienta G/T. Jeszcze nie użyto.

name

string

Nazwa łącza.

polarization

polarization

Polaryzacji. np. (RHCP, LHCP).

ContactProfileLinkChannel

Kanał linku profilu kontaktu.

Nazwa Typ Opis
bandwidthMHz

number

Przepustowość w MHz.

centerFrequencyMHz

number

Częstotliwość wyśrodkowania w MHz.

decodingConfiguration

string

Obecnie nieużywane.

demodulationConfiguration

string

Kopia pliku konfiguracji modemu, takiego jak Kratos QRadio lub Kratos QuantumRx. Prawidłowe tylko dla wskazówek pasma do dołu. Jeśli tak, modem łączy się z punktem końcowym klienta i wysyła zdegradowane dane zamiast strumienia VITA.49.

encodingConfiguration

string

Obecnie nieużywane.

endPoint

EndPoint

Punkt końcowy klienta do przechowywania i pobierania danych podczas kontaktu ze statkiem kosmicznym.

modulationConfiguration

string

Kopia pliku konfiguracji modemu, takiego jak Kratos QRadio. Prawidłowe tylko dla wskazówek pasma. Jeśli zostanie podany, modem łączy się z punktem końcowym klienta i akceptuje polecenia od klienta zamiast strumienia VITA.49.

name

string

Nazwa kanału.

ContactProfileThirdPartyConfiguration

Skontaktuj się z konfiguracją partnera innej firmy.

Nazwa Typ Opis
missionConfiguration

string

Nazwa ciągu odwołującego się do konfiguracji opisującej konfigurację kontaktu skonfigurowaną dla określonej misji. Oczekiwane wartości to te, które zostały utworzone we współpracy z siecią partnerów.

providerName

string

Nazwa dostawcy innej firmy.

createdByType

Typ tożsamości, która utworzyła zasób.

Wartość Opis
Application
Key
ManagedIdentity
User

direction

Kierunek (pasma lub odsuń).

Wartość Opis
Downlink
Uplink

EndPoint

Punkt końcowy klienta do przechowywania i pobierania danych podczas kontaktu ze statkiem kosmicznym.

Nazwa Typ Opis
endPointName

string

Nazwa punktu końcowego.

ipAddress

string

Adres IP (IPv4).

port

string

Port TCP do nasłuchiwania w celu odbierania danych.

protocol

protocol

Protokół UDP lub TCP.

ErrorAdditionalInfo

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

Szczegóły błędu.

Nazwa Typ Opis
additionalInfo

ErrorAdditionalInfo[]

Dodatkowe informacje o błędzie.

code

string

Kod błędu.

details

ErrorDetail[]

Szczegóły błędu.

message

string

Komunikat o błędzie.

target

string

Element docelowy błędu.

ErrorResponse

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt błędu.

NetworkConfiguration

Konfiguracja sieciowa sieci wirtualnej klienta.

Nazwa Typ Opis
subnetId

string

Identyfikator zasobu usługi ARM podsieci delegowanej do bramy Microsoft.Orbital/orbitalGateways. Musi być co najmniej podsiecią klasy C i nie powinna mieć w niej żadnego adresu IP.

polarization

Polaryzacji. np. (RHCP, LHCP).

Wartość Opis
LHCP
RHCP
linearHorizontal
linearVertical

protocol

Protokół UDP lub TCP.

Wartość Opis
TCP
UDP

ProvisioningState

Bieżący stan tworzenia, usuwania lub modyfikacji zasobu.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string (date-time)

Sygnatura czasowa tworzenia zasobu (UTC).

createdBy

string

Tożsamość, która utworzyła zasób.

createdByType

createdByType

Typ tożsamości, która utworzyła zasób.

lastModifiedAt

string (date-time)

Znacznik czasu ostatniej modyfikacji zasobu (UTC)

lastModifiedBy

string

Tożsamość, która ostatnio zmodyfikowała zasób.

lastModifiedByType

createdByType

Typ tożsamości, która ostatnio zmodyfikowała zasób.