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

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 または customer の devices を一覧表示します。