Beispiele für Amazon S3 Control mit AWS CLI

Um einen Access Point zu erstellen

Im folgenden create-access-point Beispiel wird ein Access Point erstellt, der finance-ap nach dem Bucket business-records im Konto 123456789012 benannt ist. Bevor Sie dieses Beispiel ausführen, ersetzen Sie den Namen des Access Points, den Bucket-Namen und die Kontonummer durch die entsprechenden Werte für Ihren Anwendungsfall.

aws s3control create-access-point \
    --account-id 123456789012 \
    --bucket business-records \
    --name finance-ap

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Creating Access Points im Amazon Simple Storage Service Developer Guide.

So erstellen Sie einen Amazon S3 S3-Auftrag für Batch-Operationen

Im folgenden create-job Beispiel wird ein Amazon S3 S3-Auftrag für Batch-Operationen erstellt, um Objekte als zu kennzeichnenconfidential` in the bucket ``employee-records.

aws s3control create-job \
    --account-id 123456789012 \
    --operation '{"S3PutObjectTagging": { "TagSet": [{"Key":"confidential", "Value":"true"}] }}' \
    --report '{"Bucket":"arn:aws:s3:::employee-records-logs","Prefix":"batch-op-create-job", "Format":"Report_CSV_20180820","Enabled":true,"ReportScope":"AllTasks"}' \
    --manifest '{"Spec":{"Format":"S3BatchOperations_CSV_20180820","Fields":["Bucket","Key"]},"Location":{"ObjectArn":"arn:aws:s3:::employee-records-logs/inv-report/7a6a9be4-072c-407e-85a2-ec3e982f773e.csv","ETag":"69f52a4e9f797e987155d9c8f5880897"}}' \
    --priority 42 \
    --role-arn arn:aws:iam::123456789012:role/S3BatchJobRole

Ausgabe:

{
    "JobId": "93735294-df46-44d5-8638-6356f335324e"
}

Um eine Zugriffspunktrichtlinie zu löschen

Im folgenden delete-access-point-policy Beispiel wird die Zugriffspunktrichtlinie von dem Zugriffspunkt gelöscht, der finance-ap im Konto 123456789012 benannt ist. Bevor Sie dieses Beispiel ausführen, ersetzen Sie den Namen und die Kontonummer des Zugriffspunkts durch die entsprechenden Werte für Ihren Anwendungsfall.

aws s3control delete-access-point-policy \
    --account-id 123456789012 \
    --name finance-ap

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwaltung des Datenzugriffs mit Amazon S3 Access Points im Amazon Simple Storage Service Developer Guide.

Um einen Access Point zu löschen

Im folgenden delete-access-point Beispiel wird ein Access Point mit dem Namen finance-ap 123456789012 gelöscht. Bevor Sie dieses Beispiel ausführen, ersetzen Sie den Namen und die Kontonummer des Zugriffspunkts durch die entsprechenden Werte für Ihren Anwendungsfall.

aws s3control delete-access-point \
    --account-id 123456789012 \
    --name finance-ap

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwaltung des Datenzugriffs mit Amazon S3 Access Points im Amazon Simple Storage Service Developer Guide.

Um die Einstellungen für den öffentlichen Zugriff zu sperren, für ein Konto zu löschen

Im folgenden delete-public-access-block Beispiel werden die Einstellungen zum Blockieren des öffentlichen Zugriffs für das angegebene Konto gelöscht.

aws s3control delete-public-access-block \
    --account-id 123456789012

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Um einen Amazon S3 S3-Auftrag für Batch-Operationen zu beschreiben

Im Folgenden finden describe-job Sie die Konfigurationsparameter und den Status für den angegebenen Batch-Operationsauftrag.

aws s3control describe-job \
    --account-id 123456789012 \
    --job-id 93735294-df46-44d5-8638-6356f335324e

Ausgabe:

{
    "Job": {
        "TerminationDate": "2019-10-03T21:49:53.944Z",
        "JobId": "93735294-df46-44d5-8638-6356f335324e",
        "FailureReasons": [],
        "Manifest": {
            "Spec": {
                "Fields": [
                    "Bucket",
                    "Key"
                ],
                "Format": "S3BatchOperations_CSV_20180820"
            },
            "Location": {
                "ETag": "69f52a4e9f797e987155d9c8f5880897",
                "ObjectArn": "arn:aws:s3:::employee-records-logs/inv-report/7a6a9be4-072c-407e-85a2-ec3e982f773e.csv"
            }
        },
        "Operation": {
            "S3PutObjectTagging": {
                "TagSet": [
                    {
                        "Value": "true",
                        "Key": "confidential"
                    }
                ]
            }
        },
        "RoleArn": "arn:aws:iam::123456789012:role/S3BatchJobRole",
        "ProgressSummary": {
            "TotalNumberOfTasks": 8,
            "NumberOfTasksFailed": 0,
            "NumberOfTasksSucceeded": 8
        },
        "Priority": 42,
        "Report": {
            "ReportScope": "AllTasks",
            "Format": "Report_CSV_20180820",
            "Enabled": true,
            "Prefix": "batch-op-create-job",
            "Bucket": "arn:aws:s3:::employee-records-logs"
        },
        "JobArn": "arn:aws:s3:us-west-2:123456789012:job/93735294-df46-44d5-8638-6356f335324e",
        "CreationTime": "2019-10-03T21:48:48.048Z",
        "Status": "Complete"
    }
}

Um den Status der Access Point-Richtlinie abzurufen

Im folgenden get-access-point-policy-status Beispiel wird der Status der Access Point-Richtlinie für den Access Point abgerufen, der finance-ap im Konto 123456789012 benannt ist. Der Status der Zugriffspunkt-Richtlinie gibt an, ob die Richtlinie des Zugriffspunkts öffentlichen Zugriff zulässt. Bevor Sie dieses Beispiel ausführen, ersetzen Sie den Namen und die Kontonummer des Access Points durch die entsprechenden Werte für Ihren Anwendungsfall.

aws s3control get-access-point-policy-status \
    --account-id 123456789012 \
    --name finance-ap

Ausgabe:

{
    "PolicyStatus": {
        "IsPublic": false
    }
}

Weitere Informationen darüber, wann eine Zugriffspunktrichtlinie als öffentlich betrachtet wird, finden Sie unter Die Bedeutung von „öffentlich“ im Amazon Simple Storage Service Developer Guide.

Um eine Zugriffspunktrichtlinie abzurufen

Im folgenden get-access-point-policy Beispiel wird die Zugriffspunktrichtlinie von dem Zugriffspunkt abgerufen, der finance-ap im Konto 123456789012 benannt ist. Bevor Sie dieses Beispiel ausführen, ersetzen Sie den Namen und die Kontonummer des Zugriffspunkts durch die entsprechenden Werte für Ihren Anwendungsfall.

aws s3control get-access-point-policy \
    --account-id 123456789012 \
    --name finance-ap

Ausgabe:

{
    "Policy": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::123456789012:role/Admin\"},\"Action\":\"s3:GetObject\",\"Resource\":\"arn:aws:s3:us-west-2:123456789012:accesspoint/finance-ap/object/records/*\"}]}"
}

Weitere Informationen finden Sie unter Verwaltung des Datenzugriffs mit Amazon S3 Access Points im Amazon Simple Storage Service Developer Guide.

Um die Konfigurationsdetails des Access Points abzurufen

Im folgenden get-access-point Beispiel werden die Konfigurationsdetails für den Access Point abgerufen, der finance-ap im Konto 123456789012 benannt ist. Bevor Sie dieses Beispiel ausführen, ersetzen Sie den Namen und die Kontonummer des Access Points durch die entsprechenden Werte für Ihren Anwendungsfall.

aws s3control get-access-point \
    --account-id 123456789012 \
    --name finance-ap

Ausgabe:

{
    "Name": "finance-ap",
    "Bucket": "business-records",
    "NetworkOrigin": "Internet",
    "PublicAccessBlockConfiguration": {
        "BlockPublicAcls": false,
        "IgnorePublicAcls": false,
        "BlockPublicPolicy": false,
        "RestrictPublicBuckets": false
    },
    "CreationDate": "2020-01-01T00:00:00Z"
}

Weitere Informationen finden Sie unter Verwaltung des Datenzugriffs mit Amazon S3 Access Points im Amazon Simple Storage Service Developer Guide.

Um die aktuelle Routenkonfiguration für Access Points mit mehreren Regionen abzufragen

Das folgende get-multi-region-access-point-routes Beispiel gibt die aktuelle Routingkonfiguration für den angegebenen Multiregion Access Point zurück.

aws s3control get-multi-region-access-point-routes \
    --region Region \
    --account-id 111122223333 \
    --mrap MultiRegionAccessPoint_ARN

Ausgabe:

{
    "Mrap": "arn:aws:s3::111122223333:accesspoint/0000000000000.mrap",
    "Routes": [
        {
            "Bucket": "amzn-s3-demo-bucket1",
            "Region": "ap-southeast-2",
            "TrafficDialPercentage": 100
        },
        {
            "Bucket": "amzn-s3-demo-bucket2",
            "Region": "us-west-1",
            "TrafficDialPercentage": 0
        }
    ]
}

Um öffentliche Blockzugriffseinstellungen für ein Konto aufzulisten

Im folgenden get-public-access-block Beispiel werden die Einstellungen zum Sperren des öffentlichen Zugriffs für das angegebene Konto angezeigt.

aws s3control get-public-access-block \
    --account-id 123456789012

Ausgabe:

{
   "PublicAccessBlockConfiguration": {
      "BlockPublicPolicy": true,
      "RestrictPublicBuckets": true,
      "IgnorePublicAcls": true,
      "BlockPublicAcls": true
   }
}

Beispiel 1: Um eine Liste aller Access Points für ein Konto abzurufen

Im folgenden list-access-points Beispiel wird eine Liste aller Access Points angezeigt, die an Buckets angehängt sind, die dem Konto 123456789012 gehören.

aws s3control list-access-points \
    --account-id 123456789012

Ausgabe:

{
    "AccessPointList": [
        {
            "Name": "finance-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "business-records"
        },
        {
            "Name": "managers-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "business-records"
        },
        {
            "Name": "private-network-ap",
            "NetworkOrigin": "VPC",
            "VpcConfiguration": {
                "VpcId": "1a2b3c"
            },
            "Bucket": "business-records"
        },
        {
            "Name": "customer-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "external-docs"
        },
        {
            "Name": "public-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "external-docs"
        }
    ]
}

Beispiel 2: Um eine Liste aller Access Points für einen Bucket abzurufen

Im folgenden list-access-points Beispiel wird eine Liste aller Access Points abgerufen, die an den Bucket angehängt sind, der dem Konto 123456789012 external-docs gehört.

aws s3control list-access-points \
    --account-id 123456789012 \
    --bucket external-docs

Ausgabe:

{
    "AccessPointList": [
        {
            "Name": "customer-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "external-docs"
        },
        {
            "Name": "public-ap",
            "NetworkOrigin": "Internet",
            "Bucket": "external-docs"
        }
    ]
}

Weitere Informationen finden Sie unter Verwaltung des Datenzugriffs mit Amazon S3 Access Points im Amazon Simple Storage Service Developer Guide.

Um ein Konto aufzulisten, Amazon S3 Batch Operations Jobs

Das folgende list-jobs Beispiel listet alle aktuellen Batch-Operationsaufträge für das angegebene Konto auf.

aws s3control list-jobs \
    --account-id 123456789012

Ausgabe:

{
    "Jobs": [
        {
            "Operation": "S3PutObjectTagging",
            "ProgressSummary": {
                "NumberOfTasksFailed": 0,
                "NumberOfTasksSucceeded": 8,
                "TotalNumberOfTasks": 8
            },
            "CreationTime": "2019-10-03T21:48:48.048Z",
            "Status": "Complete",
            "JobId": "93735294-df46-44d5-8638-6356f335324e",
            "Priority": 42
        },
        {
            "Operation": "S3PutObjectTagging",
            "ProgressSummary": {
                "NumberOfTasksFailed": 0,
                "NumberOfTasksSucceeded": 0,
                "TotalNumberOfTasks": 0
            },
            "CreationTime": "2019-10-03T21:46:07.084Z",
            "Status": "Failed",
            "JobId": "3f3c7619-02d3-4779-97f6-1d98dd313108",
            "Priority": 42
        },
    ]
}

Um eine Zugriffspunktrichtlinie festzulegen

Im folgenden put-access-point-policy Beispiel wird die angegebene Zugriffspunktrichtlinie für den Zugriffspunkt finance-ap im Konto 123456789012 platziert. Wenn der Access Point finance-ap bereits über eine Richtlinie verfügt, ersetzt dieser Befehl die vorhandene Richtlinie durch die in diesem Befehl angegebene Richtlinie. Bevor Sie dieses Beispiel ausführen, ersetzen Sie die Kontonummer, den Namen des Zugriffspunkts und die Richtlinienanweisungen durch entsprechende Werte für Ihren Anwendungsfall.

aws s3control put-access-point-policy \
    --account-id 123456789012 \
    --name finance-ap \
    --policy file://ap-policy.json

Inhalt von ap-policy.json:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:user/Alice"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:us-west-2:123456789012:accesspoint/finance-ap/object/Alice/*"
        }
    ]
}

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Verwaltung des Datenzugriffs mit Amazon S3 Access Points im Amazon Simple Storage Service Developer Guide.

So bearbeiten Sie die Einstellungen zum Blockieren des öffentlichen Zugriffs für ein Konto

Im folgenden put-public-access-block Beispiel werden alle Einstellungen zum Sperren des öffentlichen Zugriffs true für das angegebene Konto auf „Sperren des öffentlichen Zugriffs“ umgeschaltet.

aws s3control put-public-access-block \
    --account-id 123456789012 \
    --public-access-block-configuration '{"BlockPublicAcls": true, "IgnorePublicAcls": true, "BlockPublicPolicy": true, "RestrictPublicBuckets": true}'

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So aktualisieren Sie die Routing-Konfiguration Ihres Access Points für mehrere Regionen

Im folgenden submit-multi-region-access-point-routes Beispiel werden die Routing-Status von amzn-s3-demo-bucket1 und amzn-s3-demo-bucket2 in der ap-southeast-2 Region für Ihren Multi-Region Access Point aktualisiert.

aws s3control submit-multi-region-access-point-routes \
    --region ap-southeast-2 \
    --account-id 111122223333 \
    --mrap MultiRegionAccessPoint_ARN \
    --route-updates Bucket=amzn-s3-demo-bucket1,TrafficDialPercentage=100 Bucket=amzn-s3-demo-bucket2,TrafficDialPercentage=0

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So aktualisieren Sie die Auftragspriorität eines Amazon S3 S3-Auftrags für Batch-Operationen

Im folgenden update-job-priority Beispiel wird der angegebene Job auf eine neue Priorität aktualisiert.

aws s3control update-job-priority \
    --account-id 123456789012 \
    --job-id 8d9a18fe-c303-4d39-8ccc-860d372da386 \
    --priority 52

Ausgabe:

{
    "JobId": "8d9a18fe-c303-4d39-8ccc-860d372da386",
    "Priority": 52
}

So aktualisieren Sie den Status eines Amazon S3 S3-Auftrags für Batch-Operationen

Im folgenden update-job-status Beispiel wird der angegebene Job storniert, der auf seine Genehmigung wartet.

aws s3control update-job-status \
    --account-id 123456789012 \
    --job-id 8d9a18fe-c303-4d39-8ccc-860d372da386 \
    --requested-job-status Cancelled

Ausgabe:

{
    "Status": "Cancelled",
    "JobId": "8d9a18fe-c303-4d39-8ccc-860d372da386"
}

Im folgenden update-job-status Beispiel wird der angegebene, auf Genehmigung wartende Vorgang bestätigt und ausgeführt.

aws s3control update-job-status \
    --account-id 123456789012 \
    --job-id 5782949f-3301-4fb3-be34-8d5bab54dbca \
    --requested-job-status Ready

Output::

{
    "Status": "Ready",
    "JobId": "5782949f-3301-4fb3-be34-8d5bab54dbca"
}

Im folgenden update-job-status Beispiel wird der angegebene Job, der gerade ausgeführt wird, abgebrochen.

 aws s3control update-job-status \
    --account-id 123456789012 \
    --job-id 5782949f-3301-4fb3-be34-8d5bab54dbca \
    --requested-job-status Cancelled

Output::
{
         "Status": "Cancelling",
         "JobId": "5782949f-3301-4fb3-be34-8d5bab54dbca"
}