MediaPackage ejemplos que utilizan AWS CLI - AWS Command Line Interface
Acciones

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.

MediaPackage ejemplos que utilizan AWS CLI

Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios comunes mediante el uso del AWS Command Line Interface with 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 funciones de servicio individuales, es posible ver las acciones en contexto en los escenarios relacionados.

Cada ejemplo incluye un enlace al código fuente completo, donde puede encontrar instrucciones sobre cómo configurar y ejecutar el código en su contexto.

Acciones

En el siguiente ejemplo de código, se muestra cómo usar create-channel.

AWS CLI

Para crear un canal

El siguiente create-channel comando crea un canal con el nombre sportschannel de la cuenta corriente.

aws mediapackage create-channel --id sportschannel

Salida:

{
   "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0",
   "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "6d345804ec3f46c9b454a91d4a80d0e0",
                "Password": "generatedwebdavpassword1",
                "Url": "https://f31c86aed53b815a.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/6d345804ec3f46c9b454a91d4a80d0e0/channel",
                "Username": "generatedwebdavusername1"
            },
            {
                "Id": "2daa32878af24803b24183727211b8ff",
                "Password": "generatedwebdavpassword2",
                "Url": "https://6ebbe7e04c4b0afa.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/2daa32878af24803b24183727211b8ff/channel",
                "Username": "generatedwebdavusername2"
            }
        ]
    },
    "Id": "sportschannel",
    "Tags": {
        "region": "west"
    }
}

Para obtener más información, consulte Creación de un canal en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte CreateChannella Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar create-origin-endpoint.

AWS CLI

Para crear un punto final de origen

El siguiente create-origin-endpoint comando crea un punto final de origen denominado cmafsports con la configuración del paquete proporcionada en un JSON archivo y la configuración de punto final especificada.

aws mediapackage create-origin-endpoint \
    --channel-id sportschannel \
    --id cmafsports \
    --cmaf-package file://file/path/cmafpkg.json --description "cmaf output of sports" \
    --id cmaf_sports \
    --manifest-name sports_channel \
    --startover-window-seconds 300 \
    --tags region=west,media=sports \
    --time-delay-seconds 10

Salida:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "PASSTHROUGH",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": true,
                "ManifestName": "index",
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 300,
                "ProgramDateTimeIntervalSeconds": 300,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Description": "cmaf output of sports",
    "Id": "cmaf_sports",
    "ManifestName": "sports_channel",
    "StartoverWindowSeconds": 300,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 10,
    "Url": "",
    "Whitelist": []
}

Para obtener más información, consulte Creación de un punto final en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte CreateOriginEndpointla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar delete-channel.

AWS CLI

Para eliminar un canal

El siguiente delete-channel comando elimina el canal nombradotest.

aws mediapackage delete-channel \
    --id test

Este comando no genera ninguna salida.

Para obtener más información, consulte Eliminar un canal en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte DeleteChannella Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar delete-origin-endpoint.

AWS CLI

Para eliminar un punto final de origen

El siguiente delete-origin-endpoint comando elimina el punto final de origen denominadotester2.

aws mediapackage delete-origin-endpoint \
    --id tester2

Para obtener más información, consulte Eliminar un punto final en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte DeleteOriginEndpointla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar describe-channel.

AWS CLI

Para describir un canal

El siguiente describe-channel comando muestra todos los detalles del canal nombradotest.

aws mediapackage describe-channel \
    --id test

Salida:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "584797f1740548c389a273585dd22a63",
                "Password": "webdavgeneratedpassword1",
                "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                "Username": "webdavgeneratedusername1"
            },
            {
                "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                "Password": "webdavgeneratedpassword2",
                "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                "Username": "webdavgeneratedusername2"
            }
        ]
    },
    "Id": "test",
    "Tags": {}
}

Para obtener más información, consulte Visualización de los detalles del canal< https://docs.aws.amazon.com/mediapackage/ latest/ug/channels-view.html> en la Guía del usuario de Elemental AWS MediaPackage

  • Para obtener API más información, DescribeChannelconsulte AWS CLI la Referencia de comandos.

En el siguiente ejemplo de código, se muestra cómo usar describe-origin-endpoint.

AWS CLI

Para describir un punto final de origen

El siguiente describe-origin-endpoint comando muestra todos los detalles del punto final de origen denominadocmaf_sports.

aws mediapackage describe-origin-endpoint \
    --id cmaf_sports

Salida:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "NONE",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Id": "cmaf_sports",
    "ManifestName": "index",
    "StartoverWindowSeconds": 0,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 0,
    "Url": "",
    "Whitelist": []
}

