Adição ou exclusão de tags de recurso em lotes
Função
Função Essa API é usada para adicionar ou excluir tags em lote para um serviço do ponto de extremidade da VPC ou um ponto de extremidade da VPC especificado. ● Um recurso pode ter no máximo 10 tags.
URI
POST /v1/{project_id}/{resource_type}/{resource_id}/tags/action
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
project_id | Sim | String | ID do projeto. |
resource_type | Sim | String | Especifica o tipo de recurso. O tipo é endpoint_service ou endpoint. |
resource_id | Sim | String | Indica o ID do recurso, o ID do serviço do ponto de extremidade ou o ID do ponto de extremidade. |
Parâmetros de solicitação
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
X-Auth-Token | Sim | String | Especifica o token do usuário. Ele pode ser obtido chamando a API do IAM. O valor de X-Subject-Token no cabeçalho da resposta é o token do usuário. |
Content-Type | Sim | String | Especifica o tipo MIME do corpo da solicitação. O valor padrão application/json é recomendado. Para as APIs usadas para carregar objetos ou imagens, o tipo MIME pode variar dependendo do tipo de fluxo. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
tags | Não | Array of resource_tag objects | Especifica a lista de tags. Se não houver nenhuma tag na lista, as tags serão tomadas como uma matriz vazia. |
action | Sim | String | Especifica a ação, que somente pode ser criada e excluída. |
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
key | Sim | String | Especifica a chave de tag. A chave pode conter um máximo de 36 caracteres Unicode. A chave de tag deve estar em conformidade com as especificações do conjunto de caracteres de tag. |
value | Não | String | Especifica o valor de tag. Este parâmetro é obrigatório quando a ação é definida para criar. Cada valor de tag contém um máximo de 43 caracteres Unicode. Se o valor da tag for especificado, a tag será excluída com base na chave e no valor. Se o valor da tag for deixado em branco, a tag será excluída por chave. O valor da tag deve estar em conformidade com as especificações do conjunto de caracteres da tag. |
Parâmetros de resposta
Código de status: 400
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 401
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 403
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 404
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 405
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 406
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
Código | String | Código de erro de uma exceção de tarefa. |
Código de status: 407
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 408
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 409
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 500
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 501
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 502
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 503
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Código de status: 504
Parâmetro | Tipo | Descrição |
|---|---|---|
error | Error object | Especifica a mensagem de erro retornada quando ocorre uma exceção de envio de tarefa. |
Parâmetro | Tipo | Descrição |
|---|---|---|
message | String | Descrição do erro da tarefa |
code | String | Código de erro de uma exceção de tarefa. |
Exemplos de solicitações
-
POST https://{endpoint}/v1/{project_id}/endpoint_service/{resource_id}/tags/action { "action" : "create", "tags" : [ { "key" : "key1", "value" : "value1" }, { "key" : "key", "value" : "value3" } ] } -
POST https://{endpoint}/v1/{project_id}/endpoint/{resource_id}/tags/action { "action" : "delete", "tags" : [ { "key" : "key1" }, { "key" : "key2", "value" : "value3" } ] }
Exemplo de respostas
Nenhum
Códigos de status
Código de status | Descrição |
|---|---|
204 | O servidor processou a solicitação com sucesso. |
400 | A solicitação não pôde ser entendida pelo servidor devido à sintaxe mal formada. |
401 | A página solicitada requer um nome de usuário e senha. |
403 | O servidor entendeu a solicitação, mas se recusa a atendê-la. |
404 | A página solicitada não foi encontrada. |
405 | O método especificado na linha de solicitação não é permitido para o recurso identificado pelo URI da solicitação. |
406 | O recurso identificado pela solicitação só é capaz de gerar entidades de resposta que tenham características de conteúdo não aceitáveis de acordo com os cabeçalhos de aceitação enviados na solicitação. |
407 | O cliente deve primeiro autenticar-se com o proxy. |
408 | O cliente não produziu uma solicitação dentro do tempo que o servidor estava preparado para esperar. |
409 | A solicitação não pôde ser concluída devido a um conflito com o estado atual do recurso. |
500 | Falhou ao concluir a solicitação. Anormalidade de serviço. |
501 | Falhou ao concluir a solicitação. O servidor não suporta a função solicitada. |
502 | Falhou ao concluir a solicitação. porque o servidor recebe uma resposta inválida. |
503 | Falhou ao concluir a solicitação. porque o sistema não está disponível. |
504 | Gateway expirou o tempo limite |
Códigos de erro
Consulte Códigos de erro.

