

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Administrar una transmisión en la nube AWS
<a name="mqtt-based-file-delivery-managing"></a>

AWS IoT proporciona el AWS SDK y AWS CLI los comandos que puede usar para administrar una transmisión en la AWS nube. Puede utilizar estas métricas para hacer lo siguiente:
+ Crear una transmisión. [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)
+ Describir una transmisión para obtener su información. [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)
+ Enumere las transmisiones en su Cuenta de 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)
+ Actualizar la lista de archivos o la descripción de la transmisión en una transmisión. [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)
+ Eliminar una transmisión. [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**  
En este momento, las transmisiones no están visibles en la Consola de administración de AWS. Debe usar el AWS SDK AWS CLI o el SDK para administrar una transmisión AWS IoT. Además, el [SDK para Embedded C](https://github.com/aws/aws-iot-device-sdk-embedded-C) es el único SDK que admite transferencias de archivos basadas en MQTT.

Antes de utilizar la entrega de archivos AWS IoT basada en MQTT desde sus dispositivos, debe asegurarse de que se cumplen las siguientes condiciones en sus dispositivos, como se muestra en las siguientes secciones:
+ Una política que refleje los permisos correctos necesarios para transmitir datos a través de MQTT.
+ El dispositivo se puede conectar a la puerta de enlace de AWS IoT dispositivos.
+ Una declaración de política que indique que puede etiquetar los recursos. Si se llama a `CreateStream` con etiquetas, entonces `iot:TagResource` es obligatorio.

Antes de utilizar la entrega de archivos AWS IoT basada en MQTT desde sus dispositivos, debe seguir los pasos de las siguientes secciones para asegurarse de que los dispositivos están debidamente autorizados y se pueden conectar a AWS IoT Device Gateway. 

## Conceder permisos a sus dispositivos
<a name="mqtt-based-file-delivery-permissions"></a>

Puede seguir los pasos que se indican en [Crear una política AWS IoT](https://docs.aws.amazon.com//iot/latest/developerguide/create-iot-resources.html#create-iot-policy) para crear una política de dispositivos o usar una política de dispositivos existente. Adjunte la política a los certificados asociados a sus dispositivos y añada los siguientes permisos a la política del 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/*"
            ]
        }
    ]
}
```

## Conecta tus dispositivos a AWS IoT
<a name="mqtt-based-file-delivery-connect-devices"></a>

Es necesario conectar los dispositivos que utilizan la entrega de archivos AWS IoT basada en MQTT. AWS IoT AWS IoT La entrega de archivos basada AWS IoT en MQTT se integra con la AWS nube, por lo que sus dispositivos deberían conectarse directamente al [punto final del plano de AWS IoT datos](https://docs.aws.amazon.com//iot/latest/apireference/Welcome.html#Welcome_AWS_IoT_Data_Plane). 

**nota**  
El punto final del plano de AWS IoT datos es específico de la región Cuenta de AWS y. Debe usar el punto de conexión para Cuenta de AWS la región en la que están registrados sus dispositivos AWS IoT.

Para obtener más información, consulte [Connect to AWS IoT Core](connect-to-iot.md).

## TagResource Uso
<a name="mqtt-based-file-delivery-tag-resource"></a>

La acción de la API `CreateStream` crea una transmisión para entregar uno o varios archivos grandes en trozos a través de MQTT.

Una llamada a la API `CreateStream` correcta requiere los siguientes permisos:
+ `iot:CreateStream`
+ `iot:TagResource`( si `CreateStream` es con etiquetas)

La política que respalda esos dos permisos se muestra a continuación:

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": {
        "Action": [
            "iot:CreateStream",
            "iot:TagResource"
        ],
        "Effect": "Allow",
        "Resource": "arn:aws:iot:us-east-1:123456789012:stream/streamId"
    }
}
```

La acción de declaración de política `iot:TagResource` es necesaria para garantizar que un usuario no pueda crear o actualizar una etiqueta en un recurso sin los permisos adecuados. Sin la acción de declaración de política específica de `iot:TagResource`, la llamada a la API `CreateStream` devolverá un `AccessDeniedException` si la solicitud viene con etiquetas.

Para obtener más información, consulte los siguientes enlaces:
+ [CreateStream](https://docs.aws.amazon.com//iot/latest/apireference/API_CreateStream.html)
+ [TagResource](https://docs.aws.amazon.com//iot/latest/apireference/API_TagResource.html)
+ [Etiqueta](https://docs.aws.amazon.com//iot/latest/apireference/API_Tag.html)