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.
AWS IoT TwinMaker und Schnittstellen-VPC-Endpunkte (AWS PrivateLink)
Sie können eine private Verbindung zwischen Ihrer Virtual Private Cloud (VPC) herstellen und AWS IoT TwinMaker einen Schnittstellen-VPC-Endpunkt erstellen. Schnittstellenendpunkte werden von betrieben AWS PrivateLink
Jeder Schnittstellenendpunkt wird durch eine oder mehrere Elastic-Network-Schnittstellen in Ihren Subnetzen dargestellt.
Weitere Informationen finden Sie unter Schnittstellen-VPC-Endpunkte (AWS PrivateLink) im Amazon-VPC-Benutzerhandbuch.
Überlegungen für AWS IoT TwinMaker VPC-Endpunkte
Bevor Sie einen Schnittstellen-VPC-Endpunkt für einrichten AWS IoT TwinMaker, lesen Sie die Eigenschaften und Einschränkungen von Schnittstellenendpunkten im Amazon VPC-Benutzerhandbuch.
AWS IoT TwinMaker unterstützt Aufrufe aller API-Aktionen von Ihrer VPC aus.
-
Verwenden Sie für API-Operationen auf Datenebene den folgenden Endpunkt:
data.iottwinmaker.region.amazonaws.com.rproxy.goskope.comDie API-Operationen auf Datenebene umfassen Folgendes:
-
Verwenden Sie für die API-Operationen auf der Steuerungsebene den folgenden Endpunkt:
api.iottwinmaker.region.amazonaws.com.rproxy.goskope.comZu den unterstützten API-Vorgängen für die Steuerungsebene gehören die folgenden:
Erstellen eines Schnittstellen-VPC-Endpunkts für AWS IoT TwinMaker
Sie können einen VPC-Endpunkt für den AWS IoT TwinMaker Service erstellen, indem Sie entweder die Amazon VPC-Konsole oder die AWS Command Line Interface () verwenden.AWS CLI Weitere Informationen finden Sie unter Erstellung eines Schnittstellenendpunkts im Benutzerhandbuch für Amazon VPC.
Erstellen Sie dafür einen VPC-Endpunkt AWS IoT TwinMaker , der den folgenden Servicenamen verwendet.
-
Verwenden Sie für API-Operationen auf Datenebene den folgenden Dienstnamen:
com.amazonaws.region.iottwinmaker.data -
Verwenden Sie für API-Operationen auf der Steuerungsebene den folgenden Dienstnamen:
com.amazonaws.region.iottwinmaker.api
Wenn Sie privates DNS für den Endpunkt aktivieren, können Sie API-Anfragen an diesen richten, AWS IoT TwinMaker indem Sie den Standard-DNS-Namen für die Region verwenden, iottwinmaker.us-east-1.amazonaws.com z. B.
Weitere Informationen finden Sie unter Zugriff auf einen Service über einen Schnittstellenendpunkt im Benutzerhandbuch für Amazon VPC.
AWS IoT TwinMaker PrivateLink wird in den folgenden Regionen unterstützt:
us-east-1
Der ControlPlane Dienst wird in den folgenden Verfügbarkeitszonen unterstützt:
use1-az1use1-az2, unduse1-az6.Der DataPlane Dienst wird in den folgenden Verfügbarkeitszonen unterstützt:
use1-az1use1-az2, unduse1-az4.us-west-2
Die DataPlane Dienste ControlPlane und werden in den folgenden Verfügbarkeitszonen unterstützt:
usw2-az1usw2-az2, undusw2-az3.eu-west-1
eu-central-1
ap-southeast-1
ap-southeast-2
Weitere Informationen zu Verfügbarkeitszonen finden Sie unter Verfügbarkeitszonen-IDs für Ihre AWS Ressourcen — AWS Resource Access Manager.
Zugriff AWS IoT TwinMaker über einen Schnittstellen-VPC-Endpunkt
Wenn Sie einen Schnittstellenendpunkt erstellen, AWS IoT TwinMaker generiert dieser endpunktspezifische DNS-Hostnamen, mit denen Sie kommunizieren können. AWS IoT TwinMaker Die private DNS-Option ist standardmäßig aktiviert. Weitere Informationen finden Sie unter Verwenden von privat gehosteten Zonen im Amazon VPC-Benutzerhandbuch.
Wenn Sie privates DNS für den Endpunkt aktivieren, können Sie API-Anfragen AWS IoT TwinMaker über einen der folgenden VPC-Endpunkte stellen.
-
Verwenden Sie für die API-Operationen auf Datenebene den folgenden Endpunkt.
regionErsetzen Sie durch Ihre AWS Region.data.iottwinmaker.region.amazonaws.com -
Verwenden Sie für die API-Operationen der Steuerungsebene den folgenden Endpunkt.
regionErsetzen Sie durch Ihre AWS Region.api.iottwinmaker.region.amazonaws.com
Wenn Sie das private DNS für den Endpunkt deaktivieren, müssen Sie Folgendes tun, um AWS IoT TwinMaker über den Endpunkt darauf zuzugreifen:
-
Geben Sie die VPC-Endpunkt-URL in API-Anfragen an.
-
Verwenden Sie für die API-Operationen auf Datenebene die folgende Endpunkt-URL. Ersetzen Sie
vpc-endpoint-idundregiondurch Ihre VPC-Endpunkt-ID und Region.vpc-endpoint-id.data.iottwinmaker.region.vpce.amazonaws.com -
Verwenden Sie für die API-Operationen der Kontrollebene die folgende Endpunkt-URL. Ersetzen Sie
vpc-endpoint-idundregiondurch Ihre VPC-Endpunkt-ID und Region.vpc-endpoint-id.api.iottwinmaker.region.vpce.amazonaws.com
-
-
Deaktivieren Sie die Hostpräfix-Injektion. Die AWS CLI und AWS SDKs stellen dem Dienstendpunkt verschiedene Hostpräfixe voran, wenn Sie jeden API-Vorgang aufrufen. Dies führt dazu, dass die AWS SDKs AWS CLI und ungültige URLs erzeugen, AWS IoT TwinMaker wenn Sie einen VPC-Endpunkt angeben.
Wichtig
Sie können die Hostpräfix-Injektion in AWS CLI oder nicht deaktivieren. AWS -Tools für PowerShell Das bedeutet, dass Sie, wenn Sie privates DNS deaktiviert haben, den VPC-Endpunkt nicht verwenden AWS CLI oder AWS IoT TwinMaker über ihn AWS -Tools für PowerShell darauf zugreifen können. Wenn Sie diese Tools für den Zugriff AWS IoT TwinMaker über den Endpunkt verwenden möchten, aktivieren Sie privates DNS.
Weitere Informationen zum Deaktivieren der Hostpräfix-Injektion in den AWS SDKs finden Sie in den folgenden Dokumentationsabschnitten für jedes SDK:
Weitere Informationen finden Sie unter Zugriff auf einen Service über einen Schnittstellenendpunkt im Benutzerhandbuch für Amazon VPC.
Erstellen einer VPC-Endpunktrichtlinie für AWS IoT TwinMaker
Sie können eine Endpunktrichtlinie an Ihren VPC-Endpunkt anhängen, der den Zugriff auf AWS IoT TwinMaker steuert. Die Richtlinie gibt die folgenden Informationen an:
-
Prinzipal, der die Aktionen ausführen kann.
-
Aktionen, die ausgeführt werden können
-
Die Ressourcen, für die Aktionen ausgeführt werden können.
Weitere Informationen finden Sie unter Steuerung des Zugriffs auf Services mit VPC-Endpunkten im Amazon-VPC-Benutzerhandbuch.
Beispiel: VPC-Endpunktrichtlinie für AWS IoT TwinMaker actions
Das Folgende ist ein Beispiel für eine Endpunktrichtlinie für AWS IoT TwinMaker. Wenn diese Richtlinie an einen Endpunkt angehängt ist, gewährt sie dem IAM-Benutzer iottwinmakeradmin im AWS Konto Zugriff auf die aufgelisteten AWS IoT TwinMaker Aktionen 123456789012 auf allen Ressourcen.
{ "Statement":[ { "Principal": { "AWS": "arn:aws:iam::123456789012:user/role" }, "Resource": "*", "Effect":"Allow", "Action":[ "iottwinmaker:CreateEntity", "iottwinmaker:GetScene", "iottwinmaker:ListEntities" ] } ] }
