Beispiele für die Verwendung der AWS CLI mit MediaStore - AWS Command Line Interface
Aktionen

Beispiele für die Verwendung der AWS CLI mit MediaStore

Die folgenden Codebeispiele zeigen, wie Sie Aktionen durchführen und gängige Szenarien implementieren, indem Sie die AWS Command Line Interface mit MediaStore nutzen.

Aktionen sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.

Jedes Beispiel enthält einen Link zum vollständigen Quellcode, wo Sie Anleitungen zum Einrichten und Ausführen des Codes im Kontext finden.

Themen

Aktionen

Das folgende Codebeispiel zeigt, wie create-container verwendet wird.

AWS CLI

So erstellen Sie einen Container

Im folgenden Beispiel für create-container wird ein neuer leerer Container erstellt.

aws mediastore create-container --container-name ExampleContainer

Ausgabe:

{
    "Container": {
        "AccessLoggingEnabled": false,
        "CreationTime": 1563557265,
        "Name": "ExampleContainer",
        "Status": "CREATING",
        "ARN": "arn:aws:mediastore:us-west-2:111122223333:container/ExampleContainer"
    }
}

Weitere Informationen finden Sie unter Erstellen eines Containers im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter CreateContainer in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-container-policy verwendet wird.

AWS CLI

So löschen Sie eine Container-Richtlinie

Im folgenden Beispiel für delete-container-policy wird die Richtlinie gelöscht, die dem angegebenen Container zugewiesen wurde. Wenn die Richtlinie gelöscht wird, weist AWS Elemental MediaStore dem Container automatisch die Standardrichtlinie zu.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter DeleteContainerPolicy in der API-Referenz zu AWS Elemental MediaStore.

Das folgende Codebeispiel zeigt, wie delete-container verwendet wird.

AWS CLI

So löschen Sie einen Container

Im folgenden Beispiel für delete-container wird der angegebene Container gelöscht. Sie können einen Container nur löschen, wenn er keine Objekte enthält.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen eines Containers im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter DeleteContainer in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-cors-policy verwendet wird.

AWS CLI

So löschen Sie eine CORS-Richtlinie

Im folgenden Beispiel für delete-cors-policy wird die CORS-Richtlinie (Cross-Origin Resource Sharing) gelöscht, die dem angegebenen Container zugewiesen wurde.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen einer CORS-Richtlinie im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter DeleteCorsPolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie delete-lifecycle-policy verwendet wird.

AWS CLI

So löschen Sie eine Objektlebenszyklus-Richtlinie

Im folgenden Beispiel für delete-lifecycle-policy wird die Objektlebenszyklus-Richtlinie gelöscht, die dem angegebenen Container zugewiesen wurde. Es dauert bis zu 20 Minuten, bis die Änderung wirksam wird.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Löschen einer Objektlebenszyklus-Richtlinie im Benutzerhandbuch zu AWS Elemental MediaStore.

Das folgende Codebeispiel zeigt, wie describe-container verwendet wird.

AWS CLI

So zeigen Sie die Details für einen Container an

Im folgenden Beispiel für describe-container werden die Details des angegebenen Containers angezeigt.

aws mediastore describe-container \
    --container-name ExampleContainer

Ausgabe:

{
    "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"
    }
}

Weitere Informationen finden Sie unter Anzeigen der Details für einen Container im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter DescribeContainer in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie describe-object verwendet wird.

AWS CLI

So zeigen Sie eine Liste der Objekte und Ordner in einem bestimmten Container an

Im folgenden Beispiel für describe-object werden Elemente (Objekte und Ordner) angezeigt, die in einem angegebenen Container gespeichert sind.

aws mediastore-data describe-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path /folder_name/file1234.jpg

Ausgabe:

{
    "ContentType": "image/jpeg",
    "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT",
    "ContentLength": "2307346",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}

Weitere Informationen finden Sie unter Anzeigen der Details eines Objekts im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter DescribeObject in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-container-policy verwendet wird.

AWS CLI

Anzeige einer Containerrichtlinie

Im folgenden Beispiel für get-container-policy wird die ressourcenbasierte Richtlinie des angegebenen Containers angezeigt.

aws mediastore get-container-policy \
    --container-name ExampleLiveDemo

Ausgabe:

{
    "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"
                    }
                }
            }
        ]
    }
}

Weitere Informationen finden Sie unter Anzeigen einer Containerrichtlinie im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter GetContainerPolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-cors-policy verwendet wird.

AWS CLI

So zeigen Sie eine CORS-Richtlinie an

Im folgenden Beispiel für get-cors-policy wird die CORS-Richtlinie (Cross-Origin Resource Sharing) angezeigt, die dem angegebenen Container zugewiesen wurde.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Anzeigen einer CORS-Richtlinie im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter GetCorsPolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-lifecycle-policy verwendet wird.

