ModifyApi_API 网关_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

" 此接口面向开放 API 的用户

  • 该接口需要全量更新,不支持部分参数更新
  • 修改 ApiName 时需要注意,同一个分组内 API 不允许重名
  • 修改 RequestPath 时需要注意,同一个分组内 Path 不允许重复
  • 该接口调用的 QPS 限制为:单用户 QPS 不超过 50

流控信息

请求速率为100/1(s)。更多流控信息,请前往配额中心查看

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
apigateway:ModifyApi
Update
ApiGroup
acs:apigateway:{#regionId}:{#accountId}:apigroup/{#GroupId}

请求参数

字段名称字段详情
GroupIdstring

指定的分组编号

示例值:927d50c0f2e54b359919923d908bb015参考取值来源:
    ModifyApiGroup
    CreateApiGroup
    DescribeApiGroups
ApiIdstring

API 编号

示例值:8afff6c8c4c6447abb035812e4d66b65参考取值来源:
    CreateApi
ApiNamestring

API 的名称,组内不允许重复。支持汉字,英文,数字,下划线,且只能以英文和汉字开头,4~50 个字符

示例值:ApiName参考取值来源:
    CreateApi
    DescribeApi
Descriptionstring

API 描述信息,最多 180 个字符

示例值:Api description
Visibilitystring

API 是否公开,目前可以取值:展开详情

示例值:PUBLIC
AuthTypestring

API 安全认证类型,目前可以取值:展开详情

示例值:APP
RequestConfigstring

Consumer 向网关发送 API 请求的相关配置项

示例值:{"RequestProtocol":"HTTP","RequestHttpMethod":"GET","RequestPath":"/v3/getUserTest/[userId]","BodyFormat":"FORM","PostBodyDescription":""}
ServiceConfigstring

网关向后端服务发送 API 请求的相关配置项

示例值:{"ServiceProtocol":"HTTP","ServiceHttpMethod":"GET","ServiceAddress":"http://www.customerdomain.com","ServiceTimeout":"1000","ServicePath":"/v3/getUserTest/[userId]"}
RequestParametersstring

Consumer 向网关发送 API 请求的参数描述。展开详情

示例值:[ { "ParameterLocation": { "name": "Head", "orderNumber": 2 }, "ParameterType": "String", "Required": "OPTIONAL", "isHide": false, "ApiParameterName": "header1", "DefaultValue": "123124", "Location": "Head" }, { "ParameterLocation": { "name": "Head", "orderNumber": 2 }, "ParameterType": "String", "Required": "REQUIRED", "isHide": false, "ApiParameterName": "header2", "DefaultValue": "", "Location": "Head" }, { "ParameterLocation": { "name": "Query", "orderNumber": 3 }, "ParameterType": "String", "Required": "OPTIONAL", "isHide": false, "ApiParameterName": "query1", "DefaultValue": "1245", "Location": "Query" }, { "ApiParameterName": "CaClientIp", "ParameterLocation": { "name": "Query", "orderNumber": 0 }, "Location": "Query", "ParameterType": "String", "Required": "REQUIRED", "Description": "ClientIP" }, { "ApiParameterName": "testConstant", "ParameterLocation": { "name": "Head", "orderNumber": 0 }, "Location": "Head", "ParameterType": "String", "Required": "REQUIRED", "DefaultValue": "111" } ]
SystemParametersstring

网关发送给后端服务的系统参数

示例值:[{\"location\":\"HEAD\",\"parameterName\":\"CaDomain\",\"serviceParameterName\":\"host\"}]
ConstantParametersstring

网关发送给后端服务的常量参数

示例值:[{\"ConstantValue\":\"123\",\"Description\":\"常量参数\",\"Location\":\"HEAD\",\"ServiceParameterName\":\"test\"}]
ServiceParametersstring

网关向后端服务发送 API 请求的参数描述。展开详情

示例值:[ { "ServiceParameterName": "header1", "Location": "Head", "Type": "String", "ParameterCatalog": "REQUEST" }, { "ServiceParameterName": "header2", "Location": "Query", "Type": "String", "ParameterCatalog": "REQUEST" }, { "ServiceParameterName": "query1", "Location": "Head", "Type": "String", "ParameterCatalog": "REQUEST" }, { "ServiceParameterName": "ipp", "Location": "Query", "Type": "String", "ParameterCatalog": "SYSTEM" }, { "ServiceParameterName": "testConstant", "Location": "Head", "Type": "String", "ParameterCatalog": "CONSTANT" } ]
ServiceParametersMapstring

Consumer 向网关发送请求的参数和网关向后端服务发送的请求的参数的映射关系。展开详情

示例值:[ { "ServiceParameterName": "header1", "RequestParameterName": "header1" }, { "ServiceParameterName": "header2", "RequestParameterName": "header2" }, { "ServiceParameterName": "query1", "RequestParameterName": "query1" }, { "ServiceParameterName": "ipp", "RequestParameterName": "CaClientIp" }, { "ServiceParameterName": "testConstant", "RequestParameterName": "testConstant" } ]
ResultTypestring

后端服务返回应答的格式,目前可以设置为:JSON、TEXT、BINARY、XML、HTML。展开详情

示例值:HTML
ResultSamplestring

后端服务返回应答的示例 该值仅用于生成文档使用。不对返回结果产生影响。

示例值:{}
FailResultSamplestring

后端服务失败返回应答的示例。展开详情

示例值:{\"requestId\":\"3b9b8b31-93c3-489e-8ebb-cab35a1aee51\",\"errCode\":500,\"errMsg\":\"connection refused\"}
ErrorCodeSamplesstring

后端服务返回的错误码示例。展开详情

示例值:[{\"Code\":\"400\",\"Message\":\"Login failed\",\"Description\":\"Invalid user name or password\"}]
ResultDescriptionsstring

API 的返回说明

示例值:{}
OpenIdConnectConfigstring

第三方账号认证 OpenID Connect 相关配置项

示例值:{\"OpenIdApiType\":\"IDTOKEN\",\"PublicKey\":\"lzlj1573\",\"IdTokenParamName\":\"\",\"PublicKeyId\":\"lzljorders\"}
AllowSignatureMethodstring

API 的客户端请求签名方法,可选值:展开详情

示例值:HmacSHA256
WebSocketApiTypestring

双向通信 API 类型:展开详情

示例值:COMMON参考取值来源:
    DescribeApiHistory
ResultBodyModelstring

api 的返回结果

示例值:{}
ForceNonceCheckboolean
  • 设置 ForceNonceChecktrue, 请求时强制检查 X-Ca-Nonce,这个是请求的唯一标识,一般使用 UUID 来标识。API 网关收到这个参数后会校验这个参数的有效性,同样的值,15 分内只能被使用一次。可以有效防止 API 的重放攻击。展开详情
示例值:true
DisableInternetboolean
  • 设置 DisableInternet 为 true,仅支持内网调用 API。展开详情
示例值:true
AppCodeAuthTypestring

支持 AppCode 的认证类型。可选值:展开详情

示例值:DEFAULT
BackendIdstring

后端服务 ID

示例值:0d105f80a8f340408bd34954d4e4ff22参考取值来源:
    CreateBackend
    DescribeBackendList
BackendEnableboolean

是否启用后端服务

示例值:true

返回参数

字段名称字段详情
RequestIdstring

请求 ID

示例值:6C87A26A-6A18-4B8E-8099-705278381A2C

返回示例

变更历史

变更时间变更内容概要操作
2024-01-26
变更请求参数RequestParameters
变更请求参数SystemParameters
变更请求参数ConstantParameters
变更请求参数ServiceParameters
变更请求参数ServiceParametersMap
变更请求参数ResultSample
变更请求参数FailResultSample
变更请求参数ErrorCodeSamples
变更请求参数ResultDescriptions
2022-01-19
新增请求参数BackendId
新增请求参数BackendEnable

相关示例