将双栈应用型负载均衡实例的IPv6公网变更为IPv6私网。
接口说明
前提条件
已创建双栈 ALB 实例,调用 CreateLoadBalancer 接口将 AddressIpVersion 设置为 DualStack。
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代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
alb:DisableLoadBalancerIpv6Internet |
update |
*LoadBalancer
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ClientToken |
string |
否 |
客户端 Token,用于保证请求的幂等性。 从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符。 说明
若您未指定,则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 可能不一样。 |
593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3 |
| DryRun |
boolean |
否 |
是否只预检此次请求。取值:
|
false |
| LoadBalancerId |
string |
是 |
应用型负载均衡实例 ID。 |
alb-chugtlrj1iusjh**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
7D866E37-1123-5160-AFF1-BDAF5EB86A8A |
| JobId |
string |
异步任务 ID。 |
d12871a6-ebb2-41f3-8d74-d9f452bb**** |
示例
正常返回示例
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. | 实例的当前状态不支持本次操作。 |
| 400 | IncorrectBusinessStatus.LoadBalancer | The business status of %s [%s] is incorrect. | 实例的当前状态不支持本次操作。 |
| 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不存在。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。