OpenAPI 風格
本文為您詳細介紹了OpenAPI的RPC風格和ROA風格，在自定義請求體之前，您必須提前知曉要調用的產品接口風格，它決定了如何構造請求體的請求方法（RequestMethod）、請求頭（RequestHeader）、請求查詢字符串（RequestQueryString）、請求正文（RequestPayload）應該如何設置。
阿里云產品主要使用兩種風格定義 OpenAPI ：RPC 和 ROA。
RPC風格
RPC（Remote Procedure Call）是一種協議，它允許一個程序調用另一個程序中的函數或方法，就像調用本地函數或方法一樣。
RPC風格的接口，客戶端和服務器之間的通信是基于函數或方法調用的，而不是基于資源的。客戶端向服務器發出請求時，它傳遞的是函數或方法的參數，而不是資源的標識符。服務器收到請求后，它執行請求中指定的函數或方法，并將結果返回給客戶端。
RPC 風格接口允許的 Method：GET/POST。
OpenAPI 為RPC風格的產品：彈性計算服務ECS，關系型數據庫RDS，內容分發CDN等。
示例：
http://ecs.aliyuncs.com/?SignatureVersion=1.0&Action=DescribeDedicatedHosts&Format=XML&SignatureNonce=3ee8c1b8-xxxx-xxxx-xxxx-xxxxxxxxx&Version=2014-05-26&AccessKeyId=testid&Signature=OLeaidS1JvxuMvnyHOwuJ%2BuX5qY%3D&SignatureMethod=HMAC-SHA1&Timestamp=2016-02-23T12%3A46%3A24Z&RegionId=cn-hangzhou&Status=Available
ROA風格
REST（Representational State Transfer）是一種架構風格，用于設計 Web 服務。RESTful API 可以讓客戶端應用通過 HTTP 請求與服務器進行交互，并使用 HTTP 方法（例如 GET、POST、PUT、DELETE）執行 CRUD 操作（創建、讀取、更新、刪除）。
ROA（Resource-Oriented Architecture）是一種基于資源的架構風格，它是 REST 風格的一種擴展。
ROA風格的接口允許的Method
GET：用于從服務器獲取資源，一般不會對服務器上的資源進行修改。
POST：用于將數據發送到服務器以創建新資源，或者用于在服務器上執行某些操作。
PUT：用于更新服務器上的資源。客戶端在發送 PUT 請求時，需要提供完整的資源數據。
DELETE：用于從服務器上刪除資源。
OpenAPI 為ROA風格的產品：業務實時監控服務 ARMS，批量計算，容器服務，ElasticSearch等。
POST /clusters/test_cluster_id/triggers HTTP/1.1
{
"x-acs-action":"CreateTrigger",
"x-acs-version":"2015-12-15",
"Accept":"application/json",
"Authorization": "acs testid:D9uFJAJgLL+dryjBfQK+YeqGtoY=",
"x-acs-signature-nonce":"15215528852396",
"Date":"Tue 9 Apr 2022 07:35:29 GMT",
"x-acs-signature-method":"HMAC-SHA1",
"Content-MD5":"Gtl/0jNYHf8t9Lq8Xlpaqw=="
"Host":"cs.aliyuncs.com"
}
{
"cluster_id":"test_cluster_id",
"project_id":"default/nginx-test",
"action":"redeploy",
"type":"deployment"
}如何查看
訪問云產品文檔的API參考目錄，點擊查看API概覽文檔，內容包含OpenAPI采用的接口風格。
在 OpenAPI 門戶查找對應的接口，在API調試模塊，查看 SDK 示例代碼，如果里面涉及向
headers寫入參數的邏輯，說明是 ROA 風格，否則是 RPC 風格。