Todos os produtos
Search
Central de documentação

Alibaba Cloud Model Studio:BatchUpdateFileTag

Última atualização: Sep 09, 2026

Atualiza as tags de documentos em uma conexão de dados em lotes.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Sintaxe da solicitação

PUT /{WorkspaceId}/datacenter/batchupdatetag HTTP/1.1

Parâmetros de caminho

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

WorkspaceId

string

Sim

O ID do workspace. Para obter esse ID, acesse a página inicial do console do Model Studio e clique no ícone de detalhes do workspace no canto superior esquerdo.

llm-3shx2gu255oqxxxx

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

FileInfos

array<object>

Sim

A lista de arquivos a serem atualizados.

object

Sim

FileId

string

Sim

O ID do arquivo. Para obter esse ID, acesse a página de dados do aplicativo e clique no ícone de ID ao lado do nome do arquivo.

file_3d5319366e2c46309f4c11cfbeacd5fd_10045951

tags

array

Sim

  • Uma lista de até 100 tags para associar ao arquivo. O comprimento total de todas as tags não pode exceder 700 caracteres.

string

Não

A tag. Pode ter até 32 caracteres e não deve conter espaços. Os caracteres suportados incluem letras Unicode (como letras em inglês, caracteres chineses e números), sublinhados (_) e hifens (-).

TagA

UpdateMode

string

Não

O modo de atualização. Valores válidos: APPEND e OVERWRITE.

OVERWRITE

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

O esquema da resposta.

Code

string

O código da resposta. O valor Success indica que a chamada foi bem-sucedida.

Success

Data

object

Os dados retornados pela operação.

UpdateFileTagResultList

array<object>

A lista de resultados da atualização de tags.

object

FileId

string

The file ID.

file_f40f2a32205d44b4a93b11617113da15_10045951

Success

boolean

Indicates whether the tags for the specific file were updated. Valid values:

  • true: The tags were updated successfully.

  • false: The tag update failed.

true

ErrorCode

string

The error code. This parameter is returned only if Success is false.

NoPermission

ErrorMessage

string

The error message. This parameter is returned only if Success is false.

FileId not exists.

Message

string

A mensagem de resposta.

Required parameter(FileId) missing or invalid, please check the request parameters.

RequestId

string

O ID da solicitação.

17204B98-xxxx-4F9A-8464-2446A84821CA

Status

string

O código de status retornado para a solicitação.

200

Success

boolean

Indica se a solicitação foi aceita. Verifique UpdateFileTagResultList para obter o status de cada arquivo. Valores válidos:

  • true: A solicitação foi aceita.

  • false: A solicitação falhou, por exemplo, devido a um parâmetro inválido.

true

Exemplos

Resposta de sucesso

JSON formato

{
  "Code": "Success",
  "Data": {
    "UpdateFileTagResultList": [
      {
        "FileId": "file_f40f2a32205d44b4a93b11617113da15_10045951",
        "Success": true,
        "ErrorCode": "NoPermission",
        "ErrorMessage": "FileId not exists."
      }
    ]
  },
  "Message": "Required parameter(FileId) missing or invalid, please check the request parameters.",
  "RequestId": "17204B98-xxxx-4F9A-8464-2446A84821CA",
  "Status": "200",
  "Success": true
}

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.