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á.
# Gerenciando um stream na AWS nuvem
AWS IoT fornece AWS SDK e AWS CLI comandos que você pode usar para gerenciar um stream na AWS nuvem. Você pode usar esses comandos para fazer o seguinte:
+ Criar um stream. [CLI](https://docs.aws.amazon.com//cli/latest/reference/iot/create-stream.html) / [SDK](https://docs.aws.amazon.com//iot/latest/apireference/API_CreateStream.html)
+ Descreva um stream para obter informações. [CLI](https://docs.aws.amazon.com//cli/latest/reference/iot/describe-stream.html) / [SDK](https://docs.aws.amazon.com//iot/latest/apireference/API_DescribeStream.html)
+ Liste streams em seu. Conta da AWS[CLI](https://docs.aws.amazon.com//cli/latest/reference/iot/list-streams.html) / [SDK](https://docs.aws.amazon.com//iot/latest/apireference/API_ListStreams.html)
+ Atualize a lista de arquivos ou a descrição do stream em um stream. [CLI](https://docs.aws.amazon.com//cli/latest/reference/iot/update-stream.html) / [SDK](https://docs.aws.amazon.com//iot/latest/apireference/API_UpdateStream.html)
+ Exclui um stream. [CLI](https://docs.aws.amazon.com//cli/latest/reference/iot/delete-stream.html) / [SDK](https://docs.aws.amazon.com//iot/latest/apireference/API_DeleteStream.html)
**nota**
No momento, os streams não são visíveis no Console de gerenciamento da AWS. Você deve usar o AWS SDK AWS CLI ou para gerenciar um stream em AWS IoT. Além disso, o [Embedded C SDK](https://github.com/aws/aws-iot-device-sdk-embedded-C) é o único SDK que suporta transferências de arquivos baseadas em MQTT.
Antes de usar a entrega de arquivos AWS IoT baseada em MQTT de seus dispositivos, você deve garantir que as seguintes condições sejam atendidas para seus dispositivos, conforme mostrado nas próximas seções:
+ Uma política que reflete as permissões corretas necessárias para transmitir dados via MQTT.
+ Seu dispositivo pode se conectar ao AWS IoT Device Gateway.
+ Uma declaração de política informando que você pode marcar recursos. Se `CreateStream` for chamado com tags, então `iot:TagResource` é obrigatório.
Antes de usar a entrega de arquivos AWS IoT baseada em MQTT de seus dispositivos, você deve seguir as etapas nas próximas seções para garantir que seus dispositivos estejam devidamente autorizados e possam se conectar ao AWS IoT Device Gateway.
## Conceda permissões aos seus dispositivos
Você pode seguir as etapas em [Criar uma AWS IoT política](https://docs.aws.amazon.com//iot/latest/developerguide/create-iot-resources.html#create-iot-policy) para criar uma política de dispositivo ou usar uma política de dispositivo existente. Anexe a política aos certificados associados aos dispositivos e adicione as permissões a seguir à política do dispositivo.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"iot:Connect"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:client/${iot:Connection.Thing.ThingName}"
]
},
{
"Effect": "Allow",
"Action": [
"iot:Receive",
"iot:Publish"
],
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topic/$aws/things/${iot:Connection.Thing.ThingName}/streams/*"
]
},
{
"Effect": "Allow",
"Action": "iot:Subscribe",
"Resource": [
"arn:aws:iot:us-east-1:123456789012:topicfilter/$aws/things/${iot:Connection.Thing.ThingName}/streams/*"
]
}
]
}
```
## Conecte seus dispositivos a AWS IoT
É necessário se conectar aos dispositivos que usam a entrega de arquivos AWS IoT baseada em MQTT. AWS IoT AWS IoT A entrega de arquivos baseada em MQTT se AWS IoT integra à AWS nuvem, portanto, seus dispositivos devem se conectar diretamente ao [endpoint do plano de dados](https://docs.aws.amazon.com//iot/latest/apireference/Welcome.html#Welcome_AWS_IoT_Data_Plane). AWS IoT
**nota**
O ponto final do plano de AWS IoT dados é específico para a região Conta da AWS e. Você deve usar o endpoint da Conta da AWS e da região na qual seus dispositivos estão registrados. AWS IoT
Consulte [Conecte-se a AWS IoT Core](connect-to-iot.md) para obter mais informações.
## TagResource Uso
O API `CreateStream` cria um fluxo para fornecer um ou mais arquivos grandes em blocos por meio do MQTT.
Uma chamada de API `CreateStream` bem-sucedida requer as seguintes permissões:
+ `iot:CreateStream`
+ `iot:TagResource` (se `CreateStream` estiver com tags)
A política que suporta essas duas permissões é mostrada abaixo:
****
```
{
"Version":"2012-10-17",
"Statement": {
"Action": [
"iot:CreateStream",
"iot:TagResource"
],
"Effect": "Allow",
"Resource": "arn:aws:iot:us-east-1:123456789012:stream/streamId"
}
}
```
A ação da declaração de política `iot:TagResource` é necessária para garantir que um usuário não possa criar ou atualizar uma tag em um recurso sem as permissões adequadas. Sem a ação de declaração de política específica de `iot:TagResource`, a chamada de `CreateStream` API retornará e `AccessDeniedException` se a solicitação vier com tags.
Para obter mais informações, consulte os links a seguir:
+ [CreateStream](https://docs.aws.amazon.com//iot/latest/apireference/API_CreateStream.html)
+ [TagResource](https://docs.aws.amazon.com//iot/latest/apireference/API_TagResource.html)
+ [Tag](https://docs.aws.amazon.com//iot/latest/apireference/API_Tag.html)