Instanz-ID abrufen

Sie können eine einzelne IBM Cloud® Hyper Protect Crypto Services-Instanz für Operationen, einschließlich der eindeutigen ID oder der Instanz-ID, in API-Anforderungen an den Service richten.

Instanz-ID über die Benutzerschnittstelle anzeigen

Sie können die Instanz-ID anzeigen, die Ihrer Hyper Protect Crypto Services-Serviceinstanz zugeordnet ist, indem Sie zu Ihrer IBM Cloud-Ressourcenliste navigieren.

Melden Sie sich bei der Benutzerschnittstelle an.
Rufen Sie Menü > Ressourcenliste auf und klicken Sie dann auf Services, um eine Liste Ihrer Cloud-Services zu durchsuchen.
Klicken Sie in die Tabellenzeile, die Ihre Hyper Protect Crypto Services-Serviceinstanz beschreibt.
Rufen Sie Übersicht > Instanz auf und kopieren Sie den Wert Instanz-ID.

Diese Instanz-ID identifiziert Ihre Hyper Protect Crypto Services-Serviceinstanz eindeutig.

Instanz-ID über die Befehlszeilenschnittstelle (CLI) abrufen

Sie können die Instanz-ID Ihrer Serviceinstanz auch über die IBM Cloud-CLI abrufen.

Melden Sie sich bei IBM Cloud über die IBM Cloud CLI an.
```
ibmcloud login
```
Wenn die Anmeldung fehlschlägt, führen Sie den Befehl ibmcloud login --sso aus, um es erneut zu versuchen. Der Parameter --sso ist erforderlich, wenn Sie sich mit einer föderierten ID anmelden. Wenn diese Option verwendet wird, rufen Sie den Link auf, der in der Ausgabe der Befehlszeilenschnittstelle aufgelistet ist, um einen einmalig verwendbaren Kenncode zu generieren.
Wählen Sie die Region und die Ressourcengruppe aus, in der Ihre Serviceinstanz von Hyper Protect Crypto Services enthalten ist. Sie können den folgenden Befehl verwenden, um die gewünschte Region und Ressourcengruppe festzulegen.
```
ibmcloud target -r <region_name> -g <resource_group_name>
```
Rufen Sie den Cloudressourcennamen (CRN) ab, der Ihre Hyper Protect Crypto Services-Serviceinstanz eindeutig identifiziert.
```
ibmcloud resource service-instance <instance_name> --id
```
Ersetzen Sie <instance_name> durch den eindeutigen Aliasnamen, den Sie Ihrer Hyper Protect Crypto Services-Serviceinstanz zugewiesen haben. Das folgende verkürzte Beispiel zeigt die Ausgabe der Befehlszeilenschnittstelle.
```
crn:v1:public:hs-crypto:us-south:a/f047b55a3362ac06afad8a3f2f5586ea:42454b3b-5b06-407b-a4b3-34d9ef323901:: 42454b3b-5b06-407b-a4b3-34d9ef323901
```
Der Wert 42454b3b-5b06-407b-a4b3-34d9ef323901 ist eine Beispielinstanz-ID.

Instanz-ID mit der API abrufen

Sie können die Instanz-ID auch programmgestützt zur Erstellung und Verbindung Ihrer Anwendung abrufen. Sie können die IBM Cloud Resource Controller-APIaufrufen und dann die JSON-Ausgabe über eine Pipe an jq leiten, um diesen Wert zu extrahieren.

Rufen Sie ein IBM Cloud-IAM-Zugriffstoken ab.
Rufen Sie die Ressourcencontroller-API auf, um Ihre Instanz-ID abzurufen.
```
curl -X GET \
https://resource-controller.cloud.ibm.com/v2/resource_instances \
-H 'Authorization: Bearer <access_token>' | jq -r '.resources[] | select(.name | contains("<instance_name>")) | .guid'
```
Ersetzen Sie <instance_name> durch den eindeutigen Aliasnamen, den Sie Ihrer Hyper Protect Crypto Services-Serviceinstanz zugewiesen haben. Die folgende Ausgabe zeigt eine Beispielinstanz-ID:
```
42454b3b-5b06-407b-a4b3-34d9ef323901
```