閱讀942 返回首頁    go 英雄聯盟


修改API__API管理相關接口_API_API 網關-阿裏雲

修改API(ModifyApi)

描述

修改API定義

  • 此接口麵向開放API的用戶
  • 修改ApiName時需要注意,同一個分組內API不允許重名
  • 修改RequestPath時需要注意,同一個分組內Path不允許重複
  • 該接口調用的QPS限製為:單用戶QPS不超過50

請求參數

名稱 類型 是否必須 描述
Action String 操作接口名,係統規定參數,取值:ModifyApi
GroupId String 指定的分組編號
ApiId String API的Id標識
ApiName String API的名稱,組內不允許重複。支持漢字,英文,數字,下劃線,且隻能以英文和漢字開頭,4~50個字符
Visibility String API是否公開,目前可以取值:
  • PUBLIC:公開,如選擇此類型,該API的線上環境,會在所有用戶的控製台“發現API”頁麵展示
  • PRIVATE:不公開,如選擇此類型,當該組API在雲市場上架時,私有類型的API不會上架
Description String API描述信息,最多180個字符
AuthType String API安全認證類型,目前可以取值:
  • APP:隻允許已授權的APP調用
  • ANONYMOUS:允許匿名調用,設置為允許匿名調用需要注意:
    • 任何能夠獲取該API服務信息的人,都將能夠調用該API。網關不會對調用者做身份認證,也無法設置按用戶的流量控製,若開放該API請設置好按API的流量控製。
    • “ANONYMOUS”API不建議上架雲市場,網關無法對調用者區分計量,也無法限製調用次數,若所在分組要上架雲市場,建議將該API轉移至其他分組,或將類型設置為“私有”,或選擇“阿裏雲APP”認證方式。
  • APPOPENID:支持第三方賬號認證OpenID Connect,而且隻允許已授權的APP調用;當設置此項時,參數OpenIdConnectConfig為必傳。
OpenIdConnectConfig String 第三方賬號認證OpenID Connect相關配置項,詳情見ApiAttributesType.md#OpenIdConnectConfig
RequestConfig String Consumer向網關發送API請求的相關配置項,詳情見ApiAttributesType.md#RequestConfig
ServiceConfig String 網關向後端服務發送API請求的相關配置項,詳情見ApiAttributesType.md#ServiceConfig
RequestParameters String Consumer向網關發送API請求的參數描述,詳情見ApiAttributesType.md#RequestParameters
ServiceParameters String 網關向後端服務發送API請求的參數描述,詳情見ApiAttributesType.md#ServiceParameters
ServiceParametersMap String Consumer向網關發送請求的參數和網關向後端服務發送的請求的參數的映射關係,詳情見ApiAttributesType.md#ServiceParametersMap
ResultType String 後端服務返回應答的格式,目前可以設置為:JSON、TEXT、BINARY、XML、HTML
ResultSample String 後端服務返回應答的示例
FailResultSample String 後端服務失敗返回應答的示例
ErrorCodeSamples String 後端服務返回的錯誤碼示例,詳情見ApiAttributesType.md#ErrorCodeSamples

返回參數

名稱 類型 描述
RequestId String 本次創建API的請求Id

示例

請求示例

  1. https://ecs.aliyuncs.com/?Action=ModifyApi
  2. &GroupId=08ae4aa0f95e4321849ee57f4e0b3077
  3. &ApiName=ApiName
  4. &ApiId=8afff6c8c4c6447abb035812e4d66b65
  5. &Visibility=PUBLIC
  6. &Description=Api description
  7. &AuthType=APP
  8. &RequestConfig={"RequestProtocol":"HTTP","RequestHttpMethod":"GET","RequestPath":"/v3/getUserTest/[userId]","BodyFormat":"FORM","PostBodyDescription":""}
  9. &ServiceConfig={"ServiceProtocol":"HTTP","ServiceHttpMethod":"GET","ServiceAddress":"https://www.customerdomain.com","ServiceTimeout":"1000","ServicePath":"/v3/getUserTest/[userId]"}
  10. &RequestParameters=[{"ParameterLocation":{"name":"Head","orderNumber":1},"ParameterType":"Number","Required":"OPTIONAL","isHide":false,"ApiParameterName":"age","DefaultValue":"20","DemoValue":"20","Description":"年齡","MinValue":18,"MaxValue":100,"Location":"Head"},{"ParameterLocation":{"name":"Query","orderNumber":2},"ParameterType":"String","Required":"OPTIONAL","isHide":false,"ApiParameterName":"sex","DefaultValue":"boy","DemoValue":"boy","Description":"性別","EnumValue":"boy,girl","Location":"Query"},{"ParameterLocation":{"name":"Parameter Path","orderNumber":3},"ParameterType":"Number","Required":"REQUIRED","isHide":false,"ApiParameterName":"userId","MaxLength":10,"MinValue":10000000,"MaxValue":100000000,"Location":"Path"},{"ApiParameterName":"CaClientIp","ParameterLocation":{"name":"Head","orderNumber":0},"Location":"Head","ParameterType":"String","Required":"REQUIRED","Description":"客戶端IP"},{"ApiParameterName":"constance","ParameterLocation":{"name":"Head","orderNumber":0},"Location":"Head","ParameterType":"String","Required":"REQUIRED","DefaultValue":"constance","Description":"constance"}]
  11. &ServiceParameters=[{"ServiceParameterName":"age","Location":"Head","Type":"Number","ParameterCatalog":"REQUEST"},{"ServiceParameterName":"sex","Location":"Query","Type":"String","ParameterCatalog":"REQUEST"},{"ServiceParameterName":"userId","Location":"Path","Type":"Number","ParameterCatalog":"REQUEST"},{"ServiceParameterName":"clientIp","Location":"Head","Type":"String","ParameterCatalog":"SYSTEM"},{"ServiceParameterName":"constance","Location":"Head","Type":"String","ParameterCatalog":"CONSTANT"}]
  12. &ServiceParametersMap=[{"ServiceParameterName":"age","RequestParameterName":"age"},{"ServiceParameterName":"sex","RequestParameterName":"sex"},{"ServiceParameterName":"userId","RequestParameterName":"userId"},{"ServiceParameterName":"clientIp","RequestParameterName":"CaClientIp"},{"ServiceParameterName":"constance","RequestParameterName":"constance"}]
  13. &ResultType=HTML
  14. &ResultSample=200
  15. &<公共請求參數>

返回示例

XML格式

  1. <ModifyApiResponse>
  2. <RequestId>CEF72CEB-54B6-4AE8-B225-F876FF7BA984</RequestId>
  3. </ModifyApiResponse>

JSON格式

  1. {
  2. "RequestId":"6C87A26A-6A18-4B8E-8099-705278381A2C"
  3. }

最後更新:2016-12-15 09:04:14

  上一篇:go 刪除域名證書__域名相關接口_API_API 網關-阿裏雲
  下一篇:go 快速切換API版本__API管理相關接口_API_API 網關-阿裏雲