mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-12-13 18:02:24 +00:00
51 lines
2.9 KiB
Markdown
51 lines
2.9 KiB
Markdown
---
|
||
sidebar_label: APIキーの管理
|
||
slug: /ja/cloud/manage/openapi
|
||
title: APIキーの管理
|
||
---
|
||
|
||
ClickHouse Cloudは、OpenAPIを利用したAPIを提供しており、アカウントおよびサービスの各種要素をプログラムで管理することができます。
|
||
|
||
# APIキーの管理
|
||
|
||
:::note
|
||
このドキュメントは、ClickHouse Cloud APIについて説明しています。データベースAPIのエンドポイントについては、[Cloud Endpoints API](/docs/ja/cloud/security/cloud-endpoints-api.md)をご覧ください。
|
||
:::
|
||
|
||
1. 左側のメニューの**API Keys**タブを使用して、APIキーの作成と管理ができます。
|
||
|
||
![ClickHouse Cloud API Keys Tab](@site/docs/ja/_snippets/images/openapi1.png)
|
||
|
||
2. **API Keys**ページは、最初にAPIキーを作成するためのプロンプトを表示します。最初のキーを作成した後は、画面右上に表示される `New API Key` ボタンを使用して新しいキーを作成できます。
|
||
|
||
![Initial API Screen](@site/docs/ja/_snippets/images/openapi2.png)
|
||
|
||
3. APIキーを作成するには、キー名、キーの権限、および有効期限を指定し、`Generate API Key` をクリックします。
|
||
|
||
![Create API Key](@site/docs/ja/_snippets/images/openapi3.png)
|
||
|
||
4. 次の画面では、Key ID と Key secret が表示されます。この値をコピーして、金庫などの安全な場所に保管してください。この画面を離れた後は、これらの値は表示されません。
|
||
|
||
![API Key ID and Key Secret](@site/docs/ja/_snippets/images/openapi4.png)
|
||
|
||
5. ClickHouse Cloud APIは、[HTTP Basic Authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication)を使用してAPIキーの有効性を確認します。以下は、`curl`を使用してClickHouse Cloud APIにリクエストを送信する例です:
|
||
|
||
```bash
|
||
$ KEY_ID=mykeyid
|
||
$ KEY_SECRET=mykeysecret
|
||
|
||
$ curl --user $KEY_ID:$KEY_SECRET https://api.clickhouse.cloud/v1/organizations
|
||
```
|
||
|
||
6. **API Keys**ページに戻ると、キーの名前、Key IDの最後の4文字、権限、ステータス、満期日、および作成者が表示されます。この画面からキー名、権限、および有効期限を編集することができます。キーはこの画面から無効化または削除することもできます。
|
||
|
||
:::note
|
||
APIキーを削除すると、この操作は取り消すことができません。このキーを使用しているサービスは、すぐにClickHouse Cloudへのアクセスができなくなります。
|
||
:::
|
||
|
||
![API Key Management](@site/docs/ja/_snippets/images/openapi5.png)
|
||
|
||
## エンドポイント
|
||
|
||
[エンドポイントドキュメントはこちら](/docs/ja/cloud/manage/api/invitations-api-reference.md)。API Key と API Secret を利用して、ベースURL `https://api.clickhouse.cloud/v1` を使用してください。
|