Documentação do Oracle Cloud Infrastructure

Consultando Recursos

Esta documentação descreve as diferentes maneiras de usar o Search para localizar recursos do Oracle Cloud Infrastructure. A pesquisa suporta as seguintes tarefas para localizar recursos:

Você pode localizar recursos do Oracle Cloud Infrastructure em uma tenancy executando uma pesquisa de texto livre ou executando uma consulta. Uma pesquisa de texto livre encontra recursos com o texto especificado em qualquer lugar nos metadados do recurso. Uma consulta avançada permite localizar recursos de acordo com campos e condições específicos usando a linguagem de consulta. Ao localizar recursos, as pesquisas de texto livre e as consultas dependem da indexação de recursos e dos atributos indexados de um tipo de recurso específico. A pesquisa também define o escopo dos resultados do recurso para a região selecionada.

Observação

Recursos Suportados e Uso de Consultas Avançadas de Recursos

Os resultados da pesquisa que você vê refletem o que o serviço Search considera recursos suportados. Para ver quais serviços e recursos o Oracle Cloud Infrastructure Search suporta, consulte a seção Recursos Suportados da Visão Geral do Serviço Search ou consulte Listando Tipos de Recursos Suportados pelo Serviço Search.

Localizando instâncias

Você pode localizar instâncias (ou uma VNIC que vem com uma instância) informando um endereço IPv4 ou IPv6 como uma pesquisa de texto livre. Além disso, nos resultados da pesquisa, a Pesquisa oferece uma exibição aprimorada dos atributos do recurso para recursos da instância.

Por padrão, os resultados da pesquisa exibem um conjunto limitado e comum de atributos de recursos para qualquer recurso correspondente. Na Console, esses atributos de recursos incluem o nome para exibição, o tipo de recurso, o OCID, o compartimento, o estado do ciclo de vida e o horário de criação. No SDK ou na CLI, os resultados básicos da pesquisa de recursos também incluem o domínio de disponibilidade e quaisquer tags associadas ao recurso.

Você pode ver detalhes adicionais selecionados indexados para recursos de instância aplicando o filtro de tipo de recurso opcional aos resultados da pesquisa. Para aplicar o filtro de tipo de recurso, primeiro você deve obter os resultados da pesquisa seguindo qualquer um dos procedimentos baseados na Console em Executando uma Pesquisa de Texto Livre, Reutilizando Termos de Pesquisa Recentes, Executando uma Consulta Personalizada, de Formato Livre ou Executando uma Consulta de Amostra.

Quando você tenta encontrar instâncias fornecendo um endereço IP na caixa de pesquisa, o serviço o trata como uma pesquisa de texto livre. Tudo sobre como o serviço trata as pesquisas de texto livre se aplica, conforme descrito em Pesquisa de Texto Livre, desde a correspondência e a classificação de resultados até o uso de curingas. Por exemplo, você pode informar o seguinte endereço IPv6:
68be:66d1:e4a1:ae53:6905:ecab:30a1:*

A pesquisa interpreta o caractere curinga no último campo de 16 bits, conforme descrito em Curingas. Em seguida, o serviço tenta corresponder o termo de pesquisa traduzido aos valores de todos os atributos de recursos indexados de todos os recursos indexados. Se a string aparecer em um campo indexado, como o endereço IP de uma instância, o Search considerará o item encontrado um resultado correspondente e o retornará na lista de resultados. Se você tiver uma instância com o endereço IPv6 68be:66d1:e4a1:ae53:6905:ecab:30a1:a814, por exemplo, poderá filtrar pelo tipo de recurso da instância para obter uma view detalhada do resultado da pesquisa e de quaisquer outros resultados da instância correspondentes.

Para obter mais informações sobre como executar uma pesquisa de texto livre e filtrar resultados, consulte Executando uma Pesquisa de Texto Livre.

Localizando Recursos por OCID

Você tem várias maneiras de encontrar um recurso por seu OCID. Você pode inserir diretamente um OCID como uma pesquisa de texto livre. No entanto, recomendamos que você construa uma consulta de recursos avançada. Ao construir uma consulta para localizar um recurso por seu OCID, você pode fornecer o OCID como parte de uma instrução de condição ou como texto correspondente. Por exemplo, para localizar um compartimento com um OCID específico com uma instrução de condição:

query compartment resources where identifier = 'ocid1.compartment.oc1..<unique_ID>'

Para obter mais informações sobre essa sintaxe de consulta, consulte Condições.

Ou, por exemplo, para localizar um compartimento com um OCID específico com uma cláusula correspondente:

query compartment resources matching 'ocid1.compartment.oc1..<unique_ID>'

Para obter mais informações sobre essa sintaxe de consulta, consulte Correspondência.

Todos os métodos exigem que você forneça o OCID do recurso com exatidão.