Todos os produtos
Search
Central de documentação

Resource Orchestration Service:DATASOURCE::RDS::Databases

Última atualização: Jun 27, 2026

Consulta informações sobre bancos de dados em uma instância ApsaraDB RDS.

Sintaxe

{
  "Type": "DATASOURCE::RDS::Databases",
  "Properties": {
    "DBInstanceId": String,
    "DBName": String,
    "DBStatus": String,
    "RefreshOptions": String
  }
}

Propriedades

Propriedade

Tipo

Obrigatório

Editável

Descrição

Restrição

DBInstanceId

String

Sim

Sim

ID da instância ApsaraDB RDS.

Nenhuma.

DBName

String

Não

Sim

Nome do banco de dados.

Nenhuma.

DBStatus

String

Não

Sim

Status do banco de dados.

Valores válidos:

  • Creating: o banco de dados está sendo criado.

  • Running: o banco de dados está em execução.

  • Deleting: o banco de dados está sendo excluído.

RefreshOptions

String

Não

Sim

Política de atualização dos recursos da fonte de dados durante a atualização da pilha.

Valores válidos:

  • Never (padrão): os recursos da fonte de dados não são atualizados durante as atualizações da pilha.

  • Always: os recursos da fonte de dados são atualizados durante as atualizações da pilha.

Valores de retorno (Fn::GetAtt)

  • Databases: detalhes dos bancos de dados.

  • DBNames: nomes dos bancos de dados.

Propriedade

Tipo

Descrição

Restrição

DBNames

List

Nomes dos bancos de dados.

Nenhuma.

Databases

List

Detalhes dos bancos de dados.

Nenhuma.

DBName

String

Nome do banco de dados.

Nenhuma.

DBInstanceId

String

ID da instância ApsaraDB RDS à qual o banco de dados pertence.

Nenhuma.

Engine

String

Mecanismo de banco de dados da instância.

Nenhuma.

DBStatus

String

Status do banco de dados.

Valores válidos:

  • Creating: o banco de dados está sendo criado.

  • Running: o banco de dados está em execução.

  • Deleting: o banco de dados está sendo excluído.

CharacterSetName

String

Conjunto de caracteres.

Nenhuma.

DBDescription

String

Descrição do banco de dados.

Nenhuma.

Accounts

Map

Contas com permissões no banco de dados.

Exemplo:

{
    "Account": "Demo",
    "AccountPrivilege":"ReadOnly",
    "AccountPrivilegeDetail":"SELECT"
}

Exemplos

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "DBInstanceId": {
      "Type": "String",
      "Description": "The ID of the RDS instance."
    }
  },
  "Resources": {
    "ExtensionDataSource": {
      "Type": "DATASOURCE::RDS::Databases",
      "Properties": {
        "DBInstanceId": {
          "Ref": "DBInstanceId"
        }
      }
    }
  },
  "Outputs": {
    "Databases": {
      "Description": "The list of The RDS databases.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "Databases"
        ]
      }
    },
    "DBNames": {
      "Description": "The list of The RDS database names.",
      "Value": {
        "Fn::GetAtt": [
          "ExtensionDataSource",
          "DBNames"
        ]
      }
    }
  }
}
ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  DBInstanceId:
    Type: String
    Description: The ID of the RDS instance.
Resources:
  ExtensionDataSource:
    Type: DATASOURCE::RDS::Databases
    Properties:
      DBInstanceId:
        Ref: DBInstanceId
Outputs:
  Databases:
    Description: The list of The RDS databases.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - Databases
  DBNames:
    Description: The list of The RDS database names.
    Value:
      Fn::GetAtt:
        - ExtensionDataSource
        - DBNames