すべてのプロダクト
Search

このプロダクト

    ENS:DescribeLoadBalancerAttribute

    ドキュメントセンター

    ENS:DescribeLoadBalancerAttribute

    最終更新日:Mar 20, 2026

    指定されたロードバランサーインスタンスの詳細情報を取得します。

    操作説明

    • API 呼び出しレート：100 リクエスト/秒。

    • ユーザーごとの呼び出しレート：10 リクエスト/秒。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ens:DescribeLoadBalancerAttribute

    get

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    LoadBalancerId

    string

    必須

    ロードバランサーインスタンスの ID です。

    lb-5rcvo1n1t3hykfhhjwjgq****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンスオブジェクトです。

    RequestId

    string

    リクエスト ID です。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    LoadBalancerId

    string

    ロードバランサーインスタンスの ID です。

    lb-5rcvo1n1t3hykfhhjwjgqp****
    LoadBalancerName

    string

    ロードバランサーインスタンスの名前です。

    example
    LoadBalancerStatus

    string

    ロードバランサーインスタンスのステータスです。有効な値は次のとおりです。

    • Active：インスタンスのリスナーは、設定されたルールに基づいてトラフィックを転送できます。

    • Inactive：インスタンスのリスナーはトラフィックを転送しません。

    Active
    EnsRegionId

    string

    ENS リージョンの ID です。

    cn-chengdu-telecom
    Address

    string

    ロードバランサーインスタンスのサービスアドレスです。

    192.168.XX.XX
    NetworkId

    string

    ネットワークの ID です。

    n-5rwbi3g9zvgxcsiufwhw8****
    VSwitchId

    string

    vSwitch の ID です。

    vsw-5s78m2pdr9osa0j64bn78****
    Bandwidth

    integer

    ロードバランサーインスタンスのピーク帯域幅です。-1 の場合は、帯域幅が無制限であることを示します。

    -1

    LoadBalancerSpec

    string

    ロードバランサーインスタンスの仕様です。

    elb.s2.medium
    CreateTime

    string

    ロードバランサーインスタンスの作成時刻 (UTC) です。

    2019-05-21T12:22:00Z
    EndTime

    string

    ロードバランサーインスタンスの有効期限です。

    2020-05-21T12:22:00Z
    ListenerPorts

    array

    ロードバランサーインスタンスで使用されるフロントエンドポートです。

    string

    ロードバランサーインスタンスで使用されるフロントエンドポートです。

    80
    BackendServers

    array<object>

    バックエンドサーバーのリストです。

    object

    バックエンドサーバーです。

    ServerId

    string

    バックエンドサーバーインスタンスの ID です。

    i-5vb5h5njxiuhn48a****
    Ip

    string

    バックエンドサーバーの IP アドレスです。

    192.168.XX.XX

    Port

    string

    バックエンドサーバーで使用されるポートです。

    0
    Type

    string

    バックエンドサーバーのタイプです。

    ens
    Weight

    integer

    バックエンドサーバーの重みです。

    100
    ListenerPortsAndProtocols

    array<object>

    ロードバランサーインスタンスで使用されるフロントエンドポートおよびプロトコルです。

    object

    フロントエンドポートおよびプロトコルの詳細です。

    ListenerPort

    integer

    リスナーポートです。

    8080
    ListenerProtocol

    string

    リスナープロトコルです。

    tcp
    Description

    string

    リスナーの説明です。

    test
    ListenerForward

    string

    リスナー転送が有効かどうかを示します。

    off
    ForwardPort

    integer

    トラフィックが転送される送信先リスナーポートです。

    0
    BackendServerPort

    integer

    バックエンドサーバーで使用されるポートです。値は 1 ～ 65535 の範囲内である必要があります。

    6000
    AddressIPVersion

    string

    ロードバランサーインスタンスの IP バージョンです。有効な値は ipv4 または ipv6 です。

    ipv4
    PayType

    string

    課金方法です。有効な値は次のとおりです。

    • Prepaid：サブスクリプションモデル。

    • PostPaid：従量課金モデル。

    PostPaid
    LoadBalancerType

    string

    AddressType

    string

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "LoadBalancerId": "lb-5rcvo1n1t3hykfhhjwjgqp****",
  "LoadBalancerName": "example",
  "LoadBalancerStatus": "Active",
  "EnsRegionId": "cn-chengdu-telecom",
  "Address": "192.168.XX.XX",
  "NetworkId": "n-5rwbi3g9zvgxcsiufwhw8****",
  "VSwitchId": "vsw-5s78m2pdr9osa0j64bn78****",
  "Bandwidth": -1,
  "LoadBalancerSpec": "elb.s2.medium",
  "CreateTime": "2019-05-21T12:22:00Z",
  "EndTime": "2020-05-21T12:22:00Z",
  "ListenerPorts": [
    "80"
  ],
  "BackendServers": [
    {
      "ServerId": "i-5vb5h5njxiuhn48a****",
      "Ip": "192.168.XX.XX\n",
      "Port": "0",
      "Type": "ens",
      "Weight": 100
    }
  ],
  "ListenerPortsAndProtocols": [
    {
      "ListenerPort": 8080,
      "ListenerProtocol": "tcp",
      "Description": "test",
      "ListenerForward": "off",
      "ForwardPort": 0,
      "BackendServerPort": 6000
    }
  ],
  "AddressIPVersion": "ipv4",
  "PayType": "PostPaid",
  "LoadBalancerType": "",
  "AddressType": ""
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 ens.interface.error Failed to call API.
    400 NoPermission Permission denied.
    400 Invalid%s The specified parameter %s is invalid.
    400 Missing%s You must specify the parameter %s.

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。