Package spectrum.sas.portal.v1alpha1

Indice

Clienti

Servizio di gestione dei clienti SAS.

Recupero Cliente

rpc GetCustomer(GetCustomerRequest) returns (Customer)

Restituisce un elemento customer richiesto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
ElencoClienti

rpc ListCustomers(ListCustomersRequest) returns (ListCustomersResponse)

Restituisce un elenco di customers richieste.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
AggiornamentoCliente

rpc UpdateCustomer(UpdateCustomerRequest) returns (Customer)

Aggiorna un elemento customer esistente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email

DeviceManager

Servizio di gestione dei dispositivi di servizio radio a banda larga dei cittadini.

Creazione deployment

rpc CreateDeployment(CreateDeploymentRequest) returns (Deployment)

Crea una nuova deployment.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Crea dispositivo

rpc CreateDevice(CreateDeviceRequest) returns (Device)

Crea un device in node o customer.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
CreateNode

rpc CreateNode(CreateNodeRequest) returns (Node)

Crea una nuova node.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
CreateSignedDevice

rpc CreateSignedDevice(CreateSignedDeviceRequest) returns (Device)

Crea un device firmato sotto un node o customer.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Eliminazione

rpc DeleteDeployment(DeleteDeploymentRequest) returns (Empty)

Elimina una deployment.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Eliminazione dispositivo

rpc DeleteDevice(DeleteDeviceRequest) returns (Empty)

Elimina una device.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Eliminazione nodo

rpc DeleteNode(DeleteNodeRequest) returns (Empty)

Elimina una node.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Genera secret

rpc GenerateSecret(GenerateSecretRequest) returns (GenerateSecretResponse)

Genera un secret da utilizzare con ValidateInstaller.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Recupero deployment

rpc GetDeployment(GetDeploymentRequest) returns (Deployment)

Restituisce un elemento deployment richiesto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
GetDevice

rpc GetDevice(GetDeviceRequest) returns (Device)

Visualizza i dettagli di un device.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
GetNode

rpc GetNode(GetNodeRequest) returns (Node)

Restituisce un elemento node richiesto.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Deployment Deployment

rpc ListDeployments(ListDeploymentsRequest) returns (ListDeploymentsResponse)

Elenca deployments.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
ElencoDispositivi

rpc ListDevices(ListDevicesRequest) returns (ListDevicesResponse)

Elenca devices in un node o customer.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Nodi elenco

rpc ListNodes(ListNodesRequest) returns (ListNodesResponse)

Elenca nodes.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Sposta deployment

rpc MoveDeployment(MoveDeploymentRequest) returns (Operation)

Sposta un deployment in un altro node o customer.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Sposta dispositivo

rpc MoveDevice(MoveDeviceRequest) returns (Operation)

Sposta un device in un altro node o customer.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Nodo spostamento

rpc MoveNode(MoveNodeRequest) returns (Operation)

Sposta un node in un altro node o customer.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
SignDevice

rpc SignDevice(SignDeviceRequest) returns (Empty)

Firma un device.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Deployment Deployment

rpc UpdateDeployment(UpdateDeploymentRequest) returns (Deployment)

Aggiorna un elemento deployment esistente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
AggiornamentoDispositivo

rpc UpdateDevice(UpdateDeviceRequest) returns (Device)

Consente di aggiornare un device.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
UpdateNode

rpc UpdateNode(UpdateNodeRequest) returns (Node)

Aggiorna un elemento node esistente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Aggiornamento dispositivi firmati

rpc UpdateSignedDevice(UpdateSignedDeviceRequest) returns (Device)

Consente di aggiornare un elemento device firmato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
ValidateInstaller

rpc ValidateInstaller(ValidateInstallerRequest) returns (ValidateInstallerResponse)

Convalida l'identità di un installatore professionista certificato (CPI).

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email

PolicyPolicy

Servizio di controllo dell'accesso a Spectrum Resource Manager.

GetPolicy

rpc GetPolicy(GetPolicyRequest) returns (Policy)

Visualizza il criterio di controllo dell'accesso per una risorsa. Restituisce un criterio vuoto se la risorsa esiste e non ha un criterio impostato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
SetPolicy

rpc SetPolicy(SetPolicyRequest) returns (Policy)

Imposta il criterio di controllo dell'accesso sulla risorsa specificata. Sostituisce qualsiasi criterio esistente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
AutorizzazioniTest

rpc TestPermissions(TestPermissionsRequest) returns (TestPermissionsResponse)

