1. Packages
  2. AWS Classic
  3. API Docs
  4. secretsmanager
  5. getSecret

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.42.0 published on Wednesday, Jun 26, 2024 by Pulumi

aws.secretsmanager.getSecret

Explore with Pulumi AI

aws logo

Try AWS Native preview for resources not in the classic version.

AWS Classic v6.42.0 published on Wednesday, Jun 26, 2024 by Pulumi

    Retrieve metadata information about a Secrets Manager secret. To retrieve a secret value, see the aws.secretsmanager.SecretVersion data source.

    Example Usage

    ARN

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const by-arn = aws.secretsmanager.getSecret({
        arn: "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-123456",
    });
    
    import pulumi
    import pulumi_aws as aws
    
    by_arn = aws.secretsmanager.get_secret(arn="arn:aws:secretsmanager:us-east-1:123456789012:secret:example-123456")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/secretsmanager"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := secretsmanager.LookupSecret(ctx, &secretsmanager.LookupSecretArgs{
    			Arn: pulumi.StringRef("arn:aws:secretsmanager:us-east-1:123456789012:secret:example-123456"),
    		}, 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 by_arn = Aws.SecretsManager.GetSecret.Invoke(new()
        {
            Arn = "arn:aws:secretsmanager:us-east-1:123456789012:secret:example-123456",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.secretsmanager.SecretsmanagerFunctions;
    import com.pulumi.aws.secretsmanager.inputs.GetSecretArgs;
    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 by-arn = SecretsmanagerFunctions.getSecret(GetSecretArgs.builder()
                .arn("arn:aws:secretsmanager:us-east-1:123456789012:secret:example-123456")
                .build());
    
        }
    }
    
    variables:
      by-arn:
        fn::invoke:
          Function: aws:secretsmanager:getSecret
          Arguments:
            arn: arn:aws:secretsmanager:us-east-1:123456789012:secret:example-123456
    

    Name

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const by-name = aws.secretsmanager.getSecret({
        name: "example",
    });
    
    import pulumi
    import pulumi_aws as aws
    
    by_name = aws.secretsmanager.get_secret(name="example")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/secretsmanager"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := secretsmanager.LookupSecret(ctx, &secretsmanager.LookupSecretArgs{
    			Name: pulumi.StringRef("example"),
    		}, 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 by_name = Aws.SecretsManager.GetSecret.Invoke(new()
        {
            Name = "example",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.secretsmanager.SecretsmanagerFunctions;
    import com.pulumi.aws.secretsmanager.inputs.GetSecretArgs;
    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 by-name = SecretsmanagerFunctions.getSecret(GetSecretArgs.builder()
                .name("example")
                .build());
    
        }
    }
    
    variables:
      by-name:
        fn::invoke:
          Function: aws:secretsmanager:getSecret
          Arguments:
            name: example
    

    Using getSecret

    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 getSecret(args: GetSecretArgs, opts?: InvokeOptions): Promise<GetSecretResult>
    function getSecretOutput(args: GetSecretOutputArgs, opts?: InvokeOptions): Output<GetSecretResult>
    def get_secret(arn: Optional[str] = None,
                   name: Optional[str] = None,
                   tags: Optional[Mapping[str, str]] = None,
                   opts: Optional[InvokeOptions] = None) -> GetSecretResult
    def get_secret_output(arn: Optional[pulumi.Input[str]] = None,
                   name: Optional[pulumi.Input[str]] = None,
                   tags: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                   opts: Optional[InvokeOptions] = None) -> Output[GetSecretResult]
    func LookupSecret(ctx *Context, args *LookupSecretArgs, opts ...InvokeOption) (*LookupSecretResult, error)
    func LookupSecretOutput(ctx *Context, args *LookupSecretOutputArgs, opts ...InvokeOption) LookupSecretResultOutput

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

    public static class GetSecret 
    {
        public static Task<GetSecretResult> InvokeAsync(GetSecretArgs args, InvokeOptions? opts = null)
        public static Output<GetSecretResult> Invoke(GetSecretInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetSecretResult> getSecret(GetSecretArgs args, InvokeOptions options)
    // Output-based functions aren't available in Java yet
    
    fn::invoke:
      function: aws:secretsmanager/getSecret:getSecret
      arguments:
        # arguments dictionary

    The following arguments are supported:

    Arn string
    ARN of the secret to retrieve.
    Name string
    Name of the secret to retrieve.
    Tags Dictionary<string, string>
    Tags of the secret.
    Arn string
    ARN of the secret to retrieve.
    Name string
    Name of the secret to retrieve.
    Tags map[string]string
    Tags of the secret.
    arn String
    ARN of the secret to retrieve.
    name String
    Name of the secret to retrieve.
    tags Map<String,String>
    Tags of the secret.
    arn string
    ARN of the secret to retrieve.
    name string
    Name of the secret to retrieve.
    tags {[key: string]: string}
    Tags of the secret.
    arn str
    ARN of the secret to retrieve.
    name str
    Name of the secret to retrieve.
    tags Mapping[str, str]
    Tags of the secret.
    arn String
    ARN of the secret to retrieve.
    name String
    Name of the secret to retrieve.
    tags Map<String>
    Tags of the secret.

    getSecret Result

    The following output properties are available:

    Arn string
    ARN of the secret.
    CreatedDate string
    Created date of the secret in UTC.
    Description string
    Description of the secret.
    Id string
    The provider-assigned unique ID for this managed resource.
    KmsKeyId string
    Key Management Service (KMS) Customer Master Key (CMK) associated with the secret.
    LastChangedDate string
    Last updated date of the secret in UTC.
    Name string
    Policy string
    Resource-based policy document that's attached to the secret.
    Tags Dictionary<string, string>
    Tags of the secret.
    Arn string
    ARN of the secret.
    CreatedDate string
    Created date of the secret in UTC.
    Description string
    Description of the secret.
    Id string
    The provider-assigned unique ID for this managed resource.
    KmsKeyId string
    Key Management Service (KMS) Customer Master Key (CMK) associated with the secret.
    LastChangedDate string
    Last updated date of the secret in UTC.
    Name string
    Policy string
    Resource-based policy document that's attached to the secret.
    Tags map[string]string
    Tags of the secret.
    arn String
    ARN of the secret.
    createdDate String
    Created date of the secret in UTC.
    description String
    Description of the secret.
    id String
    The provider-assigned unique ID for this managed resource.
    kmsKeyId String
    Key Management Service (KMS) Customer Master Key (CMK) associated with the secret.
    lastChangedDate String
    Last updated date of the secret in UTC.
    name String
    policy String
    Resource-based policy document that's attached to the secret.
    tags Map<String,String>
    Tags of the secret.
    arn string
    ARN of the secret.
    createdDate string
    Created date of the secret in UTC.
    description string
    Description of the secret.
    id string
    The provider-assigned unique ID for this managed resource.
    kmsKeyId string
    Key Management Service (KMS) Customer Master Key (CMK) associated with the secret.
    lastChangedDate string
    Last updated date of the secret in UTC.
    name string
    policy string
    Resource-based policy document that's attached to the secret.
    tags {[key: string]: string}
    Tags of the secret.
    arn str
    ARN of the secret.
    created_date str
    Created date of the secret in UTC.
    description str
    Description of the secret.
    id str
    The provider-assigned unique ID for this managed resource.
    kms_key_id str
    Key Management Service (KMS) Customer Master Key (CMK) associated with the secret.
    last_changed_date str
    Last updated date of the secret in UTC.
    name str
    policy str
    Resource-based policy document that's attached to the secret.
    tags Mapping[str, str]
    Tags of the secret.
    arn String
    ARN of the secret.
    createdDate String
    Created date of the secret in UTC.
    description String
    Description of the secret.
    id String
    The provider-assigned unique ID for this managed resource.
    kmsKeyId String
    Key Management Service (KMS) Customer Master Key (CMK) associated with the secret.
    lastChangedDate String
    Last updated date of the secret in UTC.
    name String
    policy String
    Resource-based policy document that's attached to the secret.
    tags Map<String>
    Tags of the secret.

    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

    Try AWS Native preview for resources not in the classic version.

    AWS Classic v6.42.0 published on Wednesday, Jun 26, 2024 by Pulumi