取得 UUID

UUID (通用唯一識別碼) 是系統中元件的專屬 ID。使用私有雲的某些維護和設定工作時,您必須使用元件的 UUID。

本節說明您可以透過多種方式取得 Private Cloud 元件的 UUID。

使用 Management API

如要透過 Management API 取得 Private Cloud 元件的 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 物件,將每項服務的屬性指定為與 管理 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"