使用CommonRequest進行調用
當您要調用的某個產品的API沒有提供SDK時,可以采用泛用型的API調用方式(CommonRequest)。使用CommonRequest調用方式可實現任意OpenAPI接口的調用。
CommonRequest調用特點
CommonRequest的特點如下:
輕量:只需Core包即可發起調用,無需下載安裝各產品的SDK。
簡便:無需更新SDK即可調用最新發布的API。
快速迭代。
使用CommonRequest
阿里云產品的API有RPC和RESTful兩種風格,不同風格的API的CommonRequest的調用方法也不同。
通常API參數中包含Action參數的是RPC風格,包含PathPattern參數的是RESTful風格。一般情況下,每個產品內,所有API的調用風格是統一的。每個API僅支持特定的一種風格調用,傳入錯誤的標識,可能會調用到其他API,或收到ApiNotFound
的錯誤信息。
發起一次CommonRequest請求,您需要獲取以下幾個參數的值。您可以在文檔中心各產品的API文檔中獲取以下參數的值。此外,部分產品也可以通過OpenAPI 開發者門戶來獲取API的參數信息。
域名(domain):該產品的服務地址。
API版本(version):該API的版本號,格式為YYYY-MM-DD。
接口信息:要調用的接口名稱。
當調用的API為RPC風格(大部分阿里云產品API為RPC風格,如ECS和RDS)時,需要獲取Action參數,使用
request.ApiName = "<Action>"
的方式來指定API名稱。例如RunInstances接口,在發起CommonRequest請求時,需要使用
request.ApiName = "RunInstances"
來指定API名稱。
當調用的API為RESTful風格(如容器服務)時,需要獲取PathPattern參數,使用
request.PathPattern = "<PathPattern>"
的方式來指定RESTful路徑。例如容器服務的查看所有集群實例的API的PathPattern為
/clusters
,在發起CommonRequest請求時,要使用request.PathPattern = "/clusters"
指定RESTful路徑。
示例:調用RPC風格的API
以下代碼展示了如何使用CommonRequest的方式調用ECS的DescribeInstanceStatus接口:
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.request import CommonRequest
client = AcsClient('{your_access_key_id}', '{your_access_key_secret}', '{your_region_id}')
request = CommonRequest()
request.set_domain('ecs.aliyuncs.com')
request.set_version('2014-05-26')
request.set_action_name('DescribeInstanceStatus')
# or:
# request = CommonRequest(domain='ecs.aliyuncs.com', version='2014-05-26', action_name='DescribeInstanceStatus')
request.add_query_param('PageNumber', '1')
request.add_query_param('PageSize', '30')
response = client.do_action_with_exception(request)
示例:調用RESTful(ROA)風格的API
以下代碼展示了如何使用CommonRequest的方式調用容器服務的查看所有集群實例接口:
from aliyunsdkcore.client import AcsClient
from aliyunsdkcore.request import CommonRequest
client = AcsClient('{your_access_key_id}', '{your_access_key_secret}', '{your_region_id}')
request = CommonRequest()
request.set_domain('cs.aliyuncs.com')
request.set_version('2015-12-15')
request.set_uri_pattern('/clusters')
# or:
# request = CommonRequest(domain='ecs.aliyuncs.com', version='2014-05-26', uri_pattern='/clusters')
response = client.do_action_with_exception(request)