Para obtener más información, consulte Visualización de un único punto final en la Guía del MediaPackage usuario de AWS Elemental.

En el siguiente ejemplo de código, se muestra cómo usar list-channels.

AWS CLI

Creación de una lista de todos los canales

El siguiente list-channels comando muestra todos los canales que están configurados en la AWS cuenta corriente.

aws mediapackage list-channels

Salida:

{
    "Channels": [
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
            "HlsIngest": {
                "IngestEndpoints": [
                    {
                        "Id": "584797f1740548c389a273585dd22a63",
                        "Password": "webdavgeneratedpassword1",
                        "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                        "Username": "webdavgeneratedusername1"
                    },
                    {
                        "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                        "Password": "webdavgeneratedpassword2",
                        "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                        "Username": "webdavgeneratedusername2"
                    }
                ]
            },
            "Id": "test",
            "Tags": {}
        }
    ]
}

Para obtener más información, consulte Visualización de los detalles de los canales en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte ListChannelsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar list-origin-endpoints.

AWS CLI

Creación de una lista de todos los puntos de conexión de origen de un canal

El siguiente comando list-origin-endpoints muestra todos los puntos de conexión de origen que están configurados en el canal denominado test.

aws mediapackage list-origin-endpoints \
    --channel-id test

Salida:

{
    "OriginEndpoints": [
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/247cff871f2845d3805129be22f2c0a2",
            "ChannelId": "test",
            "DashPackage": {
                "ManifestLayout": "FULL",
                "ManifestWindowSeconds": 60,
                "MinBufferTimeSeconds": 30,
                "MinUpdatePeriodSeconds": 15,
                "PeriodTriggers": [],
                "Profile": "NONE",
                "SegmentDurationSeconds": 2,
                "SegmentTemplateFormat": "NUMBER_WITH_TIMELINE",
                "StreamSelection": {
                    "MaxVideoBitsPerSecond": 2147483647,
                    "MinVideoBitsPerSecond": 0,
                    "StreamOrder": "ORIGINAL"
                },
                "SuggestedPresentationDelaySeconds": 25
            },
            "Id": "tester2",
            "ManifestName": "index",
            "StartoverWindowSeconds": 0,
            "Tags": {},
            "TimeDelaySeconds": 0,
            "Url": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/247cff871f2845d3805129be22f2c0a2/index.mpd",
            "Whitelist": []
        },
        {
            "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/869e237f851549e9bcf10e3bc2830839",
            "ChannelId": "test",
            "HlsPackage": {
                "AdMarkers": "NONE",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "SegmentDurationSeconds": 6,
                "StreamSelection": {
                    "MaxVideoBitsPerSecond": 2147483647,
                    "MinVideoBitsPerSecond": 0,
                    "StreamOrder": "ORIGINAL"
                },
                "UseAudioRenditionGroup": false
            },
            "Id": "tester",
            "ManifestName": "index",
            "StartoverWindowSeconds": 0,
            "Tags": {},
            "TimeDelaySeconds": 0,
            "Url": "https://8343f7014c0ea438.mediapackage.us-west-2.amazonaws.com/out/v1/869e237f851549e9bcf10e3bc2830839/index.m3u8",
            "Whitelist": []
        }
    ]
}

Para obtener más información, consulte Visualización de todos los puntos finales asociados a un canal en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte ListOriginEndpointsla Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar list-tags-for-resource.

AWS CLI

Para enumerar las etiquetas asignadas a un recurso

El siguiente list-tags-for-resource comando muestra las etiquetas asignadas al recurso especificado.

aws mediapackage list-tags-for-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0

Salida:

{
    "Tags": {
        "region": "west"
    }
}

Para obtener más información, consulte Etiquetar recursos en AWS Elemental MediaPackage en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte ListTagsForResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar rotate-ingest-endpoint-credentials.

AWS CLI

Para rotar las credenciales de ingesta

El siguiente rotate-ingest-endpoint-credentials comando rota el nombre de DAV usuario y la contraseña web del punto final de ingesta especificado.

aws mediapackage rotate-ingest-endpoint-credentials \
    --id test \
    --ingest-endpoint-id 584797f1740548c389a273585dd22a63

