Aktionen, Ressourcen und Bedingungsschlüssel für AWS IoT SiteWise

AWS IoT SiteWise (Servicepräfix: iotsitewise) 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 IoT SiteWise 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
AssociateAssets	Gewährt die Berechtigung zur Zuordnung einer untergeordneten Komponente zu einer übergeordneten Komponente in der Hierarchie	Schreiben	asset*
AssociateTimeSeriesToAssetProperty	Gewährt die Berechtigung zum Zuordnen einer Zeitreihe mit einer Komponente	Schreiben	asset*
			time-series*
BatchAssociateProjectAssets	Gewährt die Berechtigung, zur Mapping einer Komponente zu einem Projekt	Write	project*
BatchDisassociateProjectAssets	Gewährt die Berechtigung zur Aufhebung der Mapping von Assets zu einem bestimmten Projekt	Schreiben	project*
BatchGetAssetPropertyAggregates	Gewährt die Berechtigung zum Abrufen berechneter Aggregate für mehrere Komponenteneigenschaften	Lesen	asset
			time-series
BatchGetAssetPropertyValue	Gewährt die Berechtigung zum Abrufen des neuesten Werts für mehrere Komponenteneigenschaften	Lesen	asset
			time-series
BatchGetAssetPropertyValueHistory	Gewährt die Berechtigung zum Abrufen des Wertverlaufs für mehrere Komponenteneigenschaften	Lesen	asset
			time-series
BatchPutAssetPropertyValue	Gewährt die Berechtigung zum Setzen von Eigenschaftswerten für Komponenteneigenschaften	Write	asset
			time-series
CreateAccessPolicy	Gewährt die Berechtigung zum Erstellen einer Zugriffsrichtlinie für ein bestimmtes Portal oder ein Projekt	Write	portal
			project
				aws:RequestTag/${TagKey} aws:TagKeys
CreateAsset	Gewährt die Berechtigung zum Erstellen einer Komponente aus einem Komponentenmodell	Write	asset-model*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateAssetModel	Gewährt die Berechtigung zum Erstellen eines Komponentenmodells	Schreiben		aws:RequestTag/${TagKey} aws:TagKeys
CreateAssetModelCompositeModel	Gewährt die Berechtigung zum Erstellen eines Komponentenmodells (Verbundmodell) innerhalb eines Komponentenmodells	Schreiben	asset-model*
CreateBulkImportJob	Gewährt die Berechtigung zum Erstellen einer Bulk-Importaufgabe	Schreiben
CreateDashboard	Gewährt die Berechtigung zum Erstellen eines Dashboards in einem Projekt	Write	project*
				aws:RequestTag/${TagKey} aws:TagKeys
CreateGateway	Gewährt die Berechtigung zum Erstellen eines Gateways	Write		aws:RequestTag/${TagKey} aws:TagKeys
CreatePortal	Gewährt die Berechtigung zum Erstellen eines Portals	Write		aws:RequestTag/${TagKey} aws:TagKeys	sso:CreateManagedApplicationInstance sso:DescribeRegisteredRegions
CreateProject	Gewährt die Berechtigung zum Erstellen eines Projekts in einem Portal	Write	portal*
				aws:RequestTag/${TagKey} aws:TagKeys
DeleteAccessPolicy	Gewährt die Berechtigung zum Löschen einer Zugriffsrichtlinie	Write	access-policy*
DeleteAsset	Gewährt die Berechtigung zum Löschen einer Komponente	Write	asset*
DeleteAssetModel	Gewährt die Berechtigung zum Löschen eines Komponentenmodells	Schreiben	asset-model*
DeleteAssetModelCompositeModel	Gewährt die Berechtigung zum Löschen eines Komponentenmodells (Verbundmodell)	Schreiben	asset-model*
DeleteDashboard	Gewährt die Berechtigung zum Löschen eines Dashboards	Write	dashboard*
DeleteGateway	Gewährt die Berechtigung zum Löschen eines Gateways	Write	gateway*
DeletePortal	Gewährt die Berechtigung zum Löschen eines Portals	Write	portal*		sso:DeleteManagedApplicationInstance
DeleteProject	Gewährt die Berechtigung zum Löschen eines Projekts	Schreiben	project*
DeleteTimeSeries	Gewährt die Berechtigung zum Löschen einer Zeitreihe	Schreiben	asset
			time-series
