Criação ou exclusão de uma tag

Função

Essa API é usada para criar ou excluir uma tag.

URI

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

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.