CA Performance Center API 總覽 › REST Web 服務中的基本作業

REST Web 服務中的基本作業

REST 規格留有一些彈性空間。 因此，REST Web 服務可以使用基本的 HTTP 語法來執行各種不同任務。 所有 CA Performance Center REST Web 服務都需要 HTTP 要求標頭中有使用者和密碼授權。 您可以使用在 CA Performance Center 使用者介面中使用的相同登入憑證。

在這種實作中，基本的 REST 命令的使用方法如下：

• GET - 登入或擷取伺服器資料庫中的資訊。 只需要瀏覽器工作階段。
• POST - 建立物件。 通常需要有 XML 輸入來提供參數。
• PUT - 編輯現有物件。 偶爾也用來建立物件。 通常不需要有 XML 輸入來提供參數。
• DELETE - 刪除現有物件。

以下是簡單 PUT 作業的範例，此範例會更新租戶的說明參數：

http://CA Performance Center 伺服器 IP 位址:8181/pc
/center/webservice/tenants/tenantName/tenantName/tenantDescription
/NewDescription

請將斜體字詞替換為所需的值。 有些參數是必要參數：

tenantName

您要編輯的租戶名稱。

tenantDescription

用來識別此租戶的新說明。

以下是簡單 GET 作業的範例，此範例會使用租戶 Web 服務，傳回租戶 ID 和名稱的清單：

http://CA Performance Center 伺服器 IP 位址:8181/pc
/center/webservice/tenants/idNames

以下是會傳回的 XML：

<?xml version="1.0" encoding="UTF-8"?>

<idNames>

  <idName value="tenantAccountId" />

  <idName value="tenantItemId" />

  <idName value="tenantName" />

</idNames>

無論是否成功，HTTP 要求一律會傳回回應和狀態代碼。 回應文字會是預期的結果或是指出問題的錯誤訊息。 狀態代碼會是 200 (表示回應成功) 或其他數值錯誤指標。 以下是會使用的 HTTP 回應碼範圍：

• 200 - 命令狀態是「沒問題」。
• 400 - 發生使用者錯誤。 此範圍內的錯誤表示輸入文字有問題 (400) 或使用者憑證有問題 (403)，通常可以輕鬆更正。
• 500 - 發生系統錯誤。 此範圍內的錯誤通常表示系統錯誤。 這種錯誤可能需要有 CA 技術支援的協助才能解決。

如需 HTTP 狀態代碼的詳細資訊，請參閱下列 IETF 網站：

http://www.ietf.org/rfc/rfc2616.txt