Oracle Cloud Infrastructure-Dokumentation

Berechtigungen auf API-Ebene für API-Schlüssel

Diese Seite enthält Zugriffs- und Autorisierungsinformationen für den Ressourcentyp "OCI Generative AI API-Schlüssel".

Für bestimmte Berechtigungen für diesen Ressourcentyp prüfen Sie diese Seite. Eine Liste aller Ressourcentypen, die in OCI Generative AI verfügbar sind, finden Sie unter Benutzerzugriff auf einzelne Ressourcen.

Ressourcentyp

Ressourcentyp für IAM-Berechtigungen Dokumentationsreferenz API-Referenz
generative-ai-apikey API-Schlüssel ApiKey

Berechtigung prüfen

Erteilen Sie den Benutzergruppen die Berechtigung inspect, um die folgenden Vorgänge auszuführen:

  • ListApiKeys abrufen

Leseberechtigung

Erteilen Sie den Benutzergruppen die Berechtigung read, um die folgenden Vorgänge auszuführen:

  • ListApiKeys abrufen
  • GetApiKey abrufen

Berechtigung verwenden

Erteilen Sie den Benutzergruppen die Berechtigung use, um die folgenden Vorgänge auszuführen:

  • ListApiKeys abrufen
  • GetApiKey abrufen
  • PUT UpdateApiKey

Berechtigung verwalten

Erteilen Sie den Benutzergruppen die Berechtigung manage, um die folgenden Vorgänge auszuführen:

  • ListApiKeys abrufen
  • GetApiKey abrufen
  • PUT UpdateApiKey
  • POST ChangeApiKeyCompartment
  • POST CreateApiKey
  • DeleteApiKey LÖSCHEN
Hinweis

  • Die Berechtigung manage umfasst alle Aktionen, die für use, read und inspect zulässig sind.
  • Die Berechtigung use umfasst alle Aktionen, die von read und inspect zulässig sind.
  • Die Berechtigung read umfasst alle Aktionen, die von inspect zulässig sind.
Tipp

Der Ressourcentyp generative-ai-apikey ist Teil von generative-ai-family. Wenn Sie die Berechtigung für die Familie haben, haben Sie die gleiche Berechtigung für diesen Ressourcentyp. Beispiel: 
allow group <your-group-name> to manage generative-ai-family
in compartment <your-compartment-name>

1-1 Berechtigungen für APIs

Hinweis

Wir empfehlen die Verwendung der übergeordneten IAM-Verben manage, use, read und inspect für eine bessere Benutzererfahrung. Beispiel: Sie erteilen einer Benutzergruppe die Berechtigung zum Löschen einer Ressource. Wenn Sie jedoch nicht auch die Berechtigung zum Auflisten dieser Ressource erteilen, können Benutzer sie möglicherweise nicht finden.

Wenn ein Anwendungsfall nur Zugriff auf einen bestimmten API-Vorgang erfordert, können Sie die hier aufgeführten individuellen Berechtigungen verwenden.

generative-ai-apikey

Berechtigung API-Vorgang Vorgangstyp Verb
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

Beispiel: Die folgenden beiden Policys sind äquivalent:

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>