AWS AmazonS3 documentation change
Summary
Replaced Java SDK code example for creating tagged Batch Operations jobs with a general description and API reference link
Security assessment
The change removes a specific code implementation for job tagging and replaces it with a high-level description. While tags can be used for access control, this change does not introduce new security features or address vulnerabilities. It focuses on documentation structure rather than security content.
Diff
diff --git a/AmazonS3/latest/userguide/batch-ops-tags-create.md b/AmazonS3/latest/userguide/batch-ops-tags-create.md index b76ab96cb..34ad82e0e 100644 --- a//AmazonS3/latest/userguide/batch-ops-tags-create.md +++ b//AmazonS3/latest/userguide/batch-ops-tags-create.md @@ -84 +84 @@ The following AWS CLI example creates an S3 Batch Operations `S3PutObjectCopy` j -The following example creates an S3 Batch Operations job with tags using the AWS SDK for Java. +To create an S3 Batch Operations job with tags using the AWS SDK for Java, you can use the S3Control client to configure job parameters including manifest location, job operations, reporting settings, and tags for organization and tracking purposes. @@ -86,53 +86 @@ The following example creates an S3 Batch Operations job with tags using the AWS - - public String createJob(final AWSS3ControlClient awss3ControlClient) { - final String manifestObjectArn = "arn:aws:s3:::amzn-s3-demo-manifest-bucket/manifests/10_manifest.csv"; - final String manifestObjectVersionId = "example-5dc7a8bfb90808fc5d546218"; - - final JobManifestLocation manifestLocation = new JobManifestLocation() - .withObjectArn(manifestObjectArn) - .withETag(manifestObjectVersionId); - - final JobManifestSpec manifestSpec = - new JobManifestSpec().withFormat(JobManifestFormat.S3InventoryReport_CSV_20161130); - - final JobManifest manifestToPublicApi = new JobManifest() - .withLocation(manifestLocation) - .withSpec(manifestSpec); - - final String jobReportBucketArn = "arn:aws:s3:::amzn-s3-demo-completion-report-bucket"; - final String jobReportPrefix = "example-job-reports"; - - final JobReport jobReport = new JobReport() - .withEnabled(true) - .withReportScope(JobReportScope.AllTasks) - .withBucket(jobReportBucketArn) - .withPrefix(jobReportPrefix) - .withFormat(JobReportFormat.Report_CSV_20180820); - - final String lambdaFunctionArn = "arn:aws:lambda:us-west-2:123456789012:function:example-function"; - - final JobOperation jobOperation = new JobOperation() - .withLambdaInvoke(new LambdaInvokeOperation().withFunctionArn(lambdaFunctionArn)); - - final S3Tag departmentTag = new S3Tag().withKey("department").withValue("Marketing"); - final S3Tag fiscalYearTag = new S3Tag().withKey("FiscalYear").withValue("2020"); - - final String roleArn = "arn:aws:iam::123456789012:role/example-batch-operations-role"; - final Boolean requiresConfirmation = true; - final int priority = 10; - - final CreateJobRequest request = new CreateJobRequest() - .withAccountId("123456789012") - .withDescription("Test lambda job") - .withManifest(manifestToPublicApi) - .withOperation(jobOperation) - .withPriority(priority) - .withRoleArn(roleArn) - .withReport(jobReport) - .withTags(departmentTag, fiscalYearTag) - .withConfirmationRequired(requiresConfirmation); - - final CreateJobResult result = awss3ControlClient.createJob(request); - - return result.getJobId(); - } +For examples of how to create S3 Batch Operations jobs with tags using the AWS SDK for Java, see [Create a batch job to copy objects](https://docs.aws.amazon.com/AmazonS3/latest/API/s3-control_example_s3-control_CreateJob_section.html) in the _Amazon S3 API Reference_.