Indice
Customers
(interfaccia)DeviceManager
(interfaccia)PolicyService
(interfaccia)Assignment
(messaggio)BillingMode
(enum)ChannelType
(enum)CreateDeploymentRequest
(messaggio)CreateDeviceRequest
(messaggio)CreateNodeRequest
(messaggio)CreateSignedDeviceRequest
(messaggio)Customer
(messaggio)DeleteDeploymentRequest
(messaggio)DeleteDeviceRequest
(messaggio)DeleteNodeRequest
(messaggio)Deployment
(messaggio)Device
(messaggio)Device.State
(enum)DeviceAirInterface
(messaggio)DeviceAirInterface.RadioTechnology
(enum)DeviceCategory
(enum)DeviceConfig
(messaggio)DeviceConfig.State
(enum)DeviceGrant
(messaggio)DeviceMetadata
(messaggio)DeviceModel
(messaggio)DpaMoveList
(messaggio)FrequencyRange
(messaggio)GenerateSecretRequest
(messaggio)GenerateSecretResponse
(messaggio)GetCustomerRequest
(messaggio)GetDeploymentRequest
(messaggio)GetDeviceRequest
(messaggio)GetNodeRequest
(messaggio)GetPolicyRequest
(messaggio)GrantState
(enum)HeightType
(enum)InstallationParams
(messaggio)ListCustomersRequest
(messaggio)ListCustomersResponse
(messaggio)ListDeploymentsRequest
(messaggio)ListDeploymentsResponse
(messaggio)ListDevicesRequest
(messaggio)ListDevicesResponse
(messaggio)ListNodesRequest
(messaggio)ListNodesResponse
(messaggio)MeasurementCapability
(enum)MoveDeploymentRequest
(messaggio)MoveDeviceRequest
(messaggio)MoveNodeRequest
(messaggio)Node
(messaggio)Policy
(messaggio)SetPolicyRequest
(messaggio)SignDeviceRequest
(messaggio)TestPermissionsRequest
(messaggio)TestPermissionsResponse
(messaggio)UpdateCustomerRequest
(messaggio)UpdateDeploymentRequest
(messaggio)UpdateDeviceRequest
(messaggio)UpdateNodeRequest
(messaggio)UpdateSignedDeviceRequest
(messaggio)ValidateInstallerRequest
(messaggio)ValidateInstallerResponse
(messaggio)
Clienti
Servizio di gestione dei clienti SAS.
GetCustomer | |
---|---|
Restituisce un
|
ListCustomers | |
---|---|
Restituisce un elenco di
|
UpdateCustomer | |
---|---|
Aggiorna un
|
DeviceManager
Servizio di gestione dei dispositivi Citizens Broadband Radio Service.
CreateDeployment | |
---|---|
Crea un nuovo
|
CreateDevice | |
---|---|
Crea un
|
CreateNode | |
---|---|
Crea un nuovo
|
CreateSignedDevice | |
---|---|
Crea un
|
DeleteDeployment | |
---|---|
Elimina un
|
DeleteDevice | |
---|---|
Elimina un
|
DeleteNode | |
---|---|
Elimina un
|
GenerateSecret | |
---|---|
Genera un secret da utilizzare con
|
GetDeployment | |
---|---|
Restituisce un
|
GetDevice | |
---|---|
Recupera i dettagli di un
|
GetNode | |
---|---|
Restituisce un
|
ListDeployments | |
---|---|
Elenchi
|
ListDevices | |
---|---|
Elenchi
|
ListNodes | |
---|---|
Elenchi
|
MoveDeployment | |
---|---|
Sposta un
|
MoveDevice | |
---|---|
Sposta un
|
MoveNode | |
---|---|
Sposta un
|
SignDevice | |
---|---|
Firma un
|
UpdateDeployment | |
---|---|
Aggiorna un
|
UpdateDevice | |
---|---|
Aggiorna un
|
UpdateNode | |
---|---|
Aggiorna un
|
UpdateSignedDevice | |
---|---|
Aggiorna un
|
ValidateInstaller | |
---|---|
Convalida l'identità di un installatore professionale certificato (CPI).
|
PolicyService
Servizio di controllo dell'accesso a Spectrum Resource Manager.
GetPolicy | |
---|---|
Recupera il criterio di controllo dell'accesso per una risorsa. Restituisce una policy vuota se la risorsa esiste e non è stata impostata una policy.
|
SetPolicy | |
---|---|
Imposta il criterio di controllo dell'accesso sulla risorsa specificata. Sostituisce qualsiasi policy esistente.
|
TestPermissions | |
---|---|
Restituisce le autorizzazioni di cui dispone un chiamante per la risorsa specificata.
|
Assignment
Associa members
a un role
.
Campi | |
---|---|
role |
Obbligatorio. Ruolo assegnato a |
members[] |
Le identità a cui è assegnato il ruolo. Può avere i seguenti valori:
|
BillingMode
Modalità di fatturazione di un CBSD
Enum | |
---|---|
BILLING_MODE_UNSPECIFIED |
La modalità di fatturazione non è stata specificata. |
MOBILE |
Il prezzo si basa sulla categoria di CBSD: categoria A, categoria B registrata con SAS. |
FIXED_WIRELESS |
Il prezzo dipende dal tipo di CBSD: stazione base o CPE. |
ChannelType
Enum | |
---|---|
CHANNEL_TYPE_UNSPECIFIED |
|
CHANNEL_TYPE_GAA |
|
CHANNEL_TYPE_PAL |
CreateDeploymentRequest
Richiesta per CreateDeployment
.
Campi | |
---|---|
parent |
Obbligatorio. Il nome della risorsa padre in cui creare il deployment. |
deployment |
Obbligatorio. I dettagli del deployment. |
CreateDeviceRequest
Richiesta per CreateDevice
.
Campi | |
---|---|
parent |
Obbligatorio. Il nome della risorsa padre. |
device |
I dettagli di registrazione di |
CreateNodeRequest
Richiesta per CreateNode
.
Campi | |
---|---|
parent |
Obbligatorio. Il nome della risorsa padre in cui creare il nodo. |
node |
I dettagli del nodo. |
CreateSignedDeviceRequest
Richiesta per CreateSignedDevice
.
Campi | |
---|---|
parent |
Obbligatorio. Il nome della risorsa padre. |
encoded_device |
Obbligatorio. Token web JSON firmato utilizzando una chiave privata CPI. Il payload deve essere la codifica JSON di |
installer_id |
Obbligatorio. ID installatore univoco (ID CPI) dal database degli installatori professionali certificati. |
Cliente
Entità che rappresenta un cliente SAS.
Campi | |
---|---|
name |
Solo output. Nome risorsa del cliente. |
display_name |
Obbligatorio. Nome dell'organizzazione che rappresenta la persona giuridica del cliente. |
sas_user_ids[] |
ID utente utilizzati dai dispositivi appartenenti a questo cliente. |
DeleteDeploymentRequest
Richiesta per DeleteDeployment
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del |
DeleteDeviceRequest
Richiesta per DeleteDevice
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del dispositivo. |
DeleteNodeRequest
Richiesta per DeleteNode
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del |
Deployment
Deployment.
Campi | |
---|---|
name |
Solo output. Nome della risorsa. |
display_name |
Il nome visualizzato del deployment. |
sas_user_ids[] |
ID utente utilizzato dai dispositivi appartenenti a questo deployment. Ogni deployment deve essere associato a un unico User ID. |
default_billing_mode |
Modalità di fatturazione predefinita per il deployment e i dispositivi al suo interno. |
allowed_billing_modes[] |
Le modalità di fatturazione consentite in questo deployment. |
Dispositivo
Campi | |
---|---|
name |
Solo output. Il nome del percorso della risorsa. |
fcc_id |
L'identificatore FCC del dispositivo. |
serial_number |
Un numero di serie assegnato al dispositivo dal produttore. |
preloaded_config |
Configurazione del dispositivo, come specificato tramite l'API SAS Portal. |
active_config |
Solo output. Configurazione attuale del dispositivo registrata nel SAS. |
state |
Solo output. Stato del dispositivo. |
grants[] |
Solo output. Concessioni detenute dal dispositivo. |
display_name |
Nome visualizzato del dispositivo. |
device_metadata |
Parametri del dispositivo che possono essere sostituiti sia dal portale SAS che dalle richieste di registrazione SAS. |
Stato
Stato del dispositivo.
Enum | |
---|---|
DEVICE_STATE_UNSPECIFIED |
Stato non specificato. |
RESERVED |
Dispositivo creato nel portale SAS, ma non ancora registrato con SAS. |
REGISTERED |
Dispositivo registrato con SAS. |
DEREGISTERED |
Il dispositivo è stato deregistrato da SAS. |
DeviceAirInterface
Informazioni sull'interfaccia aerea del dispositivo.
Campi | |
---|---|
radio_technology |
Condizionale. Questo campo specifica la tecnologia di accesso radio utilizzata per la CBSD. |
supported_spec |
(Facoltativo) Questo campo è correlato a |
RadioTechnology
I tipi approvati di tecnologia di accesso radio.
Enum | |
---|---|
RADIO_TECHNOLOGY_UNSPECIFIED |
|
E_UTRA |
|
CAMBIUM_NETWORKS |
|
FOUR_G_BBW_SAA_1 |
|
NR |
|
DOODLE_CBRS |
|
CW |
|
REDLINE |
|
TARANA_WIRELESS |
DeviceCategory
Categoria FCC del dispositivo, come definita dalla Parte 96.
Enum | |
---|---|
DEVICE_CATEGORY_UNSPECIFIED |
Categoria del dispositivo non specificata. |
DEVICE_CATEGORY_A |
Categoria A. |
DEVICE_CATEGORY_B |
Categoria B. |
DeviceConfig
Informazioni sulla configurazione del dispositivo.
Campi | |
---|---|
category |
Categoria FCC del dispositivo. |
model |
Informazioni su questo modello di dispositivo. |
air_interface |
Informazioni sull'interfaccia aerea di questo dispositivo. |
installation_params |
Parametri di installazione per il dispositivo. |
measurement_capabilities[] |
Funzionalità di generazione di report sulla misurazione del dispositivo. |
user_id |
L'identificatore di un utente del dispositivo. |
call_sign |
Il nominativo dell'operatore del dispositivo. |
state |
Stato della configurazione. |
is_signed |
Solo output. Indica se la configurazione è stata firmata da un CPI. |
update_time |
Solo output. L'ultima volta che è stata modificata la configurazione del dispositivo. |
Stato
Stato della configurazione del dispositivo. Durante la registrazione CBSD possono essere utilizzate solo le configurazioni con stato DEVICE_CONFIG_STATE_FINAL
.
Enum | |
---|---|
DEVICE_CONFIG_STATE_UNSPECIFIED |
|
DRAFT |
|
FINAL |
DeviceGrant
Concessione del dispositivo. Si tratta di un'autorizzazione fornita dal sistema di accesso allo spettro a un dispositivo per trasmettere utilizzando parametri operativi specificati dopo un heartbeat riuscito del dispositivo.
Campi | |
---|---|
max_eirp |
Potenza isotropica irradiata equivalente (EIRP) massima consentita dalla concessione. L'EIRP massimo è espresso in unità di dBm/MHz. Il valore di |
frequency_range |
L'intervallo di frequenza di trasmissione. |
state |
Stato della concessione. |
channel_type |
Tipo di canale utilizzato. |
move_list[] |
Gli elenchi di spostamento del DPA in cui viene visualizzata questa concessione. |
expire_time |
Il tempo per la scadenza della concessione. |
suspension_reason[] |
Se la sovvenzione è sospesa, il motivo o i motivi della sospensione. |
grant_id |
ID concessione. |
DeviceMetadata
Dati del dispositivo sostituibili sia dal Portale SAS sia dalle richieste di registrazione.
DeviceModel
Informazioni sul modello del dispositivo.
Campi | |
---|---|
vendor |
Il nome del fornitore del dispositivo. |
name |
Il nome del modello del dispositivo. |
software_version |
La versione software del dispositivo. |
hardware_version |
La versione hardware del dispositivo. |
firmware_version |
La versione firmware del dispositivo. |
DpaMoveList
Una voce nell'elenco di trasferimento di un DPA.
Campi | |
---|---|
dpa_id |
L'ID del DPA. |
frequency_range |
L'intervallo di frequenza interessato dall'elenco di spostamento. |
FrequencyRange
Intervallo di frequenza da low_frequency
a high_frequency
.
Campi | |
---|---|
low_frequency_mhz |
La frequenza più bassa dell'intervallo di frequenza in MHz. |
high_frequency_mhz |
La frequenza più alta della gamma di frequenza in MHz. |
GenerateSecretRequest
Richiesta per GenerateSecret
.
GenerateSecretResponse
Risposta per GenerateSecret
.
Campi | |
---|---|
secret |
Il secret generato dalla stringa e utilizzato da |
GetCustomerRequest
Richiesta per GetCustomer
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del |
GetDeploymentRequest
Richiesta per GetDeployment
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del |
GetDeviceRequest
Richiesta per GetDevice
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del dispositivo. |
GetNodeRequest
Richiesta per GetNode
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del |
GetPolicyRequest
Messaggio di richiesta per il metodo GetPolicy
.
Campi | |
---|---|
resource |
Obbligatorio. La risorsa per cui viene richiesta la policy. |
GrantState
Lo stato della concessione.
Enum | |
---|---|
GRANT_STATE_UNSPECIFIED |
|
GRANT_STATE_GRANTED |
La concessione è stata concessa, ma il dispositivo non invia heartbeat. |
GRANT_STATE_TERMINATED |
La concessione è stata interrotta dal SAS. |
GRANT_STATE_SUSPENDED |
La sovvenzione è stata sospesa dal SAS. |
GRANT_STATE_AUTHORIZED |
Il dispositivo sta trasmettendo. |
GRANT_STATE_EXPIRED |
La concessione è scaduta. |
HeightType
Specifica come viene misurata l'altezza.
Enum | |
---|---|
HEIGHT_TYPE_UNSPECIFIED |
Tipo di altezza non specificato. |
HEIGHT_TYPE_AGL |
L'altezza AGL viene misurata rispetto al livello del suolo. |
HEIGHT_TYPE_AMSL |
L'altezza AMSL viene misurata rispetto al livello medio del mare. |
InstallationParams
Informazioni sui parametri di installazione del dispositivo.
Campi | |
---|---|
latitude |
Latitudine della posizione dell'antenna del dispositivo in gradi rispetto al datum WGS 84. L'intervallo consentito è compreso tra -90.000000 e +90.000000. I valori positivi rappresentano le latitudini a nord dell'equatore, i valori negativi quelle a sud. |
longitude |
Longitudine della posizione dell'antenna del dispositivo in gradi rispetto al sistema di riferimento WGS 84. L'intervallo consentito è compreso tra -180.000000 e +180.000000. I valori positivi rappresentano le longitudini a est del meridiano zero, i valori negativi quelle a ovest. |
height |
Altezza dell'antenna del dispositivo in metri. Quando il valore del parametro |
height_type |
Specifica come viene misurata l'altezza. |
horizontal_accuracy |
Un numero positivo in metri che indica la precisione della posizione orizzontale dell'antenna del dispositivo. Questo parametro facoltativo deve essere presente solo se il suo valore è inferiore al requisito della FCC di 50 metri. |
vertical_accuracy |
Un numero positivo in metri che indica la precisione della posizione verticale dell'antenna del dispositivo. Questo parametro facoltativo deve essere presente solo se il suo valore è inferiore al requisito FCC di 3 metri. |
indoor_deployment |
Indica se l'antenna del dispositivo è interna o meno. |
antenna_azimuth |
Direzione di puntamento del piano orizzontale dell'antenna in gradi rispetto al nord geografico. Il valore di questo parametro è un numero intero compreso tra 0 e 359 inclusi. Un valore di 0 gradi indica il nord geografico, mentre un valore di 90 gradi indica l'est. Questo parametro è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B. |
antenna_downtilt |
L'inclinazione verso il basso dell'antenna in gradi è un numero intero con un valore compreso tra -90 e +90 inclusi; un valore negativo indica che l'antenna è inclinata verso l'alto (sopra l'orizzontale). Questo parametro è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B. |
antenna_gain |
Guadagno massimo dell'antenna in dBi. Questo parametro è un numero intero con un valore compreso tra -127 e +128 (dBi) inclusi. |
eirp_capability |
Questo parametro è l'EIRP massimo del dispositivo in unità di dBm/10 MHz ed è un numero intero con un valore compreso tra -127 e +47 (dBm/10 MHz) inclusi. Se non è incluso, SAS lo interpreta come EIRP massimo consentito in unità di dBm/10 MHz per la categoria di dispositivo. |
antenna_beamwidth |
Larghezza del fascio dell'antenna a 3 dB nel piano orizzontale in gradi. Questo parametro è un numero intero senza segno con un valore compreso tra 0 e 360 (gradi) inclusi; è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B. |
antenna_model |
Se viene utilizzata un'antenna esterna, il modello di antenna viene fornito facoltativamente in questo campo. La stringa ha una lunghezza massima di 128 ottetti. |
cpe_cbsd_indication |
Se presente, questo parametro specifica se la CBSD è una CPE-CBSD o meno. |
ListCustomersRequest
Richiesta per ListCustomers
.
Campi | |
---|---|
page_size |
Il numero massimo di |
page_token |
Un token di paginazione restituito da una precedente chiamata a |
ListCustomersResponse
Risposta per ListCustomers
.
Campi | |
---|---|
customers[] |
L'elenco di |
next_page_token |
Un token di impaginazione restituito da una precedente chiamata a |
ListDeploymentsRequest
Richiesta per ListDeployments
.
Campi | |
---|---|
parent |
Obbligatorio. Il nome della risorsa padre, ad esempio "nodes/1", customer/1/nodes/2. |
page_size |
Il numero massimo di deployment da restituire nella risposta. |
page_token |
Un token di paginazione restituito da una precedente chiamata a |
filter |
L'espressione di filtro. Il filtro deve avere il seguente formato: "DIRECT_CHILDREN" o "direct_children". Il filtro non è sensibile alle maiuscole. Se è vuoto, non vengono filtrati deployment. |
ListDeploymentsResponse
Risposta per ListDeployments
.
Campi | |
---|---|
deployments[] |
I |
next_page_token |
Un token di impaginazione restituito da una precedente chiamata a |
ListDevicesRequest
Richiesta per ListDevices
.
Campi | |
---|---|
parent |
Obbligatorio. Il nome della risorsa padre. |
page_size |
Il numero massimo di dispositivi da restituire nella risposta. Se è vuoto o zero, verranno elencati tutti i dispositivi. Deve essere compreso nell'intervallo [0, 1000]. |
page_token |
Un token di paginazione restituito da una precedente chiamata a |
filter |
L'espressione di filtro. Il filtro deve avere uno dei seguenti formati: "sn=123454" o "display_name=MyDevice". sn corrisponde al numero di serie del dispositivo. Il filtro non è sensibile alle maiuscole. |
ListDevicesResponse
Risposta per ListDevices
.
Campi | |
---|---|
devices[] |
I |
next_page_token |
Un token di impaginazione restituito da una precedente chiamata a |
ListNodesRequest
Richiesta per ListNodes
.
Campi | |
---|---|
parent |
Obbligatorio. Il nome della risorsa padre, ad esempio "nodes/1". |
page_size |
Il numero massimo di nodi da restituire nella risposta. |
page_token |
Un token di paginazione restituito da una precedente chiamata a |
filter |
L'espressione di filtro. Il filtro deve avere il seguente formato: "DIRECT_CHILDREN" o "direct_children". Il filtro non è sensibile alle maiuscole. Se è vuoto, non viene filtrato alcun nodo. |
ListNodesResponse
Risposta per ListNodes
.
Campi | |
---|---|
nodes[] |
I |
next_page_token |
Un token di impaginazione restituito da una precedente chiamata a |
MeasurementCapability
Funzionalità di misurazione del dispositivo. I valori sono definiti da WINNF-SSC-0002.
Enum | |
---|---|
MEASUREMENT_CAPABILITY_UNSPECIFIED |
|
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT |
|
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT |
MoveDeploymentRequest
Richiesta per MoveDeployment
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del |
destination |
Obbligatorio. Il nome della nuova risorsa principale |
MoveDeviceRequest
Richiesta per MoveDevice
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del dispositivo da spostare. |
destination |
Obbligatorio. Il nome della nuova risorsa genitore |
MoveNodeRequest
Richiesta per MoveNode
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del |
destination |
Obbligatorio. Il nome della nuova risorsa padre |
Nodo
The Node.
Campi | |
---|---|
name |
Solo output. Nome della risorsa. |
display_name |
Il nome visualizzato del nodo. |
sas_user_ids[] |
ID utente utilizzati dai dispositivi appartenenti a questo nodo. |
Norme
Definisce un criterio di controllo dell'accesso alle risorse.
Campi | |
---|---|
assignments[] |
Elenco di |
etag |
L'etag viene utilizzato per il controllo della concorrenza ottimistico come modo per impedire che gli aggiornamenti simultanei di un criterio si sovrascrivano a vicenda. È consigliabile che i sistemi utilizzino l'etag nel ciclo di lettura-modifica-scrittura per eseguire gli aggiornamenti dei criteri al fine di evitare race condition: un'etag viene restituita nella risposta a Se nella chiamata a |
SetPolicyRequest
Messaggio di richiesta per il metodo SetPolicy
.
Campi | |
---|---|
resource |
Obbligatorio. La risorsa per cui vengono specificati i criteri. Questa policy sostituisce qualsiasi policy esistente. |
policy |
Obbligatorio. Il criterio da applicare a |
SignDeviceRequest
Richiesta per SignDevice
.
Campi | |
---|---|
device |
Obbligatorio. |
TestPermissionsRequest
Messaggio di richiesta per il metodo TestPermissions
.
Campi | |
---|---|
resource |
Obbligatorio. La risorsa per cui vengono richieste le autorizzazioni. |
permissions[] |
Il set di autorizzazioni da controllare per |
TestPermissionsResponse
Messaggio di risposta per il metodo TestPermissions
.
Campi | |
---|---|
permissions[] |
Un insieme di autorizzazioni consentite al chiamante. |
UpdateCustomerRequest
Richiesta per UpdateCustomer
.
Campi | |
---|---|
customer |
Obbligatorio. I nuovi valori per |
update_mask |
Campi da aggiornare. |
UpdateDeploymentRequest
Richiesta per UpdateDeployment
.
Campi | |
---|---|
deployment |
Obbligatorio. I nuovi valori per |
update_mask |
Campi da aggiornare. |
UpdateDeviceRequest
Richiesta per UpdateDevice
.
Campi | |
---|---|
device |
Obbligatorio. |
update_mask |
Campi da aggiornare. |
UpdateNodeRequest
Richiesta per UpdateNode
.
Campi | |
---|---|
node |
Obbligatorio. I nuovi valori per |
update_mask |
Campi da aggiornare. |
UpdateSignedDeviceRequest
Richiesta per UpdateSignedDevice
.
Campi | |
---|---|
name |
Obbligatorio. Il nome del dispositivo da aggiornare. |
encoded_device |
Obbligatorio. Il token web JSON firmato utilizzando una chiave privata CPI. Il payload deve essere la codifica JSON di |
installer_id |
Obbligatorio. ID installatore univoco (ID CPI) dal database Certified Professional Installers. |
ValidateInstallerRequest
Richiesta per ValidateInstaller
.
Campi | |
---|---|
installer_id |
Obbligatorio. ID installatore univoco (ID CPI) dal database degli installatori professionali certificati. |
secret |
Obbligatorio. Secret restituito da |
encoded_secret |
Obbligatorio. Token web JSON firmato utilizzando una chiave privata CPI. Il payload deve includere un'attestazione "secret" il cui valore è il secret. |
ValidateInstallerResponse
Risposta per ValidateInstaller
.