Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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á.
# MediaPackage exemplos usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface with MediaPackage.
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, em que você pode encontrar instruções sobre como configurar e executar o código.
**Topics**
+ [Ações](#actions)
## Ações
### `create-channel`
O código de exemplo a seguir mostra como usar `create-channel`.
**AWS CLI**
**Para criar um canal**
O comando `create-channel` a seguir cria um canal chamado `sportschannel` na conta atual.
```
aws mediapackage create-channel --id sportschannel
```
Saída:
```
{
"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 obter mais informações, consulte [Criação de um canal](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-create.html) no *Guia do MediaPackage usuário do AWS Elemental*.
+ Para obter detalhes da API, consulte [CreateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/create-channel.html)em *Referência de AWS CLI Comandos*.
### `create-origin-endpoint`
O código de exemplo a seguir mostra como usar `create-origin-endpoint`.
**AWS CLI**
**Para criar um endpoint de origem**
O comando `create-origin-endpoint` a seguir cria um endpoint de origem chamado `cmafsports` com as configurações de pacote fornecidas em um arquivo JSON e as configurações de endpoint especificadas.
```
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
```
Saída:
```
{
"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 obter mais informações, consulte [Criação de um endpoint no Guia](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-create.html) do * MediaPackage usuário do AWS Elemental*.
+ Para obter detalhes da API, consulte [CreateOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/create-origin-endpoint.html)em *Referência de AWS CLI Comandos*.
### `delete-channel`
O código de exemplo a seguir mostra como usar `delete-channel`.
**AWS CLI**
**Para excluir um canal**
O comando `delete-channel` a seguir o canal chamado `test`.
```
aws mediapackage delete-channel \
--id test
```
Este comando não produz saída.
Para obter mais informações, consulte [Excluindo um canal no Guia](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-delete.html) do * MediaPackage usuário do AWS Elemental*.
+ Para obter detalhes da API, consulte [DeleteChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/delete-channel.html)em *Referência de AWS CLI Comandos*.
### `delete-origin-endpoint`
O código de exemplo a seguir mostra como usar `delete-origin-endpoint`.
**AWS CLI**
**Para excluir um endpoint**
O comando `delete-origin-endpoint` a seguir exclui o endpoint de origem chamado `tester2`.
```
aws mediapackage delete-origin-endpoint \
--id tester2
```
Para obter mais informações, consulte [Excluindo um endpoint](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-delete.html) no Guia do usuário do *AWS Elemental MediaPackage *.
+ Para obter detalhes da API, consulte [DeleteOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/delete-origin-endpoint.html)em *Referência de AWS CLI Comandos*.
### `describe-channel`
O código de exemplo a seguir mostra como usar `describe-channel`.
**AWS CLI**
**Para descrever um canal**
O comando `describe-channel` a seguir exibe todos os detalhes do canal chamado `test`.
```
aws mediapackage describe-channel \
--id test
```
Saída:
```
{
"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 obter mais informações, consulte Visualizando detalhes do canal< https://docs.aws.amazon.com/mediapackage/ latest/ug/channels -view.html> no Guia do usuário do Elemental AWS MediaPackage *
+ Para obter detalhes da API, consulte [DescribeChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/describe-channel.html)em *Referência de AWS CLI Comandos*.
### `describe-origin-endpoint`
O código de exemplo a seguir mostra como usar `describe-origin-endpoint`.
**AWS CLI**
**Para descrever um endpoint de origem**
O comando `describe-origin-endpoint` a seguir exibe todos os detalhes do endpoint de origem chamado `cmaf_sports`.
```
aws mediapackage describe-origin-endpoint \
--id cmaf_sports
```
Saída:
```
{
"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 obter mais informações, consulte [Visualizando um único endpoint no Guia](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-view-one.html) do * MediaPackage usuário do AWS Elemental*.
+ Para obter detalhes da API, consulte [DescribeOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/describe-origin-endpoint.html)em *Referência de AWS CLI Comandos*.
### `list-channels`
O código de exemplo a seguir mostra como usar `list-channels`.
**AWS CLI**
**Para listar todos os canais**
O `list-channels` comando a seguir lista todos os canais configurados na AWS conta atual.
```
aws mediapackage list-channels
```
Saída:
```
{
"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 obter mais informações, consulte [Visualizando detalhes do canal](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html) no *Guia do MediaPackage usuário do AWS Elemental*.
+ Para obter detalhes da API, consulte [ListChannels](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-channels.html)em *Referência de AWS CLI Comandos*.
### `list-origin-endpoints`
O código de exemplo a seguir mostra como usar `list-origin-endpoints`.
**AWS CLI**
**Para listar todos os endpoints de origem de um canal**
O comando `list-origin-endpoints` a seguir lista todos endpoints de origem que estão configurados no canal `test`.
```
aws mediapackage list-origin-endpoints \
--channel-id test
```
Saída:
```
{
"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 obter mais informações, consulte [Visualização de todos os endpoints associados a um canal no Guia](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-view-all.html) do * MediaPackage usuário do AWS Elemental*.
+ Para obter detalhes da API, consulte [ListOriginEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-origin-endpoints.html)em *Referência de AWS CLI Comandos*.
### `list-tags-for-resource`
O código de exemplo a seguir mostra como usar `list-tags-for-resource`.
**AWS CLI**
**Para listar tags atribuídas a um recurso**
O comando `list-tags-for-resource` a seguir lista todas as tags atribuídas ao recurso especificado.
```
aws mediapackage list-tags-for-resource \
--resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0
```
Saída:
```
{
"Tags": {
"region": "west"
}
}
```
Para obter mais informações, consulte Como [marcar recursos no AWS Elemental MediaPackage no Guia](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) do usuário do *AWS Elemental MediaPackage *.
+ Para obter detalhes da API, consulte [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-tags-for-resource.html)em *Referência de AWS CLI Comandos*.
### `rotate-ingest-endpoint-credentials`
O código de exemplo a seguir mostra como usar `rotate-ingest-endpoint-credentials`.
**AWS CLI**
**Para rotacionar as credenciais de ingestão**
O comando `rotate-ingest-endpoint-credentials` a seguir rotaciona o nome de usuário WebDAV e a senha para o endpoint de ingestão especificado.
```
aws mediapackage rotate-ingest-endpoint-credentials \
--id test \
--ingest-endpoint-id 584797f1740548c389a273585dd22a63
```
Saída:
```
{
"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 obter mais informações, consulte [Rotação de credenciais em um URL de entrada no Guia do](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-rotate-creds) usuário do *AWS Elemental MediaPackage *.
+ Para obter detalhes da API, consulte [RotateIngestEndpointCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/rotate-ingest-endpoint-credentials.html)em *Referência de AWS CLI Comandos*.
### `tag-resource`
O código de exemplo a seguir mostra como usar `tag-resource`.
**AWS CLI**
**Para adicionar uma tag a um recurso**
Os comandos `tag-resource` a seguir adicionam um par de chave-valor `region=west` ao recurso especificado.
```
aws mediapackage tag-resource \
--resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
--tags region=west
```
Este comando não produz saída.
Para obter mais informações, consulte Como [marcar recursos no AWS Elemental MediaPackage no Guia](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) do usuário do *AWS Elemental MediaPackage *.
+ Para obter detalhes da API, consulte [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/tag-resource.html)em *Referência de AWS CLI Comandos*.
### `untag-resource`
O código de exemplo a seguir mostra como usar `untag-resource`.
**AWS CLI**
**Para remover uma tag de um recurso**
O comando `untag-resource` a seguir remove a tag com a chave `region` do canal especificado.
```
aws mediapackage untag-resource \
--resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
--tag-keys region
```
Para obter mais informações, consulte Como [marcar recursos no AWS Elemental MediaPackage no Guia](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) do usuário do *AWS Elemental MediaPackage *.
+ Para obter detalhes da API, consulte [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/untag-resource.html)em *Referência de AWS CLI Comandos*.
### `update-channel`
O código de exemplo a seguir mostra como usar `update-channel`.
**AWS CLI**
**Para atualizar um canal**
O comando `update-channel` a seguir atualiza o canal chamado `sportschannel` para incluir a descrição`24x7 sports`.
```
aws mediapackage update-channel \
--id sportschannel \
--description "24x7 sports"
```
Saída:
```
{
"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 obter mais informações, consulte [Editando um canal](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-edit.html) no *Guia do MediaPackage usuário do AWS Elemental*.
+ Para obter detalhes da API, consulte [UpdateChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/update-channel.html)em *Referência de AWS CLI Comandos*.
### `update-origin-endpoint`
O código de exemplo a seguir mostra como usar `update-origin-endpoint`.
**AWS CLI**
**Para atualizar um endpoint de origem**
O comando `update-origin-endpoint` a seguir atualiza o endpoint de origem chamado `cmaf_sports`. Ele altera o tempo de atraso para `0` segundos.
```
aws mediapackage update-origin-endpoint \
--id cmaf_sports \
--time-delay-seconds 0
```
Saída:
```
{
"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 obter mais informações, consulte [Editando um endpoint no Guia](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-edit.html) do * MediaPackage usuário do AWS Elemental*.
+ Para obter detalhes da API, consulte [UpdateOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/update-origin-endpoint.html)em *Referência de AWS CLI Comandos*.