Restituisce le autorizzazioni di un chiamante sulla risorsa specificata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email

Compito

Associa members a un role.

Campi
role

string

Obbligatorio. Ruolo assegnato a members.

members[]

string

Le identità a cui è assegnato il ruolo. Può avere i seguenti valori:

  • {user_email}: un indirizzo email che rappresenta un Account Google specifico. Ad esempio: alice@gmail.com.

  • {group_email}: un indirizzo email che rappresenta un gruppo Google. Ad esempio, viewers@gmail.com.

Modalità di fatturazione

Modalità di fatturazione di un CBSD

Enum
BILLING_MODE_UNSPECIFIED La modalità di fatturazione non è stata specificata.
MOBILE Il prezzo si basa sulla categoria CBSD: Categoria A, Categoria B registrata presso SAS.
FIXED_WIRELESS Il prezzo si basa sul tipo di CBSD: stazione base o CPE.

TipoCanale

Enum
CHANNEL_TYPE_UNSPECIFIED
CHANNEL_TYPE_GAA
CHANNEL_TYPE_PAL

CreazioneRichiesta di deployment

Richiesta di CreateDeployment.

Campi
parent

string

Obbligatorio. Il nome della risorsa padre in cui deve essere creato il deployment.

deployment

Deployment

Obbligatorio. I dettagli del deployment. Il campo name deve essere vuoto. Viene generato dal server. È necessario impostare il deployment display_name.

CreateDeviceRequest

Richiesta di CreateDevice.

Campi
parent

string

Obbligatorio. Il nome della risorsa padre.

device

Device

I dettagli della registrazione device. Il campo name deve essere vuoto. Viene generato dal server. Devono essere impostati i campi device fcc_id e serial_number. Il campo user_id deve essere impostato.

CreateNodeRequest

Richiesta di CreateNode.

Campi
parent

string

Obbligatorio. Il nome della risorsa padre in cui deve essere creato il nodo.

node

Node

I dettagli del nodo. Il campo name deve essere vuoto. Viene generato dal server. È necessario impostare il nodo display_name.

CreateSignedDeviceRequest

Richiesta di CreateSignedDevice.

Campi
parent

string

Obbligatorio. Il nome della risorsa padre.

encoded_device

bytes

Obbligatorio. JSON Web Token firmato utilizzando una chiave privata CPI. Il payload deve essere la codifica JSON di device. Il campo user_id deve essere impostato.

installer_id

string

Obbligatorio. ID di installazione univoco (ID CPI) dal database dei programmi di installazione certificati certificati.

Cliente

Entità che rappresenta un cliente SAS.

Campi
name

string

Solo output. Nome della risorsa del cliente.

display_name

string

Obbligatorio. Nome dell'organizzazione rappresentata dall'entità del cliente.

sas_user_ids[]

string

ID utente utilizzati dai dispositivi appartenenti a questo cliente.

EliminazioneDeploymentRequest

Richiesta di DeleteDeployment.

Campi
name

string

Obbligatorio. Il nome del deployment.

DeleteDeviceRequest

Richiesta di DeleteDevice.

Campi
name

string

Obbligatorio. Il nome del dispositivo.

EliminazioneNodeRequest

Richiesta di DeleteNode.

Campi
name

string

Obbligatorio. Il nome del node.

Deployment

Il deployment.

Campi
name

string

Solo output. Nome della risorsa.

display_name

string

Il nome visualizzato del deployment.

sas_user_ids[]

string

User-ID utilizzato dai dispositivi appartenenti a questo deployment. Ogni deployment deve essere associato a un ID utente univoco.

default_billing_mode

BillingMode

Modalità di fatturazione predefinita per il deployment e per i dispositivi sottostanti.

allowed_billing_modes[]

BillingMode

Le modalità di fatturazione consentite in questo deployment.

Dispositivo

Campi
name

string

Solo output. Il nome del percorso della risorsa.

fcc_id

string

L'identificatore FCC del dispositivo.

serial_number

string

Un numero di serie assegnato al dispositivo dal produttore.

preloaded_config

DeviceConfig

Configurazione del dispositivo, come specificato tramite l'API SAS Portal.

active_config

DeviceConfig

Solo output. Configurazione attuale del dispositivo come registrata presso la SAS.

state

State

Solo output. Stato del dispositivo.

grants[]

DeviceGrant

Solo output. Concessioni detenute dal dispositivo.

display_name

string

Nome visualizzato del dispositivo.

