Viewing docs for gcore 2.0.0-alpha.15
published on Thursday, Aug 6, 2026 by g-core
published on Thursday, Aug 6, 2026 by g-core
Viewing docs for gcore 2.0.0-alpha.15
published on Thursday, Aug 6, 2026 by g-core
published on Thursday, Aug 6, 2026 by g-core
Load balancer listeners handle incoming traffic on specified protocols and ports, forwarding requests to backend pools.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as gcore from "@pulumi/gcore";
const exampleCloudLoadBalancerListeners = gcore.getCloudLoadBalancerListeners({
projectId: 1,
regionId: 1,
loadBalancerId: "00000000-0000-4000-8000-000000000000",
name: "listener-name",
});
import pulumi
import pulumi_gcore as gcore
example_cloud_load_balancer_listeners = gcore.get_cloud_load_balancer_listeners(project_id=1,
region_id=1,
load_balancer_id="00000000-0000-4000-8000-000000000000",
name="listener-name")
package main
import (
"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
_, err := gcore.GetCloudLoadBalancerListeners(ctx, &gcore.GetCloudLoadBalancerListenersArgs{
ProjectId: pulumi.Float64Ref(1),
RegionId: pulumi.Float64Ref(1),
LoadBalancerId: pulumi.StringRef("00000000-0000-4000-8000-000000000000"),
Name: pulumi.StringRef("listener-name"),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Gcore = Pulumi.Gcore;
return await Deployment.RunAsync(() =>
{
var exampleCloudLoadBalancerListeners = Gcore.GetCloudLoadBalancerListeners.Invoke(new()
{
ProjectId = 1,
RegionId = 1,
LoadBalancerId = "00000000-0000-4000-8000-000000000000",
Name = "listener-name",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.gcore.GcoreFunctions;
import com.pulumi.gcore.inputs.GetCloudLoadBalancerListenersArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
final var exampleCloudLoadBalancerListeners = GcoreFunctions.getCloudLoadBalancerListeners(GetCloudLoadBalancerListenersArgs.builder()
.projectId(1)
.regionId(1)
.loadBalancerId("00000000-0000-4000-8000-000000000000")
.name("listener-name")
.build());
}
}
variables:
exampleCloudLoadBalancerListeners:
fn::invoke:
function: gcore:getCloudLoadBalancerListeners
arguments:
projectId: 1
regionId: 1
loadBalancerId: 00000000-0000-4000-8000-000000000000
name: listener-name
Example coming soon!
Using getCloudLoadBalancerListeners
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 getCloudLoadBalancerListeners(args: GetCloudLoadBalancerListenersArgs, opts?: InvokeOptions): Promise<GetCloudLoadBalancerListenersResult>
function getCloudLoadBalancerListenersOutput(args: GetCloudLoadBalancerListenersOutputArgs, opts?: InvokeOptions): Output<GetCloudLoadBalancerListenersResult>def get_cloud_load_balancer_listeners(load_balancer_id: Optional[str] = None,
max_items: Optional[float] = None,
name: Optional[str] = None,
project_id: Optional[float] = None,
region_id: Optional[float] = None,
opts: Optional[InvokeOptions] = None) -> GetCloudLoadBalancerListenersResult
def get_cloud_load_balancer_listeners_output(load_balancer_id: pulumi.Input[Optional[str]] = None,
max_items: pulumi.Input[Optional[float]] = None,
name: pulumi.Input[Optional[str]] = None,
project_id: pulumi.Input[Optional[float]] = None,
region_id: pulumi.Input[Optional[float]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetCloudLoadBalancerListenersResult]func GetCloudLoadBalancerListeners(ctx *Context, args *GetCloudLoadBalancerListenersArgs, opts ...InvokeOption) (*GetCloudLoadBalancerListenersResult, error)
func GetCloudLoadBalancerListenersOutput(ctx *Context, args *GetCloudLoadBalancerListenersOutputArgs, opts ...InvokeOption) GetCloudLoadBalancerListenersResultOutput> Note: This function is named GetCloudLoadBalancerListeners in the Go SDK.
public static class GetCloudLoadBalancerListeners
{
public static Task<GetCloudLoadBalancerListenersResult> InvokeAsync(GetCloudLoadBalancerListenersArgs args, InvokeOptions? opts = null)
public static Output<GetCloudLoadBalancerListenersResult> Invoke(GetCloudLoadBalancerListenersInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetCloudLoadBalancerListenersResult> getCloudLoadBalancerListeners(GetCloudLoadBalancerListenersArgs args, InvokeOptions options)
public static Output<GetCloudLoadBalancerListenersResult> getCloudLoadBalancerListeners(GetCloudLoadBalancerListenersArgs args, InvokeOptions options)
fn::invoke:
function: gcore:index/getCloudLoadBalancerListeners:getCloudLoadBalancerListeners
arguments:
# arguments dictionarydata "gcore_get_cloud_load_balancer_listeners" "name" {
# arguments
}The following arguments are supported:
- Load
Balancer stringId - Load Balancer ID
- Max
Items double - Max items to fetch, default: 1000
- Name string
- Filter by name
- Project
Id double - Project ID
- Region
Id double - Region ID
- Load
Balancer stringId - Load Balancer ID
- Max
Items float64 - Max items to fetch, default: 1000
- Name string
- Filter by name
- Project
Id float64 - Project ID
- Region
Id float64 - Region ID
- load_
balancer_ stringid - Load Balancer ID
- max_
items number - Max items to fetch, default: 1000
- name string
- Filter by name
- project_
id number - Project ID
- region_
id number - Region ID
- load
Balancer StringId - Load Balancer ID
- max
Items Double - Max items to fetch, default: 1000
- name String
- Filter by name
- project
Id Double - Project ID
- region
Id Double - Region ID
- load
Balancer stringId - Load Balancer ID
- max
Items number - Max items to fetch, default: 1000
- name string
- Filter by name
- project
Id number - Project ID
- region
Id number - Region ID
- load_
balancer_ strid - Load Balancer ID
- max_
items float - Max items to fetch, default: 1000
- name str
- Filter by name
- project_
id float - Project ID
- region_
id float - Region ID
- load
Balancer StringId - Load Balancer ID
- max
Items Number - Max items to fetch, default: 1000
- name String
- Filter by name
- project
Id Number - Project ID
- region
Id Number - Region ID
getCloudLoadBalancerListeners Result
The following output properties are available:
- Id string
- The provider-assigned unique ID for this managed resource.
- Items
List<Get
Cloud Load Balancer Listeners Item> - The items returned by the data source
- Load
Balancer stringId - Load Balancer ID
- Max
Items double - Max items to fetch, default: 1000
- Name string
- Filter by name
- Project
Id double - Project ID
- Region
Id double - Region ID
- Id string
- The provider-assigned unique ID for this managed resource.
- Items
[]Get
Cloud Load Balancer Listeners Item - The items returned by the data source
- Load
Balancer stringId - Load Balancer ID
- Max
Items float64 - Max items to fetch, default: 1000
- Name string
- Filter by name
- Project
Id float64 - Project ID
- Region
Id float64 - Region ID
- id string
- The provider-assigned unique ID for this managed resource.
- items list(object)
- The items returned by the data source
- load_
balancer_ stringid - Load Balancer ID
- max_
items number - Max items to fetch, default: 1000
- name string
- Filter by name
- project_
id number - Project ID
- region_
id number - Region ID
- id String
- The provider-assigned unique ID for this managed resource.
- items
List<Get
Cloud Load Balancer Listeners Item> - The items returned by the data source
- load
Balancer StringId - Load Balancer ID
- max
Items Double - Max items to fetch, default: 1000
- name String
- Filter by name
- project
Id Double - Project ID
- region
Id Double - Region ID
- id string
- The provider-assigned unique ID for this managed resource.
- items
Get
Cloud Load Balancer Listeners Item[] - The items returned by the data source
- load
Balancer stringId - Load Balancer ID
- max
Items number - Max items to fetch, default: 1000
- name string
- Filter by name
- project
Id number - Project ID
- region
Id number - Region ID
- id str
- The provider-assigned unique ID for this managed resource.
- items
Sequence[Get
Cloud Load Balancer Listeners Item] - The items returned by the data source
- load_
balancer_ strid - Load Balancer ID
- max_
items float - Max items to fetch, default: 1000
- name str
- Filter by name
- project_
id float - Project ID
- region_
id float - Region ID
- id String
- The provider-assigned unique ID for this managed resource.
- items List<Property Map>
- The items returned by the data source
- load
Balancer StringId - Load Balancer ID
- max
Items Number - Max items to fetch, default: 1000
- name String
- Filter by name
- project
Id Number - Project ID
- region
Id Number - Region ID
Supporting Types
GetCloudLoadBalancerListenersItem
- Admin
State boolUp - Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
- Allowed
Cidrs List<string> - Network CIDRs from which service will be accessible
- Connection
Limit double - Limit of simultaneous connections
- Creator
Task stringId - Task that created this entity
- Id string
- Load balancer listener ID
- Insert
Headers Dictionary<string, string> - Dictionary of additional header insertion into HTTP headers. Only used with HTTP and
TERMINATED_HTTPSprotocols. - Load
Balancer stringId - Load balancer ID
- Name string
- Load balancer listener name
- Operating
Status string - Listener operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
- Pool
Count double - Number of pools (for UI)
- Protocol string
- Load balancer protocol Available values: "HTTP", "HTTPS", "PROMETHEUS", "TCP", "TERMINATED_HTTPS", "UDP".
- Protocol
Port double - Protocol port
- Provisioning
Status string - Listener lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
- Secret
Id string - ID of the secret where PKCS12 file is stored for
TERMINATED_HTTPSor PROMETHEUS load balancer - Sni
Secret List<string>Ids - List of secret's ID containing PKCS12 format certificate/key bundles for
TERMINATED_HTTPSor PROMETHEUS listeners - Task
Id string - The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If
null, the resource is not locked. - Timeout
Client doubleData - Frontend client inactivity timeout in milliseconds
- Timeout
Member doubleConnect - Backend member connection timeout in milliseconds
- Timeout
Member doubleData - Backend member inactivity timeout in milliseconds
- User
Lists List<GetCloud Load Balancer Listeners Item User List> - Load balancer listener users list
- Admin
State boolUp - Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
- Allowed
Cidrs []string - Network CIDRs from which service will be accessible
- Connection
Limit float64 - Limit of simultaneous connections
- Creator
Task stringId - Task that created this entity
- Id string
- Load balancer listener ID
- Insert
Headers map[string]string - Dictionary of additional header insertion into HTTP headers. Only used with HTTP and
TERMINATED_HTTPSprotocols. - Load
Balancer stringId - Load balancer ID
- Name string
- Load balancer listener name
- Operating
Status string - Listener operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
- Pool
Count float64 - Number of pools (for UI)
- Protocol string
- Load balancer protocol Available values: "HTTP", "HTTPS", "PROMETHEUS", "TCP", "TERMINATED_HTTPS", "UDP".
- Protocol
Port float64 - Protocol port
- Provisioning
Status string - Listener lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
- Secret
Id string - ID of the secret where PKCS12 file is stored for
TERMINATED_HTTPSor PROMETHEUS load balancer - Sni
Secret []stringIds - List of secret's ID containing PKCS12 format certificate/key bundles for
TERMINATED_HTTPSor PROMETHEUS listeners - Task
Id string - The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If
null, the resource is not locked. - Timeout
Client float64Data - Frontend client inactivity timeout in milliseconds
- Timeout
Member float64Connect - Backend member connection timeout in milliseconds
- Timeout
Member float64Data - Backend member inactivity timeout in milliseconds
- User
Lists []GetCloud Load Balancer Listeners Item User List - Load balancer listener users list
- admin_
state_ boolup - Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
- allowed_
cidrs list(string) - Network CIDRs from which service will be accessible
- connection_
limit number - Limit of simultaneous connections
- creator_
task_ stringid - Task that created this entity
- id string
- Load balancer listener ID
- insert_
headers map(string) - Dictionary of additional header insertion into HTTP headers. Only used with HTTP and
TERMINATED_HTTPSprotocols. - load_
balancer_ stringid - Load balancer ID
- name string
- Load balancer listener name
- operating_
status string - Listener operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
- pool_
count number - Number of pools (for UI)
- protocol string
- Load balancer protocol Available values: "HTTP", "HTTPS", "PROMETHEUS", "TCP", "TERMINATED_HTTPS", "UDP".
- protocol_
port number - Protocol port
- provisioning_
status string - Listener lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
- secret_
id string - ID of the secret where PKCS12 file is stored for
TERMINATED_HTTPSor PROMETHEUS load balancer - sni_
secret_ list(string)ids - List of secret's ID containing PKCS12 format certificate/key bundles for
TERMINATED_HTTPSor PROMETHEUS listeners - task_
id string - The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If
null, the resource is not locked. - timeout_
client_ numberdata - Frontend client inactivity timeout in milliseconds
- timeout_
member_ numberconnect - Backend member connection timeout in milliseconds
- timeout_
member_ numberdata - Backend member inactivity timeout in milliseconds
- user_
lists list(object) - Load balancer listener users list
- admin
State BooleanUp - Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
- allowed
Cidrs List<String> - Network CIDRs from which service will be accessible
- connection
Limit Double - Limit of simultaneous connections
- creator
Task StringId - Task that created this entity
- id String
- Load balancer listener ID
- insert
Headers Map<String,String> - Dictionary of additional header insertion into HTTP headers. Only used with HTTP and
TERMINATED_HTTPSprotocols. - load
Balancer StringId - Load balancer ID
- name String
- Load balancer listener name
- operating
Status String - Listener operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
- pool
Count Double - Number of pools (for UI)
- protocol String
- Load balancer protocol Available values: "HTTP", "HTTPS", "PROMETHEUS", "TCP", "TERMINATED_HTTPS", "UDP".
- protocol
Port Double - Protocol port
- provisioning
Status String - Listener lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
- secret
Id String - ID of the secret where PKCS12 file is stored for
TERMINATED_HTTPSor PROMETHEUS load balancer - sni
Secret List<String>Ids - List of secret's ID containing PKCS12 format certificate/key bundles for
TERMINATED_HTTPSor PROMETHEUS listeners - task
Id String - The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If
null, the resource is not locked. - timeout
Client DoubleData - Frontend client inactivity timeout in milliseconds
- timeout
Member DoubleConnect - Backend member connection timeout in milliseconds
- timeout
Member DoubleData - Backend member inactivity timeout in milliseconds
- user
Lists List<GetCloud Load Balancer Listeners Item User List> - Load balancer listener users list
- admin
State booleanUp - Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
- allowed
Cidrs string[] - Network CIDRs from which service will be accessible
- connection
Limit number - Limit of simultaneous connections
- creator
Task stringId - Task that created this entity
- id string
- Load balancer listener ID
- insert
Headers {[key: string]: string} - Dictionary of additional header insertion into HTTP headers. Only used with HTTP and
TERMINATED_HTTPSprotocols. - load
Balancer stringId - Load balancer ID
- name string
- Load balancer listener name
- operating
Status string - Listener operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
- pool
Count number - Number of pools (for UI)
- protocol string
- Load balancer protocol Available values: "HTTP", "HTTPS", "PROMETHEUS", "TCP", "TERMINATED_HTTPS", "UDP".
- protocol
Port number - Protocol port
- provisioning
Status string - Listener lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
- secret
Id string - ID of the secret where PKCS12 file is stored for
TERMINATED_HTTPSor PROMETHEUS load balancer - sni
Secret string[]Ids - List of secret's ID containing PKCS12 format certificate/key bundles for
TERMINATED_HTTPSor PROMETHEUS listeners - task
Id string - The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If
null, the resource is not locked. - timeout
Client numberData - Frontend client inactivity timeout in milliseconds
- timeout
Member numberConnect - Backend member connection timeout in milliseconds
- timeout
Member numberData - Backend member inactivity timeout in milliseconds
- user
Lists GetCloud Load Balancer Listeners Item User List[] - Load balancer listener users list
- admin_
state_ boolup - Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
- allowed_
cidrs Sequence[str] - Network CIDRs from which service will be accessible
- connection_
limit float - Limit of simultaneous connections
- creator_
task_ strid - Task that created this entity
- id str
- Load balancer listener ID
- insert_
headers Mapping[str, str] - Dictionary of additional header insertion into HTTP headers. Only used with HTTP and
TERMINATED_HTTPSprotocols. - load_
balancer_ strid - Load balancer ID
- name str
- Load balancer listener name
- operating_
status str - Listener operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
- pool_
count float - Number of pools (for UI)
- protocol str
- Load balancer protocol Available values: "HTTP", "HTTPS", "PROMETHEUS", "TCP", "TERMINATED_HTTPS", "UDP".
- protocol_
port float - Protocol port
- provisioning_
status str - Listener lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
- secret_
id str - ID of the secret where PKCS12 file is stored for
TERMINATED_HTTPSor PROMETHEUS load balancer - sni_
secret_ Sequence[str]ids - List of secret's ID containing PKCS12 format certificate/key bundles for
TERMINATED_HTTPSor PROMETHEUS listeners - task_
id str - The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If
null, the resource is not locked. - timeout_
client_ floatdata - Frontend client inactivity timeout in milliseconds
- timeout_
member_ floatconnect - Backend member connection timeout in milliseconds
- timeout_
member_ floatdata - Backend member inactivity timeout in milliseconds
- user_
lists Sequence[GetCloud Load Balancer Listeners Item User List] - Load balancer listener users list
- admin
State BooleanUp - Administrative state of the resource. When set to true, the resource is enabled and operational. When set to false, the resource is disabled and will not process traffic. Defaults to true.
- allowed
Cidrs List<String> - Network CIDRs from which service will be accessible
- connection
Limit Number - Limit of simultaneous connections
- creator
Task StringId - Task that created this entity
- id String
- Load balancer listener ID
- insert
Headers Map<String> - Dictionary of additional header insertion into HTTP headers. Only used with HTTP and
TERMINATED_HTTPSprotocols. - load
Balancer StringId - Load balancer ID
- name String
- Load balancer listener name
- operating
Status String - Listener operating status Available values: "DEGRADED", "DRAINING", "ERROR", "NO_MONITOR", "OFFLINE", "ONLINE".
- pool
Count Number - Number of pools (for UI)
- protocol String
- Load balancer protocol Available values: "HTTP", "HTTPS", "PROMETHEUS", "TCP", "TERMINATED_HTTPS", "UDP".
- protocol
Port Number - Protocol port
- provisioning
Status String - Listener lifecycle status Available values: "ACTIVE", "DELETED", "ERROR", "PENDINGCREATE", "PENDINGDELETE", "PENDING_UPDATE".
- secret
Id String - ID of the secret where PKCS12 file is stored for
TERMINATED_HTTPSor PROMETHEUS load balancer - sni
Secret List<String>Ids - List of secret's ID containing PKCS12 format certificate/key bundles for
TERMINATED_HTTPSor PROMETHEUS listeners - task
Id String - The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If
null, the resource is not locked. - timeout
Client NumberData - Frontend client inactivity timeout in milliseconds
- timeout
Member NumberConnect - Backend member connection timeout in milliseconds
- timeout
Member NumberData - Backend member inactivity timeout in milliseconds
- user
Lists List<Property Map> - Load balancer listener users list
GetCloudLoadBalancerListenersItemUserList
- Encrypted
Password string - Encrypted password to auth via Basic Authentication
- Username string
- Username to auth via Basic Authentication
- Encrypted
Password string - Encrypted password to auth via Basic Authentication
- Username string
- Username to auth via Basic Authentication
- encrypted_
password string - Encrypted password to auth via Basic Authentication
- username string
- Username to auth via Basic Authentication
- encrypted
Password String - Encrypted password to auth via Basic Authentication
- username String
- Username to auth via Basic Authentication
- encrypted
Password string - Encrypted password to auth via Basic Authentication
- username string
- Username to auth via Basic Authentication
- encrypted_
password str - Encrypted password to auth via Basic Authentication
- username str
- Username to auth via Basic Authentication
- encrypted
Password String - Encrypted password to auth via Basic Authentication
- username String
- Username to auth via Basic Authentication
Package Details
- Repository
- gcore g-core/terraform-provider-gcore
- License
- Notes
- This Pulumi package is based on the
gcoreTerraform Provider.
Viewing docs for gcore 2.0.0-alpha.15
published on Thursday, Aug 6, 2026 by g-core
published on Thursday, Aug 6, 2026 by g-core