如何通過SmartCloud Enterprise+API執行基本的管理工作

IBM HTTP://www.aliyun.com/zixun/aggregation/13696.html">SmartCloud Enterprise+ 的使用者可通過一個基於整合服務管理的 (ISM) 的 Web 門戶來創建和管理虛擬資產。 大部分門戶功能都可以通過 API 進行使用。 通過使用這些 API，您可以用一個程式來控制 SmartCloud Enterprise+ 資源的創建和維護。 SmartCloud Enterprise+ 雲解決方案可自動置備、擴展和重新配置。

SmartCloud Enterprise+ API 被實現為可在預定義的端點 URL 上獲得的具象狀態傳輸 (REST) 調用。 （端點 URL 在 SmartCloud Enterprise+ 操作培訓期間才能傳達給 IBM 客戶，所以本文的示例使用一個 endpoint_URL 預留位置代替了實際的端點 URL。 ）這些 API 提供了 3 個主要功能：

對 SmartCloud Enterprise+ 中繼資料和資源進行唯讀檢查 對管理性資源（使用者、團隊、專案和批准）進行管理 對 SmartCloud Enterprise+ 虛擬伺服器、補丁和快照進行管理

本文討論所有 3 種類別中的 API 使用並提供了一些示例。 我們的代碼示例使用了 cURL 命令列實用程式，它支援您使用簡單的 HTTP 命令來傳輸資料。 我們還會演示每個 cURL 調用中的 REST 調用參數。

調用語法

SmartCloud Enterprise+ REST API 請求可在 HTTP 要求標頭和正文中傳遞調用參數。 對於郵件內文中的請求傳遞參數，需要 Content-Type 標頭元素，它的值為 application/xml 或 application/json。 根據內容類型，在請求正文中，您應該放置一個包含所創建資源的所有屬性的 XML 或 JavaScript 物件標記法 (JSON) 元素。 您也可以使用 Accept 標頭指定請求的回應格式（也為 application/xml 或 application/json）。

返回一個元素集合的 REST 查詢（HTTP GET 請求）可能擁有額外的 URL 參數，用於指定查詢的過濾條件（例如 GET baseURL/users?first_name=John）。 同樣地，GET 查詢可請求排序或截斷結果。 有關的詳細資訊，請參閱 IBM SmartCloud Enterprise+ API Specifications 文檔，您可以在 SmartCloud Enterprise+ 操作培訓期間獲得該文檔。

查看、創建和維護 SmartCloud Enterprise+ 專案和伺服器實例

接下來，我們將展示如何使用這些 API，以程式設計方式控制 SmartCloud Enterprise+ 專案和伺服器實例的查看、創建和維護。

檢索資源中繼資料

圖 1 是 SmartCloud Enterprise+ 資源模型的結構圖：

圖 1. SmartCloud Enterprise+ 資源模型

在圖 1 中，箭頭表示資源之間的依賴關係，或者從一個資源到另一個資源的引用。 在該模型中，您可以看到創建一個實例（SmartCloud Enterprise+ 伺服器）需要哪些類型的資源。 實例被綁定到了分組。 一個分組 是一種抽象的資源分組，它在 SmartCloud Enterprise+ 中惟一的物理實現是一個專案。 專案進而由包含使用者的團隊組成。 必須首先創建團隊、使用者和分組，然後才能將實例與它們關聯。

此外，使用者和實例必須與一定數量的現有 SmartCloud Enterprise+ 資源相關聯，所以您必須提取這些資源的中繼資料。 例如，使用者需要一個角色，這是一個惟一的 SmartCloud Enterprise+ 資源。

一個 SmartCloud Enterprise+ 使用者至多可以擁有兩個角色。 要獲取使用者的角色中繼資料，可以發出 REST GET 命令：

curl -k -X GET -u johntester@test.com:johnspasswd HTTPs://endpoint_URL/roles

對上面的命令的一個示例回應是：

<roles> <role> <id>53</id> <name>Administrator</name> <role_group> IaaS-User</role_group> </role> <role> <id>54</id> <name>Business Manager</ name> <role_group>IaaS-User</role_group> </role></roles>

您也可以在瀏覽器中發出 REST GET 命令，因為瀏覽器預設情況下會發出 HTTP GET 請求。 鍵入 REST 調用 URL：

HTTPs://endpoint_URL/roles

該瀏覽器隨後會顯示預設的 XML 格式回應。

創建使用者

要創建一個使用者，您必須指定：

使用者 ID（使用者的電子郵件地址） 顯示名稱 名字 姓氏 角色引用清單 語言 區域