REST Resource: customers.deployments.devices

리소스: 기기

JSON 표현 
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string,
  "deviceMetadata": {
    object (DeviceMetadata)
  },
  "currentChannels": [
    {
      object (ChannelWithScore)
    }
  ],
  "grantRangeAllowlists": [
    {
      object (FrequencyRange)
    }
  ]
}
필드
name

string

출력 전용입니다. 리소스 경로 이름입니다.
fccId

string

기기의 FCC 식별자입니다.
serialNumber

string

기기 제조업체에서 기기에 할당한 일련번호입니다.
preloadedConfig

object (DeviceConfig)

SAS 포털 API를 통해 지정된 기기 구성입니다.
activeConfig

object (DeviceConfig)

출력 전용입니다. SAS에 등록된 기기의 현재 구성입니다.
state

enum (State)

출력 전용입니다. 기기 상태입니다.
grants[]

object (DeviceGrant)

출력 전용입니다. 기기에서 보유한 권한입니다.
displayName

string

기기 표시 이름입니다.
deviceMetadata

object (DeviceMetadata)

SAS 포털과 SAS 등록 요청 모두에서 재정의할 수 있는 기기 매개변수입니다.
currentChannels[]
(deprecated)

object (ChannelWithScore)

출력 전용입니다. 점수가 있는 현재 채널입니다.
grantRangeAllowlists[]

object (FrequencyRange)

허용 목록에 있는 범위만 새 권한 부여에 사용할 수 있습니다.

DeviceConfig

기기 구성에 관한 정보입니다.

JSON 표현 
{
  "category": enum (DeviceCategory),
  "model": {
    object (DeviceModel)
  },
  "airInterface": {
    object (DeviceAirInterface)
  },
  "installationParams": {
    object (InstallationParams)
  },
  "measurementCapabilities": [
    enum (MeasurementCapability)
  ],
  "userId": string,
  "callSign": string,
  "state": enum (State),
  "isSigned": boolean,
  "updateTime": string
}
필드
category

enum (DeviceCategory)

기기의 FCC 카테고리입니다.
model

object (DeviceModel)

이 기기 모델에 관한 정보입니다.
airInterface

object (DeviceAirInterface)

이 기기의 무선 인터페이스에 관한 정보입니다.
installationParams

object (InstallationParams)

기기의 설치 매개변수입니다.
measurementCapabilities[]

enum (MeasurementCapability)

기기의 측정 보고 기능입니다.
userId

string

기기 사용자의 식별자입니다.
callSign

string

기기 운영자의 호출 부호입니다.
state

enum (State)

구성의 상태입니다.
isSigned

boolean

출력 전용입니다. 구성의 서명이 CPI에 의해 이루어졌는지 여부입니다.
updateTime

string (Timestamp format)

출력 전용입니다. 기기 구성이 마지막으로 수정된 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

DeviceCategory

파트 96에 정의된 기기의 FCC 카테고리입니다.

열거형
DEVICE_CATEGORY_UNSPECIFIED 지정되지 않은 기기 카테고리입니다.
DEVICE_CATEGORY_A 카테고리 A
DEVICE_CATEGORY_B 카테고리 B

DeviceModel

기기 모델에 관한 정보입니다.

JSON 표현 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
필드
vendor

string

기기 공급업체의 이름입니다.
name

string

기기 모델의 이름입니다.
softwareVersion

string

기기의 소프트웨어 버전입니다.
hardwareVersion

string

기기의 하드웨어 버전입니다.
firmwareVersion

string

기기의 펌웨어 버전입니다.

DeviceAirInterface

기기의 무선 인터페이스에 관한 정보입니다.

JSON 표현 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
필드
radioTechnology

enum (RadioTechnology)

조건부 이 필드는 CBSD에 사용되는 무선 액세스 기술을 지정합니다.
supportedSpec

string

선택사항입니다. 이 필드는 radioTechnology와 관련이 있으며 CBSD가 등록 시 준수하는 무선 인터페이스 사양을 제공합니다.

RadioTechnology

승인된 무선 액세스 기술 유형입니다.

열거형
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
CW
REDLINE
TARANA_WIRELESS

InstallationParams

기기 설치 매개변수에 관한 정보입니다.

JSON 표현 
{
  "latitude": number,
  "longitude": number,
  "height": number,
  "heightType": enum (HeightType),
  "horizontalAccuracy": number,
  "verticalAccuracy": number,
  "indoorDeployment": boolean,
  "antennaAzimuth": integer,
  "antennaDowntilt": integer,
  "antennaGain": integer,
  "eirpCapability": integer,
  "antennaBeamwidth": integer,
  "antennaModel": string,
  "cpeCbsdIndication": boolean
}
필드
latitude

