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

string

Nama Profil Kontak.

resourceGroupName
path True

string

Nama grup sumber daya. Nama tidak peka huruf besar/kecil.

subscriptionId
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

ContactProfileLink[]

Tautan Profil Kontak. Menjelaskan tautan RF, pemrosesan modem, dan titik akhir IP.

properties.networkConfiguration True

NetworkConfiguration

Konfigurasi jaringan jaringan virtual pelanggan.

properties.autoTrackingConfiguration

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

ProvisioningState

Status pembuatan, penghapusan, atau modifikasi sumber daya saat ini.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

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

ContactProfile

Pembaruan berhasil. Operasi mengembalikan sumber daya ContactProfile yang dihasilkan.

201 Created

ContactProfile

Buat keberhasilan. Operasi mengembalikan sumber daya ContactProfile yang dihasilkan.

Headers

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

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
AutoTrackingConfiguration

Konfigurasi pelacakan otomatis.

ContactProfile

Pelanggan membuat Sumber Daya Profil Kontak, yang akan berisi semua konfigurasi yang diperlukan untuk menjadwalkan kontak.

ContactProfileLink

Tautan Profil Kontak.

ContactProfileLinkChannel

Hubungi Saluran Tautan Profil.

ContactProfileThirdPartyConfiguration

Hubungi Konfigurasi mitra pihak ketiga Profil.

createdByType

Jenis identitas yang membuat sumber daya.

direction

Arah (Uplink atau Downlink).

EndPoint

Titik akhir pelanggan untuk menyimpan dan mengambil data selama kontak dengan pesawat ruang angkasa.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

NetworkConfiguration

Konfigurasi jaringan jaringan virtual pelanggan.

polarization

Polarisasi. misalnya (RHCP, LHCP).

protocol

Protokol baik UDP atau TCP.

ProvisioningState

Status pembuatan, penghapusan, atau modifikasi sumber daya saat ini.

systemData

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

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

ContactProfileLink[]

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

NetworkConfiguration

Konfigurasi jaringan jaringan virtual pelanggan.

properties.provisioningState

ProvisioningState

Status pembuatan, penghapusan, atau modifikasi sumber daya saat ini.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

Konfigurasi misi pihak ketiga dari Profil Kontak. Menjelaskan tautan RF, pemrosesan modem, dan titik akhir IP.

systemData

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"

Tautan Profil Kontak.

Nama Jenis Deskripsi
channels

ContactProfileLinkChannel[]

Hubungi Saluran Tautan Profil.

direction

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

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

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

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

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

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

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

createdByType

Jenis identitas yang terakhir mengubah sumber daya.