详情页标题前

阿里云负载均衡DescribeLoadBalancers – 查询已创建的负载均衡实例-云淘科技

• 阿里云负载均衡
详情页1

查询已创建的负载均衡实例。

调试

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

调试阿里云负载均衡DescribeLoadBalancers - 查询已创建的负载均衡实例-云淘科技调试

授权信息

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

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

请求参数

名称 类型 必填 描述 示例值
RegionId string 是

传统型负载均衡实例的地域ID。

您可以通过调用DescribeRegions接口查询地域ID。

 cn-hangzhou
ServerId string 否

添加的后端服务器ID。

 vm-server-23****
AddressIPVersion string 否

IP版本，可以设置为ipv4或者ipv6。

 ipv4
LoadBalancerStatus string 否

实例状态。取值：

  • inactive: 实例已停止，此状态的实例监听不会再转发流量。

  • active: 实例运行中，实例创建后，默认状态为active。

  • locked: 实例已锁定。当负载均衡实例到期后，但到期时间未超过7天时，负载均衡实例进入锁定状态。此种状态下，您不能对负载均衡实例进行任何操作，并且实例不再会进行流量转发，但会保留实例的IP和其它配置。

 active
LoadBalancerId string 否

传统型负载均衡实例ID。

支持多值查询，最多可输入10个ID，以半角逗号（,）分隔。

 lb-bp1b6c719dfa****
LoadBalancerName string 否

传统型负载均衡实例名称。

长度为1~80个英文或中文字符，必须以大小字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-）。

支持多值查询，最多可输入10个名称，以半角逗号（,）分隔。

 test
ServerIntranetAddress string 否

添加的后端服务器的内网地址。

支持多值查询，以半角逗号（,）分隔。

 10.XX.XX.102
AddressType string 否

传统型负载均衡实例的网络类型。取值：

  • internet：创建公网负载均衡实例后，系统会分配一个公网IP地址，可以转发公网请求。

  • intranet：创建内网负载均衡实例后，系统会分配一个内网IP地址，仅可转发内网请求。

 intranet
InternetChargeType string 否

公网计费方式。取值：

  • paybybandwidth：按带宽计费。

  • paybytraffic：按流量计费。

当PayType参数的值为PrePay时，只支持按带宽计费。当InstanceChargeType参数的值为PayByCLCU时，只支持按流量计费。

 paybytraffic
VpcId string 否

传统型负载均衡实例所属的VPC ID。

 vpc-bp1aevy8sof****
VSwitchId string 否

传统型负载均衡实例所属的交换机ID。

 vsw-bp12mw1f8k3****
NetworkType string 否

私网实例的网络类型。取值：

  • vpc：专有网络实例。

  • classic：经典网络实例。

 vpc
Address string 否

传统型负载均衡实例的服务地址。

 192.168.XX.XX
MasterZoneId string 否

负载均衡实例的主可用区ID。

 cn-hangzhou-b
SlaveZoneId string 否

传统型负载均衡实例的备可用区ID。

目前对金融云用户暂时不支持多可用区功能。

 cn-hangzhou-d
Tags string 否

传统型负载均衡实例绑定的标签列表，其结构是一个JSON dictionary，包含标签键和标签值。

一次请求中，绑定的标签列表中最多支持10个标签。

 [{“tagKey”:”Key1″,”tagValue”:”Value1″}]
PayType string 否

传统型负载均衡实例付费模式。取值：

  • PayOnDemand：按量付费。
  • PrePay：包年包月。
 PayOnDemand
ResourceGroupId string 否

企业资源组ID。

 rg-acfmxazb4p****
PageNumber integer 否

分页查询时的页码。

 1
PageSize integer 否

分页查询时设置的每页行数。

取值范围：1~100。

说明
如果设置了PageSize，则需要同时设置PageNumber。

50
Tagobject []否

标签列表。
Key string 否

资源的标签键。N的取值范围：1~20。一旦输入该值，则不允许为空字符串。

最多支持64个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

 FinanceDept
Value string 否

资源的标签值。N的取值范围：1~20。一旦输入该值，可以为空字符串。
最多支持128个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

 FinanceJoshua

返回参数

名称 类型 描述 示例值
object
RequestId string

请求ID。

 8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E
PageNumber integer

实例列表页码。

 1
PageSize integer

当前分页的行数。

 50
TotalCount integer

根据过滤条件得到的实例总个数。

 1
LoadBalancers object []

数组格式，返回负载均衡实例列表。
VpcId string

私网负载均衡实例的专有网络ID。

 vpc-25dvzy9f8****
CreateTimeStamp long

实例创建时间戳。

 1504147745000
LoadBalancerId string

负载均衡实例ID。

 lb-bp1b6c719dfa****
CreateTime string

实例创建时间，格式为：YYYY-MM-DDThh:mm:ssZ。

 2021-12-02T02:49:05Z
PayType string

负载均衡实例付费模式，取值：

  • PayOnDemand：按量付费。
  • PrePay：包年包月。
 PayOnDemand