AWS CLI

So zeigen Sie eine Objektlebenszyklus-Richtlinie an

Im folgenden Beispiel für get-lifecycle-policy wird die Objektlebenszyklus-Richtlinie angezeigt, die dem angegebenen Container zugewiesen wurde.

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

Ausgabe:

{
    "LifecyclePolicy": {
        "rules": [
            {
                "definition": {
                    "path": [
                        {
                            "prefix": "Football/"
                        },
                        {
                            "prefix": "Baseball/"
                        }
                    ],
                    "days_since_create": [
                        {
                            "numeric": [
                                ">",
                                28
                            ]
                        }
                    ]
                },
                "action": "EXPIRE"
            }
        ]
    }
}

Weitere Informationen finden Sie unter Anzeigen einer Objektlebenszyklus-Richtlinie im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter GetLifecyclePolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie get-object verwendet wird.

AWS CLI

So laden Sie ein Objekt herunter

Im folgenden Beispiel für get-object wird ein Objekt in den angegebenen Endpunkt heruntergeladen.

aws mediastore-data get-object \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com \
    --path=/folder_name/README.md README.md

Ausgabe:

{
    "ContentLength": "2307346",
    "ContentType": "image/jpeg",
    "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3",
    "StatusCode": 200
}

So laden Sie einen Teil eines Objekts herunter

Im folgenden Beispiel für get-object wird ein Teil eines Objekts in den angegebenen Endpunkt heruntergeladen.

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

Ausgabe:

{
    "StatusCode": 206,
    "ContentRange": "bytes 0-100/2307346",
    "ContentLength": "101",
    "LastModified": "Fri, 19 Jul 2019 21:32:20 GMT",
    "ContentType": "image/jpeg",
    "ETag": "2aa333bbcc8d8d22d777e999c88d4aa9eeeeee4dd89ff7f555555555555da6d3"
}

Weitere Informationen finden Sie unter Herunterladen eines Objekts im Benutzerhandbuch zu AWS Elemental MediaStore.

  • API-Details finden Sie unter GetObject in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-containers verwendet wird.

AWS CLI

So zeigen Sie eine Liste der Container an

Im folgenden Beispiel für list-containers wird eine Liste aller Container angezeigt, die dem Konto zugeordnet sind.

aws mediastore list-containers

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen einer Liste der Container im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter ListContainers in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-items verwendet wird.

AWS CLI

Beispiel 1: So zeigen Sie eine Liste der Objekte und Ordner in einem bestimmten Container an

Im folgenden Beispiel für list-items werden Elemente (Objekte und Ordner) angezeigt, die im angegebenen Container gespeichert sind.

aws mediastore-data list-items \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com

Ausgabe:

{
    "Items": [
        {
            "ContentType": "image/jpeg",
            "LastModified": 1563571859.379,
            "Name": "filename.jpg",
            "Type": "OBJECT",
            "ETag": "543ab21abcd1a234ab123456a1a2b12345ab12abc12a1234abc1a2bc12345a12",
            "ContentLength": 3784
        },
        {
            "Type": "FOLDER",
            "Name": "ExampleLiveDemo"
        }
    ]
}

Beispiel 2: So zeigen Sie eine Liste der Objekte und Ordner in einem bestimmten Ordner an

Im folgenden Beispiel für list-items werden Elemente (Objekte und Ordner) angezeigt, die in einem bestimmten Ordner gespeichert sind.

aws mediastore-data list-items \
    --endpoint https://aaabbbcccdddee.data.mediastore.us-west-2.amazonaws.com

Ausgabe:

{
    "Items": [
        {
            "ContentType": "image/jpeg",
            "LastModified": 1563571859.379,
            "Name": "filename.jpg",
            "Type": "OBJECT",
            "ETag": "543ab21abcd1a234ab123456a1a2b12345ab12abc12a1234abc1a2bc12345a12",
            "ContentLength": 3784
        },
        {
            "Type": "FOLDER",
            "Name": "ExampleLiveDemo"
        }
    ]
}

Weitere Informationen finden Sie unter Anzeigen einer Liste von Objekten im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter ListItems in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie list-tags-for-resource verwendet wird.

AWS CLI

So listen Sie die Tags für einen Container auf

Im folgenden Beispiel für list-tags-for-resource werden die Tag-Schlüssel und -Werte angezeigt, die dem angegebenen Container zugeordnet wurden.

aws mediastore list-tags-for-resource \
    --resource arn:aws:mediastore:us-west-2:1213456789012:container/ExampleContainer

Ausgabe:

{
    "Tags": [
        {
            "Value": "Test",
            "Key": "Environment"
        },
        {
            "Value": "West",
            "Key": "Region"
        }
    ]
}

Weitere Informationen finden Sie unter ListTagsForResource in der API-Referenz zu AWS Elemental MediaStore.

