Data.Cloud.AmazonAPI.TAmazonStorageService.GetBucketACLXML

From RAD Studio API Documentation
Jump to: navigation, search

Delphi

function GetBucketACLXML(const BucketName: string;  ResponseInfo: TCloudResponseInfo = nil; BucketRegion: TAmazonRegion = amzrNotSpecified): string;

C++

System::UnicodeString __fastcall GetBucketACLXML(const System::UnicodeString BucketName, Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0), TAmazonRegion BucketRegion = (TAmazonRegion)(0x0));

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

BucketName

The name of the bucket to get the access control list for.

ResponseInfo

The optional class for storing response info into.

GetBucketACLXML returns the XML representation of the bucket's ACL.

See Also