Acessar UUIDs

Um UUID (Identificador universalmente exclusivo) é um ID exclusivo de um componente no sistema. Algumas tarefas de manutenção e configuração da nuvem privada exigem que você use o UUID de um componente.

Nesta seção, mostramos vários métodos que podem ser usados para conseguir UUIDs de componentes de nuvem privada.

Usar a API Management

Para receber o UUID de componentes de nuvem privada com a API de gerenciamento, use as seguintes chamadas de API:

Componente Chamada de API
Roteador
curl http://router_IP:8081/v1/servers/self
Processador de mensagens
curl http://mp_IP:8082/v1/servers/self
Qpid (em inglês)
curl http://qp_IP:8083/v1/servers/self
Postgres (em inglês)
curl http://pg_IP:8084/v1/servers/self

Os números das portas são diferentes, dependendo do componente chamado.

Se você chamar a API na própria máquina, não precisará especificar um nome de usuário e uma senha. Se você chamar a API remotamente, especifique o nome de usuário e a senha do administrador do Edge, como mostra o exemplo a seguir:

curl http://10.1.1.0:8081/v1/servers/self -u user@example.com:abcd1234 \
  -H "Accept:application/xml"

Cada uma dessas chamadas retorna um objeto JSON que contém detalhes sobre o serviço. A propriedade uUID especifica o UUID do serviço, como o exemplo a seguir mostra:

{
  "buildInfo" : {
    ...
  },
  ...
  "tags" : {
    ...
  },
  "type" : [ "router" ],
  "uUID" : "71ad42fb-abd1-4242-b795-3ef29342fc42"
}

Opcionalmente, defina o cabeçalho Accept como application/xml para instruir o apigee-adminapi.sh a retornar XML em vez de JSON. Exemplo:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list --admin user@example.com \
  --pwd abcd1234 --host localhost -H "Accept:application/xml"

Usar apigee-adminapi.sh

É possível conseguir os UUIDs de alguns componentes usando a opção servers list do utilitário apigee-adminapi.sh. Para receber UUIDs com apigee-adminapi.sh, use a seguinte sintaxe:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list \
  --admin admin_email_address --pwd admin_password --host edge_server

Em que:

  • admin_email_address é o endereço de e-mail do administrador do Edge.
  • admin_password é a senha do administrador do Edge.
  • edge_server é o endereço IP do servidor do qual você quer uma lista. Se você tiver feito login no servidor, poderá usar localhost.

Exemplo:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list --admin user@example.com --pwd abcd1234 --host localhost

Esse comando retorna um objeto JSON complexo que especifica as mesmas propriedades para cada serviço que as chamadas da API de gerenciamento.

Assim como nas chamadas de API de gerenciamento, você tem a opção de definir o cabeçalho Accept como application/xml para instruir o apigee-adminapi.sh a retornar XML em vez de JSON. Por exemplo:

/opt/apigee/apigee-adminapi/bin/apigee-adminapi.sh servers list --admin user@example.com \
  --pwd abcd1234 --host localhost -H "Accept:application/xml"