Todos os produtos
Search
Central de documentação

Object Storage Service:DeleteBucketReplication

Última atualização: Jul 03, 2026

Interrompe a replicação de dados de um bucket e exclua a configuração de replicação. Após a exclusão da regra, as operações no bucket source deixam de ser sincronizadas com o bucket de destino.

Observações de uso

  • Se não houver regras de replicação de dados configuradas para o bucket solicitado, esta operação retornará 200 OK.

  • A exclusão de uma regra de replicação de dados não é imediata. O OSS requer tempo para executar operações de limpeza, período em que o status da regra permanece como closing. A regra é removida somente após a conclusão dessa limpeza.

  • Se você chamar esta operação para uma regra de replicação de dados com status closing, o retorno será 204 NoContent.

Sintaxe da solicitação

POST /?replication&comp=delete HTTP/1.1 
Host: BucketName.oss-cn-hangzhou.aliyuncs.com 
Date: GMT Date
Content-Length: ContentLength
Content-Type: application/xml 
Authorization: SignatureValue

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

Elementos da solicitação

Nome

Tipo

Obrigatório

Descrição

ReplicationRules

Contêiner

Sim

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

Nó pai: Nenhum

Nó filho: ID

ID

String

Sim

ID da regra de replicação a ser excluída. Obtenha esse ID por meio da operação GetBucketReplication.

Nó pai: ReplicationRules

Nó filho: Nenhum

Exemplos

  • Exemplo de solicitação

POST /?replication&comp=delete HTTP/1.1 
Host: oss-example.oss-cn-hangzhou.aliyuncs.com 
Date: Thu, 17 Apr 2025 15:39:18 GMT
Content-Length: 46
Content-Type: application/xml
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,AdditionalHeaders=content-length,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

<?xml version="1.0" encoding="UTF-8"?>
<ReplicationRules>
  <ID>test_replication_1</ID>
</ReplicationRules>
  • Exemplo de resposta

HTTP/1.1 200 OK
x-oss-request-id: 534B371674E88A4D8906**** 
Date: Thu, 24 Sep 2015 15:39:18 GMT
Connection: close 
Content-Length: 0
Server: AliyunOSS

SDK

Os seguintes SDKs oferecem suporte a esta operação:

Ferramenta de linha de comando ossutil

Para obter o comando do ossutil referente a esta operação, consulte delete-bucket-replication.

Códigos de erro

Código de erro

Código de status

Descrição

NoSuchBucket

404 NotFound

O bucket solicitado não existe.

TooManyReplicationRules

400 BadRequest

A solicitação contém mais de uma regra de replicação de dados.

Cada solicitação deve incluir apenas uma regra de replicação de dados.

TransferAccAlreadyInUse

409Conflict

A aceleração de transferência está desativada para o bucket de destino especificado na replicação entre regiões (CRR). A resposta de erro em XML inclui informações sobre os buckets de origem e de destino:

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>TransferAccAlreadyInUse</Code>
  <Message>The transfer acceleration is already used by cross-region replication.</Message>
  <SourceBucket>srcBucket</SourceBucket>
  <DestinationBucket>destBucket</DestinationBucket>
  <RequestId>5F1E76142A535D373683****</RequestId>
  <HostId>oss-cn-hangzhou.aliyuncs.com</HostId>
</Error>