DigitalOcean v4.22.0, Sep 22 23

DigitalOcean v4.22.0 published on Friday, Sep 22, 2023 by Pulumi

digitalocean.SpacesBucket

Explore with Pulumi AI

DigitalOcean v4.22.0 published on Friday, Sep 22, 2023 by Pulumi

The Spaces API was designed to be interoperable with Amazon’s AWS S3 API. This allows users to interact with the service while using the tools they already know. Spaces mirrors S3’s authentication framework and requests to Spaces require a key pair similar to Amazon’s Access ID and Secret Key.

The authentication requirement can be met by either setting the SPACES_ACCESS_KEY_ID and SPACES_SECRET_ACCESS_KEY environment variables or the provider’s spaces_access_id and spaces_secret_key arguments to the access ID and secret you generate via the DigitalOcean control panel. For example:

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

const static_assets = new digitalocean.SpacesBucket("static-assets", {});
// ...

import pulumi
import pulumi_digitalocean as digitalocean

static_assets = digitalocean.SpacesBucket("static-assets")
# ...

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

return await Deployment.RunAsync(() => 
{
    var static_assets = new DigitalOcean.SpacesBucket("static-assets");

    // ...
});

package main

import (
	"github.com/pulumi/pulumi-digitalocean/sdk/v4/go/digitalocean"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := digitalocean.NewSpacesBucket(ctx, "static-assets", 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.digitalocean.SpacesBucket;
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 static_assets = new SpacesBucket("static-assets");

    }
}

resources:
  static-assets:
    type: digitalocean:SpacesBucket

For more information, See An Introduction to DigitalOcean Spaces

Example Usage

Create a New Bucket

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

return await Deployment.RunAsync(() => 
{
    var foobar = new DigitalOcean.SpacesBucket("foobar", new()
    {
        Region = "nyc3",
    });

});

package main

import (
	"github.com/pulumi/pulumi-digitalocean/sdk/v4/go/digitalocean"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := digitalocean.NewSpacesBucket(ctx, "foobar", &digitalocean.SpacesBucketArgs{
			Region: pulumi.String("nyc3"),
		})
		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.digitalocean.SpacesBucket;
import com.pulumi.digitalocean.SpacesBucketArgs;
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 foobar = new SpacesBucket("foobar", SpacesBucketArgs.builder()        
            .region("nyc3")
            .build());

    }
}

import pulumi
import pulumi_digitalocean as digitalocean

foobar = digitalocean.SpacesBucket("foobar", region="nyc3")

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

const foobar = new digitalocean.SpacesBucket("foobar", {region: "nyc3"});

resources:
  foobar:
    type: digitalocean:SpacesBucket
    properties:
      region: nyc3

Create a New Bucket With CORS Rules

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

return await Deployment.RunAsync(() => 
{
    var foobar = new DigitalOcean.SpacesBucket("foobar", new()
    {
        CorsRules = new[]
        {
            new DigitalOcean.Inputs.SpacesBucketCorsRuleArgs
            {
                AllowedHeaders = new[]
                {
                    "*",
                },
                AllowedMethods = new[]
                {
                    "GET",
                },
                AllowedOrigins = new[]
                {
                    "*",
                },
                MaxAgeSeconds = 3000,
            },
            new DigitalOcean.Inputs.SpacesBucketCorsRuleArgs
            {
                AllowedHeaders = new[]
                {
                    "*",
                },
                AllowedMethods = new[]
                {
                    "PUT",
                    "POST",
                    "DELETE",
                },
                AllowedOrigins = new[]
                {
                    "https://www.example.com",
                },
                MaxAgeSeconds = 3000,
            },
        },
        Region = "nyc3",
    });

});

package main

