As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Conecte-se a AWS IoT Core endpoints de serviço
Você pode acessar os recursos do **plano de controle AWS IoT Core-** usando o AWS CLI AWS SDK do seu idioma preferido ou chamando diretamente a API REST. Recomendamos usar o AWS CLI ou um AWS SDK para interagir, AWS IoT Core pois eles incorporam as melhores práticas para AWS serviços de chamadas. Chamar as APIs REST diretamente é uma opção, mas você deve fornecer [as credenciais de segurança necessárias](https://docs.aws.amazon.com//general/latest/gr/signing_aws_api_requests.html) para permitir o acesso à API.
**nota**
Os dispositivos de IoT devem usar [AWS IoT SDKs de dispositivos](iot-connect-devices.md#iot-connect-device-sdks). Os Device SDKs são otimizados para uso em dispositivos, oferecem suporte à comunicação MQTT e às AWS IoT APIs mais usadas pelos dispositivos. AWS IoT Para obter mais informações sobre os SDKs de dispositivos e os recursos que eles oferecem, consulte [AWS IoT SDKs de dispositivos](iot-connect-devices.md#iot-connect-device-sdks).
Os dispositivos móveis devem usar [AWS SDKs móveis](#iot-connect-mobile-sdks). Os SDKs móveis fornecem suporte para AWS IoT APIs, comunicações de dispositivos MQTT e APIs de outros AWS serviços em dispositivos móveis. Para obter mais informações sobre os SDKs móveis e os recursos que eles oferecem, consulte [AWS SDKs móveis](#iot-connect-mobile-sdks).
Você pode usar AWS Amplify ferramentas e recursos em aplicativos móveis e da Web para se conectar com mais facilidade AWS IoT Core. Para obter mais informações sobre como se conectar AWS IoT Core usando o Amplify, consulte [PubSub](https://docs.amplify.aws/react/build-a-backend/add-aws-services/pubsub/)a documentação do Amplify.
As seções a seguir descrevem as ferramentas e os SDKs que você pode usar para desenvolver e interagir com AWS IoT outros AWS serviços. Para ver a lista completa de AWS ferramentas e kits de desenvolvimento disponíveis para criar e gerenciar aplicativos AWS, consulte [Ferramentas para criar AWS](https://aws.amazon.com/tools/).
## AWS CLI for AWS IoT Core
O AWS CLI fornece acesso por linha de comando às AWS APIs.
+
**Instalação**
Para obter informações sobre como instalar o AWS CLI, consulte [Instalando AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/cli-chap-install.html) o.
+
**Autenticação**
O AWS CLI usa as credenciais do seu. Conta da AWS
+
**Referência**
Para obter informações sobre os AWS CLI comandos desses AWS IoT Core serviços, consulte:
+ [AWS CLI Referência de comandos para IoT](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html)
+ [AWS CLI Referência de comando para dados de IoT](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-data/index.html)
+ [AWS CLI Referência de comando para dados de trabalhos de IoT](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot-jobs-data/index.html)
+ [AWS CLI Referência de comando para tunelamento seguro de IoT](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iotsecuretunneling/index.html)
Para obter ferramentas para gerenciar AWS serviços e recursos no ambiente PowerShell de script, consulte [AWS Ferramentas para PowerShell](https://aws.amazon.com/powershell/).
## AWS SDKs
Com AWS os SDKs, seus aplicativos e dispositivos compatíveis podem chamar AWS IoT APIs e APIs de outros serviços. AWS Esta seção fornece links para os AWS SDKs e para a documentação de referência da API para as APIs dos AWS IoT Core serviços.
**A ferramenta AWS Os SDKs oferecem suporte a esses AWS IoT Core APIs**
+ [AWS IoT](https://docs.aws.amazon.com//iot/latest/apireference/welcome.html)
+ [AWS IoT Plano de dados](https://docs.aws.amazon.com//iot/latest/apireference/welcome.html)
+ [AWS IoT Plano de dados de trabalhos](https://docs.aws.amazon.com//iot/latest/apireference/welcome.html)
+ [AWS IoT Tunelamento seguro](https://docs.aws.amazon.com//iot/latest/apireference/welcome.html)
+ [AWS IoT Sem fio](https://docs.aws.amazon.com/iot-wireless/latest/apireference/welcome.html)
------
#### [ C\+\+ ]
**Para instalar o [AWS SDK para C\+\+](https://aws.amazon.com/sdk-for-cpp/) e use-o para se conectar a AWS IoT:**
1. Siga as instruções em [Introdução ao uso do AWS SDK para C\+\+](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/getting-started.html)
Essas instruções descrevem como:
+ Instalar e compilar o SDK dos arquivos de origem
+ Fornecer credenciais para usar o SDK com sua Conta da AWS
+ Inicializar e desligar o SDK em seu aplicativo ou serviço
+ Criar um projeto CMake para compilar seu aplicativo ou serviço
1. Criar e executar um aplicativo de exemplo. Para exemplos de aplicativos que usam o SDK da AWS para C\+\+ [Exemplos de códigos do AWS SDK para C\+\+](https://docs.aws.amazon.com/sdk-for-cpp/v1/developer-guide/programming-services.html).
**Documentação para o AWS IoT Core serviços que o AWS SDK para C\+\+ compatível**
+ [Documentação de referência de AWS::IoTClient"](https://sdk.amazonaws.com/cpp/api/LATEST/root/html/index.html)
+ [Aws:IoTDataPlane:: documentação IoTDataPlaneClient de referência](http://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_io_t_data_plane_1_1_io_t_data_plane_client.html)
+ [Aws:IoTJobsDataPlane:: documentação IoTJobsDataPlaneClient de referência](http://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_io_t_jobs_data_plane_1_1_io_t_jobs_data_plane_client.html)
+ [Aws:IoTSecureTunneling:: documentação IoTSecureTunnelingClient de referência](http://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_io_t_secure_tunneling_1_1_io_t_secure_tunneling_client.html)
------
#### [ Go ]
**Para instalar o [AWS SDK para Go](https://aws.amazon.com/sdk-for-go/) e use-o para se conectar a AWS IoT:**
1. Siga as instruções em [Introdução ao AWS SDK para Go](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/setting-up.html)
Essas instruções descrevem como:
+ Instale o AWS SDK para Go
+ Obter chaves de acesso para que o SDK acesse sua Conta da AWS
+ Importar pacotes para o código-fonte de nossos aplicativos ou serviços
1. Criar e executar um aplicativo de exemplo. Para ver exemplos de aplicativos que usam o AWS SDK para Go, consulte [Exemplos de códigos do AWS SDK para Go](https://docs.aws.amazon.com/sdk-for-go/v1/developer-guide/common-examples.html).
**Documentação para o AWS IoT Core serviços que o AWS SDK para Go compatível**
+ [Documentação de referência de IoT](https://docs.aws.amazon.com/sdk-for-go/api/service/iot/)
+ [IoTDataPlane documentação de referência](https://docs.aws.amazon.com/sdk-for-go/api/service/iotdataplane/)
+ [IoTJobsDataPlane documentação de referência](https://docs.aws.amazon.com/sdk-for-go/api/service/iotjobsdataplane/)
+ [IoTSecureTunneling documentação de referência](https://docs.aws.amazon.com/sdk-for-go/api/service/iotsecuretunneling/)
------
#### [ Java ]
**Para instalar o [AWS SDK para Java](https://aws.amazon.com/sdk-for-java/) e use-o para se conectar a AWS IoT:**
1. Siga as instruções em [Introdução ao AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/getting-started.html)
Essas instruções descrevem como:
+ Inscreva-se AWS e crie um usuário do IAM
+ Fazer download do SDK
+ Configurar AWS credenciais e região
+ Usar o SDK com o Apache Maven
+ Usar o SDK com o Gradle
1. Criar e executar um aplicativo de exemplo usando um dos [Códigos de exemplo do AWS SDK for Java 2.x](https://docs.aws.amazon.com/sdk-for-java/v2/developer-guide/advanced-topics.html).
1. Analisar a [Documentação de referência da API SDK](https://sdk.amazonaws.com/java/api/latest/)
**Documentação para o AWS IoT Core serviços que o AWS SDK para Java compatível**
+ [IotClient documentação de referência](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/iot/IotClient.html)
+ [IotDataPlaneClient documentação de referência](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/iotdataplane/IotDataPlaneClient.html)
+ [IotJobsDataPlaneClient documentação de referência](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/iotjobsdataplane/IotJobsDataPlaneClient.html)
+ [IoTSecureTunnelingClient documentação de referência](https://sdk.amazonaws.com/java/api/latest/software/amazon/awssdk/services/iotsecuretunneling/IoTSecureTunnelingClient.html)
------
#### [ JavaScript ]
**Para instalar o AWS SDK para JavaScript e use-o para se conectar a AWS IoT:**
1. Siga as instruções em [Configurar o AWS SDK para JavaScript](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/setting-up.html). Essas instruções se aplicam ao uso do AWS SDK para JavaScript no navegador e com Node.JS. Siga as instruções que se aplicam à sua instalação.
Essas instruções descrevem como:
+ Verificar os pré-requisitos
+ Instale o SDK para JavaScript
+ Carregue o SDK para JavaScript
1. Criar e executar um aplicativo de exemplo para começar a usar o SDK, conforme descrito na opção de introdução do seu ambiente.
+ Comece a usar o [AWS SDK JavaScript no navegador](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/getting-started-browser.html) ou
+ Comece a usar o [AWS SDK para JavaScript Node.js](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/getting-started-nodejs.html)
**Documentação para o AWS IoT Core serviços que o AWS SDK para JavaScript compatível**
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Iot.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/Iot.html)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IotData.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IotData.html)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IoTJobsDataPlane.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IoTJobsDataPlane.html)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IoTSecureTunneling.html](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IoTSecureTunneling.html)
------
#### [ .NET ]
**Para instalar o [AWS SDK para .NET](https://aws.amazon.com/sdk-for-net/) e use-o para se conectar a AWS IoT:**
1. Siga as instruções em [Configurando seu AWS SDK para .NET ambiente](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-setup.html)
1. Siga as instruções em [Configurando seu AWS SDK para .NET projeto](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/net-dg-config.html)
Essas instruções descrevem como:
+ Iniciar um novo projeto
+ Obter e configurar AWS credenciais
+ Instalar AWS pacotes do SDK
1. Crie e execute um dos programas de amostra em [Trabalhando com AWS serviços no AWS SDK for .NET](https://docs.aws.amazon.com/sdk-for-net/latest/developer-guide/tutorials-examples.html)
1. Analisar a [Documentação de referência da API SDK](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html)
**Documentação para o AWS IoT Core serviços que o AWS SDK para .NET compatível**
+ [Amazon.IoT.Model documentação de referência](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoT/NIoTModel.html)
+ [Amazon.IotData.Model documentação de referência](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IotData/NIotDataModel.html)
+ [Amazon.IoTJobsDataPlane.Model documentação de referência](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoTJobsDataPlane/NIoTJobsDataPlaneModel.html)
+ [Amazon.IoTSecureTunneling.Model documentação de referência](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/items/IoTSecureTunneling/NIoTSecureTunnelingModel.html)
------
#### [ PHP ]
**Para instalar o [AWS SDK para PHP](https://aws.amazon.com/sdk-for-php/) e use-o para se conectar a AWS IoT:**
1. Siga as instruções em [Introdução à AWS SDK para PHP versão 3](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/getting-started_index.html)
Essas instruções descrevem como:
+ Verificar os pré-requisitos
+ Instalar o SDK
+ Aplicar o SDK a um script PHP
1. Criar e executar um aplicativo de exemplo usando um dos [Códigos de exemplo do AWS SDK para PHP Versão 3](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/examples_index.html)
**Documentação para o AWS IoT Core serviços que o AWS SDK para PHP compatível**
+ [Documentação de referência de IoTClient](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.Iot.IotClient.html)
+ [IoTDataPlaneClient documentação de referência](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.IotDataPlane.IotDataPlaneClient.html)
+ [IoTJobsDataPlaneClient documentação de referência](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.IoTJobsDataPlane.IoTJobsDataPlaneClient.html)
+ [IoTSecureTunnelingClient documentação de referência](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.IoTSecureTunneling.IoTSecureTunnelingClient.html)
------
#### [ Python ]
**Para instalar o [AWS SDK para Python (Boto3)](https://aws.amazon.com/sdk-for-python/) e use-o para se conectar a AWS IoT:**
1. Siga as instruções em [Início rápido do AWS SDK para Python (Boto3)](https://boto3.amazonaws.com/v1/documentation/api/latest/guide/quickstart.html)
Essas instruções descrevem como:
+ Instalar o SDK
+ Configurar o SDK
+ Usar o SDK no seu código
1. Criar e executar um programa de exemplo que usa o AWS SDK para Python (Boto3)
Esse programa exibe as opções de registro atualmente configuradas da conta. Depois de instalar o SDK e configurá-lo para sua conta, você deverá conseguir executar esse programa.
```
import boto3
import json
# initialize client
iot = boto3.client('iot')
# get current logging levels, format them as JSON, and write them to stdout
response = iot.get_v2_logging_options()
print(json.dumps(response, indent=4))
```
Para obter mais informações sobre a função usada nesse exemplo, consulte [Configurar AWS IoT registro em log](configure-logging.md).
**Documentação para o AWS IoT Core serviços que o AWS SDK para Python (Boto3) compatível**
+ [Documentação de referência de IoT](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iot.html)
+ [IoTDataPlane documentação de referência](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iot-data.html)
+ [IoTJobsDataPlane documentação de referência](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iot-jobs-data.html)
+ [IoTSecureTunneling documentação de referência](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/iotsecuretunneling.html)
------
#### [ Ruby ]
**Para instalar o [AWS SDK para Ruby](https://aws.amazon.com/sdk-for-ruby/) e use-o para se conectar a AWS IoT:**
+ Siga as instruções em [Introdução ao AWS SDK para Ruby](https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/getting-started.html)
Essas instruções descrevem como:
+ Instalar o SDK
+ Configurar o SDK
+ Criar e executar o [tutorial Olá, mundo](https://docs.aws.amazon.com/sdk-for-ruby/v3/developer-guide/hello.html)
**Documentação para o AWS IoT Core serviços que o AWS Compatível com SDK for Ruby**
+ [Documentação de referência de Aws::IoT::Client](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoT/Client.html)
+ [Aws:IoTDataPlane: :Documentação de referência do cliente](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTDataPlane/Client.html)
+ [Aws:IoTJobsDataPlane: :Documentação de referência do cliente](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTJobsDataPlane/Client.html)
+ [Aws:IoTSecureTunneling: :Documentação de referência do cliente](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/IoTSecureTunneling/Client.html)
------
## AWS SDKs móveis
Os SDKs AWS móveis fornecem aos desenvolvedores de aplicativos móveis suporte específico da plataforma para as APIs dos serviços AWS IoT Core , a comunicação de dispositivos de IoT usando o MQTT e as APIs de outros serviços. AWS
------
#### [ Android ]
**AWS Mobile SDK para Android**
AWS Mobile SDK para Android Ele contém uma biblioteca, exemplos e documentação para os desenvolvedores criarem aplicativos móveis conectados usando AWS. Esse SDK também inclui suporte para comunicações de dispositivos MQTT e chamadas de APIs dos serviços. AWS IoT Core Para saber mais, consulte:
+ [AWS SDK móvel para Android ativado GitHub](https://github.com/aws/aws-sdk-android)
+ [AWS SDK móvel para Android Readme](https://github.com/aws-amplify/aws-sdk-android/blob/main/README.md#aws-sdk-for-android)
+ [AWS Exemplos de SDK móvel para Android](https://github.com/awslabs/aws-sdk-android-samples#aws-sdk-for-android-samples)
+ [AWS Referência da API do SDK for Android](https://aws-amplify.github.io/aws-sdk-android/docs/reference/)
+ [AWSIoTClient Documentação de referência de classe](https://aws-amplify.github.io/aws-sdk-android/docs/reference/com/amazonaws/services/iot/AWSIotClient.html)
------
#### [ iOS ]
**AWS Mobile SDK for iOS**
O AWS Mobile SDK for iOS é um kit de desenvolvimento de software de código aberto, distribuído sob uma licença Apache Open Source. O SDK para iOS fornece uma biblioteca, exemplos de código e documentação para ajudar os desenvolvedores a criar aplicativos móveis conectados usando o. AWS Esse SDK também inclui suporte para comunicações de dispositivos MQTT e chamadas de APIs dos serviços. AWS IoT Core Para saber mais, consulte:
+ [AWS Mobile SDK for iOS em GitHub](https://github.com/aws/aws-sdk-ios)
+ [AWS SDK para iOS Readme](https://github.com/aws-amplify/aws-sdk-ios/blob/main/README.md#aws-sdk-for-ios)
+ [AWS Amostras do SDK para iOS](https://github.com/awslabs/aws-sdk-ios-samples#the-aws-sdk-for-ios-samples)
+ [AWS IoT Documentos de referência de classe no AWS SDK para iOS](https://aws-amplify.github.io/aws-sdk-ios/docs/reference/AWSIoT/index.html)
------
## APIs REST do AWS IoT Core serviços
As APIs REST dos AWS IoT Core serviços podem ser chamadas diretamente usando solicitações HTTP.
+
**URL do endpoint**
Os endpoints de serviço que expõem as APIs REST dos serviços do AWS IoT Core variam conforme a região e estão listados em [Endpoints e cotas do AWS IoT Core](https://docs.aws.amazon.com//general/latest/gr/iot-core.html). Você deve usar o endpoint da região que tem os AWS IoT recursos que você deseja acessar, porque AWS IoT os recursos são específicos da região.
+
**Autenticação**
As APIs REST dos AWS IoT Core serviços usam credenciais AWS do IAM para autenticação. Para obter mais informações, consulte [Assinatura de solicitações da AWS API](https://docs.aws.amazon.com//general/latest/gr/signing_aws_api_requests.html) na Referência AWS geral.
+
**Referência de API**
Para obter informações sobre as funções específicas fornecidas pelas APIs REST dos AWS IoT Core serviços, consulte:
+ [Referência de API para IoT](https://docs.aws.amazon.com//iot/latest/apireference/API_Operations_AWS_IoT.html).
+ [Referência de API para dados de IoT](https://docs.aws.amazon.com//iot/latest/apireference/API_Operations_AWS_IoT_Data_Plane.html).
+ [Referência de API para dados de trabalhos de IoT](https://docs.aws.amazon.com//iot/latest/apireference/API_Operations_AWS_IoT_Jobs_Data_Plane.html).
+ [Referência de API para encapsulamento seguro de IoT](https://docs.aws.amazon.com//iot/latest/apireference/API_Operations_AWS_IoT_Secure_Tunneling.html).