Aktionen, Ressourcen und Bedingungsschlüssel für Amazon S3 Vectors

Amazon S3 Vectors (Servicepräfix:s3vectors) stellt die folgenden dienstspezifischen Ressourcen, Aktionen und Bedingungskontextschlüssel zur Verwendung in IAM-Berechtigungsrichtlinien bereit.

Referenzen:

• Erfahren Sie, wie Sie diesen Service konfigurieren.

• Zeigen Sie eine Liste der API-Vorgänge an, die für diesen Service verfügbar sind.

• Erfahren Sie, wie Sie diesen Service und seine Ressourcen mithilfe von IAM-Berechtigungsrichtlinien schützen.

Von Amazon S3 Vectors definierte Aktionen

Sie können die folgenden Aktionen im Element Action einer IAM-Richtlinienanweisung angeben. Verwenden Sie Richtlinien, um Berechtigungen zum Ausführen einer Operation in AWS zu erteilen. Wenn Sie eine Aktion in einer Richtlinie verwenden, erlauben oder verweigern Sie in der Regel den Zugriff auf die API-Operation oder den CLI-Befehl mit demselben Namen. Dabei kann es mitunter vorkommen, dass eine einzige Aktion den Zugriff auf mehr als eine Operation steuert. Alternativ erfordern einige Vorgänge mehrere verschiedene Aktionen.

In der Spalte Zugriffsebene der Tabelle Aktionen wird beschrieben, wie die Aktion klassifiziert ist (Liste, Lesen, Verwaltung von Berechtigungen oder Tagging). Diese Klassifizierung gibt an, welche Zugriffsebene die betreffende Aktion gewährt, wenn Sie sie in einer Richtlinie verwenden. Weitere Informationen zu Zugriffsebenen finden Sie unter Zugriffsebenen in Richtlinienzusammenfassungen.

Die Spalte Resource types (Ressourcentypen) der Aktionstabelle gibt an, ob die Aktion Berechtigungen auf Ressourcenebene unterstützt. Wenn es keinen Wert für diese Spalte gibt, müssen Sie alle Ressourcen ("*") im Element Resource Ihrer Richtlinienanweisung angeben. Wenn die Spalte einen Ressourcentyp enthält, können Sie einen ARN dieses Typs in einer Anweisung mit dieser Aktion angeben. Wenn für die Aktion eine oder mehrere Ressourcen erforderlich sind, muss der Aufrufer die Erlaubnis haben, die Aktion mit diesen Ressourcen zu verwenden. Erforderliche Ressourcen sind in der Tabelle mit einem Sternchen (*) gekennzeichnet. Wenn Sie den Ressourcenzugriff mit dem Element Resource in einer IAM-Richtlinie einschränken, müssen Sie für jeden erforderlichen Ressourcentyp einen ARN oder ein Muster angeben. Einige Aktionen unterstützen mehrere Ressourcentypen. Wenn der Ressourcentyp optional ist (nicht als erforderlich angegeben), können Sie sich für einen der optionalen Ressourcentypen entscheiden.

Die Spalte Bedingungsschlüssel der Tabelle der Aktionen enthält Schlüssel, die Sie im Element Condition einer Richtlinienanweisung angeben können. Weitere Informationen zu den Bedingungsschlüsseln, die den Ressourcen für den Service zugeordnet sind, finden Sie in der Spalte Bedingungsschlüssel der Tabelle der Ressourcentypen.

In der Spalte „Abhängige Aktionen“ der Tabelle „Aktionen“ werden zusätzliche Berechtigungen angezeigt, die für den erfolgreichen Aufruf einer Aktion erforderlich sind. Diese Berechtigungen werden zusätzlich zu den Berechtigungen für die Aktion selbst benötigt. Wenn eine Aktion abhängige Aktionen spezifiziert, können diese Abhängigkeiten für zusätzliche Ressourcen gelten, die für diese Aktion definiert wurden, nicht nur für die erste Ressource, die in der Tabelle aufgeführt ist.

Anmerkung

Die Ressourcenbedingungsschlüssel sind in der Tabelle Ressourcentypen enthalten. Sie finden einen Link zu dem Ressourcentyp, der für eine Aktion gilt, in der Spalte Ressourcentypen (*erforderlich) der Tabelle „Aktionen“. Der Ressourcentyp in der Tabelle „Ressourcentypen“ enthält die Spalte Bedingungsschlüssel. Das sind die Ressourcenbedingungsschlüssel, die für eine Aktion in der Tabelle „Aktionen“ gelten.

Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Aktionen

