クラスターの管理
このガイドでは、クラスターのライフサイクルについて説明し、Zilliz Cloud コンソールを最大限に活用して目標を達成する方法を示します。
稼働中のクラスターの管理
稼働中のクラスターに対して、以下の操作を実行できます。
名前の変更
対象のクラスターのクラスターの詳細ページに移動し、以下の手順に従ってクラスターの名前を変更します。
一時停止
Web コンソールまたはプログラム経由でクラスターを一時停止できます。
- Cloud Console
- cURL
対象のクラスターのクラスターの詳細ページに移動し、以下の手順に従って Dedicated クラスターを一時停止します。
リクエストは以下の例のようになります。ここで、{API_KEY} は認証に使用する API キーです。
以下の POST リクエストはリクエストボディを受け取り、Dedicated クラスターを一時停止します。
curl --request POST \
--url "https://api.cloud.zilliz.com/v2/clusters/${CLUSTER_ID}/suspend" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
# {
# "code": 0,
# "data": {
# "clusterId": "inxx-xxxxxxxxxxxxxxx",
# "prompt": "Successfully Submitted. The cluster will not incur any computing costs when suspended. You will only be billed for the storage costs during this time."
# }
# }
上記のコマンドでは、
-
{API_KEY}: API リクエストの認証に使用される認証情報です。値はご自身のものに置き換えてください。API キーは Platform API（コントロールプレーン）リクエストの認証に使用されることに注意してください。データプランへの接続には、代わりにクラスター認証情報（username:password）を使用してください。 -
{CLUSTER_ID}: 一時停止する Dedicated クラスターの ID です。
詳細については、クラスターの一時停止 を参照してください。
一時停止操作が成功すると、ジョブレコードが生成されます。進捗状況は ジョブ ページで確認できます。
再開
再開中は、クラスターに対して他のアクションを実行できないことに注意してください。
クラスターの再開は、Web コンソールまたはプログラムで行うことができます。
- Cloud Console
- cURL
対象クラスターの クラスターの詳細 ページに移動し、以下の手順に従ってクラスターを再開してください。
クラスターの再開 ダイアログボックスで 再開 をクリックすると、プロジェクトのリソースクォータを確認するよう求められます。リソースが十分であれば、確認が完了後にダイアログボックスが消えます。そうでない場合は、
プロジェクトのリソース設定に移動 をクリックしてプロジェクトのリソース設定を編集するか、
前のステップに戻る をクリックしてクラスター設定を変更してください。
このプロセス中、ローリングに追加のリソースが必要になります。これらのリソースは使用後に解放されます。
リクエストは以下の例のようになるはずです。ここで {API_KEY} は認証に使用する API キーです。
以下の POST リクエストはリクエストボディを受け取り、クラスターを再開します。
curl --request POST \
--url "https://api.cloud.zilliz.com/v2/clusters/${CLUSTER_ID}/resume" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
# {
# "code": 0,
# "data": {
# "clusterId": "inxx-xxxxxxxxxxxxxxx",
# "prompt": "successfully Submitted. Cluster is being resumed, which is expected to takes several minutes. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK."
# }
# }
上記のコマンドでは、
-
{API_KEY}: API リクエストの認証に使用される認証情報です。値はご自身のものに置き換えてください。API キーは Platform API（コントロールプレーン）リクエストの認証に使用されることに注意してください。データプランへの接続には、代わりにクラスター認証情報（username:password）を使用してください。 -
{CLUSTER_ID}: 再開するクラスターの ID です。
詳細については、クラスターの再開 を参照してください。
再開操作が成功すると、ジョブレコードが生成されます。進捗状況は ジョブ ページで確認できます。
削除
クラスターが不要になった場合、削除することができます。クラスターは Web コンソールまたはプログラムで削除できます。
- Cloud Console
- cURL
対象クラスターの クラスターの詳細 ページに移動し、以下の手順に従ってクラスターを削除してください。
リクエストは以下の例のようになるはずです。ここで {API_KEY} は認証に使用する API キーです。
以下の DELETE リクエストはリクエストボディを受け取り、クラスターを削除します。
curl --request POST \
--url "https://api.cloud.zilliz.com/v2/clusters/${CLUSTER_ID}/drop" \
--header "Authorization: Bearer ${API_KEY}" \
--header "Accept: application/json" \
--header "Content-Type: application/json" \
# {
# "code": 0,
# "data": {
# "clusterId": "inxx-xxxxxxxxxxxxxxx",
# "prompt": "The cluster has been deleted. If you consider this action to be an error, you have the option to restore the deleted cluster from the recycle bin within a 30-day period. Kindly note, this recovery feature does not apply to free clusters."
# }
# }
上記のコマンドでは、
-
{API_KEY}: APIリクエストの認証に使用されるクレデンシャルです。値はご自身のものに置き換えてください。APIキーはPlatform API（コントロールプレーン）リクエストの認証に使用されることに注意してください。データプランへの接続には、代わりにクラスタークレデンシャル（username:password）を使用してください。 -
{CLUSTER_ID}: 削除するDedicatedクラスターのIDです。
詳細については、クラスターの削除 を参照してください。
オンデマンドクラスターの管理 ｜PUBLIC
オンデマンドクラスターに対して、以下の操作を実行できます。
削除
-
RESTful API経由
curl --request DELETE \--url "https://${BASE_URL}/v2/clusters/onDemandClusters/in07-7d6ac8697204a6a" \--header "Authorization: Bearer ${API_KEY}" \--header "Accept: application/json" -
ウェブコンソール経由