다음을 통해 공유


Contact Profiles - Create Or Update

연락처 프로필을 만들거나 업데이트합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
contactProfileName
path True

string

연락처 프로필 이름입니다.

resourceGroupName
path True

string

리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다.

subscriptionId
path True

string

대상 구독의 ID입니다.

api-version
query True

string

이 작업에 사용할 API 버전입니다.

요청 본문

Name 필수 형식 Description
location True

string

리소스가 있는 지리적 위치

properties.links True

ContactProfileLink[]

연락처 프로필의 링크입니다. RF 링크, 모뎀 처리 및 IP 엔드포인트에 대해 설명합니다.

properties.networkConfiguration True

NetworkConfiguration

고객 가상 네트워크의 네트워크 구성.

properties.autoTrackingConfiguration

AutoTrackingConfiguration

자동 추적 구성.

properties.eventHubUri

string

원격 분석에 사용되는 이벤트 허브의 ARM 리소스 식별자입니다. 궤도 리소스 공급자에게 원격 분석을 허브로 보낼 수 있는 권한을 부여해야 합니다.

properties.minimumElevationDegrees

number

접점의 최소 실행 가능한 권한 상승(10진수)입니다. 지정된 지상국에서 우주선과 사용 가능한 접점을 나열하는 데 사용됩니다.

properties.minimumViableContactDuration

string

ISO 8601 형식의 최소 실행 가능한 연락처 기간입니다. 지정된 지상국에서 우주선과 사용 가능한 접점을 나열하는 데 사용됩니다.

properties.provisioningState

ProvisioningState

리소스 생성, 삭제 또는 수정의 현재 상태입니다.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

연락처 프로필의 타사 임무 구성입니다. RF 링크, 모뎀 처리 및 IP 엔드포인트에 대해 설명합니다.

tags

object

리소스 태그.

응답

Name 형식 Description
200 OK

ContactProfile

업데이트에 성공했습니다. 이 작업은 결과 ContactProfile 리소스를 반환합니다.

201 Created

ContactProfile

만들기에 성공했습니다. 이 작업은 결과 ContactProfile 리소스를 반환합니다.

헤더

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

작업이 실패한 이유를 설명하는 오류 응답입니다.

예제

Create a contact profile

샘플 요청

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

샘플 응답

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

정의

Name Description
AutoTrackingConfiguration

자동 추적 구성.

ContactProfile

고객은 연락처를 예약하는 데 필요한 모든 구성을 포함하는 연락처 프로필 리소스를 만듭니다.

ContactProfileLink

프로필 링크에 문의하세요.

ContactProfileLinkChannel

프로필 링크 채널에 문의하세요.

ContactProfileThirdPartyConfiguration

프로필 타사 파트너 구성에 문의하세요.

createdByType

리소스를 만든 ID 유형입니다.

direction

방향(업링크 또는 다운링크).

EndPoint

우주선과 접촉하는 동안 데이터를 저장하고 검색하는 고객 엔드포인트입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

NetworkConfiguration

고객 가상 네트워크의 네트워크 구성.

polarization

편광. 예: (RHCP, LHCP).

protocol

UDP 또는 TCP 프로토콜.

ProvisioningState

리소스 생성, 삭제 또는 수정의 현재 상태입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

AutoTrackingConfiguration

자동 추적 구성.

Name 형식 Description
disabled

string

sBand

string

xBand

string

ContactProfile

고객은 연락처를 예약하는 데 필요한 모든 구성을 포함하는 연락처 프로필 리소스를 만듭니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

리소스가 있는 지리적 위치

name

string

리소스의 이름입니다.

properties.autoTrackingConfiguration

AutoTrackingConfiguration

자동 추적 구성.

properties.eventHubUri

string

원격 분석에 사용되는 이벤트 허브의 ARM 리소스 식별자입니다. 궤도 리소스 공급자에게 원격 분석을 허브로 보낼 수 있는 권한을 부여해야 합니다.

properties.links

ContactProfileLink[]

연락처 프로필의 링크입니다. RF 링크, 모뎀 처리 및 IP 엔드포인트에 대해 설명합니다.

properties.minimumElevationDegrees

number

접점의 최소 실행 가능한 권한 상승(10진수)입니다. 지정된 지상국에서 우주선과 사용 가능한 접점을 나열하는 데 사용됩니다.

