Details einer serverunabhängigen Instanz abrufen

Sie können Informationen wie die Instanz-ID (oder GUID) und den Bereitstellungsstatus einer IBM Analytics Engine serverunabhängigen Instanz aus den Instanzdetails abrufen. Sie benötigen die Instanz-ID, um die REST-API der Spark-Anwendung und die Livy-Batch-APIs verwenden zu können.

Sie können die Details wie folgt abrufen:

Über die IBM Cloud-CLI
Über die IBM Cloud-REST-API

Über die IBM Cloud -CLI auf Instanzdetails zugreifen

So rufen Sie die Details einer Instanz ab:

Alle erstellten serverunabhängigen Instanzen auflisten:

$ ibmcloud resource service-instances --service-name ibmanalyticsengine

Dieser Aufruf ruft die Instanzen des Typs service_instancein allen Ressourcengruppen an allen Standorten für Ihr Konto ab.

Beispielantwort:

Name                  Location   State    Type               Resource Group ID
serverless-instance   us-south   active   service_instance   65xxxxxxxxxxxxxxxa3fd

Geben Sie den folgenden Befehl mit dem Serverinstanznamen Ihrer Instanz ein, um die Instanzdetails anzuzeigen:

$ ibmcloud resource service-instance "Analytics Engine-xyz"

Dieser Befehl ruft Ihre Instanz aus den Ressourcengruppen unter Ihrem Konto ab.

Beispielantwort:

Name:                  Analytics Engine-xyz
ID:
crn:v1:staging:public:ibmanalyticsengine:us-south:a/XXXXX:XXXXX::
GUID:                  XXXXX
Location:              us-south
Service Name:          ibmanalyticsengine
Service Plan Name:     standard-serverless-spark
Resource Group Name:   Default
State:                 active
Type:                  service_instance
Sub Type:
Created at:            2021-01-06T07:49:12Z
Created by:            XXXXX
Updated at:            2021-01-06T07:51:01Z
Last Operation:
                       status    create succeeded
                       Message   Started create instance operation

Die Antwort enthält die GUID und den Bereitstellungsstatus Ihrer Instanz.

Beachten Sie, dass der zurückgegebene Status create succeededangibt, dass die Bereitstellungsanforderung erfolgreich akzeptiert wurde. Zum Ausführen von Anwendungen muss die Instanz jedoch in den Status activewechseln. Verfolgen Sie den Status der Instanzbereitschaft, bevor Sie eine Operation für die Instanz durchführen. Siehe Verfolgen der Instanzbereitschaft.

Mit der REST-API IBM Cloud auf Instanzdetails zugreifen

Sie benötigen die ID einer IBM Analytics Engine serverunabhängigen Instanz, um die Details der Instanz abzurufen. Dazu gehören beispielsweise die GUID und der Bereitstellungsstatus der Instanz.

So rufen Sie die Details einer Instanz ab:

Listen Sie alle erstellten serverunabhängigen Instanzen in der Ressourcengruppe Ihres Kontos auf:

GET <resource-controller-url>/v2/resource_instances

Beispiel für eine Anforderung:

curl -X GET https://resource-controller.cloud.ibm.com/v2/resource_instances? resource_plan_id=8afxxxx-xxxx-xxxx-xxxx-946d843xxxx -H "Authorization: Bearer <>" \

Beispielantwort:

