Todos os produtos
Search

Este produto

    Cloud Backup:UpdatePolicyBinding

    Central de documentação

    Cloud Backup:UpdatePolicyBinding

    Última atualização: Jun 28, 2026

    Atualiza a associação entre uma política de backup e uma origem 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

    *All Resource

    *

    		 Nenhuma Nenhuma

    Parâmetros da solicitação

    Parâmetro

    Tipo

    Obrigatório

    Descrição

    Exemplo
    PolicyId

    string

    Sim

    O ID da política de backup.

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

    string

    Sim

    O ID da origem de dados.

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

    string

    Sim

    O tipo da origem de dados. Valor válido:

    • UDM_ECS: Backup de instância ECS

    UDM_ECS
    PolicyBindingDescription

    string

    Não

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

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

    boolean

    Não

    Especifica se a política de backup deve ser desativada para a origem de dados.

    • true: A política de backup está desativada.

    • false: A política de backup não está desativada.

    true
    Source

    string

    Não

    Este parâmetro tem diferentes significados com base no valor de SourceType.

    • OSS: O prefixo dos objetos dos quais você deseja fazer backup. Se você não especificar este parâmetro, o bucket inteiro será submetido a backup. Apenas um único prefixo é suportado. Para fazer backup do diretório /backup, defina este parâmetro como /backup.

    • ECS_FILE: Os caminhos para os arquivos dos quais você deseja fazer backup. Se você não especificar este parâmetro, todos os arquivos serão submetidos a backup. Você pode especificar vários caminhos. Para fazer backup dos arquivos nos caminhos /a e /b, defina este parâmetro como ["/a", "/b"].

    • File: Os caminhos para os arquivos dos quais você deseja fazer backup. Se você não especificar este parâmetro, todos os arquivos serão submetidos a backup. Você pode especificar vários caminhos. Para fazer backup dos arquivos nos diretórios /a e /b, defina este parâmetro como ["/a", "/b"].

    • COMMON_FILE_SYSTEM: Obrigatório. Os caminhos de backup. Você pode especificar vários caminhos. Para fazer backup dos caminhos /a e /b, defina este parâmetro como ["/a", "/b"]. Para fazer backup do diretório raiz, defina este parâmetro como ["/"].

    • COMMON_NAS: Obrigatório. O caminho de backup. Apenas um único caminho é suportado. Para fazer backup do caminho /a, defina este parâmetro como ["/a"]. Para fazer backup do diretório raiz, defina este parâmetro como ["/"].

    • OTS: A lista de tabelas das quais você deseja fazer backup. Se você não especificar este parâmetro, todas as tabelas serão submetidas a backup. Você pode especificar várias tabelas. Para fazer backup da Tabela a e da Tabela b, defina este parâmetro como ["a", "b"].

    backup/
    Include

    string

    Não

    Este parâmetro está disponível apenas se você definir SourceType como ECS_FILE, File, NAS, COMMON_NAS ou COMMON_FILE_SYSTEM. Este parâmetro especifica os tipos de arquivo a serem submetidos a backup. Todos os arquivos dos tipos especificados serão submetidos a backup. O valor pode ter até 255 caracteres.

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

    string

    Não

    Este parâmetro é obrigatório quando SourceType é definido como ECS_FILE, File, NAS, COMMON_NAS ou COMMON_FILE_SYSTEM. Ele especifica os tipos de arquivo a serem incluídos no backup. O valor pode ter até 255 caracteres.

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

    string

    Não

    Este parâmetro é obrigatório apenas se você definir SourceType como ECS_FILE ou File. Este parâmetro especifica as regras de limitação para backups. O formato é {start}{end}{bandwidth}. Separe várias regras de limitação com uma barra vertical (|). Os períodos de tempo das regras não podem se sobrepor.

    • start: A hora de início.

    • end: A hora de término.

    • bandwidth: A velocidade de limitação. 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

    A lista de IDs de discos em nuvem que não precisam ser protegidos. Este parâmetro é ignorado quando DiskIdList não está vazio.

    string

    Não

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

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

    array

    Não

    A lista de IDs de discos em nuvem que precisam ser protegidos. Se você quiser proteger todos os discos em nuvem, deixe este parâmetro vazio.

    string

    Não

    O ID de um disco em nuvem que precisa ser protegido.

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

    boolean

    Não

    Especifica se deve ser criado um grupo consistente com snapshot. Você pode criar um grupo consistente com snapshot apenas se todos os tipos de disco forem Enhanced SSDs (ESSDs).

    true
    AppConsistent

    boolean

    Não

    Especifica se a consistência de aplicativo deve ser ativada. Você pode ativar a consistência de aplicativo apenas se todos os tipos de disco forem ESSDs.

    false
    RamRoleName

    string

    Não

    Este parâmetro é obrigatório apenas se você definir AppConsistent como true. Este parâmetro especifica o nome da função RAM necessária para criar snapshots consistentes com o aplicativo.

    AliyunECSInstanceForHbrRole
    PreScriptPath

    string

    Não

    Este parâmetro é obrigatório apenas se você definir AppConsistent como true. Este parâmetro especifica o caminho para o script de pré-congelamento que é executado antes da criação de um snapshot consistente com o aplicativo.

    /tmp/prescript.sh
    PostScriptPath

    string

    Não

    Este parâmetro é obrigatório apenas se você definir AppConsistent como true. Este parâmetro especifica o caminho para o script de pós-descongelamento que é executado após a criação de um snapshot consistente com o aplicativo.

    /tmp/postscript.sh
    EnableFsFreeze

    boolean

    Não

    Este parâmetro é obrigatório apenas se você definir AppConsistent como true. Este parâmetro 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 o aplicativo. O valor padrão é true.

    true
    TimeoutInSeconds

    integer

    Não

    Este parâmetro é obrigatório apenas se você definir AppConsistent como true. Este parâmetro especifica o período de tempo limite de congelamento de E/S. O valor padrão é 30 segundos.

    30
    EnableWriters

    boolean

    Não

    Este parâmetro é obrigatório apenas se você definir AppConsistent como true. Este parâmetro especifica se um snapshot consistente com o aplicativo deve ser criado:

    • true: Cria um snapshot consistente com o aplicativo.

    • false: Cria um snapshot consistente com o sistema de arquivos.

    O 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 você especificar este parâmetro, o inventário do OSS será usado para ajuste de desempenho.

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

    • Leva tempo para gerar um arquivo de inventário do OSS. Antes que o arquivo de inventário seja gerado, o trabalho de backup pode falhar. Você pode aguardar a execução do próximo ciclo de backup.

    30663060
    InventoryCleanupPolicy

    string

    Não

    Especifica se o arquivo de inventário deve ser excluído após um backup. Este parâmetro é válido apenas quando você usa um inventário do OSS. Valores válidos:

    • NO_CLEANUP: Não exclui o arquivo de inventário.

    • DELETE_CURRENT: Exclui o arquivo atual.

    • DELETE_CURRENT_AND_PREVIOUS: Exclui todos os arquivos.

    NO_CLEANUP
    IgnoreArchiveObject

    boolean

    Não

    Especifica se os objetos de arquivamento devem ser excluídos das estatísticas da tarefa e da lista 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 um backup completo deve ser executado se um backup incremental falhar. Valores válidos:

    • true: Executa um backup completo.

    • false: Não executa um backup completo.

    true
    FetchSliceSize

    integer

    Não

    O tamanho da partição de backup (o 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.

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

    • false: A solicitação falhou.

    true
    Code

    string

    O código de retorno. O valor 200 indica que a solicitação foi bem-sucedida.

    200
    Message

    string

    A mensagem retornada. Se a solicitação for bem-sucedida, "successful" será retornado. Se a solicitação falhar, uma mensagem de erro será retornada.

    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.