ibm 1.78.0 published on Wednesday, Apr 30, 2025 by ibm-cloud
ibm.getPiInstances
Explore with Pulumi AI
Retrieve information about all Power Systems Virtual Server instances for the given cloud instance. For more information, about Power Virtual Server instances, see getting started with IBM Power Systems Virtual Servers.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as ibm from "@pulumi/ibm";
const dsInstance = ibm.getPiInstances({
piCloudInstanceId: "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
});
import pulumi
import pulumi_ibm as ibm
ds_instance = ibm.get_pi_instances(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.GetPiInstances(ctx, &ibm.GetPiInstancesArgs{
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 dsInstance = Ibm.GetPiInstances.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.GetPiInstancesArgs;
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 dsInstance = IbmFunctions.getPiInstances(GetPiInstancesArgs.builder()
.piCloudInstanceId("49fba6c9-23f8-40bc-9899-aca322ee7d5b")
.build());
}
}
variables:
dsInstance:
fn::invoke:
function: ibm:getPiInstances
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
-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 getPiInstances
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 getPiInstances(args: GetPiInstancesArgs, opts?: InvokeOptions): Promise<GetPiInstancesResult>
function getPiInstancesOutput(args: GetPiInstancesOutputArgs, opts?: InvokeOptions): Output<GetPiInstancesResult>
def get_pi_instances(id: Optional[str] = None,
pi_cloud_instance_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetPiInstancesResult
def get_pi_instances_output(id: Optional[pulumi.Input[str]] = None,
pi_cloud_instance_id: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetPiInstancesResult]
func GetPiInstances(ctx *Context, args *GetPiInstancesArgs, opts ...InvokeOption) (*GetPiInstancesResult, error)
func GetPiInstancesOutput(ctx *Context, args *GetPiInstancesOutputArgs, opts ...InvokeOption) GetPiInstancesResultOutput
> Note: This function is named GetPiInstances
in the Go SDK.
public static class GetPiInstances
{
public static Task<GetPiInstancesResult> InvokeAsync(GetPiInstancesArgs args, InvokeOptions? opts = null)
public static Output<GetPiInstancesResult> Invoke(GetPiInstancesInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetPiInstancesResult> getPiInstances(GetPiInstancesArgs args, InvokeOptions options)
public static Output<GetPiInstancesResult> getPiInstances(GetPiInstancesArgs args, InvokeOptions options)
fn::invoke:
function: ibm:index/getPiInstances:getPiInstances
arguments:
# arguments dictionary
The following arguments are supported:
- Pi
Cloud stringInstance Id - The GUID of the service instance associated with an account.
- Id string
- Pi
Cloud stringInstance Id - The GUID of the service instance associated with an account.
- Id string
- pi
Cloud StringInstance Id - The GUID of the service instance associated with an account.
- id String
- pi
Cloud stringInstance Id - The GUID of the service instance associated with an account.
- id string
- pi_
cloud_ strinstance_ id - The GUID of the service instance associated with an account.
- id str
- pi
Cloud StringInstance Id - The GUID of the service instance associated with an account.
- id String
getPiInstances Result
The following output properties are available:
- Id string
- Pi
Cloud stringInstance Id - Pvm
Instances List<GetPi Instances Pvm Instance> - (List) List of power virtual server instances for the respective cloud instance.
- Id string
- Pi
Cloud stringInstance Id - Pvm
Instances []GetPi Instances Pvm Instance - (List) List of power virtual server instances for the respective cloud instance.
- id String
- pi
Cloud StringInstance Id - pvm
Instances List<GetPi Instances Pvm Instance> - (List) List of power virtual server instances for the respective cloud instance.
- id string
- pi
Cloud stringInstance Id - pvm
Instances GetPi Instances Pvm Instance[] - (List) List of power virtual server instances for the respective cloud instance.
- id str
- pi_
cloud_ strinstance_ id - pvm_
instances Sequence[GetPi Instances Pvm Instance] - (List) List of power virtual server instances for the respective cloud instance.
- id String
- pi
Cloud StringInstance Id - pvm
Instances List<Property Map> - (List) List of power virtual server instances for the respective cloud instance.
Supporting Types
GetPiInstancesPvmInstance
- Crn string
- (String) The CRN of this resource.
- Dedicated
Host stringId - (String) The dedicated host ID where the shared processor pool resides.
- Fault Dictionary<string, string>
- (Map) Fault information, if any.
- Health
Status string - (String) The health of the instance.
- License
Repository doubleCapacity - (Deprecated, Integer) The VTL license repository capacity TB value. Only available with VTL instances.
- Max
Virtual doubleCores - (Integer) The maximum number of virtual cores that can be assigned without rebooting the instance.
- Maxmem double
- (Float) The maximum amount of memory that can be allocated to the instance without shutting down or rebooting the
LPAR
. - Maxproc double
- (Float) The maximum number of processors that can be allocated to the instance without shutting down or rebooting the
LPAR
. - Memory double
- (Float) The amount of memory that is allocated to the instance.
- Min
Virtual doubleCores - (Integer) The minimum number of virtual cores that can be assigned without rebooting the instance.
- Minmem double
- (Float) The minimum amount of memory that must be allocated to the instance.
- Minproc double
- (Float) The minimum number of processors that must be allocated to the instance.
- Networks
List<Get
Pi Instances Pvm Instance Network> - (List) List of networks associated with this instance.
- Pin
Policy string - (String) The pinning policy of the instance.
- Placement
Group stringId - (String) The ID of the placement group that the instance is a member.
- Processors double
- (Float) The number of processors that are allocated to the instance.
- Proctype string
- (String) The procurement type of the instance. Supported values are
shared
anddedicated
. - Pvm
Instance stringId - (String) The unique identifier of the instance.
- Server
Name string - (String) The name of the instance.
- string
- (String) The name of the shared processor pool for the instance.
- string
- (String) The ID of the shared processor pool for the instance.
- Status string
- (String) The status of the instance.
- Storage
Connection string - (String) The storage connection type for the instance
- Storage
Pool string - (String) The storage Pool where server is deployed.
- Storage
Pool boolAffinity - (Boolean) Indicates if all volumes attached to the server must reside in the same storage pool.
- Storage
Type string - (String) The storage type where server is deployed.
- List<string>
- (List) List of user tags attached to the resource.
- Virtual
Cores doubleAssigned - (Integer) The virtual cores that are assigned to the instance.
- Virtual
Serial List<GetNumbers Pi Instances Pvm Instance Virtual Serial Number> - (List) Virtual serial number information
- Crn string
- (String) The CRN of this resource.
- Dedicated
Host stringId - (String) The dedicated host ID where the shared processor pool resides.
- Fault map[string]string
- (Map) Fault information, if any.
- Health
Status string - (String) The health of the instance.
- License
Repository float64Capacity - (Deprecated, Integer) The VTL license repository capacity TB value. Only available with VTL instances.
- Max
Virtual float64Cores - (Integer) The maximum number of virtual cores that can be assigned without rebooting the instance.
- Maxmem float64
- (Float) The maximum amount of memory that can be allocated to the instance without shutting down or rebooting the
LPAR
. - Maxproc float64
- (Float) The maximum number of processors that can be allocated to the instance without shutting down or rebooting the
LPAR
. - Memory float64
- (Float) The amount of memory that is allocated to the instance.
- Min
Virtual float64Cores - (Integer) The minimum number of virtual cores that can be assigned without rebooting the instance.
- Minmem float64
- (Float) The minimum amount of memory that must be allocated to the instance.
- Minproc float64
- (Float) The minimum number of processors that must be allocated to the instance.
- Networks
[]Get
Pi Instances Pvm Instance Network - (List) List of networks associated with this instance.
- Pin
Policy string - (String) The pinning policy of the instance.
- Placement
Group stringId - (String) The ID of the placement group that the instance is a member.
- Processors float64
- (Float) The number of processors that are allocated to the instance.
- Proctype string
- (String) The procurement type of the instance. Supported values are
shared
anddedicated
. - Pvm
Instance stringId - (String) The unique identifier of the instance.
- Server
Name string - (String) The name of the instance.
- string
- (String) The name of the shared processor pool for the instance.
- string
- (String) The ID of the shared processor pool for the instance.
- Status string
- (String) The status of the instance.
- Storage
Connection string - (String) The storage connection type for the instance
- Storage
Pool string - (String) The storage Pool where server is deployed.
- Storage
Pool boolAffinity - (Boolean) Indicates if all volumes attached to the server must reside in the same storage pool.
- Storage
Type string - (String) The storage type where server is deployed.
- []string
- (List) List of user tags attached to the resource.
- Virtual
Cores float64Assigned - (Integer) The virtual cores that are assigned to the instance.
- Virtual
Serial []GetNumbers Pi Instances Pvm Instance Virtual Serial Number - (List) Virtual serial number information
- crn String
- (String) The CRN of this resource.
- dedicated
Host StringId - (String) The dedicated host ID where the shared processor pool resides.
- fault Map<String,String>
- (Map) Fault information, if any.
- health
Status String - (String) The health of the instance.
- license
Repository DoubleCapacity - (Deprecated, Integer) The VTL license repository capacity TB value. Only available with VTL instances.
- max
Virtual DoubleCores - (Integer) The maximum number of virtual cores that can be assigned without rebooting the instance.
- maxmem Double
- (Float) The maximum amount of memory that can be allocated to the instance without shutting down or rebooting the
LPAR
. - maxproc Double
- (Float) The maximum number of processors that can be allocated to the instance without shutting down or rebooting the
LPAR
. - memory Double
- (Float) The amount of memory that is allocated to the instance.
- min
Virtual DoubleCores - (Integer) The minimum number of virtual cores that can be assigned without rebooting the instance.
- minmem Double
- (Float) The minimum amount of memory that must be allocated to the instance.
- minproc Double
- (Float) The minimum number of processors that must be allocated to the instance.
- networks
List<Get
Pi Instances Pvm Instance Network> - (List) List of networks associated with this instance.
- pin
Policy String - (String) The pinning policy of the instance.
- placement
Group StringId - (String) The ID of the placement group that the instance is a member.
- processors Double
- (Float) The number of processors that are allocated to the instance.
- proctype String
- (String) The procurement type of the instance. Supported values are
shared
anddedicated
. - pvm
Instance StringId - (String) The unique identifier of the instance.
- server
Name String - (String) The name of the instance.
- String
- (String) The name of the shared processor pool for the instance.
- String
- (String) The ID of the shared processor pool for the instance.
- status String
- (String) The status of the instance.
- storage
Connection String - (String) The storage connection type for the instance
- storage
Pool String - (String) The storage Pool where server is deployed.
- storage
Pool BooleanAffinity - (Boolean) Indicates if all volumes attached to the server must reside in the same storage pool.
- storage
Type String - (String) The storage type where server is deployed.
- List<String>
- (List) List of user tags attached to the resource.
- virtual
Cores DoubleAssigned - (Integer) The virtual cores that are assigned to the instance.
- virtual
Serial List<GetNumbers Pi Instances Pvm Instance Virtual Serial Number> - (List) Virtual serial number information
- crn string
- (String) The CRN of this resource.
- dedicated
Host stringId - (String) The dedicated host ID where the shared processor pool resides.
- fault {[key: string]: string}
- (Map) Fault information, if any.
- health
Status string - (String) The health of the instance.
- license
Repository numberCapacity - (Deprecated, Integer) The VTL license repository capacity TB value. Only available with VTL instances.
- max
Virtual numberCores - (Integer) The maximum number of virtual cores that can be assigned without rebooting the instance.
- maxmem number
- (Float) The maximum amount of memory that can be allocated to the instance without shutting down or rebooting the
LPAR
. - maxproc number
- (Float) The maximum number of processors that can be allocated to the instance without shutting down or rebooting the
LPAR
. - memory number
- (Float) The amount of memory that is allocated to the instance.
- min
Virtual numberCores - (Integer) The minimum number of virtual cores that can be assigned without rebooting the instance.
- minmem number
- (Float) The minimum amount of memory that must be allocated to the instance.
- minproc number
- (Float) The minimum number of processors that must be allocated to the instance.
- networks
Get
Pi Instances Pvm Instance Network[] - (List) List of networks associated with this instance.
- pin
Policy string - (String) The pinning policy of the instance.
- placement
Group stringId - (String) The ID of the placement group that the instance is a member.
- processors number
- (Float) The number of processors that are allocated to the instance.
- proctype string
- (String) The procurement type of the instance. Supported values are
shared
anddedicated
. - pvm
Instance stringId - (String) The unique identifier of the instance.
- server
Name string - (String) The name of the instance.
- string
- (String) The name of the shared processor pool for the instance.
- string
- (String) The ID of the shared processor pool for the instance.
- status string
- (String) The status of the instance.
- storage
Connection string - (String) The storage connection type for the instance
- storage
Pool string - (String) The storage Pool where server is deployed.
- storage
Pool booleanAffinity - (Boolean) Indicates if all volumes attached to the server must reside in the same storage pool.
- storage
Type string - (String) The storage type where server is deployed.
- string[]
- (List) List of user tags attached to the resource.
- virtual
Cores numberAssigned - (Integer) The virtual cores that are assigned to the instance.
- virtual
Serial GetNumbers Pi Instances Pvm Instance Virtual Serial Number[] - (List) Virtual serial number information
- crn str
- (String) The CRN of this resource.
- dedicated_
host_ strid - (String) The dedicated host ID where the shared processor pool resides.
- fault Mapping[str, str]
- (Map) Fault information, if any.
- health_
status str - (String) The health of the instance.
- license_
repository_ floatcapacity - (Deprecated, Integer) The VTL license repository capacity TB value. Only available with VTL instances.
- max_
virtual_ floatcores - (Integer) The maximum number of virtual cores that can be assigned without rebooting the instance.
- maxmem float
- (Float) The maximum amount of memory that can be allocated to the instance without shutting down or rebooting the
LPAR
. - maxproc float
- (Float) The maximum number of processors that can be allocated to the instance without shutting down or rebooting the
LPAR
. - memory float
- (Float) The amount of memory that is allocated to the instance.
- min_
virtual_ floatcores - (Integer) The minimum number of virtual cores that can be assigned without rebooting the instance.
- minmem float
- (Float) The minimum amount of memory that must be allocated to the instance.
- minproc float
- (Float) The minimum number of processors that must be allocated to the instance.
- networks
Sequence[Get
Pi Instances Pvm Instance Network] - (List) List of networks associated with this instance.
- pin_
policy str - (String) The pinning policy of the instance.
- placement_
group_ strid - (String) The ID of the placement group that the instance is a member.
- processors float
- (Float) The number of processors that are allocated to the instance.
- proctype str
- (String) The procurement type of the instance. Supported values are
shared
anddedicated
. - pvm_
instance_ strid - (String) The unique identifier of the instance.
- server_
name str - (String) The name of the instance.
- str
- (String) The name of the shared processor pool for the instance.
- str
- (String) The ID of the shared processor pool for the instance.
- status str
- (String) The status of the instance.
- storage_
connection str - (String) The storage connection type for the instance
- storage_
pool str - (String) The storage Pool where server is deployed.
- storage_
pool_ boolaffinity - (Boolean) Indicates if all volumes attached to the server must reside in the same storage pool.
- storage_
type str - (String) The storage type where server is deployed.
- Sequence[str]
- (List) List of user tags attached to the resource.
- virtual_
cores_ floatassigned - (Integer) The virtual cores that are assigned to the instance.
- virtual_
serial_ Sequence[Getnumbers Pi Instances Pvm Instance Virtual Serial Number] - (List) Virtual serial number information
- crn String
- (String) The CRN of this resource.
- dedicated
Host StringId - (String) The dedicated host ID where the shared processor pool resides.
- fault Map<String>
- (Map) Fault information, if any.
- health
Status String - (String) The health of the instance.
- license
Repository NumberCapacity - (Deprecated, Integer) The VTL license repository capacity TB value. Only available with VTL instances.
- max
Virtual NumberCores - (Integer) The maximum number of virtual cores that can be assigned without rebooting the instance.
- maxmem Number
- (Float) The maximum amount of memory that can be allocated to the instance without shutting down or rebooting the
LPAR
. - maxproc Number
- (Float) The maximum number of processors that can be allocated to the instance without shutting down or rebooting the
LPAR
. - memory Number
- (Float) The amount of memory that is allocated to the instance.
- min
Virtual NumberCores - (Integer) The minimum number of virtual cores that can be assigned without rebooting the instance.
- minmem Number
- (Float) The minimum amount of memory that must be allocated to the instance.
- minproc Number
- (Float) The minimum number of processors that must be allocated to the instance.
- networks List<Property Map>
- (List) List of networks associated with this instance.
- pin
Policy String - (String) The pinning policy of the instance.
- placement
Group StringId - (String) The ID of the placement group that the instance is a member.
- processors Number
- (Float) The number of processors that are allocated to the instance.
- proctype String
- (String) The procurement type of the instance. Supported values are
shared
anddedicated
. - pvm
Instance StringId - (String) The unique identifier of the instance.
- server
Name String - (String) The name of the instance.
- String
- (String) The name of the shared processor pool for the instance.
- String
- (String) The ID of the shared processor pool for the instance.
- status String
- (String) The status of the instance.
- storage
Connection String - (String) The storage connection type for the instance
- storage
Pool String - (String) The storage Pool where server is deployed.
- storage
Pool BooleanAffinity - (Boolean) Indicates if all volumes attached to the server must reside in the same storage pool.
- storage
Type String - (String) The storage type where server is deployed.
- List<String>
- (List) List of user tags attached to the resource.
- virtual
Cores NumberAssigned - (Integer) The virtual cores that are assigned to the instance.
- virtual
Serial List<Property Map>Numbers - (List) Virtual serial number information
GetPiInstancesPvmInstanceNetwork
- External
Ip string - (String) The external IP address of the instance.
- Ip string
- (String) The IP address of the instance.
- Mac
Address string - (String) The MAC address of the instance.
- Network
Id string - (String) The network ID of the instance.
- Network
Interface stringId - (String) ID of the network interface.
- Network
Name string - (String) The network name of the instance.
- Network
Security List<string>Group Ids - (List) IDs of the network necurity groups that the network interface is a member of.
- Network
Security List<string>Groups Hreves - (List) Links to the network security groups that the network interface is a member of.
- Type string
- (String) The type of the network.
- External
Ip string - (String) The external IP address of the instance.
- Ip string
- (String) The IP address of the instance.
- Mac
Address string - (String) The MAC address of the instance.
- Network
Id string - (String) The network ID of the instance.
- Network
Interface stringId - (String) ID of the network interface.
- Network
Name string - (String) The network name of the instance.
- Network
Security []stringGroup Ids - (List) IDs of the network necurity groups that the network interface is a member of.
- Network
Security []stringGroups Hreves - (List) Links to the network security groups that the network interface is a member of.
- Type string
- (String) The type of the network.
- external
Ip String - (String) The external IP address of the instance.
- ip String
- (String) The IP address of the instance.
- mac
Address String - (String) The MAC address of the instance.
- network
Id String - (String) The network ID of the instance.
- network
Interface StringId - (String) ID of the network interface.
- network
Name String - (String) The network name of the instance.
- network
Security List<String>Group Ids - (List) IDs of the network necurity groups that the network interface is a member of.
- network
Security List<String>Groups Hreves - (List) Links to the network security groups that the network interface is a member of.
- type String
- (String) The type of the network.
- external
Ip string - (String) The external IP address of the instance.
- ip string
- (String) The IP address of the instance.
- mac
Address string - (String) The MAC address of the instance.
- network
Id string - (String) The network ID of the instance.
- network
Interface stringId - (String) ID of the network interface.
- network
Name string - (String) The network name of the instance.
- network
Security string[]Group Ids - (List) IDs of the network necurity groups that the network interface is a member of.
- network
Security string[]Groups Hreves - (List) Links to the network security groups that the network interface is a member of.
- type string
- (String) The type of the network.
- external_
ip str - (String) The external IP address of the instance.
- ip str
- (String) The IP address of the instance.
- mac_
address str - (String) The MAC address of the instance.
- network_
id str - (String) The network ID of the instance.
- network_
interface_ strid - (String) ID of the network interface.
- network_
name str - (String) The network name of the instance.
- network_
security_ Sequence[str]group_ ids - (List) IDs of the network necurity groups that the network interface is a member of.
- network_
security_ Sequence[str]groups_ hreves - (List) Links to the network security groups that the network interface is a member of.
- type str
- (String) The type of the network.
- external
Ip String - (String) The external IP address of the instance.
- ip String
- (String) The IP address of the instance.
- mac
Address String - (String) The MAC address of the instance.
- network
Id String - (String) The network ID of the instance.
- network
Interface StringId - (String) ID of the network interface.
- network
Name String - (String) The network name of the instance.
- network
Security List<String>Group Ids - (List) IDs of the network necurity groups that the network interface is a member of.
- network
Security List<String>Groups Hreves - (List) Links to the network security groups that the network interface is a member of.
- type String
- (String) The type of the network.
GetPiInstancesPvmInstanceVirtualSerialNumber
- Description string
- (String) Description for virtual serial number.
- Serial string
- (String) Virtual serial number.
- Description string
- (String) Description for virtual serial number.
- Serial string
- (String) Virtual serial number.
- description String
- (String) Description for virtual serial number.
- serial String
- (String) Virtual serial number.
- description string
- (String) Description for virtual serial number.
- serial string
- (String) Virtual serial number.
- description str
- (String) Description for virtual serial number.
- serial str
- (String) Virtual serial number.
- description String
- (String) Description for virtual serial number.
- serial String
- (String) Virtual serial number.
Package Details
- Repository
- ibm ibm-cloud/terraform-provider-ibm
- License
- Notes
- This Pulumi package is based on the
ibm
Terraform Provider.