Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi Cloud Packages Tutorials
  1. Packages
  2. Planetscale Provider
  3. API Docs
  4. getBackups
planetscale 0.4.1 published on Tuesday, Mar 11, 2025 by planetscale
planetscale/terraform-provider-planetscale

planetscale.getBackups

Explore with Pulumi AI

planetscale logo
planetscale 0.4.1 published on Tuesday, Mar 11, 2025 by planetscale
planetscale/terraform-provider-planetscale

    A list of PlanetScale backups.

    Example Usage

    import * as pulumi from "@pulumi/pulumi";
import * as planetscale from "@pulumi/planetscale";

const example = planetscale.getBackups({
    organization: "example.com",
    database: "example_db",
    branch: "main",
});
export const backups = example;

    import pulumi
import pulumi_planetscale as planetscale

example = planetscale.get_backups(organization="example.com",
    database="example_db",
    branch="main")
pulumi.export("backups", example)

    package main

import (
	"github.com/pulumi/pulumi-terraform-provider/sdks/go/planetscale/planetscale"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		example, err := planetscale.GetBackups(ctx, &planetscale.GetBackupsArgs{
			Organization: "example.com",
			Database:     "example_db",
			Branch:       "main",
		}, nil)
		if err != nil {
			return err
		}
		ctx.Export("backups", example)
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Planetscale = Pulumi.Planetscale;

return await Deployment.RunAsync(() => 
{
    var example = Planetscale.GetBackups.Invoke(new()
    {
        Organization = "example.com",
        Database = "example_db",
        Branch = "main",
    });

    return new Dictionary<string, object?>
    {
        ["backups"] = example,
    };
});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.planetscale.PlanetscaleFunctions;
import com.pulumi.planetscale.inputs.GetBackupsArgs;
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 example = PlanetscaleFunctions.getBackups(GetBackupsArgs.builder()
            .organization("example.com")
            .database("example_db")
            .branch("main")
            .build());

        ctx.export("backups", example.applyValue(getBackupsResult -> getBackupsResult));
    }
}

    variables:
  example:
    fn::invoke:
      function: planetscale:getBackups
      arguments:
        organization: example.com
        database: example_db
        branch: main
outputs:
  backups: ${example}

    Using getBackups

    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 getBackups(args: GetBackupsArgs, opts?: InvokeOptions): Promise<GetBackupsResult>
function getBackupsOutput(args: GetBackupsOutputArgs, opts?: InvokeOptions): Output<GetBackupsResult>
    def get_backups(branch: Optional[str] = None,
                database: Optional[str] = None,
                organization: Optional[str] = None,
                opts: Optional[InvokeOptions] = None) -> GetBackupsResult
def get_backups_output(branch: Optional[pulumi.Input[str]] = None,
                database: Optional[pulumi.Input[str]] = None,
                organization: Optional[pulumi.Input[str]] = None,
                opts: Optional[InvokeOptions] = None) -> Output[GetBackupsResult]
    func GetBackups(ctx *Context, args *GetBackupsArgs, opts ...InvokeOption) (*GetBackupsResult, error)
func GetBackupsOutput(ctx *Context, args *GetBackupsOutputArgs, opts ...InvokeOption) GetBackupsResultOutput

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

    public static class GetBackups 
{
    public static Task<GetBackupsResult> InvokeAsync(GetBackupsArgs args, InvokeOptions? opts = null)
    public static Output<GetBackupsResult> Invoke(GetBackupsInvokeArgs args, InvokeOptions? opts = null)
}
    public static CompletableFuture<GetBackupsResult> getBackups(GetBackupsArgs args, InvokeOptions options)