import (
	"github.com/pulumi/pulumi-digitalocean/sdk/v4/go/digitalocean"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := digitalocean.NewSpacesBucket(ctx, "foobar", &digitalocean.SpacesBucketArgs{
			CorsRules: digitalocean.SpacesBucketCorsRuleArray{
				&digitalocean.SpacesBucketCorsRuleArgs{
					AllowedHeaders: pulumi.StringArray{
						pulumi.String("*"),
					},
					AllowedMethods: pulumi.StringArray{
						pulumi.String("GET"),
					},
					AllowedOrigins: pulumi.StringArray{
						pulumi.String("*"),
					},
					MaxAgeSeconds: pulumi.Int(3000),
				},
				&digitalocean.SpacesBucketCorsRuleArgs{
					AllowedHeaders: pulumi.StringArray{
						pulumi.String("*"),
					},
					AllowedMethods: pulumi.StringArray{
						pulumi.String("PUT"),
						pulumi.String("POST"),
						pulumi.String("DELETE"),
					},
					AllowedOrigins: pulumi.StringArray{
						pulumi.String("https://www.example.com"),
					},
					MaxAgeSeconds: pulumi.Int(3000),
				},
			},
			Region: pulumi.String("nyc3"),
		})
		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.digitalocean.SpacesBucket;
import com.pulumi.digitalocean.SpacesBucketArgs;
import com.pulumi.digitalocean.inputs.SpacesBucketCorsRuleArgs;
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 foobar = new SpacesBucket("foobar", SpacesBucketArgs.builder()        
            .corsRules(            
                SpacesBucketCorsRuleArgs.builder()
                    .allowedHeaders("*")
                    .allowedMethods("GET")
                    .allowedOrigins("*")
                    .maxAgeSeconds(3000)
                    .build(),
                SpacesBucketCorsRuleArgs.builder()
                    .allowedHeaders("*")
                    .allowedMethods(                    
                        "PUT",
                        "POST",
                        "DELETE")
                    .allowedOrigins("https://www.example.com")
                    .maxAgeSeconds(3000)
                    .build())
            .region("nyc3")
            .build());

    }
}

import pulumi
import pulumi_digitalocean as digitalocean

foobar = digitalocean.SpacesBucket("foobar",
    cors_rules=[
        digitalocean.SpacesBucketCorsRuleArgs(
            allowed_headers=["*"],
            allowed_methods=["GET"],
            allowed_origins=["*"],
            max_age_seconds=3000,
        ),
        digitalocean.SpacesBucketCorsRuleArgs(
            allowed_headers=["*"],
            allowed_methods=[
                "PUT",
                "POST",
                "DELETE",
            ],
            allowed_origins=["https://www.example.com"],
            max_age_seconds=3000,
        ),
    ],
    region="nyc3")

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

const foobar = new digitalocean.SpacesBucket("foobar", {
    corsRules: [
        {
            allowedHeaders: ["*"],
            allowedMethods: ["GET"],
            allowedOrigins: ["*"],
            maxAgeSeconds: 3000,
        },
        {
            allowedHeaders: ["*"],
            allowedMethods: [
                "PUT",
                "POST",
                "DELETE",
            ],
            allowedOrigins: ["https://www.example.com"],
            maxAgeSeconds: 3000,
        },
    ],
    region: "nyc3",
});

resources:
  foobar:
    type: digitalocean:SpacesBucket
    properties:
      corsRules:
        - allowedHeaders:
            - '*'
          allowedMethods:
            - GET
          allowedOrigins:
            - '*'
          maxAgeSeconds: 3000
        - allowedHeaders:
            - '*'
          allowedMethods:
            - PUT
            - POST
            - DELETE
          allowedOrigins:
            - https://www.example.com
          maxAgeSeconds: 3000
      region: nyc3

Create SpacesBucket Resource

new SpacesBucket(name: string, args?: SpacesBucketArgs, opts?: CustomResourceOptions);

@overload
def SpacesBucket(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 acl: Optional[str] = None,
                 cors_rules: Optional[Sequence[SpacesBucketCorsRuleArgs]] = None,
                 force_destroy: Optional[bool] = None,
                 lifecycle_rules: Optional[Sequence[SpacesBucketLifecycleRuleArgs]] = None,
                 name: Optional[str] = None,
                 region: Optional[Union[str, Region]] = None,
                 versioning: Optional[SpacesBucketVersioningArgs] = None)
@overload
def SpacesBucket(resource_name: str,
                 args: Optional[SpacesBucketArgs] = None,
                 opts: Optional[ResourceOptions] = None)

