Atualização do grupo da Lente de Armazenamento - Amazon Simple Storage Service

Atualização do grupo da Lente de Armazenamento

Os exemplos a seguir demonstram como atualizar um grupo da Lente de Armazenamento do Amazon S3. Você pode atualizar um grupo da Lente de Armazenamento usando o console Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK for Java.

Para atualizar um grupo da Lente de Armazenamento

  1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. No painel de navegação à esquerda, selecione Grupos de Lente de Armazenamento.

  3. Em Grupos da Lente de Armazenamento, selecione o grupo a ser atualizado.

  4. Em Escopo, selecione Editar.

  5. Na página Escopo, selecione o filtro a ser aplicado no grupo da Lente de Armazenamento. Para aplicar vários filtros, selecione os filtros e escolha o operador lógico AND ou OR.

    • Para o filtro Prefixos, selecione Prefixos e insira uma sequência de prefixo. Para adicionar vários prefixos, selecione Adicionar prefixo. Para remover um prefixo, selecione Remover ao lado do prefixo para remover.

    • Para o filtro Tags de objeto, insira o par de valores-chave ao objeto. Selecione Adicionar tag. Para remover uma tag, selecione Remover ao lado da tag para remover.

    • Para o filtro Sufixos, selecione Sufixos e insira uma sequência de sufixo. Para adicionar vários sufixos, selecione Adicionar sufixo. Para remover um sufixo, selecione Remover ao lado do sufixo para remover.

    • Para o filtro Idade, especifique a faixa etária do objeto em dias. Selecione Especificar idade mínima do objeto e insira a idade mínima do objeto. Em Especificar idade máxima do objeto, insira a idade máxima do objeto.

    • Para o filtro Tamanho, especifique a faixa de tamanho do objeto e a unidade de medida. Selecione Especificar tamanho mínimo do objeto e insira o tamanho mínimo do objeto. Em Especificar tamanho máximo do objeto, insira o tamanho máximo do objeto.

  6. Escolha Salvar alterações. A página de detalhes do grupo da Lente de Armazenamento é exibida.

  7. (Opcional) Para adicionar uma nova tag de recursos AWS, acesse a seção Tags de recursos AWS e selecione Adicionar tags. A página Adicionar tags é exibida.

    Adicione o novo par de valores-chave e selecione Salvar alterações. A página de detalhes do grupo da Lente de Armazenamento é exibida.

  8. (Opcional) Para remover uma tag de recursos existente AWS, acesse a seção Tags de recurso AWS e selecione a tag de recursos. Em seguida, selecione Excluir. A caixa de diálogo Excluir tags AWS é exibida.

    Selecione Excluir novamente para excluir permanentemente a tag de recursos AWS.

    nota

    Depois de excluir permanentemente uma tag de recursos AWS, ela não poderá ser restaurada.

O comando de exemplo AWS CLI a seguir mostra os detalhes da configuração de um grupo da Lente de Armazenamento marketing-department. Para usar esse exemplo de comando, substitua os user input placeholders por suas próprias informações.

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

O exemplo AWS CLI a seguir atualiza um grupo da Lente de Armazenamento. Para usar esse exemplo de comando, substitua os user input placeholders por suas próprias informações. 

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

Para obter configurações de exemplo JSON, consulte Configuração de grupos da Lente de Armazenamento.

O exemplo AWS SDK for Java a seguir mostra os detalhes da configuração do grupo da Lente de Armazenamento Marketing-Department na conta 111122223333. Para usar esse exemplo, substitua os user input placeholders por suas próprias informações.

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();
        }
    }
}

O exemplo a seguir atualiza o grupo da Lente de Armazenamento Marketing-Department na conta 111122223333. Esse exemplo atualiza o escopo do painel para incluir objetos que correspondam a qualquer um dos seguintes sufixos: .png, .gif, .jpg ou .jpeg. Para usar esse exemplo, substitua os user input placeholders por suas próprias informações.

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();
        }
    }
}

Para obter configurações de exemplo JSON, consulte Configuração de grupos da Lente de Armazenamento.