CreatePolicy - 创建策略-API 网关(API Gateway)-阿里云帮助中心

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

apig:CreatePolicy

none

*全部资源

*

无

请求语法

POST /v2/policies HTTP/1.1

请求参数

名称	类型	必填	描述	示例值
body	object	否	请求 Body。	{'key': 'value'}
className	string	是	策略类型，RateLimit、ConcurrencyLimit、CircuitBreaker、HttpRewrite、HeaderModify、Cors、Authentication、FlowCopy、Timeout、Retry、IpAccessControl、DirectResponse、Redirect、Fallback、ServiceTls、ServiceLb、ServicePortTls、Waf、JWTAuth、OIDCAuth、ExternalZAuth、AiProxy、ModelRouter、AiStatistics、AiSecurityGuard、AiFallback、ModelMapper、AiTokenRateLimit、AiCache、DynamicRoute 枚举值： ServicePortTls : 服务端口 TLS，后端服务端口 TLS 配置 CircuitBreaker : 熔断，后端异常时自动熔断 IpAccessControl : IP 访问控制，基于 IP 黑白名单过滤 HeaderModify : 请求头修改，增删改 HTTP 请求头 ExternalZAuth : 外部认证，对接外部认证服务 RateLimit : 速率限流，限制请求速率 AiTokenRateLimit : AI Token 限流，基于 Token 消耗的限流 DirectResponse : 直接响应，直接返回固定响应 OIDCAuth : OIDC 认证，基于 OIDC 协议的请求认证 AiSecurityGuard : AI 安全防护，AI 请求/响应内容安全检测 ConcurrencyLimit : 并发限流，限制并发请求数 ServiceTls : 服务端 TLS，后端服务 TLS 配置 AiCache : AI 缓存，缓存 AI 响应结果 Timeout : 超时策略，设置请求超时时间 FlowCopy : 流量复制，将请求复制到额外后端 Redirect : 重定向，将请求重定向到其他地址 Cors : 跨域资源共享（CORS），控制跨域请求 JWTAuth : JWT 认证，基于 JWT 的请求认证 ServiceLb : 服务负载均衡，后端服务负载均衡配置 Authentication : 通用认证，通用请求认证策略 Fallback : 降级策略，后端不可用时返回降级响应 Retry : 重试策略，请求失败时自动重试 AiFallback : AI 降级，AI 服务不可用时降级到备选模型 Waf : Web 应用防火墙，请求安全防护 HttpRewrite : HTTP 重写，重写请求 URL 或路径	Timeout
config	string	是	策略配置	{"unitNum":1,"timeUnit":"s","enable":true}
description	string	否	描述	超时策略
name	string	是	策略名称	test-policy

返回参数

名称	类型	描述	示例值
	object	Schema of Response
code	string	响应状态码。	Ok
data	object	响应数据。
policyId	string	策略 ID	p-cq7l5s5lhtgi6qasr***
message	string	响应信息。	success
requestId	string	请求 ID。	393E2630-DBE7-5221-AB35-9E7406754***

示例

正常返回示例

JSON格式

{
  "code": "Ok",
  "data": {
    "policyId": "p-cq7l5s5lhtgi6qasr***\n"
  },
  "message": "success",
  "requestId": "393E2630-DBE7-5221-AB35-9E7406754***"
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter.IsEmpty	Parameter className should not be empty.

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。