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 ou exclusão de tags de uma imagem em lotes

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

Ver PDF

Adição ou exclusão de tags de uma imagem em lotes

Função

Essa API é usada para adicionar tags, atualizar tags ou excluir tags de uma imagem em lotes.

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.
As chaves de várias tags no corpo da solicitação devem ser exclusivas.
Esta 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.

Se a tag especificada não existir, a exclusão é considerada bem-sucedida por padrão.

Restrições em chaves e valores de tags durante a exclusão em lote
Durante a exclusão, o sistema não verificará o intervalo do conjunto de caracteres da chave e do valor. A chave não pode ser deixada em branco ou uma cadeia de caracteres vazia. O valor é opcional e não será verificado. Se a tag a ser excluída não existir, a exclusão será considerada bem-sucedida e nenhum erro será relatado. Além disso, o sistema não verificará o comprimento da chave e do valor. A chave pode conter um máximo de 127 caracteres e o valor contém um máximo de 255 caracteres.

URI

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

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
Tags	Sim	Matriz de objetos	Lista as tags a serem adicionadas ou excluídas. Para mais detalhes, consulte Tabela 2.
Ação	Sim	Cadeia	Especifica a operação de tag a ser executada. O valor diferencia maiúsculas de minúsculas e pode ser create ou delete. create indica que as tags serão adicionadas ou atualizadas, enquanto delete indica que as tags serão excluídas.

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

Exemplo de solicitação

Adição de tags de imagem em lotes

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

        
             {
   "tags": [{
      "value": "value1",
      "key": "key1"
   },
   {
      "value": "value2",
      "key": "key2"
   },
   {
      "value": "",
      "key": "key3"
   }],
   "action": "create"
}

Exclusão de tags de imagem em lotes

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

        
             {
   "tags": [{
      "value": "value1",
      "key": "key1"
   },
   {
      "value": "value2",
      "key": "key2"
   },
   {
      "value": "",
      "key": "key3"
   }],
      "action": "delete"
}

Resposta

Parâmetros de resposta
Nenhum
Exemplo de resposta
```
STATUS CODE 204
```

Valores retornados

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.