All Products
Search
Document Center

Resource Orchestration Service:DATASOURCE::DBS::BackupPlan

更新时间:Mar 10, 2025

DATASOURCE::DBS::BackupPlan is used to query the information about a backup schedule.

Syntax

{
  "Type": "DATASOURCE::DBS::BackupPlan",
  "Properties": {
    "BackupPlanId": String,
    "RefreshOptions": String
  }
}

Properties

Property

Type

Required

Editable

Description

Constraint

BackupPlanId

String

Yes

Yes

The ID of the backup schedule.

None.

RefreshOptions

String

No

Yes

The refresh policy for data source resources when the stack is updated.

Valid values:

  • Never (default): does not refresh data source resources when the stack is updated.

  • Always: refreshes data source resources when the stack is updated.

Return values

Fn::GetAtt

  • BackupPlanName: the name of the backup schedule.

  • BackupObjects: the backup objects.

  • ResourceGroupId: the ID of the resource group.

  • DatabaseType: the type of the database engine.

  • CrossAliyunId: the user ID of the account that is used to perform backups across Alibaba Cloud accounts.

  • SourceEndpointDatabaseName: the name of the database.

  • SourceEndpointRegion: the region of the database.

  • PaymentType: the billing method.

  • BackupPlanId: the ID of the backup schedule.

  • BackupGatewayId: the ID of the backup gateway.

  • SourceEndpointInstanceType: the location of the database.

  • SourceEndpointUserName: the account of the database.

  • BackupStorageType: the built-in storage type.

  • CrossRoleName: the name of the Resource Access Management (RAM) role that is used to perform backups across Alibaba Cloud accounts.

  • DuplicationInfrequentAccessPeriod: the number of days after which the storage class of the backup data is changed to Infrequent Access (IA).

  • BackupMethod: the backup method.

  • BackupPeriod: the full backup cycle.

  • CreateTime: the timestamp that indicates when the backup schedule was created.

  • SourceEndpointInstanceId: the ID of the database instance.

  • InstanceClass: the type of the backup schedule.

  • SourceEndpointSid: the system ID (SID) of the database instance.

  • DuplicationArchivePeriod: the number of days after which the storage class of the backup data is changed to Archive.

  • BackupStartTime: the start time of the full backup.

  • EnableBackupLog: indicates whether the incremental log backup feature is enabled.

  • OssBucketName: the name of the Object Storage Service (OSS) bucket.

  • BackupRetentionPeriod: the retention period of the backup data.

Examples

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  BackupPlanId:
    Type: String
    Description:
      en: The ID of the backup plan.
    Required: true
Resources:
  ExtensionDataSource:
    Type: DATASOURCE::DBS::BackupPlan
    Properties:
      BackupPlanId:
        Ref: BackupPlanId
