Todos os produtos
Search
Central de documentação

Cloud Backup:AddDataSource

Última atualização: Oct 26, 2026

Cria uma fonte de dados.

Descrição da operação

  • Para o recurso de backup de NAS local, o tipo de fonte de dados compatível é o NAS local (COMMON_NAS).

  • Para o recurso de backup de CPFS, os tipos de fonte de dados compatíveis são o Cloud Parallel File Storage (CPFS), o CPFS for AI (BMCPFS) e outros sistemas de arquivos de grande escala (COMMON_FILE_SYSTEM).

  • Para o recurso de arquivamento, os tipos de fonte de dados compatíveis são o NAS local (COMMON_NAS), o HDFS (HDFS) e o S3 (S3).

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

  • Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.

  • API: A API que você pode chamar para executar a ação.

  • Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.

  • Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.

    • Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.

    • Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.

  • Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.

  • Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

hbr:AddDataSource

create

*Todos os recursos.

*

Nenhuma Nenhuma

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

DataSourceType

string

Sim

O tipo da fonte de dados.

COMMON_NAS

DataSourceName

string

Sim

O nome da fonte de dados.

MyLocalNas

Credential

string

Não

A credencial de acesso para a fonte de dados. Especifique este parâmetro conforme necessário para fontes de dados de NAS local que usam o protocolo SMB, fontes de dados compatíveis com o protocolo OSS e fontes de dados compatíveis com o protocolo S3. Exemplos:

  • Fonte de dados de NAS local (protocolo SMB): { "mountUsername": "*****", "mountPassword": "*****" }

  • Fonte de dados compatível com o protocolo OSS ou fonte de dados compatível com o protocolo S3: { "accessKeyId": "*****", "accessKeySecret": "*****" }

{ "mountUsername": "*****", "mountPassword": "*****" }

ConnectionInfo

string

Não

As informações de conexão da fonte de dados, que descrevem como acessar a fonte de dados. Exemplos:

  • Fonte de dados de NAS local: { "dataServerAddresses": [ { "host": "123.123.123.123", "port": "8080" } ], "sharePath": "/share", "mountOptions": "vers=3", "fileSystemType": "nfs" }

  • Fonte de dados do CPFS for AI: {"vpcMountTarget":"cpfs-010wn***wy-vpc-ta***8.cn-shanghai.cpfs.aliyuncs.com","sharePath":"/"}

  • Fonte de dados de outro sistema de arquivos de grande escala: {"path":"/mnt"}

{ "dataServerAddresses": [ { "host": "123.123.123.123", "port": "8080" } ], "sharePath": "/share", "mountOptions": "vers=3", "fileSystemType": "nfs" }

IndexLevel

string

Não

O nível do índice. Este parâmetro é usado apenas para análise de fonte de dados no recurso de arquivamento. Não use este parâmetro em outros cenários. Valores válidos:

  • OFF: nenhum índice é criado

  • META: índice de metadados

  • ALL: índice de texto completo ([Deprecated])

META

ClusterId

string

Não

O ID do grupo de clientes usado para acessar a fonte de dados.

cl-0004i0nlngorvgjpl7ck

Schedule

string

Não

O ciclo de execução. Este parâmetro é usado apenas para análise de fonte de dados no recurso de arquivamento. Não use este parâmetro em outros cenários. Formato: I{startTime}{interval}. Isso indica que uma tarefa é executada em um intervalo de {interval} a partir de {startTime}. startTime: a hora de início, que é um timestamp UNIX em segundos. interval: um intervalo de tempo ISO 8601. Por exemplo, PT1H indica um intervalo de uma hora e P1D indica um intervalo de um dia.

I|1729493847|P1D

SpeedLimit

string

Não

O limite de taxa. Este parâmetro é usado apenas para análise de fonte de dados no recurso de arquivamento. Não use este parâmetro em outros cenários.

6:21:10240

Options

string

Não

As opções de análise da fonte de dados. Este parâmetro é usado apenas para análise de fonte de dados no recurso de arquivamento. Não use este parâmetro em outros cenários.

{}

Include

string

Não

O filtro que especifica os arquivos a serem incluídos. Este parâmetro é usado apenas para análise de fonte de dados no recurso de arquivamento. Não use este parâmetro em outros cenários.

["/home/alice", "/home/bob"]

Exclude

string

Não

O filtro que especifica os arquivos a serem excluídos. Este parâmetro é usado apenas para análise de fonte de dados no recurso de arquivamento. Não use este parâmetro em outros cenários.

["/home/alice/log"]

Path

array

Não

A lista de caminhos para análise da fonte de dados. Este parâmetro é usado apenas para análise de fonte de dados no recurso de arquivamento. Não use este parâmetro em outros cenários.

string

Não

O caminho para análise da fonte de dados. Este parâmetro é usado apenas para análise de fonte de dados no recurso de arquivamento. Não use este parâmetro em outros cenários.

/home

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Code

string

O código de erro.

200

Message

string

A mensagem retornada quando a fonte de dados é adicionada.

successful

RequestId

string

O ID da solicitação.

53167AD3-****-****-92C7-CF69A000BA45

Success

boolean

Indica se a solicitação foi bem-sucedida.

true

DataSourceId

string

O ID da fonte de dados.

ds-000*******xzj

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "200",
  "Message": "successful",
  "RequestId": "53167AD3-****-****-92C7-CF69A000BA45",
  "Success": true,
  "DataSourceId": "ds-000*******xzj"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.