Aktionen, Ressourcen und Bedingungsschlüssel für AWS DeepComposer

AWS DeepComposer (Servicepräfix: deepcomposer) stellt die folgenden servicespezifischen Ressourcen, Aktionen und Bedingungskontextschlüssel für die Verwendung in IAM-Berechtigungsrichtlinien bereit.

Referenzen:

• Erfahren Sie, wie Sie diesen Service konfigurieren.

• Zeigen Sie eine Liste der API-Operationen 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 AWS DeepComposer 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.

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.

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
AssociateCoupon [nur Berechtigung]	Gewährt die Berechtigung zum Zuordnen eines DeepComposer-Coupon (oder DSN) zu dem Konto, das dem Sender der Anfrage zugeordnet ist	Write
CreateAudio [nur Berechtigung]	Gewährt die Berechtigung zum Erstellen einer Audiodatei, indem die Midi-Komposition in eine WAV- oder MP3-Datei konvertiert wird	Write	audio*
CreateComposition [nur Berechtigung]	Gewährt die Berechtigung zum Erstellen einer Mehrspur-Midi-Komposition	Write	composition*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateModel [nur Berechtigung]	Gewährt die Berechtigung, mit der Erstellung/Übung eines generativen Modells zu beginnen, das in der Lage ist, Inferenz gegen die vom Benutzer bereitgestellte Klaviermelodie durchzuführen, um eine mehrspurige Midi-Komposition zu erstellen	Write	model*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteComposition [nur Berechtigung]	Gewährt die Berechtigung zum Löschen der Komposition	Write	composition*
DeleteModel	Gewährt die Berechtigung zum Löschen des Modells	Write	model*
GetComposition [nur Berechtigung]	Gewährt die Berechtigung zum Abrufen von Informationen zu der Komposition	Read	composition*
				aws:ResourceTag/${TagKey}
GetModel [nur Berechtigung]	Gewährt die Berechtigung zum Abrufen von Informationen zu dem Modell	Read	model*
				aws:ResourceTag/${TagKey}
GetSampleModel [nur Berechtigung]	Gewährt die Berechtigung, Informationen über das Beispiel/vortrainierte DeepComposer-Modell zu erhalten	Read	model*
ListCompositions [nur Berechtigung]	Gewährt die Berechtigung zum Auflisten aller Kompositionen, die dem Sender der Anforderung gehören	List	composition*
ListModels [nur Berechtigung]	Gewährt die Berechtigung zum Auflisten aller Modelle, die dem Sender der Anfrage gehören	List	model*
ListSampleModels [nur Berechtigung]	Gewährt die Berechtigung zum Auflisten aller Beispiel-/vortrainierten Modelle, die vom DeepComposer-Service bereitgestellt werden.	List	model*
ListTagsForResource	Gewährt die Berechtigung zum Auflisten von Tags für eine Ressource	List	composition
			model
				aws:ResourceTag/${TagKey}
ListTrainingTopics [nur Berechtigung]	Gewährt die Berechtigung zum Auflisten aller Übungsoptionen oder Themen zum Erstellen/Üben eines Modells	List	model*
TagResource	Gewährt die Berechtigung zum Markieren einer Ressource mit Tags	Markieren	composition
			model
				aws:TagKeys aws:RequestTag/${TagKey} aws:ResourceTag/${TagKey}
UntagResource	Gewährt die Berechtigung zum Aufheben der Markierung einer Ressource	Markieren	composition
			model
				aws:TagKeys aws:ResourceTag/${TagKey}
UpdateComposition [nur Berechtigung]	Gewährt die Berechtigung zum Ändern der veränderbaren Eigenschaften, die mit einer Komposition verknüpft sind	Write	composition*
UpdateModel [nur Berechtigung]	Gewährt die Berechtigung zum Ändern der veränderbaren Eigenschaften, die mit einem Modell verknüpft sind	Write	model*

Von AWS DeepComposer 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 "Actions" (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
model	arn:${Partition}:deepcomposer:${Region}:${Account}:model/${ModelId}	aws:ResourceTag/${TagKey}
composition	arn:${Partition}:deepcomposer:${Region}:${Account}:composition/${CompositionId}	aws:ResourceTag/${TagKey}
audio	arn:${Partition}:deepcomposer:${Region}:${Account}:audio/${AudioId}

Bedingungsschlüssel für AWS DeepComposer

AWS DeepComposer 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 Bedingungsschlüssel.

Eine Liste der globalen Bedingungsschlüssel, die für alle Services verfügbar sind, finden Sie unter Verfügbare globale Bedingungsschlüssel.

Bedingungsschlüssel	Beschreibung	Typ
aws:RequestTag/${TagKey}	Filtert den Zugriff danach, ob Tag-Schlüssel-Wert-Paare in der Anforderung vorhanden sind	Zeichenfolge
aws:ResourceTag/${TagKey}	Filtert den Zugriff basierend auf den Tag-Schlüssel-Wert-Paaren, die der Ressource angefügt sind	Zeichenfolge
aws:TagKeys	Filtert Zugriff basierend auf dem Vorhandensein von Tag-Schlüsseln in der Anforderung	ArrayOfString