Todos os produtos
Search

Este produto

    Cloud Backup:UpdatePolicyBinding

    Central de documentação

    Cloud Backup:UpdatePolicyBinding

    Última atualização: Oct 26, 2026

    Modifica a associação entre uma política e uma fonte de dados.

    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:UpdatePolicyBinding

    update

    *Todos os recursos.

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    PolicyId

    string

    Sim

    O ID da política.

    po-000************ky9
    DataSourceId

    string

    Sim

    O ID da fonte de dados.

    i-bp1************dtv
    SourceType

    string

    Sim

    O tipo da fonte de dados. Valores válidos:

    • UDM_ECS: Backup de instância ECS.

    • OSS: Backup do OSS.

    • NAS: Backup do Alibaba Cloud NAS.

    • COMMON_NAS: Backup de NAS local.

    • ECS_FILE: ECS File Backup Standard Edition.

    • File: Backup de arquivo local.

    • COMMON_FILE_SYSTEM: Backup baseado em agente do CPFS.

    • OTS: Backup do Tablestore.

    • CPFS: Backup sem agente do CPFS.

    UDM_ECS
    PolicyBindingDescription

    string

    Não

    A descrição da vinculação da política.

    po-000************5xx-i-2ze************nw4
    Disabled

    boolean

    Não

    Especifica se a política está suspensa para a fonte de dados. Valores válidos:

    • true: Suspensa.

    • false: Não suspensa.

    true
    Source

    string

    Não

    A fonte de backup. O significado varia com base no valor de SourceType.

    • OSS: O prefixo a ser submetido a backup. Se não for especificado, o diretório raiz de todo o bucket será submetido a backup. Apenas um único prefixo é suportado. Para fazer backup de objetos com o prefixo de dados, insira data em vez de /data.

    • ECS_FILE: Os diretórios de arquivos a serem submetidos a backup. Se não for especificado, todos os diretórios serão submetidos a backup. Vários diretórios podem ser especificados. Para fazer backup de arquivos nos diretórios /a e /b, insira ["/a", "/b"].

    • File: Os diretórios de arquivos a serem submetidos a backup. Se não for especificado, todos os diretórios serão submetidos a backup. Vários diretórios podem ser especificados. Para fazer backup de arquivos nos diretórios /a e /b, insira ["/a", "/b"].

    • COMMON_FILE_SYSTEM: Obrigatório. Os caminhos de origem. Vários caminhos podem ser especificados. Para fazer backup dos caminhos /a e /b, insira ["/a", "/b"]. Para fazer backup do caminho raiz, insira ["/"].

    • COMMON_NAS: Obrigatório. O caminho de origem. Apenas um único caminho é suportado. Para fazer backup do caminho /a, insira ["/a"]. Para fazer backup do caminho raiz, insira ["/"].

    • OTS: A lista de tabelas de dados a serem submetidas a backup. Se não for especificado, todas as tabelas de dados serão submetidas a backup. Várias tabelas de dados podem ser especificadas. Para fazer backup das tabelas de dados a e b, insira ["a", "b"].

    • CPFS: Obrigatório. Os caminhos de origem. Vários caminhos podem ser especificados. Para fazer backup dos caminhos /a e /b, insira ["/a", "/b"]. Para fazer backup do caminho raiz, insira ["/"].

    /src
    Include

    string

    Não

    Os tipos de arquivo a serem submetidos a backup. Este parâmetro está disponível quando SourceType é definido como ECS_FILE, File, NAS, COMMON_NAS, COMMON_FILE_SYSTEM ou CPFS. Todos os arquivos dos tipos especificados são submetidos a backup. O valor pode ter até 255 caracteres.

    [\"*.doc\",\"*.xltm\"]
    Exclude

    string

    Não

    Os tipos de arquivo a serem submetidos a backup. Este parâmetro está disponível quando SourceType é definido como ECS_FILE, File, NAS, COMMON_NAS, COMMON_FILE_SYSTEM ou CPFS. Todos os arquivos dos tipos especificados são submetidos a backup. O valor pode ter até 255 caracteres.

    [\"*.doc\",\"*.xltm\"]
    SpeedLimit

    string

    Não

    O limitador de tráfego de backup. Este parâmetro é obrigatório quando SourceType é definido como ECS_FILE ou File. O formato é {start}{end}{bandwidth}. Várias configurações de limitação são separadas, e os períodos de tempo configurados não devem se sobrepor.

    • start: A hora de início.

    • end: A hora de término.

    • bandwidth: O limite de largura de banda. Unidade: KB/s.

    0:24:5120
    AdvancedOptions

    object

    Não

    As opções avançadas.

    UdmDetail

    object

    Não

    Os detalhes do backup da instância ECS.

    ExcludeDiskIdList

    array

    Não

    Os IDs dos discos em nuvem que não precisam ser protegidos. Este parâmetro é ignorado se DiskIdList não estiver vazio.

    string

    Não

    O ID do disco em nuvem que não precisa ser protegido.

    d-bp1************apo
    DiskIdList

    array

    Não

    Os IDs dos discos em nuvem a serem protegidos. Este valor fica vazio quando todos os discos em nuvem estão protegidos.

    string

    Não

    O ID do disco em nuvem a ser protegido.

    d-bp1************apo
    SnapshotGroup

    boolean

    Não

    Especifica se deve ser criado um grupo consistente com snapshot. Grupos consistentes com snapshot são suportados apenas quando todos os discos em nuvem são ESSDs.

    true
    AppConsistent

    boolean

    Não

    Especifica se a consistência de aplicativo deve ser ativada. Snapshots consistentes com aplicativo são suportados apenas quando todos os discos em nuvem são ESSDs.

    false
    RamRoleName

    string

    Não

    O nome da função do RAM configurada para criar snapshots consistentes com aplicativo. Este parâmetro é obrigatório quando AppConsistent é definido como true.

    AliyunECSInstanceForHbrRole
    PreScriptPath

    string

    Não

    O caminho do script de pré-congelamento a ser executado antes da criação de um snapshot consistente com aplicativo. Este parâmetro é obrigatório quando AppConsistent é definido como true.

    /tmp/prescript.sh
    PostScriptPath

    string

    Não

    O caminho do script de pós-descongelamento a ser executado após a criação de um snapshot consistente com aplicativo. Este parâmetro é obrigatório quando AppConsistent é definido como true.

    /tmp/postscript.sh
    EnableFsFreeze

    boolean

    Não

    Especifica se o mecanismo FsFreeze do Linux deve ser usado para garantir a consistência de leitura do sistema de arquivos antes da criação de um snapshot consistente com aplicativo. Este parâmetro é obrigatório quando AppConsistent é definido como true. Valor padrão: true.

    true
    TimeoutInSeconds

    integer

    Não

    O período de tempo limite de congelamento de E/S. Unidade: segundos. Este parâmetro é obrigatório quando AppConsistent é definido como true. Valor padrão: 30.

    30
    EnableWriters

    boolean

    Não

    Especifica se snapshots consistentes com aplicativo devem ser configurados. Este parâmetro é obrigatório quando AppConsistent é definido como true. Valores válidos:

    • true: Cria snapshots consistentes com aplicativo.

    • false: Cria snapshots consistentes com o sistema de arquivos.

    Valor padrão: true.

    true
    OssDetail

    object

    Não

    Os detalhes do backup do OSS.

    InventoryId

    string

    Não

    O nome do inventário do OSS. Se este valor não estiver vazio, o inventário do OSS será usado para ajuste de desempenho.

    • Use um inventário para melhorar o desempenho de backup incremental ao fazer backup de mais de 100 milhões de objetos do OSS. As taxas de armazenamento geradas pelos arquivos de inventário são cobradas separadamente pelo OSS.

    • A geração de arquivos de inventário do OSS leva tempo. Os backups podem falhar antes que a geração seja concluída. Nesse caso, aguarde o próximo ciclo de backup.

    30663060
    InventoryCleanupPolicy

    string

    Não

    Especifica se os arquivos de inventário devem ser excluídos após o backup. Este parâmetro é válido apenas quando um inventário do OSS é usado. Valores válidos:

    • NO_CLEANUP: Não exclui os arquivos.

    • DELETE_CURRENT: Exclui o arquivo atual.

    • DELETE_CURRENT_AND_PREVIOUS: Exclui todos os arquivos.

    NO_CLEANUP
    IgnoreArchiveObject

    boolean

    Não

    Exclui objetos arquivados das estatísticas da tarefa e das listas de arquivos com falha.

    true
    CommonFileSystemDetail

    object

    Não

    Os detalhes do backup de sistema de arquivos em grande escala.

    FullOnIncrementFail

    boolean

    Não

    Especifica se deve alternar para um backup completo quando um backup incremental falhar. Valores válidos:

    • true: Alterna para um backup completo em caso de falha.

    • false: Não alterna para um backup completo em caso de falha.

    true
    FetchSliceSize

    integer

    Não

    O tamanho da fatia de backup (número de arquivos).

    100000

    Elementos de resposta

    Elemento

    Tipo

    Descrição

    Exemplo

    object

    UpdatePolicyBindingResponse.

    Success

    boolean

    Indica se a solicitação foi bem-sucedida. Valores válidos:

    • true: A solicitação foi bem-sucedida.

    • false: A solicitação falhou.

    true
    Code

    string

    O código de retorno. Um valor 200 indica sucesso.

    200
    Message

    string

    A mensagem de retorno. "successful" é retornado para solicitações bem-sucedidas, e mensagens de erro específicas são retornadas para solicitações com falha.

    successful
    RequestId

    string

    O ID da solicitação.

    B6F24C46-54B9-519B-9AB8-A8988D705E67

    Exemplos

    Resposta de sucesso

    JSON formato

    {
  "Success": true,
  "Code": "200",
  "Message": "successful",
  "RequestId": "B6F24C46-54B9-519B-9AB8-A8988D705E67"
}

    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.