Todos os produtos
Search
Central de documentação

Object Storage Service:put-bucket-rtc

Última atualização: Sep 24, 2026

Ative ou desative o Replication Time Control (RTC) em regras de replicação entre regiões (CRR) existentes.

Notas de uso

Por padrão, uma conta Alibaba Cloud tem permissão para ativar ou desativar o RTC em regras de CRR existentes. Para ativar ou desativar o RTC em regras de CRR existentes com um usuário RAM ou o Security Token Service (STS), você deve ter a permissão oss:PutBucketRtc. Para mais informações, consulte Anexar uma política personalizada a um usuário RAM.

Sintaxe do comando

ossutil api put-bucket-rtc --bucket value --rtc-configuration value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--rtc-configuration

string

Configurações do RTC.

Nota

O comando put-bucket-rtc corresponde à operação PutBucketRTC. Para mais informações sobre os parâmetros da operação PutBucketRTC, consulte PutBucketRTC.

--rtc-configuration

A opção --rtc-configuration aceita os formatos XML e JSON. Se o valor da opção incluir o prefixo file://, o comando lê a configuração a partir de um arquivo.

  • Formato XML:

    <RtcConfiguration>
      <RTC>
        <Status>string</Status>
      </RTC>
      <ID>string</ID>
    </RtcConfiguration>
  • Formato JSON:

    {
      "RTC": {
        "Status": "string"
      },
      "ID": "string"
    }
Nota

Para mais informações, consulte Opções de linha de comando.

Exemplos

Os exemplos a seguir mostram como ativar o RTC para uma regra de CRR cujo ID é rtc-configuration, configurada para o bucket examplebucket.

  • O arquivo de configuração XML rtc-configuration.xml tem o seguinte conteúdo:

    <?xml version="1.0" encoding="UTF-8"?>
    <RtcConfiguration>
        <RTC>
            <Status>enabled</Status>
        </RTC>
        <ID>rtc-configuration</ID>
    </RtcConfiguration>  
    ossutil api put-bucket-rtc --bucket examplebucket --rtc-configuration file://rtc-configuration.xml
  • O arquivo de configuração JSON rtc-configuration.json contém o seguinte:

    {
        "RTC": {
            "Status": "enabled"
        },
        "ID": "rtc-configuratione"
    }
    ossutil api put-bucket-rtc --bucket examplebucket --rtc-configuration file://rtc-configuration.json
  • Configure os parâmetros no comando a seguir usando o formato JSON:

    ossutil api put-bucket-rtc --bucket examplebucket --rtc-configuration "{\"RTC\":{\"Status\":\"enabled\"},\"ID\":\"rtc-configuration\"}"