Qué hace realmente eliminar, por recurso

“Eliminar” significa cosas distintas según qué se elimine a través de la RealityConnect API. Algunos recursos van a una papelera recuperable; la mayoría se eliminan de forma definitiva. Esta página es la referencia recurso por recurso para diseñar lógica de limpieza o de reconciliación de sincronización.

---

Comportamiento de eliminación por recurso

Recurso	Eliminación	Restauración	Purga
Nodo de datos (división, sitio, carpeta, twin, proyecto, Data Bundle, Asset Library, etc.)	Suave (pasa a la papelera)	PATCH /v1/nodes/{nodeId}/restore	Automática 30 días después de eliminarse, o inmediata mediante DELETE /v1/nodes/{nodeId}/hard
POI	Definitiva	No disponible	Inmediata
Zona	Definitiva	No disponible	Inmediata
Box asset	Definitiva	No disponible	Inmediata
Model asset (RealityPlan)	Definitiva	No disponible	Inmediata
Modelo de Asset Library	Definitiva (bloqueada mientras algún asset lo siga referenciando)	No disponible	Inmediata una vez desbloqueada
Etiqueta de Asset Library	Definitiva	No disponible	Inmediata
Grupo	Definitiva	No disponible	Inmediata
Membresía de grupo	Definitiva	No disponible	Inmediata
Invitación (organización o nodo)	Definitiva (revocación)	No disponible	Inmediata
Adjunto de objeto	Definitiva (elimina solo el archivo almacenado)	No disponible	Inmediata

Solo los nodos de datos tienen papelera. Cualquier otro recurso de esta tabla desaparece en cuanto la llamada de eliminación tiene éxito, sin ninguna vía de recuperación del lado del servidor.

Nodos de datos: eliminación suave y papelera

DELETE /v1/nodes/{nodeId} elimina un nodo de forma suave: pasa a la papelera de la organización en lugar de eliminarse. Un nodo en la papelera:

• Se lista con GET /v1/trash (paginado, ordenable por deletedAt o name).
• Puede restaurarse con PATCH /v1/nodes/{nodeId}/restore, que puede fallar con 409 StorageLimitExceeded si la restauración haría que la organización superara su cuota de almacenamiento.
• Se elimina de forma definitiva con DELETE /v1/nodes/{nodeId}/hard, o automáticamente 30 días después de haber pasado a la papelera.

Tanto la restauración como la eliminación definitiva devuelven 409 NoNodeRemoved si el nodo no está actualmente en la papelera, incluido un id de nodo que nunca se eliminó, o uno que ya se eliminó definitivamente o se purgó automáticamente.

Eliminar definitivamente un nodo también elimina sus descendientes en la papelera y cualquier fila de derivados que afecte a nodos de ese subárbol. Los nodos fuera del subárbol que resulten derivar de algo dentro de él no se ven afectados.

Qué bloquea la eliminación de un nodo

DELETE /v1/nodes/{nodeId} puede rechazarse con 409 Conflict por tres motivos:

Código	Significado	¿Se puede omitir con ?force=true?
NodeHasDerivatives	El nodo tiene salidas derivadas (por ejemplo, resultados procesados) que deben eliminarse primero. La respuesta lista en derivatives[] exactamente qué nodos lo bloquean.	No
NodeHasBundleDependants	El Data Bundle del nodo tiene dependientes.	No
NodeNotInDeletableState	El nodo se está procesando actualmente, o su procesamiento falló (isProcessing / isFailed).	Sí

force=true (una cadena de consulta, exactamente "true" o "false") solo omite NodeNotInDeletableState. Un nodo con derivados o dependientes de bundle debe resolverse primero; no hay forma de omitirlo. Consulta Códigos de error para ver la forma completa de la respuesta y el manejo sugerido.

Los modelos de Asset Library tienen su propia versión, más simple, de este mismo bloqueo: DELETE /v1/asset-library/{ownerContextId}/models/{libraryModelId} devuelve 409 Conflict mientras algún asset siga referenciando el modelo. Una vez que desaparece la última referencia, la eliminación es definitiva y no recuperable, a diferencia de la eliminación suave de un nodo.

Nodos eliminados de forma suave en el explorador y la búsqueda

Un nodo eliminado de forma suave desaparece de GET /v1/nodes/{id}/browse y de GET /v1/nodes/search de forma inmediata e incondicional: ninguno de los dos endpoints tiene un parámetro para incluir nodos en la papelera. La única forma de ver un nodo en la papelera es GET /v1/trash; restaurarlo es lo que vuelve a hacerlo explorable y buscable.

Para saber cómo funcionan la jerarquía de nodos y la búsqueda en sí, consulta Tipos de nodo y jerarquía y Búsqueda de objetos de negocio y nodos.

¿Qué sigue?

• Códigos de error para el conjunto completo de códigos de error con nombre, incluidos todos los referenciados en esta página.
• Qué acepta contextId para resolver el contextId usado para direccionar POI, zonas, assets y adjuntos.