AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。
Docs Menu

MongoDB\UpdateResult::getUpsertedId()

MongoDB\UpdateResult::getUpsertedId()

ID( アップサートされたドキュメントの_idフィールド値)をスキャンします。

function getUpsertedId(): mixed|null

ID(つまり アップサートされたドキュメントの_idフィールド値)をスキャンします。 アップサートされたドキュメントがない場合は、 nullが返されます。

アップサートを行う前にドキュメントにIDが存在した場合(つまり、サーバーがIDを生成する必要がなかった場合)、その _idフィールド値がこれに含まれます。サーバーが生成したID は、 MongoDB\BSON\ObjectIdインスタンスになります。

このメソッドが呼び出され、書込み操作で未確認の書込み保証が使用された場合はMongoDB\Exception\BadMethodCallException