func NewSpacesBucket(ctx *Context, name string, args *SpacesBucketArgs, opts ...ResourceOption) (*SpacesBucket, error)

public SpacesBucket(string name, SpacesBucketArgs? args = null, CustomResourceOptions? opts = null)

public SpacesBucket(String name, SpacesBucketArgs args)
public SpacesBucket(String name, SpacesBucketArgs args, CustomResourceOptions options)

type: digitalocean:SpacesBucket
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

name string: The unique name of the resource.
args SpacesBucketArgs: 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 SpacesBucketArgs: 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 SpacesBucketArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

name string: The unique name of the resource.
args SpacesBucketArgs: The arguments to resource properties.
opts CustomResourceOptions: Bag of options to control resource's behavior.

name String: The unique name of the resource.
args SpacesBucketArgs: The arguments to resource properties.
options CustomResourceOptions: Bag of options to control resource's behavior.

SpacesBucket Resource Properties

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

Inputs

The SpacesBucket resource accepts the following input properties:

Acl string

Canned ACL applied on bucket creation (private or public-read)

CorsRules List<Pulumi.DigitalOcean.Inputs.SpacesBucketCorsRule>

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

ForceDestroy bool

Unless true, the bucket will only be destroyed if empty (Defaults to false)

LifecycleRules List<Pulumi.DigitalOcean.Inputs.SpacesBucketLifecycleRule>

A configuration of object lifecycle management (documented below).

Name string

The name of the bucket

Region string | Pulumi.DigitalOcean.Region

The region where the bucket resides (Defaults to nyc3)

Versioning Pulumi.DigitalOcean.Inputs.SpacesBucketVersioning

A state of versioning (documented below)

Acl string

Canned ACL applied on bucket creation (private or public-read)

CorsRules []SpacesBucketCorsRuleArgs

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

ForceDestroy bool

Unless true, the bucket will only be destroyed if empty (Defaults to false)

LifecycleRules []SpacesBucketLifecycleRuleArgs

A configuration of object lifecycle management (documented below).

Name string

The name of the bucket

Region string | Region

The region where the bucket resides (Defaults to nyc3)

Versioning SpacesBucketVersioningArgs

A state of versioning (documented below)

acl String

Canned ACL applied on bucket creation (private or public-read)

corsRules List<SpacesBucketCorsRule>

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

forceDestroy Boolean

Unless true, the bucket will only be destroyed if empty (Defaults to false)

lifecycleRules List<SpacesBucketLifecycleRule>

A configuration of object lifecycle management (documented below).

name String

The name of the bucket

region String | Region

The region where the bucket resides (Defaults to nyc3)

versioning SpacesBucketVersioning

A state of versioning (documented below)

acl string

Canned ACL applied on bucket creation (private or public-read)

corsRules SpacesBucketCorsRule[]

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

forceDestroy boolean

Unless true, the bucket will only be destroyed if empty (Defaults to false)

lifecycleRules SpacesBucketLifecycleRule[]

A configuration of object lifecycle management (documented below).

name string

The name of the bucket

region string | Region

The region where the bucket resides (Defaults to nyc3)

versioning SpacesBucketVersioning

A state of versioning (documented below)

acl str

Canned ACL applied on bucket creation (private or public-read)

cors_rules Sequence[SpacesBucketCorsRuleArgs]

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

force_destroy bool

Unless true, the bucket will only be destroyed if empty (Defaults to false)

lifecycle_rules Sequence[SpacesBucketLifecycleRuleArgs]

A configuration of object lifecycle management (documented below).

name str

The name of the bucket

region str | Region

The region where the bucket resides (Defaults to nyc3)

versioning SpacesBucketVersioningArgs

A state of versioning (documented below)

acl String

Canned ACL applied on bucket creation (private or public-read)

corsRules List<Property Map>

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

forceDestroy Boolean

Unless true, the bucket will only be destroyed if empty (Defaults to false)

lifecycleRules List<Property Map>

A configuration of object lifecycle management (documented below).

name String

The name of the bucket

region String | "nyc1" | "nyc2" | "nyc3" | "sgp1" | "lon1" | "ams2" | "ams3" | "fra1" | "tor1" | "sfo1" | "sfo2" | "sfo3" | "blr1"

