检索无服务器实例的详细信息

您可以从实例详细信息中检索 IBM Analytics Engine 无服务器实例的实例标识 (或 GUID) 和供应状态等信息。 您需要实例标识以使用 Spark 应用程序 REST API 和 Livy 批处理 API。

您可以通过以下方法检索详细信息:

使用 IBM Cloud CLI 访问实例详细信息

要获取实例的详细信息:

  1. 列出所有已创建的无服务器实例:

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

    此调用将在帐户的所有位置的所有资源组中检索类型为 service_instance 的实例。

    示例响应:

    Name                  Location   State    Type               Resource Group ID
    serverless-instance   us-south   active   service_instance   65xxxxxxxxxxxxxxxa3fd
    
  2. 输入带有实例的服务器实例名称的以下命令以查看实例详细信息:

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

    这将从帐户下的资源组中检索实例。

    示例响应:

    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
    

    响应包含实例的 GUID 和供应状态。

    请注意,返回的状态 create succeeded 指示已成功接受供应请求。 但是,为了运行应用程序,实例需要移至 active 状态。 在对实例执行任何操作之前,请跟踪实例就绪状态。 请参阅 跟踪实例就绪情况

使用 IBM Cloud REST API 访问实例详细信息

您需要 IBM Analytics Engine 无服务器实例的标识来获取实例的详细信息,例如,包括 GUID 和实例的供应状态。

要获取实例的详细信息:

  1. 列出您帐户的资源组中所有已创建的无服务器实例:

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

    请求示例:

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

    示例响应:

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

    请参阅 检索 IAM 访问令牌,以了解如何获取授权不记名访问令牌。

    通过检查 "name" 参数,在响应中的 "resources" 数组中搜索实例名称。 响应包含实例的 GUID 和供应状态。 有关 API 响应的更多详细信息,请参阅 获取所有资源实例的列表

    请注意,返回的状态 create succeeded 指示已成功接受供应请求。 但是,要运行应用程序,实例需要移至 active 状态。 在对实例执行任何操作之前跟踪实例就绪情况。 请参阅 跟踪实例就绪情况