BlueXP 複製與同步 API
透過 Web UI 提供的 BlueXP 複本與同步功能也可透過 RESTful API 取得。
開始使用
若要開始使用 BlueXP 複本與同步 API 、您必須取得使用者權杖和 BlueXP 帳戶 ID 。進行 API 呼叫時、您必須將權杖和帳戶 ID 新增至「授權」標頭。
-
從 BlueXP 取得使用者權杖。
如果您使用的是沒有用戶端ID的個人電子郵件帳戶、您可以使用預設用戶端ID「QC3AgHk6qdbmC7Yr82ApwaaJLwRrNO」。 -
取得您的BlueXP帳戶ID。
此 API 會傳回如下回應:
-
在每個 API 呼叫的「授權」標頭中新增使用者權杖和帳戶 ID 。
-
範例 *
下列範例顯示在 Microsoft Azure 中建立資料代理程式的 API 呼叫。您只需將 <user_token (使用者權杖) > 和 <AccountID> 替換成您在先前步驟中取得的權杖和 ID 即可。
-
BlueXP 的使用者權杖具有到期日。若要重新整理權杖、您需要再次從步驟 1 呼叫 API 。
API 回應包含「 Expire_in 」欄位、指出權杖過期的時間。
使用清單 API
清單 API 為非同步 API 、因此不會立即傳回結果(例如:「 Get /data-kers/{id}/list-nfs_export-folders 」和「 Get /data-ker/{id}/list-s3-buckets 」)。伺服器唯一的回應是 HTTP 狀態 202 。若要取得實際結果、您必須使用「 Get /Messages / Client (取得 / 訊息 / 用戶端)」 API 。
-
呼叫您要使用的清單 API 。
-
使用「 Get /Messages / Client (取得 / 訊息 / 用戶端)」 API 來檢視作業結果。
-
使用相同的 API 、將它附加到您剛收到的 ID :「 Get http://api.cloudsync.netapp.com/api/messages/client?last=<id_from_step_2>` 」
請注意、每次您呼叫「 Get /Messages / Client (取得 / 訊息 / 用戶端)」 API 時、 ID 都會變更。
-
範例 *
-
當您呼叫「 list-s3-buckets 」 API 時、不會立即傳回結果:
結果是 HTTP 狀態代碼 202 、表示訊息已被接受、但尚未處理。
若要取得作業結果、您需要使用下列 API :
結果是一個陣列、其中一個物件包含 ID 欄位。ID 欄位代表伺服器傳送的最後一則訊息。例如:
您現在可以使用剛收到的 ID 進行下列 API 呼叫:
結果是一組訊息。每個訊息內部都有一個有效負載物件、其中包含作業名稱(做為金鑰)及其結果(做為值)。例如:
API 參考
每個 BlueXP 複本與同步 API 的文件均可從取得 https://api.cloudsync.netapp.com/docs。