Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Aktionen, Ressourcen und Bedingungsschlüssel für AWS IoT Greengrass V2
AWS IoT Greengrass V2 (Servicepräfix: greengrass) 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.
Themen
Von AWS IoT Greengrass V2 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 |
|---|---|---|---|---|---|
| AssociateServiceRoleToAccount | Gewährt die Berechtigung zum Verknüpfen einer Rolle mit Ihrem AWS-Konto. IoT Greengrass verwendet diese Rolle für den Zugriff auf Ihre Lambda-Funktionen und die AWS-IoT-Ressourcen. | Berechtigungsverwaltung |
iam:PassRole |
||
| BatchAssociateClientDeviceWithCoreDevice | Gewährt die Berechtigung zum Zuordnen einer Liste von Clientgeräten an ein Kerngerät | Schreiben | |||
| BatchDisassociateClientDeviceFromCoreDevice | Gewährt die Berechtigung zum Trennen einer Liste von Clientgeräten von einem Kerngerät | Schreiben | |||
| CancelDeployment | Gewährt die Berechtigung zum Abbrechen einer Bereitstellung | Write |
iot:CancelJob iot:DeleteThingShadow iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow iot:UpdateJob iot:UpdateThingShadow |
||
| CreateComponentVersion | Gewährt die Berechtigung zum Erstellen einer Komponente | Write | |||
| CreateDeployment | Gewährt die Berechtigung zum Erstellen einer Bereitstellung | Write |
iot:CancelJob iot:CreateJob iot:DeleteThingShadow iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow iot:UpdateJob iot:UpdateThingShadow |
||
| DeleteComponent | Gewährt die Berechtigung zum Löschen einer Komponente | Write | |||
| DeleteCoreDevice | Gewährt die Berechtigung zum Löschen eines AWS-IoT-Greengrass-Core-Geräts, das ein AWS-IoT-Objekt ist. Durch diesen Vorgang wird das Kerngerät aus der Liste der Kerngeräte entfernt. Das AWS-IoT-Objekt wird nicht gelöscht. | Schreiben |
iot:DescribeJobExecution |
||
| DeleteDeployment | Gewährt die Berechtigung zum Löschen einer Bereitstellung. Um eine aktive Bereitstellung zu löschen, muss sie zuerst abgebrochen werden | Schreiben |
iot:DeleteJob |
||
| DescribeComponent | Gewährt die Berechtigung zum Abrufen von Metadaten für eine Version einer Komponente | Lesen | |||
| DisassociateServiceRoleFromAccount | Gewährt die Berechtigung zum Aufheben der Mapping zwischen der Servicerolle und einem Konto. Ohne Servicerolle funktionieren Bereitstellungen nicht. | Schreiben | |||
| GetComponent | Gewährt die Berechtigung zum Abrufen des Rezepts für eine Version einer Komponente | Read | |||
| GetComponentVersionArtifact | Gewährt die Berechtigung zum Abrufen der vorsignierten URL zum Download eines Artefakts für öffentliche Komponenten | Lesen | |||
| GetConnectivityInfo | Gewährt die Berechtigung zum Abrufen der Verbindungsinformationen für ein Greengrass Core Device | Lesen |
iot:GetThingShadow |
||
| GetCoreDevice | Gewährt die Berechtigung zum Abrufen von Metadaten für ein AWS-IoT-Greengrass-Core-Gerät | Read | |||
| GetDeployment | Gewährt die Berechtigung zum Abrufen einer Bereitstellung | Lesen |
iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow |
||
| GetServiceRoleForAccount | Gewährt die Berechtigung zum Abrufen der Servicerolle, die einem Konto zugeordnet ist. | Lesen | |||
| ListClientDevicesAssociatedWithCoreDevice | Gewährt die Berechtigung zum Abrufen einer paginierten Liste von Client-Geräten, die einem AWS-IoT-Greengrass-Kerngerät zugeordnet sind | Auflisten | |||
| ListComponentVersions | Gewährt die Berechtigung zum Abrufen einer paginierten Liste aller Versionen einer Komponente | List | |||
| ListComponents | Gewährt die Berechtigung zum Abrufen einer paginierten Liste mit Komponentenzusammenfassungen | List | |||
| ListCoreDevices | Gewährt die Berechtigung zum Abrufen einer paginierten Liste mit AWS-IoT-Greengrass-Core-Geräten | List | |||
| ListDeployments | Gewährt die Berechtigung zum Abrufen einer paginierten Liste mit Bereitstellungen | List |
iot:DescribeJob iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow |
||
| ListEffectiveDeployments | Gewährt die Berechtigung zum Abrufen einer paginierten Liste mit Bereitstellungsaufgaben, die AWS IoT Greengrass an AWS-IoT-Greengrass-Core-Geräte sendet | List |
iot:DescribeJob iot:DescribeJobExecution iot:DescribeThing iot:DescribeThingGroup iot:GetThingShadow |
||
| ListInstalledComponents | Gewährt die Berechtigung zum Abrufen einer paginierten Liste der Komponenten, die auf einem AWS-IoT-Greengrass-Core-Gerät ausgeführt werden | List | |||
| ListTagsForResource | Gewährt die Berechtigung zum Auflisten der Tags für eine Ressource | Lesen | |||
| ResolveComponentCandidates | Gewährt die Berechtigung zum Auflisten von Komponenten, die den Anforderungen einer Komponente, Version und Plattform entsprechen | List | |||
| TagResource | Gewährt die Berechtigung zum Hinzufügen von Tags zu einer Ressource. | Markieren | |||
| UntagResource | Gewährt die Berechtigung zum Entfernen von Tags aus einer Ressource | Markieren | |||
| UpdateConnectivityInfo | Gewährt die Berechtigung zum Aktualisieren der Verbindungsinformationen für einen Greengrass Core. Alle Geräte, die zu der Gruppe gehören, die diesen Core enthält, empfangen diese Informationen, um den Speicherort des Cores ermitteln und eine Verbindung zu diesem herzustellen. | Schreiben |
iot:GetThingShadow iot:UpdateThingShadow |
Von AWS IoT Greengrass V2 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 |
|---|---|---|
| connectivityInfo |
arn:${Partition}:greengrass:${Region}:${Account}:/greengrass/things/${ThingName}/connectivityInfo
|
|
| component |
arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}
|
|
| componentVersion |
arn:${Partition}:greengrass:${Region}:${Account}:components:${ComponentName}:versions:${ComponentVersion}
|
|
| coreDevice |
arn:${Partition}:greengrass:${Region}:${Account}:coreDevices:${CoreDeviceThingName}
|
|
| deployment |
arn:${Partition}:greengrass:${Region}:${Account}:deployments:${DeploymentId}
|
Bedingungsschlüssel für AWS IoT Greengrass V2
AWS IoT Greengrass V2 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).
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 enthalten sind | Zeichenfolge |
| aws:ResourceTag/${TagKey} | Filtert den Zugriff durch Überprüfung von Tag-Schlüssel/Wert-Paaren, die einer bestimmten Ressource zugeordnet sind | Zeichenfolge |
| aws:TagKeys | Filtert den Zugriff durch Überprüfung der Tag-Schlüsseln, die in der Anforderung übergeben werden | ArrayOfString |
