UUIDs abrufen

Eine UUID (Universally Unique IDentifier) ist eine eindeutige ID für eine Komponente in Ihrem System. Bei einigen Wartungs- und Konfigurationsaufgaben für die Private Cloud müssen Sie die UUID einer Komponente verwenden.

In diesem Abschnitt werden mehrere Methoden beschrieben, mit denen Sie UUIDs von Private Cloud-Komponenten abrufen können.

Verwaltungs-API verwenden

Verwenden Sie die folgenden API-Aufrufe, um die UUID für Private Cloud-Komponenten mit der Verwaltungs-API abzurufen:

Komponente API-Aufruf
Router
curl http://router_IP:8081/v1/servers/self
Nachrichtenverarbeiter
curl http://mp_IP:8082/v1/servers/self
Qpid
curl http://qp_IP:8083/v1/servers/self
Postgres
curl http://pg_IP:8084/v1/servers/self

Beachten Sie, dass die Port-Nummern je nach angerufener Komponente unterschiedlich sind.

Wenn Sie die API vom Computer aus aufrufen, müssen Sie keinen Nutzernamen und kein Passwort angeben. Wenn Sie die API remote aufrufen, müssen Sie den Benutzernamen und das Passwort des Edge-Administrators wie im folgenden Beispiel zeigen:

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

Bei jedem dieser Aufrufe wird ein JSON-Objekt zurückgegeben, das Details zum Dienst enthält. Das Attribut uUID gibt die UUID des Dienstes an, wie im folgenden Beispiel gezeigt:

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

Optional können Sie den Header Accept auf application/xml setzen, um apigee-adminapi.sh anzuweisen, XML anstelle von JSON zurückzugeben. Beispiel:

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

apigee-adminapi.sh verwenden

Sie können die UUIDs einiger Komponenten mit der Option servers list des Dienstprogramms apigee-adminapi.sh abrufen. Verwenden Sie die folgende Syntax, um UUIDs mit apigee-adminapi.sh abzurufen:

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

Wobei:

  • admin_email_address ist die E-Mail-Adresse des Edge-Administrators.
  • admin_password ist das Passwort des Edge-Administrators.
  • edge_server ist die IP-Adresse des Servers, von dem Sie eine Liste abrufen möchten. Wenn Sie auf dem Server angemeldet sind, können Sie localhost verwenden.

Beispiel:

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

Dieser Befehl gibt ein komplexes JSON-Objekt zurück, das für jeden Dienst die gleichen Attribute wie die Verwaltungs-API-Aufrufe angibt.

Wie bei den Verwaltungs-API-Aufrufen können Sie optional den Header Accept auf application/xml setzen, um apigee-adminapi.sh anzuweisen, XML anstelle von JSON zurückzugeben. Beispiel:

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