Todos los productos
Search
Centro de documentos

ID Verification:Elimine imágenes faciales de una biblioteca facial

Última actualización: Sep 18, 2026

FACE_IDU admite el modo de búsqueda facial y ofrece funciones para gestionar bibliotecas faciales. Elimine imágenes faciales específicas mediante un identificador de usuario en la consola de ID Verification o al invocar esta operación.

Detalles de la operación

  • Operación: DeleteFaceRecordV2

  • Método de solicitud: POST

  • Protocolo: HTTPS

  • Límite de QPS: la tasa máxima de solicitudes para un solo inquilino es de 50 QPS.

  • Endpoint:

    Nota
    • Una red interna es una red de comunicación privada que conecta los productos de Alibaba Cloud dentro de la misma región. Si su servidor de aplicaciones se despliega en la misma región, utilice el endpoint interno para acceder al servicio ID Verification. Esto mejora la seguridad y la estabilidad.

    • Los distintos planes del producto ID Verification admiten diferentes regiones, y los datos están aislados entre ellas. Debe usar el endpoint correspondiente a la región de sus datos para acceder a ellos.

    Asia Pacific SE 1 (Singapore)

    • Endpoint público: cloudauth-intl.ap-southeast-1.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-1.aliyuncs.com

    Asia Pacific SE 5 (Jakarta)

    • Endpoint público: cloudauth-intl.ap-southeast-5.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-5.aliyuncs.com

    China (Hong Kong)

    • Endpoint público: cloudauth-intl.cn-hongkong.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.cn-hongkong.aliyuncs.com

    Asia Pacific SE 3 (Kuala Lumpur)

    • Endpoint público: cloudauth-intl.ap-southeast-3.aliyuncs.com

    • Endpoint interno: cloudauth-intl-vpc.ap-southeast-3.aliyuncs.com

Depuración e integración en línea

Nota

Antes de depurar e integrar, lea el documento Use OpenAPI para conocer cómo invocar las API en la plataforma OpenAPI y obtener el SDK.

Ejecute esta API en OpenAPI Explorer para depurarla y generar ejemplos de código del SDK.

Parámetros de solicitud

Nombre

Tipo

Descripción

Obligatorio

MerchantUserId

String

El identificador único del usuario. Este valor debe coincidir con el que se utilizó al agregar el registro facial mediante la llamada a AddFaceRecord. Si no proporcionó ningún valor durante el registro, puede usar el nombre predeterminado de la imagen.

Sí

FaceGroupCode

String

El código de la biblioteca facial de destino. Si no se especifica este parámetro, los datos faciales del usuario se eliminan de todas las bibliotecas faciales.

No

Parámetros de respuesta

Nombre

Tipo

Descripción

Ejemplo

HTTP Status Code

integer

El código de estado HTTP.

200

HTTP Body

RequestId

String

El identificador único de la solicitud, utilizado para solucionar problemas.

130A2C10-B9EE-4D84-88E3-5384FF03****

Code

String

El código devuelto. Para más información, consulte Server-side HTTP status codes.

Success

Message

String

La descripción detallada del código devuelto.

The request is successful.

Result.Deleted

String

El resultado de la eliminación.

  • Y: la imagen facial se eliminó correctamente.

  • N: la eliminación de la imagen facial terminó con errores.

Y

Result.DeletedGroupCodes

String

La lista de códigos de las bibliotecas faciales donde se ejecutó la eliminación, separados por comas. Si no se especifica FaceGroupCode, se devuelven todas las bibliotecas afectadas.

10001