# Ejemplos de VOD de MediaPackage que utilizan la AWS CLI
<a name="cli_mediapackage-vod_code_examples"></a>

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios habituales mediante el AWS Command Line Interface con VOD de MediaPackage.

Las *acciones* son extractos de código de programas más grandes y deben ejecutarse en contexto. Mientras las acciones muestran cómo llamar a las distintas funciones de servicio, es posible ver las acciones en contexto en los escenarios relacionados.

En cada ejemplo se incluye un enlace al código de origen completo, con instrucciones de configuración y ejecución del código en el contexto.

**Topics**
+ [Acciones](#actions)

## Acciones
<a name="actions"></a>

### `create-asset`
<a name="mediapackage-vod_CreateAsset_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-asset`.

**AWS CLI**  
**Para crear un activo**  
En el siguiente ejemplo de `create-asset`, se crea un activo llamado `Chicken_Asset` en la cuenta actual de AWS. El activo ingiere el archivo `30sec_chicken.smil` en MediaPackage.  

```
aws mediapackage-vod create-asset \
    --id chicken_asset \
    --packaging-group-id hls_chicken_gp \
    --source-role-arn arn:aws:iam::111122223333:role/EMP_Vod \
    --source-arn arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil
```
Salida:  

```
{
    "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:assets/chicken_asset",
    "Id":"chicken_asset",
    "PackagingGroupId":"hls_chicken_gp",
    "SourceArn":"arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil",
    "SourceRoleArn":"arn:aws:iam::111122223333:role/EMP_Vod",
    "EgressEndpoints":[
        {
            "PackagingConfigurationId":"New_config_1",
            "Url":"https://c75ea2668ab49d02bca7ae10ef31c59e.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/6644b55df1744261ab3732a8e5cdaf07/904b06a58c7645e08d57d40d064216ac/f5b2e633ff4942228095d164c10074f3/index.m3u8"
        },
        {
            "PackagingConfigurationId":"new_hls",
            "Url":" https://c75ea2668ab49d02bca7ae10ef31c59e.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/6644b55df1744261ab3732a8e5cdaf07/fe8f1f00a80e424cb4f8da4095835e9e/7370ec57432343af816332356d2bd5c6/string.m3u8"
        }
    ]
}
```
Para obtener más información, consulte [Ingest an Asset](https://docs.aws.amazon.com/mediapackage/latest/ug/asset-create.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [CreateAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/create-asset.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-packaging-configuration`
<a name="mediapackage-vod_CreatePackagingConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-packaging-configuration`.

**AWS CLI**  
**Para crear una configuración de empaquetado**  
En el siguiente ejemplo de `create-packaging-configuration`, se crea una configuración de empaquetado llamada `new_hls` en el grupo de empaquetado llamado `hls_chicken`. En este ejemplo se utiliza un archivo en el disco llamado `hls_pc.json` para proporcionar los detalles.  

```
aws mediapackage-vod create-packaging-configuration \
    --id new_hls \
    --packaging-group-id hls_chicken \
    --hls-package file://hls_pc.json
```
Contenido de `hls_pc.json`:  

```
{
    "HlsManifests":[
        {
            "AdMarkers":"NONE",
            "IncludeIframeOnlyStream":false,
            "ManifestName":"string",
            "ProgramDateTimeIntervalSeconds":60,
            "RepeatExtXKey":true,
            "StreamSelection":{
                "MaxVideoBitsPerSecond":1000,
                "MinVideoBitsPerSecond":0,
                "StreamOrder":"ORIGINAL"
            }
        }
    ],
    "SegmentDurationSeconds":6,
    "UseAudioRenditionGroup":false
}
```
Salida:  

```
{
    "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/new_hls",
    "Id":"new_hls",
    "PackagingGroupId":"hls_chicken",
    "HlsManifests":{
        "SegmentDurationSeconds":6,
        "UseAudioRenditionGroup":false,
        "HlsMarkers":[
            {
                "AdMarkers":"NONE",
                "IncludeIframeOnlyStream":false,
                "ManifestName":"string",
                "ProgramDateTimeIntervalSeconds":60,
                "RepeatExtXKey":true,
                "StreamSelection":{
                    "MaxVideoBitsPerSecond":1000,
                    "MinVideoBitsPerSecond":0,
                    "StreamOrder":"ORIGINAL"
                }
            }
        ]
    }
}
```
Para obtener más información, consulte [Creating a Packaging Configuration](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-cfig-create.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [CreatePackagingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/create-packaging-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `create-packaging-group`
<a name="mediapackage-vod_CreatePackagingGroup_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `create-packaging-group`.

**AWS CLI**  
**Para crear un grupo de empaquetado**  
En el siguiente ejemplo de `create-packaging-group`, se muestran todos los grupos de empaquetado que están configurados en la cuenta actual de AWS.  

```
aws mediapackage-vod create-packaging-group \
    --id hls_chicken
```
Salida:  

```
{
    "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/hls_chicken",
    "Id": "hls_chicken"
}
```
Para obtener más información, consulte [Creating a Packaging Group](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-group-create.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [CreatePackagingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/create-packaging-group.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-asset`
<a name="mediapackage-vod_DeleteAsset_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-asset`.

**AWS CLI**  
**Para eliminar un activo**  
En el siguiente ejemplo de `delete-asset`, se elimina el activo llamado `30sec_chicken`.  

```
aws mediapackage-vod delete-asset \
    --id 30sec_chicken
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Deleting an Asset](https://docs.aws.amazon.com/mediapackage/latest/ug/asset-delete.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [DeleteAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/delete-asset.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-packaging-configuration`
<a name="mediapackage-vod_DeletePackagingConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-packaging-configuration`.

**AWS CLI**  
**Para eliminar una configuración de empaquetado**  
En el siguiente ejemplo de `delete-packaging-configuration`, se elimina la configuración de empaquetado llamada `CMAF`.  

```
aws mediapackage-vod delete-packaging-configuration \
    --id CMAF
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Deleting a Packaging Configuration](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-cfig-delete.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [DeletePackagingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/delete-packaging-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `delete-packaging-group`
<a name="mediapackage-vod_DeletePackagingGroup_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `delete-packaging-group`.

**AWS CLI**  
**Para eliminar un grupo de empaquetado**  
En el siguiente ejemplo de `delete-packaging-group`, se elimina el grupo de empaquetado llamado `Dash_widevine`.  

```
aws mediapackage-vod delete-packaging-group \
    --id Dash_widevine
```
Este comando no genera ninguna salida.  
Para obtener más información, consulte [Deleting a Packaging Group](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-group-delete.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [DeletePackagingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/delete-packaging-group.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-asset`
<a name="mediapackage-vod_DescribeAsset_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-asset`.

**AWS CLI**  
**Para describir un activo**  
En el siguiente ejemplo de `describe-asset`, se muestran todos los detalles del activo llamado `30sec_chicken`.  

```
aws mediapackage-vod describe-asset \
    --id 30sec_chicken
```
Salida:  

```
{
    "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:assets/30sec_chicken",
    "Id":"30sec_chicken",
    "PackagingGroupId":"Packaging_group_1",
    "SourceArn":"arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil",
    "SourceRoleArn":"arn:aws:iam::111122223333:role/EMP_Vod",
    "EgressEndpoints":[
        {
            "PackagingConfigurationId":"DASH",
            "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/66c25aff456d463aae0855172b3beb27/4ddfda6da17c4c279a1b8401cba31892/index.mpd"
        },
        {
            "PackagingConfigurationId":"HLS",
            "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/6e5bf286a3414254a2bf0d22ae148d7e/06b5875b4d004c3cbdc4da2dc4d14638/index.m3u8"
        },
        {
            "PackagingConfigurationId":"CMAF",
            "Url":"https://a5f46a44118ba3e3724ef39ef532e701.egress.mediapackage-vod.us-west-2.amazonaws.com/out/v1/aad7962c569946119c2d5a691be5663c/628fb5d8d89e4702958b020af27fde0e/05eb062214064238ad6330a443aff7f7/index.m3u8"
        }
    ]
}
```
Para obtener más información, consulte [Viewing Asset Details](https://docs.aws.amazon.com/mediapackage/latest/ug/asset-view.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [DescribeAsset](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/describe-asset.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-packaging-configuration`
<a name="mediapackage-vod_DescribePackagingConfiguration_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-packaging-configuration`.

**AWS CLI**  
**Para describir una configuración de empaquetado**  
En el siguiente ejemplo de `describe-packaging-configuration`, se muestran todos los detalles de la configuración de empaquetado llamada `DASH`.  

```
aws mediapackage-vod describe-packaging-configuration \
    --id DASH
```
Salida:  

```
{
    "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/DASH",
    "Id":"DASH",
    "PackagingGroupId":"Packaging_group_1",
    "DashPackage":[
        {
            "SegmentDurationSeconds":"2"
        },
        {
            "DashManifests":{
                "ManifestName":"index",
                "MinBufferTimeSeconds":"30",
                "Profile":"NONE"
            }
        }
    ]
}
```
Para obtener más información, consulte [Viewing Packaging Configuration Details](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-cfig-view.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [DescribePackagingConfiguration](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/describe-packaging-configuration.html) en la *Referencia de comandos de la AWS CLI*. 

### `describe-packaging-group`
<a name="mediapackage-vod_DescribePackagingGroup_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `describe-packaging-group`.

**AWS CLI**  
**Para describir un grupo de empaquetado**  
En el siguiente ejemplo de `describe-packaging-group`, se muestran todos los detalles del grupo de de empaquetado llamado `Packaging_group_1`.  

```
aws mediapackage-vod describe-packaging-group \
    --id Packaging_group_1
```
Salida:  

```
{
    "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Packaging_group_1",
    "Id": "Packaging_group_1"
}
```
Para obtener más información, consulte [Viewing Packaging Group Details](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-group-view.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [DescribePackagingGroup](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/describe-packaging-group.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-assets`
<a name="mediapackage-vod_ListAssets_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-assets`.

**AWS CLI**  
**Para enumerar todos los activos**  
En el siguiente ejemplo de `list-assets`, se muestran todos los activos que están configurados en la cuenta actual de AWS.  

```
aws mediapackage-vod list-assets
```
Salida:  

```
{
    "Assets": [
        "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:assets/30sec_chicken",
        "Id": "30sec_chicken",
        "PackagingGroupId": "Packaging_group_1",
        "SourceArn": "arn:aws:s3::111122223333:video-bucket/A/30sec_chicken.smil",
        "SourceRoleArn": "arn:aws:iam::111122223333:role/EMP_Vod"
    ]
}
```
Para obtener más información, consulte [Viewing Asset Details](https://docs.aws.amazon.com/mediapackage/latest/ug/asset-view.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [ListAssets](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/list-assets.html) en la *Referencia de comandos de la AWS CLI*. 

### `list-packaging-configurations`
<a name="mediapackage-vod_ListPackagingConfigurations_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-packaging-configurations`.

**AWS CLI**  
**Para enumerar todas las configuraciones de empaquetado**  
En el siguiente ejemplo de `list-packaging-configurations`, se muestran todas las configuraciones de empaquetado que están configuradas en el grupo de empaquetado llamado `Packaging_group_1`.  

```
aws mediapackage-vod list-packaging-configurations \
    --packaging-group-id Packaging_group_1
```
Salida:  

```
{
    "PackagingConfigurations":[
        {
            "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/CMAF",
            "Id":"CMAF",
            "PackagingGroupId":"Packaging_group_1",
            "CmafPackage":[
                {
                    "SegmentDurationSeconds":"2"
                },
                {
                    "HlsManifests":{
                        "AdMarkers":"NONE",
                        "RepeatExtXKey":"False",
                        "ManifestName":"index",
                        "ProgramDateTimeIntervalSeconds":"0",
                        "IncludeIframeOnlyStream":"False"
                    }
                }
            ]
        },
        {
            "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/DASH",
            "Id":"DASH",
            "PackagingGroupId":"Packaging_group_1",
            "DashPackage":[
                {
                    "SegmentDurationSeconds":"2"
                },
                {
                    "DashManifests":{
                        "ManifestName":"index",
                        "MinBufferTimeSeconds":"30",
                        "Profile":"NONE"
                    }
                }
            ]
        },
        {
            "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/HLS",
            "Id":"HLS",
            "PackagingGroupId":"Packaging_group_1",
            "HlsPackage":[
                {
                    "SegmentDurationSeconds":"6",
                    "UseAudioRenditionGroup":"False"
                },
                {
                    "HlsManifests":{
                        "AdMarkers":"NONE",
                        "RepeatExtXKey":"False",
                        "ManifestName":"index",
                        "ProgramDateTimeIntervalSeconds":"0",
                        "IncludeIframeOnlyStream":"False"
                    }
                }
            ]
        },
        {
            "Arn":"arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-configurations/New_config_0_copy",
            "Id":"New_config_0_copy",
            "PackagingGroupId":"Packaging_group_1",
            "HlsPackage":[
                {
                    "SegmentDurationSeconds":"6",
                    "UseAudioRenditionGroup":"False"
                },
                {
                    "Encryption":{
                        "EncryptionMethod":"AWS_128",
                        "SpekeKeyProvider":{
                           "RoleArn":"arn:aws:iam:111122223333::role/SPEKERole",
                            "Url":"https://lfgubdvs97.execute-api.us-west-2.amazonaws.com/EkeStage/copyProtection/",
                            "SystemIds":[
                                "81376844-f976-481e-a84e-cc25d39b0b33"
                            ]
                        }
                    }
                },
                {
                    "HlsManifests":{
                        "AdMarkers":"NONE",
                        "RepeatExtXKey":"False",
                        "ManifestName":"index",
                        "ProgramDateTimeIntervalSeconds":"0",
                        "IncludeIframeOnlyStream":"False"
                    }
                }
            ]
        }
    ]
}
```
Para obtener más información, consulte [Viewing Packaging Configuration Details](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-cfig-view.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener más información sobre la API, consulte [ListPackagingConfigurations](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/list-packaging-configurations.html) en *Referencia de comandos de la AWS CLI*. 

### `list-packaging-groups`
<a name="mediapackage-vod_ListPackagingGroups_cli_topic"></a>

En el siguiente ejemplo de código, se muestra cómo utilizar `list-packaging-groups`.

**AWS CLI**  
**Para enumerar todos los grupos de empaquetado**  
En el siguiente ejemplo de `list-packaging-groups`, se muestran todos los grupos de empaquetado que están configurados en la cuenta actual de AWS.  

```
aws mediapackage-vod list-packaging-groups
```
Salida:  

```
{
    "PackagingGroups": [
        {
            "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Dash_widevine",
            "Id": "Dash_widevine"
        },
        {
            "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Encrypted_HLS",
            "Id": "Encrypted_HLS"
        },
        {
            "Arn": "arn:aws:mediapackage-vod:us-west-2:111122223333:packaging-groups/Packaging_group_1",
            "Id": "Packaging_group_1"
        }
    ]
}
```
Para obtener más información, consulte [Viewing Packaging Group Details](https://docs.aws.amazon.com/mediapackage/latest/ug/pkg-group-view.html) en la *Guía del usuario de AWS Elemental MediaPackage*.  
+  Para obtener información sobre la API, consulte [ListPackagingGroups](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage-vod/list-packaging-groups.html) en la *Referencia de comandos de la AWS CLI*.