device_metadata

DeviceMetadata

Parametri dei dispositivi che possono essere sostituiti sia dalle richieste SAS Portal sia dalle richieste di registrazione SAS.

Stato

Stato del dispositivo.

Enum
DEVICE_STATE_UNSPECIFIED Stato non specificato.
RESERVED Dispositivo creato nel portale SAS, tuttavia non ancora registrato con SAS.
REGISTERED Dispositivo registrato con SAS.
DEREGISTERED Dispositivo registrato con SAS.

DeviceAirInterface

Informazioni sull'interfaccia relativa al dispositivo.

Campi
radio_technology

RadioTechnology

Condizionale. Questo campo specifica la tecnologia di accesso radio utilizzata per il CBSD.

supported_spec

string

(Facoltativo) Questo campo è correlato al radioTechnology e fornisce la specifica dell'interfaccia aerea a cui è conforme la CBSD al momento della registrazione.

Radiotecnologia

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

Categoria

Categoria FCC del dispositivo, come definito dalla Parte 96.

Enum
DEVICE_CATEGORY_UNSPECIFIED Categoria dispositivo non specificata.
DEVICE_CATEGORY_A Categoria A.
DEVICE_CATEGORY_B Categoria B.

DeviceConfig

Informazioni sulla configurazione del dispositivo.

Campi
category

DeviceCategory

Categoria FCC del dispositivo.

model

DeviceModel

Informazioni su questo modello di dispositivo.

air_interface

DeviceAirInterface

Informazioni sull'interfaccia relativa al dispositivo.

installation_params

InstallationParams

Parametri di installazione per il dispositivo.

measurement_capabilities[]

MeasurementCapability

Funzionalità di generazione di report di misurazione del dispositivo.

user_id

StringValue

L'identificatore di un utente del dispositivo.

call_sign

string

Il nominativo dell'operatore del dispositivo.

state

State

Stato della configurazione.

is_signed

BoolValue

Solo output. Indica se la configurazione è stata firmata da un CPI.

update_time

Timestamp

Solo output. L'ultima volta che la configurazione del dispositivo è stata modificata.

Stato

Stato della configurazione del dispositivo. Durante la registrazione a CBSD è possibile usare solo le configurazioni nello stato DEVICE_CONFIG_STATE_FINAL.

Enum
DEVICE_CONFIG_STATE_UNSPECIFIED
DRAFT
FINAL

Concedi dispositivo

Concessione dispositivo. È un'autorizzazione fornita dal Sistema di accesso allo spettro a un dispositivo per la trasmissione tramite parametri operativi specificati dopo un successo del battito cardiaco dal dispositivo.

Campi
max_eirp

DoubleValue

Potenza massima radiata isotropica equivalente (EIRP) consentita dalla concessione. L'EIRP massimo è in unità di dBm/MHz. Il valore di maxEirp rappresenta l'EIRP medio (RMS) che verrebbe misurato dalla procedura definita nella parte FCC 96.41(e)(3).

frequency_range

FrequencyRange

La gamma di frequenze di trasmissione.

state

GrantState

Stato della concessione.

channel_type

ChannelType

Tipo di canale utilizzato.

move_list[]

DpaMoveList

L'ETD trasferisce gli elenchi in cui compare la concessione.

expire_time

Timestamp

La scadenza della concessione.

suspension_reason[]

string

Se la concessione è sospesa, i motivi della sospensione.

grant_id

string

ID concessione.

Metadati dispositivo

Dati di dispositivi che possono essere sostituiti sia dal portale SAS sia dalle richieste di registrazione.

Modello dispositivo

Informazioni sul modello del dispositivo.

Campi
vendor

string

Il nome del fornitore del dispositivo.

name

string

Il nome del modello del dispositivo.

software_version

string

La versione software del dispositivo.

hardware_version

string

La versione hardware del dispositivo.

firmware_version

string

La versione del firmware del dispositivo.

DpaMoveList

Una voce nell'elenco degli spostamenti di un DPA.

Campi
dpa_id

StringValue

L'ID della DPA.

frequency_range

FrequencyRange

L'intervallo di frequenze interessato dall'elenco degli spostamenti.

Intervallofrequenza

Gamma di frequenza da low_frequency a high_frequency.

Campi
low_frequency_mhz

DoubleValue

La frequenza più bassa della gamma di frequenze in MHz.

high_frequency_mhz

DoubleValue

La frequenza più alta della gamma di frequenze in MHz.

