View a markdown version of this page

AWS IoT TwinMaker e interfacciano gli endpoint VPC (AWS PrivateLink) - AWS IoT TwinMaker
Considerazioni per AWS IoT TwinMaker Endpoint VPCCreazione di un endpoint VPC di interfaccia per AWS IoT TwinMakerAccesso AWS IoT TwinMaker tramite un'interfaccia (endpoint VPC)Creazione di una policy sugli endpoint VPC per AWS IoT TwinMaker

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWS IoT TwinMaker e interfacciano gli endpoint VPC (AWS PrivateLink)

Puoi stabilire una connessione privata tra il tuo cloud privato virtuale (VPC) e creando un endpoint VPC AWS IoT TwinMaker di interfaccia. Gli endpoint di interfaccia sono alimentati da AWS PrivateLink, che puoi utilizzare per accedere privatamente alle AWS IoT TwinMaker API senza un gateway Internet, un dispositivo NAT (Network Address Translation), una connessione VPN o una connessione Direct Connect. AWS AWS IoT TwinMaker supporta sia IPv4 che IPv6 (dual-stack) tramite i suoi endpoint di interfaccia. Le istanze del tuo VPC non necessitano di indirizzi IP pubblici per comunicare con le API. AWS IoT TwinMaker Il traffico tra il tuo VPC e quello in uscita AWS IoT TwinMaker dalla rete Amazon.

Ogni endpoint dell'interfaccia è rappresentato da una o più interfacce di rete elastiche nelle sottoreti.

Per ulteriori informazioni, consultare Endpoint VPC di interfaccia (AWS PrivateLink) nella Guida per l'utente di Amazon VPC.

Considerazioni per AWS IoT TwinMaker Endpoint VPC

Prima di configurare un endpoint VPC di interfaccia per AWS IoT TwinMaker, consulta le proprietà e le limitazioni degli endpoint di interfaccia nella Amazon VPC User Guide.

AWS IoT TwinMaker supporta l'esecuzione di chiamate a tutte le sue azioni API dal tuo VPC.

Creazione di un endpoint VPC di interfaccia per AWS IoT TwinMaker

Puoi creare un endpoint VPC per il AWS IoT TwinMaker servizio utilizzando la console Amazon VPC o (). AWS Command Line Interface AWS CLI Per ulteriori informazioni, consultare Creazione di un endpoint di interfaccia nella Guida per l’utente di Amazon VPC.

Crea un endpoint VPC AWS IoT TwinMaker che utilizzi il seguente nome di servizio.

  • Per le operazioni API del piano dati, utilizza il seguente nome di servizio: 

    com.amazonaws.region.iottwinmaker.data

  • Per le operazioni API del piano di controllo, utilizza il seguente nome di servizio: 

    com.amazonaws.region.iottwinmaker.api

Se abiliti il DNS privato per l'endpoint, puoi effettuare richieste API AWS IoT TwinMaker utilizzando il nome DNS predefinito per la regione, ad esempio. iottwinmaker.us-east-1.amazonaws.com

Per ulteriori informazioni, consultare Accesso a un servizio tramite un endpoint di interfaccia in Guida per l'utente di Amazon VPC.

AWS IoT TwinMaker PrivateLink è supportato nelle seguenti regioni:

  • us-east-1

    Il ControlPlane servizio è supportato nelle seguenti zone di disponibilità:use1-az1,use1-az2, euse1-az6.

    Il DataPlane servizio è supportato nelle seguenti zone di disponibilità:use1-az1,use1-az2, euse1-az4.

  • us-west-2

    I DataPlane servizi ControlPlane and sono supportati nelle seguenti zone di disponibilità:usw2-az1,usw2-az2, eusw2-az3.

  • eu-west-1

  • eu-central-1

  • ap-southeast-1

  • ap-southeast-2

Per ulteriori informazioni sulle zone di disponibilità, vedi ID delle zone di disponibilità per AWS le tue AWS risorse - Resource Access Manager.

Accesso AWS IoT TwinMaker tramite un'interfaccia (endpoint VPC)

