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，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

DeviceCategory

设备的 FCC 类别，如第 96 部分所定义。

枚举
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 和 359）之间的整数。0 度表示正北，90 度表示正东。对于 A 类设备，此形参是可选的；对于 B 类设备，此形参是条件形参。
antennaDowntilt

integer

天线俯仰角（以度为单位），是一个介于 -90 到 +90（含）之间的整数；负值表示天线向上倾斜（高于水平位置）。对于 A 类设备，此形参是可选的；对于 B 类设备，此形参是条件形参。
antennaGain

integer

天线峰值增益（以 dBi 为单位）。此参数是一个整数，其值介于 -127 到 +128（含）之间（单位为 dBi）。
eirpCapability

integer

此参数是设备的最大 EIRP，以 dBm/10MHz 为单位，是一个介于 -127 到 +47（含）之间的整数值（单位为 dBm/10 MHz）。如果未包含，SAS 会将其解读为设备类别的最大允许 EIRP（单位为 dBm/10MHz）。
antennaBeamwidth

integer

天线在水平面内的 3 dB 天线波束宽度（以度为单位）。此形参是一个无符号整数，其值介于 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

州

设备配置的状态。在 CBSD 注册期间，只能使用状态为 DEVICE_CONFIG_STATE_FINAL 的配置。

枚举
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，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
suspensionReason[]

string

如果许可被中止，则为中止原因。
grantId

string

授权 ID。
lastHeartbeatTransmitExpireTime

string (Timestamp format)

上次检测信号的传输到期时间。

时间戳采用 RFC3339 世界协调时间（UTC，即“祖鲁时”）格式，精确到纳秒，最多九个小数位。示例："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 已验证其与国家静区办公室进行了协调，则设置为 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。