Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. s3outposts
  5. Bucket

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi
pulumi/pulumi-aws-native

aws-native.s3outposts.Bucket

Explore with Pulumi AI

aws-native logo

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi
pulumi/pulumi-aws-native

    Resource Type Definition for AWS::S3Outposts::Bucket

    Create Bucket Resource

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

    Constructor syntax

    new Bucket(name: string, args: BucketArgs, opts?: CustomResourceOptions);
    @overload
def Bucket(resource_name: str,
           args: BucketArgs,
           opts: Optional[ResourceOptions] = None)

@overload
def Bucket(resource_name: str,
           opts: Optional[ResourceOptions] = None,
           outpost_id: Optional[str] = None,
           bucket_name: Optional[str] = None,
           lifecycle_configuration: Optional[BucketLifecycleConfigurationArgs] = None,
           tags: Optional[Sequence[_root_inputs.TagArgs]] = None)
    func NewBucket(ctx *Context, name string, args BucketArgs, opts ...ResourceOption) (*Bucket, error)
    public Bucket(string name, BucketArgs args, CustomResourceOptions? opts = null)
    public Bucket(String name, BucketArgs args)
public Bucket(String name, BucketArgs args, CustomResourceOptions options)

    type: aws-native:s3outposts:Bucket
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 BucketArgs
    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 BucketArgs
    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 BucketArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args BucketArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args BucketArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Bucket 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 Bucket resource accepts the following input properties:

    OutpostId string
    The id of the customer outpost on which the bucket resides.
    BucketName string
    A name for the bucket.
    LifecycleConfiguration Pulumi.AwsNative.S3Outposts.Inputs.BucketLifecycleConfiguration
    Rules that define how Amazon S3Outposts manages objects during their lifetime.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    An arbitrary set of tags (key-value pairs) for this S3Outposts bucket.
    OutpostId string
    The id of the customer outpost on which the bucket resides.
    BucketName string
    A name for the bucket.
    LifecycleConfiguration BucketLifecycleConfigurationArgs
    Rules that define how Amazon S3Outposts manages objects during their lifetime.
    Tags TagArgs
    An arbitrary set of tags (key-value pairs) for this S3Outposts bucket.
    outpostId String
    The id of the customer outpost on which the bucket resides.
    bucketName String
    A name for the bucket.
    lifecycleConfiguration BucketLifecycleConfiguration
    Rules that define how Amazon S3Outposts manages objects during their lifetime.
    tags List<Tag>
    An arbitrary set of tags (key-value pairs) for this S3Outposts bucket.
    outpostId string
    The id of the customer outpost on which the bucket resides.
    bucketName string
    A name for the bucket.
    lifecycleConfiguration BucketLifecycleConfiguration
    Rules that define how Amazon S3Outposts manages objects during their lifetime.
    tags Tag[]
    An arbitrary set of tags (key-value pairs) for this S3Outposts bucket.
    outpost_id str
    The id of the customer outpost on which the bucket resides.
    bucket_name str
    A name for the bucket.
    lifecycle_configuration BucketLifecycleConfigurationArgs
    Rules that define how Amazon S3Outposts manages objects during their lifetime.
    tags Sequence[TagArgs]
    An arbitrary set of tags (key-value pairs) for this S3Outposts bucket.
    outpostId String
    The id of the customer outpost on which the bucket resides.
    bucketName String
    A name for the bucket.
    lifecycleConfiguration Property Map
    Rules that define how Amazon S3Outposts manages objects during their lifetime.
    tags List<Property Map>
    An arbitrary set of tags (key-value pairs) for this S3Outposts bucket.

    Outputs

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

    Arn string
    The Amazon Resource Name (ARN) of the specified bucket.
    Id string
    The provider-assigned unique ID for this managed resource.
    Arn string
    The Amazon Resource Name (ARN) of the specified bucket.
    Id string
    The provider-assigned unique ID for this managed resource.
    arn String
    The Amazon Resource Name (ARN) of the specified bucket.
    id String
    The provider-assigned unique ID for this managed resource.
    arn string
    The Amazon Resource Name (ARN) of the specified bucket.
    id string
    The provider-assigned unique ID for this managed resource.
    arn str
    The Amazon Resource Name (ARN) of the specified bucket.
    id str
    The provider-assigned unique ID for this managed resource.
    arn String
    The Amazon Resource Name (ARN) of the specified bucket.
    id String
    The provider-assigned unique ID for this managed resource.

    Supporting Types

    BucketAbortIncompleteMultipartUpload, BucketAbortIncompleteMultipartUploadArgs

    DaysAfterInitiation int
    Specifies the number of days after which Amazon S3Outposts aborts an incomplete multipart upload.
    DaysAfterInitiation int
    Specifies the number of days after which Amazon S3Outposts aborts an incomplete multipart upload.
    daysAfterInitiation Integer
    Specifies the number of days after which Amazon S3Outposts aborts an incomplete multipart upload.
    daysAfterInitiation number
    Specifies the number of days after which Amazon S3Outposts aborts an incomplete multipart upload.
    days_after_initiation int
    Specifies the number of days after which Amazon S3Outposts aborts an incomplete multipart upload.
    daysAfterInitiation Number
    Specifies the number of days after which Amazon S3Outposts aborts an incomplete multipart upload.

    BucketFilterAndOperatorProperties, BucketFilterAndOperatorPropertiesArgs

    Tags List<Pulumi.AwsNative.S3Outposts.Inputs.BucketFilterTag>
    All of these tags must exist in the object's tag set in order for the rule to apply.
    Prefix string
    Prefix identifies one or more objects to which the rule applies.
    Tags []BucketFilterTag
    All of these tags must exist in the object's tag set in order for the rule to apply.
    Prefix string
    Prefix identifies one or more objects to which the rule applies.
    tags List<BucketFilterTag>
    All of these tags must exist in the object's tag set in order for the rule to apply.
    prefix String
    Prefix identifies one or more objects to which the rule applies.
    tags BucketFilterTag[]
    All of these tags must exist in the object's tag set in order for the rule to apply.
    prefix string
    Prefix identifies one or more objects to which the rule applies.
    tags Sequence[BucketFilterTag]
    All of these tags must exist in the object's tag set in order for the rule to apply.
    prefix str
    Prefix identifies one or more objects to which the rule applies.
    tags List<Property Map>
    All of these tags must exist in the object's tag set in order for the rule to apply.
    prefix String
    Prefix identifies one or more objects to which the rule applies.

    BucketFilterTag, BucketFilterTagArgs

    Key string
    Value string
    Key string
    Value string
    key String
    value String
    key string
    value string
    key str
    value str
    key String
    value String

    BucketLifecycleConfiguration, BucketLifecycleConfigurationArgs

    Rules List<Pulumi.AwsNative.S3Outposts.Inputs.BucketRule>
    A list of lifecycle rules for individual objects in an Amazon S3Outposts bucket.
    Rules []BucketRule
    A list of lifecycle rules for individual objects in an Amazon S3Outposts bucket.
    rules List<BucketRule>
    A list of lifecycle rules for individual objects in an Amazon S3Outposts bucket.
    rules BucketRule[]
    A list of lifecycle rules for individual objects in an Amazon S3Outposts bucket.
    rules Sequence[BucketRule]
    A list of lifecycle rules for individual objects in an Amazon S3Outposts bucket.
    rules List<Property Map>
    A list of lifecycle rules for individual objects in an Amazon S3Outposts bucket.

    BucketRule, BucketRuleArgs

    AbortIncompleteMultipartUpload Pulumi.AwsNative.S3Outposts.Inputs.BucketAbortIncompleteMultipartUpload
    Specifies a lifecycle rule that stops incomplete multipart uploads to an Amazon S3Outposts bucket.
    ExpirationDate string
    Indicates when objects are deleted from Amazon S3Outposts. The date value must be in ISO 8601 format. The time is always midnight UTC.
    ExpirationInDays int
    Indicates the number of days after creation when objects are deleted from Amazon S3Outposts.
    Filter Pulumi.AwsNative.S3Outposts.Inputs.BucketRuleFilterProperties
    The container for the filter of the lifecycle rule.
    Id string
    Unique identifier for the lifecycle rule. The value can't be longer than 255 characters.
    Status Pulumi.AwsNative.S3Outposts.BucketRuleStatus
    If Enabled , the rule is currently being applied. If Disabled , the rule is not currently being applied.
    AbortIncompleteMultipartUpload BucketAbortIncompleteMultipartUpload
    Specifies a lifecycle rule that stops incomplete multipart uploads to an Amazon S3Outposts bucket.
    ExpirationDate string
    Indicates when objects are deleted from Amazon S3Outposts. The date value must be in ISO 8601 format. The time is always midnight UTC.
    ExpirationInDays int
    Indicates the number of days after creation when objects are deleted from Amazon S3Outposts.
    Filter BucketRuleFilterProperties
    The container for the filter of the lifecycle rule.
    Id string
    Unique identifier for the lifecycle rule. The value can't be longer than 255 characters.
    Status BucketRuleStatus
    If Enabled , the rule is currently being applied. If Disabled , the rule is not currently being applied.
    abortIncompleteMultipartUpload BucketAbortIncompleteMultipartUpload
    Specifies a lifecycle rule that stops incomplete multipart uploads to an Amazon S3Outposts bucket.
    expirationDate String
    Indicates when objects are deleted from Amazon S3Outposts. The date value must be in ISO 8601 format. The time is always midnight UTC.
    expirationInDays Integer
    Indicates the number of days after creation when objects are deleted from Amazon S3Outposts.
    filter BucketRuleFilterProperties
    The container for the filter of the lifecycle rule.
    id String
    Unique identifier for the lifecycle rule. The value can't be longer than 255 characters.
    status BucketRuleStatus
    If Enabled , the rule is currently being applied. If Disabled , the rule is not currently being applied.
    abortIncompleteMultipartUpload BucketAbortIncompleteMultipartUpload
    Specifies a lifecycle rule that stops incomplete multipart uploads to an Amazon S3Outposts bucket.
    expirationDate string
    Indicates when objects are deleted from Amazon S3Outposts. The date value must be in ISO 8601 format. The time is always midnight UTC.
    expirationInDays number
    Indicates the number of days after creation when objects are deleted from Amazon S3Outposts.
    filter BucketRuleFilterProperties
    The container for the filter of the lifecycle rule.
    id string
    Unique identifier for the lifecycle rule. The value can't be longer than 255 characters.
    status BucketRuleStatus
    If Enabled , the rule is currently being applied. If Disabled , the rule is not currently being applied.
    abort_incomplete_multipart_upload BucketAbortIncompleteMultipartUpload
    Specifies a lifecycle rule that stops incomplete multipart uploads to an Amazon S3Outposts bucket.
    expiration_date str
    Indicates when objects are deleted from Amazon S3Outposts. The date value must be in ISO 8601 format. The time is always midnight UTC.
    expiration_in_days int
    Indicates the number of days after creation when objects are deleted from Amazon S3Outposts.
    filter BucketRuleFilterProperties
    The container for the filter of the lifecycle rule.
    id str
    Unique identifier for the lifecycle rule. The value can't be longer than 255 characters.
    status BucketRuleStatus
    If Enabled , the rule is currently being applied. If Disabled , the rule is not currently being applied.
    abortIncompleteMultipartUpload Property Map
    Specifies a lifecycle rule that stops incomplete multipart uploads to an Amazon S3Outposts bucket.
    expirationDate String
    Indicates when objects are deleted from Amazon S3Outposts. The date value must be in ISO 8601 format. The time is always midnight UTC.
    expirationInDays Number
    Indicates the number of days after creation when objects are deleted from Amazon S3Outposts.
    filter Property Map
    The container for the filter of the lifecycle rule.
    id String
    Unique identifier for the lifecycle rule. The value can't be longer than 255 characters.
    status "Enabled" | "Disabled"
    If Enabled , the rule is currently being applied. If Disabled , the rule is not currently being applied.

    BucketRuleFilterProperties, BucketRuleFilterPropertiesArgs

    AndOperator Pulumi.AwsNative.S3Outposts.Inputs.BucketFilterAndOperatorProperties
    The container for the AND condition for the lifecycle rule. A combination of Prefix and 1 or more Tags OR a minimum of 2 or more tags.
    Prefix string
    Object key prefix that identifies one or more objects to which this rule applies.
    Tag Pulumi.AwsNative.S3Outposts.Inputs.BucketFilterTag
    Specifies a tag used to identify a subset of objects for an Amazon S3Outposts bucket.
    AndOperator BucketFilterAndOperatorProperties
    The container for the AND condition for the lifecycle rule. A combination of Prefix and 1 or more Tags OR a minimum of 2 or more tags.
    Prefix string
    Object key prefix that identifies one or more objects to which this rule applies.
    Tag BucketFilterTag
    Specifies a tag used to identify a subset of objects for an Amazon S3Outposts bucket.
    andOperator BucketFilterAndOperatorProperties
    The container for the AND condition for the lifecycle rule. A combination of Prefix and 1 or more Tags OR a minimum of 2 or more tags.
    prefix String
    Object key prefix that identifies one or more objects to which this rule applies.
    tag BucketFilterTag
    Specifies a tag used to identify a subset of objects for an Amazon S3Outposts bucket.
    andOperator BucketFilterAndOperatorProperties
    The container for the AND condition for the lifecycle rule. A combination of Prefix and 1 or more Tags OR a minimum of 2 or more tags.
    prefix string
    Object key prefix that identifies one or more objects to which this rule applies.
    tag BucketFilterTag
    Specifies a tag used to identify a subset of objects for an Amazon S3Outposts bucket.
    and_operator BucketFilterAndOperatorProperties
    The container for the AND condition for the lifecycle rule. A combination of Prefix and 1 or more Tags OR a minimum of 2 or more tags.
    prefix str
    Object key prefix that identifies one or more objects to which this rule applies.
    tag BucketFilterTag
    Specifies a tag used to identify a subset of objects for an Amazon S3Outposts bucket.
    andOperator Property Map
    The container for the AND condition for the lifecycle rule. A combination of Prefix and 1 or more Tags OR a minimum of 2 or more tags.
    prefix String
    Object key prefix that identifies one or more objects to which this rule applies.
    tag Property Map
    Specifies a tag used to identify a subset of objects for an Amazon S3Outposts bucket.

    BucketRuleStatus, BucketRuleStatusArgs

    Enabled
    Enabled
    Disabled
    Disabled
    BucketRuleStatusEnabled
    Enabled
    BucketRuleStatusDisabled
    Disabled
    Enabled
    Enabled
    Disabled
    Disabled
    Enabled
    Enabled
    Disabled
    Disabled
    ENABLED
    Enabled
    DISABLED
    Disabled
    "Enabled"
    Enabled
    "Disabled"
    Disabled

    Tag, TagArgs

    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    AWS Cloud Control v1.28.0 published on Monday, May 19, 2025 by Pulumi
    pulumi/pulumi-aws-native