Exclui um nome de domínio personalizado (registro CNAME) mapeado a um bucket.
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 é necessária para excluir um CNAME como usuário RAM ou ao usar STS. Para mais informações, consulte Grant a custom policy.
Sintaxe do comando
ossutil api delete-cname --bucket value --cname-configuration value --wildcard value [flags]
|
Parâmetro |
Tipo |
Descrição |
|
--bucket |
string |
Nome do bucket. |
|
--cname-configuration |
string |
Contêiner de configuração do CNAME. |
|
--wildcard |
string |
Indica se um CNAME de domínio com curinga deve ser excluído. Valores válidos: true e false. Para um Agentic Bucket, defina explicitamente este parâmetro como true ou false. Em buckets padrão, o parâmetro é opcional e assume false por padrão. |
O comando delete-cname corresponde à operação da API DeleteCname. Para obter mais detalhes sobre os parâmetros, consulte DeleteCname.
A opção --wildcard é um novo parâmetro para operações de CNAME com domínio curinga. Verifique se sua versão do ossutil oferece suporte a esse parâmetro.
--cname-configuration
A opção --cname-configuration aceita XML e JSON. Se o valor contiver o prefixo file://, a configuração será lida de um arquivo.
-
Sintaxe XML:
<BucketCnameConfiguration> <Cname> <Domain>string</Domain> </Cname> </BucketCnameConfiguration> -
Sintaxe JSON:
{ "Cname": { "Domain": "string" } }
Para obter mais informações sobre as opções globais de linha de comando compatíveis, consulte Global command-line options.
Exemplos
-
Exclua o nome de domínio personalizado
example.commapeado aexamplebucket.-
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 Bucketmy-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
-