AcquireBlobLease

Acquires a lease on a specified blob.

Properties

Azure Storage Credential

  • Account Name - The name of your Azure storage account.
  • Access Key - Your Azure account access key.
  • EndpointSuffix - To create a connection string for a storage service in a specific region.
  • BlobStorageUri - The Uri to the location of the Blob storage you want to access.
    • PrimaryUri and SecondaryUri settings available
  • FileStorageUri - The Uri to the location of the File storage you want to access.
    • PrimaryUri and SecondaryUri settings available
  • TableStorageUri - The Uri to the location of the Table storage you want to access.
    • PrimaryUri and SecondaryUri settings available
  • QueueStorageUri - The Uri to the location of the Queue storage you want to access.
    • PrimaryUri and SecondaryUri settings available

Container name

The container name of the target blob. To access the root container, specify $root as the name.

Relative address

The relative address for the blob, e.g. folder/subfolder.

Blob name

Name of the blob. Acquiring a lease establishes a lock on a blob for write and delete operations.

Lease time

Number of seconds for which to acquire the lease. If specified, this must be between 15 and 60 seconds. If not specified, an infinite lease will be acquired.

Proposed lease id

A string representing the proposed lease id for the new lease, e.g. 80008000-abcd-2000-3000-400040004000. If not specified, lease id will be auto-generated.

If match ETag

ETag value for a condition specifying that the given ETag must match blob's ETag. Do not use simultaneously with If none match ETag or If modified since time.

If none match ETag

ETag value for a condition specifying that the given ETag must not match blob's ETag. Do not use simultaneously with If match ETag or If not modified since time.

If modified since time

Specifies a DateTime value in ISO 8061 format for a condition specifying a time since which the blob has been modified. Do not use simultaneously with If not modified since time or If match ETag. If If none match ETag is specified, this property is ignored.

If not modified since time

Specifies a DateTime value in ISO 8061 format for a condition specifying a time since which the blob has not been modified. Do not use simultaneously with If modified since time or If none match ETag. If If match ETag is specified, this property is ignored.


Also See

Please refer to the following Azure API reference documentation:

Configure Azure Storage connection strings:

https://docs.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.auth.storagecredentials.-ctor?view=azure-dotnet#Microsoft_Azure_Storage_Auth_StorageCredentials__ctor_System_String_System_String_

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.cloudstorageaccount.-ctor?view=azure-dotnet#Microsoft_Azure_Storage_CloudStorageAccount__ctor_Microsoft_Azure_Storage_Auth_StorageCredentials_System_String_System_Boolean_

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.cloudstorageaccount.-ctor?view=azure-dotnet#Microsoft_Azure_Storage_CloudStorageAccount__ctor_Microsoft_Azure_Storage_Auth_StorageCredentials_Microsoft_Azure_Storage_StorageUri_Microsoft_Azure_Storage_StorageUri_Microsoft_Azure_Storage_StorageUri_Microsoft_Azure_Storage_StorageUri_

Documentation to assist in setting properties:

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.accesscondition?view=azure-dotnet

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.blob.cloudblob.acquirelease?view=azure-dotnet

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.blob.cloudblobclient.getcontainerreference?view=azure-dotnet

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.blob.cloudblobcontainer.getdirectoryreference?view=azure-dotnet

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.blob.cloudblobcontainer.getblobreference?view=azure-dotnet

https://docs.microsoft.com/en-us/dotnet/api/microsoft.azure.storage.blob.cloudblobdirectory.getblobreference?view=azure-dotnet