すべてのプロダクト
Search

このプロダクト

    :GetLoadBalancerAttribute

    ドキュメントセンター

    :GetLoadBalancerAttribute

    最終更新日:Dec 19, 2025

    Application Load Balancer (ALB) インスタンスの詳細を照会します。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    alb:GetLoadBalancerAttribute

    get

    *LoadBalancer

    acs:alb:{#regionId}:{#accountId}:loadbalancer/{#loadbalancerId}

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    LoadBalancerId

    string

    必須

    ALB インスタンスの ID。

    alb-o9ulmq5hgn68jk****

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    ALB インスタンスの構成の詳細。

    AccessLogConfig

    object

    アクセスログ機能の構成。

    LogProject

    string

    Log Service プロジェクト。

    sls-setter
    LogStore

    string

    Logstore。

    test
    AddressAllocatedMode

    string

    IP アドレスの割り当てモード。有効な値：

    • Fixed：ALB インスタンスに静的 IP アドレスを割り当てます。

    • Dynamic：ALB インスタンスの各ゾーンに IP アドレスを動的に割り当てます。

    Dynamic
    AddressType

    string

    ALB インスタンスのネットワークタイプ。有効な値：

    • Internet：ALB インスタンスはパブリック IP アドレスを使用します。ALB インスタンスのドメイン名はパブリック IP アドレスに解決されるため、ALB インスタンスはインターネット経由でアクセスできます。

    • Intranet：ALB インスタンスはプライベート IP アドレスを使用します。ALB インスタンスのドメイン名はプライベート IP アドレスに解決されます。この場合、ALB インスタンスは、インスタンスがデプロイされている VPC 経由でアクセスできます。

    Intranet
    BandwidthPackageId

    string

    インターネット向けの ALB インスタンスに関連付けられている Elastic IP (EIP) 帯域幅プランの ID。

    cbwp-bp1vevu8h3ieh****
    CreateTime

    string

    リソースが作成された時刻。時刻は、yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準に準拠しています。時刻は UTC で表示されます。

    2022-07-02T02:49:05Z
    DNSName

    string

    ALB インスタンスのドメイン名。

    alb-95qnr2itwu9orb****.cn-hangzhou.alb.aliyuncs.com
    DeletionProtectionConfig

    object

    削除保護の構成。

    Enabled

    boolean

    削除保護機能が有効になっているかどうかを示します。有効な値：

    • true

    • false

    true
    EnabledTime

    string

    削除保護機能が有効になった時刻。時刻は、yyyy-MM-ddTHH:mm:ssZ 形式の ISO 8601 標準に準拠しています。時刻は UTC で表示されます。

    2022-08-02T02:49:05Z
    LoadBalancerBillingConfig

    object

    ALB インスタンスの課金方法。

    PayType

    string

    課金方法。

    従量課金を示す PostPay のみが返されます。

    PostPay
    LoadBalancerBussinessStatus

    string

    ALB インスタンスのサービスステータス。有効な値：

    • Abnormal

    • Normal

    Normal
    LoadBalancerEdition

    string

    ALB インスタンスのエディション。ALB インスタンスのエディションによって、機能と課金ルールが異なります。有効な値：

    • Basic

    • Standard

    • StandardWithWaf

    Standard
    LoadBalancerId

    string

    ALB インスタンスの ID。

    alb-o9ulmq5hgn68jk****
    LoadBalancerName

    string

    ALB インスタンスの名前。

    名前は 2～128 文字で、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。名前は文字で始まる必要があります。

    alb1
    LoadBalancerOperationLocks

    array<object>

    ロックのタイプ。有効な値：

    • SecurityLocked：ALB インスタンスはセキュリティ上の理由でロックされています。

    • RelatedResourceLocked：ALB インスタンスは関連付けの問題によりロックされています。

    • FinancialLocked：ALB インスタンスは支払い遅延によりロックされています。

    • ResidualLocked：関連リソースに支払い遅延があり、リソースがリリースされたため、ALB インスタンスはロックされています。

    object

    LockReason

    string

    ALB インスタンスがロックされている理由。このパラメーターは、LoadBalancerBussinessStatus が Abnormal に設定されている場合にのみ有効です。

    nolock
    LockType

    string

    ロックタイプ。有効な値：

    • SecurityLocked：ALB インスタンスはセキュリティ上の理由でロックされています。

    • RelatedResourceLocked：ALB インスタンスは、ALB インスタンスに関連付けられている他のリソースが原因でロックされています。

    • FinancialLocked：ALB インスタンスは支払い遅延によりロックされています。

    • ResidualLocked：関連リソースに支払い遅延があり、リソースがリリースされたため、ALB インスタンスはロックされています。

    FinancialLocked
    LoadBalancerStatus

    string

    ALB インスタンスのステータス。有効な値：

    • Inactive：ALB インスタンスは無効になっています。Inactive 状態の ALB インスタンスはトラフィックを転送しません。

    • Active：ALB インスタンスは実行中です。

    • Provisioning：ALB インスタンスは作成中です。

    • Configuring：ALB インスタンスは変更中です。

    • CreateFailed：システムの ALB インスタンスの作成に失敗しました。この場合、ALB インスタンスは課金されません。ALB インスタンスは削除のみ可能です。

    Active
    ModificationProtectionConfig

    object

    設定変更保護の設定。

    Reason

    string

    設定変更保護が有効になっている理由。

    名前は 2～128 文字で、文字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-) を使用できます。文字で始まる必要があります。

    このパラメーターは、Status が ConsoleProtection に設定されている場合にのみ有効です。

    test
    Status

    string

    設定変更保護が有効になっているかどうかを指定します。有効な値：

    • NonProtection：設定変更保護は無効になっています。この場合、指定した Reason パラメーターの値は有効になりません。Reason を設定すると、値はクリアされます。

    • ConsoleProtection：設定変更保護が有効になっています。この場合、Reason パラメーターの値が有効になります。****

    説明

    パラメーターが ConsoleProtection に設定されている場合、設定変更保護が有効になります。ALB コンソールで ALB インスタンスの構成を変更することはできません。ただし、API 操作を呼び出して ALB インスタンスの構成を変更することはできます。

    ConsoleProtection
    RegionId

    string

    ALB インスタンスのリージョン ID。

    cn-hangzhou
    RequestId

    string

    リクエスト ID。

    365F4154-92F6-4AE4-92F8-7FF34B540710
    ResourceGroupId

    string

    リソースグループ ID。

    rg-atstuj3rtop****
    Tags

    array<object>

    タグ値。

    タグ値は最大 128 文字で、acs: または aliyun で始めることはできません。タグ値に http:// または https:// を含めることはできません。

    object

    Key

    string

    タグキー。

    タグキーは最大 128 文字で、http:// または https:// を含めることはできません。`acs:` または `aliyun` で始めることはできません。

    FinanceDept
    Value

    string

    タグ値。

    タグ値は最大 128 文字で、http:// または https:// を含めることはできません。`aliyun` または `acs:` で始めることはできません。

    FinanceJoshua
    VpcId

    string

    ALB インスタンスがデプロイされている VPC の ID。

    vpc-bp1b49rqrybk45nio****
    ZoneMappings

    array<object>

    ゾーンと vSwitch 間のマッピング。最大 10 個のゾーンが返されます。現在のリージョンが 2 つ以上のゾーンをサポートしている場合、少なくとも 2 つのゾーンが返されます。

    array<object>

    ゾーンと vSwitch 間のマッピング。最大 10 個のゾーンが返されます。現在のリージョンが 2 つ以上のゾーンをサポートしている場合、少なくとも 2 つのゾーンが返されます。

    LoadBalancerAddresses

    array<object>

    ALB インスタンスのアドレス。

    object

    ALB インスタンスのアドレス。

    Address

    string

    IPv4 アドレス。

    このパラメーターは、AddressIPVersion が IPv4 または DualStack に設定されている場合に有効です。ネットワークタイプは AddressType の値によって決まります。

    192.168.10.1
    Ipv6Address

    string

    IPv6 アドレス。

    このパラメーターは、AddressIPVersion が DualStack に設定されている場合にのみ有効です。ネットワークタイプは Ipv6AddressType の値によって決まります。

    2408:XXXX:39d:eb00::/56
    IntranetAddress

    string

    プライベート IPv4 アドレス。

    10.0.1.181
    AllocationId

    string

    Elastic IP (EIP)。

    eip-uf6wm****1zj9
    EipType

    string

    EIP のタイプ。有効な値：

    • Common：EIP。

    • Anycast：Anycast EIP。

    説明

    ALB が Anycast EIP をサポートするリージョンの詳細については、「制限事項」をご参照ください。

    Common
    IntranetAddressHcStatus

    string

    ALB インスタンスのプライベート IPv4 アドレスのヘルスステータス。 このパラメーターは、ゾーンの Status が Active の場合にのみ返されます。有効な値：

    • Healthy

    • Unhealthy

    Healthy
    Ipv6AddressHcStatus

    string

    ALB インスタンスのプライベート IPv6 アドレスのヘルスステータス。 このパラメーターは、ゾーンの Status が Active の場合にのみ返されます。有効な値：

    • Healthy

    • Unhealthy

    Healthy
    Ipv4LocalAddresses

    array

    IPv4 リンクローカルアドレス。ALB インスタンスがバックエンドサーバーとの通信に使用する IP アドレス。

    string

    IPv4 リンクローカルアドレス。

    10.1.0.62
    Ipv6LocalAddresses

    array

    IPv6 リンクローカルアドレス。ALB インスタンスがバックエンドサーバーとの通信に使用する IP アドレス。

    string

    IPv6 リンクローカルアドレス。

    2408:xxxx:249:dd01:6f4:750f:xxxx:bcda
    VSwitchId

    string

    ゾーン内の vSwitch。ALB インスタンスの各ゾーンで指定できる vSwitch (サブネット) は 1 つだけです。

    vsw-bp12mw1f8k3jgy****
    ZoneId

    string

    ALB インスタンスのゾーン ID。

    DescribeZones 操作を呼び出して、最新のゾーンリストを照会できます。

    cn-hangzhou-a
    Status

    string

    ゾーンのステータス。有効な値：

    • Active：ALB インスタンスは実行中です。

    • Stopped：ALB インスタンスは無効になっています。

    • Shifted：ALB インスタンスは削除されました。

    • Starting：ALB インスタンスは起動中です。

    • Stopping：ALB インスタンスは停止中です。

    Active
    AddressIpVersion

    string

    IP バージョン。有効な値：

    • IPv4

    • DualStack

    DualStack
    Ipv6AddressType

    string

    ALB インスタンスが使用する IPv6 アドレスのタイプ。有効な値：

    • Internet：ALB インスタンスはパブリック IP アドレスを使用します。ALB インスタンスのドメイン名はパブリック IP アドレスに解決されるため、ALB インスタンスはインターネット経由でアクセスできます。

    • Intranet：ALB インスタンスはプライベート IP アドレスを使用します。ALB インスタンスのドメイン名はプライベート IP アドレスに解決されるため、ALB インスタンスはデプロイされている VPC 経由でアクセスできます。

    Intranet
    SecurityGroupIds

    array

    ALB インスタンスが追加されるセキュリティグループの ID。

    string

    ALB インスタンスが追加されるセキュリティグループの ID。

    sg-uf63j385dzwlm6cy****

    例

    成功レスポンス

    JSONJSON

    {
  "AccessLogConfig": {
    "LogProject": "sls-setter",
    "LogStore": "test"
  },
  "AddressAllocatedMode": "Dynamic",
  "AddressType": "Intranet",
  "BandwidthPackageId": "cbwp-bp1vevu8h3ieh****",
  "CreateTime": "2022-07-02T02:49:05Z",
  "DNSName": "alb-95qnr2itwu9orb****.cn-hangzhou.alb.aliyuncs.com",
  "DeletionProtectionConfig": {
    "Enabled": true,
    "EnabledTime": "2022-08-02T02:49:05Z"
  },
  "LoadBalancerBillingConfig": {
    "PayType": "PostPay"
  },
  "LoadBalancerBussinessStatus": "Normal",
  "LoadBalancerEdition": "Standard",
  "LoadBalancerId": "alb-o9ulmq5hgn68jk****",
  "LoadBalancerName": "alb1",
  "LoadBalancerOperationLocks": [
    {
      "LockReason": "nolock",
      "LockType": "FinancialLocked"
    }
  ],
  "LoadBalancerStatus": "Active",
  "ModificationProtectionConfig": {
    "Reason": "test",
    "Status": "ConsoleProtection"
  },
  "RegionId": "cn-hangzhou",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "ResourceGroupId": "rg-atstuj3rtop****",
  "Tags": [
    {
      "Key": "FinanceDept",
      "Value": "FinanceJoshua"
    }
  ],
  "VpcId": "vpc-bp1b49rqrybk45nio****",
  "ZoneMappings": [
    {
      "LoadBalancerAddresses": [
        {
          "Address": "192.168.10.1",
          "Ipv6Address": "2408:XXXX:39d:eb00::/56",
          "IntranetAddress": "10.0.1.181",
          "AllocationId": "eip-uf6wm****1zj9",
          "EipType": "Common",
          "IntranetAddressHcStatus": "Healthy",
          "Ipv6AddressHcStatus": "Healthy",
          "Ipv4LocalAddresses": [
            "10.1.0.62"
          ],
          "Ipv6LocalAddresses": [
            "2408:xxxx:249:dd01:6f4:750f:xxxx:bcda"
          ]
        }
      ],
      "VSwitchId": "vsw-bp12mw1f8k3jgy****",
      "ZoneId": "cn-hangzhou-a",
      "Status": "Active"
    }
  ],
  "AddressIpVersion": "DualStack",
  "Ipv6AddressType": "Intranet",
  "SecurityGroupIds": [
    "sg-uf63j385dzwlm6cy****"
  ]
}

    エラーコード

    HTTP ステータスコード

    エラーコード

    エラーメッセージ

    説明
    400 Forbidden.LoadBalancer Authentication has failed for LoadBalancer.
    404 ResourceNotFound.LoadBalancer The specified resource %s is not found.

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

    変更履歴

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