Object
Provides a resource for copying an S3 object.
Example Usage
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.s3.ObjectCopy;
import com.pulumi.aws.s3.ObjectCopyArgs;
import com.pulumi.aws.s3.inputs.ObjectCopyGrantArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
var test = new ObjectCopy("test", ObjectCopyArgs.builder()
.bucket("destination_bucket")
.grants(ObjectCopyGrantArgs.builder()
.permissions("READ")
.type("Group")
.uri("http://acs.amazonaws.com/groups/global/AllUsers")
.build())
.key("destination_key")
.source("source_bucket/source_key")
.build());
}
}Constructors
Functions
Properties
Canned ACL to apply. Defaults to private. Valid values are private, public-read, public-read-write, authenticated-read, aws-exec-read, bucket-owner-read, and bucket-owner-full-control. Conflicts with grant.
Specifies caching behavior along the request/reply chain Read w3c cache_control for further details.
Specifies presentational information for the object. Read w3c content_disposition for further information.
Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to obtain the media-type referenced by the Content-Type header field. Read w3c content encoding for further information.
Copies the object if it has been modified since the specified time, in RFC3339 format.
Copies the object if it hasn't been modified since the specified time, in RFC3339 format.
Specifies the customer-provided encryption key for Amazon S3 to use in encrypting data. This value is used to store the object and then it is discarded; Amazon S3 does not store the encryption key. The key must be appropriate for use with the algorithm specified in the x-amz-server-side-encryption-customer-algorithm header.
Date and time at which the object is no longer cacheable, in RFC3339 format.
The legal hold status that you want to apply to the specified object. Valid values are ON and OFF.
Object lock retention mode that you want to apply to this object. Valid values are GOVERNANCE and COMPLIANCE.
Date and time, in RFC3339 format, when this object's object lock will expire.
Confirms that the requester knows that they will be charged for the request. Bucket owners need not specify this parameter in their requests. For information about downloading objects from requester pays buckets, see Downloading Objects in Requestor Pays Buckets (https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html) in the Amazon S3 Developer Guide. If included, the only valid value is requester.
Specifies the source object for the copy operation. You specify the value in one of two formats. For objects not accessed through an access point, specify the name of the source bucket and the key of the source object, separated by a slash (/). For example, testbucket/test1.json. For objects accessed through access points, specify the ARN of the object as accessed through the access point, in the format arn:aws:s3:<Region>:<account-id>:accesspoint/<access-point-name>/object/<key>. For example, arn:aws:s3:us-west-2:9999912999:accesspoint/my-access-point/object/testbucket/test1.json. The following arguments are optional:
Specifies the desired storage class for the object. Defaults to STANDARD.