Visão geral dos serviços gNOI

Os dispositivos Junos oferecem suporte aos serviços gNOI e RPCs descritos neste tópico.

A interface de operações de rede gRPC (gNOI) define serviços para executar comandos operacionais em dispositivos de rede. O OpenConfig define as operações (RPCs) e as estruturas de dados (mensagens) para cada serviço em arquivos de protodefinição. Os arquivos proto com a lista completa de RPCs gNOI estão localizados no repositório OpenConfig gNOI GitHub em https://github.com/openconfig/gnoi. Os dispositivos Junos oferecem suporte a um subconjunto dos serviços e RPCs, conforme descrito nas seções a seguir.

Visão geral dos serviços suportados

A Tabela 1 descreve os serviços gNOI suportados em dispositivos Junos. A tabela lista a versão na qual o suporte começa para a versão fornecida do arquivo proto.

Tabela 1: Serviços gNOI suportados
Serviço	Suporte para iniciar a versão	Versão do arquivo Proto
`CertificateManagement`	Junos OS Evolved versão 22.2R1	0.2.0
`Diag`	Junos OS Evolved versão 22.2R1	0.1.0
`File`	Junos OS Evolved versão 22.2R1	0.1.0
`Layer2`	Junos OS e Junos OS Evolved versão 24.2R1	0.1.0
`LinkQualification`	Junos OS Evolved 25.2X100D20	1.1.0
`OS`	Junos OS Evolved versão 22.2R1	0.1.1
`System`	Junos OS Evolved versão 22.2R1	1.0.0

Serviço CertificateManagement

Tabela 2: RPCs cert.proto com suporte
RPC	Descrição	Introduzido na versão
`CanGenerateCSR()`	Consulte o dispositivo de destino para determinar se ele pode gerar uma solicitação de assinatura de certificado (CSR) com o tipo de chave, o tamanho da chave e o tipo de certificado especificados. Valores suportados: Tipo de chave: KT_RSA Tamanhos das chaves: 1024, 2048, 4096 Tipo de certificado: CT_X509 Retorna `True` se o servidor gNOI suporta o tipo de chave, o tamanho da chave e o tipo de certificado específicos.	Junos OS Evolved 23.1R1
`GenerateCSR()`	Gerar e retornar uma solicitação de assinatura de certificado (CSR).	Junos OS Evolved 22.2R1
`GetCertificates()`	Retorne os certificados locais carregados no dispositivo de destino.	Junos OS Evolved 22.2R1
`Install()`	Carregue um novo certificado no dispositivo de destino criando uma solicitação de CSR, gerando um certificado com base no CSR e carregando o certificado usando uma nova ID de certificado.	Junos OS Evolved 22.2R1
`LoadCertificate()`	Carregue um certificado assinado por uma autoridade de certificação (CA) no dispositivo de destino.	Junos OS Evolved 22.2R1
`LoadCertificateAuthorityBundle()`	Carregue um pacote de certificado de CA no dispositivo de destino.	Junos OS Evolved 22.2R1
`RevokeCertificates()`	Revogue os certificados com as IDs de certificado especificadas no dispositivo de destino.	Junos OS Evolved 23.1R1
`Rotate()`	Substitua um certificado existente no dispositivo de destino criando uma solicitação de CSR, gerando um certificado com base no CSR e carregando o certificado usando uma ID de certificado existente.	Junos OS Evolved 22.2R1

Serviço de diagnóstico (diagnóstico)

Tabela 3: RPCs diag.proto suportados
RPC	Descrição	Introduzido na versão
`StartBERT()`	Inicie um BERT em um conjunto de portas. Os dispositivos Junos oferecem suporte aos seguintes padrões PRBS para BERTs gNOI: PRBS7 PRBS9 PRBS15 PRBS23 PRBS31	Junos OS Evolved 22.2R1
`StopBert()`	Pare um BERT já em andamento em um conjunto de portas.	Junos OS Evolved 22.2R1
`GetBERTResult()`	Obtenha os resultados do BERT durante o BERT ou após sua conclusão.	Junos OS Evolved 22.2R1

Serviço de arquivo

Tabela 4: RPCs file.proto suportados
RPC	Descrição	Introduzido na versão
`Get()`	Leia e transmita o conteúdo de um arquivo do destino. O arquivo é transmitido por mensagens sequenciais, cada mensagem contendo até 64 KB de dados. Uma mensagem final é enviada antes de fechar o fluxo que contém o hash dos dados enviados. A operação retornará um erro se o arquivo não existir ou se houver um erro ao ler o arquivo.	Junos OS Evolved 22.2R1
`Put()`	Transmita dados para um arquivo no destino. O arquivo é enviado em mensagens sequenciais, cada mensagem contendo até 64 KB de dados. Uma mensagem final deve ser enviada que inclua o hash dos dados. A operação retornará um erro se o local não existir ou se houver um erro ao gravar os dados. Se nenhuma soma de verificação for recebida, o destino removerá o arquivo parcialmente transmitido. Uma falha não alterará nenhum arquivo existente com o mesmo nome.	Junos OS Evolved 22.2R1
`Remove()`	Remova o arquivo especificado do destino. A operação retornará um erro se o arquivo não existir, se o caminho do arquivo for resolvido para um diretório ou se a operação de remoção encontrar um erro.	Junos OS Evolved 22.2R1
`Stat()`	Retorne metadados sobre um arquivo no dispositivo de destino. A operação retornará um erro se o arquivo não existir ou se houver um erro ao acessar os metadados.	Junos OS Evolved 22.2R1

