使用的 MediaStore 範例 AWS CLI

下列程式碼範例示範如何使用 AWS Command Line Interface with 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 Elemental MediaStore 使用者指南中的建立容器。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 CreateContainer。

下列程式碼範例示範如何使用 delete-container-policy。

AWS CLI

若要刪除容器政策

下列delete-container-policy範例會刪除指派給指定容器的政策。刪除政策時， AWS Elemental MediaStore 會自動將預設政策指派給容器。


aws mediastore delete-container-policy \
    --container-name LiveEvents

此命令不會產生輸出。

如需詳細資訊，請參閱 ElementalWordWord 參考DeleteContainerPolicy中的 Word。 AWS MediaStore API

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 DeleteContainerPolicy。

下列程式碼範例示範如何使用 delete-container。

AWS CLI

若要刪除容器

下列delete-container範例會刪除指定的容器。只有當容器沒有任何物件時，您才可以將該容器刪除。


aws mediastore delete-container \
    --container-name=ExampleLiveDemo

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS Elemental MediaStore 使用者指南中的刪除容器。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 DeleteContainer。

下列程式碼範例示範如何使用 delete-cors-policy。

AWS CLI

若要刪除 CORS 政策

下列delete-cors-policy範例會刪除指派給指定容器的跨來源資源共用 (CORS) 政策。


aws mediastore delete-cors-policy \
    --container-name ExampleContainer

此命令不會產生輸出。

如需詳細資訊，請參閱 ElementalCORS 使用者指南中的刪除 Word 政策。 AWS MediaStore

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 DeleteCorsPolicy。

下列程式碼範例示範如何使用 delete-lifecycle-policy。

AWS CLI

若要刪除物件生命週期政策

下列delete-lifecycle-policy範例會刪除連接至指定容器的物件生命週期政策。此變更最多可能需要 20 分鐘才會生效。


aws mediastore delete-lifecycle-policy \
    --container-name LiveEvents

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS Elemental MediaStore 使用者指南中的刪除物件生命週期政策。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 DeleteLifecyclePolicy。

下列程式碼範例示範如何使用 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 Elemental MediaStore 使用者指南中的檢視容器的詳細資訊。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 DescribeContainer。

下列程式碼範例示範如何使用 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 Elemental MediaStore 使用者指南中的檢視物件的詳細資訊。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 DescribeObject。

下列程式碼範例示範如何使用 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 Elemental MediaStore 使用者指南中的檢視容器政策。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 GetContainerPolicy。

下列程式碼範例示範如何使用 get-cors-policy。

AWS CLI

檢視 CORS 政策

下列get-cors-policy範例顯示指派給指定容器的跨來源資源共用 (CORS) 政策。


aws mediastore get-cors-policy \
    --container-name ExampleContainer \
    --region us-west-2

輸出：


{
    "CorsPolicy": [
        {
            "AllowedMethods": [
                "GET",
                "HEAD"
            ],
            "MaxAgeSeconds": 3000,
            "AllowedOrigins": [
                ""
            ],
            "AllowedHeaders": [
                ""
            ]
        }
    ]
}

如需詳細資訊，請參閱 ElementalCORS 使用者指南中的檢視 Word 政策。 AWS MediaStore

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 GetCorsPolicy。

下列程式碼範例示範如何使用 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 Elemental MediaStore 使用者指南中的檢視物件生命週期政策。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 GetLifecyclePolicy。

下列程式碼範例示範如何使用 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 Elemental MediaStore 使用者指南中的下載物件。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 GetObject。

下列程式碼範例示範如何使用 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 Elemental MediaStore 使用者指南中的檢視容器清單。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 ListContainers。

下列程式碼範例示範如何使用 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 Elemental MediaStore 使用者指南中的檢視物件清單。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 ListItems。

下列程式碼範例示範如何使用 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"
        }
    ]
}

如需詳細資訊，請參閱 ElementalWordWord 參考ListTagsForResource中的 Word。 AWS MediaStore API

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 ListTagsForResource。

下列程式碼範例示範如何使用 put-container-policy。

AWS CLI

編輯容器政策

下列put-container-policy範例會將不同的政策指派給指定的容器。在此範例中，更新的政策是在名為的檔案中定義LiveEventsContainerPolicy.json。


aws mediastore put-container-policy \
    --container-name LiveEvents \
    --policy file://LiveEventsContainerPolicy.json

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS Elemental MediaStore 使用者指南中的編輯容器政策。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 PutContainerPolicy。

