ibm 1.77.1 published on Monday, Apr 14, 2025 by ibm-cloud
ibm.getPiCloudInstance
Explore with Pulumi AI
Retrieve information about an existing IBM Power Virtual Server Cloud Instance 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 dsCloudInstance = ibm.getPiCloudInstance({
    piCloudInstanceId: "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
});
import pulumi
import pulumi_ibm as ibm
ds_cloud_instance = ibm.get_pi_cloud_instance(pi_cloud_instance_id="49fba6c9-23f8-40bc-9899-aca322ee7d5b")
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.GetPiCloudInstance(ctx, &ibm.GetPiCloudInstanceArgs{
			PiCloudInstanceId: "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
		}, 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 dsCloudInstance = Ibm.GetPiCloudInstance.Invoke(new()
    {
        PiCloudInstanceId = "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
    });
});
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.GetPiCloudInstanceArgs;
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 dsCloudInstance = IbmFunctions.getPiCloudInstance(GetPiCloudInstanceArgs.builder()
            .piCloudInstanceId("49fba6c9-23f8-40bc-9899-aca322ee7d5b")
            .build());
    }
}
variables:
  dsCloudInstance:
    fn::invoke:
      function: ibm:getPiCloudInstance
      arguments:
        piCloudInstanceId: 49fba6c9-23f8-40bc-9899-aca322ee7d5b
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-lonzone-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 getPiCloudInstance
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 getPiCloudInstance(args: GetPiCloudInstanceArgs, opts?: InvokeOptions): Promise<GetPiCloudInstanceResult>
function getPiCloudInstanceOutput(args: GetPiCloudInstanceOutputArgs, opts?: InvokeOptions): Output<GetPiCloudInstanceResult>def get_pi_cloud_instance(id: Optional[str] = None,
                          pi_cloud_instance_id: Optional[str] = None,
                          opts: Optional[InvokeOptions] = None) -> GetPiCloudInstanceResult
def get_pi_cloud_instance_output(id: Optional[pulumi.Input[str]] = None,
                          pi_cloud_instance_id: Optional[pulumi.Input[str]] = None,
                          opts: Optional[InvokeOptions] = None) -> Output[GetPiCloudInstanceResult]func GetPiCloudInstance(ctx *Context, args *GetPiCloudInstanceArgs, opts ...InvokeOption) (*GetPiCloudInstanceResult, error)
