Definición
Return Values
Un mapa de IDs (es decir, _id valores de campo) para documentos que fueron upsertados por todas las operaciones de actualización y reemplazo en el guardado masivo.
El índice de cada ID en el mapa corresponde a la posición de cada documento en la operación masiva. Si un documento tenía un ID antes de hacer un upsert (es decir, el servidor no generó un ID), el índice contendrá el valor de su campo _id. Cualquier ID generado por el servidor será una instancia de MongoDB\BSON\ObjectId.
Errores/Excepciones
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.