Salida:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/584797f1740548c389a273585dd22a63",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "584797f1740548c389a273585dd22a63",
                "Password": "webdavregeneratedpassword1",
                "Url": "https://9be9c4405c474882.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/584797f1740548c389a273585dd22a63/channel",
                "Username": "webdavregeneratedusername1"
            },
            {
                "Id": "7d187c8616fd455f88aaa5a9fcf74442",
                "Password": "webdavgeneratedpassword2",
                "Url": "https://7bf454c57220328d.mediapackage.us-west-2.amazonaws.com/in/v2/584797f1740548c389a273585dd22a63/7d187c8616fd455f88aaa5a9fcf74442/channel",
                "Username": "webdavgeneratedusername2"
            }
        ]
    },
    "Id": "test",
    "Tags": {}
}

Para obtener más información, consulte Rotación de credenciales en una entrada URL en la Guía del MediaPackage usuario de AWS Elemental.

En el siguiente ejemplo de código, se muestra cómo usar tag-resource.

AWS CLI

Cómo añadir una etiqueta a un recurso

Los siguientes tag-resource comandos añaden un par de region=west clave y valor al recurso especificado.

aws mediapackage tag-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
    --tags region=west

Este comando no genera ninguna salida.

Para obtener más información, consulte Etiquetar recursos en AWS Elemental MediaPackage en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte TagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar untag-resource.

AWS CLI

Para eliminar una etiqueta de un recurso

El siguiente untag-resource comando elimina la etiqueta con la clave region del canal especificado.

aws mediapackage untag-resource \
    --resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
    --tag-keys region

Para obtener más información, consulte Etiquetar recursos en AWS Elemental MediaPackage en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte UntagResourcela Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar update-channel.

AWS CLI

Para actualizar un canal

El siguiente update-channel comando actualiza el canal nombrado sportschannel para incluir la descripción24x7 sports.

aws mediapackage update-channel \
    --id sportschannel \
    --description "24x7 sports"

Salida:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0",
    "Description": "24x7 sports",
    "HlsIngest": {
        "IngestEndpoints": [
            {
                "Id": "6d345804ec3f46c9b454a91d4a80d0e0",
                "Password": "generatedwebdavpassword1",
                "Url": "https://f31c86aed53b815a.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/6d345804ec3f46c9b454a91d4a80d0e0/channel",
                "Username": "generatedwebdavusername1"
            },
            {
                "Id": "2daa32878af24803b24183727211b8ff",
                "Password": "generatedwebdavpassword2",
                "Url": "https://6ebbe7e04c4b0afa.mediapackage.us-west-2.amazonaws.com/in/v2/6d345804ec3f46c9b454a91d4a80d0e0/2daa32878af24803b24183727211b8ff/channel",
                "Username": "generatedwebdavusername2"
            }
        ]
    },
    "Id": "sportschannel",
    "Tags": {}
}

Para obtener más información, consulte Edición de un canal en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte UpdateChannella Referencia de AWS CLI comandos.

En el siguiente ejemplo de código, se muestra cómo usar update-origin-endpoint.

AWS CLI

Para actualizar un punto final de origen

El siguiente update-origin-endpoint comando actualiza el punto final de origen denominadocmaf_sports. Cambia el tiempo de retardo a 0 segundos.

aws mediapackage update-origin-endpoint \
    --id cmaf_sports \
    --time-delay-seconds 0

Salida:

{
    "Arn": "arn:aws:mediapackage:us-west-2:111222333:origin_endpoints/1dc6718be36f4f34bb9cd86bc50925e6",
    "ChannelId": "sportschannel",
    "CmafPackage": {
        "HlsManifests": [
            {
                "AdMarkers": "NONE",
                "Id": "cmaf_sports_endpoint",
                "IncludeIframeOnlyStream": false,
                "PlaylistType": "EVENT",
                "PlaylistWindowSeconds": 60,
                "ProgramDateTimeIntervalSeconds": 0,
                "Url": "https://c4af3793bf76b33c.mediapackage.us-west-2.amazonaws.com/out/v1/1dc6718be36f4f34bb9cd86bc50925e6/cmaf_sports_endpoint/index.m3u8"
            }
        ],
        "SegmentDurationSeconds": 2,
        "SegmentPrefix": "sportschannel"
    },
    "Id": "cmaf_sports",
    "ManifestName": "index",
    "StartoverWindowSeconds": 0,
    "Tags": {
        "region": "west",
        "media": "sports"
    },
    "TimeDelaySeconds": 0,
    "Url": "",
    "Whitelist": []
}

Para obtener más información, consulte Edición de un punto final en la Guía del MediaPackage usuario de AWS Elemental.

  • Para API obtener más información, consulte UpdateOriginEndpointla Referencia de AWS CLI comandos.