文档

EnableLoadBalancerIpv6Internet - 开启负载均衡IPv6公网

更新时间:

将双栈应用型负载均衡实例的IPv6私网变更为IPv6公网。

接口说明

前提条件

已创建双栈 ALB 实例,调用 CreateLoadBalancer 接口将 AddressIpVersion 设置为 DualStack

说明 AddressIpVersion 设置为 DualStack 时:
  • AddressType 设置为 Internet 表示 ALB 实例拥有 IPv4 公网和 IPv6 私网访问能力。
  • AddressType 设置为 Intranet 表示 ALB 实例拥有 IPv4 私网和 IPv6 私网访问能力。
  • 使用说明

    • 变更成功后,Ipv6AddressType 类型将变为 Internet,ALB 实例 IPv6 地址即具备公网能力,后续该 ALB 实例下变配或者弹性产生的新的弹性网卡 ENI(Elastic Network Interface)也会自动开启公网能力,您可以通过调用 GetLoadBalancerAttribute 接口查看 Ipv6AddressType 的取值。

    • EnableLoadBalancerIpv6Internet 接口属于异步接口,即系统返回一个请求 ID,但该 ALB 实例的 IPv6 私网尚未变更为 IPv6 公网,系统后台的变更任务仍在进行。您可以调用 GetLoadBalancerAttribute 查询 ALB 实例 IPv6 网络的变更状态:

      • 当应用型负载均衡处于 Configuring 状态时,表示 ALB 实例的 IPv6 私网正在变更为 IPv6 公网。

      • 当应用型负载均衡处于 Active 状态时,表示 ALB 实例的 IPv6 私网变更 IPv6 公网成功。

    调试

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

    授权信息

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

    • 操作:是指具体的权限点。
    • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
    • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
      • 对于必选的资源类型,用背景高亮的方式表示。
      • 对于不支持资源级授权的操作,用全部资源表示。
    • 条件关键字:是指云产品自身定义的条件关键字。
    • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
    操作访问级别资源类型条件关键字关联操作
    alb:EnableLoadBalancerIpv6InternetWrite
    • LoadBalancer
      acs:alb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}
    • alb:AddressType

    请求参数

    名称类型必填描述示例值
    ClientTokenstring

    客户端 Token,用于保证请求的幂等性。

    从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。

    说明 若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
    5A2CFF0E-5718-45B5-9D4D-70B3FF3898
    DryRunboolean

    是否只预检此次请求。取值:

    • true:发送检查请求,不会开启负载均衡 ALB 的 IPv6 公网。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过,则返回对应错误。如果检查通过,则返回错误码DryRunOperation
    • false(默认值):发送正常请求,通过检查后返回 HTTP 2xx 状态码并直接进行操作。
    false
    LoadBalancerIdstring

    应用型负载均衡实例的 ID。

    alb-o2cvudgo6rlqz7****

    返回参数

    名称类型描述示例值
    object

    Schema of Response

    RequestIdstring

    请求 ID。

    BB920797-D70E-567F-8098-55A861DD7912
    JobIdstring

    异步任务 ID。

    4a6e3ad4-ef08-4ab1-b332-fa621cfe****

    示例

    正常返回示例

    JSON格式

    {
      "RequestId": "BB920797-D70E-567F-8098-55A861DD7912",
      "JobId": "4a6e3ad4-ef08-4ab1-b332-fa621cfe****"
    }

    错误码

    HTTP status code错误码错误信息描述
    400IncorrectStatus.LoadBalancerThe status of %s [%s] is incorrect.资源%s [%s]的状态无效。
    400IncorrectBusinessStatus.LoadBalancerThe business status of %s [%s] is incorrect.资源%s [%s]的业务状态无效。
    400OperationDenied.NonDualStackInstanceThe operation is not allowed because of %s.操作被拒绝,原因是%s。
    400OperationDenied.Ipv6InternetInstanceThe operation is not allowed because of %s.操作被拒绝,原因是%s。
    403Forbidden.LoadBalancerAuthentication is failed for %s.负载均衡操作鉴权失败。
    404ResourceNotFound.LoadBalancerThe specified resource %s is not found.资源%s不存在。

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

    变更历史

    变更时间变更内容概要操作
    2024-01-29OpenAPI 错误码发生变更看变更集
    变更项变更内容
    错误码OpenAPI 错误码发生变更
      删除错误码:400
      删除错误码:404
      新增错误码:403
    • 本页导读 (1)
    文档反馈