Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu

MongoDB\UpdateResult::getUpsertedCount()

MongoDB\UpdateResult::getUpsertedCount()

Devuelve el número de documentos que se han insertado o actualizado.

function getUpsertedCount(): integer

Este método solo debe llamarse si se reconoció el guardado.

El número total de documentos que se insertaron o actualizaron. Esto debe ser 0 o 1 para una actualización reconocida o una operación de reemplazo, dependiendo de si se produjo una inserción.

MongoDB\Exception\BadMethodCallException si este método se llama y la operación de guardar usó un nivel de confirmación de escritura (write concern)no reconocida.