Excluir objetos em buckets do Amazon S3 on Outposts
Objetos são as entidades fundamentais armazenadas no Amazon S3 on Outposts. Cada objeto está contido em um bucket. É necessário usar pontos de acesso para acessar qualquer objeto em um bucket do Outpost. Ao especificar o bucket para operações de objeto, use o nome do recurso da Amazon (ARN) do ponto de acesso ou o alias do ponto de acesso. Para obter mais informações sobre alias de pontos de acesso, consulte Usar um alias em estilo de bucket para seu ponto de acesso de bucket do S3 no Outposts.
O exemplo a seguir mostra o formato do ARN para pontos de acesso do S3 no Outposts, que inclui o código Região da AWS para a região em que o Outpost está hospedado, o ID da Conta da AWS, o ID do Outpost e o nome do ponto de acesso:
arn:aws:s3-outposts:
region
:account-id
:outpost/outpost-id
/accesspoint/accesspoint-name
Para obter mais informações sobre o S3 on Outposts, consulte ARNs de recurso para S3 no Outposts.
Com o Amazon S3 on Outposts, os dados do objeto são sempre armazenados no Outpost. Quando a AWS instala um rack do Outpost, seus dados permanecem no local do Outpost para atender aos requisitos de residência de dados. Seus objetos nunca saem do Outpost e não estão em uma Região da AWS. Como o AWS Management Console está hospedado na região, você não pode usá-lo para fazer upload de objetos no Outpost nem os gerenciar. No entanto, você pode usar a API REST, a AWS Command Line Interface (AWS CLI) e os SDKs para fazer upload de objetos e gerenciá-los por meio de seus pontos de acesso.
Os exemplos a seguir mostram como excluir um ou vários objetos em um bucket do S3 on Outposts usando a AWS Command Line Interface (AWS CLI) e o AWS SDK para Java.
Os exemplos a seguir mostram como excluir um único ou vários objetos de um bucket do S3 on Outposts.
- delete-object
-
O exemplo a seguir exclui um objeto chamado
sample-object.xml
de um bucket do S3 on Outposts (s3-outposts:DeleteObject
) usando a AWS CLI. Para usar esse comando, substitua cada
por suas próprias informações. Para obter mais informações sobre esse comando, consulte delete-objectuser input placeholder
na Referência de comandos da AWS CLI. aws s3api delete-object --bucket arn:aws:s3-outposts:
region
:123456789012
:outpost/op-01ac5d28a6a232904
/accesspoint/example-outposts-access-point
--keysample-object.xml
- delete-objects
-
O exemplo a seguir exclui dois objetos chamados
sample-object.xml
etest1.text
de um bucket do S3 on Outposts (s3-outposts:DeleteObject
) usando a AWS CLI. Para usar esse comando, substitua cada
por suas próprias informações. Para obter mais informações sobre esse comando, consulte delete-objectsuser input placeholder
na Referência de comandos da AWS CLI. aws s3api delete-objects --bucket arn:aws:s3-outposts:
region
:123456789012
:outpost/op-01ac5d28a6a232904
/accesspoint/example-outposts-access-point
--delete file://delete.json delete.json { "Objects": [ { "Key": "test1.txt" }, { "Key": "sample-object.xml" } ], "Quiet": false }
Uso do AWS CLI
Os exemplos a seguir mostram como excluir um único ou vários objetos de um bucket do S3 on Outposts.
- delete-object
-
O exemplo a seguir exclui um objeto chamado
sample-object.xml
de um bucket do S3 on Outposts (s3-outposts:DeleteObject
) usando a AWS CLI. Para usar esse comando, substitua cada
por suas próprias informações. Para obter mais informações sobre esse comando, consulte delete-objectuser input placeholder
na Referência de comandos da AWS CLI. aws s3api delete-object --bucket arn:aws:s3-outposts:
region
:123456789012
:outpost/op-01ac5d28a6a232904
/accesspoint/example-outposts-access-point
--keysample-object.xml
- delete-objects
-
O exemplo a seguir exclui dois objetos chamados
sample-object.xml
etest1.text
de um bucket do S3 on Outposts (s3-outposts:DeleteObject
) usando a AWS CLI. Para usar esse comando, substitua cada
por suas próprias informações. Para obter mais informações sobre esse comando, consulte delete-objectsuser input placeholder
na Referência de comandos da AWS CLI. aws s3api delete-objects --bucket arn:aws:s3-outposts:
region
:123456789012
:outpost/op-01ac5d28a6a232904
/accesspoint/example-outposts-access-point
--delete file://delete.json delete.json { "Objects": [ { "Key": "test1.txt" }, { "Key": "sample-object.xml" } ], "Quiet": false }
O exemplo a seguir exclui um objeto chamado sample-object.xml
de um bucket do S3 on Outposts (s3-outposts:DeleteObject
) usando a AWS CLI. Para usar esse comando, substitua cada
por suas próprias informações. Para obter mais informações sobre esse comando, consulte delete-objectuser input
placeholder
aws s3api delete-object --bucket arn:aws:s3-outposts:
region
:123456789012
:outpost/op-01ac5d28a6a232904
/accesspoint/example-outposts-access-point
--keysample-object.xml
Os exemplos a seguir mostram como excluir um único ou vários objetos de um bucket do S3 on Outposts.
- DeleteObject
-
O exemplo do S3 on Outposts a seguir exclui um objeto de um bucket usando o SDK para Java. Para usar este exemplo, especifique o ARN do ponto de acesso para o Outpost e o nome da chave para o objeto que você deseja excluir. Para obter mais informações, consulte DeleteObject na Referência da API do Amazon Simple Storage Service.
import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.services.s3.AmazonS3; import com.amazonaws.services.s3.AmazonS3ClientBuilder; import com.amazonaws.services.s3.model.DeleteObjectRequest; public class DeleteObject { public static void main(String[] args) { String accessPointArn = "
*** access point ARN ***
"; String keyName = "*** key name ****
"; try { // This code expects that you have AWS credentials set up per: // https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html AmazonS3 s3Client = AmazonS3ClientBuilder.standard() .enableUseArnRegion() .build(); s3Client.deleteObject(new DeleteObjectRequest(accessPointArn, keyName)); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it, so it 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(); } } } - DeleteObjects
-
O exemplo do S3 on Outposts a seguir faz upload e depois exclui objetos de um bucket usando o SDK para Java. Para usar este exemplo, especifique o ARN do ponto de acesso para o Outpost. Para obter mais informações, consulte DeleteObjects na Referência da API do Amazon Simple Storage Service.
import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.services.s3.AmazonS3; import com.amazonaws.services.s3.AmazonS3ClientBuilder; import com.amazonaws.services.s3.model.DeleteObjectsRequest; import com.amazonaws.services.s3.model.DeleteObjectsRequest.KeyVersion; import com.amazonaws.services.s3.model.DeleteObjectsResult; import java.util.ArrayList; public class DeleteObjects { public static void main(String[] args) { String accessPointArn = "arn:aws:s3-outposts:
region
:123456789012
:outpost/op-01ac5d28a6a232904
/accesspoint/example-outposts-access-point
"; try { // This code expects that you have AWS credentials set up per: // https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html AmazonS3 s3Client = AmazonS3ClientBuilder.standard() .enableUseArnRegion() .build(); // Upload three sample objects. ArrayList<KeyVersion> keys = new ArrayList<KeyVersion>(); for (int i = 0; i < 3; i++) { String keyName = "delete object example " + i; s3Client.putObject(accessPointArn, keyName, "Object number " + i + " to be deleted."); keys.add(new KeyVersion(keyName)); } System.out.println(keys.size() + " objects successfully created."); // Delete the sample objects. DeleteObjectsRequest multiObjectDeleteRequest = new DeleteObjectsRequest(accessPointArn) .withKeys(keys) .withQuiet(false); // Verify that the objects were deleted successfully. DeleteObjectsResult delObjRes = s3Client.deleteObjects(multiObjectDeleteRequest); int successfulDeletes = delObjRes.getDeletedObjects().size(); System.out.println(successfulDeletes + " objects successfully deleted."); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it, so it 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(); } } }
Usar o AWS SDK para Java
Os exemplos a seguir mostram como excluir um único ou vários objetos de um bucket do S3 on Outposts.
- DeleteObject
-
O exemplo do S3 on Outposts a seguir exclui um objeto de um bucket usando o SDK para Java. Para usar este exemplo, especifique o ARN do ponto de acesso para o Outpost e o nome da chave para o objeto que você deseja excluir. Para obter mais informações, consulte DeleteObject na Referência da API do Amazon Simple Storage Service.
import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.services.s3.AmazonS3; import com.amazonaws.services.s3.AmazonS3ClientBuilder; import com.amazonaws.services.s3.model.DeleteObjectRequest; public class DeleteObject { public static void main(String[] args) { String accessPointArn = "
*** access point ARN ***
"; String keyName = "*** key name ****
"; try { // This code expects that you have AWS credentials set up per: // https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html AmazonS3 s3Client = AmazonS3ClientBuilder.standard() .enableUseArnRegion() .build(); s3Client.deleteObject(new DeleteObjectRequest(accessPointArn, keyName)); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it, so it 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(); } } } - DeleteObjects
-
O exemplo do S3 on Outposts a seguir faz upload e depois exclui objetos de um bucket usando o SDK para Java. Para usar este exemplo, especifique o ARN do ponto de acesso para o Outpost. Para obter mais informações, consulte DeleteObjects na Referência da API do Amazon Simple Storage Service.
import com.amazonaws.AmazonServiceException; import com.amazonaws.SdkClientException; import com.amazonaws.services.s3.AmazonS3; import com.amazonaws.services.s3.AmazonS3ClientBuilder; import com.amazonaws.services.s3.model.DeleteObjectsRequest; import com.amazonaws.services.s3.model.DeleteObjectsRequest.KeyVersion; import com.amazonaws.services.s3.model.DeleteObjectsResult; import java.util.ArrayList; public class DeleteObjects { public static void main(String[] args) { String accessPointArn = "arn:aws:s3-outposts:
region
:123456789012
:outpost/op-01ac5d28a6a232904
/accesspoint/example-outposts-access-point
"; try { // This code expects that you have AWS credentials set up per: // https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html AmazonS3 s3Client = AmazonS3ClientBuilder.standard() .enableUseArnRegion() .build(); // Upload three sample objects. ArrayList<KeyVersion> keys = new ArrayList<KeyVersion>(); for (int i = 0; i < 3; i++) { String keyName = "delete object example " + i; s3Client.putObject(accessPointArn, keyName, "Object number " + i + " to be deleted."); keys.add(new KeyVersion(keyName)); } System.out.println(keys.size() + " objects successfully created."); // Delete the sample objects. DeleteObjectsRequest multiObjectDeleteRequest = new DeleteObjectsRequest(accessPointArn) .withKeys(keys) .withQuiet(false); // Verify that the objects were deleted successfully. DeleteObjectsResult delObjRes = s3Client.deleteObjects(multiObjectDeleteRequest); int successfulDeletes = delObjRes.getDeletedObjects().size(); System.out.println(successfulDeletes + " objects successfully deleted."); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it, so it 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 do S3 on Outposts a seguir exclui um objeto de um bucket usando o SDK para Java. Para usar este exemplo, especifique o ARN do ponto de acesso para o Outpost e o nome da chave para o objeto que você deseja excluir. Para obter mais informações, consulte DeleteObject na Referência da API do Amazon Simple Storage Service.
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.services.s3.AmazonS3;
import com.amazonaws.services.s3.AmazonS3ClientBuilder;
import com.amazonaws.services.s3.model.DeleteObjectRequest;
public class DeleteObject {
public static void main(String[] args) {
String accessPointArn = "*** access point ARN ***
";
String keyName = "*** key name ****
";
try {
// This code expects that you have AWS credentials set up per:
// https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-credentials.html
AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
.enableUseArnRegion()
.build();
s3Client.deleteObject(new DeleteObjectRequest(accessPointArn, keyName));
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it, so it 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();
}
}
}