ALIYUN::HBR::DbAgent

更新时间:
复制 MD 格式

ALIYUN::HBR::DbAgent installs a Data Disaster Recovery client on Elastic Compute Service (ECS) instances.

Syntax

{
  "Type": "ALIYUN::HBR::DbAgent",
  "Properties": {
    "InstanceInfo": List,
    "CrossAccountType": String,
    "CrossAccountRoleName": String,
    "CrossAccountUserId": Number
  }
}

Properties

Property

Type

Required

Editable

Description

Constraint

InstanceInfo

List

Yes

No

The information about the Elastic Compute Service (ECS) instances.

You can specify 1 to 100 ECS instances.

For more information, see InstanceInfo syntax and InstanceInfo properties.

CrossAccountType

String

No

No

The backup type.

Valid values:

  • SELF_ACCOUNT: backup within the current Alibaba Cloud account.

  • CROSS_ACCOUNT: backup across Alibaba Cloud accounts.

CrossAccountRoleName

String

No

No

The name of the Resource Access Management (RAM) role that is created within the source Alibaba Cloud account to authorize cross-account backup.

None.

CrossAccountUserId

Number

No

No

The ID of the source Alibaba Cloud account that authorizes cross-account backup.

None.

InstanceInfo syntax

"InstanceInfo": [
  {
    "UserName": String,
    "InstanceId": String,
    "SourceType": String,
    "Password": String,
    "AuthenticationType": String
  }
]

InstanceInfo properties

Property

Type

Required

Editable

Description

Constraint

UserName

String

No

No

The username of the account used to connect to the Data Disaster Recovery client.

None.

InstanceId

String

Yes

No

The ID of the ECS instance.

None.

SourceType

String

Yes

No

The type of the data source.

Valid values:

  • MYSQL

  • ORACLE

  • MSSQL

Password

String

No

No

The password of the account used to connect to the Data Disaster Recovery client.

None.

AuthenticationType

String

No

No

The authentication method.

Valid values:

  • Valid value when SourceType is set to MYSQL or MSSQL: INSTANCE.

  • Valid value when SourceType is set to ORACLE: ACCESS_KEY.

Return values

Fn::GetAtt

  • UniBackupInstances: the instances on which the Data Disaster Recovery client is installed.

  • TaskId: the ID of the task.

  • UniBackupInstanceDetails: details of the instances on which the Data Disaster Recovery client is installed.

  • InstanceIds: the IDs of the ECS instances.

Examples

JSON format

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "InstanceInfo": {
      "Type": "Json",
      "Description": "Instance infos",
      "Default": "[\n  {\n    \"UserName\": \"test123\",\n    \"InstanceId\": \"i-12e****\",\n    \"SourceType\": \"MSSQL\",\n    \"Password\": \"tes****\",\n    \"AuthenticationType\": \"INSTANCE\"\n  }\n]"
    }
  },
  "Resources": {
    "UniBackupAgent": {
      "Type": "ALIYUN::HBR::DbAgent",
      "Properties": {
        "InstanceInfo": {
          "Ref": "InstanceInfo"
        }
      }
    }
  },
  "Outputs": {
    "UniBackupInstances": {
      "Description": "Uni backup agent instance info",
      "Value": {
        "Fn::GetAtt": [
          "UniBackupAgent",
          "UniBackupInstances"
        ]
      }
    },
    "TaskId": {
      "Description": "Uni backup agent install task id.",
      "Value": {
        "Fn::GetAtt": [
          "UniBackupAgent",
          "TaskId"
        ]
      }
    },
    "UniBackupInstanceDetails": {
      "Description": "Uni backup agent instance info details",
      "Value": {
        "Fn::GetAtt": [
          "UniBackupAgent",
          "UniBackupInstanceDetails"
        ]
      }
    },
    "InstanceIds": {
      "Description": "Uni backup agent instance ids",
      "Value": {
        "Fn::GetAtt": [
          "UniBackupAgent",
          "InstanceIds"
        ]
      }
    }
  }
}