Todos os produtos
Search
Central de documentação

Object Storage Service:delete-cname

Última atualização: Jul 03, 2026

O comando delete-cname é usado para excluir um registro CNAME mapeado para um bucket do OSS.

Notas de uso

Por padrão, uma conta Alibaba Cloud tem as permissões necessárias para excluir um registro CNAME mapeado para um bucket do OSS. A exclusão de registros CNAME como usuário RAM ou usando o Security Token Service (STS) requer permissões oss:DeleteCname. Para mais informações, consulte Conceder uma política personalizada.

Sintaxe do comando

ossutil api delete-cname --bucket value --cname-configuration value [flags]

Parâmetro

Tipo

Descrição

--bucket

string

Nome do bucket.

--cname-configuration

string

Contêiner que armazena o registro CNAME.

Nota

O comando delete-cname corresponde à operação DeleteCname. Para mais informações sobre os parâmetros na operação DeleteCname, consulte DeleteCname.

--cname-configuration

A opção --cname-configuration oferece suporte aos formatos XML e JSON. Se o valor da opção contiver o prefixo 'file://', os parâmetros de configuração são lidos do arquivo especificado.

  • Formato XML:

    <BucketCnameConfiguration>
      <Cname>
        <Domain>string</Domain>
      </Cname>
    </BucketCnameConfiguration>
  • Formato JSON:

    {
      "Cname": {
        "Domain": "string"
      }
    }
Nota

Para mais informações sobre as opções globais da linha de comando suportadas, consulte Opções da linha de comando.

Exemplos

Exclua o registro CNAME example.com mapeado para examplebucket.

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

    <?xml version="1.0" encoding="UTF-8"?>
    <BucketCnameConfiguration>
      <Cname>
        <Domain>example.com</Domain>
      </Cname>
    </BucketCnameConfiguration>

Comando de exemplo:

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

    {
      "Cname": {
        "Domain": "example.com"
      }
    }

    Comando de exemplo:

    ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.json
  • Configure os parâmetros no seguinte comando no formato JSON:

    ossutil api delete-cname --bucket examplebucket --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}"