Aktualisieren einer Storage-Lens-Gruppe

In den folgenden Beispielen wird veranschaulicht, wie eine Amazon-S3-Storage-Lens-Gruppe aktualisiert wird. Sie können eine Storage-Lens-Gruppe mithilfe der Amazon-S3-Konsole, der AWS Command Line Interface (AWS CLI) und des AWS SDK for Java aktualisieren.

Verwenden der S3-Konsole

So aktualisieren Sie eine Storage-Lens-Gruppe

1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon-S3-Konsole unter https://console.aws.amazon.com/s3/.

2. Wählen Sie im linken Navigationsbereich die Option Storage-Lens-Gruppen aus.

3. Wählen Sie unter Storage-Lens-Gruppen die zu aktualisierende Storage-Lens-Gruppe aus.

4. Wählen Sie unter Umfang die Option Bearbeiten aus.

5. Wählen Sie auf der Seite Umfang den Filter aus, der auf die Storage-Lens-Gruppe angewendet werden soll. Zum Anwenden mehrerer Filter wählen Sie die Filter und dann den logischen Operator UND oder ODER aus.

   • Wählen Sie für den Filter Präfixe die Option Präfixe aus und geben Sie eine Präfixzeichenfolge ein. Zum Hinzufügen mehrerer Präfixe wählen Sie Präfix hinzufügen aus. Zum Entfernen eines Präfixes wählen Sie neben dem zu entfernenden Präfix Entfernen aus.

   • Geben Sie für den Filter Objekt-Tags das Schlüssel-Wert-Paar für das Objekt ein. Wählen Sie dann Tag hinzufügen aus. Zum Entfernen eines vorhandenen Tags wählen Sie neben dem zu entfernenden Tag Entfernen aus.

   • Wählen Sie für den Filter Suffixe die Option Suffixe aus und geben Sie eine Suffixzeichenfolge ein. Um mehrere Suffixe hinzuzufügen, wählen Sie Suffix hinzufügen aus. Zum Entfernen eines Suffixes wählen Sie neben dem zu entfernenden Suffix Entfernen aus.

   • Geben Sie für den Filter Alter den Altersbereich des Objekts in Tagen an. Wählen Sie Mindestobjektalter festlegen aus und geben Sie das Mindestalter des Objekts ein. Geben Sie für Das maximale Objektalter festlegen das maximale Objektalter ein.

   • Geben Sie für den Filter Größe den Objektgrößenbereich und die Maßeinheit an. Wählen Sie Mindestobjektgröße festlegen aus und geben Sie die Mindestobjektgröße ein. Geben Sie für Die maximale Objektgröße festlegen die maximale Objektgröße ein.

6. Wählen Sie Save Changes. Die Detailseite für die Storage-Lens-Gruppe wird angezeigt.

7. (Optional) Wenn Sie ein neues AWS-Ressourcen-Tag hinzufügen möchten, scrollen Sie zum Abschnitt AWS-Ressourcen-Tags und wählen Sie dann Tags hinzufügen aus. Die Seite Add tags (Tags hinzufügen) wird angezeigt.

   Fügen Sie das neue Schlüssel-Wert-Paar hinzu und wählen Sie dann Änderungen speichern aus. Die Detailseite für die Storage-Lens-Gruppe wird angezeigt.

8. (Optional) Wenn Sie ein vorhandenes AWS-Ressourcen-Tag entfernen möchten, scrollen Sie zum Abschnitt AWS-Ressourcen-Tags und wählen Sie das Ressourcen-Tag aus. Wählen Sie dann Löschen. Das Dialogfeld AWS-Ressourcen-Tags löschen wird angezeigt.

   Wählen Sie erneut Löschen aus, um das AWS-Ressourcen-Tag dauerhaft zu löschen.

   Anmerkung

   Nachdem Sie ein AWS-Ressourcen-Tag dauerhaft gelöscht haben, kann es nicht wiederhergestellt werden.

Verwendung von AWS CLI

Mit dem folgenden AWS CLI-Beispielbefehl werden die Konfigurationsdetails für eine Storage-Lens-Gruppe namens marketing-department zurückgegeben. Wenn Sie diesen Beispielbefehl verwenden möchten, ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3control get-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --name marketing-department

Im folgenden AWS CLI-Beispiel wird eine Storage-Lens-Gruppe aktualisiert. Wenn Sie diesen Beispielbefehl verwenden möchten, ersetzen Sie user input placeholders durch Ihre Informationen.

aws s3control update-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json

JSON-Beispielkonfigurationen finden Sie unter Konfiguration von Storage-Lens-Gruppen.

Verwenden des AWS-SDKs für Java

Im folgenden AWS SDK for Java-Beispiel werden die Konfigurationsdetails für die Storage-Lens-Gruppe Marketing-Department im Konto 111122223333 zurückgegeben. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie user input placeholders durch Ihre Informationen.

package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse;

public class GetStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .accountId(accountId).build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest);
            System.out.println(response);
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}

In dem folgenden Beispiel wird die Storage-Lens-Gruppe Marketing-Department im Konto 111122223333 aktualisiert. In diesem Beispiel wird der Dashboard-Umfang so aktualisiert, dass die Objekte berücksichtigt werden, die einem der folgenden Suffixe entsprechen: .png, .gif, .jpg oder .jpeg. Wenn Sie dieses Beispiel verwenden möchten, ersetzen Sie user input placeholders durch Ihre Informationen.

package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.UpdateStorageLensGroupRequest;

public class UpdateStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create updated filter.
            StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
                    .matchAnySuffix(".png", ".gif", ".jpg", ".jpeg")
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(suffixFilter)
                    .build();

            UpdateStorageLensGroupRequest updateStorageLensGroupRequest = UpdateStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId)
                    .build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.updateStorageLensGroup(updateStorageLensGroupRequest);
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}

JSON-Beispielkonfigurationen finden Sie unter Konfiguration von Storage-Lens-Gruppen.