首页 负载均衡 应用型负载均衡ALB 开发参考 API参考 API目录 实例 EnableLoadBalancerIpv6Internet - 开启负载均衡IPv6公网

EnableLoadBalancerIpv6Internet - 开启负载均衡IPv6公网

更新时间: 2023-11-01 19:45:25

调用EnableLoadBalancerIpv6Internet接口将双栈应用型负载均衡实例的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。
    404ResourceNotFound.LoadBalancerThe specified resource %s is not found.资源%s不存在。

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

    变更历史

    变更时间变更内容概要操作
    暂无变更历史
    阿里云首页 负载均衡 相关技术圈