Vultr v2.12.1, Feb 11 23

vultr.getBlockStorage

Get information about a Vultr block storage subscription.

Example Usage

Get the information for a block storage subscription by

using System.Collections.Generic;
using Pulumi;
using Vultr = Pulumi.Vultr;

return await Deployment.RunAsync(() => 
{
    var myBlockStorage = Vultr.GetBlockStorage.Invoke(new()
    {
        Filters = new[]
        {
            new Vultr.Inputs.GetBlockStorageFilterInputArgs
            {
                Name = "label",
                Values = new[]
                {
                    "my-block-storage-label",
                },
            },
        },
    });

});

package main

import (
	"github.com/dirien/pulumi-vultr/sdk/v2/go/vultr"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := vultr.LookupBlockStorage(ctx, &vultr.LookupBlockStorageArgs{
			Filters: []vultr.GetBlockStorageFilter{
				{
					Name: "label",
					Values: []string{
						"my-block-storage-label",
					},
				},
			},
		}, 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.vultr.VultrFunctions;
import com.pulumi.vultr.inputs.GetBlockStorageArgs;
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 myBlockStorage = VultrFunctions.getBlockStorage(GetBlockStorageArgs.builder()
            .filters(GetBlockStorageFilterArgs.builder()
                .name("label")
                .values("my-block-storage-label")
                .build())
            .build());

    }
}

import pulumi
import pulumi_vultr as vultr

my_block_storage = vultr.get_block_storage(filters=[vultr.GetBlockStorageFilterArgs(
    name="label",
    values=["my-block-storage-label"],
)])

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

const myBlockStorage = vultr.getBlockStorage({
    filters: [{
        name: "label",
        values: ["my-block-storage-label"],
    }],
});

variables:
  myBlockStorage:
    fn::invoke:
      Function: vultr:getBlockStorage
      Arguments:
        filters:
          - name: label
            values:
              - my-block-storage-label

Using getBlockStorage

Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.

function getBlockStorage(args: GetBlockStorageArgs, opts?: InvokeOptions): Promise<GetBlockStorageResult>
function getBlockStorageOutput(args: GetBlockStorageOutputArgs, opts?: InvokeOptions): Output<GetBlockStorageResult>

def get_block_storage(filters: Optional[Sequence[GetBlockStorageFilter]] = None,
                      opts: Optional[InvokeOptions] = None) -> GetBlockStorageResult
def get_block_storage_output(filters: Optional[pulumi.Input[Sequence[pulumi.Input[GetBlockStorageFilterArgs]]]] = None,
                      opts: Optional[InvokeOptions] = None) -> Output[GetBlockStorageResult]

func LookupBlockStorage(ctx *Context, args *LookupBlockStorageArgs, opts ...InvokeOption) (*LookupBlockStorageResult, error)
func LookupBlockStorageOutput(ctx *Context, args *LookupBlockStorageOutputArgs, opts ...InvokeOption) LookupBlockStorageResultOutput

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

public static class GetBlockStorage 
{
    public static Task<GetBlockStorageResult> InvokeAsync(GetBlockStorageArgs args, InvokeOptions? opts = null)
    public static Output<GetBlockStorageResult> Invoke(GetBlockStorageInvokeArgs args, InvokeOptions? opts = null)
}

