Recuperación de detalles de una instancia sin servidor

Puede recuperar información, como el ID de instancia (o GUID) y el estado de suministro de una instancia sin servidor de IBM Analytics Engine de los detalles de la instancia. Necesita el ID de instancia para utilizar la API REST de aplicación de Spark y las API de proceso por lotes de Livy.

Puede recuperar los detalles:

Utilizando la CLI de IBM Cloud
Utilizando la API REST IBM Cloud

Accediendo a los detalles de instancia mediante la CLI de IBM Cloud

Para obtener los detalles de una instancia:

Cree una lista de todas las instancias sin servidor creadas:

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

Esta llamada recupera las instancias de tipo service_instance en todos los grupos de recursos de todas las ubicaciones de la cuenta.

Respuesta de ejemplo:

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

Especifique el mandato siguiente con el nombre de instancia de servidor de la instancia para ver los detalles de la instancia:
```
$ ibmcloud resource service-instance "Analytics Engine-xyz"
```
De este modo, se recupera la instancia de los grupos de recursos de la cuenta.

Respuesta de ejemplo:
```
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 respuesta incluye el GUID y el estado de suministro de la instancia.

Tenga en cuenta que el estado devuelto create succeeded indica que la solicitud de suministro se ha aceptado satisfactoriamente. Sin embargo, para poder ejecutar aplicaciones, la instancia debe moverse al estado active. Realice un seguimiento del estado de la preparación de la instancia antes de realizar cualquier operación en la instancia. Consulte Seguimiento de preparación de instancias.

Acceso a los detalles de instancia mediante la API REST de IBM Cloud

Necesita el ID de una instancia sin servidor de IBM Analytics Engine para obtener los detalles de la instancia, que incluyen el GUID y el estado de suministro de la instancia, por ejemplo.

Para obtener los detalles de una instancia:

Cree una lista de todas las instancias sin servidor creadas en el grupo de recursos de la cuenta:

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

Ejemplo de solicitud:

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

Respuesta de ejemplo:

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

Consulte Recuperación de señales de acceso de IAM para obtener la señal de acceso al portador de autorización.

Busque el nombre de instancia en la matriz "resources" en la respuesta comprobando el parámetro "name". La respuesta incluye el GUID y el estado de suministro de la instancia. Para obtener más detalles sobre la respuesta de la API, consulte Obtener una lista de todas las instancias de recursos.

Tenga en cuenta que el estado devuelto create succeeded indica que la solicitud de suministro se ha aceptado satisfactoriamente. Sin embargo, para ejecutar aplicaciones, la instancia debe moverse al estado active. Realice un seguimiento de la preparación de la instancia antes de realizar cualquier operación en ella. Consulte Seguimiento de preparación de instancias.