CDN加速

文档中心 API文档 工具服务 创建服务负载均衡

创建服务负载均衡

更新时间:2019-08-16 13:05:30
适用产品:通用功能

接口描述

创建服务的负载均衡

请求参数

参数名称类型必填描述
namestring负载均衡名称,名称为4-63个字符, 以小写字母开头,由小写字母,数字,‘-’组成,且不能以中划线‘-’结尾。若为空,则系统自动生成。
prefixstring负载均衡cname域名前缀,长度不超过63个字符,若为空,系统随机分配。
protocolstring通信协议,当前支持三种通信协议,分别为HTTP、TCP和UDP。
descriptionstring负载均衡描述,描述长度不超过255个字符
sessionint会话保持。默认为不开启。开启会话保持:1;不开启会话保持(即轮询):0
forwardsarray公网映射关系。
┗servicePortint服务端口。
┗uristringhttp转发路径,需以/开头,支持大小写字母数字和-,不同服务端口需对应不同uri参数。当protocol为HTTP时才有该参数。
┗portint公网协议端口,范围为32000-32767,若需要特殊端口,请与相关人员联系。当protocol为TCP或UDP时才有该参数。

返回参数

参数名称类型描述
namestring负载均衡名称,名称为4-63个字符, 以小写字母开头,由小写字母,数字,‘-’组成,且不能以中划线‘-’结尾。若为空,则系统自动生成。
prefixstring负载均衡cname域名前缀,长度不超过63个字符,若为空,系统随机分配。
protocolstring通信协议,当前支持三种通信协议,分别为HTTP、TCP和UDP。
descriptionstring负载均衡描述,描述长度不超过255个字符
sessionint会话保持。默认为不开启。开启会话保持:1;不开启会话保持(即轮询):0
forwardsarray公网映射关系。
┗servicePortint服务端口。
┗uristringhttp转发路径,需以/开头,支持大小写字母数字和-,不同服务端口需对应不同uri参数。当protocol为HTTP时才有该参数。
┗portint公网协议端口,范围为32000-32767,若需要特殊端口,请与相关人员联系。当protocol为TCP或UDP时才有该参数。

错误码

错误代码(code)描述(message)HTTP状态码语义
31442001request format error400请求格式错误
31442002missing argument400缺少必要参数
31442003illegal argument400参数非法
31445001duplicate domain400域名已存在
31445009duplicate name400负载均衡名字重复

示例

示例说明
json
请求示例
复制
#!/bin/bash

username="example_username"

apiKey="example_apiKey"

date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"`

password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64`

curl -i --url "https://open-its.chinanetcenter.com/ecc/container/v1/namespace/test-openapi/appservice/test-opensvc-001/load-balance" \

-X "POST" \

-u "$username:$password" \

-H "Date: $date" \

-H "Accept: application/json" \

-d '{
  "name":"test-opensvc-001",
  "prefix": "test1",
  "protocol": "HTTP",
  "session" : 1,
  "description": "test loadbalance",
  "forwards": [ {
    "servicePort": 8080,
    "uri" : "/"
  } ]
}'
返回示例
复制
{
    "code": "0",
    "message": "success",
    "data": {
        "name":"test-opensvc-001",
        "prefix": "test1",
        "protocol": "HTTP",
        "session" : 1,
        "description": "test loadbalance",
        "forwards": [ {
          "port": 80,
          "servicePort": 8080,
          "uri" : "/"
        } ]
      }        
  }