专有云计算

  • 专有云计算 > API 文档 > 创建负载均衡资源池

    创建负载均衡资源池

    最近更新时间:2022-01-18 10:42:05

    请求路径

    POST /api/rio/v1/network/loadbalancer_listener/:listener_id/pool

    请求参数

    名称 类型 位置 必须 描述
    x-rio-zone-id string header 地域 ID
    listener_id string path 监听器 ID
    pool_name string body 资源池名称
    description string body 描述
    scheduler string body 调度算法:
    • wlc : (最小连接数)除了根据每台后端服务器设定的权重值来进行轮询,同时还考虑后端服务器的实际负载(即连接数)。当权重值相同时,当前连接数越小的后端服务器被轮询到的次数(概率)也越高。
    • rr : (轮询)按照访问顺序依次将外部请求依序分发到后端服务器。
    • sch : (源IP)基于源IP地址的一致性hash,相同的源地址会调度到相同的后端服务器。
    protocol string body 协议类型:
    • tcp
    • udp
    • https
    • http
    • sctp
    • terminated_https
    persistence_type string body 持久化类型:
    • APP_COOKIE : 依赖于 APP 定义的 COOKIE,通过在 APP 会话中创建不同的 COOKIE 来区分不同的客户端,后续具有相同 COOKIE 客户端的请求由同一个实服务主机进行处理。
    • HTTP_COOKIE : 客户端第一次连接时,在 HTTP 的应答报文中打上标记,后续具有相同标记的请求由同一个实服务主机进行处理。
    • SOURCE_IP : 以请求的源地址为依据,相同源地址的客户端请求分发至同一后端服务器。
    cookie_name string body 用于会话持久化的 cookie 名称,仅在 PersistenceType = APP_COOKIE 时需要
    persistence_timeout integer body 超时,单位:s
    persistence_granularity string body 用于确定 SCTP 或 UDP 会话持久性的网络掩码
    health_monitor_name string body 健康检查器名称
    health_check_type string body 健康检查协议类型:
    • http
    • https
    • ping
    • sctp
    • tcp
    • tls-hello
    • udp-connect
    health_http_method string body 健康检查请求方法:
    • connect
    • delete
    • get
    • head
    • options
    • patch
    • post
    • put
    • trace
    health_check_domain string body 健康检查的域名
    health_check_uri string body 健康检查的URI
    health_check_connect_port integer body 健康检查使用的端口。取值:1-65535。
    healthy_threshold integer body 健康检查连续成功多少次后,将后端服务器的健康检查状态由fail判定为success。取值:2-10。 默认值: 3
    unhealthy_threshold integer body 健康检查连续失败多少次后,将后端服务器的健康检查状态由success判定为fail。取值:2-10。 默认值: 3
    health_check_interval integer body 健康检查的时间间隔。取值:1-50(秒)。 默认值: 2
    health_check_timeout integer body 健康检查连接超时时间,此值必须小于延迟值(health_check_interval)
    health_check_http_code string body 健康检查正常的HTTP状态码:
    • http_2xx
    • http_3xx
    • http_4xx
    • http_5xx

    返回值

    名称 类型 描述
    request_id string 请求 ID
    data SLBPoolInfo 负载均衡资源池信息

    SLBPoolInfo 负载均衡资源池信息

    名称 类型 描述
    slb_pool_id string 资源池 ID
    enabled boolean 启用状态:
    • true : 已启用
    • false : 已停用
    slb_pool_name string 名称
    description string 描述
    protocol string 协议类型:
    • tcp
    • udp
    • https :tcp 转发实现
    • http
    • sctp
    • terminated_https : https 协议
    status string 状态:
    • active : 正常的
    • creating : 创建中
    • updating :更新中
    • deleting : 删除中
    • error : 错误
    listener_id string 所属监听器 ID
    members []Member 后端服务器组
    type string 持久化类型:
    • APP_COOKIE : 依赖于 APP 定义的 COOKIE,通过在 APP 会话中创建不同的 COOKIE 来区分不同的客户端,后续具有相同 COOKIE 客户端的请求由同一个实服务主机进行处理。
    • HTTP_COOKIE : 客户端第一次连接时,在 HTTP 的应答报文中打上标记,后续具有相同标记的请求由同一个实服务主机进行处理。
    • SOURCE_IP : 以请求的源地址为依据,相同源地址的客户端请求分发至同一后端服务器。
    cookie_name string 用于会话持久化的 cookie 名称,仅在 PersistenceType = APP_COOKIE 时需要
    persistence_timeout integer 超时,单位:s
    persistence_granularity string 用于确定 SCTP 或 UDP 会话持久性的网络掩码
    health_monitor_id string 健康检查器 ID
    health_monitor_name string 健康检查器名称
    health_check_type string 健康检查协议类型:
    • http
    • https
    • ping
    • sctp
    • tcp
    • tls-hello
    • udp-connect
    health_http_method string 健康检查请求方法:
    • connect
    • delete
    • get
    • head
    • options
    • patch
    • post
    • put
    • trace
    health_check_domain string 用于健康检查的域名
    health_check_uri string 用于健康检查的URI
    health_check_connect_port integer 健康检查使用的端口。取值:1-65535。
    healthy_threshold integer 健康检查连续成功多少次后,将后端服务器的健康检查状态由fail判定为success。取值:2-10。 默认值: 3
    unhealthy_threshold integer 健康检查连续失败多少次后,将后端服务器的健康检查状态由success判定为fail。取值:2-10。 默认值: 3
    health_check_interval integer 健康检查的时间间隔。取值:1-50(秒)。 默认值: 2
    health_check_timeout integer 健康检查连接超时时间,此值必须小于延迟值(health_check_interval)
    health_check_http_code string 健康检查正常的HTTP状态码:
    • http_2xx
    • http_3xx
    • http_4xx
    • http_5xx

    Member 后端服务器

    名称 类型 描述
    member_id string 后端服务器 ID
    enabled boolean 启用状态:
    • true : 已启用
    • false : 已停用
    status string 状态:
    • active : 正常
    • creating : 创建中
    • updating : 更新中
    • deleting : 删除中
    • unhealthy : 健康检查未通过
    • error : 错误
    server_id string 服务 ID,对应云主机 ID
    back_up boolean 成员是否为备用服务器,备用服务器只在主服务器全部关闭后才启用
    adress string IP 地址,当添加内部虚拟服务器时传值,IP 地址、专有网络 ID 必传,添加外部虚拟服务器的前提是负载均衡实例可通过网络访问
    subnet_id string 专有网络 ID
    port integer 端口
    weight integer 权重,值范围 0 ~ 100
    create_at integer 创建时间,毫秒时间戳

    请求值示例

    {
        "pool_name":"pool-f19ez",
        "scheduler":"wlc",
        "persistence_type":"APP_COOKIE",
        "description":"desc",
        "cookie_name":"cookie_test_name",
        "load_balancer_id":"7ebe162e-3351-413b-a9c5-623291061b2f",
        "protocol":"tcp"
    }
    

    返回值示例

    {
        "request_id":"HtPfEgtKrwqf_8kW",
        "data":{
            "slb_pool_id":"a4dc3fd3-b1cf-4222-85b3-afce9f0185b8",
            "enabled":true,
            "slb_pool_name":"pool-f19ez",
            "description":"desc",
            "protocol":"tcp",
            "status":"creating",
            "server_member_type":null,
            "listener_id":"9491a0a0-28f4-476f-a7f0-eb2b8a648b64",
            "members":[
    
            ],
            "session_persistence":{
                "type":"APP_COOKIE",
                "cookie_name":"cookie_test_name",
                "persistence_timeout":0,
                "persistence_granularity":""
            },
            "health_monitor_id":"dd44450b-0b4f-432c-a10f-39841ce32038",
            "health_monitor_name":"health-1l7pS",
            "health_check_type":"ping",
            "health_http_method":null,
            "health_check_domain":"",
            "health_check_uri":"",
            "health_check_connect_port":null,
            "healthy_threshold":3,
            "unhealthy_threshold":3,
            "health_check_interval":5,
            "health_check_timeout":5,
            "health_check_http_code":null,
            "create_at":1642124597000
        }
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close