取得 UUID

UUID (通用唯一 IDentifier) 是系統中元件的專屬 ID。私有雲的部分維護和設定工作需要使用元件的 UUID。

本節說明多種取得私有雲元件 UUID 的方法。

使用 Management API

如要透過 Management API 取得私有雲元件的 UUID，請使用下列 API 呼叫：

元件 API 呼叫
路由器 
curl http://router_IP:8081/v1/servers/self
訊息處理器 
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

請注意，通訊埠號碼會因呼叫的元件而異。

如果您是從機器本身呼叫 API，則不需要指定使用者名稱和密碼。如果您從遠端呼叫 API，則必須指定 Edge 管理員的使用者名稱和密碼，如以下範例所示：

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

每次呼叫都會傳回 JSON 物件，內含服務的詳細資料。uUID 屬性會指定服務的 UUID，如以下範例所示：

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

您可以視需要將 Accept 標頭設為 application/xml，指示 apigee-adminapi.sh 傳回 XML 而非 JSON。例如：

/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

您可以使用 apigee-adminapi.sh 公用程式的 servers list 選項，取得部分元件的 UUID。如要使用 apigee-adminapi.sh 取得 UUID，請使用下列語法：

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

其中：

  • admin_email_address 是 Edge 管理員的電子郵件地址。
  • admin_password 是 Edge 管理員的密碼。
  • edge_server 是要列出清單的伺服器 IP 位址。如果您已登入伺服器，可以使用 localhost。

例如：

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

這個指令會傳回複雜的 JSON 物件，為每項服務指定與Management API 呼叫相同的屬性。

與 Management API 呼叫一樣，您可以選擇將 Accept 標頭設為 application/xml，指示 apigee-adminapi.sh 傳回 XML 而非 JSON。例如：

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