The region where the bucket resides (Defaults to nyc3)

versioning Property Map

A state of versioning (documented below)

Outputs

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

BucketDomainName string: The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)
BucketUrn string: The uniform resource name for the bucket
Endpoint string: The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)
Id string: The provider-assigned unique ID for this managed resource.

BucketDomainName string: The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)
BucketUrn string: The uniform resource name for the bucket
Endpoint string: The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)
Id string: The provider-assigned unique ID for this managed resource.

bucketDomainName String: The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)
bucketUrn String: The uniform resource name for the bucket
endpoint String: The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)
id String: The provider-assigned unique ID for this managed resource.

bucketDomainName string: The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)
bucketUrn string: The uniform resource name for the bucket
endpoint string: The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)
id string: The provider-assigned unique ID for this managed resource.

bucket_domain_name str: The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)
bucket_urn str: The uniform resource name for the bucket
endpoint str: The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)
id str: The provider-assigned unique ID for this managed resource.

bucketDomainName String: The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)
bucketUrn String: The uniform resource name for the bucket
endpoint String: The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)
id String: The provider-assigned unique ID for this managed resource.

Look up Existing SpacesBucket Resource

Get an existing SpacesBucket 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?: SpacesBucketState, opts?: CustomResourceOptions): SpacesBucket

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        acl: Optional[str] = None,
        bucket_domain_name: Optional[str] = None,
        bucket_urn: Optional[str] = None,
        cors_rules: Optional[Sequence[SpacesBucketCorsRuleArgs]] = None,
        endpoint: Optional[str] = None,
        force_destroy: Optional[bool] = None,
        lifecycle_rules: Optional[Sequence[SpacesBucketLifecycleRuleArgs]] = None,
        name: Optional[str] = None,
        region: Optional[Union[str, Region]] = None,
        versioning: Optional[SpacesBucketVersioningArgs] = None) -> SpacesBucket

func GetSpacesBucket(ctx *Context, name string, id IDInput, state *SpacesBucketState, opts ...ResourceOption) (*SpacesBucket, error)

public static SpacesBucket Get(string name, Input<string> id, SpacesBucketState? state, CustomResourceOptions? opts = null)

public static SpacesBucket get(String name, Output<String> id, SpacesBucketState 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:

Acl string

Canned ACL applied on bucket creation (private or public-read)

BucketDomainName string

The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)

BucketUrn string

The uniform resource name for the bucket

CorsRules List<Pulumi.DigitalOcean.Inputs.SpacesBucketCorsRule>

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

Endpoint string

The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)

ForceDestroy bool

Unless true, the bucket will only be destroyed if empty (Defaults to false)

LifecycleRules List<Pulumi.DigitalOcean.Inputs.SpacesBucketLifecycleRule>

A configuration of object lifecycle management (documented below).

Name string

The name of the bucket

Region string | Pulumi.DigitalOcean.Region

The region where the bucket resides (Defaults to nyc3)

Versioning Pulumi.DigitalOcean.Inputs.SpacesBucketVersioning

A state of versioning (documented below)

Acl string

Canned ACL applied on bucket creation (private or public-read)

BucketDomainName string

The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)

BucketUrn string

The uniform resource name for the bucket

CorsRules []SpacesBucketCorsRuleArgs

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

Endpoint string

The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)

ForceDestroy bool

Unless true, the bucket will only be destroyed if empty (Defaults to false)

LifecycleRules []SpacesBucketLifecycleRuleArgs

A configuration of object lifecycle management (documented below).

Name string

The name of the bucket

Region string | Region

The region where the bucket resides (Defaults to nyc3)

Versioning SpacesBucketVersioningArgs

A state of versioning (documented below)

acl String

Canned ACL applied on bucket creation (private or public-read)

bucketDomainName String

The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)

bucketUrn String

The uniform resource name for the bucket

corsRules List<SpacesBucketCorsRule>

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

endpoint String

The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)

forceDestroy Boolean

Unless true, the bucket will only be destroyed if empty (Defaults to false)

lifecycleRules List<SpacesBucketLifecycleRule>

