Data.Cloud.AzureAPI.TAzureQueueService.SetQueueACL
Delphi
function SetQueueACL(const AQueueName: string; const ASignedIdentifierId: string; const AAccessPolicy: TPolicy; const AClientRequestID: string; const AResponseInfo: TCloudResponseInfo): Boolean; overload;
function SetQueueACL(const AQueueName: string; ASignedIdentifiers: TArray<TSignedIdentifier>; const AClientRequestID: string; const AResponseInfo: TCloudResponseInfo): Boolean; overload;
C++
bool __fastcall SetQueueACL(const System::UnicodeString AQueueName, const System::UnicodeString ASignedIdentifierId, TPolicy* const AAccessPolicy, const System::UnicodeString AClientRequestID, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;
bool __fastcall SetQueueACL(const System::UnicodeString AQueueName, System::DynamicArray<TSignedIdentifier*> ASignedIdentifiers, const System::UnicodeString AClientRequestID, Data::Cloud::Cloudapi::TCloudResponseInfo* const AResponseInfo)/* overload */;
Properties
| Type | Visibility | Source | Unit | Parent |
|---|---|---|---|---|
| function | public | Data.Cloud.AzureAPI.pas Data.Cloud.AzureAPI.hpp |
Data.Cloud.AzureAPI | TAzureQueueService |
Description
Sets the access policies stored for the specified queue 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 queue, 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.
SetQueueACL receives the following parameters:
AQueueNameis the name of the target queue.- You may specify either a single policy or several policies:
- To specify a single access policy use the following parameters:
ASignedIdentifierIdis a string that uniquely identifies the stored access policy.AAccessPolicyis the access policy to store for the queue.
- To specify an array of access policies and their identifiers use the
ASignedIdentifiersparameter.
- To specify a single access policy use the following parameters:
AClientRequestIDis an optional string that uniquely identifies your client. This value is used for storage analytics.AResponseInfois 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.TAzureQueueService.GetQueueACL
- Data.Cloud.AzureAPI.TAzureQueueService.GetQueueACLXML