Das folgende Codebeispiel zeigt, wie put-container-policy verwendet wird.

AWS CLI

So bearbeiten Sie eine Containerrichtlinie

Im folgenden Beispiel für put-container-policy wird dem angegebenen Container eine andere Richtlinie zugewiesen. In diesem Beispiel ist die aktualisierte Richtlinie in einer Datei mit dem Namen LiveEventsContainerPolicy.json definiert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Bearbeiten einer Containerrichtlinie im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter PutContainerPolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-cors-policy verwendet wird.

AWS CLI

Beispiel 1: So fügen Sie eine CORS-Richtlinie hinzu

Im folgenden Beispiel für put-cors-policy wird dem angegebenen Container eine CORS-Richtlinie (Cross-Origin Resource Sharing) zugewiesen. Der Inhalt der CORS-Richtlinie befindet sich in der Datei mit dem Namen corsPolicy.json.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Hinzufügen einer CORS-Richtlinie zu einem Container im Benutzerhandbuch zu AWS Elemental MediaStore.

Beispiel 2: So fügen Sie eine CORS-Richtlinie hinzu

Im folgenden Beispiel für put-cors-policy wird die CORS-Richtlinie (Cross-Origin Resource Sharing) aktualisiert, die dem angegebenen Container zugewiesen wurde. Der Inhalt der aktualisierten CORS-Richtlinie befindet sich in der Datei mit dem Namen corsPolicy2.json.

Weitere Informationen finden Sie unter Bearbeiten einer Containerrichtlinie im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter PutCorsPolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-lifecycle-policy verwendet wird.

AWS CLI

So erstellen Sie eine Objektlebenszyklus-Richtlinie

Im folgenden Beispiel für put-lifecycle-policy wird die Objektlebenszyklus-Richtlinie an den angegebenen Container angehängt. So können Sie angeben, wie lange der Service Objekte in Ihrem Container speichern soll. MediaStore löscht Objekte im Container, sobald sie ihr Ablaufdatum gemäß der Richtlinie, die sich in der Datei LiveEventsLifecyclePolicy.json befindet, erreicht haben.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Hinzufügen einer Objektlebenszyklus-Richtlinie zu einem Container im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter PutLifecyclePolicy in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie put-object verwendet wird.

AWS CLI

So laden Sie ein Objekt hoch

Im folgenden Beispiel für put-object wird ein Objekt in den angegebenen Container hochgeladen. Sie können einen Ordnerpfad angeben, unter dem das Objekt im Container gespeichert wird. Wenn der Ordner bereits vorhanden ist, speichert AWS Elemental MediaStore das Objekt im Ordner. Wenn der Ordner nicht vorhanden, legt der Service ihn an und speichert das Objekt in dem Ordner.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Hochladen eines Objekts im Benutzerhandbuch zu AWS Elemental MediaStore.

  • API-Details finden Sie unter PutObject in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie start-access-logging verwendet wird.

AWS CLI

So aktivieren Sie die Zugriffsprotokollierung für einen Container

Im folgenden Beispiel für start-access-logging wird die Zugriffsprotokollierung für den angegebenen Container aktiviert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Aktivieren der Zugriffsprotokollierung für einen Container im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter StartAccessLogging in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie stop-access-logging verwendet wird.

AWS CLI

So deaktivieren Sie die Zugriffsprotokollierung für einen Container

Im folgenden Beispiel für stop-access-logging wird die Zugriffsprotokollierung für den angegebenen Container deaktiviert.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Deaktivieren der Zugriffsprotokollierung für einen Container im Benutzerhandbuch zu AWS Elemental MediaStore.

  • Weitere Details zur API finden Sie unter StopAccessLogging in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie tag-resource verwendet wird.

AWS CLI

So fügen Sie Tags zu einem Container hinzu

Im folgenden Beispiel für tag-resource werden die Tag-Schlüssel und -Werte des angegebenen Containers angezeigt.

aws mediastore tag-resource \
    --resource arn:aws:mediastore:us-west-2:123456789012:container/ExampleContainer \
    --tags '[{"Key": "Region", "Value": "West"}, {"Key": "Environment", "Value": "Test"}]'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter TagResource in der API-Referenz zu AWS Elemental MediaStore.

  • API-Details finden Sie unter TagResource in der AWS CLI-Befehlsreferenz.

Das folgende Codebeispiel zeigt, wie untag-resource verwendet wird.

AWS CLI

So entfernen Sie Tags aus einem Container

Mit dem folgenden untag-resource-Befehl werden der angegebene Tag-Schlüssel und der ihm zugewiesene Wert aus dem Container entfernt.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter UntagResource in der API-Referenz zu AWS Elemental MediaStore.

  • API-Details finden Sie unter UntagResource in der AWS CLI-Befehlsreferenz.