internal/provider: add optional metadata param

[rjeczalik]

This PR adds a new, optional metadata parameter, which controls whether ScyllaDB Cloud client should fetch deployment metadata prior to issuing API calls.

The deployment metadata is used to map various region, instance etc. identifier to human-readable text strings.

By default metadata is always on and true.

It is safe to turn off the metadata retrieval, when it's known to be not needed - e.g. for Stacks API integration.

For regular use of terraform providers user will not need to control this behavior. The main use-case for this new param are automation flows.

[ksinica]

@rjeczalik: Maybe it is also worth mentioning this newly added SCYLLADB_CLOUD_IGNORE_META environment variable in the docs/index.md? I understand that most users will not be interested in this addition, but for the sake of completeness.

[rjeczalik]

SCYLLADB_CLOUD_IGNORE_META

It's removed, thus it's not mentioned.

Completeness depends on the perspective, from the perspective of the user it is already complete.

[ksinica]

You're right, I was thinking about the added metadata field, but somehow written about the environment variable. I'm not insisting on adding the information about it.

[rjeczalik]

I prefer having this behavior declared explicitly in the configuration rather than the environment variable.

👍

Thanks!

[mykaul]

Where's the documentation for this?