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

डिवाइस का एफ़सीसी आइडेंटिफ़ायर.
serialNumber

string

यह डिवाइस बनाने वाली कंपनी की ओर से डिवाइस को असाइन किया गया सीरियल नंबर होता है.
preloadedConfig

object (DeviceConfig)

डिवाइस का कॉन्फ़िगरेशन, जैसा कि SAS Portal API के ज़रिए बताया गया है.
activeConfig

object (DeviceConfig)

सिर्फ़ आउटपुट के लिए. एसएएस के साथ रजिस्टर किए गए डिवाइस का मौजूदा कॉन्फ़िगरेशन.
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)

डिवाइस की एफ़सीसी कैटगरी.
model

object (DeviceModel)

इस डिवाइस मॉडल के बारे में जानकारी.
airInterface

object (DeviceAirInterface)

इस डिवाइस के एयर इंटरफ़ेस के बारे में जानकारी.
installationParams

object (InstallationParams)

डिवाइस के लिए इंस्टॉलेशन पैरामीटर.
measurementCapabilities[]

enum (MeasurementCapability)

डिवाइस की मेज़रमेंट रिपोर्टिंग की सुविधाएँ.
userId

string

यह कुकी, डिवाइस के उपयोगकर्ता का आइडेंटिफ़ायर सेव करती है.
callSign

string

डिवाइस ऑपरेटर का कॉल साइन.
state

enum (State)

कॉन्फ़िगरेशन की स्थिति.
isSigned

boolean

सिर्फ़ आउटपुट के लिए. कॉन्फ़िगरेशन पर किसी सीपीआई ने हस्ताक्षर किया है या नहीं.
updateTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. डिवाइस कॉन्फ़िगरेशन में पिछली बार बदलाव कब किया गया था.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक होते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

DeviceCategory

डिवाइस की एफ़सीसी कैटगरी, जिसे पार्ट 96 के तहत तय किया गया है.

Enums
DEVICE_CATEGORY_UNSPECIFIED डिवाइस की कैटगरी नहीं बताई गई है.
DEVICE_CATEGORY_A कैटगरी ए.
DEVICE_CATEGORY_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

रेडियो ऐक्सेस टेक्नोलॉजी के स्वीकृत टाइप.

Enums
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

मीटर में एक पॉज़िटिव संख्या, जो डिवाइस के ऐंटेना की वर्टिकल जगह की सटीक जानकारी देती है. यह वैकल्पिक पैरामीटर सिर्फ़ तब मौजूद होना चाहिए, जब इसकी वैल्यू, 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 की इकाइयों में डिवाइस का ज़्यादा से ज़्यादा ईआईआरपी है. यह एक पूर्णांक है, जिसकी वैल्यू -127 से +47 (dBm/10 MHz) के बीच होती है. अगर इसे शामिल नहीं किया जाता है, तो एसएएस इसे डिवाइस कैटगरी के लिए, dBm/10MHz की इकाइयों में ईआईआरपी की ज़्यादा से ज़्यादा अनुमत वैल्यू के तौर पर इंटरप्रेट करता है.
antennaBeamwidth

integer

डिग्री में, हॉरिज़ॉन्टल-प्लेन में ऐंटीना की 3-dB ऐंटीना बीमविड्थ. यह पैरामीटर, बिना हस्ताक्षर वाला पूर्णांक है. इसकी वैल्यू 0 से 360 (डिग्री) के बीच होती है. यह कैटगरी A वाले डिवाइसों के लिए ज़रूरी नहीं है और कैटगरी B वाले डिवाइसों के लिए कुछ शर्तों के साथ ज़रूरी है.
antennaModel

string

अगर किसी बाहरी ऐन्टेना का इस्तेमाल किया जाता है, तो इस फ़ील्ड में ऐन्टेना मॉडल की जानकारी दी जा सकती है. स्ट्रिंग की लंबाई ज़्यादा से ज़्यादा 128 ऑक्टेट होती है.
cpeCbsdIndication

boolean

अगर यह पैरामीटर मौजूद है, तो इससे पता चलता है कि सीबीएसडी, सीपीई-सीबीएसडी है या नहीं.

HeightType

