DiscoveryAPI - com escopo

Os métodos da classe DiscoveryAPI iniciam um Discovery rápido de um único endereço IPv4 e retornam resumos dos status do Discovery iniciado anteriormente para um único IC ou para todos os ICs verificados.

Esta classe é executada no namespace sn_discovery.

DiscoveryAPI com escopo - discoveryIpAddress(cadeia de caracteres ipAddress, aplicação de cadeia de caracteres, origem de cadeia de caracteres)

Descobre um endereço IPv4 especificado.

Um MID Server é selecionado automaticamente, com base no endereço IP fornecido ou na aplicação especificada.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
Aplicação	Cadeia de caracteres	Opcional. Aplicação configurada para o MID Server. Para definir um parâmetro source, mas não um parâmetro application, use "NULL" como espaço reservado. Padrão: Descoberta
ipAddress	Cadeia de caracteres	Endereço IP a ser descoberto.
origem	Cadeia de caracteres	Opcional. Origem da descoberta. Esse mesmo valor aparece no campo opcional Origem no registro de Status do Discovery, que indica como o Discovery foi acionado. Padrão: Discovery_API

Tabela 2. Retorna

Tipo	Descrição
Cadeia de caracteres	sys_id do registro de status da descoberta. As seguintes exceções podem ser geradas durante a seleção do MID Server: NoSuitableMidServerFoundException: nenhum MID Server apropriado disponível para esta Descoberta BadArgumentException: argumento inválido detectado durante a seleção do MID Server

var sysid = sn_discovery.DiscoveryAPI.discoverIpAddress("11.23.125.39");

DiscoveryAPI com escopo - reportCiIpAddressStatus(Object ipAddress, Object discoveryStatusSysId)

Usado para retornar um resumo do status do Discovery de um item de configuração de acordo com o sys_id do status específico e o endereço IPv4.

As seguintes exceções podem ser lançadas:

• DiscoveryStatusNotFoundException: Exibe esta mensagem: O status da descoberta com o SYS ID "<valor inválido>" não existe
• DiscoveryDeviceHistoryNotFoundException: o histórico do dispositivo com o SYS ID do status da descoberta "<valor inválido>" e o endereço IP "<valor inválido>" não existe
• IllegalArgumentException (argumentos de entrada inválidos): esta exceção de argumento evita que os valores de entrada sejam nulos.
  • O SYS ID do status da descoberta não pode ser nulo
  • ipAddress não pode ser nulo
• IllegalArgumentException (valores armazenados no banco de dados): esta exceção de argumento evita que dados incorretos sejam retornados ao solicitante no caso de valores de atributo incorretos.
  • A propriedade "estado" do status da descoberta não pode ser nula
  • A propriedade "origem" do histórico do dispositivo não pode ser nula
  • A propriedade "problemas" do histórico do dispositivo não é um número inteiro: <valor inválido>
  • A propriedade "problemas" do histórico do dispositivo não pode ser inferior a 0: <valor inválido>

Tabela 3. Parâmetros

Nome	Tipo	Descrição
ipAddress	Cadeia de caracteres	O endereço IPv4 que foi verificado.
discoveryStatusSysId	Cadeia de caracteres	O sys_id do registro de status do Discovery para o endereço IP que foi verificado.

Tabela 4. Retorna

Tipo	Descrição
matriz	Matriz JavaScript de objetos ReportCiStatusOutputJS imutáveis.

var ipResultObj = sn_discovery.DiscoveryAPI.reportCiIpAddressStatus(ipAddress, discoveryStatus);

DiscoveryAPI com escopo - reportCiStatus(Object discoveryStatusSysId)

Usado para retornar um resumo de um status de descoberta de IC de acordo com um sys_id de status de descoberta específico.

As seguintes exceções podem ser lançadas:

• DiscoveryStatusNotFoundException: o status da descoberta com o SYS ID "<valor inválido>" não existe
• DiscoveryDeviceHistoryNotFoundException: o histórico do dispositivo com o SYS ID do status da descoberta "<valor inválido>" e o endereço IP "<valor inválido>" não existe
• IllegalArgumentException (argumentos de entrada inválidos): esta exceção de argumento evita que os valores de entrada sejam nulos.
  • O SYS ID do status da descoberta não pode ser nulo
  • ipAddress não pode ser nulo
• IllegalArgumentException (valores armazenados no banco de dados): esta exceção de argumento impõe pós-condições nos valores de acesso ao banco de dados.
  • A propriedade "estado" do status da descoberta não pode ser nula
  • A propriedade "origem" do histórico do dispositivo não pode ser nula
  • A propriedade "problemas" do histórico do dispositivo não é um número inteiro: <valor inválido>
  • A propriedade "problemas" do histórico do dispositivo não pode ser inferior a 0: <valor inválido>

Tabela 5. Parâmetros

Nome	Tipo	Descrição
sys_id	Cadeia de caracteres	O sys_id de um registro de status do Discovery.

Tabela 6. Retorna

Tipo	Descrição
matriz	Matriz JavaScript de objetos ReportCiStatusOutputJS imutáveis.

var ipResultObjArray = sn_discovery.DiscoveryAPI.reportCiStatus(discoveryStatus);
for(var idx=0; idx < ipResultObjArray.length; idx++) {    
var ipResultObj = ipResultObjArray[idx];