Todos os produtos
Search
Central de documentação

Object Storage Service:delete-bucket-replication

Última atualização: Jul 03, 2026

Desativa a replicação de dados de um bucket e exclua as regras de replicação correspondentes. Após essa operação, nenhuma alteração no bucket de origem será sincronizada com o bucket de destino.

Observações de uso

  • Para excluir uma regra de replicação de dados de um bucket, você precisa da permissão oss:DeleteBucketReplication. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.

  • O comando delete-bucket-replication não remove a regra de replicação instantaneamente. O Object Storage Service (OSS) leva algum tempo para limpar as tarefas de replicação associadas à regra. Durante esse processo, as tarefas permanecem no estado Closing. A regra só é excluída após a conclusão dessa limpeza.

  • Somente o proprietário do bucket pode excluir suas regras de replicação. Você pode realizar essa exclusão por meio de qualquer endpoint do OSS.

Sintaxe do comando

ossutil api delete-bucket-replication --bucket value --replication-rules value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket cujas regras de replicação serão excluídas.

--replication-rules

string

Contêiner que armazena a regra de replicação de dados a ser excluída.

Nota

A exclusão de regras de replicação segue o mesmo padrão da operação DeleteBucketReplication. Para obter detalhes sobre os parâmetros dessa operação, consulte DeleteBucketReplication.

--replication-rules

A opção --replication-rules aceita os formatos XML e JSON. Se o valor incluir o prefixo file://, o ossutil lerá as configurações diretamente do arquivo especificado.

  • Formato XML:

    <ReplicationRules>
      <ID>string</ID>
    </ReplicationRules>
  • Formato JSON:

    {
      "ID": "string"
    }
    Nota

    Para mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções de linha de comando.

Exemplos

  • Para desativar a replicação de dados no bucket examplebucket e remover a regra com ID rule_id, utilize um dos métodos abaixo:

    • Crie um arquivo de configuração chamado replication-rules.xml e adicione o seguinte código:

      <?xml version="1.0" encoding="UTF-8"?>
      <ReplicationRules>
        <ID>rule_id</ID>
      </ReplicationRules>

      Comando de exemplo:

      ossutil api delete-bucket-replication --bucket examplebucket --replication-rules file://replication-rules.xml
    • Crie um arquivo de configuração chamado replication-rules.json e adicione o seguinte código:

      {
        "ID": "rule_id"
      }

      Comando de exemplo:

      ossutil api delete-bucket-replication --bucket examplebucket --replication-rules file://replication-rules.json
    • Defina os parâmetros diretamente no comando usando o formato JSON:

      ossutil api delete-bucket-replication --bucket examplebucket --replication-rules "{\"ID\":\"rule_id\"}"