DescribeAccessPolicy	Gewährt die Berechtigung zum Beschreiben einer Zugriffsrichtlinie	Lesen	access-policy*
DescribeAction	Gewährt die Berechtigung zum Beschreiben von Aktionen	Lesen	asset
DescribeAsset	Gewährt die Berechtigung zum beschreiben einer Komponente	Lesen	asset*
DescribeAssetCompositeModel	Gewährt die Berechtigung zum Beschreiben eines Komponentenmodells (Verbundmodell)	Lesen	asset*
DescribeAssetModel	Gewährt die Berechtigung zum Beschreiben eines Komponentenmodells	Lesen	asset-model*
DescribeAssetModelCompositeModel	Gewährt die Berechtigung zum Beschreiben eines Komponentenmodells (Verbundmodell)	Lesen	asset-model*
DescribeAssetProperty	Gewährt die Berechtigung zum Beschreiben einer Asset-Eigenschaft	Lesen	asset*
DescribeBulkImportJob	Gewährt die Berechtigung zum Beschreiben einer Bulk-Importaufgabe	Lesen
DescribeDashboard	Gewährt die Berechtigung zur Beschreibung eines Dashboards	Read	dashboard*
DescribeDefaultEncryptionConfiguration	Gewährt die Berechtigung zum Beschreiben der Standardverschlüsselungskonfiguration für das AWS-Konto	Read
DescribeGateway	Gewährt die Berechtigung zum Beschreiben eines Gateways	Read	gateway*
DescribeGatewayCapabilityConfiguration	Gewährt die Berechtigung zum Beschreiben einer Funktionskonfiguration für ein Gateway	Read	gateway*
DescribeLoggingOptions	Gewährt die Berechtigung zum Beschreiben der Protokollierungsoptionen für das AWS-Konto	Read
DescribePortal	Gewährt die Berechtigung zum Beschreiben eines Portals	Read	portal*
DescribeProject	Gewährt die Berechtigung zum Beschreiben eines Projekts	Lesen	project*
DescribeStorageConfiguration	Gewährt die Berechtigung zum Beschreiben der Standardverschlüsselungskonfiguration für das AWS-Konto	Lesen
DescribeTimeSeries	Gewährt die Berechtigung zum Beschreiben einer Zeitreihe	Lesen	asset
			time-series
				aws:RequestTag/${TagKey} aws:TagKeys
DisassociateAssets	Gewährt die Berechtigung zum Aufheben der Mapping einer untergeordneten Komponente zu einer übergeordneten Komponente in einer Hierarchie	Schreiben	asset*
DisassociateTimeSeriesFromAssetProperty	Gewährt die Berechtigung zum Aufheben der Zuordnung einer Zeitreihe mit einer Komponente	Schreiben	asset*
			time-series*
EnableSiteWiseIntegration [nur Berechtigung]	Gewährt die Berechtigung, IoT SiteWise in andere Dienste integrieren zu lassen	Schreiben
ExecuteAction	Gewährt die Berechtigung zum Ausführen von Aktionen	Schreiben	asset
ExecuteQuery	Gewährt die Berechtigung zum Ausführen einer Abfrage	Lesen
GetAssetPropertyAggregates	Gewährt die Berechtigung zum Abrufen berechneter Aggregate für eine Komponenteneigenschaft	Read	asset
			time-series
GetAssetPropertyValue	Gewährt die Berechtigung zum Abrufen des neuesten Werts für eine Komponenteneigenschaft	Read	asset
			time-series
GetAssetPropertyValueHistory	Gewährt die Berechtigung zum Abrufen der Werthistorie für eine Komponenteneigenschaft	Lesen	asset
			time-series
