VMware Aria Operations API REST 要求

若要擷取物件表示方式，用戶端會向物件參考發出 HTTP 要求。

安全性

API 用戶端與伺服器之間的 HTTP 連結是使用 SSL 建立的。API 用戶端會設定以 Token 為基礎的驗證，以與伺服器進行通訊。

使用以 Token 為基礎的驗證 POST 登入要求至 VMware Aria Operations API 伺服器，提供有效的使用者認證以取得驗證 Token。下列範例提供以 Token 為基礎的驗證案例。

取得 VMware Aria Operations 執行個體的有效使用者認證。
向 REST 端點 POST 要求以進行驗證。
```
https://RESTendpoint.example.com/suite-api/api/auth/token/acquire
```
要求內文包括使用者名稱、密碼和驗證來源。
在回應內文中，端點會傳回 Token、到期日和時間。
如需進一步的通訊，請在授權標頭中包含具有下列格式的 Token 物件：
```
Authorization: OpsToken <vROps_token>
```
備註：舊格式
```
Authorization: vRealizeOpsToken <vROps_token>
```
在 VMware Aria Operations 中繼續受支援。
或者，如果您從 SSO 來源取得 Token，則授權標頭的格式為：
```
Authorization: SSO2Token <SSO_SAML_TOKEN>
```
您可以將 POST 要求傳送至登出端點，以在到期日和時間之前使 Token 失效。
```
POST https://RESTendpoint.example.com/suite-api/api/auth/token/release
```

API 要求中通常包含下列 HTTP 標頭：

Accept-Language	若要指定回應中所需的語言，請使用 `Accept-Language` 要求標頭。ErrorType 回應中的訊息字串已進行當地語系化。若要要求使用當地語系化為法文的訊息字串來回應，請使用下列標頭： Accept-Language: fr-FR
授權	所有建立 API 工作階段的要求，必須包含由組織使用的身分識別提供者所規定的 `Authorization` 標頭格式
Content-Type	包含內文的要求必須包含適當的 HTTP `Content-Type` 標頭。對於以 XML 撰寫的要求內文，標頭必須包含 Content-Type: application/xml 對於以 JSON 撰寫的要求內文，標頭必須包含 Content-Type: application/json
接受	若要指定所需的回應格式，請包括 `Accept` 要求標頭。對於以 XML 撰寫的回應，標頭必須包含 Accept: application/xml 對於以 JSON 撰寫的回應，標頭必須包含 Accept: application/json

對於以 XML 撰寫的要求內文，VMware Aria Operations 會使用驗證 XML 剖析器，該剖析器需要在要求內文中的元素符合配置的順序和編號。除非符合下列準則，否則要求內文會因被視為無效而遭到拒絕：