> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-3a82795f.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# API キーの管理

> ClickHouse Cloud では、OpenAPI を利用した API が提供されており、アカウントやサービスの一部機能をプログラムから管理できます。

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

ClickHouse Cloud では、OpenAPI を利用した API が提供されており、アカウントやサービスの一部機能をプログラムから管理できます。

<Note>
  このドキュメントでは ClickHouse Cloud API を扱います。データベースの API エンドポイントについては、[Cloud Endpoints API](/ja/products/cloud/guides/sql-console/query-endpoints) を参照してください。
</Note>

1. 左側のメニューにある **API Keys** タブから、API キーを作成および管理できます。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi1.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=b00f0b4f0391fd038c91baae2dfdb728" size="sm" alt="API Keys タブ" border width="433" height="472" data-path="images/cloud/manage/openapi1.png" />

2. **API Keys** ページを開くと、最初は以下のように最初の API キーを作成するための案内が表示されます。最初のキーを作成すると、右上に表示される `New API Key` ボタンから新しいキーを作成できるようになります。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi2.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=37646787aac0ecef6f8e5d897ce8450b" size="md" alt="API Keys ページ" border width="1036" height="466" data-path="images/cloud/manage/openapi2.png" />

3. API キーを作成するには、キー名、キーの権限、有効期限を指定し、`Generate API Key` をクリックします。

<br />

<Note>
  権限は ClickHouse Cloud の[事前定義ロール](/ja/products/cloud/reference/security/console-roles)に対応しています。developer ロールには割り当てられたサービスに対する読み取り専用権限があり、admin ロールには完全な読み取りおよび書き込み権限があります。
</Note>

<Tip>
  **クエリ API エンドポイント**

  [クエリ API エンドポイント](/ja/products/cloud/guides/sql-console/query-endpoints) で API キーを使用するには、Organization Role を少なくとも `Member` に設定し、Service Role に `Query Endpoints` へのアクセスを付与してください。
</Tip>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi3.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=c7668537d2628710b8d56f628bb88838" size="md" alt="API キー作成フォーム" border width="661" height="410" data-path="images/cloud/manage/openapi3.png" />

4. 次の画面に Key ID と Key secret が表示されます。これらの値をコピーし、vault などの安全な場所に保管してください。この画面を離れると、これらの値は再表示されません。

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi4.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=65f5066df4be769b0be1a1f0a75db290" size="md" alt="API キーの詳細" border width="653" height="271" data-path="images/cloud/manage/openapi4.png" />

5. ClickHouse Cloud API では、[HTTP Basic Authentication](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) を使用して API キーの有効性を検証します。以下は、`curl` を使用して API キーで ClickHouse Cloud API にリクエストを送信する例です。

```bash theme={null}
$ KEY_ID=mykeyid
$ KEY_SECRET=mykeysecret

$ curl --user $KEY_ID:$KEY_SECRET https://api.clickhouse.cloud/v1/organizations
```

6. **API Keys** ページに戻ると、キー名、Key ID の末尾 4 文字、権限、ステータス、有効期限、作成者が表示されます。この画面から、キー名、権限、有効期限を編集できます。また、キーの無効化や削除もこの画面から行えます。

<br />

<Note>
  API キーの削除は元に戻せない操作です。このキーを使用しているサービスは、直ちに ClickHouse Cloud へアクセスできなくなります。
</Note>

<Image img="https://mintcdn.com/private-7c7dfe99-mintlify-3a82795f/hIzR76_l6U8-lQLM/images/cloud/manage/openapi5.png?fit=max&auto=format&n=hIzR76_l6U8-lQLM&q=85&s=f08a928d4f9788eb2f1ef78d62146dc4" size="md" alt="API キー管理ページ" border width="1092" height="335" data-path="images/cloud/manage/openapi5.png" />

<div id="endpoints">
  ## エンドポイント
</div>

エンドポイントの詳細については、[API リファレンス](/ja/api-reference/organization/get-list-of-available-organizations)を参照してください。
base URL `https://api.clickhouse.cloud/v1` を使用し、API キー と API Secret を指定します。