ibm 1.77.1, Apr 14 25

ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud

ibm.StorageBlock

Explore with Pulumi AI

ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud

Example Usage

In the following example, you can create 20G of Endurance block storage with 10G snapshot capacity and 0.25 IOPS/GB.

TypeScript
Python
Go
C#
Java
YAML

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

const test1 = new ibm.StorageBlock("test1", {
    allowedIpAddresses: [
        "10.40.98.193",
        "10.40.98.200",
    ],
    allowedVirtualGuestIds: [27699397],
    capacity: 20,
    datacenter: "dal05",
    hourlyBilling: true,
    iops: 0.25,
    osFormatType: "Linux",
    snapshotCapacity: 10,
    type: "Endurance",
});

import pulumi
import pulumi_ibm as ibm

test1 = ibm.StorageBlock("test1",
    allowed_ip_addresses=[
        "10.40.98.193",
        "10.40.98.200",
    ],
    allowed_virtual_guest_ids=[27699397],
    capacity=20,
    datacenter="dal05",
    hourly_billing=True,
    iops=0.25,
    os_format_type="Linux",
    snapshot_capacity=10,
    type="Endurance")

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ibm.NewStorageBlock(ctx, "test1", &ibm.StorageBlockArgs{
			AllowedIpAddresses: pulumi.StringArray{
				pulumi.String("10.40.98.193"),
				pulumi.String("10.40.98.200"),
			},
			AllowedVirtualGuestIds: pulumi.Float64Array{
				pulumi.Float64(27699397),
			},
			Capacity:         pulumi.Float64(20),
			Datacenter:       pulumi.String("dal05"),
			HourlyBilling:    pulumi.Bool(true),
			Iops:             pulumi.Float64(0.25),
			OsFormatType:     pulumi.String("Linux"),
			SnapshotCapacity: pulumi.Float64(10),
			Type:             pulumi.String("Endurance"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var test1 = new Ibm.StorageBlock("test1", new()
    {
        AllowedIpAddresses = new[]
        {
            "10.40.98.193",
            "10.40.98.200",
        },
        AllowedVirtualGuestIds = new[]
        {
            27699397,
        },
        Capacity = 20,
        Datacenter = "dal05",
        HourlyBilling = true,
        Iops = 0.25,
        OsFormatType = "Linux",
        SnapshotCapacity = 10,
        Type = "Endurance",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.StorageBlock;
import com.pulumi.ibm.StorageBlockArgs;
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 test1 = new StorageBlock("test1", StorageBlockArgs.builder()
            .allowedIpAddresses(            
                "10.40.98.193",
                "10.40.98.200")
            .allowedVirtualGuestIds(27699397)
            .capacity(20)
            .datacenter("dal05")
            .hourlyBilling(true)
            .iops(0.25)
            .osFormatType("Linux")
            .snapshotCapacity(10)
            .type("Endurance")
            .build());

    }
}

resources:
  test1:
    type: ibm:StorageBlock
    properties:
      allowedIpAddresses:
        - 10.40.98.193
        - 10.40.98.200
      # Optional fields
      allowedVirtualGuestIds:
        - 2.7699397e+07
      capacity: 20
      datacenter: dal05
      hourlyBilling: true
      iops: 0.25
      osFormatType: Linux
      snapshotCapacity: 10
      type: Endurance

In the following example, you can create 20G of Performance block storage and 100 IOPS.

TypeScript
Python
Go
C#
Java
YAML

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

const test2 = new ibm.StorageBlock("test2", {
    allowedIpAddresses: [
        "10.40.98.193",
        "10.40.98.200",
    ],
    allowedVirtualGuestIds: [27699397],
    capacity: 20,
    datacenter: "dal05",
    hourlyBilling: true,
    iops: 100,
    osFormatType: "Linux",
    type: "Performance",
});

import pulumi
import pulumi_ibm as ibm

test2 = ibm.StorageBlock("test2",
    allowed_ip_addresses=[
        "10.40.98.193",
        "10.40.98.200",
    ],
    allowed_virtual_guest_ids=[27699397],
    capacity=20,
    datacenter="dal05",
    hourly_billing=True,
    iops=100,
    os_format_type="Linux",
    type="Performance")

package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/ibm/ibm"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := ibm.NewStorageBlock(ctx, "test2", &ibm.StorageBlockArgs{
			AllowedIpAddresses: pulumi.StringArray{
				pulumi.String("10.40.98.193"),
				pulumi.String("10.40.98.200"),
			},
			AllowedVirtualGuestIds: pulumi.Float64Array{
				pulumi.Float64(27699397),
			},
			Capacity:      pulumi.Float64(20),
			Datacenter:    pulumi.String("dal05"),
			HourlyBilling: pulumi.Bool(true),
			Iops:          pulumi.Float64(100),
			OsFormatType:  pulumi.String("Linux"),
			Type:          pulumi.String("Performance"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

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

return await Deployment.RunAsync(() => 
{
    var test2 = new Ibm.StorageBlock("test2", new()
    {
        AllowedIpAddresses = new[]
        {
            "10.40.98.193",
            "10.40.98.200",
        },
        AllowedVirtualGuestIds = new[]
        {
            27699397,
        },
        Capacity = 20,
        Datacenter = "dal05",
        HourlyBilling = true,
        Iops = 100,
        OsFormatType = "Linux",
        Type = "Performance",
    });

});

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.ibm.StorageBlock;
import com.pulumi.ibm.StorageBlockArgs;
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 test2 = new StorageBlock("test2", StorageBlockArgs.builder()
            .allowedIpAddresses(            
                "10.40.98.193",
                "10.40.98.200")
            .allowedVirtualGuestIds(27699397)
            .capacity(20)
            .datacenter("dal05")
            .hourlyBilling(true)
            .iops(100)
            .osFormatType("Linux")
            .type("Performance")
            .build());

    }
}

resources:
  test2:
    type: ibm:StorageBlock
    properties:
      allowedIpAddresses:
        - 10.40.98.193
        - 10.40.98.200
      # Optional fields
      allowedVirtualGuestIds:
        - 2.7699397e+07
      capacity: 20
      datacenter: dal05
      hourlyBilling: true
      iops: 100
      osFormatType: Linux
      type: Performance

Argument reference

Review the argument references that you can specify for your resource.

allowed_virtual_guest_ids- (Optional, Array of Integers) The virtual guests that you want to give access to this instance. Virtual guests must be in the same data center as the block storage. You can also use this field to import the list of virtual guests that have access to this storage from the block_storage_ids argument in the ibm.ComputeVmInstance resource.
allowed_hardware_ids- (Optional, Array of Integers) The Bare Metal servers that you want to give access to this instance. Bare Metal servers must be in the same data center as the block storage. You can also use this field to import the list of Bare Metal servers that have access to this storage from the block_storage_ids argument in the ibm.ComputeBareMetal resource.
allowed_ip_addresses- (Optional, Array of string) The IP addresses that you want to give access to this instance. IP addresses must be in the same data center as the block storage.
capacity - (Required, Integer) The amount of storage capacity that you want to allocate, specified in gigabytes.
datacenter- (Required, Forces new resource, String) The data center where you want to provision the block storage instance.
hourly_billing - (Optional, Bool) Set true to enable hourly billing. Default value is false Note Hourly billing is only available in updated data centers with improved capabilities. Refer to the link to get the updated list of data centers. See file storage locations.
iops- (Required, Float) The IOPS value for the storage. For supported values for endurance storage, see IBM Cloud Classic Infrastructure (SoftLayer).
os_format_type - (Required, Forces new resource, String) The OS type used to format the storage space. This OS type must match the OS type that connects to the LUN. Log in to the IBM Cloud Classic Infrastructure API to see available OS format types. Use your API as the password to log in. Log in and find the key called name.
notes - (Optional, String) A descriptive note that you want to associate with the block storage.
snapshot_capacity - (Optional, Forces new resource, Integer) The amount of snapshot capacity to allocate, specified in gigabytes.
type - (Required, Forces new resource, String)The type of the storage. Accepted values are Endurance and Performance.
tags - (Optional, Array of string) Tags associated with the storage block instance. Note Tags are managed locally and not stored on the IBM Cloud Service Endpoint at this moment.

Create StorageBlock Resource

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

new StorageBlock(name: string, args: StorageBlockArgs, opts?: CustomResourceOptions);

@overload
def StorageBlock(resource_name: str,
                 args: StorageBlockArgs,
                 opts: Optional[ResourceOptions] = None)

@overload
def StorageBlock(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 iops: Optional[float] = None,
                 os_format_type: Optional[str] = None,
                 type: Optional[str] = None,
                 capacity: Optional[float] = None,
                 datacenter: Optional[str] = None,
                 timeouts: Optional[StorageBlockTimeoutsArgs] = None,
                 hourly_billing: Optional[bool] = None,
                 allowed_hardware_ids: Optional[Sequence[float]] = None,
                 allowed_ip_addresses: Optional[Sequence[str]] = None,
                 snapshot_capacity: Optional[float] = None,
                 storage_block_id: Optional[str] = None,
                 tags: Optional[Sequence[str]] = None,
                 notes: Optional[str] = None,
                 allowed_virtual_guest_ids: Optional[Sequence[float]] = None)

func NewStorageBlock(ctx *Context, name string, args StorageBlockArgs, opts ...ResourceOption) (*StorageBlock, error)

public StorageBlock(string name, StorageBlockArgs args, CustomResourceOptions? opts = null)

public StorageBlock(String name, StorageBlockArgs args)
public StorageBlock(String name, StorageBlockArgs args, CustomResourceOptions options)

type: ibm:StorageBlock
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 StorageBlockArgs: 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 StorageBlockArgs: 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 StorageBlockArgs: The arguments to resource properties.
opts ResourceOption: Bag of options to control resource's behavior.

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

name String: The unique name of the resource.
args StorageBlockArgs: 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.

TypeScript
Python
Go
C#
Java
YAML

var storageBlockResource = new Ibm.StorageBlock("storageBlockResource", new()
{
    Iops = 0,
    OsFormatType = "string",
    Type = "string",
    Capacity = 0,
    Datacenter = "string",
    Timeouts = new Ibm.Inputs.StorageBlockTimeoutsArgs
    {
        Create = "string",
        Delete = "string",
        Update = "string",
    },
    HourlyBilling = false,
    AllowedHardwareIds = new[]
    {
        0,
    },
    AllowedIpAddresses = new[]
    {
        "string",
    },
    SnapshotCapacity = 0,
    StorageBlockId = "string",
    Tags = new[]
    {
        "string",
    },
    Notes = "string",
    AllowedVirtualGuestIds = new[]
    {
        0,
    },
});

example, err := ibm.NewStorageBlock(ctx, "storageBlockResource", &ibm.StorageBlockArgs{
Iops: pulumi.Float64(0),
OsFormatType: pulumi.String("string"),
Type: pulumi.String("string"),
Capacity: pulumi.Float64(0),
Datacenter: pulumi.String("string"),
Timeouts: &.StorageBlockTimeoutsArgs{
Create: pulumi.String("string"),
Delete: pulumi.String("string"),
Update: pulumi.String("string"),
},
HourlyBilling: pulumi.Bool(false),
AllowedHardwareIds: pulumi.Float64Array{
pulumi.Float64(0),
},
AllowedIpAddresses: pulumi.StringArray{
pulumi.String("string"),
},
SnapshotCapacity: pulumi.Float64(0),
StorageBlockId: pulumi.String("string"),
Tags: pulumi.StringArray{
pulumi.String("string"),
},
Notes: pulumi.String("string"),
AllowedVirtualGuestIds: pulumi.Float64Array{
pulumi.Float64(0),
},
})

var storageBlockResource = new StorageBlock("storageBlockResource", StorageBlockArgs.builder()
    .iops(0)
    .osFormatType("string")
    .type("string")
    .capacity(0)
    .datacenter("string")
    .timeouts(StorageBlockTimeoutsArgs.builder()
        .create("string")
        .delete("string")
        .update("string")
        .build())
    .hourlyBilling(false)
    .allowedHardwareIds(0)
    .allowedIpAddresses("string")
    .snapshotCapacity(0)
    .storageBlockId("string")
    .tags("string")
    .notes("string")
    .allowedVirtualGuestIds(0)
    .build());

storage_block_resource = ibm.StorageBlock("storageBlockResource",
    iops=0,
    os_format_type="string",
    type="string",
    capacity=0,
    datacenter="string",
    timeouts={
        "create": "string",
        "delete": "string",
        "update": "string",
    },
    hourly_billing=False,
    allowed_hardware_ids=[0],
    allowed_ip_addresses=["string"],
    snapshot_capacity=0,
    storage_block_id="string",
    tags=["string"],
    notes="string",
    allowed_virtual_guest_ids=[0])

const storageBlockResource = new ibm.StorageBlock("storageBlockResource", {
    iops: 0,
    osFormatType: "string",
    type: "string",
    capacity: 0,
    datacenter: "string",
    timeouts: {
        create: "string",
        "delete": "string",
        update: "string",
    },
    hourlyBilling: false,
    allowedHardwareIds: [0],
    allowedIpAddresses: ["string"],
    snapshotCapacity: 0,
    storageBlockId: "string",
    tags: ["string"],
    notes: "string",
    allowedVirtualGuestIds: [0],
});

type: ibm:StorageBlock
properties:
    allowedHardwareIds:
        - 0
    allowedIpAddresses:
        - string
    allowedVirtualGuestIds:
        - 0
    capacity: 0
    datacenter: string
    hourlyBilling: false
    iops: 0
    notes: string
    osFormatType: string
    snapshotCapacity: 0
    storageBlockId: string
    tags:
        - string
    timeouts:
        create: string
        delete: string
        update: string
    type: string

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

Capacity double: Storage block size
Datacenter string: Datacenter name
Iops double: IOPS value required
OsFormatType string: OS formatr type
Type string: Storage block type
AllowedHardwareIds List<double>: List of allowe hardware IDs
AllowedIpAddresses List<string>: Allowed IP addresses
AllowedVirtualGuestIds List<double>: List of allowed virtual guest IDs
HourlyBilling bool: Billing done hourly, if set to true
Notes string: Additional note info
SnapshotCapacity double: Snapshot capacity in GB
StorageBlockId string: (String) The unique identifier of the storage.
Tags List<string>: List of tags associated with the resource
Timeouts StorageBlockTimeouts

Capacity float64: Storage block size
Datacenter string: Datacenter name
Iops float64: IOPS value required
OsFormatType string: OS formatr type
Type string: Storage block type
AllowedHardwareIds []float64: List of allowe hardware IDs
AllowedIpAddresses []string: Allowed IP addresses
AllowedVirtualGuestIds []float64: List of allowed virtual guest IDs
HourlyBilling bool: Billing done hourly, if set to true
Notes string: Additional note info
SnapshotCapacity float64: Snapshot capacity in GB
StorageBlockId string: (String) The unique identifier of the storage.
Tags []string: List of tags associated with the resource
Timeouts StorageBlockTimeoutsArgs

capacity Double: Storage block size
datacenter String: Datacenter name
iops Double: IOPS value required
osFormatType String: OS formatr type
type String: Storage block type
allowedHardwareIds List<Double>: List of allowe hardware IDs
allowedIpAddresses List<String>: Allowed IP addresses
allowedVirtualGuestIds List<Double>: List of allowed virtual guest IDs
hourlyBilling Boolean: Billing done hourly, if set to true
notes String: Additional note info
snapshotCapacity Double: Snapshot capacity in GB
storageBlockId String: (String) The unique identifier of the storage.
tags List<String>: List of tags associated with the resource
timeouts StorageBlockTimeouts

capacity number: Storage block size
datacenter string: Datacenter name
iops number: IOPS value required
osFormatType string: OS formatr type
type string: Storage block type
allowedHardwareIds number[]: List of allowe hardware IDs
allowedIpAddresses string[]: Allowed IP addresses
allowedVirtualGuestIds number[]: List of allowed virtual guest IDs
hourlyBilling boolean: Billing done hourly, if set to true
notes string: Additional note info
snapshotCapacity number: Snapshot capacity in GB
storageBlockId string: (String) The unique identifier of the storage.
tags string[]: List of tags associated with the resource
timeouts StorageBlockTimeouts

capacity float: Storage block size
datacenter str: Datacenter name
iops float: IOPS value required
os_format_type str: OS formatr type
type str: Storage block type
allowed_hardware_ids Sequence[float]: List of allowe hardware IDs
allowed_ip_addresses Sequence[str]: Allowed IP addresses
allowed_virtual_guest_ids Sequence[float]: List of allowed virtual guest IDs
hourly_billing bool: Billing done hourly, if set to true
notes str: Additional note info
snapshot_capacity float: Snapshot capacity in GB
storage_block_id str: (String) The unique identifier of the storage.
tags Sequence[str]: List of tags associated with the resource
timeouts StorageBlockTimeoutsArgs

capacity Number: Storage block size
datacenter String: Datacenter name
iops Number: IOPS value required
osFormatType String: OS formatr type
type String: Storage block type
allowedHardwareIds List<Number>: List of allowe hardware IDs
allowedIpAddresses List<String>: Allowed IP addresses
allowedVirtualGuestIds List<Number>: List of allowed virtual guest IDs
hourlyBilling Boolean: Billing done hourly, if set to true
notes String: Additional note info
snapshotCapacity Number: Snapshot capacity in GB
storageBlockId String: (String) The unique identifier of the storage.
tags List<String>: List of tags associated with the resource
timeouts Property Map

Outputs

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

AllowedHardwareInfos List<StorageBlockAllowedHardwareInfo>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
AllowedHostInfos List<StorageBlockAllowedHostInfo>: (String) The user name, password, and host IQN of the hosts with access to the storage.
AllowedVirtualGuestInfos List<StorageBlockAllowedVirtualGuestInfo>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
Hostname string: (String) The fully qualified domain name of the storage.
Id string: The provider-assigned unique ID for this managed resource.
Lunid string: (String) The LUN ID of the storage device.
ResourceControllerUrl string: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
ResourceName string: The name of the resource
TargetAddresses List<string>: List of target Addresses
Volumename string: (String) The name of the storage volume.

AllowedHardwareInfos []StorageBlockAllowedHardwareInfo: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
AllowedHostInfos []StorageBlockAllowedHostInfo: (String) The user name, password, and host IQN of the hosts with access to the storage.
AllowedVirtualGuestInfos []StorageBlockAllowedVirtualGuestInfo: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
Hostname string: (String) The fully qualified domain name of the storage.
Id string: The provider-assigned unique ID for this managed resource.
Lunid string: (String) The LUN ID of the storage device.
ResourceControllerUrl string: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
ResourceName string: The name of the resource
TargetAddresses []string: List of target Addresses
Volumename string: (String) The name of the storage volume.

allowedHardwareInfos List<StorageBlockAllowedHardwareInfo>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
allowedHostInfos List<StorageBlockAllowedHostInfo>: (String) The user name, password, and host IQN of the hosts with access to the storage.
allowedVirtualGuestInfos List<StorageBlockAllowedVirtualGuestInfo>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
hostname String: (String) The fully qualified domain name of the storage.
id String: The provider-assigned unique ID for this managed resource.
lunid String: (String) The LUN ID of the storage device.
resourceControllerUrl String: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
resourceName String: The name of the resource
targetAddresses List<String>: List of target Addresses
volumename String: (String) The name of the storage volume.

allowedHardwareInfos StorageBlockAllowedHardwareInfo[]: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
allowedHostInfos StorageBlockAllowedHostInfo[]: (String) The user name, password, and host IQN of the hosts with access to the storage.
allowedVirtualGuestInfos StorageBlockAllowedVirtualGuestInfo[]: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
hostname string: (String) The fully qualified domain name of the storage.
id string: The provider-assigned unique ID for this managed resource.
lunid string: (String) The LUN ID of the storage device.
resourceControllerUrl string: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
resourceName string: The name of the resource
targetAddresses string[]: List of target Addresses
volumename string: (String) The name of the storage volume.

allowed_hardware_infos Sequence[StorageBlockAllowedHardwareInfo]: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
allowed_host_infos Sequence[StorageBlockAllowedHostInfo]: (String) The user name, password, and host IQN of the hosts with access to the storage.
allowed_virtual_guest_infos Sequence[StorageBlockAllowedVirtualGuestInfo]: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
hostname str: (String) The fully qualified domain name of the storage.
id str: The provider-assigned unique ID for this managed resource.
lunid str: (String) The LUN ID of the storage device.
resource_controller_url str: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
resource_name str: The name of the resource
target_addresses Sequence[str]: List of target Addresses
volumename str: (String) The name of the storage volume.

allowedHardwareInfos List<Property Map>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
allowedHostInfos List<Property Map>: (String) The user name, password, and host IQN of the hosts with access to the storage.
allowedVirtualGuestInfos List<Property Map>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
hostname String: (String) The fully qualified domain name of the storage.
id String: The provider-assigned unique ID for this managed resource.
lunid String: (String) The LUN ID of the storage device.
resourceControllerUrl String: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
resourceName String: The name of the resource
targetAddresses List<String>: List of target Addresses
volumename String: (String) The name of the storage volume.

Look up Existing StorageBlock Resource

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

TypeScript
Python
Go
C#
Java
YAML

public static get(name: string, id: Input<ID>, state?: StorageBlockState, opts?: CustomResourceOptions): StorageBlock

@staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        allowed_hardware_ids: Optional[Sequence[float]] = None,
        allowed_hardware_infos: Optional[Sequence[StorageBlockAllowedHardwareInfoArgs]] = None,
        allowed_host_infos: Optional[Sequence[StorageBlockAllowedHostInfoArgs]] = None,
        allowed_ip_addresses: Optional[Sequence[str]] = None,
        allowed_virtual_guest_ids: Optional[Sequence[float]] = None,
        allowed_virtual_guest_infos: Optional[Sequence[StorageBlockAllowedVirtualGuestInfoArgs]] = None,
        capacity: Optional[float] = None,
        datacenter: Optional[str] = None,
        hostname: Optional[str] = None,
        hourly_billing: Optional[bool] = None,
        iops: Optional[float] = None,
        lunid: Optional[str] = None,
        notes: Optional[str] = None,
        os_format_type: Optional[str] = None,
        resource_controller_url: Optional[str] = None,
        resource_name: Optional[str] = None,
        snapshot_capacity: Optional[float] = None,
        storage_block_id: Optional[str] = None,
        tags: Optional[Sequence[str]] = None,
        target_addresses: Optional[Sequence[str]] = None,
        timeouts: Optional[StorageBlockTimeoutsArgs] = None,
        type: Optional[str] = None,
        volumename: Optional[str] = None) -> StorageBlock

func GetStorageBlock(ctx *Context, name string, id IDInput, state *StorageBlockState, opts ...ResourceOption) (*StorageBlock, error)

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

public static StorageBlock get(String name, Output<String> id, StorageBlockState state, CustomResourceOptions options)

resources:  _:    type: ibm:StorageBlock    get:      id: ${id}

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:

AllowedHardwareIds List<double>: List of allowe hardware IDs
AllowedHardwareInfos List<StorageBlockAllowedHardwareInfo>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
AllowedHostInfos List<StorageBlockAllowedHostInfo>: (String) The user name, password, and host IQN of the hosts with access to the storage.
AllowedIpAddresses List<string>: Allowed IP addresses
AllowedVirtualGuestIds List<double>: List of allowed virtual guest IDs
AllowedVirtualGuestInfos List<StorageBlockAllowedVirtualGuestInfo>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
Capacity double: Storage block size
Datacenter string: Datacenter name
Hostname string: (String) The fully qualified domain name of the storage.
HourlyBilling bool: Billing done hourly, if set to true
Iops double: IOPS value required
Lunid string: (String) The LUN ID of the storage device.
Notes string: Additional note info
OsFormatType string: OS formatr type
ResourceControllerUrl string: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
ResourceName string: The name of the resource
SnapshotCapacity double: Snapshot capacity in GB
StorageBlockId string: (String) The unique identifier of the storage.
Tags List<string>: List of tags associated with the resource
TargetAddresses List<string>: List of target Addresses
Timeouts StorageBlockTimeouts
Type string: Storage block type
Volumename string: (String) The name of the storage volume.

AllowedHardwareIds []float64: List of allowe hardware IDs
AllowedHardwareInfos []StorageBlockAllowedHardwareInfoArgs: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
AllowedHostInfos []StorageBlockAllowedHostInfoArgs: (String) The user name, password, and host IQN of the hosts with access to the storage.
AllowedIpAddresses []string: Allowed IP addresses
AllowedVirtualGuestIds []float64: List of allowed virtual guest IDs
AllowedVirtualGuestInfos []StorageBlockAllowedVirtualGuestInfoArgs: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
Capacity float64: Storage block size
Datacenter string: Datacenter name
Hostname string: (String) The fully qualified domain name of the storage.
HourlyBilling bool: Billing done hourly, if set to true
Iops float64: IOPS value required
Lunid string: (String) The LUN ID of the storage device.
Notes string: Additional note info
OsFormatType string: OS formatr type
ResourceControllerUrl string: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
ResourceName string: The name of the resource
SnapshotCapacity float64: Snapshot capacity in GB
StorageBlockId string: (String) The unique identifier of the storage.
Tags []string: List of tags associated with the resource
TargetAddresses []string: List of target Addresses
Timeouts StorageBlockTimeoutsArgs
Type string: Storage block type
Volumename string: (String) The name of the storage volume.

allowedHardwareIds List<Double>: List of allowe hardware IDs
allowedHardwareInfos List<StorageBlockAllowedHardwareInfo>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
allowedHostInfos List<StorageBlockAllowedHostInfo>: (String) The user name, password, and host IQN of the hosts with access to the storage.
allowedIpAddresses List<String>: Allowed IP addresses
allowedVirtualGuestIds List<Double>: List of allowed virtual guest IDs
allowedVirtualGuestInfos List<StorageBlockAllowedVirtualGuestInfo>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
capacity Double: Storage block size
datacenter String: Datacenter name
hostname String: (String) The fully qualified domain name of the storage.
hourlyBilling Boolean: Billing done hourly, if set to true
iops Double: IOPS value required
lunid String: (String) The LUN ID of the storage device.
notes String: Additional note info
osFormatType String: OS formatr type
resourceControllerUrl String: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
resourceName String: The name of the resource
snapshotCapacity Double: Snapshot capacity in GB
storageBlockId String: (String) The unique identifier of the storage.
tags List<String>: List of tags associated with the resource
targetAddresses List<String>: List of target Addresses
timeouts StorageBlockTimeouts
type String: Storage block type
volumename String: (String) The name of the storage volume.

allowedHardwareIds number[]: List of allowe hardware IDs
allowedHardwareInfos StorageBlockAllowedHardwareInfo[]: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
allowedHostInfos StorageBlockAllowedHostInfo[]: (String) The user name, password, and host IQN of the hosts with access to the storage.
allowedIpAddresses string[]: Allowed IP addresses
allowedVirtualGuestIds number[]: List of allowed virtual guest IDs
allowedVirtualGuestInfos StorageBlockAllowedVirtualGuestInfo[]: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
capacity number: Storage block size
datacenter string: Datacenter name
hostname string: (String) The fully qualified domain name of the storage.
hourlyBilling boolean: Billing done hourly, if set to true
iops number: IOPS value required
lunid string: (String) The LUN ID of the storage device.
notes string: Additional note info
osFormatType string: OS formatr type
resourceControllerUrl string: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
resourceName string: The name of the resource
snapshotCapacity number: Snapshot capacity in GB
storageBlockId string: (String) The unique identifier of the storage.
tags string[]: List of tags associated with the resource
targetAddresses string[]: List of target Addresses
timeouts StorageBlockTimeouts
type string: Storage block type
volumename string: (String) The name of the storage volume.

allowed_hardware_ids Sequence[float]: List of allowe hardware IDs
allowed_hardware_infos Sequence[StorageBlockAllowedHardwareInfoArgs]: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
allowed_host_infos Sequence[StorageBlockAllowedHostInfoArgs]: (String) The user name, password, and host IQN of the hosts with access to the storage.
allowed_ip_addresses Sequence[str]: Allowed IP addresses
allowed_virtual_guest_ids Sequence[float]: List of allowed virtual guest IDs
allowed_virtual_guest_infos Sequence[StorageBlockAllowedVirtualGuestInfoArgs]: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
capacity float: Storage block size
datacenter str: Datacenter name
hostname str: (String) The fully qualified domain name of the storage.
hourly_billing bool: Billing done hourly, if set to true
iops float: IOPS value required
lunid str: (String) The LUN ID of the storage device.
notes str: Additional note info
os_format_type str: OS formatr type
resource_controller_url str: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
resource_name str: The name of the resource
snapshot_capacity float: Snapshot capacity in GB
storage_block_id str: (String) The unique identifier of the storage.
tags Sequence[str]: List of tags associated with the resource
target_addresses Sequence[str]: List of target Addresses
timeouts StorageBlockTimeoutsArgs
type str: Storage block type
volumename str: (String) The name of the storage volume.

allowedHardwareIds List<Number>: List of allowe hardware IDs
allowedHardwareInfos List<Property Map>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
allowedHostInfos List<Property Map>: (String) The user name, password, and host IQN of the hosts with access to the storage.
allowedIpAddresses List<String>: Allowed IP addresses
allowedVirtualGuestIds List<Number>: List of allowed virtual guest IDs
allowedVirtualGuestInfos List<Property Map>: (String) Deprecated please use allowed_host_info instead.
Deprecated: Deprecated
capacity Number: Storage block size
datacenter String: Datacenter name
hostname String: (String) The fully qualified domain name of the storage.
hourlyBilling Boolean: Billing done hourly, if set to true
iops Number: IOPS value required
lunid String: (String) The LUN ID of the storage device.
notes String: Additional note info
osFormatType String: OS formatr type
resourceControllerUrl String: The URL of the IBM Cloud dashboard that can be used to explore and view details about this instance
resourceName String: The name of the resource
snapshotCapacity Number: Snapshot capacity in GB
storageBlockId String: (String) The unique identifier of the storage.
tags List<String>: List of tags associated with the resource
targetAddresses List<String>: List of target Addresses
timeouts Property Map
type String: Storage block type
volumename String: (String) The name of the storage volume.

Supporting Types

StorageBlockAllowedHardwareInfo
, StorageBlockAllowedHardwareInfoArgs

HostIqn string
Id double: (String) The unique identifier of the storage.
Password string
Username string

HostIqn string
Id float64: (String) The unique identifier of the storage.
Password string
Username string

hostIqn String
id Double: (String) The unique identifier of the storage.
password String
username String

hostIqn string
id number: (String) The unique identifier of the storage.
password string
username string

host_iqn str
id float: (String) The unique identifier of the storage.
password str
username str

hostIqn String
id Number: (String) The unique identifier of the storage.
password String
username String

StorageBlockAllowedHostInfo
, StorageBlockAllowedHostInfoArgs

HostIqn string
Id double: (String) The unique identifier of the storage.
Password string
Username string

HostIqn string
Id float64: (String) The unique identifier of the storage.
Password string
Username string

hostIqn String
id Double: (String) The unique identifier of the storage.
password String
username String

hostIqn string
id number: (String) The unique identifier of the storage.
password string
username string

host_iqn str
id float: (String) The unique identifier of the storage.
password str
username str

hostIqn String
id Number: (String) The unique identifier of the storage.
password String
username String

StorageBlockAllowedVirtualGuestInfo
, StorageBlockAllowedVirtualGuestInfoArgs

HostIqn string
Id double: (String) The unique identifier of the storage.
Password string
Username string

HostIqn string
Id float64: (String) The unique identifier of the storage.
Password string
Username string

hostIqn String
id Double: (String) The unique identifier of the storage.
password String
username String

hostIqn string
id number: (String) The unique identifier of the storage.
password string
username string

host_iqn str
id float: (String) The unique identifier of the storage.
password str
username str

hostIqn String
id Number: (String) The unique identifier of the storage.
password String
username String

StorageBlockTimeouts
, StorageBlockTimeoutsArgs

Create string
Delete string
Update string

Create string
Delete string
Update string

create String
delete String
update String

create string
delete string
update string

create str
delete str
update str

create String
delete String
update String

Package Details

Repository: ibm ibm-cloud/terraform-provider-ibm
License
Notes: This Pulumi package is based on the ibm Terraform Provider.

ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud

ibm-cloud/terraform-provider-ibm

ibm.StorageBlock

On this page

On this page

Example Usage

Argument reference

Create StorageBlock Resource

Constructor syntax

Parameters

Constructor example

StorageBlock Resource Properties

Inputs

Outputs

Look up Existing StorageBlock Resource

Supporting Types

StorageBlockAllowedHardwareInfo
, StorageBlockAllowedHardwareInfoArgs

StorageBlockAllowedHostInfo
, StorageBlockAllowedHostInfoArgs

StorageBlockAllowedVirtualGuestInfo
, StorageBlockAllowedVirtualGuestInfoArgs

StorageBlockTimeouts
, StorageBlockTimeoutsArgs

Package Details

On this page

On this page

ibm.StorageBlock

On this page

On this page

Example Usage

Argument reference

Create StorageBlock Resource

Constructor syntax

Parameters

Constructor example

StorageBlock Resource Properties

Inputs

Outputs

Look up Existing StorageBlock Resource

Supporting Types

StorageBlockAllowedHardwareInfo, StorageBlockAllowedHardwareInfoArgs

StorageBlockAllowedHostInfo, StorageBlockAllowedHostInfoArgs

StorageBlockAllowedVirtualGuestInfo, StorageBlockAllowedVirtualGuestInfoArgs

StorageBlockTimeouts, StorageBlockTimeoutsArgs

Package Details

On this page

On this page

StorageBlockAllowedHardwareInfo
, StorageBlockAllowedHardwareInfoArgs

StorageBlockAllowedHostInfo
, StorageBlockAllowedHostInfoArgs

StorageBlockAllowedVirtualGuestInfo
, StorageBlockAllowedVirtualGuestInfoArgs

StorageBlockTimeouts
, StorageBlockTimeoutsArgs