AddressType string

实例的网络类型。取值：

  • internet：创建公网负载均衡实例后，系统会分配一个公网IP地址，可以转发公网请求。

  • intranet：创建内网负载均衡实例后，系统会分配一个内网IP地址，仅可转发内网请求。

 intranet
NetworkType string

私网负载均衡实例的网络类型，取值：

  • vpc：专有网络实例。

  • classic：经典网络实例。

 vpc
AddressIPVersion string

IP版本，可以设置为ipv4或者ipv6。

 ipv4
LoadBalancerName string

负载均衡实例的名称。

 lb-bp1o94dp5i6ea****
Bandwidth integer

监听的带宽峰值，单位：Mbps。取值：

  • -1：对于按流量计费的公网负载均衡实例，可以将带宽峰值设置为-1，即不限制带宽峰值。

  • 1~5120：对于按带宽计费的公网负载均衡实例，可以设置每个监听的带宽峰值，但所有监听的带宽峰值之和不能超过实例的带宽峰值。

 -1
Address string

负载均衡实例服务地址。

 100.XX.XX.28
SlaveZoneId string

实例的备可用区ID。

 cn-hangzhou-d
MasterZoneId string

实例的主可用区ID。

 cn-hangzhou-b
InternetChargeTypeAlias string

公网计费方式。取值：

  • paybybandwidth：按带宽计费。

  • paybytraffic：按流量计费

当PayType参数的值为PrePay时，只支持按带宽计费。当InstanceChargeType参数的值为PayByCLCU时，只支持按流量计费。

 paybybandwidth
LoadBalancerSpec string

负载均衡实例的性能规格。

 slb.s1.small
RegionId string

负载均衡实例的地域ID。

 cn-hangzhou
ModificationProtectionReason string

设置修改保护状态的原因，长度为1~80个字符，必须以字母或中文开头，支持数字、半角句号（.）、下划线（_）和短划线（-）。

说明
仅在ModificationProtectionStatus为ConsoleProtection时有效。

托管实例
ModificationProtectionStatusstring

负载均衡修改保护状态：

  • NonProtection：不限制修改保护，设置后会清空之前设置的ModificationProtectionReason。

  • ConsoleProtection：实例控制台修改保护状态。

说明
当取值为ConsoleProtection，即开启修改保护后，用户不能通过负载均衡控制台修改实例配置，但可以通过调用API修改实例配置。

ConsoleProtection
VSwitchIdstring

私网负载均衡实例的交换机ID。

 vsw-255ecr****
LoadBalancerStatus string

负载均衡实例状态。取值：

  • inactive：实例已停止，此状态的实例监听不会再转发流量。

  • active：实例运行中，实例创建后，默认状态为active。

  • locked：实例已锁定，实例已经被锁定。

 active
ResourceGroupId string

企业资源组ID。

 rg-atstuj3r****
InternetChargeType string

公网类型实例付费方式。取值：

  • 3：按带宽计费（paybybandwidth）。

  • 4：按流量计费（paybytraffic）。

当PayType参数的值为PrePay时，只支持按带宽计费。当InstanceChargeType参数的值为PayByCLCU时，只支持按流量计费。

 3
DeleteProtection string

负载均衡删除保护状态。取值：

  • on：开启。
  • off：关闭。
 off
RegionIdAlias string

传统型负载均衡实例的地域名称。

 hangzhou
Tags object []

标签列表
TagValue string

标签值。

 FinanceJoshua
TagKey string

标签键。

 FinanceDept
InstanceChargeType string

实例计费方式，取值：

  • PayBySpec：按规格计费。
  • PayByCLCU：按使用量计费。

说明
该参数仅适用于中国站且当PayType（实例付费模式）取值为PayOnDemand（按量付费）时，该参数生效。

PayBySpec

示例

正常返回示例

JSON格式

{
  "RequestId": "8B9DB03B-ED39-5DB8-9C9F-1ED5F548D61E",
  "PageNumber": 1,
  "PageSize": 50,
  "TotalCount": 1,
  "LoadBalancers": {
    "LoadBalancer": [
      {
        "VpcId": "vpc-25dvzy9f8****",
        "CreateTimeStamp": 1504147745000,
        "LoadBalancerId": "lb-bp1b6c719dfa****",
        "CreateTime": "2021-12-02T02:49:05Z",
        "PayType": "PayOnDemand",
        "AddressType": "intranet",
        "NetworkType": "vpc",
        "AddressIPVersion": "ipv4",
        "LoadBalancerName": "lb-bp1o94dp5i6ea****",
        "Bandwidth": -1,
        "Address": "100.XX.XX.28",
        "SlaveZoneId": "cn-hangzhou-d",
        "MasterZoneId": "cn-hangzhou-b",
        "InternetChargeTypeAlias": "paybybandwidth",
        "LoadBalancerSpec": "slb.s1.small",
        "RegionId": "cn-hangzhou",
        "ModificationProtectionReason": "托管实例",
        "ModificationProtectionStatus": "ConsoleProtection",
        "VSwitchId": "vsw-255ecr****",
        "LoadBalancerStatus": "active",
        "ResourceGroupId": "rg-atstuj3r****",
        "InternetChargeType": "3",
        "DeleteProtection": "off",
        "RegionIdAlias": "hangzhou",
        "Tags": {
          "Tag": [
            {
              "TagValue": "FinanceJoshua",
              "TagKey": "FinanceDept"
            }
          ]
        },
        "InstanceChargeType": "PayBySpec"
      }
    ]
  }
}