Aktionen	Beschreibung	Zugriffsebene	Ressourcentypen (*erforderlich)	Bedingungsschlüssel	Abhängige Aktionen
CreateIndex	Erteilt die Berechtigung, einen neuen Vektorindex innerhalb eines angegebenen Vektor-Buckets zu erstellen	Schreiben	Index*
CreateVectorBucket	Erteilt die Berechtigung zum Erstellen eines neuen Vektor-Buckets	Schreiben	VectorBucket*
				s3vectors:sseType s3vectors:kmsKeyArn
DeleteIndex	Erteilt die Erlaubnis, einen angegebenen Vektorindex zu löschen	Schreiben	Index*
DeleteVectorBucket	Erteilt die Berechtigung zum Löschen eines angegebenen Vektor-Buckets	Schreiben	VectorBucket*
DeleteVectorBucketPolicy	Erteilt die Berechtigung zum Löschen der IAM-Ressourcenrichtlinie aus einem angegebenen Vektor-Bucket	Berechtigungsverwaltung	VectorBucket*
DeleteVectors	Erteilt die Berechtigung zum Löschen eines Stapels von Vektoren aus einem angegebenen Vektorindex	Schreiben	Index*
GetIndex	Erteilt die Berechtigung, die Attribute eines angegebenen Vektorindexes abzurufen	Lesen	Index*
GetVectorBucket	Erteilt die Berechtigung zum Abrufen der Attribute eines angegebenen Vektor-Buckets	Lesen	VectorBucket*
GetVectorBucketPolicy	Erteilt die Berechtigung zum Abrufen der IAM-Ressourcenrichtlinie für einen bestimmten Vektor-Bucket	Lesen	VectorBucket*
GetVectors	Erteilt die Erlaubnis, einen Stapel von Vektoren anhand ihrer Vektorschlüssel abzurufen	Lesen	Index*
ListIndexes	Erteilt die Berechtigung, eine paginierte Liste aller Indizes in einem angegebenen Vektor-Bucket abzurufen	Auflisten	VectorBucket*
ListVectorBuckets	Erteilt die Berechtigung, eine paginierte Liste aller Vektor-Buckets im Konto abzurufen	Auflisten
ListVectors	Erteilt die Berechtigung, eine paginierte Liste aller Vektoren in einem angegebenen Vektorindex abzurufen	Auflisten	Index*		s3vectors:GetVectors
PutVectorBucketPolicy	Erteilt die Berechtigung, einem angegebenen Vektor-Bucket eine IAM-Ressourcenrichtlinie hinzuzufügen	Berechtigungsverwaltung	VectorBucket*
PutVectors	Erteilt die Berechtigung, einem angegebenen Vektorindex einen Stapel von Vektoren hinzuzufügen	Schreiben	Index*
QueryVectors	Erteilt die Berechtigung, die ungefähren nächstgelegenen Nachbarn innerhalb eines angegebenen Suchvektorindexes für einen bestimmten Abfragevektor zu finden	Lesen	Index*		s3vectors:GetVectors

Von Amazon S3 Vectors definierte Ressourcentypen

Die folgenden Ressourcentypen werden von diesem Service definiert und können im Element Resource von IAM-Berechtigungsrichtlinienanweisungen verwendet werden. Jede Aktion in der Tabelle „Aktionen“ identifiziert die Ressourcentypen, die mit der Aktion angegeben werden können. Ein Ressourcentyp kann auch definieren, welche Bedingungsschlüssel Sie in einer Richtlinie einschließen können. Diese Schlüssel werden in der letzten Spalte der Tabelle der Ressourcentypen angezeigt. Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Resource types.

Ressourcentypen	ARN	Bedingungsschlüssel
Index	arn:${Partition}:s3vectors:${Region}:${Account}:bucket/${BucketName}/index/${IndexName}
VectorBucket	arn:${Partition}:s3vectors:${Region}:${Account}:bucket/${BucketName}

Bedingungsschlüssel für Amazon S3 Vectors

Amazon S3 Vectors definiert die folgenden Bedingungsschlüssel, die im Condition Element einer IAM-Richtlinie verwendet werden können. Diese Schlüssel können Sie verwenden, um die Bedingungen zu verfeinern, unter denen die Richtlinienanweisung angewendet wird. Details zu den Spalten in der folgenden Tabelle finden Sie in der Tabelle Condition keys (Bedingungsschlüssel).

Informationen zu den globalen Bedingungsschlüsseln, die für alle Services verfügbar sind, finden Sie unter AWS Globale Bedingungskontextschlüssel.

Bedingungsschlüssel	Beschreibung	Typ
s3vectors:kmsKeyArn	Filtert den Zugriff anhand des AWS KMS-Schlüssels ARN nach dem Schlüssel, der zum Verschlüsseln eines Vektor-Buckets verwendet wird	ARN
s3vectors:sseType	Filtert den Zugriff nach serverseitigem Verschlüsselungstyp	String