REST Resource: customers.devices

リソース: デバイス

JSON 表現 
{
  "name": string,
  "fccId": string,
  "serialNumber": string,
  "preloadedConfig": {
    object (DeviceConfig)
  },
  "activeConfig": {
    object (DeviceConfig)
  },
  "state": enum (State),
  "grants": [
    {
      object (DeviceGrant)
    }
  ],
  "displayName": string
}
フィールド
name

string

出力のみ。リソースパス名。
fccId

string

デバイスの FCC 識別子。
serialNumber

string

デバイスのメーカーがデバイスに割り当てるシリアル番号。
preloadedConfig

object (DeviceConfig)

デバイスの構成。SAS Portal API で指定します。
activeConfig

object (DeviceConfig)

出力のみ。SAS に登録されているデバイスの現在の構成。

state

enum (State)

出力のみ。デバイスの状態。

grants[]

object (DeviceGrant)

出力のみ。デバイスに保持されている権限。
displayName

string

デバイスの表示名。

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: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

このフィールドは無線技術フィールドに関連するフィールドで、登録時に CBSD が遵守している航空インターフェースの仕様を示します。

任意

放射線技術

承認されている無線アクセス技術のタイプ。

列挙型
RADIO_TECHNOLOGY_UNSPECIFIED
E_UTRA
CAMBIUM_NETWORKS
FOUR_G_BBW_SAA_1
NR
DOODLE_CBRS
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
}
フィールド
latitude

number

デバイスのアンテナ位置の緯度を、WGS 84 データに対する相対角度で表します。指定できる範囲は -90.000000 ～+90.000000 です。正の値は、赤道より北に位置する緯度、赤道より南にある緯度を表します。
longitude

number

デバイスのアンテナの位置の経度。WGS 84 データに対する相対角度。指定できる範囲は -180.000000 ～+180.000000 です。正の値は、本初子午線より東の経度を表し、負の値は本初子午線より西にあります。
height

number

デバイスのアンテナの高さ（メートル単位）。heightType パラメータ値が &At&; AGL" の場合、アンテナの高さは地面の相対値で指定します。heightType パラメータ値が &amt; AMSL" の場合、WGS84 データに対して指定されます。
heightType

enum (HeightType)

高さの測定方法を指定します。

horizontalAccuracy

number

デバイス アンテナの水平方向の精度を示す、メートル単位の正の数値です。このオプションのパラメータは、その値が FCC 要件の 50 m を下回った場合にのみ指定します。
verticalAccuracy

number

デバイス アンテナの垂直位置の精度を示す正数（メートル単位）。このオプションのパラメータは、その値が FCC 要件の 3 m より小さい場合にのみ指定する必要があります。
indoorDeployment

boolean

デバイスのアンテナが屋内かどうかを示します。正しい: 屋内。False: 屋外。
antennaAzimuth

integer

アンテナの水平面のボアサイト方向（真北に対する角度）。このパラメータの値は 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 オクテットです。

高さのタイプ

高さの測定方法を指定します。

列挙型
HEIGHT_TYPE_UNSPECIFIED 高さのタイプが指定されていません。
HEIGHT_TYPE_AGL AGL の高さは、地面の高さに対して測定されます。
HEIGHT_TYPE_AMSL AMSL の高さは、平均海面を基準にして測定されます。

MeasurementCapability

デバイス測定機能。値は [WINNF-SSC-0002] [https://winnf.memberclicks.net/assets/CBRS/WINNF-SSC-0002.pdf] によって定義されます。

列挙型
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

State

デバイスの状態。

列挙型
DEVICE_STATE_UNSPECIFIED 未指定の状態
RESERVED SAS Portal で作成されたデバイスがまだ SAS に登録されていない。
REGISTERED SAS に登録されているデバイス。
DEREGISTERED SAS から登録解除されたデバイス。

デバイス付与

デバイスの許可これは、デバイスがハートビートに成功した後に、指定動作パラメータを使用して送信するために Spectrum Access システムによってデバイスに付与される認可です。

JSON 表現 
{
  "maxEirp": number,
  "frequencyRange": {
    object (FrequencyRange)
  },
  "state": enum (GrantState),
  "channelType": enum (ChannelType),
  "moveList": [
    {
      object (DpaMoveList)
    }
  ],
  "expireTime": string
}
フィールド
maxEirp

number

アクセス許可によって許容される最大等価放射電力（EIRP）最大 EIRP は、dBm/MHz の単位です。maxEirp の値は、平均（RMS）EIRP を表し、FCC パート 96.41（e）（3）で定義される手順によって測定されます。
frequencyRange

object (FrequencyRange)

送信周波数範囲。
state

enum (GrantState)

付与の状態。
channelType

enum (ChannelType)

使用されたチャンネルの種類。
moveList[]

object (DpaMoveList)

この付与が表示されている DPA Move リスト。

expireTime

string (Timestamp format)

付与の有効期限。

RFC3339 UTC「Zulu」形式のタイムスタンプ。精度はナノ秒（例: "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)

移動リストが影響を与える頻度の範囲。

Methods

create

 node または customer の下に device を作成します。

createSigned

 node または customer の下に署名付き device を作成します。

delete

 device を削除します。

get

 device に関する詳細を取得します。

list

 node または customer の devices を一覧表示します。

move

 device を別の node または customer の下に移動します。

patch

 device を更新します。

signDevice

 device に署名します。

updateSigned

 署名付きの device を更新します。