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/ Image Management Service/ Referência de API/ As API do IMS/ Marcação de imagem/ Adição de uma tag a uma imagem

Atualizado em 2022-11-16 GMT+08:00

Ver PDF

Adição de uma tag a uma imagem

Função

Essa API é usada para adicionar uma tag a uma imagem ou atualizar uma tag.

Restrições

Cada tag consiste em uma chave e um valor. A chave contém no máximo 36 caracteres e o valor contém no máximo 43 caracteres. A chave não pode ser deixada em branco ou uma cadeia de caracteres vazia. O valor não pode ser deixado em branco, mas pode ser uma cadeia de caracteres vazia.
Uma imagem pode ter no máximo de 10 tags.
Esta API é uma API idempotente. Se uma tag a ser adicionada tiver a mesma chave que uma tag existente, mas os valores da tag forem diferentes, essa tag será adicionada e substituirá a existente. Se uma tag a ser adicionada tiver a mesma chave e valor de uma tag existente, essa tag não será adicionada.

URI

POST /v2/{project_id}/images/{image_id}/tags

Tabela 1 lista os parâmetros no URI.

**Tabela 1** Descrição do parâmetro
Parâmetro	Obrigatório	Tipo	Descrição
project_id	Sim	Cadeia	Especifica o ID do projeto.
id_imagem	Sim	Cadeia	Especifica o ID da imagem.

Solicitação

Parâmetros de solicitação

Parâmetro	Obrigatório	Tipo	Descrição
Tag	Sim	Objeto	Especifica a tag a ser adicionada ou atualizada. Para mais detalhes, consulte Tabela 2.

**Tabela 2** Descrição da estrutura de dados do campo tag
Parâmetro	Obrigatório	Tipo	Descrição
chave	Sim	Cadeia	Especifica a chave de marcação. A chave de etiqueta não pode ser deixada em branco.
Valor	Sim	Cadeia	Especifica o valor da tag.

Exemplo de solicitação

POST https://{Endpoint}/v2/fd73a4a14a4a4dfb9771a8475e5198ea/images/67e17426-359e-49fb-aa12-0bd1756ec240/tags

      
           {
   "tag": {
      "value": "value1",
      "key": "key1"
   }
}

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.