[CDRIVER-4568] Limit options available for createEncryptedCollection

[vector-of-bool]

Refer: CDRIVER-4568

This changeset changes the parameters available in create-encrypted-collection to specifying only the masterKey to be used for datakey creation. The prior version allowed all datakey options to be passed through, but most of them were conflicting or nonsensical in this context. Refer to the linked DRIVERS ticket.

The required changes also re-specified the test cases to test both local as well as aws KMS providers. The test cases in question have been updated to run over both configurations.

[eramongodb]

Minor feedback; otherwise LGTM.

[eramongodb]

A bit unclear what this comment is documenting. Is it documenting that local should be tested before AWS?

[vector-of-bool]

It's become a redundant comment. Gone.

[kevinAlbs]

I suggest adding a way to extend options. When this API becomes stable, it may be helpful to have a way to add supported options. Consider adding a mongoc_client_encryption_cec_opts_t type to support only this option:

:man_page: mongoc_client_encryption_cec_opts_t

mongoc_client_encryption_cec_opts_t
===================================

Synopsis
--------

.. code-block:: c

  typedef struct _mongoc_client_encryption_cec_opts_t mongoc_client_encryption_cec_opts_t;

Used to set options for :symbol:`mongoc_client_encryption_create_encrypted_collection()`.

.. only:: html

  Functions
  ---------

  .. toctree::
    :titlesonly:
    :maxdepth: 1

    mongoc_client_encryption_cec_opts_new
    mongoc_client_encryption_cec_opts_destroy
    mongoc_client_encryption_cec_opts_set_masterkey

.. seealso::

  | :symbol:`mongoc_client_encryption_create_encrypted_collection()`

[vector-of-bool]

I see this pattern throughout the C driver and I question its ergonomics over using _v2/_v3 interfaces that add the additional options, which is used in most C APIs I'm familiar with. Using dynamically allocated options-objects adds significant complexity at call sites.

[kevinAlbs]

Fair point. The option structs may not add much benefit. Adding options to the structs still requires an API addition of the function call. The alternative API addition of a _v2 / _v3 may be preferable.