number

WGS 84 기준에 대한 기기 안테나 위치의 위도(도)입니다. 허용되는 범위는 -90.000000~+90.000000입니다. 양수 값은 적도 북쪽의 위도를 나타내고 음수 값은 적도 남쪽의 위도를 나타냅니다.
longitude

number

WGS 84 기준점에 대한 기기 안테나 위치의 경도(단위: 도)입니다. 허용되는 범위는 -180.000000~+180.000000입니다. 양수 값은 본초자오선 동쪽의 경도를 나타내고 음수 값은 본초자오선 서쪽의 경도를 나타냅니다.
height

number

기기 안테나 높이(미터)입니다. heightType 매개변수 값이 'AGL'인 경우 안테나 높이는 지면을 기준으로 지정해야 합니다. heightType 매개변수 값이 'AMSL'인 경우 WGS84 기준점을 기준으로 제공됩니다.
heightType

enum (HeightType)

높이를 측정하는 방법을 지정합니다.
horizontalAccuracy

number

기기 안테나의 수평 위치 정확도를 나타내는 양수(단위: 미터)입니다. 이 선택적 매개변수는 값이 FCC 요구사항인 50미터보다 작은 경우에만 있어야 합니다.
verticalAccuracy

number

기기 안테나의 수직 위치 정확도를 나타내는 양수(미터)입니다. 이 선택적 매개변수는 값이 FCC 요구사항인 3미터보다 작은 경우에만 있어야 합니다.
indoorDeployment

boolean

기기 안테나가 실내에 있는지 여부입니다. true: 실내 false: 실외
antennaAzimuth

integer

안테나의 수평면의 보어사이트 방향(진북 기준, 단위: 도)입니다. 이 매개변수의 값은 0~359 사이의 정수입니다. 0도는 진북을 의미하고 90도는 동쪽을 의미합니다. 이 매개변수는 카테고리 A 기기에는 선택사항이고 카테고리 B 기기에는 조건부입니다.
antennaDowntilt

integer

안테나 다운틸트(단위: 도)이며 -90~+90 사이의 정수입니다. 음수 값은 안테나가 위쪽(수평 위)으로 기울어져 있음을 의미합니다. 이 매개변수는 카테고리 A 기기에는 선택사항이고 카테고리 B 기기에는 조건부입니다.
antennaGain

integer

dBi 단위의 최대 안테나 이득입니다. 이 매개변수는 -127~+128 (dBi) 사이의 값을 갖는 정수입니다.
eirpCapability

integer

이 매개변수는 dBm/10MHz 단위의 최대 기기 EIRP이며 -127~+47 (dBm/10MHz) 사이의 정수입니다. 포함되지 않은 경우 SAS는 기기 카테고리에 허용되는 최대 EIRP를 dBm/10MHz 단위로 해석합니다.
antennaBeamwidth

integer

안테나의 3dB 안테나 빔폭(수평면, 도)입니다. 이 매개변수는 0~360 (도) 범위의 값을 갖는 부호 없는 정수입니다. 카테고리 A 기기에서는 선택사항이고 카테고리 B 기기에서는 조건부입니다.
antennaModel

string

외부 안테나를 사용하는 경우 안테나 모델이 이 필드에 선택적으로 제공됩니다. 문자열의 최대 길이는 128옥텟입니다.
cpeCbsdIndication

boolean

이 매개변수가 있으면 CBSD가 CPE-CBSD인지 여부를 지정합니다.

HeightType

높이를 측정하는 방법을 지정합니다.

열거형
HEIGHT_TYPE_UNSPECIFIED 지정되지 않은 높이 유형입니다.
HEIGHT_TYPE_AGL AGL 높이는 지상 높이를 기준으로 측정됩니다.
HEIGHT_TYPE_AMSL AMSL 높이는 평균 해수면을 기준으로 측정됩니다.

MeasurementCapability

기기 측정 기능입니다. 값은 WINNF-SSC-0002에 의해 정의됩니다.

열거형
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

주

기기 구성의 상태입니다. 상태가 DEVICE_CONFIG_STATE_FINAL인 구성만 CBSD 등록 중에 사용할 수 있습니다.

열거형
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

주

기기 상태입니다.

열거형
DEVICE_STATE_UNSPECIFIED 지정되지 않은 상태.
RESERVED SAS 포털에서 기기가 생성되었지만 아직 SAS에 등록되지 않았습니다.
REGISTERED 기기가 SAS에 등록되었습니다.
DEREGISTERED SAS에서 기기가 등록 해제되었습니다.

DeviceGrant

기기 부여 기기가 하트비트를 성공적으로 수행한 후 지정된 작동 매개변수를 사용하여 전송하도록 스펙트럼 액세스 시스템에서 기기에 제공하는 승인입니다.