Outputs:
  BackupPlanName:
    Description: The name of the backup plan.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupPlanName
  BackupObjects:
    Description: The backup object.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupObjects
  ResourceGroupId:
    Description: The ID of the resource group.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - ResourceGroupId
  DatabaseType:
    Description: Database type.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - DatabaseType
  CrossAliyunId:
    Description: The UID that is backed up across Alibaba Cloud accounts.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - CrossAliyunId
  SourceEndpointDatabaseName:
    Description: The name of the database.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - SourceEndpointDatabaseName
  SourceEndpointRegion:
    Description: The region of the database.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - SourceEndpointRegion
  PaymentType:
    Description: The billing method of the resource.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - PaymentType
  BackupPlanId:
    Description: The ID of the backup plan.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupPlanId
  BackupGatewayId:
    Description: The ID of the backup gateway.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupGatewayId
  SourceEndpointInstanceType:
    Description: The location of the database.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - SourceEndpointInstanceType
  SourceEndpointUserName:
    Description: Database account.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - SourceEndpointUserName
  BackupStorageType:
    Description: Built-in storage class.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupStorageType
  CrossRoleName:
    Description: The name of the RAM role that is backed up across Alibaba Cloud accounts.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - CrossRoleName
  DuplicationInfrequentAccessPeriod:
    Description: The storage time is converted to low-frequency access. The default time is 180 days.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - DuplicationInfrequentAccessPeriod
  BackupMethod:
    Description: Backup method.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupMethod
  BackupPeriod:
    Description: Full backup cycle.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupPeriod
  CreateTime:
    Description: The creation time of the backup plans.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - CreateTime
  SourceEndpointInstanceId:
    Description: The ID of the database instance.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - SourceEndpointInstanceId
  InstanceClass:
    Description: Instance class.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - InstanceClass
  SourceEndpointSid:
    Description: Oracle SID name.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - SourceEndpointSid
  DuplicationArchivePeriod:
    Description: The storage time for conversion to archive cold standby is 365 days by default.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - DuplicationArchivePeriod
  BackupStartTime:
    Description: The start time of full backup.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupStartTime
  EnableBackupLog:
    Description: Whether to enable incremental log backup.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - EnableBackupLog
  OssBucketName:
    Description: OSS Bucket name.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - OssBucketName
  BackupRetentionPeriod:
    Description: The retention period of backup data. Valid values: 0 to 1825. Default value: 730 days.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - BackupRetentionPeriod
{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "BackupPlanId": {
      "Type": "String",
      "Description": {
        "en": "The ID of the backup plan."
      },
      "Required": true
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::DBS::BackupPlan",
      "Properties": {
        "BackupPlanId": {
          "Ref": "BackupPlanId"
        }
      }
    }
  },
  "Outputs": {
    "BackupPlanName": {
      "Description": "The name of the backup plan.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupPlanName"
        ]
      }
    },
    "BackupObjects": {
      "Description": "The backup object.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupObjects"
        ]
      }
    },
    "ResourceGroupId": {
      "Description": "The ID of the resource group.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "ResourceGroupId"
        ]
      }
    },
    "DatabaseType": {
      "Description": "Database type.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "DatabaseType"
        ]
      }
    },
    "CrossAliyunId": {
      "Description": "The UID that is backed up across Alibaba Cloud accounts.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "CrossAliyunId"
        ]
      }
    },
    "SourceEndpointDatabaseName": {
      "Description": "The name of the database.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "SourceEndpointDatabaseName"
        ]
      }
    },
    "SourceEndpointRegion": {
      "Description": "The region of the database.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "SourceEndpointRegion"
        ]
      }
    },
    "PaymentType": {
      "Description": "The billing method of the resource.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "PaymentType"
        ]
      }
    },
    "BackupPlanId": {
      "Description": "The ID of the backup plan.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupPlanId"
        ]
      }
    },
    "BackupGatewayId": {
      "Description": "The ID of the backup gateway.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupGatewayId"
        ]
      }
    },
    "SourceEndpointInstanceType": {
      "Description": "The location of the database.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "SourceEndpointInstanceType"
        ]
      }
    },
    "SourceEndpointUserName": {
      "Description": "Database account.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "SourceEndpointUserName"
        ]
      }
    },
    "BackupStorageType": {
      "Description": "Built-in storage class.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupStorageType"
        ]
      }
    },
    "CrossRoleName": {
      "Description": "The name of the RAM role that is backed up across Alibaba Cloud accounts.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "CrossRoleName"
        ]
      }
    },
    "DuplicationInfrequentAccessPeriod": {
      "Description": "The storage time is converted to low-frequency access. The default time is 180 days.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "DuplicationInfrequentAccessPeriod"
        ]
      }
    },
    "BackupMethod": {
      "Description": "Backup method.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupMethod"
        ]
      }
    },
    "BackupPeriod": {
      "Description": "Full backup cycle.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupPeriod"
        ]
      }
    },
    "CreateTime": {
      "Description": "The creation time of the backup plans.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "CreateTime"
        ]
      }
    },
    "SourceEndpointInstanceId": {
      "Description": "The ID of the database instance.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "SourceEndpointInstanceId"
        ]
      }
    },
    "InstanceClass": {
      "Description": "Instance class.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "InstanceClass"
        ]
      }
    },
    "SourceEndpointSid": {
      "Description": "Oracle SID name.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "SourceEndpointSid"
        ]
      }
    },
    "DuplicationArchivePeriod": {
      "Description": "The storage time for conversion to archive cold standby is 365 days by default.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "DuplicationArchivePeriod"
        ]
      }
    },
    "BackupStartTime": {
      "Description": "The start time of full backup.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupStartTime"
        ]
      }
    },
    "EnableBackupLog": {
      "Description": "Whether to enable incremental log backup.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "EnableBackupLog"
        ]
      }
    },
    "OssBucketName": {
      "Description": "OSS Bucket name.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "OssBucketName"
        ]
      }
    },
    "BackupRetentionPeriod": {
      "Description": "The retention period of backup data. Valid values: 0 to 1825. Default value: 730 days.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "BackupRetentionPeriod"
        ]
      }
    }
  }
}