Data.Cloud.AzureAPI.TAzureBlobService.SetContainerACL

From RAD Studio API Documentation
Jump to: navigation, search

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 or ContainerName 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.
  • APublicAccess or PublicAccess 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 or ResponseInfo 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