JSON 표현 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string,
  "suspensionReason": [
    string
  ],
  "grantId": string,
  "lastHeartbeatTransmitExpireTime": string
}
필드
maxEirp

number

허가에 의해 허용되는 최대 등가 등방성 복사 전력 (EIRP)입니다. 최대 EIRP는 dBm/MHz 단위입니다. maxEirp 값은 FCC 파트 96.41 (e)(3)에 정의된 절차에 따라 측정되는 평균(RMS) EIRP를 나타냅니다.
frequencyRange

object (FrequencyRange)

전송 주파수 범위입니다.
state

enum (GrantState)

권한의 상태입니다.
channelType

enum (ChannelType)

사용된 채널 유형입니다.
moveList[]

object (DpaMoveList)

이 권한이 표시되는 DPA 이동 목록입니다.
expireTime

string (Timestamp format)

권한 부여의 만료 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.
suspensionReason[]

string

권한이 정지된 경우 정지 이유입니다.
grantId

string

권한 부여 ID입니다.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

마지막 하트비트의 전송 만료 시간입니다.

RFC3339 UTC 'Zulu' 형식의 타임스탬프입니다(나노초 단위, 소수점 이하 9자리). 예를 들면 "2014-10-02T15:01:23Z" 및 "2014-10-02T15:01:23.045123456Z"입니다.

FrequencyRange

주파수 범위: low_frequency~high_frequency

JSON 표현 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
필드
lowFrequencyMhz

number

주파수 범위의 최저 주파수(MHz)입니다.
highFrequencyMhz

number

주파수 범위의 최고 주파수(MHz)입니다.

GrantState

권한의 상태입니다.

열거형
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED 권한이 부여되었지만 기기에서 하트비트를 전송하지 않습니다.
GRANT_STATE_TERMINATED SAS에 의해 권한 부여가 종료되었습니다.
GRANT_STATE_SUSPENDED SAS에 의해 승인이 정지되었습니다.
GRANT_STATE_AUTHORIZED 현재 기기가 전송 중입니다.
GRANT_STATE_EXPIRED 권한이 만료되었습니다.

ChannelType

열거형
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

DPA의 이동 목록에 있는 항목입니다.

JSON 표현 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
필드
dpaId

string

DPA의 ID입니다.
frequencyRange

object (FrequencyRange)

이동 목록이 영향을 미치는 주파수 범위입니다.

DeviceMetadata

SAS Portal과 등록 요청 모두에서 재정의할 수 있는 기기 데이터

JSON 표현 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
필드
interferenceCoordinationGroup

string

간섭 조정 그룹 (ICG) 그룹과의 간섭을 자체적으로 관리하는 CBSD 그룹입니다. 자세한 내용은 CBRSA-TS-2001 V3.0.0을 참고하세요.
commonChannelGroup

string

공통 채널 그룹 (CCG) 동일한 ICG에 속하며 공통 기본 채널 할당을 요청하는 CBSD 그룹 자세한 내용은 CBRSA-TS-2001 V3.0.0을 참고하세요.
antennaModel

string

채워진 경우 사용할 안테나 모델 패턴입니다. 형식은 RecordCreatorId:PatternId입니다.
nrqzValidated
(deprecated)

boolean

출력 전용입니다. CPI가 National Quiet Zone 사무실과 협력했음을 확인한 경우 true로 설정합니다.
nrqzValidation

object (NrqzValidation)

출력 전용입니다. 국가 무선 저소음 구역 유효성 검사 정보입니다.

NrqzValidation

국립 전파 금지 구역 검증에 관한 정보입니다.

JSON 표현 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
필드
state

enum (State)

NRQZ 검증 정보의 상태입니다.
caseId

string

유효성 검사 케이스 ID입니다.
latitude

number

유효성 검사와 연결된 기기 위도입니다.
longitude

number

유효성 검사와 연결된 기기 위도입니다.
cpiId

string

유효성 검사에 서명한 CPI입니다.

주

NRQZ 검증 정보의 상태입니다.

열거형
STATE_UNSPECIFIED 지정되지 않은 상태.
DRAFT 초안 상태입니다.
FINAL 최종 상태입니다.

ChannelWithScore

점수가 있는 채널입니다.

JSON 표현 
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
필드
frequencyRange

object (FrequencyRange)

채널의 주파수 범위입니다.
score

number

채널 점수입니다. [0, 100] 범위로 정규화됩니다.

메서드

create

 node 또는 customer 아래에 device를 만듭니다.

createSigned

 node 또는 customer 아래에 서명된 device를 만듭니다.

list

 node 또는 customer 아래의 devices를 나열합니다.