检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
检测到您已登录华为云国际站账号，为了您更好的体验，建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
environment. 404 API不存在或未发布到环境 检查调用API所使用的域名、请求方法、路径和创建的API是否一致；检查API是否发布，如果发布到非生产环境，检查请求X-Stage头是否为发布的环境名；检查调用API使用的域名是否已经绑定到API所在的分组。 APIG.0101 The
environment. 404 API不存在或未发布到环境 检查调用API所使用的域名、请求方法、路径是否正确。 检查API是否发布。 检查域名解析是否正确。 检查API是否使用OPTIONS跨域请求，如果使用OPTIONS跨域请求，请在API中开启CORS。 具体操作请参见常见问题。
APIG对API请求体的大小是否有限制？ 共享版：API每次最大可以转发Body体为12MB的请求包。请求body体超过12M时，API网关会拒绝该请求。这种场景，推荐考虑使用对象存储服务。 专享版：API每次最大可以转发Body体为12MB的请求包。请求body体超过12M时，根据业务需求，请在“实例概览”的配
变更计费模式概述 在开通使用API网关后，如果发现当前计费模式无法满足您的业务需求，您可以变更计费模式。 按需付费变更为包年/包月 按需付费变更为包年/包月，需要您按需购买相应的版本，生成新的订单并支付后，包年/包月计费模式立即生效。 包年/包月变更为按需付费 包年/包月变更为按
已发布的API因为其他原因需要暂停对外提供服务，可以暂时将API从相关环境中下线。 该操作将导致此API在指定的环境无法被访问，请确保已经告知使用此API的用户。 前提条件 已创建API分组和分组内的API。 API已发布到该环境。 操作步骤 进入共享版控制台。 单击“开放API >
单击“健康检查”，进入“健康检查”页签。 单击“编辑”，弹出“编辑健康检查配置”对话框。 编辑如表1所示信息。 表1 健康检查 信息项 描述 协议 使用以下协议，对VPC中主机执行健康检查。 TCP HTTP HTTPS 默认为TCP协议。 路径 健康检查时的目标路径。 仅在协议不为“TCP”时，需要设置。
已发布的API因为其他原因需要暂停对外提供服务，可以暂时将API从相关环境中下线。 该操作将导致此API在指定的环境无法被访问，请确保已经告知使用此API的用户。 前提条件 已创建API分组和分组内的API。 API已发布到该环境。 操作步骤 进入API网关控制台页面。 根据实际业务在左侧导航栏上方选择实例。
API网关支持导入微服务引擎（Cloud Service Engine，简称CSE）的微服务。将微服务作为后端服务，在API网关中开放API，提供给API调用者使用。 如果当前实例不支持“导入CSE微服务”，请联系客服。 目前仅广州友好、贵阳一、上海一、广州、北京四区域支持导入CSE服务。 注意事项 仅支持导入未开启安全认证的微服务引擎。
内网域名：部署在云服务平台内的业务系统，可以使用内网域名访问API。 公网域名：部署在云服务平台外的业务系统，可以使用公网域名访问API。 您也可以使用系统分配的调试域名（子域名）访问API分组内的API，该调试域名唯一且不可修改，每天最多可以访问1000次，仅适用于内部测试使用。 当独立域名为泛域名（例如*
包年/包月：一种预付费模式，即先付费再使用，按照订单的购买周期进行结算。购买周期越长，享受的折扣越大。一般适用于设备需求量长期稳定的成熟业务。 按需计费：一种后付费模式，即先使用再付费，按照API网关实际使用时长计费，秒级计费，按小时结算。按需计费模式允许您根据实际业务需求灵活地调整资源使用，无需提前预置
包年/包月转按需 创建一个包年/包月实例后，您可以将该实例的计费模式转为按需计费，回收部分成本，同时更加灵活地按需使用实例。 包年/包月转按需，需包年/包月计费模式到期后，按需的计费模式才会生效。 前提条件 实例计费模式为“包年/包月”。 操作步骤 方式一：在API网关控制台的实例管理中变更计费模式。
续费概述 包年/包月实例到期后会影响实例正常运行。如果您想继续使用，需要在指定的时间内为实例续费，否则实例资源会自动释放，数据丢失且不可恢复。 续费操作仅适用于包年/包月实例，按需计费实例不需要续费，只需要保证账户余额充足即可。 包年/包月实例在到期前续费成功，所有资源得以保留，
”，则API在发布到环境1时，使用“/Stage/test”代替“Path”，在环境1中调用此API时，后端服务请求Path为“/Stage/test”。在环境2中创建了变量“Path”，变量值“/Stage/AA”，则API在发布到环境2时，使用“/Stage/AA”代替“Pa
API调用授权概述 API调用者在调用使用APP认证方式的API时，可以通过用凭据进行API认证或AppCode进行简易的API认证。您可以根据业务需求选择其中一种进行认证，下文介绍具体两种认证方式的配置。 配置APIG的API认证凭据 在API网关中创建一个凭据，生成密钥对（K
对于不同的环境，API的版本、请求地址甚至于包括请求消息等均有可能不同。如：某个API，v1.0的版本为稳定版本，发布到了生产环境供生产使用，同时，该API正处于迭代中，v1.1的版本是开发人员交付测试人员进行测试的版本，发布在测试环境上，而v1.2的版本目前开发团队正处于开发过程中，可以发布到开发环境进行自测等。
它的值是服务端根据客户端的IP指定的，当客户端访问APIG时，如果中间没有任何代理，那么就会把remote_addr设为客户端IP；如果使用了某个代理，那么客户端会先访问这个代理，然后再由这个代理转发到APIG，这样就会把remote_addr设为这台代理机的IP。 父主题： API策略
如果您使用系统角色相关权限，需要同时拥有“APIG Administrator”和“VPC Administrator”权限才能创建实例。 如果您使用系统策略，则拥有“APIG FullAccess”即可。 如果您使用自定义策略，请参考APIG自定义策略。 网络 如果您使用192
APIG最佳实践一览表 最佳实践 说明 使用APIG专享版开放云容器引擎CCE工作负载 云容器引擎（Cloud Container Engine，即CCE）中的工作负载，以及微服务，可通过API网关将服务能力以API形式对外开放。 使用APIG专享版开放本地数据中心的服务能力 使用专享版API网关为本
授权项变更公告 公告说明 自2024年9月起，当用户使用以下API的自定义策略授权时，用户需创建或更新自定义策略才可访问。 权限描述 对应的API 新增授权项 依赖授权项 IAM项目（Project） 企业项目（Enterprise Project） 获取SSL证书列表 GET
响应缓存策略仅支持使用GET、HEAD方法的API。 超过1M的响应体不会被缓存。 用于后端响应内容的缓存大小为128m。 API网关遵守后端应答中的Cache-Control头的约定来处理缓存，如果后端不返回Cache-Control头，则默认缓存，使用策略中配置的ttl字段作为缓存超期时间。
长按/截图保存，微信识别二维码
或者关注公众号“华为云”