GetInterpolatedAssetPropertyValues	Gewährt die Berechtigung zum Abrufen des neuesten Werts für eine Komponenteneigenschaft	Lesen	asset
			time-series
ListAccessPolicies	Gewährt die Berechtigung zum Auflisten aller Zugriffsrichtlinien für eine Identität oder eine Ressource	Auflisten	portal
			project
ListActions	Gewährt die Berechtigung zum Auflisten aller Aktionen	Auflisten	asset
ListAssetModelCompositeModels	Gewährt die Berechtigung zum Auflisten aller Komponentenmodelle (Verbundmodelle)	Auflisten	asset-model*
ListAssetModelProperties	Gewährt die Berechtigung zum Auflisten von Komponentenmodelleigenschaften	Auflisten	asset-model*
ListAssetModels	Gewährt die Berechtigung zum Auflisten aller Komponentenmodelle	Auflisten
ListAssetProperties	Gewährt die Berechtigung zum Auflisten von Komponenteneigenschaften	Auflisten	asset*
ListAssetRelationships	Gewährt die Berechtigung zum Auflisten des Komponentenbeziehungsdiagramms für eine Komponente	List	asset*
ListAssets	Gewährt die Berechtigung zum Auflisten aller Komponenten	Auflisten	asset-model
ListAssociatedAssets	Gewährt die Berechtigung zum Auflisten aller Komponenten, die einer Komponente durch eine Hierarchie zugeordnet sind	Auflisten	asset*
ListBulkImportJobs	Gewährt die Berechtigung zum Auflisten von Bulk-Importaufgaben	Auflisten
ListCompositionRelationships	Gewährt die Berechtigung zum Auflisten aller Beziehungen von Komponentenmodellen (Verbundmodelle)	Auflisten	asset-model*
ListDashboards	Gewährt die Berechtigung zum Auflisten aller Dashboards in einem Projekt	List	project*
ListGateways	Gewährt die Berechtigung zum Auflisten aller Gateways	List
ListPortals	Gewährt die Berechtigung zum Auflisten aller Portale	List
ListProjectAssets	Gewährt die Berechtigung zum Auflisten aller Komponenten, die einem Projekt zugeordnet sind	List	project*
ListProjects	Gewährt die Berechtigung zum Auflisten aller Projekte in einem Portal	List	portal*
ListTagsForResource	Gewährt die Berechtigung zum Auflisten aller Tags für eine Ressource	Lesen	access-policy
			asset
			asset-model
			dashboard
			gateway
			portal
			project
			time-series
				aws:ResourceTag/${TagKey}
ListTimeSeries	Gewährt die Berechtigung zum Auflisten von Zeitreihen	Auflisten	asset
PutDefaultEncryptionConfiguration	Gewährt die Berechtigung zum Festlegen der Standardverschlüsselungskonfiguration für das AWS-Konto	Write
PutLoggingOptions	Gewährt die Berechtigung zum Festlegen der Protokollierungsoptionen für das AWS-Konto	Schreiben
PutStorageConfiguration	Gewährt die Berechtigung zum Festlegen einer Speicherkonfiguration für dasAWS-Konto	Schreiben
TagResource	Gewährt die Berechtigung zum Markieren einer Ressource mit Tags	Markieren	access-policy
			asset
			asset-model
			dashboard
			gateway
			portal
			project
			time-series
				aws:TagKeys aws:RequestTag/${TagKey}
UntagResource	Gewährt die Berechtigung zum Aufheben der Markierung einer Ressource	Markieren	access-policy
			asset
			asset-model
			dashboard
			gateway
			portal
			project
			time-series
				aws:TagKeys
