1. Packages
  2. AWS
  3. API Docs
  4. redshiftserverless
  5. getWorkgroup
AWS v7.10.0 published on Friday, Oct 24, 2025 by Pulumi
pulumi/pulumi-aws

aws.redshiftserverless.getWorkgroup

Get Started
aws logo
AWS v7.10.0 published on Friday, Oct 24, 2025 by Pulumi
pulumi/pulumi-aws

    Data source for managing an AWS Redshift Serverless Workgroup.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = aws.redshiftserverless.getWorkgroup({
    workgroupName: exampleAwsRedshiftserverlessWorkgroup.workgroupName,
});

    import pulumi
import pulumi_aws as aws

example = aws.redshiftserverless.get_workgroup(workgroup_name=example_aws_redshiftserverless_workgroup["workgroupName"])

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/redshiftserverless"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := redshiftserverless.LookupWorkgroup(ctx, &redshiftserverless.LookupWorkgroupArgs{
			WorkgroupName: exampleAwsRedshiftserverlessWorkgroup.WorkgroupName,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var example = Aws.RedshiftServerless.GetWorkgroup.Invoke(new()
    {
        WorkgroupName = exampleAwsRedshiftserverlessWorkgroup.WorkgroupName,
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.redshiftserverless.RedshiftserverlessFunctions;
import com.pulumi.aws.redshiftserverless.inputs.GetWorkgroupArgs;
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 example = RedshiftserverlessFunctions.getWorkgroup(GetWorkgroupArgs.builder()
            .workgroupName(exampleAwsRedshiftserverlessWorkgroup.workgroupName())
            .build());

    }
}

    variables:
  example:
    fn::invoke:
      function: aws:redshiftserverless:getWorkgroup
      arguments:
        workgroupName: ${exampleAwsRedshiftserverlessWorkgroup.workgroupName}

    Using getWorkgroup

    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 getWorkgroup(args: GetWorkgroupArgs, opts?: InvokeOptions): Promise<GetWorkgroupResult>
function getWorkgroupOutput(args: GetWorkgroupOutputArgs, opts?: InvokeOptions): Output<GetWorkgroupResult>
    def get_workgroup(region: Optional[str] = None,
                  workgroup_name: Optional[str] = None,
                  opts: Optional[InvokeOptions] = None) -> GetWorkgroupResult
def get_workgroup_output(region: Optional[pulumi.Input[str]] = None,
                  workgroup_name: Optional[pulumi.Input[str]] = None,
                  opts: Optional[InvokeOptions] = None) -> Output[GetWorkgroupResult]
    func LookupWorkgroup(ctx *Context, args *LookupWorkgroupArgs, opts ...InvokeOption) (*LookupWorkgroupResult, error)