इससे पता चलता है कि ऊंचाई को कैसे मेज़र किया जाता है.

Enums
HEIGHT_TYPE_UNSPECIFIED ऊंचाई के टाइप की जानकारी नहीं दी गई है.
HEIGHT_TYPE_AGL AGL की ऊंचाई, ज़मीन के लेवल के हिसाब से मापी जाती है.
HEIGHT_TYPE_AMSL AMSL की ऊंचाई, समुद्र तल से मापी जाती है.

MeasurementCapability

डिवाइस की मेज़रमेंट क्षमता. ये वैल्यू, WINNF-SSC-0002 के हिसाब से तय की जाती हैं.

Enums
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

स्थिति

डिवाइस कॉन्फ़िगरेशन की स्थिति. सीबीएसडी रजिस्ट्रेशन के दौरान, सिर्फ़ DEVICE_CONFIG_STATE_FINAL स्थिति वाले कॉन्फ़िगरेशन का इस्तेमाल किया जा सकता है.

Enums
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

स्थिति

डिवाइस की स्थिति.

Enums
DEVICE_STATE_UNSPECIFIED स्थिति की जानकारी नहीं दी गई है.
RESERVED SAS Portal में डिवाइस बनाया गया है. हालांकि, इसे अब तक SAS के साथ रजिस्टर नहीं किया गया है.
REGISTERED डिवाइस को SAS के साथ रजिस्टर किया गया है.
DEREGISTERED डिवाइस को एसएएस से डी-रजिस्टर कर दिया गया है.

DeviceGrant

डिवाइस का ऐक्सेस देना. यह स्पेक्ट्रम ऐक्सेस सिस्टम की ओर से किसी डिवाइस को दिया गया अनुमति पत्र है. इससे डिवाइस को तय किए गए ऑपरेटिंग पैरामीटर का इस्तेमाल करके डेटा ट्रांसमिट करने की अनुमति मिलती है. हालांकि, इसके लिए डिवाइस को हार्टबीट सिग्नल भेजना ज़रूरी है.

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

अनुदान के तहत, ज़्यादा से ज़्यादा इक्विवैलेंट आइसोट्रॉपिक रेडिएटेड पावर (ईआईआरपी) की अनुमति है. ईआईआरपी की ज़्यादा से ज़्यादा वैल्यू, dBm/MHz में होती है. maxEirp की वैल्यू, औसत (आरएमएस) ईआईआरपी को दिखाती है. इसे एफ़सीसी के पार्ट 96.41(e)(3) में बताई गई प्रोसेस के हिसाब से मेज़र किया जाता है.
frequencyRange

object (FrequencyRange)

ट्रांसमिशन की फ़्रीक्वेंसी रेंज.
state

enum (GrantState)

अनुमति देने की स्थिति.
channelType

enum (ChannelType)

इस्तेमाल किए गए चैनल का टाइप.
moveList[]

object (DpaMoveList)

डीपीए की उन सूचियों को दिखाता है जिनमें यह अनुमति दिखती है.
expireTime

string (Timestamp format)

अनुमति खत्म होने का समय.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक होते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
suspensionReason[]

string

अगर अनुदान को निलंबित कर दिया गया है, तो निलंबन की वजह(वजहें).
grantId

string

अनुमति का आईडी.
lastHeartbeatTransmitExpireTime

string (Timestamp format)

पिछली हार्टबीट के ट्रांसमिट होने की समयसीमा खत्म होने का समय.

आरएफ़सी3339 यूटीसी के "Zulu" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक होते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

FrequencyRange

फ़्रीक्वेंसी की रेंज, low_frequency से high_frequency तक है.

JSON के काेड में दिखाना 
{
  "lowFrequencyMhz": number,
  "highFrequencyMhz": number
}
फ़ील्ड
lowFrequencyMhz

number

मेगाहर्ट्ज़ में फ़्रीक्वेंसी रेंज की सबसे कम फ़्रीक्वेंसी.
highFrequencyMhz

number

फ़्रीक्वेंसी रेंज की सबसे ज़्यादा फ़्रीक्वेंसी, मेगाहर्ट्ज़ में.

GrantState

अनुमति की स्थिति.

