# Ejemplos de MediaPackage que utilizan la AWS CLI
Los siguientes ejemplos de código muestran cómo realizar acciones e implementar escenarios habituales mediante el AWS Command Line Interface con 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
### `create-channel`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-channel`.
**AWS CLI**
**Para crear un canal**
El siguiente comando `create-channel` crea un canal llamado `sportschannel` en la cuenta actual.
```
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 [Creating a Channel](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-create.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [CreateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/create-channel.html) en la *Referencia de comandos de la AWS CLI*.
### `create-origin-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `create-origin-endpoint`.
**AWS CLI**
**Para crear un punto de conexión de origen**
El siguiente comando `create-origin-endpoint` crea un punto de conexión de origen llamado `cmafsports` con la configuración del paquete proporcionada en un archivo JSON y la configuración de punto de conexión 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 [Creating an Endpoint](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-create.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [CreateOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/create-origin-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-channel`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-channel`.
**AWS CLI**
**Para eliminar un canal**
El siguiente comando `delete-channel` elimina el canal llamado `test`.
```
aws mediapackage delete-channel \
--id test
```
Este comando no genera ninguna salida.
Para obtener más información, consulte [Deleting a Channel](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-delete.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [DeleteChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/delete-channel.html) en la *Referencia de comandos de la AWS CLI*.
### `delete-origin-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `delete-origin-endpoint`.
**AWS CLI**
**Para eliminar un punto de conexión de origen**
El siguiente comando `delete-origin-endpoint` elimina el punto de conexión de origen llamado `tester2`.
```
aws mediapackage delete-origin-endpoint \
--id tester2
```
Para obtener más información, consulte [Deleting an Endpoint](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-delete.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [DeleteOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/delete-origin-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-channel`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-channel`.
**AWS CLI**
**Para describir un canal**
El siguiente comando `describe-channel` muestra todos los detalles del canal llamado `test`.
```
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 Viewing Channel Details en la *Guía del usuario de AWS Elemental MediaPackage*
+ Para obtener información sobre la API, consulte [DescribeChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/describe-channel.html) en la *Referencia de comandos de la AWS CLI*.
### `describe-origin-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `describe-origin-endpoint`.
**AWS CLI**
**Para describir un punto de conexión de origen**
El siguiente comando `describe-origin-endpoint` muestra todos los detalles del punto de conexión de origen llamado `cmaf_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 [Viewing a Single Endpoint](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-view-one.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [DescribeOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/describe-origin-endpoint.html) en la *Referencia de comandos de la AWS CLI*.
### `list-channels`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-channels`.
**AWS CLI**
**Creación de una lista de todos los canales**
El siguiente comando `list-channels` muestra todos los canales que están configurados en la cuenta de AWS actual.
```
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 [Viewing Channel Details](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [ListChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-channels.html) en la *Referencia de comandos de la AWS CLI*.
### `list-origin-endpoints`
En el siguiente ejemplo de código, se muestra cómo utilizar `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 [Viewing all Endpoints Associated with a Channel](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-view-all.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [ListOriginEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-origin-endpoints.html) en la *Referencia de comandos de la AWS CLI*.
### `list-tags-for-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `list-tags-for-resource`.
**AWS CLI**
**Para enumerar las etiquetas asignadas a un recurso**
El siguiente comando `list-tags-for-resource` enumera todas 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 [Tagging Resources in AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para ver los detalles de la API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-tags-for-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `rotate-ingest-endpoint-credentials`
En el siguiente ejemplo de código, se muestra cómo utilizar `rotate-ingest-endpoint-credentials`.
**AWS CLI**
**Para rotar las credenciales de ingesta**
El siguiente comando `rotate-ingest-endpoint-credentials` rota el nombre de usuario y la contraseña de WebDAV para el punto de conexión 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 [Rotating Credentials on an Input URL](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-rotate-creds) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener más información sobre la API, consulte [RotateIngestEndpointCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/rotate-ingest-endpoint-credentials.html) en la *Referencia de comandos de la AWS CLI*.
### `tag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `tag-resource`.
**AWS CLI**
**Cómo añadir una etiqueta a un recurso**
Los siguientes comandos `tag-resource` agregan un par de clave y valor `region=west` 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 [Tagging Resources in AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para ver los detalles de la API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/tag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `untag-resource`
En el siguiente ejemplo de código, se muestra cómo utilizar `untag-resource`.
**AWS CLI**
**Para eliminar una etiqueta de un recurso**
El siguiente comando `untag-resource` 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 [Tagging Resources in AWS Elemental MediaPackage](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para ver los detalles de la API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/untag-resource.html) en la *Referencia de comandos de la AWS CLI*.
### `update-channel`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-channel`.
**AWS CLI**
**Para actualizar un canal**
El siguiente comando `update-channel` actualiza el canal llamado `sportschannel` para incluir la descripción `24x7 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 [Editing a Channel](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-edit.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [UpdateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/update-channel.html) en la *Referencia de comandos de la AWS CLI*.
### `update-origin-endpoint`
En el siguiente ejemplo de código, se muestra cómo utilizar `update-origin-endpoint`.
**AWS CLI**
**Para actualizar un punto de conexión de origen**
El siguiente comando `update-origin-endpoint` actualiza el punto de conexión de origen denominado `cmaf_sports`. Cambia el retardo de tiempo 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 [Editing an Endpoint](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-edit.html) en la *Guía del usuario de AWS Elemental MediaPackage*.
+ Para obtener información sobre la API, consulte [UpdateOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/update-origin-endpoint.html) en la *Referencia de comandos de AWS CLI*.