Clarify in more detail how the HPCS instance ID drop down works

Timo-1 commented 2 years ago

https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-tutorial-kmip-vmware#tutorial-vmware-configure

4.) Select the Initialize service instance option and Hyper Protect as the key management type.

Select the Hyper Protect Crypto Services instance ID that stores your root key and key encryption key. You can click the Retrieve button to get a list of Hyper Protect Crypto Services instances under your IBM Cloud account. Add a note like: "(Only IDs of Hyper Protect Crypto Services instances that contain at least one root key will be displayed in this list.)"

Reason: If a HPCS instance exists, but a root key is not yet created in this instance, the instance id will not be listed in the drop down, which may be counter-intuitive.

TiffanyLiIBM commented 2 years ago

@Timo-1 Thanks much for your feedback! Please see the updated doc at: https://cloud.ibm.com/docs/hs-crypto?topic=hs-crypto-tutorial-kmip-vmware#tutorial-vmware-configure.

We've already included creating root keys as a prerequisite in the tutorial. And I agree with you. A note in this specific step will make it more clear what service instances are to be retrieved.

Timo-1 commented 2 years ago

@TiffanyLiIBM Thank you - the updated doc looks good !

TiffanyLiIBM commented 2 years ago

Pushed to Prod. Closing...

ibm-cloud-docs / hs-crypto

Clarify in more detail how the HPCS instance ID drop down works #28