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 |
---|---|---|---|---|
contact
|
path | True |
string |
연락처 프로필 이름입니다. |
resource
|
path | True |
string |
리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다. |
subscription
|
path | True |
string |
대상 구독의 ID입니다. |
api-version
|
query | True |
string |
이 작업에 사용할 API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
location | True |
string |
리소스가 있는 지리적 위치 |
properties.links | True |
연락처 프로필의 링크입니다. RF 링크, 모뎀 처리 및 IP 엔드포인트에 대해 설명합니다. |
|
properties.networkConfiguration | True |
고객 가상 네트워크의 네트워크 구성. |
|
properties.autoTrackingConfiguration |
자동 추적 구성. |
||
properties.eventHubUri |
string |
원격 분석에 사용되는 이벤트 허브의 ARM 리소스 식별자입니다. 궤도 리소스 공급자에게 원격 분석을 허브로 보낼 수 있는 권한을 부여해야 합니다. |
|
properties.minimumElevationDegrees |
number |
접점의 최소 실행 가능한 권한 상승(10진수)입니다. 지정된 지상국에서 우주선과 사용 가능한 접점을 나열하는 데 사용됩니다. |
|
properties.minimumViableContactDuration |
string |
ISO 8601 형식의 최소 실행 가능한 연락처 기간입니다. 지정된 지상국에서 우주선과 사용 가능한 접점을 나열하는 데 사용됩니다. |
|
properties.provisioningState |
리소스 생성, 삭제 또는 수정의 현재 상태입니다. |
||
properties.thirdPartyConfigurations |
연락처 프로필의 타사 임무 구성입니다. RF 링크, 모뎀 처리 및 IP 엔드포인트에 대해 설명합니다. |
||
tags |
object |
리소스 태그. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
업데이트에 성공했습니다. 이 작업은 결과 ContactProfile 리소스를 반환합니다. |
|
201 Created |
만들기에 성공했습니다. 이 작업은 결과 ContactProfile 리소스를 반환합니다. 헤더 Azure-AsyncOperation: string |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. |
예제
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 |
---|---|
Auto |
자동 추적 구성. |
Contact |
고객은 연락처를 예약하는 데 필요한 모든 구성을 포함하는 연락처 프로필 리소스를 만듭니다. |
Contact |
프로필 링크에 문의하세요. |
Contact |
프로필 링크 채널에 문의하세요. |
Contact |
프로필 타사 파트너 구성에 문의하세요. |
created |
리소스를 만든 ID 유형입니다. |
direction |
방향(업링크 또는 다운링크). |
End |
우주선과 접촉하는 동안 데이터를 저장하고 검색하는 고객 엔드포인트입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Network |
고객 가상 네트워크의 네트워크 구성. |
polarization |
편광. 예: (RHCP, LHCP). |
protocol |
UDP 또는 TCP 프로토콜. |
Provisioning |
리소스 생성, 삭제 또는 수정의 현재 상태입니다. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
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 |
자동 추적 구성. |
|
properties.eventHubUri |
string |
원격 분석에 사용되는 이벤트 허브의 ARM 리소스 식별자입니다. 궤도 리소스 공급자에게 원격 분석을 허브로 보낼 수 있는 권한을 부여해야 합니다. |
properties.links |
연락처 프로필의 링크입니다. RF 링크, 모뎀 처리 및 IP 엔드포인트에 대해 설명합니다. |
|
properties.minimumElevationDegrees |
number |
접점의 최소 실행 가능한 권한 상승(10진수)입니다. 지정된 지상국에서 우주선과 사용 가능한 접점을 나열하는 데 사용됩니다. |
properties.minimumViableContactDuration |
string |
ISO 8601 형식의 최소 실행 가능한 연락처 기간입니다. 지정된 지상국에서 우주선과 사용 가능한 접점을 나열하는 데 사용됩니다. |
properties.networkConfiguration |
고객 가상 네트워크의 네트워크 구성. |
|
properties.provisioningState |
리소스 생성, 삭제 또는 수정의 현재 상태입니다. |
|
properties.thirdPartyConfigurations |
연락처 프로필의 타사 임무 구성입니다. RF 링크, 모뎀 처리 및 IP 엔드포인트에 대해 설명합니다. |
|
systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
|
tags |
object |
리소스 태그. |
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
ContactProfileLink
프로필 링크에 문의하세요.
Name | 형식 | Description |
---|---|---|
channels |
프로필 링크 채널에 문의하세요. |
|
direction |
방향(업링크 또는 다운링크). |
|
eirpdBW |
number |
dBW의 EIRP(유효 이방성 방사력). 고객이 요구하는 EIRP입니다. 아직 사용되지 않았습니다. |
gainOverTemperature |
number |
db/K의 노이즈 온도를 얻습니다. 고객이 요구하는 G/T입니다. 아직 사용되지 않았습니다. |
name |
string |
링크 이름입니다. |
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 |
우주선과 접촉하는 동안 데이터를 저장하고 검색하는 고객 엔드포인트입니다. |
|
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 |
UDP 또는 TCP 프로토콜. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
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 |
리소스를 만든 ID 유형입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |