Este conteúdo foi traduzido por máquina para sua conveniência e a Huawei Cloud não pode garantir que o conteúdo foi traduzido com precisão. Para exibir o conteúdo original, use o link no canto superior direito para mudar para a página em inglês.
Central de ajuda> Auto Scaling> Referência de API> APIs> Tags> Criação ou exclusão de uma tag
Atualizado em 2023-07-04 GMT+08:00

Criação ou exclusão de uma tag

Função

Essa API é usada para criar ou excluir uma tag.

Cada grupo de AS pode ter um máximo de 10 tags adicionadas a ele.

URI

POST /autoscaling-api/v1/{project_id}/{resource_type}/{resource_id}/tags/action

Tabela 1 Descrição do parâmetro

Parâmetro

Obrigatório

Tipo

Descrição

project_id

Sim

String

Especifica o ID do projeto.

resource_type

Sim

String

Especifica o tipo de recurso. A opção é a seguinte:

scaling_group_tag: indica que o tipo de recurso é grupos de AS.

resource_id

Sim

String

ID do recurso

Mensagem de solicitação

  • Parâmetros de solicitação
    Tabela 2 Parâmetros de solicitação

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    tags

    Sim

    Array of ResourceTag objects

    Especifica a lista de tags. Para mais detalhes, consulte Tabela 3.

    Se action estiver definida para delete, a estrutura da tag não pode estar ausente e a chave não pode ser deixada em branco ou uma cadeia vazia.

    action

    Sim

    String

    Especifica o ID de operação. O valor diferencia maiúsculas de minúsculas e pode ser qualquer um dos seguintes:

    • delete: indica a exclusão de uma tag.
    • create: indica a criação de uma tag. Se o mesmo valor de chave já existir, ele será sobrescrito.
    Tabela 3 Descrição do campo ResourceTag

    Parâmetro

    Obrigatório

    Tipo

    Descrição

    key

    Sim

    String

    Especifica a chave de tag. As chaves de tag de um recurso devem ser exclusivas.

    • Uma chave de tag contém no máximo 36 caracteres. O conjunto de caracteres é o seguinte: A-Z, a-z, 0-9, hifens (-), sublinhados (_) e caracteres Unicode (\u4E00-\u9FFF).
    • Quando action é definida para delete, o conjunto de caracteres de tag não é verificado e uma chave contém no máximo 127 caracteres Unicode.

    value

    Não

    String

    Especifica o valor de tag.

    • Um valor de tag contém no máximo 43 caracteres e pode ser deixado em branco. O conjunto de caracteres é o seguinte: A-Z, a-z, 0-9, pontos (.), hifens (-), sublinhados (_) e caracteres Unicode (\u4E00-\u9FFF).
    • Quando action está definida para delete, o conjunto de caracteres de tag não é verificado e um valor contém no máximo 255 caracteres Unicode. Se value for especificado, as tags serão excluídas por chave e valor. Se value não for especificado, as tags serão excluídas pela chave.
  • Exemplo de solicitação

    Este exemplo mostra como adicionar duas tags (chave = ENV15 e valor = ENV15) e (chave = ENV151 e valor = ENV151) ao grupo de AS com ID e5d27f5c-dd76-4a61-b4bc-a67c5686719a.

    POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_tag/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/tags/action
    
    { 
      "tags": [
        { 
            "key": "ENV15", 
            "value": "ENV15" 
        }, 
        { 
            "key": "ENV151", 
            "value": "ENV151" 
        }
        ], 
      "action": "create" 
    }

Mensagem de resposta

  • Parâmetros de resposta

    Nenhum

  • Exemplo de resposta

    Nenhum

Valores retornados

  • Normal

    204

  • Anormal

    Valores retornados

    Descrição

    400 Bad Request

    O servidor falhou ao processar a solicitação.

    401 Unauthorized

    Você deve digitar o nome de usuário e a senha para acessar a página solicitada.

    403 Forbidden

    Você está proibido de acessar a página solicitada.

    404 Not Found

    O servidor não conseguiu encontrar a página solicitada.

    405 Method Not Allowed

    Você não tem permissão para usar o método especificado na solicitação.

    406 Not Acceptable

    A resposta gerada pelo servidor não poderia ser aceita pelo cliente.

    407 Proxy Authentication Required

    Você deve usar o servidor proxy para autenticação para que a solicitação possa ser processada.

    408 Request Timeout

    A solicitação expirou o tempo limite.

    409 Conflict

    A solicitação não pôde ser processada devido a um conflito.

    500 Internal Server Error

    Falhou ao concluir a solicitação porque ocorreu um erro de serviço interno.

    501 Not Implemented

    Falhou ao concluir a solicitação porque o servidor não suporta a função solicitada.

    502 Bad Gateway

    Falhou ao concluir a solicitação porque o servidor recebe uma solicitação inválida.

    503 Service Unavailable

    Falhou ao concluir a solicitação porque o sistema está indisponível no momento.

    504 Gateway Timeout

    Ocorreu um erro de tempo limite de gateway.

Códigos de erro

Consulte Códigos de erro.