将双栈应用型负载均衡实例的IPv6公网变更为IPv6私网。
接口说明
前提条件
已创建双栈 ALB 实例,调用 CreateLoadBalancer 接口将 AddressIpVersion 设置为 DualStack。
- AddressType 设置为 Internet 表示 ALB 实例拥有 IPv4 公网和 IPv6 私网访问能力。
- AddressType 设置为 Intranet 表示 ALB 实例拥有 IPv4 私网和 IPv6 私网访问能力。
使用说明
-
变更成功后,Ipv6AddressType 类型将变为 Intranet,ALB 实例 IPv6 地址即具备私网能力,后续该 ALB 实例下变配或者弹性产生的新的弹性网卡 ENI(Elastic Network Interface)也会默认具备私网能力。您可以通过调用 GetLoadBalancerAttribute 接口查看 Ipv6AddressType 的取值。
-
DisableLoadBalancerIpv6Internet 接口属于异步接口,即系统返回一个请求 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:DisableLoadBalancerIpv6Internet | Write |
|
| 无 |
请求参数
名称 | 类型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
ClientToken | string | 否 | 客户端 Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。
| 593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3 |
DryRun | boolean | 否 | 是否只预检此次请求。取值:
| false |
LoadBalancerId | string | 是 | 应用型负载均衡实例 ID。 | alb-chugtlrj1iusjh**** |
返回参数
示例
正常返回示例
JSON
格式
{
"RequestId": "7D866E37-1123-5160-AFF1-BDAF5EB86A8A",
"JobId": "d12871a6-ebb2-41f3-8d74-d9f452bb****"
}
错误码
HTTP status code | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IncorrectStatus.LoadBalancer | The status of %s [%s] is incorrect. | 资源%s [%s]的状态无效。 |
400 | IncorrectBusinessStatus.LoadBalancer | The business status of %s [%s] is incorrect. | 资源%s [%s]的业务状态无效。 |
400 | OperationDenied.NonDualStackInstance | The operation is not allowed because of %s. | 操作被拒绝,原因是%s。 |
400 | OperationDenied.Ipv6IntranetInstance | The operation is not allowed because of %s. | 操作被拒绝,原因是%s。 |
403 | Forbidden.LoadBalancer | Authentication is failed for %s. | 负载均衡操作鉴权失败。 |
404 | ResourceNotFound.LoadBalancer | The specified resource %s is not found. | 资源%s不存在。 |
访问错误中心查看更多错误码。
变更历史
变更时间 | 变更内容概要 | 操作 | ||||||||
---|---|---|---|---|---|---|---|---|---|---|
2024-01-29 | OpenAPI 错误码发生变更 | 看变更集 | ||||||||
|