キー

キーは、そのtoken
属性を介して組織レベルでAPIへのアクセスを提供します。組織に代わってすべてのAPIエンドポイントと対話することが許可されています。
新しく作成された組織ごとにキーが生成されます。
属性
名 | タイプ | 説明 |
---|---|---|
id | キーID | リソース識別子 |
resource | 文字列、常にkey | リソースタイプ指定子 |
organisation | 組織ID | このキーが属する組織。 |
type | ひも | standard 、 trial |
storage_config | オプション、ストレージ構成ID | キーによって使用されるストレージ構成。 |
webhook_config | オプション、ウェブフック設定ID | キーによって使用されるWebhook設定。 |
token | ひも | このキーの認証資料。 APIに対するリクエストにAUTHORIZATION HTTPヘッダーをAUTHORIZATION するために使用されます。 |
state | ひも | active 、 deactivated 、 blocked 、 expired です。 |
date_created | 日付時刻 | リソースが作成されたとき |
date_expires | オプション、日時 | キーが期限切れになるとき。おtrial タイプのキーに主に適用されます。 |
タイプ
-
standard
- 鍵タイプどの組織にも、これらのうち少なくとも1つがあります。
-
trial
- 組織に試験的なアクセスを追加の権限に付与するためにAPI管理者によって生成されたキーこれらは通常
date_expires
フィールドを設定します。
ストレージとウェブフックの設定
重要なリソースは、storageおよびwebhook configの組織のデフォルト値を上書きできます。これは、開発環境と本番環境のような環境間で結果とイベント通知を分割するのに役立ちます。
トークン
キーのtoken
属性の値は、所有組織に代わってAPIに対して認証するために使用できます。
これらの値は安全に保管し、一般に公開しないでください。
状態
-
active
- キーの標準状態
-
deactivated
- 所有組織が鍵を無効にしました。
-
blocked
- キーはAPI管理者によって無効にされています。
-
expired
- 試用期間が過ぎると、キーは無効になります。
POST /keys
作成
パラメーター
名 | タイプ | 説明 |
---|---|---|
storage_config | ストレージ構成ID | このキーで組織のデフォルトのストレージ設定を上書きします。 |
webhook_config | ウェブフック設定ID | このキーで組織のデフォルトのWebhook設定を上書きします。 |
cURLを使う
curl 'https://ricloud-api.reincubate.com/keys' \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "storage_config": 2, }'
ricloud-pyを使う
import ricloud key = ricloud.Key.create(storage_config=2) # OR storage_config = ricloud.StorageConfig.retrieve(2) key = ricloud.Key.create(storage_config=storage_config)
GET /keys/{key ID}
取得しGET /keys/{key ID}
cURLを使う
curl 'https://ricloud-api.reincubate.com/keys/<key ID>' \ -H 'Authorization: Token <your key_token>'
ricloud-pyを使う
import ricloud key = ricloud.Key.retrieve(<key ID>)
GET /keys
一覧表示
パラメーター
名 | タイプ | 説明 |
---|---|---|
type | ひも | タイプ別にキーをフィルタリングします。 |
state | ひも | 状態によってキーをフィルタします。 |
cURLを使う
curl 'https://ricloud-api.reincubate.com/keys?limit=2' \ -H 'Authorization: Token <your key_token>'
ricloud-pyを使う
import ricloud keys = ricloud.Key.list(limit=2)
POST /keys/{key ID}
更新
パラメーター
名 | タイプ | 説明 |
---|---|---|
storage_config | ストレージ構成ID | キーによって使用されているストレージ構成を更新します。 null 場合、組織のデフォルトに戻ります。 |
webhook_config | ウェブフック設定ID | キーによって使用されるWebhook設定を更新します。 null 場合、組織のデフォルトに戻ります。 |
cURLを使う
curl 'https://ricloud-api.reincubate.com/keys/<key ID>' \ -X POST \ -H 'Authorization: Token <your key_token>' \ -H 'Content-Type: application/json' \ -d '{ "webhook_config": 2 }'
ricloud-pyを使う
import ricloud key = ricloud.Key.update_with_id(<key ID>, webhook_config=2) # OR key = ricloud.Key.retrieve(<key ID>) key.update(webhook_config=2)
POST /keys/{key ID}/rotate
キーのtoken
値を回転させtoken
。必須ではありませんが、かなり定期的に、または鍵のtoken
が危険にさらされていると疑われる場合は直ちにこれを行うことをお勧めします。
パラメーター
名 | タイプ | 説明 |
---|---|---|
force | bool、デフォルト: False | 現在のtoken 値をただちに認証解除する必要がある場合。そうでない場合、現在のローテーション期間は呼び出しが行われてから6時間後です。 |
cURLを使う
curl 'https://ricloud-api.reincubate.com/keys/<key ID>/rotate' \ -X POST \ -H 'Authorization: Token <your key_token>'
ricloud-pyを使う
import ricloud key = ricloud.Key.rotate_with_id(<key ID>) # OR key = ricloud.Key.retrieve(<key ID>) key.rotate()