Delete a CNAME record that is mapped to an OSS bucket. - Object Storage Service: Central de Documentação do Alibaba Cloud

Observação de uso

Por padrão, uma conta Alibaba Cloud tem permissão para excluir um nome de domínio personalizado mapeado a um bucket. A permissão oss:DeleteCname é obrigatória para excluir um CNAME como usuário RAM ou ao usar o STS. Para mais informações, consulte Conceder uma política personalizada.

Sintaxe do comando

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

Parâmetro	Tipo	Descrição
--bucket	string	O nome do bucket.
--cname-configuration	string	O contêiner de configuração do CNAME.
--wildcard	bool	Especifica se um CNAME de domínio curinga deve ser excluído. Valores válidos: true e false. Para um Agentic Bucket, defina este parâmetro explicitamente como true ou false. Para um bucket padrão, este parâmetro é opcional e o valor padrão é false.

Nota

O comando delete-cname corresponde à operação da API DeleteCname. Para mais informações sobre os parâmetros, consulte DeleteCname.
A opção --wildcard é um novo parâmetro para operações de CNAME de domínio curinga. Certifique-se de que a sua versão do ossutil oferece suporte a este parâmetro.

--cname-configuration

A opção --cname-configuration aceita tanto XML quanto JSON. Se o valor contiver o prefixo file://, o sistema lê a configuração a partir de um arquivo.

Sintaxe XML:

<BucketCnameConfiguration>
  <Cname>
    <Domain>string</Domain>
  </Cname>
</BucketCnameConfiguration>

Sintaxe JSON:

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

Nota

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

Exemplos

Exclua o nome de domínio personalizado example.com mapeado a examplebucket.

Use um arquivo de configuração XML. O conteúdo de cname-configuration.xml é o seguinte:

<?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

Use um arquivo de configuração JSON. O conteúdo de cname-configuration.json é o seguinte:

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

Comando de exemplo:

ossutil api delete-cname --bucket examplebucket --cname-configuration file://cname-configuration.json

Use parâmetros de configuração JSON. Comando de exemplo:

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

Exclua o CNAME curinga de example.com (sem o prefixo *.) do Agentic Bucket my-uid-region-ab-apsr.
- Use parâmetros de configuração JSON. Comando de exemplo:
```
ossutil api delete-cname --bucket my-uid-region-ab-apsr --cname-configuration "{\"Cname\":{\"Domain\":\"example.com\"}}" --wildcard=true
```