func GetPiCloudInstanceOutput(ctx *Context, args *GetPiCloudInstanceOutputArgs, opts ...InvokeOption) GetPiCloudInstanceResultOutput> Note: This function is named GetPiCloudInstance in the Go SDK.
public static class GetPiCloudInstance 
{
    public static Task<GetPiCloudInstanceResult> InvokeAsync(GetPiCloudInstanceArgs args, InvokeOptions? opts = null)
    public static Output<GetPiCloudInstanceResult> Invoke(GetPiCloudInstanceInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetPiCloudInstanceResult> getPiCloudInstance(GetPiCloudInstanceArgs args, InvokeOptions options)
public static Output<GetPiCloudInstanceResult> getPiCloudInstance(GetPiCloudInstanceArgs args, InvokeOptions options)
fn::invoke:
  function: ibm:index/getPiCloudInstance:getPiCloudInstance
  arguments:
    # arguments dictionaryThe following arguments are supported:
- Pi
Cloud stringInstance Id  - The GUID of the service instance associated with an account.
 - Id string
 - (String) PVM Instance ID.
 
- Pi
Cloud stringInstance Id  - The GUID of the service instance associated with an account.
 - Id string
 - (String) PVM Instance ID.
 
- pi
Cloud StringInstance Id  - The GUID of the service instance associated with an account.
 - id String
 - (String) PVM Instance ID.
 
- pi
Cloud stringInstance Id  - The GUID of the service instance associated with an account.
 - id string
 - (String) PVM Instance ID.
 
- pi_
cloud_ strinstance_ id  - The GUID of the service instance associated with an account.
 - id str
 - (String) PVM Instance ID.
 
- pi
Cloud StringInstance Id  - The GUID of the service instance associated with an account.
 - id String
 - (String) PVM Instance ID.
 
getPiCloudInstance Result
The following output properties are available:
- Capabilities List<string>
 - (String) Lists the capabilities for this cloud instance.
 - Enabled bool
 - (Bool) Indicates whether the tenant is enabled.
 - Id string
 - (String) PVM Instance ID.
 - Pi
Cloud stringInstance Id  - Pvm
Instances List<GetPi Cloud Instance Pvm Instance>  - (List) PVM instances owned by the Cloud Instance.
 - Region string
 - (String) The region the cloud instance lives.
 - Tenant
Id string - (String) The tenant ID that owns this cloud instance.
 - Total
Instances double - (String) The count of lpars that belong to this specific cloud instance.
 - Total
Memory doubleConsumed  - (String) The total memory consumed by this service instance.
 - Total
Processors doubleConsumed  - (String) The total processors consumed by this service instance.
 - Total
Ssd doubleStorage Consumed  - (String) The total SSD Storage consumed by this service instance.
 - Total
Standard doubleStorage Consumed  - (String) The total Standard Storage consumed by this service instance.
 
- Capabilities []string
 - (String) Lists the capabilities for this cloud instance.
 - Enabled bool
 - (Bool) Indicates whether the tenant is enabled.
 - Id string
 - (String) PVM Instance ID.
 - Pi
Cloud stringInstance Id  - Pvm
Instances []GetPi Cloud Instance Pvm Instance  - (List) PVM instances owned by the Cloud Instance.
 - Region string
 - (String) The region the cloud instance lives.
 - Tenant
Id string - (String) The tenant ID that owns this cloud instance.
 - Total
Instances float64 - (String) The count of lpars that belong to this specific cloud instance.
 - Total
Memory float64Consumed  - (String) The total memory consumed by this service instance.
 - Total
Processors float64Consumed  - (String) The total processors consumed by this service instance.
 - Total
Ssd float64Storage Consumed  - (String) The total SSD Storage consumed by this service instance.
 - Total
Standard float64Storage Consumed  - (String) The total Standard Storage consumed by this service instance.
 
- capabilities List<String>
 - (String) Lists the capabilities for this cloud instance.
 - enabled Boolean
 - (Bool) Indicates whether the tenant is enabled.
 - id String
 - (String) PVM Instance ID.
 - pi
Cloud StringInstance Id  - pvm
Instances List<GetPi Cloud Instance Pvm Instance>  - (List) PVM instances owned by the Cloud Instance.
 - region String
 - (String) The region the cloud instance lives.
 - tenant
Id String - (String) The tenant ID that owns this cloud instance.
 - total
Instances Double - (String) The count of lpars that belong to this specific cloud instance.
 - total
Memory DoubleConsumed  - (String) The total memory consumed by this service instance.
 - total
Processors DoubleConsumed  - (String) The total processors consumed by this service instance.
 - total
Ssd DoubleStorage Consumed  - (String) The total SSD Storage consumed by this service instance.
 - total
Standard DoubleStorage Consumed  - (String) The total Standard Storage consumed by this service instance.
 
- capabilities string[]
 - (String) Lists the capabilities for this cloud instance.
 - enabled boolean
 - (Bool) Indicates whether the tenant is enabled.
 - id string
 - (String) PVM Instance ID.
 - pi
Cloud stringInstance Id  - pvm
Instances GetPi Cloud Instance Pvm Instance[]  - (List) PVM instances owned by the Cloud Instance.
 - region string
 - (String) The region the cloud instance lives.
 - tenant
Id string - (String) The tenant ID that owns this cloud instance.
 - total
Instances number - (String) The count of lpars that belong to this specific cloud instance.
 - total
Memory numberConsumed  - (String) The total memory consumed by this service instance.
 - total
Processors numberConsumed  - (String) The total processors consumed by this service instance.
 - total
Ssd numberStorage Consumed  - (String) The total SSD Storage consumed by this service instance.
 - total
Standard numberStorage Consumed  - (String) The total Standard Storage consumed by this service instance.
 
- capabilities Sequence[str]
 - (String) Lists the capabilities for this cloud instance.
 - enabled bool
 - (Bool) Indicates whether the tenant is enabled.
 - id str
 - (String) PVM Instance ID.
 - pi_
cloud_ strinstance_ id  - pvm_
instances Sequence[GetPi Cloud Instance Pvm Instance]  - (List) PVM instances owned by the Cloud Instance.
 - region str
 - (String) The region the cloud instance lives.
 - tenant_
id str - (String) The tenant ID that owns this cloud instance.
 - total_
instances float - (String) The count of lpars that belong to this specific cloud instance.
 - total_
memory_ floatconsumed  - (String) The total memory consumed by this service instance.
 - total_
processors_ floatconsumed  - (String) The total processors consumed by this service instance.
 - total_
ssd_ floatstorage_ consumed  - (String) The total SSD Storage consumed by this service instance.
 - total_
standard_ floatstorage_ consumed  - (String) The total Standard Storage consumed by this service instance.
 
- capabilities List<String>
 - (String) Lists the capabilities for this cloud instance.
 - enabled Boolean
 - (Bool) Indicates whether the tenant is enabled.
 - id String
 - (String) PVM Instance ID.
 - pi
Cloud StringInstance Id  - pvm
Instances List<Property Map> - (List) PVM instances owned by the Cloud Instance.
 - region String
 - (String) The region the cloud instance lives.
 - tenant
Id String - (String) The tenant ID that owns this cloud instance.
 - total
Instances Number - (String) The count of lpars that belong to this specific cloud instance.
 - total
Memory NumberConsumed  - (String) The total memory consumed by this service instance.
 - total
Processors NumberConsumed  - (String) The total processors consumed by this service instance.
 - total
Ssd NumberStorage Consumed  - (String) The total SSD Storage consumed by this service instance.
 - total
Standard NumberStorage Consumed  - (String) The total Standard Storage consumed by this service instance.
 
Supporting Types
GetPiCloudInstancePvmInstance     
- Creation
Date string - (String) Date of PVM instance creation.
 - Crn string
 - (String) The CRN of this resource.
 - Href string
 - (String) Link to Cloud Instance resource.
 - Id string
 - (String) PVM Instance ID.
 - Name string
 - (String) Name of the server.
 - Status string
 - (String) The status of the instance.
 - Systype string
 - (string) System type used to host the instance.
 
- Creation
Date string - (String) Date of PVM instance creation.
 - Crn string
 - (String) The CRN of this resource.
 - Href string
 - (String) Link to Cloud Instance resource.
 - Id string
 - (String) PVM Instance ID.
 - Name string
 - (String) Name of the server.
 - Status string
 - (String) The status of the instance.
 - Systype string
 - (string) System type used to host the instance.
 
- creation
Date String - (String) Date of PVM instance creation.
 - crn String
 - (String) The CRN of this resource.
 - href String
 - (String) Link to Cloud Instance resource.
 - id String
 - (String) PVM Instance ID.
 - name String
 - (String) Name of the server.
 - status String
 - (String) The status of the instance.
 - systype String
 - (string) System type used to host the instance.
 
- creation
Date string - (String) Date of PVM instance creation.
 - crn string
 - (String) The CRN of this resource.
 - href string
 - (String) Link to Cloud Instance resource.
 - id string
 - (String) PVM Instance ID.
 - name string
 - (String) Name of the server.
 - status string
 - (String) The status of the instance.
 - systype string
 - (string) System type used to host the instance.
 
- creation_
date str - (String) Date of PVM instance creation.
 - crn str
 - (String) The CRN of this resource.
 - href str
 - (String) Link to Cloud Instance resource.
 - id str
 - (String) PVM Instance ID.
 - name str
 - (String) Name of the server.
 - status str
 - (String) The status of the instance.
 - systype str
 - (string) System type used to host the instance.
 
- creation
Date String - (String) Date of PVM instance creation.
 - crn String
 - (String) The CRN of this resource.
 - href String
 - (String) Link to Cloud Instance resource.
 - id String
 - (String) PVM Instance ID.
 - name String
 - (String) Name of the server.
 - status String
 - (String) The status of the instance.
 - systype String
 - (string) System type used to host the instance.
 
Package Details
- Repository
 - ibm ibm-cloud/terraform-provider-ibm
 - License
 - Notes
 - This Pulumi package is based on the 
ibmTerraform Provider.