Todos os produtos
Search
Central de documentação

Object Storage Service:delete-bucket-replication

Última atualização: Sep 22, 2026

Desabilita a replicação de dados de um bucket e exclui as regras de replicação de dados desse bucket. Nesse caso, nenhuma operação no bucket source é sincronizada com o bucket de destino.

Notas de uso

  • Para excluir uma regra de replicação de dados de um bucket, você precisa ter a permissão oss:DeleteBucketReplication. Para mais informações, consulte Attach a custom policy to a RAM user.

  • O comando delete-bucket-replication não exclui uma regra de replicação de dados imediatamente. O Object Storage Service (OSS) leva um determinado período de tempo para limpar as tarefas de replicação de dados executadas com base na regra de replicação de dados. Durante esse processo, as tarefas de replicação de dados ficam no estado Closing. Após a limpeza das tarefas de replicação de dados, o OSS exclui a regra de replicação de dados.

  • Somente o proprietário do bucket pode excluir as regras de replicação de dados dele. Para isso, utilize um endpoint do OSS.

Sintaxe do comando

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

Parâmetro

Tipo

Descrição

--bucket

string

O nome do bucket que contém as regras de replicação de dados a serem excluídas.

--replication-rules

string

O contêiner utilizado para armazenar a regra de replicação de dados a ser excluída.

Nota

Você pode excluir regras de replicação de dados da mesma maneira que chama a operação DeleteBucketReplication. Para mais informações sobre os parâmetros da operação DeleteBucketReplication, consulte DeleteBucketReplication.

--replication-rules

A opção --replication-rules aceita os formatos XML e JSON. Se o valor da opção contiver o prefixo file://, o ossutil lê as configurações de um arquivo específico.

  • 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 Command-line options.

Exemplos

  • Para desabilitar a replicação de dados de um bucket chamado examplebucket e exclua uma regra de replicação de dados cujo ID é rule_id nesse bucket, utilize um dos seguintes métodos:

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

      <?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 replication-rules.json e adicione o seguinte código a ele:

      {
        "ID": "rule_id"
      }

      Comando de exemplo:

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

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