Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Ibm Provider
  3. API Docs
  4. StorageBlock
ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm

ibm.StorageBlock

Explore with Pulumi AI

ibm logo
ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
ibm-cloud/terraform-provider-ibm

    Create, delete, or update a block storage resource. For more information, about Block storage, see getting startecwith block storage.

    Block storage can be accessed and mounted through a Multipath Input/Output Internet Small Computer System Interface (iSCSI) connection.

    Example Usage

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

    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.

    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.

    Constructor syntax

    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.

    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.

    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 logo
    ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
    ibm-cloud/terraform-provider-ibm