Todos los productos
Search
Centro de documentos

Alibaba Cloud Model Studio:BatchUpdateFileTag

Última actualización: Oct 12, 2026

Esta operación actualiza las etiquetas de documentos en una conexión de datos por lotes.

Probar ahora

Pruebe esta API en OpenAPI Explorer; no es necesaria la firma manual. Las llamadas exitosas generan automáticamente código SDK que coincide con sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Prueba

Autorización de RAM

No hay autorización para esta operación. Si encuentra problemas con esta operación, póngase en contacto con el soporte técnico.

Sintaxis de la solicitud

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

Parámetros de ruta

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

WorkspaceId

string

Sí

El ID del espacio de trabajo. Para obtener este ID, vaya al inicio de la consola de Model Studio y haga clic en el icono de detalles del espacio de trabajo en la esquina superior izquierda.

llm-3shx2gu255oqxxxx

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

FileInfos

array<object>

Sí

Una lista de archivos para actualizar.

object

Sí

FileId

string

Sí

El ID del archivo. Para obtener este ID, vaya a la página de datos de la aplicación y haga clic en el icono ID junto al nombre del archivo.

file_3d5319366e2c46309f4c11cfbeacd5fd_10045951

tags

array

Sí

  • Una lista de hasta 100 etiquetas para asociar con el archivo. La longitud total de todas las etiquetas no puede exceder los 700 caracteres.

string

No

La etiqueta. Puede tener hasta 32 caracteres de longitud y no debe contener espacios. Los caracteres admitidos incluyen letras Unicode (como letras en inglés, caracteres chinos y números), guiones bajos (_) y guiones (-).

TagA

UpdateMode

string

No

El modo de actualización. Los valores válidos son APPEND y OVERWRITE.

OVERWRITE

Elementos de respuesta

Elemento

Tipo

Descripción

Ejemplo

object

El esquema de respuesta.

Code

string

El código de respuesta. Un valor de Success indica que la llamada fue exitosa.

Éxito

Data

object

Los datos devueltos por la operación.

UpdateFileTagResultList

array<object>

Una lista de los resultados de actualización de etiquetas.

object

FileId

string

El ID del archivo.

file_f40f2a32205d44b4a93b11617113da15_10045951

Success

boolean

Indica si las etiquetas del archivo específico fueron actualizadas. Valores válidos:

  • true: Las etiquetas se actualizaron correctamente.

  • false: La actualización de la etiqueta falló.

true

ErrorCode

string

El código de error. Este parámetro se devuelve solo si Success es false.

NoPermission

ErrorMessage

string

El mensaje de error. Este parámetro se devuelve solo si Success es false.

FileId no existe.

Message

string

El mensaje de respuesta.

Falta el parámetro requerido (FileId) o no es válido; verifique los parámetros de la solicitud.

RequestId

string

El ID de la solicitud.

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

Status

string

El código de estado devuelto para la solicitud.

200

Success

boolean

Indica si la solicitud fue aceptada. Consulte UpdateFileTagResultList para ver el estado de cada archivo. Valores válidos:

  • true: La solicitud fue aceptada.

  • false: La solicitud falló, por ejemplo, debido a un parámetro no válido.

true

Ejemplos

Respuesta exitosa

Formato JSON

{
  "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 error

Consulte Códigos de error para obtener una lista completa.

Notas de lanzamiento

Consulte Notas de lanzamiento para obtener una lista completa.