Data.Cloud.AzureAPI.TAzureBlobService.SetContainerACL
Delphi
function SetContainerACL(ContainerName: string; const SignedIdentifierId: string; AccessPolicy: TAccessPolicy; PublicAccess: TBlobPublicAccess = bpaContainer; ResponseInfo: TCloudResponseInfo = nil): Boolean; overload; deprecated;
function SetContainerACL(const AContainerName: string; const ASignedIdentifierId: string; const AAccessPolicy: TPolicy; APublicAccess: TBlobPublicAccess; const AClientRequestID: string; const AResponseInfo: TCloudResponseInfo): Boolean; overload;
function SetContainerACL(ContainerName: string; SignedIdentifiers: TList<TSignedIdentifier>; PublicAccess: TBlobPublicAccess = bpaContainer; ResponseInfo: TCloudResponseInfo = nil; const AClientRequestID: string = ''): Boolean; overload;
C++
bool __fastcall SetContainerACL _DEPRECATED_ATTRIBUTE0 (System::UnicodeString ContainerName, const System::UnicodeString SignedIdentifierId, const TAccessPolicy &AccessPolicy, TBlobPublicAccess PublicAccess = (TBlobPublicAccess)(0x1), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0))/* overload */;
bool __fastcall SetContainerACL(const System::UnicodeString AContainerName, const System::UnicodeString ASignedIdentifierId, TPolicy* const AAccessPolicy, TBlobPublicAccess APublicAccess, const System::UnicodeString AClientRequestID, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;
bool __fastcall SetContainerACL(System::UnicodeString ContainerName, System::Generics::Collections::TList__1<TSignedIdentifier*>* SignedIdentifiers, TBlobPublicAccess PublicAccess = (TBlobPublicAccess)(0x1), Data::Cloud::Cloudapi::TCloudResponseInfo* ResponseInfo = (Data::Cloud::Cloudapi::TCloudResponseInfo*)(0x0), const System::UnicodeString AClientRequestID = System::UnicodeString())/* overload */;
Properties
Type | Visibility | Source | Unit | Parent |
---|---|---|---|---|
function | public | Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp |
Data.Cloud.AzureAPI | TAzureBlobService |
Description
Sets the access policies stored for the specified blob container that you may use with shared access signatures, and returns True
on success or False
otherwise.
- Note: When you establish a stored access policy on a blob container, it may take up to 30 seconds to take effect. During this interval, a shared access signature that is associated with the stored access policy fails with status code 403 (Forbidden), until the access policy becomes active.
SetContainerACL receives the following parameters:
AContainerName
orContainerName
is the name of the target blob container.- You may specify either a single policy or several policies:
- To specify a single access policy use the following parameters:
ASignedIdentifierId
is a string that uniquely identifies the stored access policy.AAccessPolicy
is the access policy to store for the blob container.
- To specify an array of access policies and their identifiers use the
SignedIdentifiers
parameter.
- To specify a single access policy use the following parameters:
APublicAccess
orPublicAccess
is the value to set as the public access of the blob container. When you specify several access policies, it defaults to bpaContainer.AClientRequestID
is an optional string that uniquely identifies your client. This value is used for storage analytics.AResponseInfo
orResponseInfo
is an optional instance of TCloudResponseInfo to store the information of the response. Use a nil value if you do not need the information of the response.
See Also
- Data.Cloud.AzureAPI.TAzureBlobService.GetContainerACL
- Data.Cloud.AzureAPI.TAzureBlobService.GetContainerACLXML