REST Resource: customers.deployments.devices

資源：Device

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 ID。
serialNumber

string

裝置製造商指派給裝置的序號。
preloadedConfig

object (DeviceConfig)

透過 SAS Portal 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

裝置使用者的 ID。
callSign

string

裝置業者的呼叫符號。
state

enum (State)

設定的狀態。
isSigned

boolean

僅供輸出。設定是否已透過 CPI 簽署。
updateTime

string (Timestamp format)

僅供輸出。上次編輯裝置設定的時間。

RFC3339 UTC 的「Zulu」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例："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：

裝置型號

裝置型號的相關資訊。

JSON 表示法 
{
  "vendor": string,
  "name": string,
  "softwareVersion": string,
  "hardwareVersion": string,
  "firmwareVersion": string
}
欄位
vendor

string

裝置供應商的名稱。
name

string

裝置型號名稱。
softwareVersion

string

裝置的軟體版本。
hardwareVersion

string

裝置的硬體版本。
firmwareVersion

string

裝置的韌體版本。

裝置空氣介面

裝置空氣介面的相關資訊。

JSON 表示法 
{
  "radioTechnology": enum (RadioTechnology),
  "supportedSpec": string
}
欄位
radioTechnology

enum (RadioTechnology)

條件式。這個欄位會指定 CBSD 所用的無線電存取技術。
supportedSpec

string

選用，這個欄位與 radioTechnology 相關，並提供註冊時 CBSD 符合的空氣介面規格。

無線電技術

已獲得核准的無線電存取技術類型。

列舉
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

以公尺為單位表示裝置天線垂直位置的準確度。只有在選用值小於 3 公尺的 FCC 規定時，才需要顯示這個選用參數。
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 的單位裝置最高 IIRP，其值為介於 -127 和 +47 (dBm/10 MHz) 之間的整數。如果沒有納入，SAS 會將該裝置視為裝置類別允許的上限 EdRP (dBm/10MHz)。
antennaBeamwidth

integer

水平面上天線的天線 3 dB 光度，單位為度。這個參數是介於 0 和 360 (包含) 之間的不帶正負號整數，適用 A 類裝置和類別 B 裝置條件。
antennaModel

string

如果使用外部天線，這個欄位中會提供天線模型。字串長度上限為 128 個八位元組。
cpeCbsdIndication

boolean

如果有，此參數會指定 CBSD 是否為 CPE-CBSD。

高度類型

指定高度的測量方式。

列舉
HEIGHT_TYPE_UNSPECIFIED 未指定高度類型。
HEIGHT_TYPE_AGL AGL 高度是根據地面測量的測量值。
HEIGHT_TYPE_AMSL AMSL 高度是根據平均海拔測量而得。

評估功能

裝置測量功能。這些值是由 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 取消註冊。

裝置授權

裝置授權。可讓「頻譜存取系統」為裝置提供的授權，在裝置成功產生心跳後，透過指定的作業參數進行傳輸。

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」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。
suspensionReason[]

string

如果帳戶遭到停權，停權的原因。
grantId

string

授權 ID
lastHeartbeatTransmitExpireTime

string (Timestamp format)

上次活動訊號的傳輸時間到期時間。

RFC3339 UTC 的「Zulu」格式時間戳記，單位為奈秒解析度，最多可達九位數。範例："2014-10-02T15:01:23Z" 和 "2014-10-02T15:01:23.045123456Z"。

頻率範圍

頻率範圍從 low_frequency 到 high_frequency。

JSON 表示法 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
欄位
lowFrequencyMhz

number

頻率範圍的最低頻率 (以 MHz 為單位)。
highFrequencyMhz

number

頻率範圍的最高頻率 (以 MHz 為單位)。

授權州

授權狀態。

列舉
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED 已授予權限，但裝置目前沒有跳動。
GRANT_STATE_TERMINATED SAS 已終止授權。
GRANT_STATE_SUSPENDED SAS 已遭停權。
GRANT_STATE_AUTHORIZED 裝置目前正在傳輸中。
GRANT_STATE_EXPIRED 授權已過期。

頻道類型

列舉
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

DPA' 移動清單中的項目。

JSON 表示法 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
欄位
dpaId

string

DPA 的 ID。
frequencyRange

object (FrequencyRange)

移動清單會影響的頻率範圍。

裝置中繼資料

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)

僅供輸出。美國國家無線電通訊區驗證資訊。

Nrqz 驗證

國家廣播電台安靜區驗證的相關資訊。

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

簽署驗證的單次安裝出價。

狀態

NRQZ 驗證資訊的狀態。

列舉
STATE_UNSPECIFIED 未指定狀態。
DRAFT 草稿狀態。
FINAL 最終狀態。

頻道分數

含有分數的頻道。

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。