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

AWS CodePipeline (Dienstpräfix:codepipeline) 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 AWS CodePipeline 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
AcknowledgeJob	Gewährt die Berechtigung zum Anzeigen von Informationen zu einem bestimmten Auftrag und ob dieser Auftrag von dem Worker empfangen wurde	Write
AcknowledgeThirdPartyJob	Gewährt die Berechtigung, zu bestätigen, dass ein Worker den angegebenen Auftrag erhalten hat (nur Partneraktionen)	Schreiben
CreateCustomActionType	Erteilt die Berechtigung zum Erstellen einer benutzerdefinierten Aktion, die Sie in den zugehörigen Pipelines verwenden können AWS-Konto	Schreiben	actiontype*
				aws:RequestTag/${TagKey} aws:TagKeys
CreatePipeline	Gewährt die Berechtigung zum Erstellen einer eindeutig benannten Pipeline	Schreiben	pipeline*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteCustomActionType	Gewährt die Berechtigung zum Löschen einer benutzerdefinierten Aktion	Write	actiontype*
DeletePipeline	Gewährt die Berechtigung zum Löschen einer angegebenen Pipeline	Write	pipeline*
DeleteWebhook	Gewährt die Berechtigung zum Löschen eines angegebenen Webhooks	Write	webhook*
DeregisterWebhookWithThirdParty	Gewährt die Berechtigung, die Registrierung eines Webhooks bei dem in der Konfiguration angegebenen Drittanbieter zu entfernen	Write	webhook*
DisableStageTransition	Gewährt die Berechtigung, zu verhindern, dass Revisionen zum nächsten Schritt in einer Pipeline überzugehen	Write	stage*
EnableStageTransition	Gewährt die Berechtigung, zu gewähren, dass Revisionen zum nächsten Schritt in einer Pipeline übergehen	Schreiben	stage*
GetActionType	Gewährt die Berechtigung zum Abrufen von Informationen zu einer Aktion.	Lesen
GetJobDetails	Gewährt die Berechtigung zum Anzeigen von Informationen zu einem Auftrag (nur benutzerdefinierte Aktionen)	Read
GetPipeline	Gewährt die Berechtigung zum Abrufen von Informationen zur Struktur einer Pipeline	Read	pipeline*
GetPipelineExecution	Gewährt die Berechtigung zum Anzeigen von Informationen zur Ausführung einer Pipeline, einschließlich Details zu Artefakten, Pipeline-Ausführungs-ID sowie Name, Version und Status der Pipeline	Read	pipeline*
GetPipelineState	Gewährt die Berechtigung zum Anzeigen von Informationen über den aktuellen Status der Phasen und Aktionen einer Pipeline	Read	pipeline*
GetThirdPartyJobDetails	Gewährt die Berechtigung zum Anzeigen der Details eines Auftrags für eine Drittanbieteraktion (nur Partneraktionen)	Read
ListActionExecutions	Gewährt die Berechtigung zum Auflisten der Aktionsausführungen, die in einer Pipeline aufgetreten sind	Read	pipeline*
ListActionTypes	Gewährt die Berechtigung, eine Zusammenfassung aller Aktionstypen aufzulisten, die für Pipelines in Ihrem Konto verfügbar sind	Read
ListPipelineExecutions	Gewährt die Berechtigung zum Auflisten einer Zusammenfassung der letzten Ausführungen für eine Pipeline	Auflisten	pipeline*
ListPipelines	Erteilt die Berechtigung, eine Zusammenfassung aller Pipelines aufzulisten, die mit Ihrem AWS-Konto	Auflisten
ListTagsForResource	Erteilt die Berechtigung, Tags für eine CodePipeline Ressource aufzulisten	Lesen	actiontype
			pipeline
			webhook