Quando crei un endpoint di interfaccia, AWS IoT TwinMaker genera nomi host DNS specifici dell'endpoint con cui puoi comunicare. AWS IoT TwinMaker L'opzione DNS privato è abilitata per impostazione predefinita. Per ulteriori informazioni, consulta Using private hosted zones nella Amazon VPC User Guide.

Se abiliti il DNS privato per l'endpoint, puoi effettuare richieste API AWS IoT TwinMaker tramite uno dei seguenti endpoint VPC.

  • Per le operazioni API del piano dati, utilizza il seguente endpoint. Sostituisci region con la tua AWS regione. 

    data.iottwinmaker.region.amazonaws.com

  • Per le operazioni API del piano di controllo, utilizza il seguente endpoint. Sostituisci region con la tua AWS regione. 

    api.iottwinmaker.region.amazonaws.com

Se disabiliti il DNS privato per l'endpoint, devi fare quanto segue per accedere AWS IoT TwinMaker tramite l'endpoint:

  • Specifica l'URL dell'endpoint VPC nelle richieste API.

    • Per le operazioni API del piano dati, utilizza il seguente URL dell'endpoint. Sostituisci vpc-endpoint-id e region con l'ID e la regione dell'endpoint VPC. 

      vpc-endpoint-id.data.iottwinmaker.region.vpce.amazonaws.com

    • Per le operazioni dell'API del piano di controllo, utilizza il seguente URL dell'endpoint. Sostituisci vpc-endpoint-id e region con l'ID e la regione dell'endpoint VPC. 

      vpc-endpoint-id.api.iottwinmaker.region.vpce.amazonaws.com

  • Disabilita l'iniezione del prefisso dell'host. Gli AWS SDK AWS CLI e gli SDK aggiungono all'endpoint del servizio diversi prefissi host quando si chiama ogni operazione API. Ciò fa sì che gli AWS CLI e AWS SDK producano URL non validi per quando si specifica un endpoint VPC. AWS IoT TwinMaker

    Importante

    Non è possibile disabilitare l'inserimento del prefisso host in o. AWS CLI AWS Strumenti per PowerShell Ciò significa che se hai disabilitato il DNS privato, non sarai in grado di utilizzare AWS CLI o AWS Strumenti per PowerShell accedere AWS IoT TwinMaker tramite l'endpoint VPC. Se desideri utilizzare questi strumenti per accedere AWS IoT TwinMaker tramite l'endpoint, abilita il DNS privato.

    Per ulteriori informazioni su come disabilitare l'inserimento del prefisso host negli AWS SDK, consulta le seguenti sezioni di documentazione per ciascun SDK:

Per ulteriori informazioni, consultare Accesso a un servizio tramite un endpoint di interfaccia in Guida per l'utente di Amazon VPC.

Creazione di una policy sugli endpoint VPC per AWS IoT TwinMaker

È possibile allegare un criterio all'endpoint VPC che controlla l'accesso all' AWS IoT TwinMaker. La policy specifica le informazioni riportate di seguito:

  • Il principale che può eseguire operazioni.

  • Le azioni che possono essere eseguite.

  • Le risorse sui cui si possono eseguire operazioni.

Per ulteriori informazioni, consulta Controllo degli accessi ai servizi con endpoint VPC in Guida per l'utente di Amazon VPC.

Esempio: politica sugli endpoint VPC per AWS IoT TwinMaker actions

Di seguito è riportato un esempio di policy sugli endpoint per. AWS IoT TwinMaker Se collegata a un endpoint, questa policy garantisce l'accesso alle AWS IoT TwinMaker azioni elencate per l'utente IAM iottwinmakeradmin nell' AWS account 123456789012 su tutte le risorse.

{
   "Statement":[ 
      {
        "Principal": {
            "AWS": "arn:aws:iam::123456789012:user/role"
                },
         "Resource": "*",
         "Effect":"Allow",
         "Action":[
            "iottwinmaker:CreateEntity",
            "iottwinmaker:GetScene",
            "iottwinmaker:ListEntities"
         ]
        }
    ]
}