Adição ou modificação de uma tag

Função

Essa API é usada para adicionar uma tag a uma imagem ou modificar uma tag de uma imagem. Com tags, você pode gerenciar facilmente as imagens.

URI

PUT /v1/cloudimages/tags

Solicitação

• Parâmetros de solicitação

  Parâmetro	Obrigatório	Tipo	Descrição
  id_imagem	Sim	Cadeia	Especifica o ID da imagem. Para obter detalhes de como conseguir o ID de domínio, consulte Consulta de imagens.
  Tag	Não	Cadeia	Especifica a tag. Use tag ou image_tag.
  image_tag	Não	Objeto	Lista as tags de imagem. Para uma descrição detalhada, consulte Formatos de dados da tag de imagem. Este parâmetro é deixado em branco por padrão. Use tag ou image_tag.

  Tabela 1 Descrição da estrutura de dados do campo image_tag

  Parâmetro	Obrigatório	Tipo	Descrição
  chave	Sim	Cadeia	Especifica a chave de marcação.
  Valor	Sim	Cadeia	Especifica o valor da tag.

• Exemplo de solicitação
  • Exemplo de solicitação contendo o parâmetro tag

    PUT https://{Endpoint}/v1/cloudimages/tags

    1 2 3 4

    { "image_id": "62a15f6c-9197-44d2-89c7-708981c1bec1", "tag": "aaaa.1111" }

  • Exemplo de solicitação contendo o parâmetro image_tag

    PUT https://{Endpoint}/v1/cloudimages/tags

    1 2 3 4

    { "image_id": "67437ebd-2563-46e0-887e-ad1923977fa1", "image_tag": {"key":"key1","value":"value1"} }

Resposta

• Parâmetros de resposta

  Nenhum

• Exemplo de resposta

  STATUS CODE 204

Valor retornado

• Normal

  204

• Anormal

  Valor retornado	Descrição
  400 Solicitação inválida	Erro na solicitação.
  401 Não autorizado	Autenticação falhou.
  403 Proibido	Você não tem os direitos para realizar a operação.
  404 Não encontrado	O recurso solicitado não foi encontrado.
  500 Erro de servidor interno	Erro do serviço interno.
  503 Serviço indisponível	Serviço não está disponível.