GeneraSecretSecretRequest

Richiesta di GenerateSecret.

Genera secretSecret

Risposta per GenerateSecret.

Campi
secret

string

Il secret generato dalla stringa e utilizzato da ValidateInstaller.

GetCustomerRequest

Richiesta di GetCustomer .

Campi
name

string

Obbligatorio. Il nome del customer.

RecuperoRichiesta di deployment

Richiesta di GetDeployment.

Campi
name

string

Obbligatorio. Il nome del deployment.

GetDeviceRequest

Richiesta di GetDevice.

Campi
name

string

Obbligatorio. Il nome del dispositivo.

GetNodeRequest

Richiesta di GetNode.

Campi
name

string

Obbligatorio. Il nome del node.

GetPolicyRequest

Messaggio di richiesta per il metodo GetPolicy.

Campi
resource

string

Obbligatorio. La risorsa per cui viene richiesto il criterio.

GrantState

Lo stato della concessione.

Enum
GRANT_STATE_UNSPECIFIED
GRANT_STATE_GRANTED La concessione è stata concessa, ma il dispositivo non sta smettendo di affaticarsi.
GRANT_STATE_TERMINATED La concessione è stata revocata dalla SAS.
GRANT_STATE_SUSPENDED La concessione è stata sospesa dalla SAS.
GRANT_STATE_AUTHORIZED Il dispositivo sta trasmettendo.
GRANT_STATE_EXPIRED La concessione è scaduta.

TipoAltezza

Specifica come viene misurata l'altezza.

Enum
HEIGHT_TYPE_UNSPECIFIED Tipo di altezza non specificato.
HEIGHT_TYPE_AGL L'altezza dell'AGL viene misurata rispetto al livello del suolo.
HEIGHT_TYPE_AMSL L'altezza del sistema AMSL viene misurata rispetto al livello medio del mare.

Parametri di installazione

Informazioni sui parametri di installazione del dispositivo.

Campi
latitude

DoubleValue

Latitudine della posizione dell'antenna del dispositivo in gradi rispetto all'origine WGS 84. L'intervallo consentito va da -90.000000 a +90.000000. I valori positivi rappresentano le latitudini a nord dell'equatore, mentre i valori negativi a sud dell'equatore.

longitude

DoubleValue

Longitudine della posizione dell'antenna del dispositivo in gradi rispetto all'origine WGS 84. L'intervallo consentito va da -180.000000 a +180.000000. I valori positivi rappresentano le longitudini a est del meridiano zero; i valori negativi a ovest del meridiano zero.

height

DoubleValue

Altezza dell'antenna del dispositivo in metri. Quando il valore del parametro heightType è "AGL", l'altezza dell'antenna deve essere indicata in relazione al livello del suolo. Quando il valore del parametro heightType è "AMSL", viene dato in relazione alla data WGS84.

height_type

HeightType

Specifica come viene misurata l'altezza.

horizontal_accuracy

DoubleValue

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 valore è inferiore al requisito FCC (50 metri).

vertical_accuracy

DoubleValue

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 valore è inferiore al requisito FCC di 3 metri.

indoor_deployment

BoolValue

Indica se l'antenna del dispositivo è al chiuso o meno. true: indoor. false: all'aperto.

antenna_azimuth

Int32Value

Direzione del campo visivo del piano orizzontale dell'antenna in gradi rispetto al nord effettivo. Il valore di questo parametro è un numero intero con un valore compreso tra 0 e 359 inclusi. Un valore di 0 gradi significa vero nord; un valore di 90 gradi significa est. Questo parametro è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B.

antenna_downtilt

Int32Value

