インスタンス・ホームとしてのObject Storageの使用

インスタンス・ホームは、IBM Analytics Engineサーバーレス・インスタンスに関連付けることができます:

その時点で、インスタンスが作成されます
instance_homeAPIを使用してインスタンスが作成された後

インスタンス・ホームとしてのIBM Cloud Object Storageの定義

Object StorageをIBM Analytics Engineサーバーレス・インスタンスのインスタンス・ホームとして定義するには、以下のようにします:

Object Storage で IBM Cloud® サービス・インスタンスをプロビジョンします。新規サービス・インスタンスの作成を参照してください。
インスタンスがプロビジョンされた後、サービス資格情報を生成し、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 エンドポイントを見つけるには、Cross Regional の回復力と場所を選択し、サービス・インスタンスをクリックします。直接エンドポイントは、 「エンドポイント」 ページからコピーできます。

REST APIを使用したインスタンス・ホームの関連付け

インスタンスの作成時にインスタンス・ホームをインスタンスに関連付けなかった場合は、以下のREST APIを使用して、インスタンスの作成後にインスタンス・ホームを関連付けることができます。近い将来、コンソールUIおよびCLIを使用してこれを行うこともできます。

メモ:インスタンス・ホームは、インスタンスの存続期間中に1回のみ関連付けることができます。

インスタンス・ホームを関連付ける場合:

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