properties.minimumViableContactDuration

string

ISO 8601 형식의 최소 실행 가능한 연락처 기간입니다. 지정된 지상국에서 우주선과 사용 가능한 접점을 나열하는 데 사용됩니다.

properties.networkConfiguration

NetworkConfiguration

고객 가상 네트워크의 네트워크 구성.

properties.provisioningState

ProvisioningState

리소스 생성, 삭제 또는 수정의 현재 상태입니다.

properties.thirdPartyConfigurations

ContactProfileThirdPartyConfiguration[]

연락처 프로필의 타사 임무 구성입니다. RF 링크, 모뎀 처리 및 IP 엔드포인트에 대해 설명합니다.

systemData

systemData

createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다.

tags

object

리소스 태그.

type

string

리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts"

프로필 링크에 문의하세요.

Name 형식 Description
channels

ContactProfileLinkChannel[]

프로필 링크 채널에 문의하세요.

direction

direction

방향(업링크 또는 다운링크).

eirpdBW

number

dBW의 EIRP(유효 이방성 방사력). 고객이 요구하는 EIRP입니다. 아직 사용되지 않았습니다.

gainOverTemperature

number

db/K의 노이즈 온도를 얻습니다. 고객이 요구하는 G/T입니다. 아직 사용되지 않았습니다.

name

string

링크 이름입니다.

polarization

polarization

편광. 예: (RHCP, LHCP).

ContactProfileLinkChannel

프로필 링크 채널에 문의하세요.

Name 형식 Description
bandwidthMHz

number

MHz의 대역폭입니다.

centerFrequencyMHz

number

가운데 주파수(MHz)입니다.

decodingConfiguration

string

현재 사용되지 않습니다.

demodulationConfiguration

string

Kratos QRadio 또는 Kratos QuantumRx와 같은 모뎀 구성 파일의 복사본입니다. 다운링크 방향에만 유효합니다. 제공된 경우 모뎀은 고객 엔드포인트에 연결하고 VITA.49 스트림 대신 강등된 데이터를 보냅니다.

encodingConfiguration

string

현재 사용되지 않습니다.

endPoint

EndPoint

우주선과 접촉하는 동안 데이터를 저장하고 검색하는 고객 엔드포인트입니다.

modulationConfiguration

string

Kratos QRadio와 같은 모뎀 구성 파일의 복사본입니다. 업링크 방향에만 유효합니다. 제공된 경우 모뎀은 고객 엔드포인트에 연결하고 VITA.49 스트림 대신 고객의 명령을 수락합니다.

name

string

채널 이름입니다.

ContactProfileThirdPartyConfiguration

프로필 타사 파트너 구성에 문의하세요.

Name 형식 Description
missionConfiguration

string

특정 임무에 대한 연락처 설정을 설명하는 구성을 참조하는 문자열의 이름입니다. 예상 값은 파트너 네트워크와 공동으로 생성된 값입니다.

providerName

string

타사 공급자의 이름입니다.

createdByType

리소스를 만든 ID 유형입니다.

Name 형식 Description
Application

string

Key

string

ManagedIdentity

string

User

string

direction

방향(업링크 또는 다운링크).

Name 형식 Description
Downlink

string

Uplink

string

EndPoint

우주선과 접촉하는 동안 데이터를 저장하고 검색하는 고객 엔드포인트입니다.

Name 형식 Description
endPointName

string

끝점의 이름입니다.

ipAddress

string

IP 주소(IPv4).

port

string

데이터를 수신 대기할 TCP 포트입니다.

protocol

protocol

UDP 또는 TCP 프로토콜.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

NetworkConfiguration

고객 가상 네트워크의 네트워크 구성.

Name 형식 Description
subnetId

string

Microsoft.Orbital/orbitalGateways에 위임된 서브넷의 ARM 리소스 식별자입니다. C 서브넷 클래스 이상이어야 하며 IP가 만들어지지 않아야 합니다.

polarization

편광. 예: (RHCP, LHCP).

Name 형식 Description
LHCP

string

RHCP

string

linearHorizontal

string

linearVertical

string

protocol

UDP 또는 TCP 프로토콜.

Name 형식 Description
TCP

string

UDP

string

ProvisioningState

리소스 생성, 삭제 또는 수정의 현재 상태입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID 유형입니다.

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.