UpdateAccessPolicy	Gewährt die Berechtigung zum Aktualisieren einer Zugriffsrichtlinie	Write	access-policy*
UpdateAsset	Gewährt die Berechtigung zum Aktualisieren einer Komponente	Write	asset*
UpdateAssetModel	Gewährt die Berechtigung zum Aktualisieren eines Komponentenmodells	Schreiben	asset-model*
UpdateAssetModelCompositeModel	Gewährt die Berechtigung zum Aktualisieren eines Komponentenmodells (Verbundmodell)	Schreiben	asset-model*
UpdateAssetModelPropertyRouting [nur Berechtigung]	Gewährt die Berechtigung zum Aktualisieren eines AssetModel-Eigenschafts-Routings	Write	asset-model*
UpdateAssetProperty	Gewährt die Berechtigung zum Aktualisieren einer Komponenteneigenschaft	Write	asset*
UpdateDashboard	Gewährt die Berechtigung zum Aktualisieren eines Dashboards	Write	dashboard*
UpdateGateway	Gewährt die Berechtigung zum Aktualisieren eines Gateways	Write	gateway*
UpdateGatewayCapabilityConfiguration	Gewährt die Berechtigung zum Aktualisieren einer Funktionskonfiguration für ein Gateway	Write	gateway*
UpdatePortal	Gewährt die Berechtigung zum Aktualisieren eines Portals	Write	portal*
UpdateProject	Gewährt die Berechtigung zum Aktualisieren eines Projekts	Write	project*

Von AWS IoT SiteWise 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
asset	arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}	aws:ResourceTag/${TagKey}
asset-model	arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}	aws:ResourceTag/${TagKey}
time-series	arn:${Partition}:iotsitewise:${Region}:${Account}:time-series/${TimeSeriesId}	aws:ResourceTag/${TagKey}
gateway	arn:${Partition}:iotsitewise:${Region}:${Account}:gateway/${GatewayId}	aws:ResourceTag/${TagKey}
portal	arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}	aws:ResourceTag/${TagKey}
project	arn:${Partition}:iotsitewise:${Region}:${Account}:project/${ProjectId}	aws:ResourceTag/${TagKey}
dashboard	arn:${Partition}:iotsitewise:${Region}:${Account}:dashboard/${DashboardId}	aws:ResourceTag/${TagKey}
access-policy	arn:${Partition}:iotsitewise:${Region}:${Account}:access-policy/${AccessPolicyId}	aws:ResourceTag/${TagKey}

Bedingungsschlüssel für AWS IoT SiteWise

AWS IoT SiteWise 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 durch die Tag-Schlüssel-Wert-Paare in der Anforderung	Zeichenfolge
aws:ResourceTag/${TagKey}	Filtert den Zugriff über die Tags, die an die Ressource angehängt sind.	Zeichenfolge
aws:TagKeys	Filtert Aktionen nach den Tag-Schlüsseln in der Anforderung	ArrayOfString
iotsitewise:assetHierarchyPath	Filtert den Zugriff nach einem Komponentenhierarchiepfad, bei dem es sich um die Zeichenfolge der Komponenten-IDs in der Komponentenhierarchie handelt, die jeweils durch einen Schrägstrich getrennt sind.	Zeichenfolge
iotsitewise:childAssetId	Filtert den Zugriff nach der ID einer untergeordneten Komponente, die einer übergeordneten Komponente zugeordnet ist	Zeichenfolge
iotsitewise:group	Filtert den Zugriff nach der ID einer AWS-Single-Sign-On-Gruppe	Zeichenfolge
iotsitewise:iam	Filtert den Zugriff nach der ID einer AWS-IAM-Identität	Zeichenfolge
iotsitewise:isAssociatedWithAssetProperty	Filtert den Zugriff nach Datenströmen, die mit Komponenten-Eigenschaften verknüpft sind oder nicht	Zeichenfolge
iotsitewise:portal	Filtert den Zugriff anhand der ID eines Portals	Zeichenfolge
iotsitewise:project	Filtert den Zugriff anhand der ID eines Projekts	String
iotsitewise:propertyAlias	Filtert den Zugriff nach dem Eigenschafts-Alias	Zeichenfolge
iotsitewise:propertyId	Filtert den Zugriff nach der ID einer Komponenteneigenschaft	Zeichenfolge
iotsitewise:user	Filtert den Zugriff nach der ID eines AWS-Single-Sign-On-Benutzers	Zeichenfolge