[Saved objects] Add support for version on create & bulkCreate when overwriting a document

[gmmorris]

Summary

Adds support for version one the SavedObjectsClient's create api.
This sallows us to retain Optimistic concurrency control when using create to overwrite an existing document.

For example:

savedObjectsClient.create(
      'known-type',
      {
        attrOne: 'one',
        attrTwo: 'two',
      },
      { id: 'uuid-to-overwrite', overwrite: true, version: '=snjr5dorY' }
    );

Checklist

Delete any items that are not applicable to this PR.

• Documentation was added for features that require explanation or tutorials
• Unit or functional tests were updated or added to match the most common scenarios

For maintainers

• This was checked for breaking API changes and was labeled appropriately

[gmmorris]

@elasticmachine merge upstream

[jportner]

WRT d4820e1 and CI failures:

It looks like all the CI failures can boiled down to three types of tests:

• Import
• Copy to space
• Loading sample data

I'm not 100% sure about loading sample data, but copy to space does use import under the hood.

You could try filtering out the version inside importSavedObjectsFromStream and see if that fixes the issue:

kibana/src/core/server/saved_objects/import/import_saved_objects.ts

Lines 69 to 73 in 36f0c75

	// Create objects in bulk
	const bulkCreateResult = await savedObjectsClient.bulkCreate(filteredObjects, {
	overwrite,
	namespace,
	});

[elasticmachine]

Pinging @elastic/kibana-platform (Team:Platform)

[elasticmachine]

Pinging @elastic/ingest-management (Team:Ingest Management)

[pgayvallet]

LGTM for platform changes.

Added @jportner as a reviewer as this may directly impact the changes on the SO sharing feature.

[kibanamachine]

💚 Build Succeeded

• continuous-integration/kibana-ci/pull-request
• Commit: 4297f2a

Build metrics

✅ unchanged

History

• 💚 Build #68833 succeeded a0fc384
• 💔 Build #68824 failed 4dfcf10
• 💚 Build #68693 succeeded caa1834
• 💔 Build #68536 failed 814b98d
• 💔 Build #68481 failed d4820e1

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

[jportner]

LGTM!