ListWebhooks	Erteilt die Erlaubnis, alle Webhooks aufzulisten, die mit Ihrem verknüpft sind AWS-Konto	Auflisten	webhook*
PollForJobs	Erteilt die Erlaubnis, Informationen über Jobs einzusehen, CodePipeline auf die Sie reagieren können	Schreiben	actiontype*
PollForThirdPartyJobs	Gewährt die Berechtigung, zu bestimmen, ob für einen Worker auszuführende Aufträge von Drittanbietern vorhanden ist (nur Partneraktionen)	Write
PutActionRevision	Gewährt die Berechtigung zum Bearbeiten von Aktionen in einer Pipeline	Schreiben	action*
PutApprovalResult	Erteilt die Berechtigung, eine Antwort (Genehmigt oder Abgelehnt) auf eine manuelle Genehmigungsanfrage in zu geben CodePipeline	Schreiben	action*
PutJobFailureResult	Gewährt die Berechtigung zur Darstellung des Fehlschlagens eines Auftrags, wie dies von einem Worker an die Pipeline zurückgegeben wurde (nur benutzerdefinierte Aktionen)	Write
PutJobSuccessResult	Gewährt die Berechtigung zur Darstellung des Erfolgs eines Auftrags, wie dies von einem Worker an die Pipeline zurückgegeben wurde (nur benutzerdefinierte Aktionen)	Write
PutThirdPartyJobFailureResult	Gewährt die Berechtigung zur Darstellung des Fehlschlagens eines Drittanbieterauftrags, wie dies von einem Worker an die Pipeline zurückgegeben wurde (nur Partneraktionen)	Write
PutThirdPartyJobSuccessResult	Gewährt die Berechtigung zur Darstellung des Erfolgs eines Drittanbieterauftrags, wie dies von einem Worker an die Pipeline zurückgegeben wurde (nur Partneraktionen)	Write
PutWebhook	Gewährt die Berechtigung zum Erstellen oder Aktualisieren eines Webhooks	Schreiben	pipeline*
			webhook*
				aws:RequestTag/${TagKey} aws:TagKeys
RegisterWebhookWithThirdParty	Gewährt die Berechtigung, einen Webhook bei dem in seiner Konfiguration angegebenen Drittanbieter zu registrieren	Write	webhook*
RetryStageExecution	Gewährt die Berechtigung, die Pipeline-Ausführung fortzusetzen, indem die letzten fehlgeschlagenen Aktionen in einer Phase erneut versucht werden	Schreiben	stage*
RollbackStage	Erteilt die Berechtigung, die Phase auf eine vorherige erfolgreiche Ausführung zurückzusetzen	Schreiben	stage*
StartPipelineExecution	Gewährt die Berechtigung zum Ausführen der letzten Revision über die Pipeline	Write	pipeline*
StopPipelineExecution	Gewährt die Berechtigung zum Beenden einer laufenden Pipeline-Ausführung	Schreiben	pipeline*
TagResource	Erteilt die Berechtigung, eine Ressource zu taggen CodePipeline	Tagging	actiontype
			pipeline
			webhook
				aws:RequestTag/${TagKey} aws:TagKeys
UntagResource	Erteilt die Erlaubnis, ein Tag aus einer CodePipeline Ressource zu entfernen	Tagging	actiontype
			pipeline
			webhook
				aws:TagKeys
UpdateActionType	Gewährt die Berechtigung zum Aktualisieren einer Aktion.	Schreiben	actiontype*
UpdatePipeline	Gewährt die Berechtigung zum Aktualisieren einer Pipeline mit Änderungen an der Struktur der Pipeline	Schreiben	pipeline*

Von AWS CodePipeline 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
action	arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}/${StageName}/${ActionName}	aws:ResourceTag/${TagKey}
actiontype	arn:${Partition}:codepipeline:${Region}:${Account}:actiontype:${Owner}/${Category}/${Provider}/${Version}	aws:ResourceTag/${TagKey}
pipeline	arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}	aws:ResourceTag/${TagKey}
stage	arn:${Partition}:codepipeline:${Region}:${Account}:${PipelineName}/${StageName}	aws:ResourceTag/${TagKey}
webhook	arn:${Partition}:codepipeline:${Region}:${Account}:webhook:${WebhookName}	aws:ResourceTag/${TagKey}

Bedingungsschlüssel für AWS CodePipeline

AWS CodePipeline 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 Aktionen basierend auf dem Vorhandensein von Tag-Schlüssel-Wert-Paaren in der Anforderung.	Zeichenfolge
aws:ResourceTag/${TagKey}	Filtert Aktionen basierend auf den Tag-Schlüssel-Wert-Paaren, die an die Ressource angefügt wurden.	Zeichenfolge
aws:TagKeys	Filtert Aktionen basierend auf dem Vorhandensein von Tag-Schlüsseln in der Anforderung.	ArrayOfString