You need to enable JavaScript to run this app.
文档中心
API 网关

API 网关

复制全文
下载 pdf
后端管理
CreateUpstreamVersion - 创建 Upstream 版本
复制全文
下载 pdf
CreateUpstreamVersion - 创建 Upstream 版本
创建 Upstream 版本。​
请求说明​
API 网关已在全球多个地域部署服务,旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅 服务地址 文档,根据业务所在地域,选择最合适的接入点。​
  • 请求方式:POST​
  • 请求地址:https://apig.cn-beijing.volcengineapi.com?Action=CreateUpstreamVersion&Version=2021-03-03​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
​
参数​
类型​
是否必选​
示例值​
描述​
Action​
String​
是​
CreateUpstreamVersion​
接口名称。当前 API 的名称为 CreateUpstreamVersion。​
Version​
String​
是​
2021-03-03​
接口版本。当前 API 的版本为 2021-03-03。​
UpstreamId​
String​
是​
ud8t****​
Upstream ID。您可以通过 ListUpstreams 查询 Upstream ID。​
UpstreamVersion​
Object of UpstreamVersion​
是​
-​
Upstream 版本。​
​
UpstreamVersion​
​
参数​
类型​
是否必选​
示例值​
描述​
Name​
String​
是​
example​
Upstream 版本名称。​
  • 支持大小写字母、数字和中划线(-),长度限制为 2~63 个字符。​
  • 不能以中划线(-)开头。​
  • 同一 Upstream 下版本名称唯一。​
Labels​
Array of Label​
是​
-​
当前版本在后端类型对应的标签。​
注意​
  • 请务必保证标签的正确性。标签填写错误将导致流量无法转发至当前版本。​
  • 相同的标签仅支持配置一个灰度版本。​
UpdateTime​
String​
否​
2025-01-01T00:00:00+08:00​
Upstream 版本更新时间。​
标准 RFC3339 格式的 UTC+0 时间。​
​
Label​
​
参数​
类型​
是否必选​
示例值​
描述​
Key​
String​
是​
example-key​
标签键。​
Value​
String​
否​
example-value​
标签值。​
​
请求示例​
​
POST https://apig.cn-beijing.volcengineapi.com?Action=CreateUpstreamVersion&Version=2021-03-03​
Content-Type: application/json​
{​
"UpstreamId": "ud8t****",​
"UpstreamVersion": "example"​
}​
​
返回参数​
​
参数​
类型​
示例值​
描述​
UpstreamId​
String​
ud8t****​
Upstream ID。​
Name​
String​
example​
版本名称。​
​
返回示例​
​
Content-Type: application/json​
{​
"ResponseMetadata": {​
"RequestId": "20230604110420****100232280022D31",​
"Action": "CreateUpstreamVersion",​
"Version": "2021-03-03",​
"Service": "apig",​
"Region": "cn-beijing"​
},​
"Result": {​
"UpstreamId": "ud8t****",​
"Name": "example"​
}​
}​
​
错误码​
本接口无特有的错误码。更多信息请参见 公共错误码。​
最近更新时间:2026.07.29 10:20:04
这个页面对您有帮助吗?
有用
有用
无用
无用