L'antenna si inclina verso il basso ed è un numero intero con un valore compreso tra -90 e +90 inclusi; un valore negativo indica che l'antenna è inclinata (sopra l'orizzontale). Questo parametro è facoltativo per i dispositivi di categoria A e condizionale per i dispositivi di categoria B.

antenna_gain

Int32Value

Guadagno massimo dell'antenna in dBi. Questo parametro è un numero intero con un valore compreso tra -127 e +128 (dBi) inclusi.

eirp_capability

Int32Value

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 massimo EIRP consentito in unità di dBm/10 MHz per la categoria del dispositivo.

antenna_beamwidth

Int32Value

Larghezza del fascio dell'antenna di 3 dB sul piano orizzontale in gradi. Questo parametro è un numero intero senza segno con un valore compreso tra 0 e 360 (gradi) facoltativo. È facoltativo per i dispositivi di Categoria A e condizionato per i dispositivi di Categoria B.

antenna_model

string

Se si utilizza un'antenna esterna, in questo campo viene facoltativamente fornito il modello dell'antenna. La stringa ha una lunghezza massima di 128 ottetti.

cpe_cbsd_indication

BoolValue

Se presente, questo parametro specifica se CBSD è un CPE-CBSD o meno.

ListCustomersRequest

Richiesta di ListCustomers.

Campi
page_size

int32

Il numero massimo di customers da restituire nella risposta.

page_token

string

Un token di impaginazione restituito da una chiamata precedente a ListCustomers che indica la posizione da cui deve continuare la scheda.

ListCustomersResponse

Risposta per ListCustomers.

Campi
customers[]

Customer

L'elenco di customers che corrispondono alla richiesta.

next_page_token

string

Un token di impaginazione restituito da una chiamata precedente a ListCustomers che indica da dove deve continuare la scheda. Se il campo è mancante o vuoto, significa che non sono presenti altri clienti.

Richiesta ListDeployments

Richiesta di ListDeployments.

Campi
parent

string

Obbligatorio. Il nome della risorsa padre, ad esempio "nodi/1", cliente/1/nodi/2.

page_size

int32

Il numero massimo di deployment da restituire nella risposta.

page_token

string

Un token di impaginazione restituito da una chiamata precedente a ListDeployments che indica la posizione da cui deve continuare la scheda.

filter

string

L'espressione di filtro. Il filtro deve avere il seguente formato: "DIRECT_CHILDREN" o formato: "direct_children". Il filtro non è sensibile alle maiuscole. Se viene lasciato vuoto, nessun deployment viene filtrato.

ListDeploymentsResponse

Risposta per ListDeployments.

Campi
deployments[]

Deployment

I deployments corrispondenti alla richiesta.

next_page_token

string

Un token di impaginazione restituito da una chiamata precedente a ListDeployments che indica da dove deve continuare la scheda. Se il campo è mancante o vuoto, significa che non sono presenti altri deployment.

ListDevicesRequest

Richiesta di ListDevices.

Campi
parent

string

Obbligatorio. Il nome della risorsa padre.

page_size

int32

Il numero massimo di dispositivi da restituire nella risposta. Se il campo viene lasciato vuoto o impostato su zero, verranno elencati tutti i dispositivi. Il valore deve essere compreso nell'intervallo [0, 1000].

page_token

string

Un token di impaginazione restituito da una chiamata precedente a ListDevices che indica la posizione da cui deve continuare la scheda.

filter

string

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[]

Device

I devices corrispondenti alla richiesta.

next_page_token

string

Un token di impaginazione restituito da una chiamata precedente a ListDevices che indica da dove deve continuare la scheda. Se il campo è mancante o vuoto, significa che non ci sono altri dispositivi.

RichiestaNoNo

Richiesta di ListNodes.

Campi
parent

string

Obbligatorio. Il nome della risorsa padre, ad esempio "nodi/1".

page_size

int32

Il numero massimo di nodi da restituire nella risposta.

page_token

string

Un token di impaginazione restituito da una chiamata precedente a ListNodes che indica la posizione da cui deve continuare la scheda.

filter

string

L'espressione di filtro. Il filtro deve avere il seguente formato: "DIRECT_CHILDREN" o formato: "direct_children". Il filtro non è sensibile alle maiuscole. Se viene lasciato vuoto, nessun nodo viene filtrato.

ListNodesResponse

Risposta per ListNodes.

Campi
nodes[]

Node

I nodes corrispondenti alla richiesta.

next_page_token

string

Un token di impaginazione restituito da una chiamata precedente a ListNodes che indica da dove deve continuare la scheda. Se il campo è mancante o vuoto, significa che non ci sono altri nodi.

Funzionalità di misurazione

Funzionalità di misurazione dei dispositivi. I valori sono definiti da WINNF-SSC-0002.

Enum
MEASUREMENT_CAPABILITY_UNSPECIFIED
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT

richiesta di spostamento

Richiesta di MoveDeployment.

Campi
name

string

Obbligatorio. Il nome di deployment da spostare.

destination

string

Obbligatorio. Il nome della nuova risorsa padre node o customer in base al quale eseguire il deployment.

Sposta richiesta dispositivo

Richiesta di MoveDevice.

Campi
name

string

Obbligatorio. Il nome del dispositivo da spostare.

destination

string

Obbligatorio. Il nome della nuova risorsa principale node o customer in cui assegnare di nuovo il dispositivo.

richiesta trasferimentoNode

Richiesta di MoveNode.

Campi
name

string

Obbligatorio. Il nome di node da spostare.

destination

string

Obbligatorio. Il nome della nuova risorsa principale node o customer in cui riposizionare il nodo.

Nodo

Il nodo

Campi
name

string

Solo output. Nome della risorsa.

display_name

string

Il nome visualizzato del nodo.

sas_user_ids[]

string

ID utente utilizzati dai dispositivi che appartengono a questo nodo.

Norme

Definisce un criterio di controllo dell'accesso alle risorse.

Campi
assignments[]

Assignment

Elenco di assignments

etag

bytes

L'etag viene utilizzato per il controllo ottimistico della contemporaneità come metodo per impedire la sovrascrittura reciproca degli aggiornamenti di un criterio. Consigliamo vivamente ai sistemi di utilizzare l'etag nel ciclo di lettura-modifica-scrittura per eseguire aggiornamenti dei criteri al fine di evitare condizioni di gara: viene restituito un etag nella risposta a GetPolicy e i sistemi sono tenuti a inserire l'etag nella richiesta a SetPolicy per garantire che la propria modifica venga applicata alla stessa versione del criterio.

Se nella chiamata a GetPolicy non viene fornito un tag, il criterio esistente viene sovrascritto completamente.

SetPolicyRequest

Messaggio di richiesta per il metodo SetPolicy.

Campi
resource

string

Obbligatorio. La risorsa per cui viene specificato il criterio. Questo criterio sostituisce qualsiasi criterio esistente.

policy

Policy

Obbligatorio. Il criterio da applicare a resource.

SignSignRequest

Richiesta di SignDevice.

Campi
device

Device

Obbligatorio. La device per firmare. Devono essere impostati i campi device name, fcc_id e serial_number. Il campo user_id deve essere impostato.

Richiesta autorizzazioni di test

Messaggio di richiesta per il metodo TestPermissions.

Campi
resource

string

Obbligatorio. La risorsa per cui si richiedono le autorizzazioni.

permissions[]

string

Insieme di autorizzazioni da controllare per resource.

RispostaAutorizzazioni di test

Messaggio di risposta per il metodo TestPermissions.

Campi
permissions[]

string

Insieme di autorizzazioni consentite al chiamante.

UpdateCustomerRequest

Richiesta di UpdateCustomer.

Campi
customer

Customer

Obbligatorio. I nuovi valori per customer. Per il cliente devono essere impostati name e display_name.

update_mask

FieldMask

Campi da aggiornare.

Aggiornamento richiesta di deployment

Richiesta di UpdateDeployment.

Campi
deployment

Deployment

Obbligatorio. I nuovi valori per deployment. È necessario impostare name e display_name.

update_mask

FieldMask

Campi da aggiornare.

UpdateDeviceRequest

Richiesta di UpdateDevice.

Campi
device

Device

Obbligatorio. Il device da aggiornare. Devono essere impostati i campi device name, fcc_id e serial_number. Il campo user_id deve essere impostato.

update_mask

FieldMask

Campi da aggiornare.

UpdateNodeRequest

Richiesta di UpdateNode.

Campi
node

Node

Obbligatorio. I nuovi valori per node. È necessario impostare name e display_name.

update_mask

FieldMask

Campi da aggiornare.

UpdateSignedDeviceRequest

Richiesta di UpdateSignedDevice.

Campi
name

string

Obbligatorio. Il nome del dispositivo da aggiornare.

encoded_device

bytes

Obbligatorio. Il token web JSON firmato utilizzando una chiave privata CPI. Il payload deve essere la codifica JSON di device. Il campo user_id deve essere impostato.

installer_id

string

Obbligatorio. ID univoco del programma di installazione (ID CPI) dal database dei programmi di installazione certificati certificati.

ConvalidaInstallerRequest

Richiesta di ValidateInstaller.

Campi
installer_id

string

Obbligatorio. ID di installazione univoco (ID CPI) dal database dei programmi di installazione certificati certificati.

secret

string

Obbligatorio. Il secret è stato restituito da GenerateSecret.

encoded_secret

string

Obbligatorio. JSON Web Token firmato utilizzando una chiave privata CPI. Il carico di lavoro deve includere un "segreto" dichiarazione il cui valore è il segreto.

ValidateInstallerResponse

Risposta per ValidateInstaller.