kvstore, `InsertKVStoreKey()` does not support `if-generation-match`

[t-geindre]

As stated here, a if-generation-match parameter allows to make sure the insert is replacing the right version.

This parameter is missing from the client function args.

And I'm not sure if there is a way to get the generation ID while reading a key value either.

[kpfleming]

Thanks for the report! Generally speaking go-fastly is primarily used by the Fastly CLI and the Fastly Terraform provider, so we're most likely to see gaps like this when working on those tools... which also means that if those tools don't try to use every API feature available, some of those features won't be added to go-fastly.

Normally I'd consider this a feature request but since it interferes with safely using the API endpoints, I've marked it as a bug.

[kpfleming]

We'll also be working on improving the API docs for the KV Store, since as you pointed out they are lacking in some areas.

[t-geindre]

Thank for your answer.
I understand the purpose of this package but we are using it to populate our kv-stores using Go et it would be very appreciated if it could implement all the available API features.

[kpfleming]

I have some good news, at least partially :-)

Your issue here prompted us to completely rework the KV Store API documentation, including documenting all available parameters and the expected responses from each operation. The results are available here.

With this documentation complete, we can now schedule some work on go-fastly to ensure that it fully supports the documented API.

[kpfleming]

A new release will be made shortly which will include full support for the KV Store API. Enjoy!