{
	"rows_count": 1,
	"next_url": null,
	"resources": [{
		"id": "crn:v1:staging:public:ibmanalyticsengine:us-south:a/d628eae2ccxxxx3bb0c9dxxxx:da82xxxx-xxxx-xxxx-xxxx-d0faf90exxxx::",
		"guid": "da82xxxx-xxxx-xxxx-xxxx-d0faf90exxxx",
		"url": "/v2/resource_instances/da82xxxx-xxxx-xxxx-xxxx-d0faf90exxxx",
		"created_at": "2021-08-05T11:05:51.545526066Z",
		"updated_at": "2021-11-04T05:11:30.966202521Z",
		"deleted_at": null,
		"created_by": "IBMid-661002042N",
		"updated_by": "",
		"deleted_by": "",
		"scheduled_reclaim_at": null,
		"restored_at": null,
		"scheduled_reclaim_by": "",
		"restored_by": "",
		"name": "serverless-instance",
		"region_id": "us-south",
		"account_id": "d628eae2ccxxxx3bb0c9dxxxx",
		"reseller_channel_id": "",
		"resource_plan_id": "8afxxxx-xxxx-xxxx-xxxx-946d843xxxx",
		"resource_group_id": "65828fxxxx594594816exxx",
		"resource_group_crn": "crn:v1:staging:public:resource-controller::a/d628eae2ccxxxx3bb0c9dxxxx::resource-group:65828fxxxx594594816exxx",
		"target_crn": "crn:v1:staging:public:globalcatalog::::deployment:8afxxxx-xxxx-xxxx-xxxx-946d843xxxx%3Aus-south",
		"parameters": {
			"default_config": {
				"spark.driver.cores": "1",
				"spark.driver.memory": "512m",
				"spark.executor.cores": "1",
				"spark.executor.instances": "1"
			},
			"default_runtime": {
				"additional_packages": ["parquet-modular-encryption"],
				"spark_version": "3.0.0"
			},
			"instance_home": {
				"endpoint": "s3.direct.us-south.cloud-object-storage.appdomain.cloud",
				"guid": "902xxxx-xxxx-xxxx-xxxx-4127da8xxxx",
				"hmac_access_key": "xxxxxxxxx",
				"hmac_secret_key": "xxxxxxxx",
				"provider": "ibm-cos",
				"region": "us-south",
				"type": "objectstore"
			},
			"service-endpoints": "public"
		},
		"allow_cleanup": false,
		"crn": "crn:v1:staging:public:ibmanalyticsengine:us-south:a/d628eae2ccxxxx3bb0c9dxxxx:da82xxxx-xxxx-xxxx-xxxx-d0faf90exxxx::",
		"state": "active",
		"type": "service_instance",
		"resource_id": "18dexxxx-xxxx-xxxx-xxxx-0ed2f9xxxx",
		"dashboard_url": null,
		"last_operation": {
			"type": "delete",
			"state": "failed",
			"async": false,
			"description": "[500, Internal Server Error] The request could not be processed. Try again later."
		},
		"resource_aliases_url": "/v2/resource_instances/da82xxxx-xxxx-xxxx-xxxx-d0faf90exxxx/resource_aliases",
		"resource_bindings_url": "/v2/resource_instances/da82xxxx-xxxx-xxxx-xxxx-d0faf90exxxx/resource_bindings",
		"resource_keys_url": "/v2/resource_instances/da82xxxx-xxxx-xxxx-xxxx-d0faf90exxxx/resource_keys",
		"plan_history": [{
			"resource_plan_id": "8afxxxx-xxxx-xxxx-xxxx-946d843xxxx",
			"start_date": "2021-08-05T11:05:51.545526066Z",
			"requestor_id": "IBMid-661002042N"
		}],
		"migrated": false,
		"controlled_by": "",
		"locked": false
	}]}

Informationen zum Abrufen des Zugriffstokens des Berechtigungsträgers finden Sie unter IAM-Zugriffstoken abrufen .

Suchen Sie nach Ihrem Instanznamen im Array "resources"in der Antwort, indem Sie den Parameter "name"überprüfen. Die Antwort enthält die GUID und den Bereitstellungsstatus Ihrer Instanz. Weitere Informationen zur Antwort der API finden Sie unter Liste aller Ressourceninstanzen abrufen.

Beachten Sie, dass der zurückgegebene Status create succeededangibt, dass die Bereitstellungsanforderung erfolgreich akzeptiert wurde. Zum Ausführen von Anwendungen muss die Instanz jedoch in den Status activewechseln. Verfolgen Sie die Instanzbereitschaft, bevor Sie Operationen für die Instanz durchführen. Siehe Verfolgen der Instanzbereitschaft.