文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 AWS SDK 範例
本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用 的 MediaPackage 範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 MediaPackage 來執行動作和實作常見案例。
Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境中查看內容中的動作。
每個範例都包含完整原始程式碼的連結,您可以在其中找到如何在內容中設定和執行程式碼的指示。
主題
動作
下列程式碼範例示範如何使用 create-channel
。
- AWS CLI
-
建立頻道
下列
create-channel
命令會在目前帳戶中建立名為sportschannel
的頻道。aws mediapackage create-channel --id
sportschannel
輸出:
{ "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" } }
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的建立頻道。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 CreateChannel
。
-
下列程式碼範例示範如何使用 create-origin-endpoint
。
- AWS CLI
-
建立原始伺服器端點
下列
create-origin-endpoint
命令cmafsports
會使用 JSON 檔案提供的套件設定和指定的端點設定來建立名為 的原始端點。aws mediapackage create-origin-endpoint \ --channel-id
sportschannel
\ --idcmafsports
\ --cmaf-packagefile://file/path/cmafpkg.json
--description"cmaf output of sports"
\ --idcmaf_sports
\ --manifest-namesports_channel
\ --startover-window-seconds300
\ --tagsregion=west,media=sports
\ --time-delay-seconds10
輸出:
{ "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": [] }
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的建立端點。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 CreateOriginEndpoint
。
-
下列程式碼範例示範如何使用 delete-channel
。
- AWS CLI
-
刪除頻道
下列
delete-channel
命令會刪除名為 的頻道test
。aws mediapackage delete-channel \ --id
test
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的刪除頻道。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DeleteChannel
。
-
下列程式碼範例示範如何使用 delete-origin-endpoint
。
- AWS CLI
-
刪除原始伺服器端點
下列
delete-origin-endpoint
命令會刪除名為 的原始伺服器端點tester2
。aws mediapackage delete-origin-endpoint \ --id
tester2
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的刪除端點。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DeleteOriginEndpoint
。
-
下列程式碼範例示範如何使用 describe-channel
。
- AWS CLI
-
描述頻道
下列
describe-channel
命令會顯示名為 之頻道的所有詳細資訊test
。aws mediapackage describe-channel \ --id
test
輸出:
{ "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": {} }
如需詳細資訊,請參閱《 AWS Elemental MediaPackage 使用者指南》中的檢視頻道詳細資訊<https://docs.aws.amazon.com/mediapackage/latest/ug/channels-view.html>
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DescribeChannel
。
-
下列程式碼範例示範如何使用 describe-origin-endpoint
。
- AWS CLI
-
描述原始伺服器端點
下列
describe-origin-endpoint
命令會顯示名為 的原始伺服器端點的所有詳細資訊cmaf_sports
。aws mediapackage describe-origin-endpoint \ --id
cmaf_sports
輸出:
{ "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": [] }
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的檢視單一端點。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 DescribeOriginEndpoint
。
-
下列程式碼範例示範如何使用 list-channels
。
- AWS CLI
-
列出所有頻道
下列
list-channels
命令會列出目前 AWS 帳戶上設定的所有頻道。aws mediapackage list-channels
輸出:
{ "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": {} } ] }
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的檢視頻道詳細資訊。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 ListChannels
。
-
下列程式碼範例示範如何使用 list-origin-endpoints
。
- AWS CLI
-
列出頻道上的所有原始端點
下列
list-origin-endpoints
命令會列出在名為 的頻道上設定的所有原始伺服器端點test
。aws mediapackage list-origin-endpoints \ --channel-id
test
輸出:
{ "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": [] } ] }
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的檢視與頻道相關聯的所有端點。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 ListOriginEndpoints
。
-
下列程式碼範例示範如何使用 list-tags-for-resource
。
- AWS CLI
-
列出指派給資源的標籤
下列
list-tags-for-resource
命令會列出指派給指定資源的標籤。aws mediapackage list-tags-for-resource \ --resource-arn
arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0
輸出:
{ "Tags": { "region": "west" } }
如需詳細資訊,請參閱《AWS Elemental MediaPackage 使用者指南》中的在 Elemental MediaPackage 中標記資源。 AWS MediaPackage
-
如需 API 詳細資訊,請參閱《AWS CLI 命令參考》中的 ListTagsForResource
。
-
下列程式碼範例示範如何使用 rotate-ingest-endpoint-credentials
。
- AWS CLI
-
輪換擷取憑證
下列
rotate-ingest-endpoint-credentials
命令會輪換指定擷取端點的 WebDAV 使用者名稱和密碼。aws mediapackage rotate-ingest-endpoint-credentials \ --id
test
\ --ingest-endpoint-id584797f1740548c389a273585dd22a63
輸出:
{ "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": {} }
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的在輸入 URL 上輪換登入資料。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 RotateIngestEndpointCredentials
。
-
下列程式碼範例示範如何使用 tag-resource
。
- AWS CLI
-
將標籤加入資源
下列
tag-resource
命令會將region=west
金鑰和值對新增至指定的資源。aws mediapackage tag-resource \ --resource-arn
arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0
\ --tagsregion=west
此命令不會產生輸出。
如需詳細資訊,請參閱《AWS Elemental MediaPackage 使用者指南》中的在 Elemental MediaPackage 中標記資源。 AWS MediaPackage
-
如需 API 詳細資訊,請參閱《AWS CLI 命令參考》中的 TagResource
。
-
下列程式碼範例示範如何使用 untag-resource
。
- AWS CLI
-
從資源移除標籤
下列
untag-resource
命令region
會從指定的頻道移除具有 金鑰的標籤。aws mediapackage untag-resource \ --resource-arn
arn:aws:mediapackage:us-west-2:111222333:channels/6d345804ec3f46c9b454a91d4a80d0e0
\ --tag-keysregion
如需詳細資訊,請參閱《AWS Elemental MediaPackage 使用者指南》中的 Elemental MediaPackage 中的標記資源。 AWS MediaPackage
-
如需 API 詳細資訊,請參閱《AWS CLI 命令參考》中的 UntagResource
。
-
下列程式碼範例示範如何使用 update-channel
。
- AWS CLI
-
更新頻道
下列
update-channel
命令會將名為 的頻道更新sportschannel
為包含描述24x7 sports
。aws mediapackage update-channel \ --id
sportschannel
\ --description"24x7 sports"
輸出:
{ "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": {} }
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的編輯頻道。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 UpdateChannel
。
-
下列程式碼範例示範如何使用 update-origin-endpoint
。
- AWS CLI
-
更新原始伺服器端點
下列
update-origin-endpoint
命令會更新名為 的原始伺服器端點cmaf_sports
。它會將時間延遲變更為0
秒。aws mediapackage update-origin-endpoint \ --id
cmaf_sports
\ --time-delay-seconds0
輸出:
{ "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": [] }
如需詳細資訊,請參閱 AWS 元素 MediaPackage 使用者指南中的編輯端點。
-
如需 API 詳細資訊,請參閱 AWS CLI 命令參考中的 UpdateOriginEndpoint
。
-