iModel creation

To start working with iModelHub, an iModel for an iTwin has to be created. End users should usually create the iModel for an iTwin through iModel manager. It's also possible to use BackendIModelsAccess.createNewIModel to create a new iModel in iModelHub.

iModel initialization

Once an iModel is uploaded to iModelHub, it starts an initialization process, that prepares that iModel for use. Until the initialization successfully finishes, no requests can be made for that iModel.

iModel initialization is usually fast, especially for empty files. However, it is possible that iModel creation requests time out. If file is not initialized by the time create request times out, it could still get initialized in the future. IModelState specifies whether the file initialization is still in progress IModelState.NotInitialized, or the initialization has completed IModelState.Initialized.