pulumi-digitalocean-kotlin/com.pulumi.digitalocean.kotlin/DigitaloceanFunctions/getSpacesBuckets

getSpacesBuckets

suspend fun getSpacesBuckets(argument: GetSpacesBucketsPlainArgs): GetSpacesBucketsResult

Get information on Spaces buckets for use in other resources, with the ability to filter and sort the results. If no filters are specified, all Spaces buckets will be returned. Note: You can use the digitalocean.SpacesBucket data source to obtain metadata about a single bucket if you already know its name and region.

Example Usage

Use the filter block with a key string and values list to filter buckets. Get all buckets in a region:

import * as pulumi from "@pulumi/pulumi";
import * as digitalocean from "@pulumi/digitalocean";
const nyc3 = digitalocean.getSpacesBuckets({
    filters: [{
        key: "region",
        values: ["nyc3"],
    }],
});
Content copied to clipboard
import pulumi
import pulumi_digitalocean as digitalocean
nyc3 = digitalocean.get_spaces_buckets(filters=[{
    "key": "region",
    "values": ["nyc3"],
}])
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using DigitalOcean = Pulumi.DigitalOcean;
return await Deployment.RunAsync(() =>
{
    var nyc3 = DigitalOcean.GetSpacesBuckets.Invoke(new()
    {
        Filters = new[]
        {
            new DigitalOcean.Inputs.GetSpacesBucketsFilterInputArgs
            {
                Key = "region",
                Values = new[]
                {
                    "nyc3",
                },
            },
        },
    });
});
Content copied to clipboard
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.GetSpacesBuckets(ctx, &digitalocean.GetSpacesBucketsArgs{
			Filters: []digitalocean.GetSpacesBucketsFilter{
				{
					Key: "region",
					Values: []string{
						"nyc3",
					},
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.digitalocean.DigitaloceanFunctions;
import com.pulumi.digitalocean.inputs.GetSpacesBucketsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var nyc3 = DigitaloceanFunctions.getSpacesBuckets(GetSpacesBucketsArgs.builder()
            .filters(GetSpacesBucketsFilterArgs.builder()
                .key("region")
                .values("nyc3")
                .build())
            .build());
    }
}
Content copied to clipboard
variables:
  nyc3:
    fn::invoke:
      function: digitalocean:getSpacesBuckets
      arguments:
        filters:
          - key: region
            values:
              - nyc3
Content copied to clipboard

You can sort the results as well:

import * as pulumi from "@pulumi/pulumi";
import * as digitalocean from "@pulumi/digitalocean";
const nyc3 = digitalocean.getSpacesBuckets({
    filters: [{
        key: "region",
        values: ["nyc3"],
    }],
    sorts: [{
        key: "name",
        direction: "desc",
    }],
});
Content copied to clipboard
import pulumi
import pulumi_digitalocean as digitalocean
nyc3 = digitalocean.get_spaces_buckets(filters=[{
        "key": "region",
        "values": ["nyc3"],
    }],
    sorts=[{
        "key": "name",
        "direction": "desc",
    }])
Content copied to clipboard
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using DigitalOcean = Pulumi.DigitalOcean;
return await Deployment.RunAsync(() =>
{
    var nyc3 = DigitalOcean.GetSpacesBuckets.Invoke(new()
    {
        Filters = new[]
        {
            new DigitalOcean.Inputs.GetSpacesBucketsFilterInputArgs
            {
                Key = "region",
                Values = new[]
                {
                    "nyc3",
                },
            },
        },
        Sorts = new[]
        {
            new DigitalOcean.Inputs.GetSpacesBucketsSortInputArgs
            {
                Key = "name",
                Direction = "desc",
            },
        },
    });
});
Content copied to clipboard
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.GetSpacesBuckets(ctx, &digitalocean.GetSpacesBucketsArgs{
			Filters: []digitalocean.GetSpacesBucketsFilter{
				{
					Key: "region",
					Values: []string{
						"nyc3",
					},
				},
			},
			Sorts: []digitalocean.GetSpacesBucketsSort{
				{
					Key:       "name",
					Direction: pulumi.StringRef("desc"),
				},
			},
		}, nil)
		if err != nil {
			return err
		}
		return nil
	})
}
Content copied to clipboard
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.digitalocean.DigitaloceanFunctions;
import com.pulumi.digitalocean.inputs.GetSpacesBucketsArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }
    public static void stack(Context ctx) {
        final var nyc3 = DigitaloceanFunctions.getSpacesBuckets(GetSpacesBucketsArgs.builder()
            .filters(GetSpacesBucketsFilterArgs.builder()
                .key("region")
                .values("nyc3")
                .build())
            .sorts(GetSpacesBucketsSortArgs.builder()
                .key("name")
                .direction("desc")
                .build())
            .build());
    }
}
Content copied to clipboard
variables:
  nyc3:
    fn::invoke:
      function: digitalocean:getSpacesBuckets
      arguments:
        filters:
          - key: region
            values:
              - nyc3
        sorts:
          - key: name
            direction: desc
Content copied to clipboard

Return

A collection of values returned by getSpacesBuckets.

Parameters

argument

A collection of arguments for invoking getSpacesBuckets.

suspend fun getSpacesBuckets(filters: List<GetSpacesBucketsFilter>? = null, sorts: List<GetSpacesBucketsSort>? = null): GetSpacesBucketsResult

Return

A collection of values returned by getSpacesBuckets.

Parameters

filters

Filter the results. The filter block is documented below.

sorts

Sort the results. The sort block is documented below.

See also

.

suspend fun getSpacesBuckets(argument: suspend GetSpacesBucketsPlainArgsBuilder.() -> Unit): GetSpacesBucketsResult

Return

A collection of values returned by getSpacesBuckets.

Parameters

argument

Builder for com.pulumi.digitalocean.kotlin.inputs.GetSpacesBucketsPlainArgs.

See also

.