1. Packages
  2. Ibm Provider
  3. API Docs
  4. getPiInstanceNetworks
ibm 1.87.0-beta1 published on Monday, Dec 22, 2025 by ibm-cloud
Schema (JSON)
ibm-cloud/terraform-provider-ibm

ibm.getPiInstanceNetworks

ibm logo
ibm 1.87.0-beta1 published on Monday, Dec 22, 2025 by ibm-cloud
Schema (JSON)
ibm-cloud/terraform-provider-ibm

    Retrieve information about all networks on a Power Systems Virtual Server 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 dsInstanceNetworks = ibm.getPiInstanceNetworks({
    piCloudInstanceId: "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
    piInstanceId: "cea6651a-bc0a-4438-9f8a-a0770b112ebb",
});

    import pulumi
import pulumi_ibm as ibm

ds_instance_networks = ibm.get_pi_instance_networks(pi_cloud_instance_id="49fba6c9-23f8-40bc-9899-aca322ee7d5b",
    pi_instance_id="cea6651a-bc0a-4438-9f8a-a0770b112ebb")

    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.GetPiInstanceNetworks(ctx, &ibm.GetPiInstanceNetworksArgs{
			PiCloudInstanceId: "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
			PiInstanceId:      "cea6651a-bc0a-4438-9f8a-a0770b112ebb",
		}, 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 dsInstanceNetworks = Ibm.GetPiInstanceNetworks.Invoke(new()
    {
        PiCloudInstanceId = "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
        PiInstanceId = "cea6651a-bc0a-4438-9f8a-a0770b112ebb",
    });

});

    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.GetPiInstanceNetworksArgs;
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 dsInstanceNetworks = IbmFunctions.getPiInstanceNetworks(GetPiInstanceNetworksArgs.builder()
            .piCloudInstanceId("49fba6c9-23f8-40bc-9899-aca322ee7d5b")
            .piInstanceId("cea6651a-bc0a-4438-9f8a-a0770b112ebb")
            .build());

    }
}

    variables:
  dsInstanceNetworks:
    fn::invoke:
      function: ibm:getPiInstanceNetworks
      arguments:
        piCloudInstanceId: 49fba6c9-23f8-40bc-9899-aca322ee7d5b
        piInstanceId: cea6651a-bc0a-4438-9f8a-a0770b112ebb

    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 getPiInstanceNetworks

    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 getPiInstanceNetworks(args: GetPiInstanceNetworksArgs, opts?: InvokeOptions): Promise<GetPiInstanceNetworksResult>
function getPiInstanceNetworksOutput(args: GetPiInstanceNetworksOutputArgs, opts?: InvokeOptions): Output<GetPiInstanceNetworksResult>
    def get_pi_instance_networks(id: Optional[str] = None,
                             pi_cloud_instance_id: Optional[str] = None,
                             pi_instance_id: Optional[str] = None,
                             opts: Optional[InvokeOptions] = None) -> GetPiInstanceNetworksResult
def get_pi_instance_networks_output(id: Optional[pulumi.Input[str]] = None,
                             pi_cloud_instance_id: Optional[pulumi.Input[str]] = None,
                             pi_instance_id: Optional[pulumi.Input[str]] = None,
                             opts: Optional[InvokeOptions] = None) -> Output[GetPiInstanceNetworksResult]
    func GetPiInstanceNetworks(ctx *Context, args *GetPiInstanceNetworksArgs, opts ...InvokeOption) (*GetPiInstanceNetworksResult, error)