public static CompletableFuture<GetBlockStorageResult> getBlockStorage(GetBlockStorageArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet

fn::invoke:
  function: vultr:index/getBlockStorage:getBlockStorage
  arguments:
    # arguments dictionary

The following arguments are supported:

Filters List<ediri.Vultr.Inputs.GetBlockStorageFilter>: Query parameters for finding block storage subscriptions.

Filters []GetBlockStorageFilter: Query parameters for finding block storage subscriptions.

filters List<GetBlockStorageFilter>: Query parameters for finding block storage subscriptions.

filters GetBlockStorageFilter[]: Query parameters for finding block storage subscriptions.

filters Sequence[GetBlockStorageFilter]: Query parameters for finding block storage subscriptions.

filters List<Property Map>: Query parameters for finding block storage subscriptions.

getBlockStorage Result

The following output properties are available:

AttachedToInstance string: The ID of the VPS the block storage subscription is attached to.
BlockType string: The type of block storage volume.
Cost int: The cost per month of the block storage subscription in USD.
DateCreated string: The date the block storage subscription was added to your Vultr account.
Id string: The provider-assigned unique ID for this managed resource.
Label string: The label of the block storage subscription.
MountId string: An ID associated with the instance, when mounted the ID can be found in /dev/disk/by-id prefixed with virtio.
Region string: The region ID of the block storage subscription.
SizeGb int: The size of the block storage subscription in GB.
Status string: The status of the block storage subscription.
Filters List<ediri.Vultr.Outputs.GetBlockStorageFilter>

AttachedToInstance string: The ID of the VPS the block storage subscription is attached to.
BlockType string: The type of block storage volume.
Cost int: The cost per month of the block storage subscription in USD.
DateCreated string: The date the block storage subscription was added to your Vultr account.
Id string: The provider-assigned unique ID for this managed resource.
Label string: The label of the block storage subscription.
MountId string: An ID associated with the instance, when mounted the ID can be found in /dev/disk/by-id prefixed with virtio.
Region string: The region ID of the block storage subscription.
SizeGb int: The size of the block storage subscription in GB.
Status string: The status of the block storage subscription.
Filters []GetBlockStorageFilter

attachedToInstance String: The ID of the VPS the block storage subscription is attached to.
blockType String: The type of block storage volume.
cost Integer: The cost per month of the block storage subscription in USD.
dateCreated String: The date the block storage subscription was added to your Vultr account.
id String: The provider-assigned unique ID for this managed resource.
label String: The label of the block storage subscription.
mountId String: An ID associated with the instance, when mounted the ID can be found in /dev/disk/by-id prefixed with virtio.
region String: The region ID of the block storage subscription.
sizeGb Integer: The size of the block storage subscription in GB.
status String: The status of the block storage subscription.
filters List<GetBlockStorageFilter>

attachedToInstance string: The ID of the VPS the block storage subscription is attached to.
blockType string: The type of block storage volume.
cost number: The cost per month of the block storage subscription in USD.
dateCreated string: The date the block storage subscription was added to your Vultr account.
id string: The provider-assigned unique ID for this managed resource.
label string: The label of the block storage subscription.
mountId string: An ID associated with the instance, when mounted the ID can be found in /dev/disk/by-id prefixed with virtio.
region string: The region ID of the block storage subscription.
sizeGb number: The size of the block storage subscription in GB.
status string: The status of the block storage subscription.
filters GetBlockStorageFilter[]

attached_to_instance str: The ID of the VPS the block storage subscription is attached to.
block_type str: The type of block storage volume.
cost int: The cost per month of the block storage subscription in USD.
date_created str: The date the block storage subscription was added to your Vultr account.
id str: The provider-assigned unique ID for this managed resource.
label str: The label of the block storage subscription.
mount_id str: An ID associated with the instance, when mounted the ID can be found in /dev/disk/by-id prefixed with virtio.
region str: The region ID of the block storage subscription.
size_gb int: The size of the block storage subscription in GB.
status str: The status of the block storage subscription.
filters Sequence[GetBlockStorageFilter]

attachedToInstance String: The ID of the VPS the block storage subscription is attached to.
blockType String: The type of block storage volume.
cost Number: The cost per month of the block storage subscription in USD.
dateCreated String: The date the block storage subscription was added to your Vultr account.
id String: The provider-assigned unique ID for this managed resource.
label String: The label of the block storage subscription.
mountId String: An ID associated with the instance, when mounted the ID can be found in /dev/disk/by-id prefixed with virtio.
region String: The region ID of the block storage subscription.
sizeGb Number: The size of the block storage subscription in GB.
status String: The status of the block storage subscription.
filters List<Property Map>

Supporting Types

GetBlockStorageFilter

Name string: Attribute name to filter with.
Values List<string>: One or more values filter with.

Name string: Attribute name to filter with.
Values []string: One or more values filter with.

name String: Attribute name to filter with.
values List<String>: One or more values filter with.

name string: Attribute name to filter with.
values string[]: One or more values filter with.

name str: Attribute name to filter with.
values Sequence[str]: One or more values filter with.

name String: Attribute name to filter with.
values List<String>: One or more values filter with.

Package Details

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