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 *VPC-Schnittstellen-Endpunkt* erstellen. Schnittstellenendpunkte werden mit Strom versorgt [AWS PrivateLink](https://aws.amazon.com/privatelink), sodass Sie privat auf AWS IoT TwinMaker APIs zugreifen können, ohne dass ein Internet-Gateway, ein NAT-Gerät (Network Address Translation), eine VPN-Verbindung oder eine AWS Direct Connect-Verbindung erforderlich ist. AWS IoT TwinMaker unterstützt über seine Schnittstellenendpunkte sowohl IPv4 als auch IPv6 (Dual-Stack). Instances in Ihrer VPC benötigen keine öffentlichen IP-Adressen, um mit AWS IoT TwinMaker APIs zu kommunizieren. Datenverkehr zwischen Ihrer VPC und dem, der das Amazon-Netzwerk AWS IoT TwinMaker nicht verlässt.
Jeder Schnittstellenendpunkt wird durch eine oder mehrere [Elastic-Network-Schnittstellen](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html) in Ihren Subnetzen dargestellt.
Weitere Informationen finden Sie unter [Schnittstellen-VPC-Endpunkte (AWS PrivateLink)](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html) im *Amazon-VPC-Benutzerhandbuch*.
## Überlegungen zu AWS IoT TwinMaker VPC-Endpunkte
Bevor Sie einen Schnittstellen-VPC-Endpunkt für einrichten AWS IoT TwinMaker, lesen Sie die [Eigenschaften und Einschränkungen des Schnittstellen-Endpunkts](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#vpce-interface-limitations) 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
```
Die API-Operationen auf der Datenebene umfassen Folgendes:
+ [GetPropertyValue](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValue.html)
+ [GetPropertyValueHistory](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetPropertyValueHistory.html)
+ [BatchPutPropertyValues](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_BatchPutPropertyValues.html)
+ Verwenden Sie für die API-Operationen auf der Steuerungsebene den folgenden Endpunkt:
```
api.iottwinmaker.{{region}}.amazonaws.com
```
Zu den unterstützten API-Vorgängen auf der Kontrollebene gehören:
+ [CreateComponentType](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CreateComponentType.html)
+ [CreateEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CreateEntity.html)
+ [CreateScene](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CreateScene.html)
+ [CreateWorkspace](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CreateWorkspace.html)
+ [DeleteComponentType](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DeleteComponentType.html)
+ [DeleteEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DeleteEntity.html)
+ [DeleteScene](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DeleteScene.html)
+ [DeleteWorkspace](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_DeleteWorkspace.html)
+ [GetComponentType](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetComponentType.html)
+ [GetEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetEntity.html)
+ [GetScene](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetScene.html)
+ [GetWorkspace](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetWorkspace.html)
+ [ListComponentTypes](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListComponentTypes.html)
+ [ListComponentTypes](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListComponentTypes.html)
+ [ListEntities](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListEntities.html)
+ [ListScenes](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListScenes.html)
+ [ListTagsForResource](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListTagsForResource.html)
+ [ListWorkspaces](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListWorkspaces.html)
+ [TagResource](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_TagResource.html)
+ [UntagResource](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_UntagResource.html)
+ [UpdateComponentType](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_UpdateComponentType.html)
+ [UpdateEntity](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_UpdateEntity.html)
+ [UpdateScene](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_UpdateScene.html)
+ [UpdateWorkspace](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_UpdateWorkspace.html)
## 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 ()AWS CLI verwenden. Weitere Informationen finden Sie unter [Erstellung eines Schnittstellenendpunkts](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#create-interface-endpoint) im *Benutzerhandbuch für Amazon VPC*.
Erstellen Sie einen VPC-Endpunkt AWS IoT TwinMaker , der den folgenden Dienstnamen verwendet.
+ Verwenden Sie für API-Operationen auf Datenebene den folgenden Dienstnamen:
```
com.amazonaws.{{region}}.iottwinmaker.data
```
+ Verwenden Sie für API-Operationen auf Steuerungsebene den folgenden Dienstnamen:
```
com.amazonaws.{{region}}.iottwinmaker.api
```
Wenn Sie privates DNS für den Endpunkt aktivieren, können Sie API-Anfragen an 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](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#access-service-though-endpoint) 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-az1``use1-az2`, und`use1-az6`.
Der DataPlane Dienst wird in den folgenden Verfügbarkeitszonen unterstützt: `use1-az1``use1-az2`, und`use1-az4`.
+ **us-west-2**
Die DataPlane Dienste ControlPlane und werden in den folgenden Verfügbarkeitszonen unterstützt: `usw2-az1``usw2-az2`, und`usw2-az3`.
+ **eu-west-1**
+ **eu-central-1**
+ **ap-southeast-1**
+ **ap-southeast-2**
Weitere Informationen zu Availability Zones finden Sie unter [Availability Zone IDs für Ihre AWS Ressourcen — AWS Resource Access Manager](https://docs.aws.amazon.com/ram/latest/userguide/working-with-az-ids.html).
## Zugriff AWS IoT TwinMaker über einen VPC-Endpunkt mit Schnittstelle
AWS IoT TwinMaker Generiert beim Erstellen eines Schnittstellenendpunkts 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](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-dns.html#vpc-private-hosted-zones) im *Amazon VPC-Benutzerhandbuch*.
Wenn Sie privates DNS für den Endpunkt aktivieren, können Sie API-Anfragen an einen AWS IoT TwinMaker der folgenden VPC-Endpunkte stellen.
+ Verwenden Sie für die API-Operationen auf der Datenebene den folgenden Endpunkt. {{region}}Ersetzen Sie es durch Ihre AWS Region.
```
data.iottwinmaker.{{region}}.amazonaws.com
```
+ Verwenden Sie für die API-Operationen auf der Kontrollebene den folgenden Endpunkt. {{region}}Ersetzen Sie es durch Ihre AWS Region.
```
api.iottwinmaker.{{region}}.amazonaws.com
```
Wenn Sie privates DNS für den Endpunkt deaktivieren, müssen Sie für den Zugriff AWS IoT TwinMaker über den Endpunkt wie folgt vorgehen:
+ Geben Sie die VPC-Endpunkt-URL in API-Anfragen an.
+ Verwenden Sie für die API-Operationen auf der Datenebene die folgende Endpunkt-URL. Ersetzen Sie {{vpc-endpoint-id}} und {{region}} durch Ihre VPC-Endpunkt-ID und Region.
```
{{vpc-endpoint-id}}.data.iottwinmaker.{{region}}.vpce.amazonaws.com
```
+ Verwenden Sie für die API-Operationen auf der Kontrollebene die folgende Endpunkt-URL. Ersetzen Sie {{vpc-endpoint-id}} und {{region}} durch Ihre VPC-Endpunkt-ID und Region.
```
{{vpc-endpoint-id}}.api.iottwinmaker.{{region}}.vpce.amazonaws.com
```
+ Deaktivieren Sie die Host-Präfix-Injektion. Die AWS SDKs AWS CLI und stellen dem Service-Endpunkt verschiedene Host-Präfixe voran, wenn Sie die einzelnen API-Operationen 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äfixinjektion in AWS CLI oder nicht deaktivieren. AWS -Tools für PowerShell Das heißt, wenn Sie privates DNS deaktiviert haben, können Sie den VPC-Endpunkt nicht verwenden AWS CLI oder AWS IoT TwinMaker über ihn AWS -Tools für PowerShell darauf zugreifen. Wenn Sie diese Tools für den Zugriff AWS IoT TwinMaker über den Endpunkt verwenden möchten, aktivieren Sie privates DNS.
Weitere Informationen zur Deaktivierung der Hostpräfixinjektion in den AWS SDKs finden Sie in den folgenden Dokumentationsabschnitten für jedes SDK:
+ [AWS SDK für C\+\+](https://sdk.amazonaws.com/cpp/api/LATEST/struct_aws_1_1_client_1_1_client_configuration.html#a3579c1a2f2e1c9d54e99c59d27643499)
+ [AWS SDK für Go](https://docs.aws.amazon.com/sdk-for-go/api/aws/#Config.WithDisableEndpointHostPrefix)
+ [AWS SDK für Go](https://docs.aws.amazon.com/sdk-for-go/v2/developer-guide/configure-endpoints.html#migration) v2
+ [AWS SDK für Java](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/ClientConfiguration.html#setDisableHostPrefixInjection-boolean-)
+ [AWS SDK for Java 2.x](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/core/client/config/SdkAdvancedClientOption.html)
+ [AWS SDK für JavaScript](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Config.html#hostPrefixEnabled-property)
+ [AWS SDK für .NET](https://docs.aws.amazon.com/sdkfornet/v4/apidocs/items/Runtime/TClientConfig.html)
+ [AWS SDK für PHP](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.AwsClient.html#___construct)
+ [AWS SDK für Python (Boto3)](https://botocore.amazonaws.com/v1/documentation/api/latest/reference/config.html)
+ [AWS SDK für Ruby](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTSiteWise/Client.html#initialize-instance_method)
Weitere Informationen finden Sie unter [Zugriff auf einen Service über einen Schnittstellenendpunkt](https://docs.aws.amazon.com/vpc/latest/userguide/vpce-interface.html#access-service-though-endpoint) 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](https://docs.aws.amazon.com/vpc/latest/userguide/vpc-endpoints-access.html) im *Amazon-VPC-Benutzerhandbuch*.
**Beispiel: VPC-Endpunktrichtlinie für AWS IoT TwinMaker actions**
Im Folgenden finden Sie 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}}"
]
}
]
}
```