1. Packages
  2. Ibm Provider
  3. API Docs
  4. getPiVirtualSerialNumber
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

ibm.getPiVirtualSerialNumber

Explore with Pulumi AI

ibm logo
ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud

    Retrieve information about an existing virtual serial number as a read-only data source. For more information, about IBM power virtual server cloud, see getting started with IBM Power Systems Virtual Servers.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const dsVirtualSerialNumber = ibm.getPiVirtualSerialNumber({
        piCloudInstanceId: "<cloud instance id>",
        piSerial: "<virtual serial number>",
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    ds_virtual_serial_number = ibm.get_pi_virtual_serial_number(pi_cloud_instance_id="<cloud instance id>",
        pi_serial="<virtual serial number>")
    
    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.LookupPiVirtualSerialNumber(ctx, &ibm.LookupPiVirtualSerialNumberArgs{
    			PiCloudInstanceId: "<cloud instance id>",
    			PiSerial:          "<virtual serial number>",
    		}, 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 dsVirtualSerialNumber = Ibm.GetPiVirtualSerialNumber.Invoke(new()
        {
            PiCloudInstanceId = "<cloud instance id>",
            PiSerial = "<virtual serial number>",
        });
    
    });
    
    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.GetPiVirtualSerialNumberArgs;
    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 dsVirtualSerialNumber = IbmFunctions.getPiVirtualSerialNumber(GetPiVirtualSerialNumberArgs.builder()
                .piCloudInstanceId("<cloud instance id>")
                .piSerial("<virtual serial number>")
                .build());
    
        }
    }
    
    variables:
      dsVirtualSerialNumber:
        fn::invoke:
          function: ibm:getPiVirtualSerialNumber
          arguments:
            piCloudInstanceId: <cloud instance id>
            piSerial: <virtual serial number>
    

    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 getPiVirtualSerialNumber

    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 getPiVirtualSerialNumber(args: GetPiVirtualSerialNumberArgs, opts?: InvokeOptions): Promise<GetPiVirtualSerialNumberResult>
    function getPiVirtualSerialNumberOutput(args: GetPiVirtualSerialNumberOutputArgs, opts?: InvokeOptions): Output<GetPiVirtualSerialNumberResult>
    def get_pi_virtual_serial_number(id: Optional[str] = None,
                                     pi_cloud_instance_id: Optional[str] = None,
                                     pi_serial: Optional[str] = None,
                                     opts: Optional[InvokeOptions] = None) -> GetPiVirtualSerialNumberResult
    def get_pi_virtual_serial_number_output(id: Optional[pulumi.Input[str]] = None,
                                     pi_cloud_instance_id: Optional[pulumi.Input[str]] = None,
                                     pi_serial: Optional[pulumi.Input[str]] = None,
                                     opts: Optional[InvokeOptions] = None) -> Output[GetPiVirtualSerialNumberResult]
    func LookupPiVirtualSerialNumber(ctx *Context, args *LookupPiVirtualSerialNumberArgs, opts ...InvokeOption) (*LookupPiVirtualSerialNumberResult, error)
    func LookupPiVirtualSerialNumberOutput(ctx *Context, args *LookupPiVirtualSerialNumberOutputArgs, opts ...InvokeOption) LookupPiVirtualSerialNumberResultOutput

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

    public static class GetPiVirtualSerialNumber 
    {
        public static Task<GetPiVirtualSerialNumberResult> InvokeAsync(GetPiVirtualSerialNumberArgs args, InvokeOptions? opts = null)
        public static Output<GetPiVirtualSerialNumberResult> Invoke(GetPiVirtualSerialNumberInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetPiVirtualSerialNumberResult> getPiVirtualSerialNumber(GetPiVirtualSerialNumberArgs args, InvokeOptions options)
    public static Output<GetPiVirtualSerialNumberResult> getPiVirtualSerialNumber(GetPiVirtualSerialNumberArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ibm:index/getPiVirtualSerialNumber:getPiVirtualSerialNumber
      arguments:
        # arguments dictionary

    The following arguments are supported:

    PiCloudInstanceId string
    The GUID of the service instance associated with an account.
    PiSerial string
    Virtual serial number.
    Id string
    PiCloudInstanceId string
    The GUID of the service instance associated with an account.
    PiSerial string
    Virtual serial number.
    Id string
    piCloudInstanceId String
    The GUID of the service instance associated with an account.
    piSerial String
    Virtual serial number.
    id String
    piCloudInstanceId string
    The GUID of the service instance associated with an account.
    piSerial string
    Virtual serial number.
    id string
    pi_cloud_instance_id str
    The GUID of the service instance associated with an account.
    pi_serial str
    Virtual serial number.
    id str
    piCloudInstanceId String
    The GUID of the service instance associated with an account.
    piSerial String
    Virtual serial number.
    id String

    getPiVirtualSerialNumber Result

    The following output properties are available:

    Description string
    (String) Description for virtual serial number.
    Id string
    InstanceId string
    PiCloudInstanceId string
    PiSerial string
    Description string
    (String) Description for virtual serial number.
    Id string
    InstanceId string
    PiCloudInstanceId string
    PiSerial string
    description String
    (String) Description for virtual serial number.
    id String
    instanceId String
    piCloudInstanceId String
    piSerial String
    description string
    (String) Description for virtual serial number.
    id string
    instanceId string
    piCloudInstanceId string
    piSerial string
    description str
    (String) Description for virtual serial number.
    id str
    instance_id str
    pi_cloud_instance_id str
    pi_serial str
    description String
    (String) Description for virtual serial number.
    id String
    instanceId String
    piCloudInstanceId String
    piSerial 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.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud