Adiciona tags personalizadas a um arquivo.
Descrição da operação
Esta operação realiza uma atualização incremental:\n\n- Se uma tag com a mesma chave já existir, seu valor será substituído.\n\n- Se uma tag não existir, ela será adicionada.\n\n- As tags existentes com chaves diferentes não são afetadas.
Experimente agora
Testar
Autorização RAM
Sintaxe da solicitação
POST /v2/file/put_usertags HTTP/1.1
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
Exemplo |
| domain_id |
string |
Sim |
||
| body |
object |
Não |
O corpo da solicitação. |
|
| drive_id |
string |
Sim |
O ID do drive. |
1 |
| file_id |
string |
Sim |
O ID do arquivo. |
9520943DC264 |
| user_tags |
array<object> |
Sim |
O array de tags a serem adicionadas. O array deve conter de 1 a 1.000 tags e não deve conter chaves de tag duplicadas. |
|
|
object |
Sim |
O comprimento combinado da chave da tag e do valor da tag não pode exceder 2.000 bytes. |
||
| key |
string |
Sim |
A chave da tag. Não deve estar vazia nem conter o caractere #. |
tag |
| value |
string |
Não |
O valor da tag. Não deve conter o caractere #. |
value |
Elementos de resposta
|
Elemento |
Tipo |
Descrição |
Exemplo |
|
object |
O esquema da resposta. |
||
| file_id |
string |
O ID do arquivo. |
9520943DC264 |
Exemplos
Resposta de sucesso
JSON formato
{
"file_id": "9520943DC264"
}
Códigos de erro
Consulte Códigos de Erro para uma lista completa.
Notas de versão
Consulte Notas de Versão para uma lista completa.