Data.Cloud.AmazonAPI.TAmazonStorageService.GetBucketACLXML
Delphi
function GetBucketACLXML(const BucketName: string; ResponseInfo: TCloudResponseInfo = nil; const BucketRegion: TAmazonRegion = amzrNotSpecified): string;
C++
System::UnicodeString __fastcall GetBucketACLXML(const System::UnicodeString BucketName, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0), const System::UnicodeString BucketRegion = System::UnicodeString());
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | Data.Cloud.AmazonAPI.pas Data.Cloud.AmazonAPI.hpp |
Data.Cloud.AmazonAPI | TAmazonStorageService |
Description
Returns the given bucket's ACL.
The possible permissions are:
- FULL_CONTROL
- WRITE
- WRITE_ACP—allow writing the ACL of the bucket
- READ
- READ_ACP—allow reading the ACL of the bucket
To get the ACL of the bucket, you must have READ_ACP access to the bucket.
If READ_ACP permission is set for anonymous users, you can return the bucket's ACL without using an authorization header.
Users assigned multiple permissions will appear multiple times in the Grant list.
All users are granted a permission when the grantee has a URI of: http://acs.amazonaws.com/groups/global/AllUsers.
All authenticated users are granted a permission when the grantee has a URI of: http://acs.amazonaws.com/groups/global/AuthenticatedUsers.
The Log delivery group is granted permission when the grantee has a URI of: http://acs.amazonaws.com/groups/global/LogDelivery.
The following table shows the significance of the parameters:
| Parameter | Description |
|---|---|
|
|
The name of the bucket to get the access control list for. |
|
|
The optional class for storing response info into. |
GetBucketACLXML returns the XML representation of the bucket's ACL.