Richiamo dei dettagli di un'istanza serverless

È possibile richiamare informazioni, come l'istanza ID (o GUID) e lo stato di provisioning di un IBM Analytics Engine istanza serverless dai dettagli dell'istanza. È necessario l'ID istanza per utilizzare le API REST delle applicazioni Spark e le API batch Livy.

È possibile richiamare i dettagli tramite:

Utilizzo del IBM Cloud CLI
Utilizzo del IBM Cloud API REST

Accesso ai dettagli dell'istanza utilizzando il IBM Cloud CLI

Per ottenere i dettagli di una istanza:

Elencare tutte le istanze serverless create:

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

Questa chiamata richiama le istanze di tipo service_instance in tutti i gruppi di risorse in tutte le località per il tuo account.

Risposta di esempio:

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

Inserire il seguente comando con il nome istanza server della propria istanza per visualizzare i dettagli dell'istanza:

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

Questo richiama la tua istanza dai gruppi di risorse sotto il tuo account.

Risposta di esempio:

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

La risposta include il GUID e lo stato di provisioning della tua istanza.

Da notare che lo stato restituito create succeeded indica che la richiesta di fornitura è stata accettata correttamente. Tuttavia, per eseguire le applicazioni, l'istanza deve passare allo stato active. Tracciare lo stato della prontezza dell'istanza prima di eseguire qualsiasi operazione sull'istanza. Consultare Tracking istanza readiness.

Accesso ai dettagli dell'istanza utilizzando il IBM Cloud REST API

È necessario l'ID di un IBM Analytics Engine serverless istanza per ottenere i dettagli dell'istanza, che includono il GUID e lo stato di provisioning dell'istanza ad esempio.

Per ottenere i dettagli di una istanza:

Elencare tutte le istanze serverless create nel gruppo di risorse il tuo account:

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

Esempio di richiesta:

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

Risposta di esempio:

{
	"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
	}]}

Consultare Richiamare token di accesso IAM per come ottenere il token di accesso al portatore di autorizzazione.

Cerca il tuo nome di istanza nell'array "resources" nella risposta controllando il parametro "name". La risposta include il GUID e lo stato di provisioning della tua istanza. Per ulteriori dettagli sulla risposta dell'API, consultare Ottieni un elenco di tutte le istanze di risorsa.

Da notare che lo stato restituito create succeeded indica che la richiesta di fornitura è stata accettata correttamente. Tuttavia, per eseguire le applicazioni, l'istanza deve passare allo stato active. Tracciare la prontezza dell'istanza prima di eseguire eventuali operazioni sull'istanza. Consultare Tracking istanza readiness.