Container for the parameters to the PutBucketPolicy operation.
Replaces a policy on a bucket. If the bucket already has a policy, the one in this request completely replaces it.
Inheritance Hierarchy
Namespace: Amazon.S3.Model
Assembly: AWSSDK.dll
Version: 2.0.0.3
Syntax
public class PutBucketPolicyRequest : AmazonWebServiceRequest IRequestEvents
The PutBucketPolicyRequest type exposes the following members
Constructors
Name | Description | |
---|---|---|
![]() |
PutBucketPolicyRequest() |
Properties
Name | Description | |
---|---|---|
![]() |
BucketName | The name of the bucket. |
![]() |
ContentMD5 | The base64 encoded 128-bit MD5 digest of the message (without the headers) according to RFC 1864. |
![]() |
Policy | The bucket policy as a JSON document. |
Examples
This example shows how to Get, Put and Delete bucket policies.
BucketPolicy samples
// Create a client AmazonS3Client client = new AmazonS3Client(); // Put sample bucket policy (overwrite an existing policy) string newPolicy = @"{ ""Statement"":[{ ""Sid"":""BasicPerms"", ""Effect"":""Allow"", ""Principal"": { ""AWS"": ""*"" }, ""Action"":[""s3:PutObject"",""s3:GetObject""], ""Resource"":[""arn:aws:s3:::samplebucketname/*""] }]}"; PutBucketPolicyRequest putRequest = new PutBucketPolicyRequest { BucketName = "SampleBucket", Policy = newPolicy }; client.PutBucketPolicy(putRequest); // Retrieve current policy GetBucketPolicyRequest getRequest = new GetBucketPolicyRequest { BucketName = "SampleBucket" }; string policy = client.GetBucketPolicy(getRequest).Policy; Console.WriteLine(policy); Debug.Assert(policy.Contains("BasicPerms")); // Delete current policy DeleteBucketPolicyRequest deleteRequest = new DeleteBucketPolicyRequest { BucketName = "SampleBucket" }; client.DeleteBucketPolicy(deleteRequest); // Retrieve current policy and verify that it is null policy = client.GetBucketPolicy(getRequest).Policy; Debug.Assert(policy == null);
Version Information
.NET Framework:
Supported in: 4.5, 4.0, 3.5
.NET for Windows Store apps:
Supported in: Windows 8
.NET for Windows Phone:
Supported in: Window Phone 8