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 Portal API で指定します。

activeConfig

object (DeviceConfig)

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

state

enum (State)

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

grants[]

object (DeviceGrant)

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

displayName

string

デバイスの表示名。

deviceMetadata

object (DeviceMetadata)

SAS Portal と 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 形式のタイムスタンプ。ナノ秒単位で、小数点以下は 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 が遵守しているエア インターフェース仕様を指定します。

放射線技術

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

列挙型
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 m を下回った場合にのみ指定します。

verticalAccuracy

number

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

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

このパラメータは、デバイスの最大 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 かどうかを指定します。

高さのタイプ

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

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

State

デバイス構成の状態。CBSD の登録時に使用できるのは、状態 DEVICE_CONFIG_STATE_FINAL の構成ファイルのみです。

列挙型
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

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,
  "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 Move リスト。

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")。

周波数範囲

頻度: low_frequencyhigh_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 ポータル リクエストと登録リクエストの両方でデバイスデータをオーバーライド可能。

JSON 表現
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
フィールド
interferenceCoordinationGroup

string

干渉調整グループ(ICG)。デバイスとの干渉を管理する CBSD グループ。詳細については、CBRSA-TS-2001 V3.0.0 をご覧ください。

commonChannelGroup

string

Common Channel Group(CCG)。同じ ICG に属する CBSD のグループであり、共通のメイン チャネルの割り当てをリクエストします。詳細については、CBRSA-TS-2001 V3.0.0 をご覧ください。

antennaModel

string

入力した場合、使用するアンテナモデル パターン形式: RecordCreatorId:PatternId

nrqzValidated
(deprecated)

boolean

出力のみ。CPI が National Quiet Zone オフィスとの調整を確認した場合は true に設定します。

nrqzValidation

object (NrqzValidation)

出力のみ。National Radio Quiet Zone の検証情報

NrqzValidation

National Radio Quilet Zone の検証に関する情報。

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。

State

NRQZ の検証情報の状態。

列挙型
STATE_UNSPECIFIED 未指定の状態
DRAFT 下書きの状態
FINAL 最終状態。

チャンネル付きスコア

スコアのあるチャンネル。

JSON 表現
{
  "frequencyRange": {
    object (FrequencyRange)
  },
  "score": number
}
フィールド
frequencyRange

object (FrequencyRange)

チャンネルの周波数範囲。

score

number

チャンネル スコア。範囲 [0,100] 内で正規化されます。

Methods

create

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

createSigned

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

list

node または customerdevices を一覧表示します。