使用 Object Storage 作为实例主目录

实例主目录可以与 IBM Analytics Engine 无服务器实例相关联:

创建实例时
在使用 instance_home API 创建实例之后

将 IBM Cloud Object Storage 定义为实例主目录

要将 Object Storage 定义为 IBM Analytics Engine 无服务器实例的实例主目录:

在 IBM Cloud®中供应 Object Storage 服务实例。请参阅创建新的服务实例。
供应实例后，生成服务凭证并检索 HMAC 访问密钥标识。
使用检索到的凭证来创建实例。

获取 Object Storage 凭证

在创建 IBM Analytics Engine 无服务器实例时，需要将访问凭证添加到 JSON 有效内容中的 Object Storage 实例，并指定实例的实例主存储器。

获取Object Storage认证：

从 IBM Cloud® 资源列表中的“存储器”下选择 Object Storage 实例。
在导航窗格中选择服务证书。
单击 新建凭证 并选择以下选项:
1. 输入您选择的凭证名称。
2. 选择 "Writer 角色。
3. 在 高级选项下:
- 选择 自动生成 作为服务标识。
- 打开选项以包含 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 创建实例后将其关联。在不久的将来，您还将能够通过控制台 UI 和 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"
}