A configuration of object lifecycle management (documented below).

name String

The name of the bucket

region String | Region

The region where the bucket resides (Defaults to nyc3)

versioning SpacesBucketVersioning

A state of versioning (documented below)

acl string

Canned ACL applied on bucket creation (private or public-read)

bucketDomainName string

The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)

bucketUrn string

The uniform resource name for the bucket

corsRules SpacesBucketCorsRule[]

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

endpoint string

The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)

forceDestroy boolean

Unless true, the bucket will only be destroyed if empty (Defaults to false)

lifecycleRules SpacesBucketLifecycleRule[]

A configuration of object lifecycle management (documented below).

name string

The name of the bucket

region string | Region

The region where the bucket resides (Defaults to nyc3)

versioning SpacesBucketVersioning

A state of versioning (documented below)

acl str

Canned ACL applied on bucket creation (private or public-read)

bucket_domain_name str

The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)

bucket_urn str

The uniform resource name for the bucket

cors_rules Sequence[SpacesBucketCorsRuleArgs]

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

endpoint str

The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)

force_destroy bool

Unless true, the bucket will only be destroyed if empty (Defaults to false)

lifecycle_rules Sequence[SpacesBucketLifecycleRuleArgs]

A configuration of object lifecycle management (documented below).

name str

The name of the bucket

region str | Region

The region where the bucket resides (Defaults to nyc3)

versioning SpacesBucketVersioningArgs

A state of versioning (documented below)

acl String

Canned ACL applied on bucket creation (private or public-read)

bucketDomainName String

The FQDN of the bucket (e.g. bucket-name.nyc3.digitaloceanspaces.com)

bucketUrn String

The uniform resource name for the bucket

corsRules List<Property Map>

A rule of Cross-Origin Resource Sharing (documented below).

Deprecated:

Terraform will only perform drift detection if a configuration value is provided. Use the resource digitalocean_spaces_bucket_cors_configuration instead.

endpoint String

The FQDN of the bucket without the bucket name (e.g. nyc3.digitaloceanspaces.com)

forceDestroy Boolean

Unless true, the bucket will only be destroyed if empty (Defaults to false)

lifecycleRules List<Property Map>

A configuration of object lifecycle management (documented below).

name String

The name of the bucket

region String | "nyc1" | "nyc2" | "nyc3" | "sgp1" | "lon1" | "ams2" | "ams3" | "fra1" | "tor1" | "sfo1" | "sfo2" | "sfo3" | "blr1"

The region where the bucket resides (Defaults to nyc3)

versioning Property Map

A state of versioning (documented below)

Supporting Types

Region, RegionArgs

NYC1: nyc1
NYC2: nyc2
NYC3: nyc3
SGP1: sgp1
LON1: lon1
AMS2: ams2
AMS3: ams3
FRA1: fra1
TOR1: tor1
SFO1: sfo1
SFO2: sfo2
SFO3: sfo3
BLR1: blr1

RegionNYC1: nyc1
RegionNYC2: nyc2
RegionNYC3: nyc3
RegionSGP1: sgp1
RegionLON1: lon1
RegionAMS2: ams2
RegionAMS3: ams3
RegionFRA1: fra1
RegionTOR1: tor1
RegionSFO1: sfo1
RegionSFO2: sfo2
RegionSFO3: sfo3
RegionBLR1: blr1

NYC1: nyc1
NYC2: nyc2
NYC3: nyc3
SGP1: sgp1
LON1: lon1
AMS2: ams2
AMS3: ams3
FRA1: fra1
TOR1: tor1
SFO1: sfo1
SFO2: sfo2
SFO3: sfo3
BLR1: blr1

NYC1: nyc1
NYC2: nyc2
NYC3: nyc3
SGP1: sgp1
LON1: lon1
AMS2: ams2
AMS3: ams3
FRA1: fra1
TOR1: tor1
SFO1: sfo1
SFO2: sfo2
SFO3: sfo3
BLR1: blr1

NYC1: nyc1
NYC2: nyc2
NYC3: nyc3
SGP1: sgp1
LON1: lon1
AMS2: ams2
AMS3: ams3
FRA1: fra1
TOR1: tor1
SFO1: sfo1
SFO2: sfo2
SFO3: sfo3
BLR1: blr1

