Spacecrafts - List Available Contacts
사용 가능한 연락처 목록을 반환합니다. 접점 프로필에 제공된 최소 실행 가능한 접촉 기간 이상 동안 우주선이 지상국에서 표시되는 경우 연락처를 사용할 수 있습니다.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Orbital/spacecrafts/{spacecraftName}/listAvailableContacts?api-version=2022-11-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
리소스 그룹의 이름. 이름은 대소문자를 구분하지 않습니다. |
spacecraft
|
path | True |
string |
우주선 ID입니다. |
subscription
|
path | True |
string |
대상 구독의 ID입니다. |
api-version
|
query | True |
string |
이 작업에 사용할 API 버전입니다. |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
contactProfile | True |
연락처 프로필 리소스에 대한 참조입니다. |
|
endTime | True |
string |
연락처 종료 시간(ISO 8601 UTC 표준). |
groundStationName | True |
string |
Azure Ground Station의 이름입니다. |
startTime | True |
string |
연락처의 시작 시간(ISO 8601 UTC 표준). |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
요청이 성공했습니다. 작업은 사용 가능한 연락처 리소스 목록을 반환합니다. |
|
202 Accepted |
수락되고 작업이 비동기적으로 완료됩니다. 헤더 Location: string |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. 리소스 그룹이 없으면 404(NotFound)가 반환됩니다. |
예제
List of Contact
샘플 요청
POST https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/listAvailableContacts?api-version=2022-11-01
{
"contactProfile": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/contactProfiles/CONTOSO-CP"
},
"groundStationName": "EASTUS2_0",
"startTime": "2022-11-01T11:30:00Z",
"endTime": "2022-11-02T11:30:00Z"
}
샘플 응답
Location: https://management.azure.com/Microsoft.Orbital/operationResults/4e2ffff7-b331-4fcb-ab11-b5fa49368188?api-version=2022-11-01
{
"value": [
{
"spacecraft": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT"
},
"groundStationName": "EASTUS2_0",
"properties": {
"maximumElevationDegrees": 26.617297,
"txStartTime": "2022-11-01T11:55:01Z",
"txEndTime": "2022-11-01T12:05:25Z",
"rxStartTime": "2022-11-01T11:55:01Z",
"rxEndTime": "2022-11-01T12:05:25Z",
"startAzimuthDegrees": 201.340472,
"endAzimuthDegrees": 330.489627,
"startElevationDegrees": 5,
"endElevationDegrees": 5.040625
}
},
{
"spacecraft": {
"id": "/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT"
},
"groundStationName": "EASTUS2_0",
"properties": {
"maximumElevationDegrees": 85.9796,
"txStartTime": "2022-11-02T10:58:30Z",
"txEndTime": "2022-11-02T11:10:45Z",
"rxStartTime": "2022-11-02T10:58:30Z",
"rxEndTime": "2022-11-02T11:10:45Z",
"startAzimuthDegrees": 165.758896,
"endAzimuthDegrees": 345.848482,
"startElevationDegrees": 5,
"endElevationDegrees": 5.048656
}
}
],
"nextLink": "https://management.azure.com/subscriptions/c1be1141-a7c9-4aac-9608-3c2e2f1152c3/resourceGroups/contoso-Rgp/providers/Microsoft.Orbital/spacecrafts/CONTOSO_SAT/listAvailableContacts?api-version=2022-11-01&$skiptoken=opaqueString"
}
정의
Name | Description |
---|---|
Authorized |
권한 있는 접지. |
Auto |
자동 추적 구성. |
Available |
고객은 우주선 리소스에 사용할 수 있는 연락처 목록을 검색합니다. 나중에 사용 가능한 연락처 중 하나를 선택하여 연락처를 만들 수 있습니다. |
Available |
ListAvailableContacts API 서비스 호출에 대한 응답입니다. |
Contact |
연락처 리소스를 정의하는 매개 변수입니다. |
Contact |
연락처 프로필 리소스에 대한 참조입니다. |
Contact |
고객은 연락처 예약에 필요한 모든 구성을 포함하는 연락처 프로필 리소스를 만듭니다. |
Contact |
프로필 링크에 문의하세요. |
Contact |
프로필 링크 채널에 문의합니다. |
Contact |
리소스 만들기, 삭제 또는 수정의 현재 상태입니다. |
Contact |
프로필 타사 파트너 구성에 문의하세요. |
created |
리소스를 만든 ID의 형식입니다. |
direction |
방향(업링크 또는 다운링크). |
End |
우주선과 접촉하는 동안 데이터를 저장하고 검색하는 고객 엔드포인트입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Network |
고객 가상 네트워크의 네트워크 구성. |
polarization |
편광. 예: (RHCP, LHCP). |
protocol |
UDP 또는 TCP 프로토콜입니다. |
Provisioning |
리소스 만들기, 삭제 또는 수정의 현재 상태입니다. |
Spacecraft |
고객은 연락처를 예약하기 위해 우주선 리소스를 만듭니다. |
Spacecraft |
지상 기지당 승인된 우주선 링크 목록 및 권한 부여 만료 날짜입니다. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
AuthorizedGroundstation
권한 있는 접지.
Name | 형식 | Description |
---|---|---|
expirationDate |
string |
권한 부여 만료 날짜입니다. |
groundStation |
string |
그라운드스테이션 이름입니다. |
AutoTrackingConfiguration
자동 추적 구성.
Name | 형식 | Description |
---|---|---|
disabled |
string |
|
sBand |
string |
|
xBand |
string |
AvailableContacts
고객은 우주선 리소스에 사용할 수 있는 연락처 목록을 검색합니다. 나중에 사용 가능한 연락처 중 하나를 선택하여 연락처를 만들 수 있습니다.
Name | 형식 | Description |
---|---|---|
groundStationName |
string |
Azure Ground Station의 이름입니다. |
properties.endAzimuthDegrees |
number |
접촉 끝부분에 있는 안테나의 아지무스(10진수도)입니다. |
properties.endElevationDegrees |
number |
접촉 끝에 수평선 위의 우주선 고도. |
properties.maximumElevationDegrees |
number |
접촉 중 안테나의 최대 고도(10진수)입니다. |
properties.rxEndTime |
string |
신호 수신 손실 시간(ISO 8601 UTC 표준). |
properties.rxStartTime |
string |
신호를 받는 가장 빠른 시간(ISO 8601 UTC 표준). |
properties.startAzimuthDegrees |
number |
접촉 시작 시 안테나의 아지무스(10진수도)입니다. |
properties.startElevationDegrees |
number |
접촉 시작 시 수평선 위의 우주선 고도. |
properties.txEndTime |
string |
안테나 전송이 비활성화되는 시간(ISO 8601 UTC 표준). |
properties.txStartTime |
string |
안테나 전송이 활성화되는 시간(ISO 8601 UTC 표준). |
spacecraft |
우주선 리소스에 대한 참조입니다. |
AvailableContactsListResult
ListAvailableContacts API 서비스 호출에 대한 응답입니다.
Name | 형식 | Description |
---|---|---|
nextLink |
string |
다음 결과 집합을 가져올 URL입니다. |
value |
사용 가능한 연락처 목록입니다. |
ContactParameters
연락처 리소스를 정의하는 매개 변수입니다.
Name | 형식 | Description |
---|---|---|
contactProfile |
연락처 프로필 리소스에 대한 참조입니다. |
|
endTime |
string |
연락처 종료 시간(ISO 8601 UTC 표준). |
groundStationName |
string |
Azure Ground Station의 이름입니다. |
startTime |
string |
연락처의 시작 시간(ISO 8601 UTC 표준). |
ContactParameters.ContactProfile
연락처 프로필 리소스에 대한 참조입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스 ID입니다. |
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 |
채널 이름입니다. |
ContactProfilesProperties.ProvisioningState
리소스 만들기, 삭제 또는 수정의 현재 상태입니다.
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
리소스 만들기, 삭제 또는 수정의 현재 상태입니다.
Spacecraft
고객은 연락처를 예약하기 위해 우주선 리소스를 만듭니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
리소스가 있는 지리적 위치 |
name |
string |
리소스의 이름입니다. |
properties.links |
우주선 링크의 변경할 수없는 목록입니다. |
|
properties.noradId |
string |
우주선의 NORAD ID입니다. |
properties.provisioningState |
리소스 만들기, 삭제 또는 수정의 현재 상태입니다. |
|
properties.titleLine |
string |
TLE(2줄 요소 집합)의 제목 줄입니다. |
properties.tleLine1 |
string |
TLE(2줄 요소 집합)의 줄 1입니다. |
properties.tleLine2 |
string |
TLE(2줄 요소 집합)의 줄 2입니다. |
systemData |
createdBy 및 modifiedBy 정보가 포함된 Azure Resource Manager 메타데이터입니다. |
|
tags |
object |
리소스 태그. |
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
SpacecraftLink
지상 기지당 승인된 우주선 링크 목록 및 권한 부여 만료 날짜입니다.
Name | 형식 | Description |
---|---|---|
authorizations |
공인 지상국 |
|
bandwidthMHz |
number |
MHz의 대역폭입니다. |
centerFrequencyMHz |
number |
가운데 주파수(MHz)입니다. |
direction |
방향(업링크 또는 다운링크). |
|
name |
string |
링크 이름입니다. |
polarization |
편광. 예: (RHCP, LHCP). |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |