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

ibm.getPiVolumeGroupRemoteCopyRelationships

Explore with Pulumi AI

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

    Retrieves information about remote copy relationships of a volume group. For more information, about managing a volume group, see moving data to the cloud.

    Example Usage

    The following example retrieves information about about remote copy relationships of a volume group in Power Systems Virtual Server.

    import * as pulumi from "@pulumi/pulumi";
    import * as ibm from "@pulumi/ibm";
    
    const dsVolumeGroupRemoteCopyRelationships = ibm.getPiVolumeGroupRemoteCopyRelationships({
        piCloudInstanceId: "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
        piVolumeGroupId: "810b5fde-e054-4577-ab5e-3f866a1f6f66",
    });
    
    import pulumi
    import pulumi_ibm as ibm
    
    ds_volume_group_remote_copy_relationships = ibm.get_pi_volume_group_remote_copy_relationships(pi_cloud_instance_id="49fba6c9-23f8-40bc-9899-aca322ee7d5b",
        pi_volume_group_id="810b5fde-e054-4577-ab5e-3f866a1f6f66")
    
    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.GetPiVolumeGroupRemoteCopyRelationships(ctx, &ibm.GetPiVolumeGroupRemoteCopyRelationshipsArgs{
    			PiCloudInstanceId: "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
    			PiVolumeGroupId:   "810b5fde-e054-4577-ab5e-3f866a1f6f66",
    		}, 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 dsVolumeGroupRemoteCopyRelationships = Ibm.GetPiVolumeGroupRemoteCopyRelationships.Invoke(new()
        {
            PiCloudInstanceId = "49fba6c9-23f8-40bc-9899-aca322ee7d5b",
            PiVolumeGroupId = "810b5fde-e054-4577-ab5e-3f866a1f6f66",
        });
    
    });
    
    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.GetPiVolumeGroupRemoteCopyRelationshipsArgs;
    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 dsVolumeGroupRemoteCopyRelationships = IbmFunctions.getPiVolumeGroupRemoteCopyRelationships(GetPiVolumeGroupRemoteCopyRelationshipsArgs.builder()
                .piCloudInstanceId("49fba6c9-23f8-40bc-9899-aca322ee7d5b")
                .piVolumeGroupId("810b5fde-e054-4577-ab5e-3f866a1f6f66")
                .build());
    
        }
    }
    
    variables:
      dsVolumeGroupRemoteCopyRelationships:
        fn::invoke:
          function: ibm:getPiVolumeGroupRemoteCopyRelationships
          arguments:
            piCloudInstanceId: 49fba6c9-23f8-40bc-9899-aca322ee7d5b
            piVolumeGroupId: 810b5fde-e054-4577-ab5e-3f866a1f6f66
    

    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 getPiVolumeGroupRemoteCopyRelationships

    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 getPiVolumeGroupRemoteCopyRelationships(args: GetPiVolumeGroupRemoteCopyRelationshipsArgs, opts?: InvokeOptions): Promise<GetPiVolumeGroupRemoteCopyRelationshipsResult>
    function getPiVolumeGroupRemoteCopyRelationshipsOutput(args: GetPiVolumeGroupRemoteCopyRelationshipsOutputArgs, opts?: InvokeOptions): Output<GetPiVolumeGroupRemoteCopyRelationshipsResult>
    def get_pi_volume_group_remote_copy_relationships(id: Optional[str] = None,
                                                      pi_cloud_instance_id: Optional[str] = None,
                                                      pi_volume_group_id: Optional[str] = None,
                                                      opts: Optional[InvokeOptions] = None) -> GetPiVolumeGroupRemoteCopyRelationshipsResult
    def get_pi_volume_group_remote_copy_relationships_output(id: Optional[pulumi.Input[str]] = None,
                                                      pi_cloud_instance_id: Optional[pulumi.Input[str]] = None,
                                                      pi_volume_group_id: Optional[pulumi.Input[str]] = None,
                                                      opts: Optional[InvokeOptions] = None) -> Output[GetPiVolumeGroupRemoteCopyRelationshipsResult]
    func GetPiVolumeGroupRemoteCopyRelationships(ctx *Context, args *GetPiVolumeGroupRemoteCopyRelationshipsArgs, opts ...InvokeOption) (*GetPiVolumeGroupRemoteCopyRelationshipsResult, error)
    func GetPiVolumeGroupRemoteCopyRelationshipsOutput(ctx *Context, args *GetPiVolumeGroupRemoteCopyRelationshipsOutputArgs, opts ...InvokeOption) GetPiVolumeGroupRemoteCopyRelationshipsResultOutput

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

    public static class GetPiVolumeGroupRemoteCopyRelationships 
    {
        public static Task<GetPiVolumeGroupRemoteCopyRelationshipsResult> InvokeAsync(GetPiVolumeGroupRemoteCopyRelationshipsArgs args, InvokeOptions? opts = null)
        public static Output<GetPiVolumeGroupRemoteCopyRelationshipsResult> Invoke(GetPiVolumeGroupRemoteCopyRelationshipsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetPiVolumeGroupRemoteCopyRelationshipsResult> getPiVolumeGroupRemoteCopyRelationships(GetPiVolumeGroupRemoteCopyRelationshipsArgs args, InvokeOptions options)
    public static Output<GetPiVolumeGroupRemoteCopyRelationshipsResult> getPiVolumeGroupRemoteCopyRelationships(GetPiVolumeGroupRemoteCopyRelationshipsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: ibm:index/getPiVolumeGroupRemoteCopyRelationships:getPiVolumeGroupRemoteCopyRelationships
      arguments:
        # arguments dictionary

    The following arguments are supported:

    PiCloudInstanceId string
    The GUID of the service instance associated with an account.
    PiVolumeGroupId string
    The ID of the volume group for which you want to retrieve detailed information.
    Id string
    (String) The unique identifier of the volume group.
    PiCloudInstanceId string
    The GUID of the service instance associated with an account.
    PiVolumeGroupId string
    The ID of the volume group for which you want to retrieve detailed information.
    Id string
    (String) The unique identifier of the volume group.
    piCloudInstanceId String
    The GUID of the service instance associated with an account.
    piVolumeGroupId String
    The ID of the volume group for which you want to retrieve detailed information.
    id String
    (String) The unique identifier of the volume group.
    piCloudInstanceId string
    The GUID of the service instance associated with an account.
    piVolumeGroupId string
    The ID of the volume group for which you want to retrieve detailed information.
    id string
    (String) The unique identifier of the volume group.
    pi_cloud_instance_id str
    The GUID of the service instance associated with an account.
    pi_volume_group_id str
    The ID of the volume group for which you want to retrieve detailed information.
    id str
    (String) The unique identifier of the volume group.
    piCloudInstanceId String
    The GUID of the service instance associated with an account.
    piVolumeGroupId String
    The ID of the volume group for which you want to retrieve detailed information.
    id String
    (String) The unique identifier of the volume group.

    getPiVolumeGroupRemoteCopyRelationships Result

    The following output properties are available:

    Id string
    (String) The unique identifier of the volume group.
    PiCloudInstanceId string
    PiVolumeGroupId string
    RemoteCopyRelationships List<GetPiVolumeGroupRemoteCopyRelationshipsRemoteCopyRelationship>
    (List) List of remote copy relationships.
    Id string
    (String) The unique identifier of the volume group.
    PiCloudInstanceId string
    PiVolumeGroupId string
    RemoteCopyRelationships []GetPiVolumeGroupRemoteCopyRelationshipsRemoteCopyRelationship
    (List) List of remote copy relationships.
    id String
    (String) The unique identifier of the volume group.
    piCloudInstanceId String
    piVolumeGroupId String
    remoteCopyRelationships List<GetPiVolumeGroupRemoteCopyRelationshipsRemoteCopyRelationship>
    (List) List of remote copy relationships.
    id string
    (String) The unique identifier of the volume group.
    piCloudInstanceId string
    piVolumeGroupId string
    remoteCopyRelationships GetPiVolumeGroupRemoteCopyRelationshipsRemoteCopyRelationship[]
    (List) List of remote copy relationships.
    id str
    (String) The unique identifier of the volume group.
    pi_cloud_instance_id str
    pi_volume_group_id str
    remote_copy_relationships Sequence[GetPiVolumeGroupRemoteCopyRelationshipsRemoteCopyRelationship]
    (List) List of remote copy relationships.
    id String
    (String) The unique identifier of the volume group.
    piCloudInstanceId String
    piVolumeGroupId String
    remoteCopyRelationships List<Property Map>
    (List) List of remote copy relationships.

    Supporting Types

    GetPiVolumeGroupRemoteCopyRelationshipsRemoteCopyRelationship

    AuxiliaryChangedVolumeName string
    (String) The name of the volume that is acting as the auxiliary change volume for the relationship.
    AuxiliaryVolumeName string
    (String) The auxiliary volume name at storage host level.
    ConsistencyGroupName string
    (String) The consistency group name if volume is a part of volume group.
    CopyType string
    (String) The copy type.
    CyclingMode string
    (String) The type of cycling mode used.
    FreezeTime string
    (String) The freeze time of remote copy relationship.
    MasterChangedVolumeName string
    (String) The name of the volume that is acting as the master change volume for the relationship.
    MasterVolumeName string
    (String) The master volume name at storage host level.
    Name string
    (String) The remote copy relationship name.
    PrimaryRole string
    (String) Indicates whether master/aux volume is playing the primary role.
    Progress double
    (Integer) The relationship progress.
    RemoteCopyId string
    (String) The remote copy relationship ID.
    State string
    (String) The relationship state.
    Synchronized string
    (String) Indicates whether the relationship is synchronized.
    AuxiliaryChangedVolumeName string
    (String) The name of the volume that is acting as the auxiliary change volume for the relationship.
    AuxiliaryVolumeName string
    (String) The auxiliary volume name at storage host level.
    ConsistencyGroupName string
    (String) The consistency group name if volume is a part of volume group.
    CopyType string
    (String) The copy type.
    CyclingMode string
    (String) The type of cycling mode used.
    FreezeTime string
    (String) The freeze time of remote copy relationship.
    MasterChangedVolumeName string
    (String) The name of the volume that is acting as the master change volume for the relationship.
    MasterVolumeName string
    (String) The master volume name at storage host level.
    Name string
    (String) The remote copy relationship name.
    PrimaryRole string
    (String) Indicates whether master/aux volume is playing the primary role.
    Progress float64
    (Integer) The relationship progress.
    RemoteCopyId string
    (String) The remote copy relationship ID.
    State string
    (String) The relationship state.
    Synchronized string
    (String) Indicates whether the relationship is synchronized.
    auxiliaryChangedVolumeName String
    (String) The name of the volume that is acting as the auxiliary change volume for the relationship.
    auxiliaryVolumeName String
    (String) The auxiliary volume name at storage host level.
    consistencyGroupName String
    (String) The consistency group name if volume is a part of volume group.
    copyType String
    (String) The copy type.
    cyclingMode String
    (String) The type of cycling mode used.
    freezeTime String
    (String) The freeze time of remote copy relationship.
    masterChangedVolumeName String
    (String) The name of the volume that is acting as the master change volume for the relationship.
    masterVolumeName String
    (String) The master volume name at storage host level.
    name String
    (String) The remote copy relationship name.
    primaryRole String
    (String) Indicates whether master/aux volume is playing the primary role.
    progress Double
    (Integer) The relationship progress.
    remoteCopyId String
    (String) The remote copy relationship ID.
    state String
    (String) The relationship state.
    synchronized_ String
    (String) Indicates whether the relationship is synchronized.
    auxiliaryChangedVolumeName string
    (String) The name of the volume that is acting as the auxiliary change volume for the relationship.
    auxiliaryVolumeName string
    (String) The auxiliary volume name at storage host level.
    consistencyGroupName string
    (String) The consistency group name if volume is a part of volume group.
    copyType string
    (String) The copy type.
    cyclingMode string
    (String) The type of cycling mode used.
    freezeTime string
    (String) The freeze time of remote copy relationship.
    masterChangedVolumeName string
    (String) The name of the volume that is acting as the master change volume for the relationship.
    masterVolumeName string
    (String) The master volume name at storage host level.
    name string
    (String) The remote copy relationship name.
    primaryRole string
    (String) Indicates whether master/aux volume is playing the primary role.
    progress number
    (Integer) The relationship progress.
    remoteCopyId string
    (String) The remote copy relationship ID.
    state string
    (String) The relationship state.
    synchronized string
    (String) Indicates whether the relationship is synchronized.
    auxiliary_changed_volume_name str
    (String) The name of the volume that is acting as the auxiliary change volume for the relationship.
    auxiliary_volume_name str
    (String) The auxiliary volume name at storage host level.
    consistency_group_name str
    (String) The consistency group name if volume is a part of volume group.
    copy_type str
    (String) The copy type.
    cycling_mode str
    (String) The type of cycling mode used.
    freeze_time str
    (String) The freeze time of remote copy relationship.
    master_changed_volume_name str
    (String) The name of the volume that is acting as the master change volume for the relationship.
    master_volume_name str
    (String) The master volume name at storage host level.
    name str
    (String) The remote copy relationship name.
    primary_role str
    (String) Indicates whether master/aux volume is playing the primary role.
    progress float
    (Integer) The relationship progress.
    remote_copy_id str
    (String) The remote copy relationship ID.
    state str
    (String) The relationship state.
    synchronized str
    (String) Indicates whether the relationship is synchronized.
    auxiliaryChangedVolumeName String
    (String) The name of the volume that is acting as the auxiliary change volume for the relationship.
    auxiliaryVolumeName String
    (String) The auxiliary volume name at storage host level.
    consistencyGroupName String
    (String) The consistency group name if volume is a part of volume group.
    copyType String
    (String) The copy type.
    cyclingMode String
    (String) The type of cycling mode used.
    freezeTime String
    (String) The freeze time of remote copy relationship.
    masterChangedVolumeName String
    (String) The name of the volume that is acting as the master change volume for the relationship.
    masterVolumeName String
    (String) The master volume name at storage host level.
    name String
    (String) The remote copy relationship name.
    primaryRole String
    (String) Indicates whether master/aux volume is playing the primary role.
    progress Number
    (Integer) The relationship progress.
    remoteCopyId String
    (String) The remote copy relationship ID.
    state String
    (String) The relationship state.
    synchronized String
    (String) Indicates whether the relationship is synchronized.

    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