擷取無伺服器實例的詳細資料

您可以從實例詳細資料擷取資訊，例如 IBM Analytics Engine 無伺服器實例的實例 ID (或 GUID) 及佈建狀態。 您需要實例 ID，才能使用 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 無伺服器實例的 ID，以取得實例的詳細資料，例如包括實例的 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 狀態。 在對實例執行任何作業之前，請先追蹤實例就緒狀態。 請參閱 追蹤實例就緒狀態。