REST Resource: customers.devices

リソース: Device

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

デバイスユーザーの識別子。
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

このフィールドは radioTechnology フィールドに関連しており、登録時に CBSD が準拠している無線インターフェース仕様を提供します。

省略可

RadioTechnology

承認された無線アクセス技術の種類。

列挙型
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 パラメータの値が「AGL」の場合、アンテナの高さは地上レベルを基準にして指定する必要があります。heightType パラメータの値が「AMSL」の場合、WGS84 測地系を基準として指定されます。
heightType

enum (HeightType)

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

number

デバイスのアンテナの水平位置の精度を示す正の数値（メートル単位）。この省略可能なパラメータは、値が FCC の要件である 50 メートル未満の場合にのみ存在します。
verticalAccuracy

number

デバイス アンテナの垂直位置の精度を示すメートル単位の正の数。この省略可能なパラメータは、値が FCC の要件である 3 メートル未満の場合にのみ存在します。
indoorDeployment

boolean

デバイスのアンテナが屋内にあるかどうか。True: 屋内。False: outdoor。
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/10 MHz）の範囲の整数です。含まれていない場合、SAS はデバイス カテゴリの dBm/10 MHz 単位の最大許容 EIRP として解釈します。
antennaBeamwidth

integer

水平面におけるアンテナの 3 dB アンテナ ビーム幅（度）。このパラメータは、0 ～ 360（度）の範囲の符号なし整数です。カテゴリ A デバイスでは省略可能、カテゴリ B デバイスでは条件付きです。
antennaModel

string

外部アンテナを使用する場合は、このフィールドでアンテナ モデルを任意で指定します。文字列の最大長は 128 オクテットです。

HeightType

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

列挙型
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

州

デバイスの状態。

列挙型
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
}
フィールド
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: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)

移動リストが影響する周波数範囲。

メソッド

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 を更新します。