Extraction des détails d'une instance sans serveur

Vous pouvez extraire des informations, comme l'ID d'instance (ou GUID) et l'état d'application des accès d'une instance IBM Analytics Engine sans serveur à partir des détails de l'instance. Vous avez besoin de l'ID instance pour utiliser l'API REST d'application Spark et les API de traitement par lots Livy.

Vous pouvez extraire les détails comme suit :

Utilisation de l'interface de ligne de commande IBM Cloud
Utilisation de l'API REST IBM Cloud

Accès aux détails d'instance à l'aide de la CLI IBM Cloud

Pour obtenir les détails d'une instance, procédez comme suit :

Répertoriez toutes les instances sans serveur créées :

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

Cet appel extrait les instances de type service_instance dans tous les groupes de ressources de tous les emplacements de votre compte.

Exemple de réponse :

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

Entrez la commande suivante avec le nom d'instance de serveur de votre instance pour afficher les détails de l'instance :

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

Vous récupérez ainsi votre instance des groupes de ressources sous votre compte.

Exemple de réponse :

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 réponse inclut le GUID et l'état de mise à disposition de votre instance.

Notez que l'état renvoyé create succeeded indique que la demande de mise à disposition a été acceptée. Toutefois, pour exécuter des applications, l'instance doit passer à l'état active. Suivez le statut de l'état de préparation de l'instance avant d'effectuer une opération sur l'instance. Voir Suivi de l'état de préparation d'une instance.

Accès aux détails d'instance à l'aide de l'API REST IBM Cloud

Vous avez besoin de l'ID d'une instance IBM Analytics Engine sans serveur pour obtenir les détails de l'instance, qui incluent le GUID et l'état de mise à disposition de l'instance, par exemple.

Pour obtenir les détails d'une instance, procédez comme suit :

Répertoriez toutes les instances sans serveur créées dans le groupe de ressources de votre compte :

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

Exemple de demande :

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

Exemple de réponse :

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

Voir Extraction des jetons d'accès IAM pour savoir comment obtenir le jeton d'accès au porteur d'autorisation.

Recherchez votre nom d'instance dans le tableau "resources" dans la réponse en vérifiant le paramètre "name". La réponse inclut le GUID et l'état de mise à disposition de votre instance. Pour plus de détails sur la réponse de l'API, voir Obtenir une liste de toutes les instances de ressource.

Notez que l'état renvoyé create succeeded indique que la demande de mise à disposition a été acceptée. Toutefois, pour exécuter des applications, l'instance doit passer à l'état active. Suivez la disponibilité de l'instance avant d'effectuer des opérations sur l'instance. Voir Suivi de l'état de préparation d'une instance.