Serviço de Camada 2

Tabela 5: RPCs layer2.proto suportados
RPC	Descrição	Introduzido na versão
`ClearLLDPInterface()`	Limpe todos os vizinhos LLDP da interface especificada.	Junos OS e Junos OS Evolved 24.2R1

Serviço de qualificação de links

Tabela 6: RPCs de qualificação de link com suporte
RPC	Descrição	Introduzido na versão
`Capabilities‎()`	Retorne se o dispositivo atende aos requisitos para realizar o teste.	Junos OS Evolved 25.2X100D20
`Create()`	Inicie um teste PBLQ em um conjunto de interfaces.	Junos OS Evolved 25.2X100D20
`Get()`	Retorne os resultados do teste.	Junos OS Evolved 25.2X100D20
`List()`	Liste os resultados dos testes que estão disponíveis para a interface especificada.	Junos OS Evolved 25.2X100D20
`Delete()`	Remova o teste especificado e seus resultados. Se o teste estiver em andamento, esse RPC cancelará e excluirá o teste.	Junos OS Evolved 25.2X100D20

Serviço de sistema operacional (SO)

Tabela 7: RPCs os.proto suportados
RPC	Descrição	Introduzido na versão
`Activate()`	Defina a versão do software usada na próxima reinicialização. `Activate()` Reinicializa o destino se o `no_reboot` sinalizador for omitido ou definido como `False`. Se a reinicialização falhar ao inicializar a versão de software solicitada, o destino será revertido para a versão anterior. Observação: Os dispositivos Junos não oferecem suporte ao `standby_supervisor` `ActivateRequest` campo na mensagem. Observação: Antes do Junos OS Evolved Release 25.2R1, `Activate()` valida a configuração atual em relação ao software, instala o software e define a versão do software como a próxima versão de inicialização.	Junos OS Evolved 22.2R1
`Install()`	Transfira um pacote de instalação de software para o destino, valide a configuração em relação ao software e instale (prepare) o software. Se a imagem de software especificada já estiver instalada no dispositivo, valide a configuração atual em relação à imagem de software e armazene a configuração validada como a configuração atual associada a essa versão de software. Observação: Os dispositivos Junos não oferecem suporte ao `standby_supervisor` `TransferRequest` campo na mensagem. Observação: Antes do Junos OS Evolved Release 25.2R1, `Install()` apenas transfere o pacote de instalação do software para o destino.	Junos OS Evolved 22.2R1
`Verify()`	Verifique a versão do software em execução. Esse RPC pode ser chamado várias vezes enquanto o destino é inicializado até ser bem-sucedido. Observação: Os dispositivos Junos não são compatíveis com `verify_standby` VerifyResponse.	Junos OS Evolved 22.2R1

Serviço do sistema

Serviço do sistema (ping e traceroute)
Serviço do sistema (reinicialização)
Serviço do sistema (atualização de software)
Serviço do sistema (comutação do Mecanismo de Roteamento)

Serviço do sistema (ping e traceroute)

Tabela 8: RPCs system.proto suportados para solução de problemas de rede
RPC	Descrição	Introduzido na versão
`Ping()`	Faça ping em um dispositivo. O `Ping()` RPC oferece suporte a pings IPv4 e IPv6. Esse RPC transmite de volta os resultados do ping após a conclusão do ping. Número padrão de pacotes: 5	Junos OS Evolved 22.2R1
`Traceroute()`	Execute o comando traceroute no dispositivo de destino e transmita os resultados de volta. Contagem de saltos padrão: 30	Junos OS Evolved 22.2R1

Serviço do sistema (reinicialização)

Tabela 9: RPCs system.proto suportados para reinicialização
RPC	Descrição	Introduzido na versão
`Reboot()`	Reinicialize o destino. Você só pode executar uma solicitação de reinicialização em um destino por vez. Opcionalmente, você pode configurar um atraso para reinicializar no futuro, reinicializar subcomponentes individualmente e adicionar uma mensagem quando a reinicialização for iniciada. O atraso é configurado em nanossegundos. Os dispositivos Junos oferecem suporte aos seguintes métodos de reinicialização: FRIO (1) DESLIGAMENTO (2) PARAR (3) PODER (7)	Junos OS Evolved 22.2R1
`RebootStatus()`	Retorne o status da reinicialização.	Junos OS Evolved 22.2R1
`CancelReboot()`	Cancele uma solicitação de reinicialização pendente.	Junos OS Evolved 22.2R1

Serviço do sistema (atualização de software)

Tabela 10: RPCs system.proto suportados para atualizações de software
RPC	Descrição	Introduzido na versão
`SetPackage()`	Instale uma imagem de software no dispositivo de destino.	Junos OS Evolved 22.2R1

Serviço do sistema (comutação do Mecanismo de Roteamento)

Tabela 11: RPCs system.proto suportados para comutação de Mecanismo de Roteamento
RPC	Descrição	Introduzido na versão
`SwitchControlProcessor()`	Alterne do Mecanismo de Roteamento atual para o Mecanismo de Roteamento especificado. Se os mecanismos de roteamento atuais e especificados forem os mesmos, é um NOOP. Se o destino não existir, o RPC retornará um erro. Observação: Os dispositivos Junos não são compatíveis com `control_processor` `SwitchControlProcessorResponse`.	Junos OS Evolved 22.2R1