func LookupWorkgroupOutput(ctx *Context, args *LookupWorkgroupOutputArgs, opts ...InvokeOption) LookupWorkgroupResultOutput

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

    public static class GetWorkgroup 
{
    public static Task<GetWorkgroupResult> InvokeAsync(GetWorkgroupArgs args, InvokeOptions? opts = null)
    public static Output<GetWorkgroupResult> Invoke(GetWorkgroupInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetWorkgroupResult> getWorkgroup(GetWorkgroupArgs args, InvokeOptions options)
public static Output<GetWorkgroupResult> getWorkgroup(GetWorkgroupArgs args, InvokeOptions options)

    fn::invoke:
  function: aws:redshiftserverless/getWorkgroup:getWorkgroup
  arguments:
    # arguments dictionary

    The following arguments are supported:

    WorkgroupName string
    The name of the workgroup associated with the database.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    WorkgroupName string
    The name of the workgroup associated with the database.
    Region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    workgroupName String
    The name of the workgroup associated with the database.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    workgroupName string
    The name of the workgroup associated with the database.
    region string
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    workgroup_name str
    The name of the workgroup associated with the database.
    region str
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.
    workgroupName String
    The name of the workgroup associated with the database.
    region String
    Region where this resource will be managed. Defaults to the Region set in the provider configuration.

    getWorkgroup Result

    The following output properties are available:

    Arn string
    Amazon Resource Name (ARN) of the Redshift Serverless Workgroup.
    Endpoints List<GetWorkgroupEndpoint>
    The endpoint that is created from the workgroup. See Endpoint below.
    EnhancedVpcRouting bool
    The value that specifies whether to turn on enhanced virtual private cloud (VPC) routing, which forces Amazon Redshift Serverless to route traffic through your VPC instead of over the internet.
    Id string
    The provider-assigned unique ID for this managed resource.
    NamespaceName string
    PubliclyAccessible bool
    A value that specifies whether the workgroup can be accessed from a public network.
    Region string
    SecurityGroupIds List<string>
    An array of security group IDs to associate with the workgroup.
    SubnetIds List<string>
    An array of VPC subnet IDs to associate with the workgroup. When set, must contain at least three subnets spanning three Availability Zones. A minimum number of IP addresses is required and scales with the Base Capacity. For more information, see the following AWS document.
    TrackName string
    The name of the track for the workgroup.
    WorkgroupId string
    The Redshift Workgroup ID.
    WorkgroupName string
    Arn string
    Amazon Resource Name (ARN) of the Redshift Serverless Workgroup.
    Endpoints []GetWorkgroupEndpoint
    The endpoint that is created from the workgroup. See Endpoint below.
    EnhancedVpcRouting bool
    The value that specifies whether to turn on enhanced virtual private cloud (VPC) routing, which forces Amazon Redshift Serverless to route traffic through your VPC instead of over the internet.
    Id string
    The provider-assigned unique ID for this managed resource.
    NamespaceName string
    PubliclyAccessible bool
    A value that specifies whether the workgroup can be accessed from a public network.
    Region string
    SecurityGroupIds []string
    An array of security group IDs to associate with the workgroup.
    SubnetIds []string
    An array of VPC subnet IDs to associate with the workgroup. When set, must contain at least three subnets spanning three Availability Zones. A minimum number of IP addresses is required and scales with the Base Capacity. For more information, see the following AWS document.
    TrackName string
    The name of the track for the workgroup.
    WorkgroupId string
    The Redshift Workgroup ID.
    WorkgroupName string
    arn String
    Amazon Resource Name (ARN) of the Redshift Serverless Workgroup.
    endpoints List<GetWorkgroupEndpoint>
    The endpoint that is created from the workgroup. See Endpoint below.
    enhancedVpcRouting Boolean
    The value that specifies whether to turn on enhanced virtual private cloud (VPC) routing, which forces Amazon Redshift Serverless to route traffic through your VPC instead of over the internet.
    id String
    The provider-assigned unique ID for this managed resource.
    namespaceName String
    publiclyAccessible Boolean
    A value that specifies whether the workgroup can be accessed from a public network.
    region String
    securityGroupIds List<String>
    An array of security group IDs to associate with the workgroup.
    subnetIds List<String>
    An array of VPC subnet IDs to associate with the workgroup. When set, must contain at least three subnets spanning three Availability Zones. A minimum number of IP addresses is required and scales with the Base Capacity. For more information, see the following AWS document.
    trackName String
    The name of the track for the workgroup.
    workgroupId String
    The Redshift Workgroup ID.
    workgroupName String
    arn string
    Amazon Resource Name (ARN) of the Redshift Serverless Workgroup.
    endpoints GetWorkgroupEndpoint[]
    The endpoint that is created from the workgroup. See Endpoint below.
    enhancedVpcRouting boolean
    The value that specifies whether to turn on enhanced virtual private cloud (VPC) routing, which forces Amazon Redshift Serverless to route traffic through your VPC instead of over the internet.
    id string
    The provider-assigned unique ID for this managed resource.
    namespaceName string
    publiclyAccessible boolean
    A value that specifies whether the workgroup can be accessed from a public network.
    region string
    securityGroupIds string[]
    An array of security group IDs to associate with the workgroup.
    subnetIds string[]
    An array of VPC subnet IDs to associate with the workgroup. When set, must contain at least three subnets spanning three Availability Zones. A minimum number of IP addresses is required and scales with the Base Capacity. For more information, see the following AWS document.
    trackName string
    The name of the track for the workgroup.
    workgroupId string
    The Redshift Workgroup ID.
    workgroupName string
    arn str
    Amazon Resource Name (ARN) of the Redshift Serverless Workgroup.
    endpoints Sequence[GetWorkgroupEndpoint]
    The endpoint that is created from the workgroup. See Endpoint below.
    enhanced_vpc_routing bool
    The value that specifies whether to turn on enhanced virtual private cloud (VPC) routing, which forces Amazon Redshift Serverless to route traffic through your VPC instead of over the internet.
    id str
    The provider-assigned unique ID for this managed resource.
    namespace_name str
    publicly_accessible bool
    A value that specifies whether the workgroup can be accessed from a public network.
    region str
    security_group_ids Sequence[str]
    An array of security group IDs to associate with the workgroup.
    subnet_ids Sequence[str]
    An array of VPC subnet IDs to associate with the workgroup. When set, must contain at least three subnets spanning three Availability Zones. A minimum number of IP addresses is required and scales with the Base Capacity. For more information, see the following AWS document.
    track_name str
    The name of the track for the workgroup.
    workgroup_id str
    The Redshift Workgroup ID.
    workgroup_name str
    arn String
    Amazon Resource Name (ARN) of the Redshift Serverless Workgroup.
    endpoints List<Property Map>
    The endpoint that is created from the workgroup. See Endpoint below.
    enhancedVpcRouting Boolean
    The value that specifies whether to turn on enhanced virtual private cloud (VPC) routing, which forces Amazon Redshift Serverless to route traffic through your VPC instead of over the internet.
    id String
    The provider-assigned unique ID for this managed resource.
    namespaceName String
    publiclyAccessible Boolean
    A value that specifies whether the workgroup can be accessed from a public network.
    region String
    securityGroupIds List<String>
    An array of security group IDs to associate with the workgroup.
    subnetIds List<String>
    An array of VPC subnet IDs to associate with the workgroup. When set, must contain at least three subnets spanning three Availability Zones. A minimum number of IP addresses is required and scales with the Base Capacity. For more information, see the following AWS document.
    trackName String
    The name of the track for the workgroup.
    workgroupId String
    The Redshift Workgroup ID.
    workgroupName String

    Supporting Types

    GetWorkgroupEndpoint

    Address string
    The DNS address of the VPC endpoint.
    Port int
    The port that Amazon Redshift Serverless listens on.
    VpcEndpoints List<GetWorkgroupEndpointVpcEndpoint>
    The VPC endpoint or the Redshift Serverless workgroup. See VPC Endpoint below.
    Address string
    The DNS address of the VPC endpoint.
    Port int
    The port that Amazon Redshift Serverless listens on.
    VpcEndpoints []GetWorkgroupEndpointVpcEndpoint
    The VPC endpoint or the Redshift Serverless workgroup. See VPC Endpoint below.
    address String
    The DNS address of the VPC endpoint.
    port Integer
    The port that Amazon Redshift Serverless listens on.
    vpcEndpoints List<GetWorkgroupEndpointVpcEndpoint>
    The VPC endpoint or the Redshift Serverless workgroup. See VPC Endpoint below.
    address string
    The DNS address of the VPC endpoint.
    port number
    The port that Amazon Redshift Serverless listens on.
    vpcEndpoints GetWorkgroupEndpointVpcEndpoint[]
    The VPC endpoint or the Redshift Serverless workgroup. See VPC Endpoint below.
    address str
    The DNS address of the VPC endpoint.
    port int
    The port that Amazon Redshift Serverless listens on.
    vpc_endpoints Sequence[GetWorkgroupEndpointVpcEndpoint]
    The VPC endpoint or the Redshift Serverless workgroup. See VPC Endpoint below.
    address String
    The DNS address of the VPC endpoint.
    port Number
    The port that Amazon Redshift Serverless listens on.
    vpcEndpoints List<Property Map>
    The VPC endpoint or the Redshift Serverless workgroup. See VPC Endpoint below.

    GetWorkgroupEndpointVpcEndpoint

    NetworkInterfaces List<GetWorkgroupEndpointVpcEndpointNetworkInterface>
    The network interfaces of the endpoint.. See Network Interface below.
    VpcEndpointId string
    The DNS address of the VPC endpoint.
    VpcId string
    The port that Amazon Redshift Serverless listens on.
    NetworkInterfaces []GetWorkgroupEndpointVpcEndpointNetworkInterface
    The network interfaces of the endpoint.. See Network Interface below.
    VpcEndpointId string
    The DNS address of the VPC endpoint.
    VpcId string
    The port that Amazon Redshift Serverless listens on.
    networkInterfaces List<GetWorkgroupEndpointVpcEndpointNetworkInterface>
    The network interfaces of the endpoint.. See Network Interface below.
    vpcEndpointId String
    The DNS address of the VPC endpoint.
    vpcId String
    The port that Amazon Redshift Serverless listens on.
    networkInterfaces GetWorkgroupEndpointVpcEndpointNetworkInterface[]
    The network interfaces of the endpoint.. See Network Interface below.
    vpcEndpointId string
    The DNS address of the VPC endpoint.
    vpcId string
    The port that Amazon Redshift Serverless listens on.
    network_interfaces Sequence[GetWorkgroupEndpointVpcEndpointNetworkInterface]
    The network interfaces of the endpoint.. See Network Interface below.
    vpc_endpoint_id str
    The DNS address of the VPC endpoint.
    vpc_id str
    The port that Amazon Redshift Serverless listens on.
    networkInterfaces List<Property Map>
    The network interfaces of the endpoint.. See Network Interface below.
    vpcEndpointId String
    The DNS address of the VPC endpoint.
    vpcId String
    The port that Amazon Redshift Serverless listens on.

    GetWorkgroupEndpointVpcEndpointNetworkInterface

    AvailabilityZone string
    The availability Zone.
    NetworkInterfaceId string
    The unique identifier of the network interface.
    PrivateIpAddress string
    The IPv4 address of the network interface within the subnet.
    SubnetId string
    The unique identifier of the subnet.
    AvailabilityZone string
    The availability Zone.
    NetworkInterfaceId string
    The unique identifier of the network interface.
    PrivateIpAddress string
    The IPv4 address of the network interface within the subnet.
    SubnetId string
    The unique identifier of the subnet.
    availabilityZone String
    The availability Zone.
    networkInterfaceId String
    The unique identifier of the network interface.
    privateIpAddress String
    The IPv4 address of the network interface within the subnet.
    subnetId String
    The unique identifier of the subnet.
    availabilityZone string
    The availability Zone.
    networkInterfaceId string
    The unique identifier of the network interface.
    privateIpAddress string
    The IPv4 address of the network interface within the subnet.
    subnetId string
    The unique identifier of the subnet.
    availability_zone str
    The availability Zone.
    network_interface_id str
    The unique identifier of the network interface.
    private_ip_address str
    The IPv4 address of the network interface within the subnet.
    subnet_id str
    The unique identifier of the subnet.
    availabilityZone String
    The availability Zone.
    networkInterfaceId String
    The unique identifier of the network interface.
    privateIpAddress String
    The IPv4 address of the network interface within the subnet.
    subnetId String
    The unique identifier of the subnet.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    AWS v7.10.0 published on Friday, Oct 24, 2025 by Pulumi
    pulumi/pulumi-aws
      Meet Neo: Your AI Platform Teammate