本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
MediaStore 使用 的範例 AWS CLI
下列程式碼範例示範如何使用 AWS Command Line Interface 搭配 來執行動作和實作常見案例 MediaStore。
Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會示範如何呼叫個別服務函數,但您可以在其相關案例中查看內容中的動作。
每個範例都包含完整原始程式碼的連結,您可以在其中找到如何在內容中設定和執行程式碼的指示。
主題
動作
下列程式碼範例示範如何使用 create-container
。
- AWS CLI
-
若要建立容器
下列
create-container
範例會建立新的空容器。aws mediastore create-container --container-name
ExampleContainer
輸出:
{ "Container": { "AccessLoggingEnabled": false, "CreationTime": 1563557265, "Name": "ExampleContainer", "Status": "CREATING", "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer" } }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的建立容器。
-
如需API詳細資訊,請參閱 命令參考 CreateContainer
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 delete-container-policy
。
- AWS CLI
-
若要刪除容器政策
下列
delete-container-policy
範例會刪除指派給指定容器的政策。刪除政策時, AWS Elemental MediaStore 會自動將預設政策指派給容器。aws mediastore delete-container-policy \ --container-name
LiveEvents
此命令不會產生輸出。
如需詳細資訊,請參閱 元素參考 DeleteContainerPolicy 中的 。 AWS MediaStore API
-
如需API詳細資訊,請參閱 命令參考 DeleteContainerPolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 delete-container
。
- AWS CLI
-
若要刪除容器
下列
delete-container
範例會刪除指定的容器。只有當容器沒有任何物件時,您才可以將該容器刪除。aws mediastore delete-container \ --container-name=ExampleLiveDemo
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的刪除容器。
-
如需API詳細資訊,請參閱 命令參考 DeleteContainer
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 delete-cors-policy
。
- AWS CLI
-
若要刪除CORS政策
下列
delete-cors-policy
範例會刪除指派給指定容器的跨來源資源共用 (CORS) 政策。aws mediastore delete-cors-policy \ --container-name
ExampleContainer
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的刪除CORS政策。
-
如需API詳細資訊,請參閱 命令參考 DeleteCorsPolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 delete-lifecycle-policy
。
- AWS CLI
-
若要刪除物件生命週期政策
下列
delete-lifecycle-policy
範例會刪除連接至指定容器的物件生命週期政策。此變更最多可能需要 20 分鐘才會生效。aws mediastore delete-lifecycle-policy \ --container-name
LiveEvents
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的刪除物件生命週期政策。
-
如需API詳細資訊,請參閱 命令參考 DeleteLifecyclePolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 describe-container
。
- AWS CLI
-
檢視容器的詳細資訊
下列
describe-container
範例顯示指定容器的詳細資訊。aws mediastore describe-container \ --container-name
ExampleContainer
輸出:
{ "Container": { "CreationTime": 1563558086, "AccessLoggingEnabled": false, "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer", "Status": "ACTIVE", "Name": "ExampleContainer", "Endpoint": "https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com" } }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的檢視容器的詳細資訊。
-
如需API詳細資訊,請參閱 命令參考 DescribeContainer
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 describe-object
。
- AWS CLI
-
檢視特定容器中的物件和資料夾清單
下列
describe-object
範例顯示存放在特定容器中的項目 (物件和資料夾)。aws mediastore-data describe-object \ --endpoint
https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
\ --path/folder_name/file1234.jpg
輸出:
{ "ContentType": "image/jpeg", "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT", "ContentLength": "2307346", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3" }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的檢視物件的詳細資訊。
-
如需API詳細資訊,請參閱 命令參考 DescribeObject
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 get-container-policy
。
- AWS CLI
-
檢視容器政策
下列
get-container-policy
範例顯示指定容器的資源型政策。aws mediastore get-container-policy \ --container-name
ExampleLiveDemo
輸出:
{ "Policy": { "Version": "2012-10-17", "Statement": [ { "Sid": "PublicReadOverHttps", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:root" }, "Action": [ "mediastore:GetObject", "mediastore:DescribeObject" ], "Resource": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleLiveDemo/", "Condition": { "Bool": { "aws:SecureTransport": "true" } } } ] } }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的檢視容器政策。
-
如需API詳細資訊,請參閱 命令參考 GetContainerPolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 get-cors-policy
。
- AWS CLI
-
檢視CORS政策
下列
get-cors-policy
範例顯示指派給指定容器的跨來源資源共用 (CORS) 政策。aws mediastore get-cors-policy \ --container-name
ExampleContainer
\ --regionus-west-2
輸出:
{ "CorsPolicy": [ { "AllowedMethods": [ "GET", "HEAD" ], "MaxAgeSeconds": 3000, "AllowedOrigins": [ "" ], "AllowedHeaders": [ "" ] } ] }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的檢視CORS政策。
-
如需API詳細資訊,請參閱 命令參考 GetCorsPolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 get-lifecycle-policy
。
- AWS CLI
-
檢視物件生命週期政策
下列
get-lifecycle-policy
範例顯示連接至指定容器的物件生命週期政策。aws mediastore get-lifecycle-policy \ --container-name
LiveEvents
輸出:
{ "LifecyclePolicy": { "rules": [ { "definition": { "path": [ { "prefix": "Football/" }, { "prefix": "Baseball/" } ], "days_since_create": [ { "numeric": [ ">", 28 ] } ] }, "action": "EXPIRE" } ] } }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的檢視物件生命週期政策。
-
如需API詳細資訊,請參閱 命令參考 GetLifecyclePolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 get-object
。
- AWS CLI
-
若要下載物件
下列
get-object
範例會將物件下載至指定的端點。aws mediastore-data get-object \ --endpoint
https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
\ --path=/folder_name/README.md
README.md輸出:
{ "ContentLength": "2307346", "ContentType": "image/jpeg", "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3", "StatusCode": 200 }
若要下載物件的一部分
下列
get-object
範例會將物件的一部分下載至指定的端點。aws mediastore-data get-object \ --endpoint
https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
\ --path/folder_name/README.md
\ --range="bytes=0-100"README2.md
輸出:
{ "StatusCode": 206, "ContentRange": "bytes 0-100/2307346", "ContentLength": "101", "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT", "ContentType": "image/jpeg", "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3" }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的下載物件。
-
如需API詳細資訊,請參閱 命令參考 GetObject
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 list-containers
。
- AWS CLI
-
檢視容器清單
下列
list-containers
範例顯示與您的帳戶相關聯的所有容器清單。aws mediastore list-containers
輸出:
{ "Containers": [ { "CreationTime": 1505317931, "Endpoint": "https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com", "Status": "ACTIVE", "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleLiveDemo", "AccessLoggingEnabled": false, "Name": "ExampleLiveDemo" }, { "CreationTime": 1506528818, "Endpoint": "https://fffggghhhiiijj.data.mediastore.us-west-2.amazonaws.com", "Status": "ACTIVE", "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer", "AccessLoggingEnabled": false, "Name": "ExampleContainer" } ] }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的檢視容器清單。
-
如需API詳細資訊,請參閱 命令參考 ListContainers
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 list-items
。
- AWS CLI
-
範例 1:檢視特定容器中的物件和資料夾清單
下列
list-items
範例顯示存放在指定容器中的項目 (物件和資料夾)。aws mediastore-data list-items \ --endpoint
https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
輸出:
{ "Items": [ { "ContentType": "image/jpeg", "LastModified": 1563571859.379, "Name": "filename.jpg", "Type": "OBJECT", "ETag": "543ab21abcd1a234ab123456a1a2b12345ab12abc12a1234abc1a2bc12345a12", "ContentLength": 3784 }, { "Type": "FOLDER", "Name": "ExampleLiveDemo" } ] }
範例 2:檢視特定資料夾中的物件和資料夾清單
下列
list-items
範例顯示存放在特定資料夾中的項目 (物件和資料夾)。aws mediastore-data list-items \ --endpoint
https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
輸出:
{ "Items": [ { "ContentType": "image/jpeg", "LastModified": 1563571859.379, "Name": "filename.jpg", "Type": "OBJECT", "ETag": "543ab21abcd1a234ab123456a1a2b12345ab12abc12a1234abc1a2bc12345a12", "ContentLength": 3784 }, { "Type": "FOLDER", "Name": "ExampleLiveDemo" } ] }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的檢視物件清單。
-
如需API詳細資訊,請參閱 命令參考 ListItems
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 list-tags-for-resource
。
- AWS CLI
-
列出容器的標籤
下列
list-tags-for-resource
範例顯示指派給指定容器的標籤索引鍵和值。aws mediastore list-tags-for-resource \ --resource
arn:aws:mediastore:us-west-2:1213456789012:container/ExampleContainer
輸出:
{ "Tags": [ { "Value": "Test", "Key": "Environment" }, { "Value": "West", "Key": "Region" } ] }
如需詳細資訊,請參閱 元素參考 ListTagsForResource中的 。 AWS MediaStore API
-
如需API詳細資訊,請參閱 命令參考 ListTagsForResource
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 put-container-policy
。
- AWS CLI
-
編輯容器政策
下列
put-container-policy
範例會將不同的政策指派給指定的容器。在此範例中,更新的政策是在名為 的檔案中定義LiveEventsContainerPolicy.json
。aws mediastore put-container-policy \ --container-name
LiveEvents
\ --policyfile://LiveEventsContainerPolicy.json
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的編輯容器政策。
-
如需API詳細資訊,請參閱 命令參考 PutContainerPolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 put-cors-policy
。
- AWS CLI
-
範例 1:新增CORS政策
下列
put-cors-policy
範例會將跨來源資源共用 (CORS) 政策新增至指定的容器。CORS 政策的內容位於名為 的檔案中corsPolicy.json
。aws mediastore put-cors-policy \ --container-name
ExampleContainer
\ --cors-policyfile://corsPolicy.json
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的將CORS政策新增至容器。
範例 2:編輯CORS政策
下列
put-cors-policy
範例會更新指派給指定容器的跨來源資源共用 (CORS) 政策。已更新CORS政策的內容位於名為 的檔案中corsPolicy2.json
。如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的編輯CORS政策。
-
如需API詳細資訊,請參閱 命令參考 PutCorsPolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 put-lifecycle-policy
。
- AWS CLI
-
建立物件生命週期政策
下列
put-lifecycle-policy
範例會將物件生命週期政策連接至指定的容器。這可讓您指定服務應該在容器中存放物件的時間長度。當物件達到過期日期時,刪除容器中的 MediaStore 物件,如 政策中所述,該政策位於名為 的檔案中LiveEventsLifecyclePolicy.json
。aws mediastore put-lifecycle-policy \ --container-name
ExampleContainer
\ --lifecycle-policyfile://ExampleLifecyclePolicy.json
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的將物件生命週期政策新增至容器。
-
如需API詳細資訊,請參閱 命令參考 PutLifecyclePolicy
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 put-object
。
- AWS CLI
-
若要上傳物件
下列
put-object
範例會將物件上傳至指定的容器。您可以指定資料夾路徑,其中會將物件儲存在容器內。如果資料夾已存在, AWS Elemental 會將物件 MediaStore 存放在資料夾中。如果資料夾不存在,服務會建立它,然後將物件存放在資料夾中。aws mediastore-data put-object \ --endpoint
https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com
\ --bodyREADME.md
\ --path/folder_name/README.md
\ --cache-control"max-age=6, public"
\ --content-typebinary/octet-stream
輸出:
{ "ContentSHA256": "74b5fdb517f423ed750ef214c44adfe2be36e37d861eafe9c842cbe1bf387a9d", "StorageClass": "TEMPORAL", "ETag": "af3e4731af032167a106015d1f2fe934e68b32ed1aa297a9e325f5c64979277b" }
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的上傳物件。
-
如需API詳細資訊,請參閱 命令參考 PutObject
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 start-access-logging
。
- AWS CLI
-
在容器上啟用存取日誌
下列
start-access-logging
範例會在指定的容器上啟用存取記錄。aws mediastore start-access-logging \ --container-name
LiveEvents
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的為容器啟用存取日誌。
-
如需API詳細資訊,請參閱 命令參考 StartAccessLogging
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 stop-access-logging
。
- AWS CLI
-
在容器上停用存取記錄
下列
stop-access-logging
範例會在指定的容器上停用存取記錄。aws mediastore stop-access-logging \ --container-name
LiveEvents
此命令不會產生輸出。
如需詳細資訊,請參閱 AWS 元素 MediaStore 使用者指南 中的停用容器的存取日誌。
-
如需API詳細資訊,請參閱 命令參考 StopAccessLogging
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 tag-resource
。
- AWS CLI
-
將標籤新增至容器
下列
tag-resource
範例會將標籤索引鍵和值新增至指定的容器。aws mediastore tag-resource \ --resource
arn:aws:mediastore:us-west-2:123456789012:container/ExampleContainer
\ --tags '[{"Key": "Region", "Value": "West"}, {"Key": "Environment", "Value": "Test"}]
'此命令不會產生輸出。
如需詳細資訊,請參閱 元素參考 TagResource中的 。 AWS MediaStore API
-
如需API詳細資訊,請參閱 命令參考 TagResource
中的 。 AWS CLI
-
下列程式碼範例示範如何使用 untag-resource
。
- AWS CLI
-
從容器移除標籤
下列
untag-resource
範例會從容器移除指定的標籤金鑰及其相關聯的值。aws mediastore untag-resource \ --resource
arn:aws:mediastore:us-west-2:123456789012:container/ExampleContainer
\ --tag-keysRegion
此命令不會產生輸出。
如需詳細資訊,請參閱 元素參考UntagResource中的。 AWS MediaStore API
-
如需API詳細資訊,請參閱 命令參考 UntagResource
中的 。 AWS CLI
-