func GetPiInstanceNetworksOutput(ctx *Context, args *GetPiInstanceNetworksOutputArgs, opts ...InvokeOption) GetPiInstanceNetworksResultOutput

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

    public static class GetPiInstanceNetworks 
{
    public static Task<GetPiInstanceNetworksResult> InvokeAsync(GetPiInstanceNetworksArgs args, InvokeOptions? opts = null)
    public static Output<GetPiInstanceNetworksResult> Invoke(GetPiInstanceNetworksInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetPiInstanceNetworksResult> getPiInstanceNetworks(GetPiInstanceNetworksArgs args, InvokeOptions options)
public static Output<GetPiInstanceNetworksResult> getPiInstanceNetworks(GetPiInstanceNetworksArgs args, InvokeOptions options)

    fn::invoke:
  function: ibm:index/getPiInstanceNetworks:getPiInstanceNetworks
  arguments:
    # arguments dictionary

    The following arguments are supported:

    PiCloudInstanceId string
    The GUID of the service instance associated with an account.
    PiInstanceId string
    The PVM instance id.
    Id string
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    PiCloudInstanceId string
    The GUID of the service instance associated with an account.
    PiInstanceId string
    The PVM instance id.
    Id string
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    piCloudInstanceId String
    The GUID of the service instance associated with an account.
    piInstanceId String
    The PVM instance id.
    id String
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    piCloudInstanceId string
    The GUID of the service instance associated with an account.
    piInstanceId string
    The PVM instance id.
    id string
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    pi_cloud_instance_id str
    The GUID of the service instance associated with an account.
    pi_instance_id str
    The PVM instance id.
    id str
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    piCloudInstanceId String
    The GUID of the service instance associated with an account.
    piInstanceId String
    The PVM instance id.
    id String
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.

    getPiInstanceNetworks Result

    The following output properties are available:

    Id string
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    Networks List<GetPiInstanceNetworksNetwork>
    (List) List of networks associated with this instance. Nested scheme for networks:
    PiCloudInstanceId string
    PiInstanceId string
    Id string
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    Networks []GetPiInstanceNetworksNetwork
    (List) List of networks associated with this instance. Nested scheme for networks:
    PiCloudInstanceId string
    PiInstanceId string
    id String
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    networks List<GetPiInstanceNetworksNetwork>
    (List) List of networks associated with this instance. Nested scheme for networks:
    piCloudInstanceId String
    piInstanceId String
    id string
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    networks GetPiInstanceNetworksNetwork[]
    (List) List of networks associated with this instance. Nested scheme for networks:
    piCloudInstanceId string
    piInstanceId string
    id str
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    networks Sequence[GetPiInstanceNetworksNetwork]
    (List) List of networks associated with this instance. Nested scheme for networks:
    pi_cloud_instance_id str
    pi_instance_id str
    id String
    (String) The unique identifier of the data source in the form <pi_cloud_instance_id>/<pi_instance_id>.
    networks List<Property Map>
    (List) List of networks associated with this instance. Nested scheme for networks:
    piCloudInstanceId String
    piInstanceId String

    Supporting Types

    GetPiInstanceNetworksNetwork

    ExternalIp string
    (String) The external IP address of the network (for pub-VLAN networks).
    Href string
    (String) Link to this PVM instance network.
    IpAddress string
    (String) The IP address of the network interface.
    MacAddress string
    (String) The MAC address of the network interface.
    NetworkId string
    (String) The network ID.
    NetworkInterfaceId string
    (String) ID of the network interface.
    NetworkName string
    (String) The network name.
    NetworkSecurityGroupIds List<string>
    (List) IDs of the network security groups that the network interface is a member of.
    NetworkSecurityGroupsHreves List<string>
    (List) Links to the network security groups that the network interface is a member of.
    Type string
    (String) The network type.
    Version double
    (Float) Version of the network information.
    ExternalIp string
    (String) The external IP address of the network (for pub-VLAN networks).
    Href string
    (String) Link to this PVM instance network.
    IpAddress string
    (String) The IP address of the network interface.
    MacAddress string
    (String) The MAC address of the network interface.
    NetworkId string
    (String) The network ID.
    NetworkInterfaceId string
    (String) ID of the network interface.
    NetworkName string
    (String) The network name.
    NetworkSecurityGroupIds []string
    (List) IDs of the network security groups that the network interface is a member of.
    NetworkSecurityGroupsHreves []string
    (List) Links to the network security groups that the network interface is a member of.
    Type string
    (String) The network type.
    Version float64
    (Float) Version of the network information.
    externalIp String
    (String) The external IP address of the network (for pub-VLAN networks).
    href String
    (String) Link to this PVM instance network.
    ipAddress String
    (String) The IP address of the network interface.
    macAddress String
    (String) The MAC address of the network interface.
    networkId String
    (String) The network ID.
    networkInterfaceId String
    (String) ID of the network interface.
    networkName String
    (String) The network name.
    networkSecurityGroupIds List<String>
    (List) IDs of the network security groups that the network interface is a member of.
    networkSecurityGroupsHreves List<String>
    (List) Links to the network security groups that the network interface is a member of.
    type String
    (String) The network type.
    version Double
    (Float) Version of the network information.
    externalIp string
    (String) The external IP address of the network (for pub-VLAN networks).
    href string
    (String) Link to this PVM instance network.
    ipAddress string
    (String) The IP address of the network interface.
    macAddress string
    (String) The MAC address of the network interface.
    networkId string
    (String) The network ID.
    networkInterfaceId string
    (String) ID of the network interface.
    networkName string
    (String) The network name.
    networkSecurityGroupIds string[]
    (List) IDs of the network security groups that the network interface is a member of.
    networkSecurityGroupsHreves string[]
    (List) Links to the network security groups that the network interface is a member of.
    type string
    (String) The network type.
    version number
    (Float) Version of the network information.
    external_ip str
    (String) The external IP address of the network (for pub-VLAN networks).
    href str
    (String) Link to this PVM instance network.
    ip_address str
    (String) The IP address of the network interface.
    mac_address str
    (String) The MAC address of the network interface.
    network_id str
    (String) The network ID.
    network_interface_id str
    (String) ID of the network interface.
    network_name str
    (String) The network name.
    network_security_group_ids Sequence[str]
    (List) IDs of the network security groups that the network interface is a member of.
    network_security_groups_hreves Sequence[str]
    (List) Links to the network security groups that the network interface is a member of.
    type str
    (String) The network type.
    version float
    (Float) Version of the network information.
    externalIp String
    (String) The external IP address of the network (for pub-VLAN networks).
    href String
    (String) Link to this PVM instance network.
    ipAddress String
    (String) The IP address of the network interface.
    macAddress String
    (String) The MAC address of the network interface.
    networkId String
    (String) The network ID.
    networkInterfaceId String
    (String) ID of the network interface.
    networkName String
    (String) The network name.
    networkSecurityGroupIds List<String>
    (List) IDs of the network security groups that the network interface is a member of.
    networkSecurityGroupsHreves List<String>
    (List) Links to the network security groups that the network interface is a member of.
    type String
    (String) The network type.
    version Number
    (Float) Version of the network information.

    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.87.0-beta1 published on Monday, Dec 22, 2025 by ibm-cloud
    Schema (JSON)
    ibm-cloud/terraform-provider-ibm
      Meet Neo: Your AI Platform Teammate