public static Output<GetBackupsResult> getBackups(GetBackupsArgs args, InvokeOptions options)

    fn::invoke:
  function: planetscale:index/getBackups:getBackups
  arguments:
    # arguments dictionary

    The following arguments are supported:

    Branch string
    Database string
    Organization string
    Branch string
    Database string
    Organization string
    branch String
    database String
    organization String
    branch string
    database string
    organization string
    branch String
    database String
    organization String

    getBackups Result

    The following output properties are available:

    Backups List<GetBackupsBackup>
    Branch string
    Database string
    Id string
    The provider-assigned unique ID for this managed resource.
    Organization string
    Backups []GetBackupsBackup
    Branch string
    Database string
    Id string
    The provider-assigned unique ID for this managed resource.
    Organization string
    backups List<GetBackupsBackup>
    branch String
    database String
    id String
    The provider-assigned unique ID for this managed resource.
    organization String
    backups GetBackupsBackup[]
    branch string
    database string
    id string
    The provider-assigned unique ID for this managed resource.
    organization string
    backups Sequence[GetBackupsBackup]
    branch str
    database str
    id str
    The provider-assigned unique ID for this managed resource.
    organization str
    backups List<Property Map>
    branch String
    database String
    id String
    The provider-assigned unique ID for this managed resource.
    organization String

    Supporting Types

    GetBackupsBackup

    Actor GetBackupsBackupActor
    The actor that created the backup.
    BackupPolicy GetBackupsBackupBackupPolicy
    The backup policy being followed.
    Branch string
    The branch this backup belongs to.
    CreatedAt string
    When the backup was created.
    Database string
    The database this backup belongs to.
    EstimatedStorageCost double
    The estimated storage cost of the backup.
    Id string
    The ID of the backup.
    Name string
    The name of the backup.
    Organization string
    The organization this backup belongs to.
    Required bool
    Whether or not the backup policy is required.
    RestoredBranches List<string>
    Branches that have been restored with this backup.
    Size double
    The size of the backup.
    State string
    The current state of the backup.
    UpdatedAt string
    When the backup was last updated.
    Actor GetBackupsBackupActor
    The actor that created the backup.
    BackupPolicy GetBackupsBackupBackupPolicy
    The backup policy being followed.
    Branch string
    The branch this backup belongs to.
    CreatedAt string
    When the backup was created.
    Database string
    The database this backup belongs to.
    EstimatedStorageCost float64
    The estimated storage cost of the backup.
    Id string
    The ID of the backup.
    Name string
    The name of the backup.
    Organization string
    The organization this backup belongs to.
    Required bool
    Whether or not the backup policy is required.
    RestoredBranches []string
    Branches that have been restored with this backup.
    Size float64
    The size of the backup.
    State string
    The current state of the backup.
    UpdatedAt string
    When the backup was last updated.
    actor GetBackupsBackupActor
    The actor that created the backup.
    backupPolicy GetBackupsBackupBackupPolicy
    The backup policy being followed.
    branch String
    The branch this backup belongs to.
    createdAt String
    When the backup was created.
    database String
    The database this backup belongs to.
    estimatedStorageCost Double
    The estimated storage cost of the backup.
    id String
    The ID of the backup.
    name String
    The name of the backup.
    organization String
    The organization this backup belongs to.
    required Boolean
    Whether or not the backup policy is required.
    restoredBranches List<String>
    Branches that have been restored with this backup.
    size Double
    The size of the backup.
    state String
    The current state of the backup.
    updatedAt String
    When the backup was last updated.
    actor GetBackupsBackupActor
    The actor that created the backup.
    backupPolicy GetBackupsBackupBackupPolicy
    The backup policy being followed.
    branch string
    The branch this backup belongs to.
    createdAt string
    When the backup was created.
    database string
    The database this backup belongs to.
    estimatedStorageCost number
    The estimated storage cost of the backup.
    id string
    The ID of the backup.
    name string
    The name of the backup.
    organization string
    The organization this backup belongs to.
    required boolean
    Whether or not the backup policy is required.
    restoredBranches string[]
    Branches that have been restored with this backup.
    size number
    The size of the backup.
    state string
    The current state of the backup.
    updatedAt string
    When the backup was last updated.
    actor GetBackupsBackupActor
    The actor that created the backup.
    backup_policy GetBackupsBackupBackupPolicy
    The backup policy being followed.
    branch str
    The branch this backup belongs to.
    created_at str
    When the backup was created.
    database str
    The database this backup belongs to.
    estimated_storage_cost float
    The estimated storage cost of the backup.
    id str
    The ID of the backup.
    name str
    The name of the backup.
    organization str
    The organization this backup belongs to.
    required bool
    Whether or not the backup policy is required.
    restored_branches Sequence[str]
    Branches that have been restored with this backup.
    size float
    The size of the backup.
    state str
    The current state of the backup.
    updated_at str
    When the backup was last updated.
    actor Property Map
    The actor that created the backup.
    backupPolicy Property Map
    The backup policy being followed.
    branch String
    The branch this backup belongs to.
    createdAt String
    When the backup was created.
    database String
    The database this backup belongs to.
    estimatedStorageCost Number
    The estimated storage cost of the backup.
    id String
    The ID of the backup.
    name String
    The name of the backup.
    organization String
    The organization this backup belongs to.
    required Boolean
    Whether or not the backup policy is required.
    restoredBranches List<String>
    Branches that have been restored with this backup.
    size Number
    The size of the backup.
    state String
    The current state of the backup.
    updatedAt String
    When the backup was last updated.

    GetBackupsBackupActor

    AvatarUrl string
    The URL of the actor's avatar
    DisplayName string
    The name of the actor
    Id string
    The ID of the actor
    AvatarUrl string
    The URL of the actor's avatar
    DisplayName string
    The name of the actor
    Id string
    The ID of the actor
    avatarUrl String
    The URL of the actor's avatar
    displayName String
    The name of the actor
    id String
    The ID of the actor
    avatarUrl string
    The URL of the actor's avatar
    displayName string
    The name of the actor
    id string
    The ID of the actor
    avatar_url str
    The URL of the actor's avatar
    display_name str
    The name of the actor
    id str
    The ID of the actor
    avatarUrl String
    The URL of the actor's avatar
    displayName String
    The name of the actor
    id String
    The ID of the actor

    GetBackupsBackupBackupPolicy

    CreatedAt string
    When the backup policy was created.
    FrequencyUnit string
    The unit for the frequency of the backup policy.
    FrequencyValue double
    A number value for the frequency of the backup policy.
    Id string
    The ID of the backup policy.
    LastRanAt string
    When the backup was last run.
    Name string
    The name of the backup policy.
    NextRunAt string
    When the backup will next run.
    RetentionUnit string
    The unit for the retention period of the backup policy.
    RetentionValue double
    A number value for the retention period of the backup policy.
    ScheduleDay string
    Day of the week that the backup is scheduled.
    ScheduleWeek string
    Week of the month that the backup is scheduled.
    Target string
    Whether the backup policy is for a production or development database, or for a database branch.
    UpdatedAt string
    When the backup policy was last updated.
    CreatedAt string
    When the backup policy was created.
    FrequencyUnit string
    The unit for the frequency of the backup policy.
    FrequencyValue float64
    A number value for the frequency of the backup policy.
    Id string
    The ID of the backup policy.
    LastRanAt string
    When the backup was last run.
    Name string
    The name of the backup policy.
    NextRunAt string
    When the backup will next run.
    RetentionUnit string
    The unit for the retention period of the backup policy.
    RetentionValue float64
    A number value for the retention period of the backup policy.
    ScheduleDay string
    Day of the week that the backup is scheduled.
    ScheduleWeek string
    Week of the month that the backup is scheduled.
    Target string
    Whether the backup policy is for a production or development database, or for a database branch.
    UpdatedAt string
    When the backup policy was last updated.
    createdAt String
    When the backup policy was created.
    frequencyUnit String
    The unit for the frequency of the backup policy.
    frequencyValue Double
    A number value for the frequency of the backup policy.
    id String
    The ID of the backup policy.
    lastRanAt String
    When the backup was last run.
    name String
    The name of the backup policy.
    nextRunAt String
    When the backup will next run.
    retentionUnit String
    The unit for the retention period of the backup policy.
    retentionValue Double
    A number value for the retention period of the backup policy.
    scheduleDay String
    Day of the week that the backup is scheduled.
    scheduleWeek String
    Week of the month that the backup is scheduled.
    target String
    Whether the backup policy is for a production or development database, or for a database branch.
    updatedAt String
    When the backup policy was last updated.
    createdAt string
    When the backup policy was created.
    frequencyUnit string
    The unit for the frequency of the backup policy.
    frequencyValue number
    A number value for the frequency of the backup policy.
    id string
    The ID of the backup policy.
    lastRanAt string
    When the backup was last run.
    name string
    The name of the backup policy.
    nextRunAt string
    When the backup will next run.
    retentionUnit string
    The unit for the retention period of the backup policy.
    retentionValue number
    A number value for the retention period of the backup policy.
    scheduleDay string
    Day of the week that the backup is scheduled.
    scheduleWeek string
    Week of the month that the backup is scheduled.
    target string
    Whether the backup policy is for a production or development database, or for a database branch.
    updatedAt string
    When the backup policy was last updated.
    created_at str
    When the backup policy was created.
    frequency_unit str
    The unit for the frequency of the backup policy.
    frequency_value float
    A number value for the frequency of the backup policy.
    id str
    The ID of the backup policy.
    last_ran_at str
    When the backup was last run.
    name str
    The name of the backup policy.
    next_run_at str
    When the backup will next run.
    retention_unit str
    The unit for the retention period of the backup policy.
    retention_value float
    A number value for the retention period of the backup policy.
    schedule_day str
    Day of the week that the backup is scheduled.
    schedule_week str
    Week of the month that the backup is scheduled.
    target str
    Whether the backup policy is for a production or development database, or for a database branch.
    updated_at str
    When the backup policy was last updated.
    createdAt String
    When the backup policy was created.
    frequencyUnit String
    The unit for the frequency of the backup policy.
    frequencyValue Number
    A number value for the frequency of the backup policy.
    id String
    The ID of the backup policy.
    lastRanAt String
    When the backup was last run.
    name String
    The name of the backup policy.
    nextRunAt String
    When the backup will next run.
    retentionUnit String
    The unit for the retention period of the backup policy.
    retentionValue Number
    A number value for the retention period of the backup policy.
    scheduleDay String
    Day of the week that the backup is scheduled.
    scheduleWeek String
    Week of the month that the backup is scheduled.
    target String
    Whether the backup policy is for a production or development database, or for a database branch.
    updatedAt String
    When the backup policy was last updated.

    Package Details

    Repository
    planetscale planetscale/terraform-provider-planetscale
    License
    Notes
    This Pulumi package is based on the planetscale Terraform Provider.
    planetscale logo
    planetscale 0.4.1 published on Tuesday, Mar 11, 2025 by planetscale
    planetscale/terraform-provider-planetscale