Enums
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED अनुमति दे दी गई है, लेकिन डिवाइस पर हार्टबीट नहीं हो रहा है.
GRANT_STATE_TERMINATED एसएएस ने यह अनुदान बंद कर दिया है.
GRANT_STATE_SUSPENDED SAS ने इस ग्रांट को निलंबित कर दिया है.
GRANT_STATE_AUTHORIZED फ़िलहाल, डिवाइस डेटा ट्रांसमिट कर रहा है.
GRANT_STATE_EXPIRED अनुदान की समयसीमा खत्म हो गई है.

ChannelType

Enums
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

DpaMoveList

डेटा प्रोसेसिंग समझौते (डीपीए) की सूची में मौजूद कोई एंट्री.

JSON के काेड में दिखाना 
{
  "dpaId": string,
  "frequencyRange": {
    object (FrequencyRange)
  }
}
फ़ील्ड
dpaId

string

डीपीए का आईडी.
frequencyRange

object (FrequencyRange)

फ़्रीक्वेंसी की वह सीमा जिस पर सूची को दूसरी जगह ले जाने का असर पड़ता है.

DeviceMetadata

डिवाइस के डेटा को SAS Portal और रजिस्ट्रेशन के अनुरोध, दोनों से बदला जा सकता है.

JSON के काेड में दिखाना 
{
  "interferenceCoordinationGroup": string,
  "commonChannelGroup": string,
  "antennaModel": string,
  "nrqzValidated": boolean,
  "nrqzValidation": {
    object (NrqzValidation)
  }
}
फ़ील्ड
interferenceCoordinationGroup

string

इंटरफ़ियरेंस कोऑर्डिनेशन ग्रुप (आईसीडी). सीबीएसडी का ऐसा ग्रुप जो ग्रुप के साथ अपने इंटरफ़ेरंस को मैनेज करता है. ज़्यादा जानकारी के लिए, CBRSA-TS-2001 V3.0.0 देखें.
commonChannelGroup

string

कॉमन चैनल ग्रुप (सीसीजी). एक ही आईसीजी में मौजूद सीबीएसडी का ऐसा ग्रुप जो एक ही प्राइमरी चैनल असाइनमेंट का अनुरोध कर रहा हो. ज़्यादा जानकारी के लिए, CBRSA-TS-2001 V3.0.0 देखें.
antennaModel

string

अगर यह फ़ील्ड भरा गया है, तो इस्तेमाल किया जाने वाला ऐंटेना मॉडल पैटर्न. फ़ॉर्मैट यह है: RecordCreatorId:PatternId
nrqzValidated
(deprecated)

boolean

सिर्फ़ आउटपुट के लिए. अगर सीपीआई ने पुष्टि की है कि उसने नेशनल क्वाइट ज़ोन ऑफ़िस के साथ समन्वय किया है, तो इसे true पर सेट करें.
nrqzValidation

object (NrqzValidation)

सिर्फ़ आउटपुट के लिए. नैशनल रेडियो क्वाइट ज़ोन की पुष्टि करने से जुड़ी जानकारी.

NrqzValidation

नैशनल रेडियो क्वाइट ज़ोन की पुष्टि करने के बारे में जानकारी.

JSON के काेड में दिखाना 
{
  "state": enum (State),
  "caseId": string,
  "latitude": number,
  "longitude": number,
  "cpiId": string
}
फ़ील्ड
state

enum (State)

एनआरक्यूज़ की पुष्टि करने वाली जानकारी की स्थिति.
caseId

string

पुष्टि करने के लिए केस आईडी.
latitude

number

डिवाइस का वह अक्षांश जिससे पुष्टि जुड़ी है.
longitude

number

डिवाइस का वह देशांतर जो पुष्टि से जुड़ा है.
cpiId

string

सीपीआई जिसने पुष्टि करने के लिए हस्ताक्षर किए हैं.

स्थिति

एनआरक्यूज़ की पुष्टि करने वाली जानकारी की स्थिति.

Enums
STATE_UNSPECIFIED स्थिति की जानकारी नहीं दी गई है.
DRAFT ड्राफ़्ट की स्थिति.
FINAL आखिरी स्थिति.

ChannelWithScore

स्कोर वाला चैनल.

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 की सूची.