下列程式碼範例示範如何使用 put-cors-policy。

AWS CLI

範例 1：新增 CORS 政策

下列put-cors-policy範例會將跨來源資源共用 (CORS) 政策新增至指定的容器。CORS 政策的內容位於名為的檔案中corsPolicy.json。


aws mediastore put-cors-policy \
    --container-name ExampleContainer \
    --cors-policy file://corsPolicy.json

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS Elemental MediaStore 使用者指南中的將 CORS 政策新增至容器。

範例 2：編輯 CORS 政策

下列put-cors-policy範例會更新指派給指定容器的跨來源資源共用 (CORS) 政策。更新的 CORS 政策內容位於名為的檔案中corsPolicy2.json。

如需詳細資訊，請參閱 ElementalCORS 使用者指南中的編輯 Word 政策。 AWS MediaStore

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 PutCorsPolicy。

下列程式碼範例示範如何使用 put-lifecycle-policy。

AWS CLI

建立物件生命週期政策

下列put-lifecycle-policy範例會將物件生命週期政策連接至指定的容器。這可讓您指定服務應該在容器中存放物件的時間長度。 MediaStore 會在物件到達過期日期時刪除容器中的物件，如政策中所述，該政策位於名為的檔案中LiveEventsLifecyclePolicy.json。


aws mediastore put-lifecycle-policy \
    --container-name ExampleContainer \
    --lifecycle-policy file://ExampleLifecyclePolicy.json

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS Elemental MediaStore 使用者指南中的將物件生命週期政策新增至容器。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 PutLifecyclePolicy。

下列程式碼範例示範如何使用 put-object。

AWS CLI

若要上傳物件

下列put-object範例會將物件上傳至指定的容器。您可以指定資料夾路徑，其中物件將儲存在容器內。如果資料夾已存在， AWS Elemental MediaStore 會將物件存放在資料夾中。如果資料夾不存在，服務會建立資料夾，然後將物件存放在資料夾中。


aws mediastore-data put-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --body README.md \
    --path /folder_name/README.md \
    --cache-control "max-age=6, public" \
    --content-type binary/octet-stream

輸出：


{
    "ContentSHA256": "74b5fdb517f423ed750ef214c44adfe2be36e37d861eafe9c842cbe1bf387a9d",
    "StorageClass": "TEMPORAL",
    "ETag": "af3e4731af032167a106015d1f2fe934e68b32ed1aa297a9e325f5c64979277b"
}

如需詳細資訊，請參閱 AWS Elemental MediaStore 使用者指南中的上傳物件。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 PutObject。

下列程式碼範例示範如何使用 start-access-logging。

AWS CLI

在容器上啟用存取日誌

下列start-access-logging範例會在指定的容器上啟用存取記錄。


aws mediastore start-access-logging \
    --container-name LiveEvents

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS Elemental MediaStore 使用者指南中的啟用容器的存取日誌。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 StartAccessLogging。

下列程式碼範例示範如何使用 stop-access-logging。

AWS CLI

在容器上停用存取記錄

下列stop-access-logging範例會在指定的容器上停用存取記錄。


aws mediastore stop-access-logging \
    --container-name LiveEvents

此命令不會產生輸出。

如需詳細資訊，請參閱 AWS Elemental MediaStore 使用者指南中的停用容器的存取日誌。

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 StopAccessLogging。

下列程式碼範例示範如何使用 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"}]'

此命令不會產生輸出。

如需詳細資訊，請參閱 ElementalWordTagResource 參考中的 Word。 AWS MediaStore API

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 TagResource。

下列程式碼範例示範如何使用 untag-resource。

AWS CLI

從容器移除標籤

下列untag-resource範例會從容器移除指定的標籤金鑰及其相關聯的值。


aws mediastore untag-resource \
    --resource arn:aws:mediastore:us-west-2:123456789012:container/ExampleContainer \
    --tag-keys Region

此命令不會產生輸出。

如需詳細資訊，請參閱 ElementalWordWord 參考UntagResource中的 Word。 AWS MediaStore API

如需 API 詳細資訊，請參閱 AWS CLI 命令參考中的 UntagResource。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

ElastiCache

Amazon EMR

使用 的 MediaStore 範例 AWS CLI

主題

動作

使用的 MediaStore 範例 AWS CLI