Visão geral dos serviços gNOI

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

A interface de operações de rede (gNOI) gRPC define serviços para a execução de 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 proto-definiçã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 de 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 em que o suporte começa para a versão dada do arquivo proto.

Tabela 1: Serviços gNOI com suporte
Versão	de lançamento de serviço iniciando o suporte	proto versão do arquivo
`CertificateManagement`	Junos OS Evolved Release 22.2R1	0.2.0
`Diag`	Junos OS Evolved Release 22.2R1	0.1.0
`File`	Junos OS Evolved Release 22.2R1	0.1.0
`OS`	Junos OS Evolved Release 22.2R1	0.1.1
`System`	Junos OS Evolved Release 22.2R1	1.0.0

Serviço de gerenciamento de certificados

Tabela 2: RPCs com suporte de cert.proto
Descrição do RPC		introduzida em versão
`CanGenerateCSR()`	Faça uma consulta ao dispositivo-alvo para determinar se ele pode gerar uma solicitação de assinatura de certificado (CSR) com o tipo de chave especificado, tamanho da chave e tipo de certificado. Valores suportados: Tipo de chave: KT_RSA Tamanhos principais: 1024, 2048, 4096 Tipo de certificado: CT_X509 Devoluções `True` se o servidor gNOI suportar o tipo de chave específico, tamanho da chave e tipo de certificado.	Junos OS Evolved 23.1R1
`GenerateCSR()`	Gere e devolva uma solicitação de assinatura de certificado (CSR).	Junos OS Evolved 22.2R1
`GetCertificates()`	Devolva os certificados locais carregados no dispositivo alvo.	Junos OS Evolved 22.2R1
`Install()`	Carregue um novo certificado no dispositivo alvo criando uma solicitação de CSR, gerando um certificado com base no CSR e carregando o certificado usando um novo certificado de ID.	Junos OS Evolved 22.2R1
`LoadCertificate()`	Carregue um certificado assinado por uma Autoridade de Certificado (CA) no dispositivo alvo.	Junos OS Evolved 22.2R1
`LoadCertificateAuthorityBundle()`	Carregue um pacote de certificado ca no dispositivo alvo.	Junos OS Evolved 22.2R1
`RevokeCertificates()`	Revogação dos certificados com os IDs de certificado especificados no dispositivo alvo.	Junos OS Evolved 23.1R1
`Rotate()`	Substitua um certificado existente no dispositivo alvo criando uma solicitação de CSR, gerando um certificado com base no CSR e carregando o certificado usando um ID de certificado existente.	Junos OS Evolved 22.2R1

Serviço de diagnóstico (Diag)

Tabela 3: RPCs com suporte para diag.proto
Descrição do RPC		introduzida em versão
`StartBERT()`	Inicie um BERT em um conjunto de portas. Os dispositivos Junos oferecem suporte aos seguintes padrões de PRBS para o gNOI BERTs: 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 resultados bert durante o BERT ou depois que ele for concluído.	Junos OS Evolved 22.2R1

Serviço de arquivos

Tabela 4: RPCs de file.proto suportados
Descrição do RPC		introduzida em versão
`Get()`	Leia e transmita o conteúdo de um arquivo do alvo. O arquivo é transmitido por mensagens sequenciais, cada mensagem contendo até 64KB de dados. Uma mensagem final é enviada antes de fechar o fluxo que contém o hash dos dados enviados. A operação retorna um erro se o arquivo não existir ou houver um erro na leitura do arquivo.	Junos OS Evolved 22.2R1
`Put()`	Transmita dados para um arquivo sobre o alvo. O arquivo é enviado em mensagens sequenciais, cada mensagem contendo até 64KB de dados. Uma mensagem final deve ser enviada que inclua o hash dos dados. A operação retorna um erro se a localização não existir ou houver um erro na escrita dos dados. Se nenhum checksum for recebido, o alvo remove o arquivo parcialmente transmitido. Uma falha não alterará nenhum arquivo existente de mesmo nome.	Junos OS Evolved 22.2R1
`Remove()`	Remova o arquivo especificado do alvo. A operação retorna 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()`	Devolva metadados sobre um arquivo no dispositivo alvo. A operação retorna um erro se o arquivo não existir ou houver um erro ao acessar os metadados.	Junos OS Evolved 22.2R1

Serviço de sistema operacional (OS)

Tabela 5: RPCs com suporte para os.proto
Descrição do RPC		introduzida em versão
`Activate()`	Defina a versão do SO que é usada no próximo reboot. `Activate()` reinicializa o alvo se a `no_reboot` bandeira for omitida ou definida para `False`. Se a reinicialização não inicializar a versão do OS solicitada, o alvo volta para o pacote anterior do OS. Nota: Os dispositivos Junos não suportam o `standby_supervisor` campo na `ActivateRequest` mensagem.	Junos OS Evolved 22.2R1
`Install()`	Transfira uma imagem de software para o alvo. Nota: Os dispositivos Junos não suportam o `standby_supervisor` campo na `TransferRequest` mensagem.	Junos OS Evolved 22.2R1
`Verify()`	Verifique a versão de sistema operacional em execução. Este RPC pode ser chamado várias vezes enquanto o alvo inicializa até ser bem sucedido. Nota: Os dispositivos Junos não oferecem suporte `verify_standby` para o VerifyResponse.	Junos OS Evolved 22.2R1

Serviço de sistema

Serviço de sistema (ping e traceroute)
Serviço de sistema (Reinicialização)
Serviço de sistema (atualização de software)
Serviço de sistema (switchover do mecanismo de roteamento)

Serviço de sistema (ping e traceroute)

Tabela 6: Sistema suportado.proto RPCs para resolução de problemas da rede
Descrição do RPC		introduzida em versão
`Ping()`	Ping um dispositivo. O `Ping()` RPC oferece suporte a pings IPv4 e IPv6. Este 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 de traceroute no dispositivo alvo e transmita os resultados de volta. Contagem padrão de saltos: 30	Junos OS Evolved 22.2R1

Serviço de sistema (Reinicialização)

Tabela 7: RPCs com suporte de system.proto para reinicialização
Descrição do RPC		introduzida em versão
`Reboot()`	Reinicialize o alvo. Você só pode executar uma solicitação de reinicialização em um alvo de cada vez. Você pode configurar opcionalmente um atraso para reiniciar no futuro, reiniciar subcomponentes individualmente e adicionar uma mensagem quando o reboot começar. O atraso está configurado em nanossegundos. Os dispositivos Junos oferecem suporte aos seguintes métodos de reinicialização: RESFRIADO (1) POWERDOWN (2) PARADA (3) POWERUP (7)	Junos OS Evolved 22.2R1
`RebootStatus()`	Devolva 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 de sistema (atualização de software)

Tabela 8: Sistema suportado.proto RPCs para atualizações de software
Descrição do RPC		introduzida em versão
`SetPackage()`	Instale uma imagem de software no dispositivo alvo.	Junos OS Evolved 22.2R1

Serviço de sistema (switchover do mecanismo de roteamento)

Tabela 9: RpCs com suporte de system.proto para switchover do mecanismo de roteamento
Descrição do RPC		introduzida em versão
`SwitchControlProcessor()`	Mude do mecanismo de roteamento atual para o mecanismo de roteamento especificado. Se os mecanismos de roteamento atuais e especificados forem os mesmos, ele será um NOOP. Se o alvo não existir, o RPC retorna um erro. Nota: Os dispositivos Junos não suportam `control_processor` `SwitchControlProcessorResponse`.	Junos OS Evolved 22.2R1