1. Packages
  2. Ibm Provider
  3. API Docs
  4. getPiInstanceVpmemVolume
ibm 1.88.0 published on Friday, Feb 6, 2026 by ibm-cloud
ibm logo
ibm 1.88.0 published on Friday, Feb 6, 2026 by ibm-cloud

    Retrieves information about a power virtual machine instance vPMEM volume.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const instanceVpmemVolume = ibm.getPiInstanceVpmemVolume({
        piCloudInstanceId: "098f6bcd-2f7e-470a-a1ab-664e61882371",
        piPvmInstanceId: "11223344-5566-7788-99ab-cdef01234567",
        piVpmemVolumeId: "a1b2c3d4-e5f6-7g8h-9i0j-1k2l3m4n5o6p",
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    instance_vpmem_volume = ibm.get_pi_instance_vpmem_volume(pi_cloud_instance_id="098f6bcd-2f7e-470a-a1ab-664e61882371",
        pi_pvm_instance_id="11223344-5566-7788-99ab-cdef01234567",
        pi_vpmem_volume_id="a1b2c3d4-e5f6-7g8h-9i0j-1k2l3m4n5o6p")
    
    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.LookupPiInstanceVpmemVolume(ctx, &ibm.LookupPiInstanceVpmemVolumeArgs{
    			PiCloudInstanceId: "098f6bcd-2f7e-470a-a1ab-664e61882371",
    			PiPvmInstanceId:   "11223344-5566-7788-99ab-cdef01234567",
    			PiVpmemVolumeId:   "a1b2c3d4-e5f6-7g8h-9i0j-1k2l3m4n5o6p",
    		}, nil)
    		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 instanceVpmemVolume = Ibm.GetPiInstanceVpmemVolume.Invoke(new()
        {
            PiCloudInstanceId = "098f6bcd-2f7e-470a-a1ab-664e61882371",
            PiPvmInstanceId = "11223344-5566-7788-99ab-cdef01234567",
            PiVpmemVolumeId = "a1b2c3d4-e5f6-7g8h-9i0j-1k2l3m4n5o6p",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.ibm.IbmFunctions;
    import com.pulumi.ibm.inputs.GetPiInstanceVpmemVolumeArgs;
    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 instanceVpmemVolume = IbmFunctions.getPiInstanceVpmemVolume(GetPiInstanceVpmemVolumeArgs.builder()
                .piCloudInstanceId("098f6bcd-2f7e-470a-a1ab-664e61882371")
                .piPvmInstanceId("11223344-5566-7788-99ab-cdef01234567")
                .piVpmemVolumeId("a1b2c3d4-e5f6-7g8h-9i0j-1k2l3m4n5o6p")
                .build());
    
        }
    }
    
    variables:
      instanceVpmemVolume:
        fn::invoke:
          function: ibm:getPiInstanceVpmemVolume
          arguments:
            piCloudInstanceId: 098f6bcd-2f7e-470a-a1ab-664e61882371
            piPvmInstanceId: 11223344-5566-7788-99ab-cdef01234567
            piVpmemVolumeId: a1b2c3d4-e5f6-7g8h-9i0j-1k2l3m4n5o6p
    

    Notes

    • Please find supported Regions for endpoints.
    • If a Power cloud instance is provisioned at lon04, The provider level attributes should be as follows:
      • region - lon
      • zone - lon04

    Example usage:

    import * as pulumi from "@pulumi/pulumi";
    
    import pulumi
    
    package main
    
    import (
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    
    return await Deployment.RunAsync(() => 
    {
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    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) {
        }
    }
    
    {}
    

    Using getPiInstanceVpmemVolume

    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 getPiInstanceVpmemVolume(args: GetPiInstanceVpmemVolumeArgs, opts?: InvokeOptions): Promise<GetPiInstanceVpmemVolumeResult>
    function getPiInstanceVpmemVolumeOutput(args: GetPiInstanceVpmemVolumeOutputArgs, opts?: InvokeOptions): Output<GetPiInstanceVpmemVolumeResult>
    def get_pi_instance_vpmem_volume(id: Optional[str] = None,
                                     pi_cloud_instance_id: Optional[str] = None,
                                     pi_pvm_instance_id: Optional[str] = None,
                                     pi_vpmem_volume_id: Optional[str] = None,
                                     opts: Optional[InvokeOptions] = None) -> GetPiInstanceVpmemVolumeResult
    def get_pi_instance_vpmem_volume_output(id: Optional[pulumi.Input[str]] = None,
                                     pi_cloud_instance_id: Optional[pulumi.Input[str]] = None,
                                     pi_pvm_instance_id: Optional[pulumi.Input[str]] = None,
                                     pi_vpmem_volume_id: Optional[pulumi.Input[str]] = None,
                                     opts: Optional[InvokeOptions] = None) -> Output[GetPiInstanceVpmemVolumeResult]
    func LookupPiInstanceVpmemVolume(ctx *Context, args *LookupPiInstanceVpmemVolumeArgs, opts ...InvokeOption) (*LookupPiInstanceVpmemVolumeResult, error)
    func LookupPiInstanceVpmemVolumeOutput(ctx *Context, args *LookupPiInstanceVpmemVolumeOutputArgs, opts ...InvokeOption) LookupPiInstanceVpmemVolumeResultOutput

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

    public static class GetPiInstanceVpmemVolume 
    {
        public static Task<GetPiInstanceVpmemVolumeResult> InvokeAsync(GetPiInstanceVpmemVolumeArgs args, InvokeOptions? opts = null)
        public static Output<GetPiInstanceVpmemVolumeResult> Invoke(GetPiInstanceVpmemVolumeInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetPiInstanceVpmemVolumeResult> getPiInstanceVpmemVolume(GetPiInstanceVpmemVolumeArgs args, InvokeOptions options)
    public static Output<GetPiInstanceVpmemVolumeResult> getPiInstanceVpmemVolume(GetPiInstanceVpmemVolumeArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ibm:index/getPiInstanceVpmemVolume:getPiInstanceVpmemVolume
      arguments:
        # arguments dictionary

    The following arguments are supported:

    PiCloudInstanceId string
    The GUID of the service instance associated with an account.
    PiPvmInstanceId string
    PCloud PVM instance ID.
    PiVpmemVolumeId string
    vPMEM volume ID.
    Id string
    (String) The unique identifier of the pvm instance vpmem volume.
    PiCloudInstanceId string
    The GUID of the service instance associated with an account.
    PiPvmInstanceId string
    PCloud PVM instance ID.
    PiVpmemVolumeId string
    vPMEM volume ID.
    Id string
    (String) The unique identifier of the pvm instance vpmem volume.
    piCloudInstanceId String
    The GUID of the service instance associated with an account.
    piPvmInstanceId String
    PCloud PVM instance ID.
    piVpmemVolumeId String
    vPMEM volume ID.
    id String
    (String) The unique identifier of the pvm instance vpmem volume.
    piCloudInstanceId string
    The GUID of the service instance associated with an account.
    piPvmInstanceId string
    PCloud PVM instance ID.
    piVpmemVolumeId string
    vPMEM volume ID.
    id string
    (String) The unique identifier of the pvm instance vpmem volume.
    pi_cloud_instance_id str
    The GUID of the service instance associated with an account.
    pi_pvm_instance_id str
    PCloud PVM instance ID.
    pi_vpmem_volume_id str
    vPMEM volume ID.
    id str
    (String) The unique identifier of the pvm instance vpmem volume.
    piCloudInstanceId String
    The GUID of the service instance associated with an account.
    piPvmInstanceId String
    PCloud PVM instance ID.
    piVpmemVolumeId String
    vPMEM volume ID.
    id String
    (String) The unique identifier of the pvm instance vpmem volume.

    getPiInstanceVpmemVolume Result

    The following output properties are available:

    CreationDate string
    (String) The date and time when the volume was created.
    Crn string
    (String) The CRN for this resource.
    ErrorCode string
    (String) Error code for the vPMEM volume.
    Href string
    (String) Link to vPMEM volume resource.
    Id string
    (String) The unique identifier of the pvm instance vpmem volume.
    Name string
    (String) Volume name.
    PiCloudInstanceId string
    PiPvmInstanceId string
    PiVpmemVolumeId string
    PvmInstanceId string
    (String) PVM Instance ID which the volume is attached to.
    Reason string
    (String) Reason for error.
    Size double
    (Float) Volume size (GB).
    Status string
    (String) Status of the volume.
    UpdatedDate string
    (String) The date and time when the volume was updated.
    UserTags List<string>
    (List) List of user tags.
    CreationDate string
    (String) The date and time when the volume was created.
    Crn string
    (String) The CRN for this resource.
    ErrorCode string
    (String) Error code for the vPMEM volume.
    Href string
    (String) Link to vPMEM volume resource.
    Id string
    (String) The unique identifier of the pvm instance vpmem volume.
    Name string
    (String) Volume name.
    PiCloudInstanceId string
    PiPvmInstanceId string
    PiVpmemVolumeId string
    PvmInstanceId string
    (String) PVM Instance ID which the volume is attached to.
    Reason string
    (String) Reason for error.
    Size float64
    (Float) Volume size (GB).
    Status string
    (String) Status of the volume.
    UpdatedDate string
    (String) The date and time when the volume was updated.
    UserTags []string
    (List) List of user tags.
    creationDate String
    (String) The date and time when the volume was created.
    crn String
    (String) The CRN for this resource.
    errorCode String
    (String) Error code for the vPMEM volume.
    href String
    (String) Link to vPMEM volume resource.
    id String
    (String) The unique identifier of the pvm instance vpmem volume.
    name String
    (String) Volume name.
    piCloudInstanceId String
    piPvmInstanceId String
    piVpmemVolumeId String
    pvmInstanceId String
    (String) PVM Instance ID which the volume is attached to.
    reason String
    (String) Reason for error.
    size Double
    (Float) Volume size (GB).
    status String
    (String) Status of the volume.
    updatedDate String
    (String) The date and time when the volume was updated.
    userTags List<String>
    (List) List of user tags.
    creationDate string
    (String) The date and time when the volume was created.
    crn string
    (String) The CRN for this resource.
    errorCode string
    (String) Error code for the vPMEM volume.
    href string
    (String) Link to vPMEM volume resource.
    id string
    (String) The unique identifier of the pvm instance vpmem volume.
    name string
    (String) Volume name.
    piCloudInstanceId string
    piPvmInstanceId string
    piVpmemVolumeId string
    pvmInstanceId string
    (String) PVM Instance ID which the volume is attached to.
    reason string
    (String) Reason for error.
    size number
    (Float) Volume size (GB).
    status string
    (String) Status of the volume.
    updatedDate string
    (String) The date and time when the volume was updated.
    userTags string[]
    (List) List of user tags.
    creation_date str
    (String) The date and time when the volume was created.
    crn str
    (String) The CRN for this resource.
    error_code str
    (String) Error code for the vPMEM volume.
    href str
    (String) Link to vPMEM volume resource.
    id str
    (String) The unique identifier of the pvm instance vpmem volume.
    name str
    (String) Volume name.
    pi_cloud_instance_id str
    pi_pvm_instance_id str
    pi_vpmem_volume_id str
    pvm_instance_id str
    (String) PVM Instance ID which the volume is attached to.
    reason str
    (String) Reason for error.
    size float
    (Float) Volume size (GB).
    status str
    (String) Status of the volume.
    updated_date str
    (String) The date and time when the volume was updated.
    user_tags Sequence[str]
    (List) List of user tags.
    creationDate String
    (String) The date and time when the volume was created.
    crn String
    (String) The CRN for this resource.
    errorCode String
    (String) Error code for the vPMEM volume.
    href String
    (String) Link to vPMEM volume resource.
    id String
    (String) The unique identifier of the pvm instance vpmem volume.
    name String
    (String) Volume name.
    piCloudInstanceId String
    piPvmInstanceId String
    piVpmemVolumeId String
    pvmInstanceId String
    (String) PVM Instance ID which the volume is attached to.
    reason String
    (String) Reason for error.
    size Number
    (Float) Volume size (GB).
    status String
    (String) Status of the volume.
    updatedDate String
    (String) The date and time when the volume was updated.
    userTags List<String>
    (List) List of user tags.

    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.88.0 published on Friday, Feb 6, 2026 by ibm-cloud
      Meet Neo: Your AI Platform Teammate