Índice
Customers(interface)DeviceManager(interface)PolicyService(interface)Assignment(mensagem)BillingMode(enum)ChannelType(enum)CreateDeploymentRequest(mensagem)CreateDeviceRequest(mensagem)CreateNodeRequest(mensagem)CreateSignedDeviceRequest(mensagem)Customer(mensagem)DeleteDeploymentRequest(mensagem)DeleteDeviceRequest(mensagem)DeleteNodeRequest(mensagem)Deployment(mensagem)Device(mensagem)Device.State(enum)DeviceAirInterface(mensagem)DeviceAirInterface.RadioTechnology(enum)DeviceCategory(enum)DeviceConfig(mensagem)DeviceConfig.State(enum)DeviceGrant(mensagem)DeviceMetadata(mensagem)DeviceModel(mensagem)DpaMoveList(mensagem)FrequencyRange(mensagem)GenerateSecretRequest(mensagem)GenerateSecretResponse(mensagem)GetCustomerRequest(mensagem)GetDeploymentRequest(mensagem)GetDeviceRequest(mensagem)GetNodeRequest(mensagem)GetPolicyRequest(mensagem)GrantState(enum)HeightType(enum)InstallationParams(mensagem)ListCustomersRequest(mensagem)ListCustomersResponse(mensagem)ListDeploymentsRequest(mensagem)ListDeploymentsResponse(mensagem)ListDevicesRequest(mensagem)ListDevicesResponse(mensagem)ListNodesRequest(mensagem)ListNodesResponse(mensagem)MeasurementCapability(enum)MoveDeploymentRequest(mensagem)MoveDeviceRequest(mensagem)MoveNodeRequest(mensagem)Node(mensagem)Policy(mensagem)SetPolicyRequest(mensagem)SignDeviceRequest(mensagem)TestPermissionsRequest(mensagem)TestPermissionsResponse(mensagem)UpdateCustomerRequest(mensagem)UpdateDeploymentRequest(mensagem)UpdateDeviceRequest(mensagem)UpdateNodeRequest(mensagem)UpdateSignedDeviceRequest(mensagem)ValidateInstallerRequest(mensagem)ValidateInstallerResponse(mensagem)
Clientes
Serviço que gerencia clientes do SAS.
| GetCustomer | |
|---|---|
|
Retorna um
|
|
| ListCustomers | |
|---|---|
|
Retorna uma lista de
|
|
| UpdateCustomer | |
|---|---|
|
Atualiza um
|
|
DeviceManager
Serviço que gerencia dispositivos de serviço de rádio de banda larga dos cidadãos.
| CreateDeployment | |
|---|---|
|
Crie um novo
|
|
| CreateDevice | |
|---|---|
|
Cria um
|
|
| CreateNode | |
|---|---|
|
Crie um novo
|
|
| CreateSignedDevice | |
|---|---|
|
Cria um
|
|
| DeleteDeployment | |
|---|---|
|
Exclui um
|
|
| DeleteDevice | |
|---|---|
|
Exclui um
|
|
| DeleteNode | |
|---|---|
|
Exclui um
|
|
| GenerateSecret | |
|---|---|
|
Gera um secret para ser usado com o
|
|
| GetDeployment | |
|---|---|
|
Retorna um
|
|
| GetDevice | |
|---|---|
|
Recebe detalhes sobre um
|
|
| GetNode | |
|---|---|
|
Retorna um
|
|
| ListDeployments | |
|---|---|
|
Lista
|
|
| ListDevices | |
|---|---|
|
Lista
|
|
| ListNodes | |
|---|---|
|
Lista
|
|
| MoveDeployment | |
|---|---|
|
Move um
|
|
| MoveDevice | |
|---|---|
|
Move um
|
|
| MoveNode | |
|---|---|
|
Move um
|
|
| SignDevice | |
|---|---|
|
Assina um
|
|
| UpdateDeployment | |
|---|---|
|
Atualiza um
|
|
| UpdateDevice | |
|---|---|
|
Atualiza um
|
|
| UpdateNode | |
|---|---|
|
Atualiza um
|
|
| UpdateSignedDevice | |
|---|---|
|
Atualiza um
|
|
| ValidateInstaller | |
|---|---|
|
Valida a identidade de um instalador profissional certificado (CPI, na sigla em inglês).
|
|
PolicyService
Serviço de controle de acesso ao gerenciador de recursos de espectro.
| GetPolicy | |
|---|---|
|
Busca a política de controle de acesso de um recurso. Retornará uma política vazia se o recurso estiver presente e não tiver um conjunto de políticas.
|
|
| SetPolicy | |
|---|---|
|
Define a política de controle de acesso no recurso especificado. Substitui qualquer política existente.
|
|
| TestPermissions | |
|---|---|
|
Retorna permissões do autor da chamada no recurso especificado.
|
|
Atribuição
Associa members a um role.
| Campos | |
|---|---|
role |
Obrigatório. Papel atribuído aos |
members[] |
As identidades a que a função está atribuída. Pode ter os seguintes valores:
|
BillingMode
Modo de faturamento de um CBSD
| Enums | |
|---|---|
BILLING_MODE_UNSPECIFIED |
O modo de faturamento não foi especificado. |
MOBILE |
O preço é baseado na categoria do CBSD: categoria A, categoria B registrada com SAS. |
FIXED_WIRELESS |
O preço é baseado no tipo de CBSD: estação base ou CPE. |
ChannelType
| Enums | |
|---|---|
CHANNEL_TYPE_UNSPECIFIED |
|
CHANNEL_TYPE_GAA |
|
CHANNEL_TYPE_PAL |
|
CreateDeploymentRequest
Solicitação de CreateDeployment.
| Campos | |
|---|---|
parent |
Obrigatório. O nome do recurso pai em que a implantação será criada. |
deployment |
Obrigatório. Os detalhes da implantação. O |
CreateDeviceRequest
Solicitação de CreateDevice.
| Campos | |
|---|---|
parent |
Obrigatório. O nome do recurso pai. |
device |
Os detalhes do registro |
CreateNodeRequest
Solicitação de CreateNode.
| Campos | |
|---|---|
parent |
Obrigatório. O nome do recurso pai em que o nó será criado. |
node |
Os detalhes do nó. O |
CreateSignedDeviceRequest
Solicitação de CreateSignedDevice.
| Campos | |
|---|---|
parent |
Obrigatório. O nome do recurso pai. |
encoded_device |
Obrigatório. JSON Web Token assinado usando uma chave privada de CPI. O payload precisa ser a codificação JSON do |
installer_id |
Obrigatório. ID exclusivo do instalador (ID da CPI) do banco de dados de instaladores profissionais certificados. |
Cliente
Entidade que representa um cliente do SAS.
| Campos | |
|---|---|
name |
Apenas saída. Nome do recurso do cliente. |
display_name |
Obrigatório. Nome da organização que a entidade do cliente representa. |
sas_user_ids[] |
IDs de usuário usados pelos dispositivos pertencentes a esse cliente. |
DeleteDeploymentRequest
Solicitação de DeleteDeployment.
| Campos | |
|---|---|
name |
Obrigatório. O nome do |
DeleteDeviceRequest
Solicitação de DeleteDevice.
| Campos | |
|---|---|
name |
Obrigatório. O nome do dispositivo. |
DeleteNodeRequest
Solicitação de DeleteNode.
| Campos | |
|---|---|
name |
Obrigatório. O nome do |
Implantação
A implantação.
| Campos | |
|---|---|
name |
Apenas saída. Nome do recurso. |
display_name |
O nome de exibição da implantação. |
sas_user_ids[] |
ID do usuário usado pelos dispositivos pertencentes a essa implantação. Cada implantação precisa estar associada a um User ID exclusivo. |
default_billing_mode |
Modo de faturamento padrão para a implantação e os dispositivos nela. |
allowed_billing_modes[] |
Os modos de faturamento permitidos nesta implantação. |
Dispositivo
| Campos | |
|---|---|
name |
Apenas saída. O nome do caminho do recurso. |
fcc_id |
O identificador da FCC do dispositivo. |
serial_number |
Um número de série atribuído ao dispositivo pelo fabricante. |
preloaded_config |
Configuração do dispositivo, conforme especificado pela API do portal do SAS. |
active_config |
Apenas saída. Configuração atual do dispositivo conforme registrado no SAS. |
state |
Apenas saída. Estado do dispositivo. |
grants[] |
Apenas saída. Concessões mantidas pelo dispositivo. |
display_name |
Nome de exibição do dispositivo. |
device_metadata |
Parâmetros do dispositivo que podem ser substituídos pelo portal do SAS e pelas solicitações de registro do SAS. |
Estado
Estado do dispositivo.
| Enums | |
|---|---|
DEVICE_STATE_UNSPECIFIED |
Estado não especificado. |
RESERVED |
O dispositivo foi criado no portal da SAS, mas ainda não foi registrado na SAS. |
REGISTERED |
O dispositivo foi registrado com o SAS. |
DEREGISTERED |
O dispositivo foi cancelado do registro com o SAS. |
DeviceAirInterface
Informações sobre a interface aérea do dispositivo.
| Campos | |
|---|---|
radio_technology |
Condicional. Este campo especifica a tecnologia de acesso de rádio usada para o CBSD. |
supported_spec |
Opcional. Esse campo está relacionado ao |
RadioTechnology
Os tipos aprovados de tecnologia de acesso por rádio.
| Enums | |
|---|---|
RADIO_TECHNOLOGY_UNSPECIFIED |
|
E_UTRA |
|
CAMBIUM_NETWORKS |
|
FOUR_G_BBW_SAA_1 |
|
NR |
|
DOODLE_CBRS |
|
CW |
|
REDLINE |
|
TARANA_WIRELESS |
|
DeviceCategory
Categoria da FCC do dispositivo, conforme definido na Parte 96.
| Enums | |
|---|---|
DEVICE_CATEGORY_UNSPECIFIED |
Categoria de dispositivo não especificada. |
DEVICE_CATEGORY_A |
Categoria A. |
DEVICE_CATEGORY_B |
Categoria B. |
DeviceConfig
Informações sobre a configuração do dispositivo.
| Campos | |
|---|---|
category |
Categoria do dispositivo de acordo com a FCC. |
model |
Informações sobre este modelo de dispositivo. |
air_interface |
Informações sobre a interface aérea deste dispositivo. |
installation_params |
Parâmetros de instalação do dispositivo. |
measurement_capabilities[] |
Recursos de relatórios de medição do dispositivo. |
user_id |
O identificador de um usuário do dispositivo. |
call_sign |
O indicativo de chamada do operador do dispositivo. |
state |
Estado da configuração. |
is_signed |
Apenas saída. Indica se a configuração foi assinada por um CPI. |
update_time |
Apenas saída. A última vez que a configuração do dispositivo foi editada. |
Estado
Estado da configuração do dispositivo. Somente as configurações no estado DEVICE_CONFIG_STATE_FINAL podem ser usadas durante o registro do CBSD.
| Enums | |
|---|---|
DEVICE_CONFIG_STATE_UNSPECIFIED |
|
DRAFT |
|
FINAL |
|
DeviceGrant
Concessão de dispositivo. É uma autorização fornecida pelo Sistema de acesso ao espectro a um dispositivo para transmitir usando parâmetros operacionais especificados após um sinal de pulso bem-sucedido do dispositivo.
| Campos | |
|---|---|
max_eirp |
Potência isotrópica irradiada equivalente (EIRP) máxima permitida pela concessão. O EIRP máximo está em unidades de dBm/MHz. O valor de |
frequency_range |
O intervalo de frequência de transmissão. |
state |
Estado da concessão. |
channel_type |
Tipo de canal usado. |
move_list[] |
As listas de movimentação de DPA em que essa concessão aparece. |
expire_time |
O prazo de validade da concessão. |
suspension_reason[] |
Se a concessão for suspensa, os motivos da suspensão. |
grant_id |
ID da concessão. |
DeviceMetadata
Dados do dispositivo substituíveis pelo Portal do SAS e por solicitações de registro.
DeviceModel
Informações sobre o modelo do dispositivo.
| Campos | |
|---|---|
vendor |
O nome do fornecedor do dispositivo. |
name |
O nome do modelo do dispositivo. |
software_version |
A versão do software do dispositivo. |
hardware_version |
A versão do hardware do dispositivo. |
firmware_version |
A versão do firmware do dispositivo. |
DpaMoveList
Uma entrada na lista de movimentação de um DPA.
| Campos | |
|---|---|
dpa_id |
O ID da DPA. |
frequency_range |
O intervalo de frequência afetado pela lista de movimentos. |
FrequencyRange
Intervalo de frequência de low_frequency a high_frequency.
| Campos | |
|---|---|
low_frequency_mhz |
A menor frequência do intervalo em MHz. |
high_frequency_mhz |
A maior frequência do intervalo de frequência em MHz. |
GenerateSecretRequest
Solicitação de GenerateSecret.
GenerateSecretResponse
Resposta para GenerateSecret.
| Campos | |
|---|---|
secret |
O secret gerado pela string e usado por |
GetCustomerRequest
Solicitação de GetCustomer .
| Campos | |
|---|---|
name |
Obrigatório. O nome do |
GetDeploymentRequest
Solicitação de GetDeployment.
| Campos | |
|---|---|
name |
Obrigatório. O nome do |
GetDeviceRequest
Solicitação de GetDevice.
| Campos | |
|---|---|
name |
Obrigatório. O nome do dispositivo. |
GetNodeRequest
Solicitação de GetNode.
| Campos | |
|---|---|
name |
Obrigatório. O nome do |
GetPolicyRequest
Solicite uma mensagem para o método GetPolicy.
| Campos | |
|---|---|
resource |
Obrigatório. O recurso para o qual a política está sendo solicitada. |
GrantState
O estado da concessão.
| Enums | |
|---|---|
GRANT_STATE_UNSPECIFIED |
|
GRANT_STATE_GRANTED |
A concessão foi feita, mas o dispositivo não está enviando pulsações nela. |
GRANT_STATE_TERMINATED |
A concessão foi encerrada pelo SAS. |
GRANT_STATE_SUSPENDED |
A concessão foi suspensa pelo SAS. |
GRANT_STATE_AUTHORIZED |
O dispositivo está transmitindo no momento. |
GRANT_STATE_EXPIRED |
A concessão expirou. |
HeightType
Especifica como a altura é medida.
| Enums | |
|---|---|
HEIGHT_TYPE_UNSPECIFIED |
Tipo de altura não especificado. |
HEIGHT_TYPE_AGL |
A altura AGL é medida em relação ao nível do solo. |
HEIGHT_TYPE_AMSL |
A altura AMSL é medida em relação ao nível médio do mar. |
InstallationParams
Informações sobre os parâmetros de instalação do dispositivo.
| Campos | |
|---|---|
latitude |
Latitude do local da antena do dispositivo em graus em relação ao datum WGS 84. O intervalo permitido é de -90.000000 a +90.000000. Valores positivos representam latitudes ao norte do equador, e valores negativos representam latitudes ao sul. |
longitude |
Longitude do local da antena do dispositivo em graus em relação ao datum WGS 84. O intervalo permitido é de -180.000000 a +180.000000. Valores positivos representam longitudes a leste do meridiano principal, e valores negativos a oeste. |
height |
Altura da antena do dispositivo em metros. Quando o valor do parâmetro |
height_type |
Especifica como a altura é medida. |
horizontal_accuracy |
Um número positivo em metros para indicar a precisão da localização horizontal da antena do dispositivo. Esse parâmetro opcional só deve estar presente se o valor dele for menor que a exigência da FCC de 50 metros. |
vertical_accuracy |
Um número positivo em metros para indicar a precisão da localização vertical da antena do dispositivo. Esse parâmetro opcional só deve estar presente se o valor dele for menor que o requisito da FCC de 3 metros. |
indoor_deployment |
Se a antena do dispositivo está em um ambiente interno ou não. |
antenna_azimuth |
Direção de mira do plano horizontal da antena em graus em relação ao norte verdadeiro. O valor desse parâmetro é um número inteiro entre 0 e 359, inclusive. Um valor de 0 grau significa norte verdadeiro, e um valor de 90 graus significa leste. Esse parâmetro é opcional para dispositivos da categoria A e condicional para dispositivos da categoria B. |
antenna_downtilt |
Inclinação vertical da antena em graus, um número inteiro com um valor entre -90 e +90, inclusive. Um valor negativo significa que a antena está inclinada para cima (acima da horizontal). Esse parâmetro é opcional para dispositivos da categoria A e condicional para dispositivos da categoria B. |
antenna_gain |
Ganho máximo da antena em dBi. Esse parâmetro é um número inteiro com um valor entre -127 e +128 (dBi), inclusive. |
eirp_capability |
Esse parâmetro é o EIRP máximo do dispositivo em unidades de dBm/10MHz e é um número inteiro com um valor entre -127 e +47 (dBm/10 MHz), inclusive. Se não for incluído, o SAS vai interpretar como a potência isotrópica radiada equivalente máxima permitida em unidades de dBm/10MHz para a categoria do dispositivo. |
antenna_beamwidth |
Largura do feixe de antena de 3 dB da antena no plano horizontal em graus. Esse parâmetro é um número inteiro sem sinal com um valor entre 0 e 360 (graus), inclusive. Ele é opcional para dispositivos da categoria A e condicional para dispositivos da categoria B. |
antenna_model |
Se uma antena externa for usada, o modelo dela poderá ser informado neste campo. A string tem um comprimento máximo de 128 octetos. |
cpe_cbsd_indication |
Se presente, esse parâmetro especifica se o CBSD é um CPE-CBSD ou não. |
ListCustomersRequest
Solicitação de ListCustomers.
| Campos | |
|---|---|
page_size |
O número máximo de |
page_token |
Um token de paginação retornou de uma chamada anterior para |
ListCustomersResponse
Resposta para ListCustomers.
| Campos | |
|---|---|
customers[] |
A lista de |
next_page_token |
Um token de paginação retornado de uma chamada anterior para |
ListDeploymentsRequest
Solicitação de ListDeployments.
| Campos | |
|---|---|
parent |
Obrigatório. O nome do recurso pai, por exemplo, "nodes/1", customer/1/nodes/2. |
page_size |
O número máximo de implantações a serem retornadas na resposta. |
page_token |
Um token de paginação retornou de uma chamada anterior para |
filter |
A expressão do filtro. O filtro precisa ter o seguinte formato: "DIRECT_CHILDREN" ou "direct_children". O filtro não diferencia maiúsculas de minúsculas. Se estiver vazio, nenhuma implantação será filtrada. |
ListDeploymentsResponse
Resposta para ListDeployments.
| Campos | |
|---|---|
deployments[] |
As |
next_page_token |
Um token de paginação retornado de uma chamada anterior para |
ListDevicesRequest
Solicitação de ListDevices.
| Campos | |
|---|---|
parent |
Obrigatório. O nome do recurso pai. |
page_size |
O número máximo de dispositivos a serem retornados na resposta. Se estiver vazio ou for zero, todos os dispositivos serão listados. Precisa estar no intervalo [0, 1000]. |
page_token |
Um token de paginação retornou de uma chamada anterior para |
filter |
A expressão do filtro. O filtro precisa ter um dos seguintes formatos: "sn=123454" ou "display_name=MyDevice". "sn" corresponde ao número de série do dispositivo. O filtro não diferencia maiúsculas de minúsculas. |
ListDevicesResponse
Resposta para ListDevices.
| Campos | |
|---|---|
devices[] |
As |
next_page_token |
Um token de paginação retornado de uma chamada anterior para |
ListNodesRequest
Solicitação de ListNodes.
| Campos | |
|---|---|
parent |
Obrigatório. O nome do recurso pai, por exemplo, "nodes/1". |
page_size |
O número máximo de nós a serem retornados na resposta. |
page_token |
Um token de paginação retornou de uma chamada anterior para |
filter |
A expressão do filtro. O filtro precisa ter o seguinte formato: "DIRECT_CHILDREN" ou "direct_children". O filtro não diferencia maiúsculas de minúsculas. Se estiver vazio, nenhum nó será filtrado. |
ListNodesResponse
Resposta para ListNodes.
| Campos | |
|---|---|
nodes[] |
As |
next_page_token |
Um token de paginação retornado de uma chamada anterior para |
MeasurementCapability
Capacidade de medição do dispositivo. Os valores são definidos por WINNF-SSC-0002.
| Enums | |
|---|---|
MEASUREMENT_CAPABILITY_UNSPECIFIED |
|
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITH_GRANT |
|
MEASUREMENT_CAPABILITY_RECEIVED_POWER_WITHOUT_GRANT |
|
MoveDeploymentRequest
Solicitação de MoveDeployment.
| Campos | |
|---|---|
name |
Obrigatório. O nome do |
destination |
Obrigatório. O nome do novo recurso pai |
MoveDeviceRequest
Solicitação de MoveDevice.
| Campos | |
|---|---|
name |
Obrigatório. O nome do dispositivo a ser movido. |
destination |
Obrigatório. O nome do novo recurso pai |
MoveNodeRequest
Solicitação de MoveNode.
| Campos | |
|---|---|
name |
Obrigatório. O nome do |
destination |
Obrigatório. O nome do novo recurso pai |
Nó
O nó.
| Campos | |
|---|---|
name |
Apenas saída. Nome do recurso. |
display_name |
O nome de exibição do nó. |
sas_user_ids[] |
IDs de usuário usados pelos dispositivos pertencentes a este nó. |
Política
Define uma política de controle de acesso aos recursos.
| Campos | |
|---|---|
assignments[] |
Lista de |
etag |
A ETag é usada para controle de simultaneidade otimista como uma maneira de evitar que atualizações simultâneas de uma política substituam umas às outras. É altamente recomendável que os sistemas usem a ETag no ciclo de leitura-modificação-gravação para realizar atualizações de política e evitar disputas. Uma ETag é retornada na resposta a Se nenhuma etag for fornecida na chamada a |
SetPolicyRequest
Solicite uma mensagem para o método SetPolicy.
| Campos | |
|---|---|
resource |
Obrigatório. O recurso para que a política está sendo especificada. Essa política substitui qualquer política atual. |
policy |
Obrigatório. A política a ser aplicada ao |
SignDeviceRequest
Solicitação de SignDevice.
| Campos | |
|---|---|
device |
Obrigatório. O |
TestPermissionsRequest
Solicite uma mensagem para o método TestPermissions.
| Campos | |
|---|---|
resource |
Obrigatório. O recurso para o qual as permissões estão sendo solicitadas. |
permissions[] |
O conjunto de permissões a serem verificadas para o |
TestPermissionsResponse
Mensagem de resposta para o método TestPermissions.
| Campos | |
|---|---|
permissions[] |
Um conjunto de permissões que o autor da chamada tem. |
UpdateCustomerRequest
Solicitação de UpdateCustomer.
| Campos | |
|---|---|
customer |
Obrigatório. Os novos valores para o |
update_mask |
Campos a serem atualizados. |
UpdateDeploymentRequest
Solicitação de UpdateDeployment.
| Campos | |
|---|---|
deployment |
Obrigatório. Os novos valores para o |
update_mask |
Campos a serem atualizados. |
UpdateDeviceRequest
Solicitação de UpdateDevice.
| Campos | |
|---|---|
device |
Obrigatório. O |
update_mask |
Campos a serem atualizados. |
UpdateNodeRequest
Solicitação de UpdateNode.
| Campos | |
|---|---|
node |
Obrigatório. Os novos valores para o |
update_mask |
Campos a serem atualizados. |
UpdateSignedDeviceRequest
Solicitação de UpdateSignedDevice.
| Campos | |
|---|---|
name |
Obrigatório. O nome do dispositivo a ser atualizado. |
encoded_device |
Obrigatório. O JSON Web Token assinado usando uma chave privada da CPI. O payload precisa ser a codificação JSON do |
installer_id |
Obrigatório. ID exclusivo do instalador (ID da CPI) do banco de dados de instaladores profissionais certificados. |
ValidateInstallerRequest
Solicitação de ValidateInstaller.
| Campos | |
|---|---|
installer_id |
Obrigatório. ID exclusivo do instalador (ID da CPI) do banco de dados de instaladores profissionais certificados. |
secret |
Obrigatório. Secret retornado pelo |
encoded_secret |
Obrigatório. JSON Web Token assinado usando uma chave privada de CPI. O payload precisa incluir uma declaração "secret" cujo valor seja o secret. |
ValidateInstallerResponse
Resposta para ValidateInstaller.