AWS Classic v5.41.0, May 15 23

aws.redshift.getClusterCredentials

Explore with Pulumi AI

Provides redshift cluster temporary credentials.

Example Usage

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

return await Deployment.RunAsync(() => 
{
    var example = Aws.RedShift.GetClusterCredentials.Invoke(new()
    {
        ClusterIdentifier = aws_redshift_cluster.Example.Cluster_identifier,
        DbUser = aws_redshift_cluster.Example.Master_username,
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v5/go/aws/redshift"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := redshift.GetClusterCredentials(ctx, &redshift.GetClusterCredentialsArgs{
			ClusterIdentifier: aws_redshift_cluster.Example.Cluster_identifier,
			DbUser:            aws_redshift_cluster.Example.Master_username,
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.redshift.RedshiftFunctions;
import com.pulumi.aws.redshift.inputs.GetClusterCredentialsArgs;
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 = RedshiftFunctions.getClusterCredentials(GetClusterCredentialsArgs.builder()
            .clusterIdentifier(aws_redshift_cluster.example().cluster_identifier())
            .dbUser(aws_redshift_cluster.example().master_username())
            .build());

    }
}

import pulumi
import pulumi_aws as aws

example = aws.redshift.get_cluster_credentials(cluster_identifier=aws_redshift_cluster["example"]["cluster_identifier"],
    db_user=aws_redshift_cluster["example"]["master_username"])

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

const example = aws.redshift.getClusterCredentials({
    clusterIdentifier: aws_redshift_cluster.example.cluster_identifier,
    dbUser: aws_redshift_cluster.example.master_username,
});

variables:
  example:
    fn::invoke:
      Function: aws:redshift:getClusterCredentials
      Arguments:
        clusterIdentifier: ${aws_redshift_cluster.example.cluster_identifier}
        dbUser: ${aws_redshift_cluster.example.master_username}

Using getClusterCredentials

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 getClusterCredentials(args: GetClusterCredentialsArgs, opts?: InvokeOptions): Promise<GetClusterCredentialsResult>
function getClusterCredentialsOutput(args: GetClusterCredentialsOutputArgs, opts?: InvokeOptions): Output<GetClusterCredentialsResult>

def get_cluster_credentials(auto_create: Optional[bool] = None,
                            cluster_identifier: Optional[str] = None,
                            db_groups: Optional[Sequence[str]] = None,
                            db_name: Optional[str] = None,
                            db_user: Optional[str] = None,
                            duration_seconds: Optional[int] = None,
                            opts: Optional[InvokeOptions] = None) -> GetClusterCredentialsResult
def get_cluster_credentials_output(auto_create: Optional[pulumi.Input[bool]] = None,
                            cluster_identifier: Optional[pulumi.Input[str]] = None,
                            db_groups: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                            db_name: Optional[pulumi.Input[str]] = None,
                            db_user: Optional[pulumi.Input[str]] = None,
                            duration_seconds: Optional[pulumi.Input[int]] = None,
                            opts: Optional[InvokeOptions] = None) -> Output[GetClusterCredentialsResult]

func GetClusterCredentials(ctx *Context, args *GetClusterCredentialsArgs, opts ...InvokeOption) (*GetClusterCredentialsResult, error)
func GetClusterCredentialsOutput(ctx *Context, args *GetClusterCredentialsOutputArgs, opts ...InvokeOption) GetClusterCredentialsResultOutput

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

public static class GetClusterCredentials 
{
    public static Task<GetClusterCredentialsResult> InvokeAsync(GetClusterCredentialsArgs args, InvokeOptions? opts = null)
    public static Output<GetClusterCredentialsResult> Invoke(GetClusterCredentialsInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetClusterCredentialsResult> getClusterCredentials(GetClusterCredentialsArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: aws:redshift/getClusterCredentials:getClusterCredentials
  arguments:
    # arguments dictionary

The following arguments are supported:

ClusterIdentifier string: Unique identifier of the cluster that contains the database for which your are requesting credentials.
DbUser string: Name of a database user. If a user name matching db_user exists in the database, the temporary user credentials have the same permissions as the existing user. If db_user doesn't exist in the database and auto_create is True, a new user is created using the value for db_user with PUBLIC permissions. If a database user matching the value for db_user doesn't exist and not is False, then the command succeeds but the connection attempt will fail because the user doesn't exist in the database.
AutoCreate bool: Create a database user with the name specified for the user named in db_user if one does not exist.
DbGroups List<string>: List of the names of existing database groups that the user named in db_user will join for the current session, in addition to any group memberships for an existing user. If not specified, a new user is added only to PUBLIC.
DbName string: Name of a database that DbUser is authorized to log on to. If db_name is not specified, db_user can log on to any existing database.
DurationSeconds int: The number of seconds until the returned temporary password expires. Valid values are between 900 and 3600. Default value is 900.

ClusterIdentifier string: Unique identifier of the cluster that contains the database for which your are requesting credentials.
DbUser string: Name of a database user. If a user name matching db_user exists in the database, the temporary user credentials have the same permissions as the existing user. If db_user doesn't exist in the database and auto_create is True, a new user is created using the value for db_user with PUBLIC permissions. If a database user matching the value for db_user doesn't exist and not is False, then the command succeeds but the connection attempt will fail because the user doesn't exist in the database.
AutoCreate bool: Create a database user with the name specified for the user named in db_user if one does not exist.
DbGroups []string: List of the names of existing database groups that the user named in db_user will join for the current session, in addition to any group memberships for an existing user. If not specified, a new user is added only to PUBLIC.
DbName string: Name of a database that DbUser is authorized to log on to. If db_name is not specified, db_user can log on to any existing database.
DurationSeconds int: The number of seconds until the returned temporary password expires. Valid values are between 900 and 3600. Default value is 900.

clusterIdentifier String: Unique identifier of the cluster that contains the database for which your are requesting credentials.
dbUser String: Name of a database user. If a user name matching db_user exists in the database, the temporary user credentials have the same permissions as the existing user. If db_user doesn't exist in the database and auto_create is True, a new user is created using the value for db_user with PUBLIC permissions. If a database user matching the value for db_user doesn't exist and not is False, then the command succeeds but the connection attempt will fail because the user doesn't exist in the database.
autoCreate Boolean: Create a database user with the name specified for the user named in db_user if one does not exist.
dbGroups List<String>: List of the names of existing database groups that the user named in db_user will join for the current session, in addition to any group memberships for an existing user. If not specified, a new user is added only to PUBLIC.
dbName String: Name of a database that DbUser is authorized to log on to. If db_name is not specified, db_user can log on to any existing database.
durationSeconds Integer: The number of seconds until the returned temporary password expires. Valid values are between 900 and 3600. Default value is 900.

clusterIdentifier string: Unique identifier of the cluster that contains the database for which your are requesting credentials.
dbUser string: Name of a database user. If a user name matching db_user exists in the database, the temporary user credentials have the same permissions as the existing user. If db_user doesn't exist in the database and auto_create is True, a new user is created using the value for db_user with PUBLIC permissions. If a database user matching the value for db_user doesn't exist and not is False, then the command succeeds but the connection attempt will fail because the user doesn't exist in the database.
autoCreate boolean: Create a database user with the name specified for the user named in db_user if one does not exist.
dbGroups string[]: List of the names of existing database groups that the user named in db_user will join for the current session, in addition to any group memberships for an existing user. If not specified, a new user is added only to PUBLIC.
dbName string: Name of a database that DbUser is authorized to log on to. If db_name is not specified, db_user can log on to any existing database.
durationSeconds number: The number of seconds until the returned temporary password expires. Valid values are between 900 and 3600. Default value is 900.

cluster_identifier str: Unique identifier of the cluster that contains the database for which your are requesting credentials.
db_user str: Name of a database user. If a user name matching db_user exists in the database, the temporary user credentials have the same permissions as the existing user. If db_user doesn't exist in the database and auto_create is True, a new user is created using the value for db_user with PUBLIC permissions. If a database user matching the value for db_user doesn't exist and not is False, then the command succeeds but the connection attempt will fail because the user doesn't exist in the database.
auto_create bool: Create a database user with the name specified for the user named in db_user if one does not exist.
db_groups Sequence[str]: List of the names of existing database groups that the user named in db_user will join for the current session, in addition to any group memberships for an existing user. If not specified, a new user is added only to PUBLIC.
db_name str: Name of a database that DbUser is authorized to log on to. If db_name is not specified, db_user can log on to any existing database.
duration_seconds int: The number of seconds until the returned temporary password expires. Valid values are between 900 and 3600. Default value is 900.

clusterIdentifier String: Unique identifier of the cluster that contains the database for which your are requesting credentials.
dbUser String: Name of a database user. If a user name matching db_user exists in the database, the temporary user credentials have the same permissions as the existing user. If db_user doesn't exist in the database and auto_create is True, a new user is created using the value for db_user with PUBLIC permissions. If a database user matching the value for db_user doesn't exist and not is False, then the command succeeds but the connection attempt will fail because the user doesn't exist in the database.
autoCreate Boolean: Create a database user with the name specified for the user named in db_user if one does not exist.
dbGroups List<String>: List of the names of existing database groups that the user named in db_user will join for the current session, in addition to any group memberships for an existing user. If not specified, a new user is added only to PUBLIC.
dbName String: Name of a database that DbUser is authorized to log on to. If db_name is not specified, db_user can log on to any existing database.
durationSeconds Number: The number of seconds until the returned temporary password expires. Valid values are between 900 and 3600. Default value is 900.

getClusterCredentials Result

The following output properties are available:

ClusterIdentifier string
DbPassword string: Temporary password that authorizes the user name returned by db_user to log on to the database db_name.
DbUser string
Expiration string: Date and time the password in db_password expires.
Id string: The provider-assigned unique ID for this managed resource.
AutoCreate bool
DbGroups List<string>
DbName string
DurationSeconds int

ClusterIdentifier string
DbPassword string: Temporary password that authorizes the user name returned by db_user to log on to the database db_name.
DbUser string
Expiration string: Date and time the password in db_password expires.
Id string: The provider-assigned unique ID for this managed resource.
AutoCreate bool
DbGroups []string
DbName string
DurationSeconds int

clusterIdentifier String
dbPassword String: Temporary password that authorizes the user name returned by db_user to log on to the database db_name.
dbUser String
expiration String: Date and time the password in db_password expires.
id String: The provider-assigned unique ID for this managed resource.
autoCreate Boolean
dbGroups List<String>
dbName String
durationSeconds Integer

clusterIdentifier string
dbPassword string: Temporary password that authorizes the user name returned by db_user to log on to the database db_name.
dbUser string
expiration string: Date and time the password in db_password expires.
id string: The provider-assigned unique ID for this managed resource.
autoCreate boolean
dbGroups string[]
dbName string
durationSeconds number

cluster_identifier str
db_password str: Temporary password that authorizes the user name returned by db_user to log on to the database db_name.
db_user str
expiration str: Date and time the password in db_password expires.
id str: The provider-assigned unique ID for this managed resource.
auto_create bool
db_groups Sequence[str]
db_name str
duration_seconds int

clusterIdentifier String
dbPassword String: Temporary password that authorizes the user name returned by db_user to log on to the database db_name.
dbUser String
expiration String: Date and time the password in db_password expires.
id String: The provider-assigned unique ID for this managed resource.
autoCreate Boolean
dbGroups List<String>
dbName String
durationSeconds Number

Package Details

Repository: AWS Classic pulumi/pulumi-aws
License: Apache-2.0
Notes: This Pulumi package is based on the aws Terraform Provider.