APIキーのAPIレベルの権限

このページには、OCI生成AI APIキー・リソース・タイプのアクセスおよび認可情報が表示されます。

このリソース・タイプの特定の権限については、このページを確認してください。OCI生成AIで使用可能なすべてのリソース・タイプのリストは、個々のリソースへのユーザー・アクセスを参照してください。

リソース・タイプ


IAM権限のリソース・タイプ	ドキュメント・リファレンス	APIリファレンス
`generative-ai-apikey`	APIキー	`ApiKey`

権限の検査

ユーザー・グループに、次の操作を実行するinspect権限を付与します。

GET ListApiKeys

読み取り権限

ユーザー・グループに、次の操作を実行するread権限を付与します。

GET ListApiKeys
GET GetApiKey

権限の使用

ユーザー・グループに、次の操作を実行するuse権限を付与します。

GET ListApiKeys
GET GetApiKey
プット UpdateApiKey

権限を管理

ユーザー・グループに、次の操作を実行するmanage権限を付与します。

GET ListApiKeys
GET GetApiKey
プット UpdateApiKey
POST ChangeApiKeyCompartment
POST CreateApiKey
DeleteApiKeyの削除

ノート

manageアクセス権には、use、read、および inspectによって許可されるすべてのアクションが含まれます。
use権限には、readおよび inspectによって許可されるすべてのアクションが含まれます。
readアクセス権には、inspectによって許可されるすべてのアクションが含まれます。

ヒント

generative-ai-apikeyリソース・タイプは、generative-ai-familyの一部です。ファミリに対する権限がある場合、このリソース・タイプに対して同じ権限を持ちます。例:

allow group <your-group-name> to manage generative-ai-family
in compartment <your-compartment-name>

1-1 APIの権限

ノート

ユーザー・エクスペリエンスを向上させるには、上位レベルのIAM動詞(manage、use、readおよびinspect)を使用することをお薦めします。たとえば、リソースを削除する権限をユーザー・グループに付与しても、そのリソースをリストする権限も付与しない場合、ユーザーはリソースを見つけられない可能性があります。

ユース・ケースで特定のAPI操作のみにアクセスする必要がある場合は、ここにリストされている個々の権限を使用できます。

`generative-ai-apikey`


権限	API操作	操作タイプ	動詞
`GENERATIVE_AI_APIKEY_INSPECT`	`ListApiKeys`	`GET`	`inspect`
`GENERATIVE_AI_APIKEY_READ`	`GetApiKey`	`GET`	`read`
`GENERATIVE_AI_APIKEY_UPDATE`	`UpdateApiKey`	`PUT`	`use`
`GENERATIVE_AI_APIKEY_MOVE`	`ChangeApiKeyCompartment`	`POST`	`manage`
`GENERATIVE_AI_APIKEY_CREATE`	`CreateApiKey`	`POST`	`manage`
`GENERATIVE_AI_APIKEY_DELETE`	`DeleteApiKey`	`DELETE`	`manage`

たとえば、次の2つのポリシーは同等です。

allow group <your-user-group> to manage generative-ai-apikey
in compartment <your-compartment-name>

allow group <your-user-group> to
{GENERATIVE_AI_APIKEY_INSPECT, GENERATIVE_AI_APIKEY_READ, GENERATIVE_AI_APIKEY_UPDATE, GENERATIVE_AI_APIKEY_MOVE, GENERATIVE_AI_APIKEY_CREATE, GENERATIVE_AI_APIKEY_DELETE}
in compartment <your-compartment-name>

Oracle Cloud Infrastructureドキュメント