错误码

HTTP status code 错误码 错误信息 描述
400 InvalidTag The specified tags is invalid. 指定的TagKey无效。请检查参数约束，并在修改后重试。
400 TooManyResult fuzzy query retrieve too many instances. 检索到的实例数量过多，请提供更具体的查询条件。
400 LocationServiceTimeout Location service connection timeout. Please try again later. Location服务连接超时，请稍后重试。

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

变更历史

变更时间 变更内容概要 操作
2023-09-08 OpenAPI 错误码发生变更 看变更集
变更项 变更内容
错误码 OpenAPI 错误码发生变更
    错误码 400 变更
2023-07-04 OpenAPI 错误码发生变更，OpenAPI 入参发生变更 看变更集
变更项 变更内容
错误码 OpenAPI 错误码发生变更
    删除错误码：400
入参 OpenAPI 入参发生变更
    新增入参：Tag

内容没看懂？ 不太想学习？想快速解决？ 有偿解决： 联系专家

阿里云企业补贴进行中： 马上申请

腾讯云限时活动1折起，即将结束： 马上收藏

同尘科技为腾讯云授权服务中心。

购买腾讯云产品享受折上折，更有现金返利:同意关联，立享优惠

转转请注明出处：https://www.yunxiaoer.com/170302.html

赞 (0)
0
上一篇 2023年12月10日
下一篇 2023年12月10日
详情页2

相关推荐

  • 阿里云日志服务SLS使用前须知-云淘科技 阿里云日志服务SLS

    阿里云日志服务SLS使用前须知-云淘科技

    日志服务提供基于原生OpenTelemetry协议的分布式链路追踪功能，支持各类Trace数据的接入、存储、分析、可视化、告警、人工智能运维等。本文介绍日志服务分布式链路追踪功能（Trace服务）相关的背景信息、方案介绍、资产说明、费用等。 重要 日志服务推出全栈可观测应用，提供一站式IT系统可观测方案，包含全栈监控、全链路Trace、移动运维监控、性能监控…

    2023年12月10日

  • 阿里云ECS云服务器查询可用的变配资源-云淘科技

    本文通过阿里云ECS Python SDK调用DescribeResourcesModification查询变更ECS实例配置时的可用规格资源列表，使用的Python语言为2.7版本。适用于作为升降配ECS实例规格操作的准备工作。 前提条件 请确保您已获取了AccessKey和资源所属的地域ID。更多详情，请参见地域和可用区和创建AccessKey。 背景信…

    阿里云服务器 2023年12月9日

  • 阿里云RDS数据库CheckInstanceExist – 查询实例是否存在-云淘科技

    该接口用于查询目标RDS实例是否存在。 接口说明 适用引擎 RDS MySQL RDS PostgreSQL RDS SQL Server RDS MariaDB 调试 您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。 调试调试授权信息下表是API对应的授…

    阿里云数据库 2023年12月9日

  • 阿里云RDS数据库ModifyParameterGroup – 修改参数模板-云淘科技

    该接口用于修改RDS参数模板。 接口说明 适用引擎 RDS MySQL RDS PostgreSQL 相关功能文档 注意 使用该接口前，请仔细阅读功能文档，确保完全了解使用接口的前提条件及使用后造成的影响后，再进行操作。 MySQL使用参数模板 PostgreSQL使用参数模板 调试 您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的…

    阿里云数据库 2023年12月9日
  • 信息流广告，信息流部分建议宽度830px，只针对默认列表样式，顺序随机

  • 阿里云ECS云服务器立即生效容量预定概述-云淘科技

    立即生效容量预定为按量付费实例保障资源供应确定性，预定成功后对应的容量立即被锁定，适用于资源使用量较高的弹性需求。 简介 您可以随时购买立即生效容量预定，预订成功后立即生效，即容量被锁定。无论是否使用预定容量创建了实例，生效后即开始按照按量实例费率收费，直至立即生效容量预定被释放。 购买立即生效容量预定时设置可用区、实例规格、操作系统类型等属性，系统会以私有…

    阿里云服务器 2023年12月9日

联系我们

400-800-8888

在线咨询： QQ交谈

邮件：admin@example.com

工作时间：周一至周五，9:30-18:30，节假日休息

关注微信
本站为广大会员提供阿里云、腾讯云、华为云、百度云等一线大厂的购买，续费优惠，保证底价，买贵退差。