1. Packages
  2. AWS
  3. API Docs
  4. ssm
  5. Parameter
AWS v6.64.0 published on Friday, Dec 6, 2024 by Pulumi

aws.ssm.Parameter

Explore with Pulumi AI

aws logo
AWS v6.64.0 published on Friday, Dec 6, 2024 by Pulumi

    Provides an SSM Parameter resource.

    Note: overwrite also makes it possible to overwrite an existing SSM Parameter that’s not created by the provider before. This argument has been deprecated and will be removed in v6.0.0 of the provider. For more information on how this affects the behavior of this resource, see this issue comment.

    Example Usage

    Basic example

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const foo = new aws.ssm.Parameter("foo", {
        name: "foo",
        type: aws.ssm.ParameterType.String,
        value: "bar",
    });
    
    import pulumi
    import pulumi_aws as aws
    
    foo = aws.ssm.Parameter("foo",
        name="foo",
        type=aws.ssm.ParameterType.STRING,
        value="bar")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ssm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := ssm.NewParameter(ctx, "foo", &ssm.ParameterArgs{
    			Name:  pulumi.String("foo"),
    			Type:  pulumi.String(ssm.ParameterTypeString),
    			Value: pulumi.String("bar"),
    		})
    		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 foo = new Aws.Ssm.Parameter("foo", new()
        {
            Name = "foo",
            Type = Aws.Ssm.ParameterType.String,
            Value = "bar",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.ssm.Parameter;
    import com.pulumi.aws.ssm.ParameterArgs;
    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) {
            var foo = new Parameter("foo", ParameterArgs.builder()
                .name("foo")
                .type("String")
                .value("bar")
                .build());
    
        }
    }
    
    resources:
      foo:
        type: aws:ssm:Parameter
        properties:
          name: foo
          type: String
          value: bar
    

    Encrypted string using default SSM KMS key

    import * as pulumi from "@pulumi/pulumi";
    import * as aws from "@pulumi/aws";
    
    const _default = new aws.rds.Instance("default", {
        allocatedStorage: 10,
        storageType: aws.rds.StorageType.GP2,
        engine: "mysql",
        engineVersion: "5.7.16",
        instanceClass: aws.rds.InstanceType.T2_Micro,
        dbName: "mydb",
        username: "foo",
        password: databaseMasterPassword,
        dbSubnetGroupName: "my_database_subnet_group",
        parameterGroupName: "default.mysql5.7",
    });
    const secret = new aws.ssm.Parameter("secret", {
        name: "/production/database/password/master",
        description: "The parameter description",
        type: aws.ssm.ParameterType.SecureString,
        value: databaseMasterPassword,
        tags: {
            environment: "production",
        },
    });
    
    import pulumi
    import pulumi_aws as aws
    
    default = aws.rds.Instance("default",
        allocated_storage=10,
        storage_type=aws.rds.StorageType.GP2,
        engine="mysql",
        engine_version="5.7.16",
        instance_class=aws.rds.InstanceType.T2_MICRO,
        db_name="mydb",
        username="foo",
        password=database_master_password,
        db_subnet_group_name="my_database_subnet_group",
        parameter_group_name="default.mysql5.7")
    secret = aws.ssm.Parameter("secret",
        name="/production/database/password/master",
        description="The parameter description",
        type=aws.ssm.ParameterType.SECURE_STRING,
        value=database_master_password,
        tags={
            "environment": "production",
        })
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/rds"
    	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ssm"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := rds.NewInstance(ctx, "default", &rds.InstanceArgs{
    			AllocatedStorage:   pulumi.Int(10),
    			StorageType:        pulumi.String(rds.StorageTypeGP2),
    			Engine:             pulumi.String("mysql"),
    			EngineVersion:      pulumi.String("5.7.16"),
    			InstanceClass:      pulumi.String(rds.InstanceType_T2_Micro),
    			DbName:             pulumi.String("mydb"),
    			Username:           pulumi.String("foo"),
    			Password:           pulumi.Any(databaseMasterPassword),
    			DbSubnetGroupName:  pulumi.String("my_database_subnet_group"),
    			ParameterGroupName: pulumi.String("default.mysql5.7"),
    		})
    		if err != nil {
    			return err
    		}
    		_, err = ssm.NewParameter(ctx, "secret", &ssm.ParameterArgs{
    			Name:        pulumi.String("/production/database/password/master"),
    			Description: pulumi.String("The parameter description"),
    			Type:        pulumi.String(ssm.ParameterTypeSecureString),
    			Value:       pulumi.Any(databaseMasterPassword),
    			Tags: pulumi.StringMap{
    				"environment": pulumi.String("production"),
    			},
    		})
    		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 @default = new Aws.Rds.Instance("default", new()
        {
            AllocatedStorage = 10,
            StorageType = Aws.Rds.StorageType.GP2,
            Engine = "mysql",
            EngineVersion = "5.7.16",
            InstanceClass = Aws.Rds.InstanceType.T2_Micro,
            DbName = "mydb",
            Username = "foo",
            Password = databaseMasterPassword,
            DbSubnetGroupName = "my_database_subnet_group",
            ParameterGroupName = "default.mysql5.7",
        });
    
        var secret = new Aws.Ssm.Parameter("secret", new()
        {
            Name = "/production/database/password/master",
            Description = "The parameter description",
            Type = Aws.Ssm.ParameterType.SecureString,
            Value = databaseMasterPassword,
            Tags = 
            {
                { "environment", "production" },
            },
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.aws.rds.Instance;
    import com.pulumi.aws.rds.InstanceArgs;
    import com.pulumi.aws.ssm.Parameter;
    import com.pulumi.aws.ssm.ParameterArgs;
    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) {
            var default_ = new Instance("default", InstanceArgs.builder()
                .allocatedStorage(10)
                .storageType("gp2")
                .engine("mysql")
                .engineVersion("5.7.16")
                .instanceClass("db.t2.micro")
                .dbName("mydb")
                .username("foo")
                .password(databaseMasterPassword)
                .dbSubnetGroupName("my_database_subnet_group")
                .parameterGroupName("default.mysql5.7")
                .build());
    
            var secret = new Parameter("secret", ParameterArgs.builder()
                .name("/production/database/password/master")
                .description("The parameter description")
                .type("SecureString")
                .value(databaseMasterPassword)
                .tags(Map.of("environment", "production"))
                .build());
    
        }
    }
    
    resources:
      default:
        type: aws:rds:Instance
        properties:
          allocatedStorage: 10
          storageType: gp2
          engine: mysql
          engineVersion: 5.7.16
          instanceClass: db.t2.micro
          dbName: mydb
          username: foo
          password: ${databaseMasterPassword}
          dbSubnetGroupName: my_database_subnet_group
          parameterGroupName: default.mysql5.7
      secret:
        type: aws:ssm:Parameter
        properties:
          name: /production/database/password/master
          description: The parameter description
          type: SecureString
          value: ${databaseMasterPassword}
          tags:
            environment: production
    

    Create Parameter Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Parameter(name: string, args: ParameterArgs, opts?: CustomResourceOptions);
    @overload
    def Parameter(resource_name: str,
                  args: ParameterArgs,
                  opts: Optional[ResourceOptions] = None)
    
    @overload
    def Parameter(resource_name: str,
                  opts: Optional[ResourceOptions] = None,
                  type: Optional[Union[str, ParameterType]] = None,
                  allowed_pattern: Optional[str] = None,
                  arn: Optional[str] = None,
                  data_type: Optional[str] = None,
                  description: Optional[str] = None,
                  insecure_value: Optional[str] = None,
                  key_id: Optional[str] = None,
                  name: Optional[str] = None,
                  overwrite: Optional[bool] = None,
                  tags: Optional[Mapping[str, str]] = None,
                  tier: Optional[str] = None,
                  value: Optional[str] = None)
    func NewParameter(ctx *Context, name string, args ParameterArgs, opts ...ResourceOption) (*Parameter, error)
    public Parameter(string name, ParameterArgs args, CustomResourceOptions? opts = null)
    public Parameter(String name, ParameterArgs args)
    public Parameter(String name, ParameterArgs args, CustomResourceOptions options)
    
    type: aws:ssm:Parameter
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args ParameterArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args ParameterArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ParameterArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ParameterArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ParameterArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var parameterResource = new Aws.Ssm.Parameter("parameterResource", new()
    {
        Type = "string",
        AllowedPattern = "string",
        Arn = "string",
        DataType = "string",
        Description = "string",
        InsecureValue = "string",
        KeyId = "string",
        Name = "string",
        Tags = 
        {
            { "string", "string" },
        },
        Tier = "string",
        Value = "string",
    });
    
    example, err := ssm.NewParameter(ctx, "parameterResource", &ssm.ParameterArgs{
    	Type:           pulumi.String("string"),
    	AllowedPattern: pulumi.String("string"),
    	Arn:            pulumi.String("string"),
    	DataType:       pulumi.String("string"),
    	Description:    pulumi.String("string"),
    	InsecureValue:  pulumi.String("string"),
    	KeyId:          pulumi.String("string"),
    	Name:           pulumi.String("string"),
    	Tags: pulumi.StringMap{
    		"string": pulumi.String("string"),
    	},
    	Tier:  pulumi.String("string"),
    	Value: pulumi.String("string"),
    })
    
    var parameterResource = new Parameter("parameterResource", ParameterArgs.builder()
        .type("string")
        .allowedPattern("string")
        .arn("string")
        .dataType("string")
        .description("string")
        .insecureValue("string")
        .keyId("string")
        .name("string")
        .tags(Map.of("string", "string"))
        .tier("string")
        .value("string")
        .build());
    
    parameter_resource = aws.ssm.Parameter("parameterResource",
        type="string",
        allowed_pattern="string",
        arn="string",
        data_type="string",
        description="string",
        insecure_value="string",
        key_id="string",
        name="string",
        tags={
            "string": "string",
        },
        tier="string",
        value="string")
    
    const parameterResource = new aws.ssm.Parameter("parameterResource", {
        type: "string",
        allowedPattern: "string",
        arn: "string",
        dataType: "string",
        description: "string",
        insecureValue: "string",
        keyId: "string",
        name: "string",
        tags: {
            string: "string",
        },
        tier: "string",
        value: "string",
    });
    
    type: aws:ssm:Parameter
    properties:
        allowedPattern: string
        arn: string
        dataType: string
        description: string
        insecureValue: string
        keyId: string
        name: string
        tags:
            string: string
        tier: string
        type: string
        value: string
    

    Parameter Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Parameter resource accepts the following input properties:

    Type string | Pulumi.Aws.Ssm.ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    AllowedPattern string
    Regular expression used to validate the parameter value.
    Arn string
    ARN of the parameter.
    DataType string
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    Description string
    Description of the parameter.
    InsecureValue string
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    KeyId string
    KMS key ID or ARN for encrypting a SecureString.
    Name string
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    Overwrite bool
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    Tags Dictionary<string, string>
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    Tier string
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    Value string

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    Type string | ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    AllowedPattern string
    Regular expression used to validate the parameter value.
    Arn string
    ARN of the parameter.
    DataType string
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    Description string
    Description of the parameter.
    InsecureValue string
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    KeyId string
    KMS key ID or ARN for encrypting a SecureString.
    Name string
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    Overwrite bool
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    Tags map[string]string
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    Tier string
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    Value string

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    type String | ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    allowedPattern String
    Regular expression used to validate the parameter value.
    arn String
    ARN of the parameter.
    dataType String
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    description String
    Description of the parameter.
    insecureValue String
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    keyId String
    KMS key ID or ARN for encrypting a SecureString.
    name String
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    overwrite Boolean
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    tags Map<String,String>
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tier String
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    value String

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    type string | ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    allowedPattern string
    Regular expression used to validate the parameter value.
    arn string
    ARN of the parameter.
    dataType string
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    description string
    Description of the parameter.
    insecureValue string
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    keyId string
    KMS key ID or ARN for encrypting a SecureString.
    name string
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    overwrite boolean
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    tags {[key: string]: string}
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tier string
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    value string

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    type str | ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    allowed_pattern str
    Regular expression used to validate the parameter value.
    arn str
    ARN of the parameter.
    data_type str
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    description str
    Description of the parameter.
    insecure_value str
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    key_id str
    KMS key ID or ARN for encrypting a SecureString.
    name str
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    overwrite bool
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    tags Mapping[str, str]
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tier str
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    value str

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    type String | "String" | "StringList" | "SecureString"

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    allowedPattern String
    Regular expression used to validate the parameter value.
    arn String
    ARN of the parameter.
    dataType String
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    description String
    Description of the parameter.
    insecureValue String
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    keyId String
    KMS key ID or ARN for encrypting a SecureString.
    name String
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    overwrite Boolean
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    tags Map<String>
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tier String
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    value String

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Parameter resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    Version int
    Version of the parameter.
    Id string
    The provider-assigned unique ID for this managed resource.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    Version int
    Version of the parameter.
    id String
    The provider-assigned unique ID for this managed resource.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    version Integer
    Version of the parameter.
    id string
    The provider-assigned unique ID for this managed resource.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    version number
    Version of the parameter.
    id str
    The provider-assigned unique ID for this managed resource.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    version int
    Version of the parameter.
    id String
    The provider-assigned unique ID for this managed resource.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    version Number
    Version of the parameter.

    Look up Existing Parameter Resource

    Get an existing Parameter resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: ParameterState, opts?: CustomResourceOptions): Parameter
    @staticmethod
    def get(resource_name: str,
            id: str,
            opts: Optional[ResourceOptions] = None,
            allowed_pattern: Optional[str] = None,
            arn: Optional[str] = None,
            data_type: Optional[str] = None,
            description: Optional[str] = None,
            insecure_value: Optional[str] = None,
            key_id: Optional[str] = None,
            name: Optional[str] = None,
            overwrite: Optional[bool] = None,
            tags: Optional[Mapping[str, str]] = None,
            tags_all: Optional[Mapping[str, str]] = None,
            tier: Optional[str] = None,
            type: Optional[Union[str, ParameterType]] = None,
            value: Optional[str] = None,
            version: Optional[int] = None) -> Parameter
    func GetParameter(ctx *Context, name string, id IDInput, state *ParameterState, opts ...ResourceOption) (*Parameter, error)
    public static Parameter Get(string name, Input<string> id, ParameterState? state, CustomResourceOptions? opts = null)
    public static Parameter get(String name, Output<String> id, ParameterState state, CustomResourceOptions options)
    Resource lookup is not supported in YAML
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    AllowedPattern string
    Regular expression used to validate the parameter value.
    Arn string
    ARN of the parameter.
    DataType string
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    Description string
    Description of the parameter.
    InsecureValue string
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    KeyId string
    KMS key ID or ARN for encrypting a SecureString.
    Name string
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    Overwrite bool
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    Tags Dictionary<string, string>
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll Dictionary<string, string>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    Tier string
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    Type string | Pulumi.Aws.Ssm.ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    Value string

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    Version int
    Version of the parameter.
    AllowedPattern string
    Regular expression used to validate the parameter value.
    Arn string
    ARN of the parameter.
    DataType string
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    Description string
    Description of the parameter.
    InsecureValue string
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    KeyId string
    KMS key ID or ARN for encrypting a SecureString.
    Name string
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    Overwrite bool
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    Tags map[string]string
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    TagsAll map[string]string
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    Tier string
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    Type string | ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    Value string

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    Version int
    Version of the parameter.
    allowedPattern String
    Regular expression used to validate the parameter value.
    arn String
    ARN of the parameter.
    dataType String
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    description String
    Description of the parameter.
    insecureValue String
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    keyId String
    KMS key ID or ARN for encrypting a SecureString.
    name String
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    overwrite Boolean
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    tags Map<String,String>
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String,String>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    tier String
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    type String | ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    value String

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    version Integer
    Version of the parameter.
    allowedPattern string
    Regular expression used to validate the parameter value.
    arn string
    ARN of the parameter.
    dataType string
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    description string
    Description of the parameter.
    insecureValue string
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    keyId string
    KMS key ID or ARN for encrypting a SecureString.
    name string
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    overwrite boolean
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    tags {[key: string]: string}
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll {[key: string]: string}
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    tier string
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    type string | ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    value string

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    version number
    Version of the parameter.
    allowed_pattern str
    Regular expression used to validate the parameter value.
    arn str
    ARN of the parameter.
    data_type str
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    description str
    Description of the parameter.
    insecure_value str
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    key_id str
    KMS key ID or ARN for encrypting a SecureString.
    name str
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    overwrite bool
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    tags Mapping[str, str]
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tags_all Mapping[str, str]
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    tier str
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    type str | ParameterType

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    value str

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    version int
    Version of the parameter.
    allowedPattern String
    Regular expression used to validate the parameter value.
    arn String
    ARN of the parameter.
    dataType String
    Data type of the parameter. Valid values: text, aws:ssm:integration and aws:ec2:image for AMI format, see the Native parameter support for Amazon Machine Image IDs.
    description String
    Description of the parameter.
    insecureValue String
    Value of the parameter. Use caution: This value is never marked as sensitive in the pulumi preview output. This argument is not valid with a type of SecureString.
    keyId String
    KMS key ID or ARN for encrypting a SecureString.
    name String
    Name of the parameter. If the name contains a path (e.g., any forward slashes (/)), it must be fully qualified with a leading forward slash (/). For additional requirements and constraints, see the AWS SSM User Guide.
    overwrite Boolean
    Overwrite an existing parameter. If not specified, defaults to false if the resource has not been created by Pulumi to avoid overwrite of existing resource, and will default to true otherwise (Pulumi lifecycle rules should then be used to manage the update behavior).

    Deprecated: this attribute has been deprecated

    tags Map<String>
    Map of tags to assign to the object. If configured with a provider default_tags configuration block present, tags with matching keys will overwrite those defined at the provider-level.
    tagsAll Map<String>
    Map of tags assigned to the resource, including those inherited from the provider default_tags configuration block.

    Deprecated: Please use tags instead.

    tier String
    Parameter tier to assign to the parameter. If not specified, will use the default parameter tier for the region. Valid tiers are Standard, Advanced, and Intelligent-Tiering. Downgrading an Advanced tier parameter to Standard will recreate the resource. For more information on parameter tiers, see the AWS SSM Parameter tier comparison and guide.
    type String | "String" | "StringList" | "SecureString"

    Type of the parameter. Valid types are String, StringList and SecureString.

    The following arguments are optional:

    value String

    Value of the parameter. This value is always marked as sensitive in the pulumi preview output, regardless of type.

    NOTE: aws:ssm:integration data_type parameters must be of the type SecureString and the name must start with the prefix /d9d01087-4a3f-49e0-b0b4-d568d7826553/ssm/integrations/webhook/. See here for information on the usage of aws:ssm:integration parameters.

    version Number
    Version of the parameter.

    Supporting Types

    ParameterType, ParameterTypeArgs

    String
    String
    StringList
    StringList
    SecureString
    SecureString
    ParameterTypeString
    String
    ParameterTypeStringList
    StringList
    ParameterTypeSecureString
    SecureString
    String
    String
    StringList
    StringList
    SecureString
    SecureString
    String
    String
    StringList
    StringList
    SecureString
    SecureString
    STRING
    String
    STRING_LIST
    StringList
    SECURE_STRING
    SecureString
    "String"
    String
    "StringList"
    StringList
    "SecureString"
    SecureString

    Import

    Using pulumi import, import SSM Parameters using the parameter store name. For example:

    $ pulumi import aws:ssm/parameter:Parameter my_param /my_path/my_paramname
    

    To learn more about importing existing cloud resources, see Importing resources.

    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 v6.64.0 published on Friday, Dec 6, 2024 by Pulumi