Todos os produtos
Search

Este produto

    Elasticsearch:UntagResources

    Central de documentação

    Elasticsearch:UntagResources

    Última atualização: Jun 27, 2026

    Exclui uma relação de tag de recurso do usuário.

    Ao chamar esta operação, observe os seguintes itens:

    • Apenas tags de usuário podem ser excluídas.

      Nota

      Rótulos de usuário são adicionados manualmente às instâncias pelos usuários. Uma Tag de sistema é uma tag que os serviços da Alibaba Cloud adicionam às instâncias. Os rótulos de sistema dividem-se em rótulos visíveis e invisíveis.

    • Caso você exclua uma relação de tag de recurso não associada a nenhum recurso, será necessário excluir as tags.

    Depuração

    O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

    Cabeçalho da requisição

    Esta operação utiliza apenas parâmetros de requisição comuns. Para mais informações, consulte Parâmetros comuns.

    Sintaxe da requisição

    DELETE /openapi/tags HTTPS|HTTP

    Parâmetros da requisição

    Parâmetro

    Tipo

    Obrigatório

    Exemplo

    Descrição

    ResourceIds

    String

    Obrigatório

    ["es-cn-09k1rocex0006**","es-cn-oew1rgiev0009**"]

    A lista de recursos que você deseja excluir.

    ResourceType

    String

    Obrigatório

    INSTANCE

    O tipo do recurso. Fixado como INSTANCE .

    TagKeys

    String

    Não

    ["tagKey1","tagKey2"]

    A lista de tags que você deseja excluir. A lista pode conter até 20 subitens.

    All

    Boolean

    Não

    false

    Especifica se todas as partes devem ser excluídas. Valor padrão: false . Este parâmetro é válido apenas quando TagKeys não for especificado.

    • Com All=true, ao chamar esta operação com TagKeys vazio, todas as relações de tag de recurso sob o Recurso são excluídas. Para recursos sem tags, a interface não processa a solicitação e retorna sucesso.

    • Quando TagKeys for nulo e All=false, a API não processa a solicitação e retorna sucesso.

    • Se TagKeys não estiver vazio, o parâmetro All será ignorado durante a chamada desta operação, independentemente de ser verdadeiro ou falso.

    • Após especificar as TagKeys, chame esta operação para excluir as tags especificadas dos recursos. Caso a tag especificada não exista em um recurso, ela não será processada.

    • Se o recurso solicitado não existir, o sistema retornará InvalidResourceId.NotFound ao chamar esta operação.

    Parâmetros de resposta

    ParâmetroTipoExemploDescrição
    RequestIdStringF99407AB-2FA9-489E-A259-40CF6D******

    O ID da requisição.

    ResultBooleantrue

    Resultados retornados:

    • true: excluído
    • false: Falha

    Exemplos

    Exemplos de requisições

    DELETE /openapi/tags? ResourceType=INSTANCE&ResourceIds=%5B%22es-cn-09k1rocex0006****%22%5D HTTP/1.1
Common request header

    Exemplos de respostas de sucesso

    Formato JSON

    {
    "Result":true,
    "RequestId": "3D8795D9-8FF5-46B2-86E6-E3B40*******"
}

    Códigos de erro

    HttpCode

    Código de erro

    Mensagem de erro

    Descrição

    400

    InstanceNotFound

    The instanceId provided does not exist.

    Mensagem de erro retornada porque a instância especificada não foi encontrada. Verifique o status da instância.

    Para obter uma lista de códigos de erro, visite a Central de Erros da API.