# -------------------------------------------------------------------------
# Copyright (c) Microsoft Corporation. All rights reserved.
# Licensed under the MIT License. See License.txt in the project root for
# license information.
# --------------------------------------------------------------------------
# pylint: disable=too-many-instance-attributes
from enum import Enum
def get_enum_value(value):
if value is None or value in ["None", ""]:
return None
try:
return value.value
except AttributeError:
return value
[docs]class StorageErrorCode(str, Enum):
# Generic storage values
account_already_exists = "AccountAlreadyExists"
account_being_created = "AccountBeingCreated"
account_is_disabled = "AccountIsDisabled"
authentication_failed = "AuthenticationFailed"
authorization_failure = "AuthorizationFailure"
no_authentication_information = "NoAuthenticationInformation"
condition_headers_not_supported = "ConditionHeadersNotSupported"
condition_not_met = "ConditionNotMet"
empty_metadata_key = "EmptyMetadataKey"
insufficient_account_permissions = "InsufficientAccountPermissions"
internal_error = "InternalError"
invalid_authentication_info = "InvalidAuthenticationInfo"
invalid_header_value = "InvalidHeaderValue"
invalid_http_verb = "InvalidHttpVerb"
invalid_input = "InvalidInput"
invalid_md5 = "InvalidMd5"
invalid_metadata = "InvalidMetadata"
invalid_query_parameter_value = "InvalidQueryParameterValue"
invalid_range = "InvalidRange"
invalid_resource_name = "InvalidResourceName"
invalid_uri = "InvalidUri"
invalid_xml_document = "InvalidXmlDocument"
invalid_xml_node_value = "InvalidXmlNodeValue"
md5_mismatch = "Md5Mismatch"
metadata_too_large = "MetadataTooLarge"
missing_content_length_header = "MissingContentLengthHeader"
missing_required_query_parameter = "MissingRequiredQueryParameter"
missing_required_header = "MissingRequiredHeader"
missing_required_xml_node = "MissingRequiredXmlNode"
multiple_condition_headers_not_supported = "MultipleConditionHeadersNotSupported"
operation_timed_out = "OperationTimedOut"
out_of_range_input = "OutOfRangeInput"
out_of_range_query_parameter_value = "OutOfRangeQueryParameterValue"
request_body_too_large = "RequestBodyTooLarge"
resource_type_mismatch = "ResourceTypeMismatch"
request_url_failed_to_parse = "RequestUrlFailedToParse"
resource_already_exists = "ResourceAlreadyExists"
resource_not_found = "ResourceNotFound"
server_busy = "ServerBusy"
unsupported_header = "UnsupportedHeader"
unsupported_xml_node = "UnsupportedXmlNode"
unsupported_query_parameter = "UnsupportedQueryParameter"
unsupported_http_verb = "UnsupportedHttpVerb"
# Blob values
append_position_condition_not_met = "AppendPositionConditionNotMet"
blob_already_exists = "BlobAlreadyExists"
blob_not_found = "BlobNotFound"
blob_overwritten = "BlobOverwritten"
blob_tier_inadequate_for_content_length = "BlobTierInadequateForContentLength"
block_count_exceeds_limit = "BlockCountExceedsLimit"
block_list_too_long = "BlockListTooLong"
cannot_change_to_lower_tier = "CannotChangeToLowerTier"
cannot_verify_copy_source = "CannotVerifyCopySource"
container_already_exists = "ContainerAlreadyExists"
container_being_deleted = "ContainerBeingDeleted"
container_disabled = "ContainerDisabled"
container_not_found = "ContainerNotFound"
content_length_larger_than_tier_limit = "ContentLengthLargerThanTierLimit"
copy_across_accounts_not_supported = "CopyAcrossAccountsNotSupported"
copy_id_mismatch = "CopyIdMismatch"
feature_version_mismatch = "FeatureVersionMismatch"
incremental_copy_blob_mismatch = "IncrementalCopyBlobMismatch"
incremental_copy_of_eralier_version_snapshot_not_allowed = "IncrementalCopyOfEralierVersionSnapshotNotAllowed"
incremental_copy_source_must_be_snapshot = "IncrementalCopySourceMustBeSnapshot"
infinite_lease_duration_required = "InfiniteLeaseDurationRequired"
invalid_blob_or_block = "InvalidBlobOrBlock"
invalid_blob_tier = "InvalidBlobTier"
invalid_blob_type = "InvalidBlobType"
invalid_block_id = "InvalidBlockId"
invalid_block_list = "InvalidBlockList"
invalid_operation = "InvalidOperation"
invalid_page_range = "InvalidPageRange"
invalid_source_blob_type = "InvalidSourceBlobType"
invalid_source_blob_url = "InvalidSourceBlobUrl"
invalid_version_for_page_blob_operation = "InvalidVersionForPageBlobOperation"
lease_already_present = "LeaseAlreadyPresent"
lease_already_broken = "LeaseAlreadyBroken"
lease_id_mismatch_with_blob_operation = "LeaseIdMismatchWithBlobOperation"
lease_id_mismatch_with_container_operation = "LeaseIdMismatchWithContainerOperation"
lease_id_mismatch_with_lease_operation = "LeaseIdMismatchWithLeaseOperation"
lease_id_missing = "LeaseIdMissing"
lease_is_breaking_and_cannot_be_acquired = "LeaseIsBreakingAndCannotBeAcquired"
lease_is_breaking_and_cannot_be_changed = "LeaseIsBreakingAndCannotBeChanged"
lease_is_broken_and_cannot_be_renewed = "LeaseIsBrokenAndCannotBeRenewed"
lease_lost = "LeaseLost"
lease_not_present_with_blob_operation = "LeaseNotPresentWithBlobOperation"
lease_not_present_with_container_operation = "LeaseNotPresentWithContainerOperation"
lease_not_present_with_lease_operation = "LeaseNotPresentWithLeaseOperation"
max_blob_size_condition_not_met = "MaxBlobSizeConditionNotMet"
no_pending_copy_operation = "NoPendingCopyOperation"
operation_not_allowed_on_incremental_copy_blob = "OperationNotAllowedOnIncrementalCopyBlob"
pending_copy_operation = "PendingCopyOperation"
previous_snapshot_cannot_be_newer = "PreviousSnapshotCannotBeNewer"
previous_snapshot_not_found = "PreviousSnapshotNotFound"
previous_snapshot_operation_not_supported = "PreviousSnapshotOperationNotSupported"
sequence_number_condition_not_met = "SequenceNumberConditionNotMet"
sequence_number_increment_too_large = "SequenceNumberIncrementTooLarge"
snapshot_count_exceeded = "SnapshotCountExceeded"
snaphot_operation_rate_exceeded = "SnaphotOperationRateExceeded"
snapshots_present = "SnapshotsPresent"
source_condition_not_met = "SourceConditionNotMet"
system_in_use = "SystemInUse"
target_condition_not_met = "TargetConditionNotMet"
unauthorized_blob_overwrite = "UnauthorizedBlobOverwrite"
blob_being_rehydrated = "BlobBeingRehydrated"
blob_archived = "BlobArchived"
blob_not_archived = "BlobNotArchived"
# Queue values
invalid_marker = "InvalidMarker"
message_not_found = "MessageNotFound"
message_too_large = "MessageTooLarge"
pop_receipt_mismatch = "PopReceiptMismatch"
queue_already_exists = "QueueAlreadyExists"
queue_being_deleted = "QueueBeingDeleted"
queue_disabled = "QueueDisabled"
queue_not_empty = "QueueNotEmpty"
queue_not_found = "QueueNotFound"
# File values
cannot_delete_file_or_directory = "CannotDeleteFileOrDirectory"
client_cache_flush_delay = "ClientCacheFlushDelay"
delete_pending = "DeletePending"
directory_not_empty = "DirectoryNotEmpty"
file_lock_conflict = "FileLockConflict"
invalid_file_or_directory_path_name = "InvalidFileOrDirectoryPathName"
parent_not_found = "ParentNotFound"
read_only_attribute = "ReadOnlyAttribute"
share_already_exists = "ShareAlreadyExists"
share_being_deleted = "ShareBeingDeleted"
share_disabled = "ShareDisabled"
share_not_found = "ShareNotFound"
sharing_violation = "SharingViolation"
share_snapshot_in_progress = "ShareSnapshotInProgress"
share_snapshot_count_exceeded = "ShareSnapshotCountExceeded"
share_snapshot_operation_not_supported = "ShareSnapshotOperationNotSupported"
share_has_snapshots = "ShareHasSnapshots"
container_quota_downgrade_not_allowed = "ContainerQuotaDowngradeNotAllowed"
# DataLake values
content_length_must_be_zero = 'ContentLengthMustBeZero'
path_already_exists = 'PathAlreadyExists'
invalid_flush_position = 'InvalidFlushPosition'
invalid_property_name = 'InvalidPropertyName'
invalid_source_uri = 'InvalidSourceUri'
unsupported_rest_version = 'UnsupportedRestVersion'
file_system_not_found = 'FilesystemNotFound'
path_not_found = 'PathNotFound'
rename_destination_parent_path_not_found = 'RenameDestinationParentPathNotFound'
source_path_not_found = 'SourcePathNotFound'
destination_path_is_being_deleted = 'DestinationPathIsBeingDeleted'
file_system_already_exists = 'FilesystemAlreadyExists'
file_system_being_deleted = 'FilesystemBeingDeleted'
invalid_destination_path = 'InvalidDestinationPath'
invalid_rename_source_path = 'InvalidRenameSourcePath'
invalid_source_or_destination_resource_type = 'InvalidSourceOrDestinationResourceType'
lease_is_already_broken = 'LeaseIsAlreadyBroken'
lease_name_mismatch = 'LeaseNameMismatch'
path_conflict = 'PathConflict'
source_path_is_being_deleted = 'SourcePathIsBeingDeleted'
class DictMixin(object):
def __setitem__(self, key, item):
self.__dict__[key] = item
def __getitem__(self, key):
return self.__dict__[key]
def __repr__(self):
return str(self)
def __len__(self):
return len(self.keys())
def __delitem__(self, key):
self.__dict__[key] = None
def __eq__(self, other):
"""Compare objects by comparing all attributes."""
if isinstance(other, self.__class__):
return self.__dict__ == other.__dict__
return False
def __ne__(self, other):
"""Compare objects by comparing all attributes."""
return not self.__eq__(other)
def __str__(self):
return str({k: v for k, v in self.__dict__.items() if not k.startswith('_')})
def has_key(self, k):
return k in self.__dict__
def update(self, *args, **kwargs):
return self.__dict__.update(*args, **kwargs)
def keys(self):
return [k for k in self.__dict__ if not k.startswith('_')]
def values(self):
return [v for k, v in self.__dict__.items() if not k.startswith('_')]
def items(self):
return [(k, v) for k, v in self.__dict__.items() if not k.startswith('_')]
def get(self, key, default=None):
if key in self.__dict__:
return self.__dict__[key]
return default
[docs]class LocationMode(object):
"""
Specifies the location the request should be sent to. This mode only applies
for RA-GRS accounts which allow secondary read access. All other account types
must use PRIMARY.
"""
PRIMARY = 'primary' #: Requests should be sent to the primary location.
SECONDARY = 'secondary' #: Requests should be sent to the secondary location, if possible.
[docs]class ResourceTypes(object):
"""
Specifies the resource types that are accessible with the account SAS.
:param bool service:
Access to service-level APIs (e.g., Get/Set Service Properties,
Get Service Stats, List Containers/Queues/Shares)
:param bool container:
Access to container-level APIs (e.g., Create/Delete Container,
Create/Delete Queue, Create/Delete Share,
List Blobs/Files and Directories)
:param bool object:
Access to object-level APIs for blobs, queue messages, and
files(e.g. Put Blob, Query Entity, Get Messages, Create File, etc.)
"""
def __init__(self, service=False, container=False, object=False): # pylint: disable=redefined-builtin
self.service = service
self.container = container
self.object = object
self._str = (('s' if self.service else '') +
('c' if self.container else '') +
('o' if self.object else ''))
def __str__(self):
return self._str
[docs] @classmethod
def from_string(cls, string):
"""Create a ResourceTypes from a string.
To specify service, container, or object you need only to
include the first letter of the word in the string. E.g. service and container,
you would provide a string "sc".
:param str string: Specify service, container, or object in
in the string with the first letter of the word.
:return: A ResourceTypes object
:rtype: ~azure.storage.blob.ResourceTypes
"""
res_service = 's' in string
res_container = 'c' in string
res_object = 'o' in string
parsed = cls(res_service, res_container, res_object)
parsed._str = string # pylint: disable = protected-access
return parsed
[docs]class AccountSasPermissions(object):
"""
:class:`~ResourceTypes` class to be used with generate_account_sas
function and for the AccessPolicies used with set_*_acl. There are two types of
SAS which may be used to grant resource access. One is to grant access to a
specific resource (resource-specific). Another is to grant access to the
entire service for a specific account and allow certain operations based on
perms found here.
:param bool read:
Valid for all signed resources types (Service, Container, and Object).
Permits read permissions to the specified resource type.
:param bool write:
Valid for all signed resources types (Service, Container, and Object).
Permits write permissions to the specified resource type.
:param bool delete:
Valid for Container and Object resource types, except for queue messages.
:param bool delete_previous_version:
Delete the previous blob version for the versioning enabled storage account.
:param bool list:
Valid for Service and Container resource types only.
:param bool add:
Valid for the following Object resource types only: queue messages, and append blobs.
:param bool create:
Valid for the following Object resource types only: blobs and files.
Users can create new blobs or files, but may not overwrite existing
blobs or files.
:param bool update:
Valid for the following Object resource types only: queue messages.
:param bool process:
Valid for the following Object resource type only: queue messages.
:keyword bool tag:
To enable set or get tags on the blobs in the container.
:keyword bool filter_by_tags:
To enable get blobs by tags, this should be used together with list permission.
"""
def __init__(self, read=False, write=False, delete=False,
list=False, # pylint: disable=redefined-builtin
add=False, create=False, update=False, process=False, delete_previous_version=False, **kwargs):
self.read = read
self.write = write
self.delete = delete
self.delete_previous_version = delete_previous_version
self.list = list
self.add = add
self.create = create
self.update = update
self.process = process
self.tag = kwargs.pop('tag', False)
self.filter_by_tags = kwargs.pop('filter_by_tags', False)
self._str = (('r' if self.read else '') +
('w' if self.write else '') +
('d' if self.delete else '') +
('x' if self.delete_previous_version else '') +
('l' if self.list else '') +
('a' if self.add else '') +
('c' if self.create else '') +
('u' if self.update else '') +
('p' if self.process else '') +
('f' if self.filter_by_tags else '') +
('t' if self.tag else '')
)
def __str__(self):
return self._str
[docs] @classmethod
def from_string(cls, permission):
"""Create AccountSasPermissions from a string.
To specify read, write, delete, etc. permissions you need only to
include the first letter of the word in the string. E.g. for read and write
permissions you would provide a string "rw".
:param str permission: Specify permissions in
the string with the first letter of the word.
:return: An AccountSasPermissions object
:rtype: ~azure.storage.blob.AccountSasPermissions
"""
p_read = 'r' in permission
p_write = 'w' in permission
p_delete = 'd' in permission
p_delete_previous_version = 'x' in permission
p_list = 'l' in permission
p_add = 'a' in permission
p_create = 'c' in permission
p_update = 'u' in permission
p_process = 'p' in permission
p_tag = 't' in permission
p_filter_by_tags = 'f' in permission
parsed = cls(read=p_read, write=p_write, delete=p_delete, delete_previous_version=p_delete_previous_version,
list=p_list, add=p_add, create=p_create, update=p_update, process=p_process, tag=p_tag,
filter_by_tags=p_filter_by_tags)
return parsed
class Services(object):
"""Specifies the services accessible with the account SAS.
:param bool blob:
Access for the `~azure.storage.blob.BlobServiceClient`
:param bool queue:
Access for the `~azure.storage.queue.QueueServiceClient`
:param bool fileshare:
Access for the `~azure.storage.fileshare.ShareServiceClient`
"""
def __init__(self, blob=False, queue=False, fileshare=False):
self.blob = blob
self.queue = queue
self.fileshare = fileshare
self._str = (('b' if self.blob else '') +
('q' if self.queue else '') +
('f' if self.fileshare else ''))
def __str__(self):
return self._str
@classmethod
def from_string(cls, string):
"""Create Services from a string.
To specify blob, queue, or file you need only to
include the first letter of the word in the string. E.g. for blob and queue
you would provide a string "bq".
:param str string: Specify blob, queue, or file in
in the string with the first letter of the word.
:return: A Services object
:rtype: ~azure.storage.blob.Services
"""
res_blob = 'b' in string
res_queue = 'q' in string
res_file = 'f' in string
parsed = cls(res_blob, res_queue, res_file)
parsed._str = string # pylint: disable = protected-access
return parsed
[docs]class UserDelegationKey(object):
"""
Represents a user delegation key, provided to the user by Azure Storage
based on their Azure Active Directory access token.
The fields are saved as simple strings since the user does not have to interact with this object;
to generate an identify SAS, the user can simply pass it to the right API.
:ivar str signed_oid:
Object ID of this token.
:ivar str signed_tid:
Tenant ID of the tenant that issued this token.
:ivar str signed_start:
The datetime this token becomes valid.
:ivar str signed_expiry:
The datetime this token expires.
:ivar str signed_service:
What service this key is valid for.
:ivar str signed_version:
The version identifier of the REST service that created this token.
:ivar str value:
The user delegation key.
"""
def __init__(self):
self.signed_oid = None
self.signed_tid = None
self.signed_start = None
self.signed_expiry = None
self.signed_service = None
self.signed_version = None
self.value = None