1. Packages
  2. Volcengine
  3. API Docs
  4. alb
  5. getListenerHealths
Volcengine v0.0.43 published on Friday, Jan 16, 2026 by Volcengine
Schema (JSON)
volcengine/pulumi-volcengine

volcengine.alb.getListenerHealths

volcengine logo
Volcengine v0.0.43 published on Friday, Jan 16, 2026 by Volcengine
Schema (JSON)
volcengine/pulumi-volcengine

    Using getListenerHealths

    Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

    function getListenerHealths(args: GetListenerHealthsArgs, opts?: InvokeOptions): Promise<GetListenerHealthsResult>
function getListenerHealthsOutput(args: GetListenerHealthsOutputArgs, opts?: InvokeOptions): Output<GetListenerHealthsResult>
    def get_listener_healths(listener_ids: Optional[Sequence[str]] = None,
                         only_un_healthy: Optional[bool] = None,
                         output_file: Optional[str] = None,
                         project_name: Optional[str] = None,
                         opts: Optional[InvokeOptions] = None) -> GetListenerHealthsResult
def get_listener_healths_output(listener_ids: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                         only_un_healthy: Optional[pulumi.Input[bool]] = None,
                         output_file: Optional[pulumi.Input[str]] = None,
                         project_name: Optional[pulumi.Input[str]] = None,
                         opts: Optional[InvokeOptions] = None) -> Output[GetListenerHealthsResult]
    func GetListenerHealths(ctx *Context, args *GetListenerHealthsArgs, opts ...InvokeOption) (*GetListenerHealthsResult, error)
