Sono disponibili altri esempi AWS SDK nel repository [AWS Doc SDK](https://github.com/awsdocs/aws-doc-sdk-examples) Examples. GitHub
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# MediaPackage esempi che utilizzano AWS CLI
I seguenti esempi di codice mostrano come eseguire azioni e implementare scenari comuni utilizzando AWS Command Line Interface with MediaPackage.
Le *azioni* sono estratti di codice da programmi più grandi e devono essere eseguite nel contesto. Sebbene le azioni mostrino come richiamare le singole funzioni del servizio, è possibile visualizzarle contestualizzate negli scenari correlati.
Ogni esempio include un link al codice sorgente completo, in cui vengono fornite le istruzioni su come configurare ed eseguire il codice nel contesto.
**Topics**
+ [Azioni](#actions)
## Azioni
### `create-channel`
Il seguente esempio di codice mostra come utilizzare`create-channel`.
**AWS CLI**
**Come creare un canale**
Il comando `create-channel` seguente crea un canale denominato `sportschannel` nell’account corrente.
```
aws mediapackage create-channel --id sportschannel
```
Output:
```
{
"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"
}
}
```
Per ulteriori informazioni, consulta [Creazione di un canale](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-create.html) nella *Guida MediaPackage utente di AWS Elemental*.
+ Per i dettagli sull'API, consulta [CreateChannel AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/create-channel.html)*Command Reference.*
### `create-origin-endpoint`
Il seguente esempio di codice mostra come utilizzare`create-origin-endpoint`.
**AWS CLI**
**Come creare un endpoint di origine**
Il comando `create-origin-endpoint` seguente crea un endpoint di origine denominato `cmafsports` con le impostazioni del pacchetto fornite in un file JSON e le impostazioni dell’endpoint specificate.
```
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
```
Output:
```
{
"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": []
}
```
Per ulteriori informazioni, consulta [Creazione di un endpoint nella Guida](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-create.html) per l'* MediaPackage utente di AWS Elemental*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [CreateOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/create-origin-endpoint.html)Reference*.
### `delete-channel`
Il seguente esempio di codice mostra come utilizzare`delete-channel`.
**AWS CLI**
**Come eliminare un canale**
Il comando `delete-channel` seguente elimina il canale denominato `test`.
```
aws mediapackage delete-channel \
--id test
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Eliminazione di un canale nella Guida](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-delete.html) per l'* MediaPackage utente di AWS Elemental*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [DeleteChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/delete-channel.html)Reference*.
### `delete-origin-endpoint`
Il seguente esempio di codice mostra come utilizzare`delete-origin-endpoint`.
**AWS CLI**
**Come eliminare un endpoint di origine**
Il comando `delete-origin-endpoint` seguente elimina l’endpoint di origine denominato `tester2`.
```
aws mediapackage delete-origin-endpoint \
--id tester2
```
Per ulteriori informazioni, consulta [Eliminazione di un endpoint](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-delete.html) nella Guida per l'utente di *AWS MediaPackage Elemental*.
+ *Per i dettagli sull'API, consulta Command [DeleteOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/delete-origin-endpoint.html)Reference AWS CLI .*
### `describe-channel`
Il seguente esempio di codice mostra come utilizzare`describe-channel`.
**AWS CLI**
**Come descrivere un canale**
Il comando `describe-channel` seguente visualizza tutti i dettagli del canale denominato `test`.
```
aws mediapackage describe-channel \
--id test
```
Output:
```
{
"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": {}
}
```
*Per ulteriori informazioni, consulta Visualizzazione dei dettagli dei canali< https://docs.aws.amazon.com/mediapackage/ latest/ug/channels -view.html> nella Guida per l'utente di Elemental AWS MediaPackage *
+ *Per i dettagli sull'API, consulta Command Reference. [DescribeChannel](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/describe-channel.html)AWS CLI *
### `describe-origin-endpoint`
Il seguente esempio di codice mostra come utilizzare`describe-origin-endpoint`.
**AWS CLI**
**Come descrivere un endpoint di origine**
Il comando `describe-origin-endpoint` seguente visualizza tutti i dettagli dell’endpoint di origine denominato `cmaf_sports`.
```
aws mediapackage describe-origin-endpoint \
--id cmaf_sports
```
Output:
```
{
"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": []
}
```
Per ulteriori informazioni, consulta [Viewing a Single Endpoint nella Guida](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-view-one.html) per l'* MediaPackage utente di AWS Elemental*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [DescribeOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/describe-origin-endpoint.html)Reference*.
### `list-channels`
Il seguente esempio di codice mostra come utilizzare`list-channels`.
**AWS CLI**
**Come elencare tutti i canali**
Il `list-channels` comando seguente elenca tutti i canali configurati nell' AWS account corrente.
```
aws mediapackage list-channels
```
Output:
```
{
"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": {}
}
]
}
```
Per ulteriori informazioni, consulta [Visualizzazione dei dettagli dei canali](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html) nella *Guida per l' MediaPackage utente di AWS Elemental*.
+ Per i dettagli sull'API, consulta [ListChannels AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-channels.html)*Command Reference.*
### `list-origin-endpoints`
Il seguente esempio di codice mostra come utilizzare`list-origin-endpoints`.
**AWS CLI**
**Come elencare tutti gli endpoint di origine in un canale**
Il comando `list-origin-endpoints` seguente elenca tutti gli endpoint di origine configurati nel canale denominato `test`.
```
aws mediapackage list-origin-endpoints \
--channel-id test
```
Output:
```
{
"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": []
}
]
}
```
Per ulteriori informazioni, consulta [Visualizzazione di tutti gli endpoint associati a un canale](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-view-all.html) nella Guida per l'* MediaPackage utente di AWS Elemental*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [ListOriginEndpoints](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-origin-endpoints.html)Reference*.
### `list-tags-for-resource`
Il seguente esempio di codice mostra come utilizzare`list-tags-for-resource`.
**AWS CLI**
**Come elencare i tag assegnati a una risorsa**
Il comando `list-tags-for-resource` seguente elenca i tag assegnati alla risorsa specificata.
```
aws mediapackage list-tags-for-resource \
--resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0
```
Output:
```
{
"Tags": {
"region": "west"
}
}
```
Per ulteriori informazioni, consulta [Tagging Resources in AWS Elemental nella MediaPackage *AWS MediaPackage Elemental*](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) User Guide.
+ *Per i dettagli sull'API, consulta Command [ListTagsForResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/list-tags-for-resource.html)Reference AWS CLI .*
### `rotate-ingest-endpoint-credentials`
Il seguente esempio di codice mostra come utilizzare`rotate-ingest-endpoint-credentials`.
**AWS CLI**
**Come ruotare le credenziali di importazione**
Il comando `rotate-ingest-endpoint-credentials` seguente ruota il nome utente e la password WebDAV per l’endpoint di importazione specificato.
```
aws mediapackage rotate-ingest-endpoint-credentials \
--id test \
--ingest-endpoint-id 584797f1740548c389a273585dd22a63
```
Output:
```
{
"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": {}
}
```
Per ulteriori informazioni, consulta [Rotazione delle credenziali su un URL di input](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-rotate-creds) nella Guida per l'utente di *AWS MediaPackage Elemental*.
+ *Per i dettagli sull'API, consulta Command [RotateIngestEndpointCredentials](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/rotate-ingest-endpoint-credentials.html)Reference AWS CLI .*
### `tag-resource`
Il seguente esempio di codice mostra come utilizzare`tag-resource`.
**AWS CLI**
**Come aggiungere un tag a una risorsa**
I comandi `tag-resource` seguenti aggiungono una coppia chiave/valore `region=west` alla risorsa specificata.
```
aws mediapackage tag-resource \
--resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
--tags region=west
```
Questo comando non produce alcun output.
Per ulteriori informazioni, consulta [Tagging Resources in AWS Elemental nella MediaPackage *AWS MediaPackage Elemental*](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) User Guide.
+ *Per i dettagli sull'API, consulta Command [TagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/tag-resource.html)Reference AWS CLI .*
### `untag-resource`
Il seguente esempio di codice mostra come utilizzare`untag-resource`.
**AWS CLI**
**Come rimuovere un tag da una risorsa**
Il comando `untag-resource` seguente rimuove il tag con la chiave `region` dal canale specificato.
```
aws mediapackage untag-resource \
--resource-arn arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0 \
--tag-keys region
```
Per ulteriori informazioni, consulta [Tagging Resources in AWS Elemental nella MediaPackage *AWS MediaPackage Elemental*](https://docs.aws.amazon.com/mediapackage/latest/ug/tagging.html) User Guide.
+ *Per i dettagli sull'API, consulta Command [UntagResource](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/untag-resource.html)Reference AWS CLI .*
### `update-channel`
Il seguente esempio di codice mostra come utilizzare`update-channel`.
**AWS CLI**
**Come modificare un canale**
Il comando `update-channel` seguente aggiorna il canale denominato `sportschannel` per includere la descrizione `24x7 sports`.
```
aws mediapackage update-channel \
--id sportschannel \
--description "24x7 sports"
```
Output:
```
{
"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": {}
}
```
Per ulteriori informazioni, consulta [Modifica di un canale](https://docs.aws.amazon.com/mediapackage/latest/ug/channels-edit.html) nella *Guida per l' MediaPackage utente di AWS Elemental*.
+ Per i dettagli sull'API, consulta [UpdateChannel AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/update-channel.html)*Command Reference.*
### `update-origin-endpoint`
Il seguente esempio di codice mostra come utilizzare`update-origin-endpoint`.
**AWS CLI**
**Come aggiornare un endpoint di origine**
Il comando `update-origin-endpoint` seguente aggiorna l’endpoint di origine denominato `cmaf_sports`. Cambia il ritardo in `0` secondi.
```
aws mediapackage update-origin-endpoint \
--id cmaf_sports \
--time-delay-seconds 0
```
Output:
```
{
"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": []
}
```
Per ulteriori informazioni, consulta [Modifica di un endpoint nella Guida](https://docs.aws.amazon.com/mediapackage/latest/ug/endpoints-edit.html) per l'* MediaPackage utente di AWS Elemental*.
+ Per i dettagli sull'API, consulta *AWS CLI Command [UpdateOriginEndpoint](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/mediapackage/update-origin-endpoint.html)Reference*.