"nyc1": nyc1
"nyc2": nyc2
"nyc3": nyc3
"sgp1": sgp1
"lon1": lon1
"ams2": ams2
"ams3": ams3
"fra1": fra1
"tor1": tor1
"sfo1": sfo1
"sfo2": sfo2
"sfo3": sfo3
"blr1": blr1

SpacesBucketCorsRule, SpacesBucketCorsRuleArgs

AllowedMethods List<string>: A list of HTTP methods (e.g. GET) which are allowed from the specified origin.
AllowedOrigins List<string>: A list of hosts from which requests using the specified methods are allowed. A host may contain one wildcard (e.g. http://*.example.com).
AllowedHeaders List<string>: A list of headers that will be included in the CORS preflight request's Access-Control-Request-Headers. A header may contain one wildcard (e.g. x-amz-*).
MaxAgeSeconds int: The time in seconds that browser can cache the response for a preflight request.

AllowedMethods []string: A list of HTTP methods (e.g. GET) which are allowed from the specified origin.
AllowedOrigins []string: A list of hosts from which requests using the specified methods are allowed. A host may contain one wildcard (e.g. http://*.example.com).
AllowedHeaders []string: A list of headers that will be included in the CORS preflight request's Access-Control-Request-Headers. A header may contain one wildcard (e.g. x-amz-*).
MaxAgeSeconds int: The time in seconds that browser can cache the response for a preflight request.

allowedMethods List<String>: A list of HTTP methods (e.g. GET) which are allowed from the specified origin.
allowedOrigins List<String>: A list of hosts from which requests using the specified methods are allowed. A host may contain one wildcard (e.g. http://*.example.com).
allowedHeaders List<String>: A list of headers that will be included in the CORS preflight request's Access-Control-Request-Headers. A header may contain one wildcard (e.g. x-amz-*).
maxAgeSeconds Integer: The time in seconds that browser can cache the response for a preflight request.

allowedMethods string[]: A list of HTTP methods (e.g. GET) which are allowed from the specified origin.
allowedOrigins string[]: A list of hosts from which requests using the specified methods are allowed. A host may contain one wildcard (e.g. http://*.example.com).
allowedHeaders string[]: A list of headers that will be included in the CORS preflight request's Access-Control-Request-Headers. A header may contain one wildcard (e.g. x-amz-*).
maxAgeSeconds number: The time in seconds that browser can cache the response for a preflight request.

allowed_methods Sequence[str]: A list of HTTP methods (e.g. GET) which are allowed from the specified origin.
allowed_origins Sequence[str]: A list of hosts from which requests using the specified methods are allowed. A host may contain one wildcard (e.g. http://*.example.com).
allowed_headers Sequence[str]: A list of headers that will be included in the CORS preflight request's Access-Control-Request-Headers. A header may contain one wildcard (e.g. x-amz-*).
max_age_seconds int: The time in seconds that browser can cache the response for a preflight request.

allowedMethods List<String>: A list of HTTP methods (e.g. GET) which are allowed from the specified origin.
allowedOrigins List<String>: A list of hosts from which requests using the specified methods are allowed. A host may contain one wildcard (e.g. http://*.example.com).
allowedHeaders List<String>: A list of headers that will be included in the CORS preflight request's Access-Control-Request-Headers. A header may contain one wildcard (e.g. x-amz-*).
maxAgeSeconds Number: The time in seconds that browser can cache the response for a preflight request.

SpacesBucketLifecycleRule, SpacesBucketLifecycleRuleArgs

Enabled bool

Specifies lifecycle rule status.

AbortIncompleteMultipartUploadDays int

Specifies the number of days after initiating a multipart upload when the multipart upload must be completed or else Spaces will abort the upload.

Expiration Pulumi.DigitalOcean.Inputs.SpacesBucketLifecycleRuleExpiration

Specifies a time period after which applicable objects expire (documented below).

Id string

Unique identifier for the rule.

NoncurrentVersionExpiration Pulumi.DigitalOcean.Inputs.SpacesBucketLifecycleRuleNoncurrentVersionExpiration

Specifies when non-current object versions expire (documented below).

At least one of expiration or noncurrent_version_expiration must be specified.

Prefix string

Object key prefix identifying one or more objects to which the rule applies.

Enabled bool

Specifies lifecycle rule status.

AbortIncompleteMultipartUploadDays int

Specifies the number of days after initiating a multipart upload when the multipart upload must be completed or else Spaces will abort the upload.

Expiration SpacesBucketLifecycleRuleExpiration

Specifies a time period after which applicable objects expire (documented below).

Id string

Unique identifier for the rule.

NoncurrentVersionExpiration SpacesBucketLifecycleRuleNoncurrentVersionExpiration

Specifies when non-current object versions expire (documented below).

At least one of expiration or noncurrent_version_expiration must be specified.

Prefix string

Object key prefix identifying one or more objects to which the rule applies.

enabled Boolean

Specifies lifecycle rule status.

abortIncompleteMultipartUploadDays Integer

Specifies the number of days after initiating a multipart upload when the multipart upload must be completed or else Spaces will abort the upload.

expiration SpacesBucketLifecycleRuleExpiration

Specifies a time period after which applicable objects expire (documented below).

id String

Unique identifier for the rule.

noncurrentVersionExpiration SpacesBucketLifecycleRuleNoncurrentVersionExpiration

Specifies when non-current object versions expire (documented below).

At least one of expiration or noncurrent_version_expiration must be specified.

prefix String

Object key prefix identifying one or more objects to which the rule applies.

enabled boolean

Specifies lifecycle rule status.

abortIncompleteMultipartUploadDays number

Specifies the number of days after initiating a multipart upload when the multipart upload must be completed or else Spaces will abort the upload.

expiration SpacesBucketLifecycleRuleExpiration

Specifies a time period after which applicable objects expire (documented below).

id string

Unique identifier for the rule.

noncurrentVersionExpiration SpacesBucketLifecycleRuleNoncurrentVersionExpiration

Specifies when non-current object versions expire (documented below).

At least one of expiration or noncurrent_version_expiration must be specified.

prefix string

Object key prefix identifying one or more objects to which the rule applies.

enabled bool

Specifies lifecycle rule status.

abort_incomplete_multipart_upload_days int

Specifies the number of days after initiating a multipart upload when the multipart upload must be completed or else Spaces will abort the upload.

expiration SpacesBucketLifecycleRuleExpiration

Specifies a time period after which applicable objects expire (documented below).

id str

Unique identifier for the rule.

noncurrent_version_expiration SpacesBucketLifecycleRuleNoncurrentVersionExpiration

Specifies when non-current object versions expire (documented below).

At least one of expiration or noncurrent_version_expiration must be specified.

prefix str

Object key prefix identifying one or more objects to which the rule applies.

enabled Boolean

Specifies lifecycle rule status.

abortIncompleteMultipartUploadDays Number

Specifies the number of days after initiating a multipart upload when the multipart upload must be completed or else Spaces will abort the upload.

expiration Property Map

Specifies a time period after which applicable objects expire (documented below).

id String

Unique identifier for the rule.

noncurrentVersionExpiration Property Map

Specifies when non-current object versions expire (documented below).

At least one of expiration or noncurrent_version_expiration must be specified.

prefix String

Object key prefix identifying one or more objects to which the rule applies.

SpacesBucketLifecycleRuleExpiration, SpacesBucketLifecycleRuleExpirationArgs

Date string: Specifies the date/time after which you want applicable objects to expire. The argument uses RFC3339 format, e.g. "2020-03-22T15:03:55Z" or parts thereof e.g. "2019-02-28".
Days int: Specifies the number of days after object creation when the applicable objects will expire.
ExpiredObjectDeleteMarker bool: On a versioned bucket (versioning-enabled or versioning-suspended bucket), setting this to true directs Spaces to delete expired object delete markers.

Date string: Specifies the date/time after which you want applicable objects to expire. The argument uses RFC3339 format, e.g. "2020-03-22T15:03:55Z" or parts thereof e.g. "2019-02-28".
Days int: Specifies the number of days after object creation when the applicable objects will expire.
ExpiredObjectDeleteMarker bool: On a versioned bucket (versioning-enabled or versioning-suspended bucket), setting this to true directs Spaces to delete expired object delete markers.

date String: Specifies the date/time after which you want applicable objects to expire. The argument uses RFC3339 format, e.g. "2020-03-22T15:03:55Z" or parts thereof e.g. "2019-02-28".
days Integer: Specifies the number of days after object creation when the applicable objects will expire.
expiredObjectDeleteMarker Boolean: On a versioned bucket (versioning-enabled or versioning-suspended bucket), setting this to true directs Spaces to delete expired object delete markers.

date string: Specifies the date/time after which you want applicable objects to expire. The argument uses RFC3339 format, e.g. "2020-03-22T15:03:55Z" or parts thereof e.g. "2019-02-28".
days number: Specifies the number of days after object creation when the applicable objects will expire.
expiredObjectDeleteMarker boolean: On a versioned bucket (versioning-enabled or versioning-suspended bucket), setting this to true directs Spaces to delete expired object delete markers.

date str: Specifies the date/time after which you want applicable objects to expire. The argument uses RFC3339 format, e.g. "2020-03-22T15:03:55Z" or parts thereof e.g. "2019-02-28".
days int: Specifies the number of days after object creation when the applicable objects will expire.
expired_object_delete_marker bool: On a versioned bucket (versioning-enabled or versioning-suspended bucket), setting this to true directs Spaces to delete expired object delete markers.

date String: Specifies the date/time after which you want applicable objects to expire. The argument uses RFC3339 format, e.g. "2020-03-22T15:03:55Z" or parts thereof e.g. "2019-02-28".
days Number: Specifies the number of days after object creation when the applicable objects will expire.
expiredObjectDeleteMarker Boolean: On a versioned bucket (versioning-enabled or versioning-suspended bucket), setting this to true directs Spaces to delete expired object delete markers.

SpacesBucketLifecycleRuleNoncurrentVersionExpiration, SpacesBucketLifecycleRuleNoncurrentVersionExpirationArgs

Days int: Specifies the number of days after which an object's non-current versions expire.

Days int: Specifies the number of days after which an object's non-current versions expire.

days Integer: Specifies the number of days after which an object's non-current versions expire.

days number: Specifies the number of days after which an object's non-current versions expire.

days int: Specifies the number of days after which an object's non-current versions expire.

days Number: Specifies the number of days after which an object's non-current versions expire.

SpacesBucketVersioning, SpacesBucketVersioningArgs

Enabled bool: Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.

Enabled bool: Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.

enabled Boolean: Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.

enabled boolean: Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.

enabled bool: Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.

enabled Boolean: Enable versioning. Once you version-enable a bucket, it can never return to an unversioned state. You can, however, suspend versioning on that bucket.

Import

Buckets can be imported using the region and name attributes (delimited by a comma)

 $ pulumi import digitalocean:index/spacesBucket:SpacesBucket foobar `region`,`name`

Package Details

Repository: DigitalOcean pulumi/pulumi-digitalocean
License: Apache-2.0
Notes: This Pulumi package is based on the digitalocean Terraform Provider.

DigitalOcean v4.22.0 published on Friday, Sep 22, 2023 by Pulumi

pulumi/pulumi-digitalocean

digitalocean.SpacesBucket

On this page

On this page

Example Usage

Create a New Bucket

Create a New Bucket With CORS Rules

Create SpacesBucket Resource

SpacesBucket Resource Properties

Inputs

Outputs

Look up Existing SpacesBucket Resource

Supporting Types

Region, RegionArgs

SpacesBucketCorsRule, SpacesBucketCorsRuleArgs

SpacesBucketLifecycleRule, SpacesBucketLifecycleRuleArgs

SpacesBucketLifecycleRuleExpiration, SpacesBucketLifecycleRuleExpirationArgs

SpacesBucketLifecycleRuleNoncurrentVersionExpiration, SpacesBucketLifecycleRuleNoncurrentVersionExpirationArgs

SpacesBucketVersioning, SpacesBucketVersioningArgs

Import

Package Details

On this page

On this page