1. Packages
  2. Packages
  3. Gcore Provider
  4. API Docs
  5. getCloudVolumeSnapshots
Viewing docs for gcore 2.0.0-alpha.15
published on Thursday, Aug 6, 2026 by g-core
Viewing docs for gcore 2.0.0-alpha.15
published on Thursday, Aug 6, 2026 by g-core

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
    import * as gcore from "@pulumi/gcore";
    
    const exampleCloudVolumeSnapshots = gcore.getCloudVolumeSnapshots({
        projectId: 1,
        regionId: 1,
        instanceId: "550e8400-e29b-41d4-a716-446655440000",
        lifecyclePolicyId: 1,
        scheduleId: "67baa7d1-08ea-4fc5-bef2-6b2465b7d227",
        volumeId: "3ed9e2ce-f906-47fb-ba32-c25a3f63df4f",
    });
    
    import pulumi
    import pulumi_gcore as gcore
    
    example_cloud_volume_snapshots = gcore.get_cloud_volume_snapshots(project_id=1,
        region_id=1,
        instance_id="550e8400-e29b-41d4-a716-446655440000",
        lifecycle_policy_id=1,
        schedule_id="67baa7d1-08ea-4fc5-bef2-6b2465b7d227",
        volume_id="3ed9e2ce-f906-47fb-ba32-c25a3f63df4f")
    
    package main
    
    import (
    	"github.com/pulumi/pulumi-terraform-provider/sdks/go/gcore/v2/gcore"
    	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
    )
    
    func main() {
    	pulumi.Run(func(ctx *pulumi.Context) error {
    		_, err := gcore.GetCloudVolumeSnapshots(ctx, &gcore.GetCloudVolumeSnapshotsArgs{
    			ProjectId:         pulumi.Float64Ref(1),
    			RegionId:          pulumi.Float64Ref(1),
    			InstanceId:        pulumi.StringRef("550e8400-e29b-41d4-a716-446655440000"),
    			LifecyclePolicyId: pulumi.Float64Ref(1),
    			ScheduleId:        pulumi.StringRef("67baa7d1-08ea-4fc5-bef2-6b2465b7d227"),
    			VolumeId:          pulumi.StringRef("3ed9e2ce-f906-47fb-ba32-c25a3f63df4f"),
    		}, nil)
    		if err != nil {
    			return err
    		}
    		return nil
    	})
    }
    
    using System.Collections.Generic;
    using System.Linq;
    using Pulumi;
    using Gcore = Pulumi.Gcore;
    
    return await Deployment.RunAsync(() => 
    {
        var exampleCloudVolumeSnapshots = Gcore.GetCloudVolumeSnapshots.Invoke(new()
        {
            ProjectId = 1,
            RegionId = 1,
            InstanceId = "550e8400-e29b-41d4-a716-446655440000",
            LifecyclePolicyId = 1,
            ScheduleId = "67baa7d1-08ea-4fc5-bef2-6b2465b7d227",
            VolumeId = "3ed9e2ce-f906-47fb-ba32-c25a3f63df4f",
        });
    
    });
    
    package generated_program;
    
    import com.pulumi.Context;
    import com.pulumi.Pulumi;
    import com.pulumi.core.Output;
    import com.pulumi.gcore.GcoreFunctions;
    import com.pulumi.gcore.inputs.GetCloudVolumeSnapshotsArgs;
    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 exampleCloudVolumeSnapshots = GcoreFunctions.getCloudVolumeSnapshots(GetCloudVolumeSnapshotsArgs.builder()
                .projectId(1)
                .regionId(1)
                .instanceId("550e8400-e29b-41d4-a716-446655440000")
                .lifecyclePolicyId(1)
                .scheduleId("67baa7d1-08ea-4fc5-bef2-6b2465b7d227")
                .volumeId("3ed9e2ce-f906-47fb-ba32-c25a3f63df4f")
                .build());
    
        }
    }
    
    variables:
      exampleCloudVolumeSnapshots:
        fn::invoke:
          function: gcore:getCloudVolumeSnapshots
          arguments:
            projectId: 1
            regionId: 1
            instanceId: 550e8400-e29b-41d4-a716-446655440000
            lifecyclePolicyId: 1
            scheduleId: 67baa7d1-08ea-4fc5-bef2-6b2465b7d227
            volumeId: 3ed9e2ce-f906-47fb-ba32-c25a3f63df4f
    
    Example coming soon!
    

    Using getCloudVolumeSnapshots

    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 getCloudVolumeSnapshots(args: GetCloudVolumeSnapshotsArgs, opts?: InvokeOptions): Promise<GetCloudVolumeSnapshotsResult>
    function getCloudVolumeSnapshotsOutput(args: GetCloudVolumeSnapshotsOutputArgs, opts?: InvokeOptions): Output<GetCloudVolumeSnapshotsResult>
    def get_cloud_volume_snapshots(instance_id: Optional[str] = None,
                                   lifecycle_policy_id: Optional[float] = None,
                                   max_items: Optional[float] = None,
                                   project_id: Optional[float] = None,
                                   region_id: Optional[float] = None,
                                   schedule_id: Optional[str] = None,
                                   volume_id: Optional[str] = None,
                                   opts: Optional[InvokeOptions] = None) -> GetCloudVolumeSnapshotsResult
    def get_cloud_volume_snapshots_output(instance_id: pulumi.Input[Optional[str]] = None,
                                   lifecycle_policy_id: pulumi.Input[Optional[float]] = None,
                                   max_items: pulumi.Input[Optional[float]] = None,
                                   project_id: pulumi.Input[Optional[float]] = None,
                                   region_id: pulumi.Input[Optional[float]] = None,
                                   schedule_id: pulumi.Input[Optional[str]] = None,
                                   volume_id: pulumi.Input[Optional[str]] = None,
                                   opts: Optional[InvokeOptions] = None) -> Output[GetCloudVolumeSnapshotsResult]
    func GetCloudVolumeSnapshots(ctx *Context, args *GetCloudVolumeSnapshotsArgs, opts ...InvokeOption) (*GetCloudVolumeSnapshotsResult, error)
    func GetCloudVolumeSnapshotsOutput(ctx *Context, args *GetCloudVolumeSnapshotsOutputArgs, opts ...InvokeOption) GetCloudVolumeSnapshotsResultOutput

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

    public static class GetCloudVolumeSnapshots 
    {
        public static Task<GetCloudVolumeSnapshotsResult> InvokeAsync(GetCloudVolumeSnapshotsArgs args, InvokeOptions? opts = null)
        public static Output<GetCloudVolumeSnapshotsResult> Invoke(GetCloudVolumeSnapshotsInvokeArgs args, InvokeOptions? opts = null)
    }
    public static CompletableFuture<GetCloudVolumeSnapshotsResult> getCloudVolumeSnapshots(GetCloudVolumeSnapshotsArgs args, InvokeOptions options)
    public static Output<GetCloudVolumeSnapshotsResult> getCloudVolumeSnapshots(GetCloudVolumeSnapshotsArgs args, InvokeOptions options)
    
    fn::invoke:
      function: gcore:index/getCloudVolumeSnapshots:getCloudVolumeSnapshots
      arguments:
        # arguments dictionary
    data "gcore_get_cloud_volume_snapshots" "name" {
        # arguments
    }

    The following arguments are supported:

    InstanceId string
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    LifecyclePolicyId double
    Optional. Filter by lifecycle policy ID
    MaxItems double
    Max items to fetch, default: 1000
    ProjectId double
    Project ID
    RegionId double
    Region ID
    ScheduleId string
    Optional. Filter by schedule ID
    VolumeId string
    Optional. Filter by volume ID
    InstanceId string
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    LifecyclePolicyId float64
    Optional. Filter by lifecycle policy ID
    MaxItems float64
    Max items to fetch, default: 1000
    ProjectId float64
    Project ID
    RegionId float64
    Region ID
    ScheduleId string
    Optional. Filter by schedule ID
    VolumeId string
    Optional. Filter by volume ID
    instance_id string
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecycle_policy_id number
    Optional. Filter by lifecycle policy ID
    max_items number
    Max items to fetch, default: 1000
    project_id number
    Project ID
    region_id number
    Region ID
    schedule_id string
    Optional. Filter by schedule ID
    volume_id string
    Optional. Filter by volume ID
    instanceId String
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecyclePolicyId Double
    Optional. Filter by lifecycle policy ID
    maxItems Double
    Max items to fetch, default: 1000
    projectId Double
    Project ID
    regionId Double
    Region ID
    scheduleId String
    Optional. Filter by schedule ID
    volumeId String
    Optional. Filter by volume ID
    instanceId string
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecyclePolicyId number
    Optional. Filter by lifecycle policy ID
    maxItems number
    Max items to fetch, default: 1000
    projectId number
    Project ID
    regionId number
    Region ID
    scheduleId string
    Optional. Filter by schedule ID
    volumeId string
    Optional. Filter by volume ID
    instance_id str
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecycle_policy_id float
    Optional. Filter by lifecycle policy ID
    max_items float
    Max items to fetch, default: 1000
    project_id float
    Project ID
    region_id float
    Region ID
    schedule_id str
    Optional. Filter by schedule ID
    volume_id str
    Optional. Filter by volume ID
    instanceId String
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecyclePolicyId Number
    Optional. Filter by lifecycle policy ID
    maxItems Number
    Max items to fetch, default: 1000
    projectId Number
    Project ID
    regionId Number
    Region ID
    scheduleId String
    Optional. Filter by schedule ID
    volumeId String
    Optional. Filter by volume ID

    getCloudVolumeSnapshots Result

    The following output properties are available:

    Id string
    The provider-assigned unique ID for this managed resource.
    Items List<GetCloudVolumeSnapshotsItem>
    The items returned by the data source
    InstanceId string
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    LifecyclePolicyId double
    Optional. Filter by lifecycle policy ID
    MaxItems double
    Max items to fetch, default: 1000
    ProjectId double
    Project ID
    RegionId double
    Region ID
    ScheduleId string
    Optional. Filter by schedule ID
    VolumeId string
    Optional. Filter by volume ID
    Id string
    The provider-assigned unique ID for this managed resource.
    Items []GetCloudVolumeSnapshotsItem
    The items returned by the data source
    InstanceId string
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    LifecyclePolicyId float64
    Optional. Filter by lifecycle policy ID
    MaxItems float64
    Max items to fetch, default: 1000
    ProjectId float64
    Project ID
    RegionId float64
    Region ID
    ScheduleId string
    Optional. Filter by schedule ID
    VolumeId string
    Optional. Filter by volume ID
    id string
    The provider-assigned unique ID for this managed resource.
    items list(object)
    The items returned by the data source
    instance_id string
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecycle_policy_id number
    Optional. Filter by lifecycle policy ID
    max_items number
    Max items to fetch, default: 1000
    project_id number
    Project ID
    region_id number
    Region ID
    schedule_id string
    Optional. Filter by schedule ID
    volume_id string
    Optional. Filter by volume ID
    id String
    The provider-assigned unique ID for this managed resource.
    items List<GetCloudVolumeSnapshotsItem>
    The items returned by the data source
    instanceId String
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecyclePolicyId Double
    Optional. Filter by lifecycle policy ID
    maxItems Double
    Max items to fetch, default: 1000
    projectId Double
    Project ID
    regionId Double
    Region ID
    scheduleId String
    Optional. Filter by schedule ID
    volumeId String
    Optional. Filter by volume ID
    id string
    The provider-assigned unique ID for this managed resource.
    items GetCloudVolumeSnapshotsItem[]
    The items returned by the data source
    instanceId string
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecyclePolicyId number
    Optional. Filter by lifecycle policy ID
    maxItems number
    Max items to fetch, default: 1000
    projectId number
    Project ID
    regionId number
    Region ID
    scheduleId string
    Optional. Filter by schedule ID
    volumeId string
    Optional. Filter by volume ID
    id str
    The provider-assigned unique ID for this managed resource.
    items Sequence[GetCloudVolumeSnapshotsItem]
    The items returned by the data source
    instance_id str
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecycle_policy_id float
    Optional. Filter by lifecycle policy ID
    max_items float
    Max items to fetch, default: 1000
    project_id float
    Project ID
    region_id float
    Region ID
    schedule_id str
    Optional. Filter by schedule ID
    volume_id str
    Optional. Filter by volume ID
    id String
    The provider-assigned unique ID for this managed resource.
    items List<Property Map>
    The items returned by the data source
    instanceId String
    Optional. Filter snapshots by the instance whose volumes were snapshotted
    lifecyclePolicyId Number
    Optional. Filter by lifecycle policy ID
    maxItems Number
    Max items to fetch, default: 1000
    projectId Number
    Project ID
    regionId Number
    Region ID
    scheduleId String
    Optional. Filter by schedule ID
    volumeId String
    Optional. Filter by volume ID

    Supporting Types

    GetCloudVolumeSnapshotsItem

    CreatedAt string
    Datetime when the snapshot was created
    CreatorTaskId string
    Task that created this entity
    Description string
    Snapshot description
    Id string
    Snapshot ID
    Name string
    Snapshot name
    ProjectId double
    Project ID
    Region string
    Region name
    RegionId double
    Region ID
    Size double
    Snapshot size, GiB
    Status string
    Snapshot status Available values: "available", "backing-up", "creating", "deleted", "deleting", "error", "error_deleting", "restoring", "unmanaging".
    Tags List<GetCloudVolumeSnapshotsItemTag>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    TaskId string
    The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.
    UpdatedAt string
    Datetime when the snapshot was last updated
    VolumeId string
    ID of the volume this snapshot was made from
    CreatedAt string
    Datetime when the snapshot was created
    CreatorTaskId string
    Task that created this entity
    Description string
    Snapshot description
    Id string
    Snapshot ID
    Name string
    Snapshot name
    ProjectId float64
    Project ID
    Region string
    Region name
    RegionId float64
    Region ID
    Size float64
    Snapshot size, GiB
    Status string
    Snapshot status Available values: "available", "backing-up", "creating", "deleted", "deleting", "error", "error_deleting", "restoring", "unmanaging".
    Tags []GetCloudVolumeSnapshotsItemTag
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    TaskId string
    The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.
    UpdatedAt string
    Datetime when the snapshot was last updated
    VolumeId string
    ID of the volume this snapshot was made from
    created_at string
    Datetime when the snapshot was created
    creator_task_id string
    Task that created this entity
    description string
    Snapshot description
    id string
    Snapshot ID
    name string
    Snapshot name
    project_id number
    Project ID
    region string
    Region name
    region_id number
    Region ID
    size number
    Snapshot size, GiB
    status string
    Snapshot status Available values: "available", "backing-up", "creating", "deleted", "deleting", "error", "error_deleting", "restoring", "unmanaging".
    tags list(object)
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    task_id string
    The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.
    updated_at string
    Datetime when the snapshot was last updated
    volume_id string
    ID of the volume this snapshot was made from
    createdAt String
    Datetime when the snapshot was created
    creatorTaskId String
    Task that created this entity
    description String
    Snapshot description
    id String
    Snapshot ID
    name String
    Snapshot name
    projectId Double
    Project ID
    region String
    Region name
    regionId Double
    Region ID
    size Double
    Snapshot size, GiB
    status String
    Snapshot status Available values: "available", "backing-up", "creating", "deleted", "deleting", "error", "error_deleting", "restoring", "unmanaging".
    tags List<GetCloudVolumeSnapshotsItemTag>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    taskId String
    The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.
    updatedAt String
    Datetime when the snapshot was last updated
    volumeId String
    ID of the volume this snapshot was made from
    createdAt string
    Datetime when the snapshot was created
    creatorTaskId string
    Task that created this entity
    description string
    Snapshot description
    id string
    Snapshot ID
    name string
    Snapshot name
    projectId number
    Project ID
    region string
    Region name
    regionId number
    Region ID
    size number
    Snapshot size, GiB
    status string
    Snapshot status Available values: "available", "backing-up", "creating", "deleted", "deleting", "error", "error_deleting", "restoring", "unmanaging".
    tags GetCloudVolumeSnapshotsItemTag[]
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    taskId string
    The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.
    updatedAt string
    Datetime when the snapshot was last updated
    volumeId string
    ID of the volume this snapshot was made from
    created_at str
    Datetime when the snapshot was created
    creator_task_id str
    Task that created this entity
    description str
    Snapshot description
    id str
    Snapshot ID
    name str
    Snapshot name
    project_id float
    Project ID
    region str
    Region name
    region_id float
    Region ID
    size float
    Snapshot size, GiB
    status str
    Snapshot status Available values: "available", "backing-up", "creating", "deleted", "deleting", "error", "error_deleting", "restoring", "unmanaging".
    tags Sequence[GetCloudVolumeSnapshotsItemTag]
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    task_id str
    The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.
    updated_at str
    Datetime when the snapshot was last updated
    volume_id str
    ID of the volume this snapshot was made from
    createdAt String
    Datetime when the snapshot was created
    creatorTaskId String
    Task that created this entity
    description String
    Snapshot description
    id String
    Snapshot ID
    name String
    Snapshot name
    projectId Number
    Project ID
    region String
    Region name
    regionId Number
    Region ID
    size Number
    Snapshot size, GiB
    status String
    Snapshot status Available values: "available", "backing-up", "creating", "deleted", "deleting", "error", "error_deleting", "restoring", "unmanaging".
    tags List<Property Map>
    List of key-value tags associated with the resource. A tag is a key-value pair that can be associated with a resource, enabling efficient filtering and grouping for better organization and management. Some tags are read-only and cannot be modified by the user. Tags are also integrated with cost reports, allowing cost data to be filtered based on tag keys or values.
    taskId String
    The UUID of the active task that currently holds a lock on the resource. This lock prevents concurrent modifications to ensure consistency. If null, the resource is not locked.
    updatedAt String
    Datetime when the snapshot was last updated
    volumeId String
    ID of the volume this snapshot was made from

    GetCloudVolumeSnapshotsItemTag

    Key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    ReadOnly bool
    If true, the tag is read-only and cannot be modified by the user
    Value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    Key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    ReadOnly bool
    If true, the tag is read-only and cannot be modified by the user
    Value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    read_only bool
    If true, the tag is read-only and cannot be modified by the user
    value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key String
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly Boolean
    If true, the tag is read-only and cannot be modified by the user
    value String
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key string
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly boolean
    If true, the tag is read-only and cannot be modified by the user
    value string
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key str
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    read_only bool
    If true, the tag is read-only and cannot be modified by the user
    value str
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    key String
    Tag key. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.
    readOnly Boolean
    If true, the tag is read-only and cannot be modified by the user
    value String
    Tag value. Maximum 255 characters. Cannot contain spaces, tabs, newlines, empty string or '=' character.

    Package Details

    Repository
    gcore g-core/terraform-provider-gcore
    License
    Notes
    This Pulumi package is based on the gcore Terraform Provider.
    Viewing docs for gcore 2.0.0-alpha.15
    published on Thursday, Aug 6, 2026 by g-core

      Try Pulumi Cloud free.
      Your team will thank you.

      Start free trial