Recuperando detalhes de uma instância serverless

É possível recuperar informações, como o ID da instância (ou GUID), e o estado de fornecimento de uma instância do IBM Analytics Engine serverless dos detalhes da instância. É preciso ter o ID da instância para usar a API de REST do aplicativo Spark e as APIs do lote Livy.

É possível recuperar os detalhes:

Usando a CLI do IBM Cloud
Usando a API de REST do IBM Cloud

Acessando detalhes da instância usando a CLI IBM Cloud

Para obter os detalhes de uma instância:

Liste todas as instâncias serverless criadas:

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

Essa chamada recupera as instâncias do tipo service_instance em todos os grupos de recursos em todos os locais para sua conta.

Resposta de exemplo:

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

Insira o comando a seguir com o nome da instância do servidor de sua instância para visualizar os detalhes da instância:

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

Isso recupera a instância dos grupos de recursos sob sua conta.

Resposta de exemplo:

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

A resposta inclui o GUID e o estado de fornecimento de sua instância.

Observe que o estado retornado create succeeded indica que a solicitação de provisão foi aceita com sucesso. No entanto, para executar aplicativos, a instância precisa se deslocar para o estado active. Controle o status da preparação da instância antes de executar qualquer operação na instância. Consulte Rastreando a preparação da instância.

Acessando detalhes da instância usando a API de REST IBM Cloud

É preciso ter o ID de uma instância serverless IBM Analytics Engine para obter os detalhes da instância, o que inclui o GUID e o estado de fornecimento da instância, por exemplo.

Para obter os detalhes de uma instância:

Liste todas as instâncias serverless criadas no grupo de recursos de sua conta:

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

Exemplo de uma solicitação:

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

Resposta de exemplo:

{
	"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 Recuperando tokens de acesso IAM para saber como obter o token de acesso do portador de autorização.

Procure pelo nome da instância na matriz "resources" na resposta verificando o parâmetro "name". A resposta inclui o GUID e o estado de fornecimento de sua instância. Para obter mais detalhes sobre a resposta da API, consulte Obter uma lista de todas as instâncias de recursos.

Observe que o estado retornado create succeeded indica que a solicitação de provisão foi aceita com sucesso. No entanto, para executar aplicativos, a instância precisa se deslocar para o estado active. Controle a preparação da instância antes de executar quaisquer operações na instância. Consulte Rastreando a preparação da instância.