func GetListenerHealthsOutput(ctx *Context, args *GetListenerHealthsOutputArgs, opts ...InvokeOption) GetListenerHealthsResultOutput

    > Note: This function is named GetListenerHealths in the Go SDK.

    public static class GetListenerHealths 
{
    public static Task<GetListenerHealthsResult> InvokeAsync(GetListenerHealthsArgs args, InvokeOptions? opts = null)
    public static Output<GetListenerHealthsResult> Invoke(GetListenerHealthsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetListenerHealthsResult> getListenerHealths(GetListenerHealthsArgs args, InvokeOptions options)
public static Output<GetListenerHealthsResult> getListenerHealths(GetListenerHealthsArgs args, InvokeOptions options)

    fn::invoke:
  function: volcengine:alb/getListenerHealths:getListenerHealths
  arguments:
    # arguments dictionary

    The following arguments are supported:

    ListenerIds List<string>
    OnlyUnHealthy bool
    OutputFile string
    ProjectName string
    listenerIds List<String>
    onlyUnHealthy Boolean
    outputFile String
    projectName String
    listenerIds string[]
    onlyUnHealthy boolean
    outputFile string
    projectName string
    listenerIds List<String>
    onlyUnHealthy Boolean
    outputFile String
    projectName String

    getListenerHealths Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerIds List<string>
    Listeners List<GetListenerHealthsListener>
    TotalCount int
    OnlyUnHealthy bool
    OutputFile string
    ProjectName string
    Id string
    The provider-assigned unique ID for this managed resource.
    ListenerIds []string
    Listeners []GetListenerHealthsListener
    TotalCount int
    OnlyUnHealthy bool
    OutputFile string
    ProjectName string
    id String
    The provider-assigned unique ID for this managed resource.
    listenerIds List<String>
    listeners List<GetListenerHealthsListener>
    totalCount Integer
    onlyUnHealthy Boolean
    outputFile String
    projectName String
    id string
    The provider-assigned unique ID for this managed resource.
    listenerIds string[]
    listeners GetListenerHealthsListener[]
    totalCount number
    onlyUnHealthy boolean
    outputFile string
    projectName string
    id str
    The provider-assigned unique ID for this managed resource.
    listener_ids Sequence[str]
    listeners Sequence[GetListenerHealthsListener]
    total_count int
    only_un_healthy bool
    output_file str
    project_name str
    id String
    The provider-assigned unique ID for this managed resource.
    listenerIds List<String>
    listeners List<Property Map>
    totalCount Number
    onlyUnHealthy Boolean
    outputFile String
    projectName String

    Supporting Types

    GetListenerHealthsListener

    BackendServers List<GetListenerHealthsListenerBackendServer>
    The list of backend server health details.
    ListenerId string
    The ID of the listener.
    Status string
    The status of the listener. Value: Active, Error, NoTarget, Disabled.
    TotalBackendServerCount int
    The total count of backend servers under the listener.
    UnHealthyCount int
    The count of backend servers with abnormal health check status.
    BackendServers []GetListenerHealthsListenerBackendServer
    The list of backend server health details.
    ListenerId string
    The ID of the listener.
    Status string
    The status of the listener. Value: Active, Error, NoTarget, Disabled.
    TotalBackendServerCount int
    The total count of backend servers under the listener.
    UnHealthyCount int
    The count of backend servers with abnormal health check status.
    backendServers List<GetListenerHealthsListenerBackendServer>
    The list of backend server health details.
    listenerId String
    The ID of the listener.
    status String
    The status of the listener. Value: Active, Error, NoTarget, Disabled.
    totalBackendServerCount Integer
    The total count of backend servers under the listener.
    unHealthyCount Integer
    The count of backend servers with abnormal health check status.
    backendServers GetListenerHealthsListenerBackendServer[]
    The list of backend server health details.
    listenerId string
    The ID of the listener.
    status string
    The status of the listener. Value: Active, Error, NoTarget, Disabled.
    totalBackendServerCount number
    The total count of backend servers under the listener.
    unHealthyCount number
    The count of backend servers with abnormal health check status.
    backend_servers Sequence[GetListenerHealthsListenerBackendServer]
    The list of backend server health details.
    listener_id str
    The ID of the listener.
    status str
    The status of the listener. Value: Active, Error, NoTarget, Disabled.
    total_backend_server_count int
    The total count of backend servers under the listener.
    un_healthy_count int
    The count of backend servers with abnormal health check status.
    backendServers List<Property Map>
    The list of backend server health details.
    listenerId String
    The ID of the listener.
    status String
    The status of the listener. Value: Active, Error, NoTarget, Disabled.
    totalBackendServerCount Number
    The total count of backend servers under the listener.
    unHealthyCount Number
    The count of backend servers with abnormal health check status.

    GetListenerHealthsListenerBackendServer

    InstanceId string
    The ID of the ECS instance or ENI.
    Ip string
    The IP address of the backend server.
    Port int
    The port of the backend server.
    RuleNumber int
    The number of forwarding rules associated with the backend server.
    ServerGroupId string
    The ID of the backend server group.
    ServerGroupName string
    The name of the backend server group.
    ServerId string
    The ID of the backend server.
    Status string
    The health status of the backend server. Value: Up, Down.
    Type string
    The type of backend server. Value: ecs, eni.
    InstanceId string
    The ID of the ECS instance or ENI.
    Ip string
    The IP address of the backend server.
    Port int
    The port of the backend server.
    RuleNumber int
    The number of forwarding rules associated with the backend server.
    ServerGroupId string
    The ID of the backend server group.
    ServerGroupName string
    The name of the backend server group.
    ServerId string
    The ID of the backend server.
    Status string
    The health status of the backend server. Value: Up, Down.
    Type string
    The type of backend server. Value: ecs, eni.
    instanceId String
    The ID of the ECS instance or ENI.
    ip String
    The IP address of the backend server.
    port Integer
    The port of the backend server.
    ruleNumber Integer
    The number of forwarding rules associated with the backend server.
    serverGroupId String
    The ID of the backend server group.
    serverGroupName String
    The name of the backend server group.
    serverId String
    The ID of the backend server.
    status String
    The health status of the backend server. Value: Up, Down.
    type String
    The type of backend server. Value: ecs, eni.
    instanceId string
    The ID of the ECS instance or ENI.
    ip string
    The IP address of the backend server.
    port number
    The port of the backend server.
    ruleNumber number
    The number of forwarding rules associated with the backend server.
    serverGroupId string
    The ID of the backend server group.
    serverGroupName string
    The name of the backend server group.
    serverId string
    The ID of the backend server.
    status string
    The health status of the backend server. Value: Up, Down.
    type string
    The type of backend server. Value: ecs, eni.
    instance_id str
    The ID of the ECS instance or ENI.
    ip str
    The IP address of the backend server.
    port int
    The port of the backend server.
    rule_number int
    The number of forwarding rules associated with the backend server.
    server_group_id str
    The ID of the backend server group.
    server_group_name str
    The name of the backend server group.
    server_id str
    The ID of the backend server.
    status str
    The health status of the backend server. Value: Up, Down.
    type str
    The type of backend server. Value: ecs, eni.
    instanceId String
    The ID of the ECS instance or ENI.
    ip String
    The IP address of the backend server.
    port Number
    The port of the backend server.
    ruleNumber Number
    The number of forwarding rules associated with the backend server.
    serverGroupId String
    The ID of the backend server group.
    serverGroupName String
    The name of the backend server group.
    serverId String
    The ID of the backend server.
    status String
    The health status of the backend server. Value: Up, Down.
    type String
    The type of backend server. Value: ecs, eni.

    Package Details

    Repository
    volcengine volcengine/pulumi-volcengine
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the volcengine Terraform Provider.
    volcengine logo
    Volcengine v0.0.43 published on Friday, Jan 16, 2026 by Volcengine
    Schema (JSON)
    volcengine/pulumi-volcengine
      Meet Neo: Your AI Platform Teammate