You need to enable JavaScript to run this app.
文档中心
全球加速

全球加速

复制全文
下载 pdf
基础型加速器-加速 IP 接口
创建加速 IP CreateBasicAccelerateIP
复制全文
下载 pdf
创建加速 IP CreateBasicAccelerateIP

在指定基础型加速器的加速区域中创建加速 IP,并按绑定模式关联终端节点。

请求说明

  • 请求方式:POST
  • 请求地址:https://ga.volcengine-api.com?Action=CreateBasicAccelerateIP&Version=2022-03-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

参数
类型
是否必填
示例值
描述
Action
String
是
CreateBasicAccelerateIP
要执行的操作,取值:CreateBasicAccelerateIP。
Version
String
是
2022-03-01
API 的版本,取值:2022-03-01。

Body

参数
类型
是否必填
示例值
描述
AcceleratorId
String
是
accinstance-basic-UKBfMXboZLwxFGNkiR****
待创建加速 IP 的加速器 ID。可通过调用 ListBasicAccelerators 接口获取账号下的加速器 ID。
IPSetId
String
是
ipset-basic-YFsv8EcxWd8gHLrEvf****
待创建加速 IP 的加速区域 ID。可通过调用 ListBasicIPSets 接口获取指定加速器上的加速区域 ID。
EdgeNodeName
String
是
sz-cluster
指定提供加速 IP 的边缘节点名称。
ISP
String
是
ChinaTelecom
指定加速 IP 的运营商。取值:
  • ChinaMobile:中国移动。
  • ChinaUnicom:中国联通。
  • ChinaTelecom:中国电信。
  • BGP:BGP。
Mode
String
是
Standard
指定加速 IP 与终端节点的绑定模式。取值:
  • Standard:标准模式。终端节点为边缘计算节点或 ENI 时可选。一个加速 IP 仅可关联一个终端节点。
  • All-Port:全端口模式。终端节点为自定义 IP 时可选。一个加速 IP 仅可关联一个终端节点。
  • Shared:共享模式。终端节点为边缘计算节点或 ENI 时可选。一个加速 IP 可关联多个终端节点,一个终端节点也可关联多个加速 IP。
EndpointIds
String[]
否
["endpoint-basic-NhQyqd6KKsBWpcC5AE****"]
待关联的终端节点 ID 列表。可通过调用 ListBasicEndpoints 接口获取指定加速器下的终端节点 ID。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数
类型
示例值
描述
AccelerateIPId
String
ip-basic-f4azPvEXZwZJsXrirm****
新创建的加速 IP 的 ID。

请求示例

POST https://ga.volcengine-api.com?Action=CreateBasicAccelerateIP&Version=2022-03-01
{
  "AcceleratorId": "accinstance-basic-UKBfMXboZLwxFGNkiR****",
  "IPSetId": "ipset-basic-YFsv8EcxWd8gHLrEvf****",
  "EdgeNodeName": "sz-cluster",
  "ISP": "ChinaTelecom",
  "Mode": "Standard",
  "EndpointIds": [
    "endpoint-basic-NhQyqd6KKsBWpcC5AE****"
  ]
}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202306041104201234100232280022D31",
    "Action": "CreateBasicAccelerateIP",
    "Version": "2022-03-01",
    "Service": "ga",
    "Region": "cn-beijing"
  },
  "Result": {
    "AccelerateIPId": "ip-basic-f4azPvEXZwZJsXrirm****"
  }
}

错误码

本接口无专用错误码。公共错误码请参见公共错误码。

最近更新时间:2026.09.23 16:20:54
这个页面对您有帮助吗?
有用
有用
无用
无用