使用 Object Storage 作為實例起始目錄

實例起始目錄可以與 IBM Analytics Engine 無伺服器實例相關聯:

在建立實例時
使用 instance_home API 建立實例之後

將 IBM Cloud Object Storage 定義為實例起始目錄

若要將 Object Storage 定義為 IBM Analytics Engine 無伺服器實例的實例起始目錄:

在 IBM Cloud®中佈建 Object Storage 服務實例。請參閱建立新的服務實例。
佈建實例之後，請產生服務認證並擷取 HMAC 存取金鑰 ID。
使用擷取的認證來建立實例。

取得 Object Storage 認證

當您建立 IBM Analytics Engine 無伺服器實例並指定實例的實例起始儲存體時，需要將存取認證新增至 JSON 有效負載中的 Object Storage 實例。

要取得Object Storage憑證：

從 IBM Cloud® 資源清單中，選取 Storage 下的 Object Storage 實例。
在導覽窗格中選擇服務憑證。
按一下 新建認證，然後選擇下列選項:
1. 輸入您選擇的認證名稱。
2. 選擇 Writer 角色。
3. 在 進階選項下:
- 針對服務 ID 選擇 自動產生。
- 開啟選項以併入 HMAC 認證。
1. 按一下新增。
建立憑證視窗

何謂 Object Storage 認證

若要取得您建立以從 IBM Analytics Engine 無伺服器實例參照之 Object Storage 實例的認證，請執行下列動作:

選取您建立的認證名稱，並將認證複製到剪貼簿。
檢視您所複製的認證。您會看到類似下列範例中所示的內容:
```
{
  "apikey": "XXXXXXX",
  "cos_hmac_keys": {
    "access_key_id": "aaaa1111bbbbb222222ccccc3333333ddddd44444",
    "secret_access_key": "ZZZZYYYYYXXXXXXWWWWWVVVVVVUUUUU"
    },
    "endpoints": ...
}
```
附註：
- 目前，IBM Analytics Engine 無伺服器方案僅支援 HMAC 樣式認證。
- 挑選專用端點以進行耗用。
- IBM Cloud Object Storage 實例的端點應該是 direct 端點。您可以透過選取跨區域備援、位置，然後按一下服務實例，在 IBM Cloud® 儀表板上找到 IBM Cloud Object Storage 實例的 direct 端點。您可以從端點頁面複製直接端點。

使用 REST API 來關聯實例起始目錄

如果您在建立實例時未建立實例起始目錄與實例的關聯，則可以在建立實例之後使用下列 REST API 來建立實例的關聯。在不久的將來，您也可以透過主控台使用者介面及 CLI 來執行此動作。

附註: 在實例的生命期限內，您只能關聯實例起始目錄一次。

若要關聯實例起始目錄，請執行下列動作:

curl -X PUT https://api.<region>.ae.cloud.ibm.com/v3/analytics_engines/<instance-id>/instance_home --header "Authorization: Bearer <IAM token>" -H "content-type: application/json" -d @instance-home.json

其中 instance-home.json 具有下列格式:

{
  "instance_id": "CLOUD_OBJECT_STORAGE_INSTANCE_GUID",
  "provider": "ibm-cos",
  "type": "objectstore",
  "region": "REGION_OF_CLOUD_OBJECT_STORAGE_INSTANCE",
  "endpoint": "https://s3.direct.us-south.cloud-object-storage.appdomain.cloud",
  "hmac_access_key": "CLOUD_OBJECT_STORAGE_HMAC_ACCESS_KEY",
  "hmac_secret_key": "LOUD_OBJECT_STORAGE_HMAC_SECRET_KEYE"
}