@azure/storage-blob package

Classes

AccountSASPermissions

ONLY AVAILABLE IN NODE.JS RUNTIME.

This is a helper class to construct a string representing the permissions granted by an AccountSAS. Setting a value to true means that any SAS which uses these permissions will grant permissions for that operation. Once all the values are set, this should be serialized with toString and set as the permissions field on an AccountSASSignatureValues object. It is possible to construct the permissions string without this class, but the order of the permissions is particular and this class guarantees correctness.

AccountSASResourceTypes

ONLY AVAILABLE IN NODE.JS RUNTIME.

This is a helper class to construct a string representing the resources accessible by an AccountSAS. Setting a value to true means that any SAS which uses these permissions will grant access to that resource type. Once all the values are set, this should be serialized with toString and set as the resources field on an AccountSASSignatureValues object. It is possible to construct the resources string without this class, but the order of the resources is particular and this class guarantees correctness.

AccountSASServices

ONLY AVAILABLE IN NODE.JS RUNTIME.

This is a helper class to construct a string representing the services accessible by an AccountSAS. Setting a value to true means that any SAS which uses these permissions will grant access to that service. Once all the values are set, this should be serialized with toString and set as the services field on an AccountSASSignatureValues object. It is possible to construct the services string without this class, but the order of the services is particular and this class guarantees correctness.

AnonymousCredential

AnonymousCredential provides a credentialPolicyCreator member used to create AnonymousCredentialPolicy objects. AnonymousCredentialPolicy is used with HTTP(S) requests that read public resources or for use with Shared Access Signatures (SAS).

AnonymousCredentialPolicy

AnonymousCredentialPolicy is used with HTTP(S) requests that read public resources or for use with Shared Access Signatures (SAS).

AppendBlobClient

AppendBlobClient defines a set of operations applicable to append blobs.

BaseRequestPolicy

The base class from which all request policies derive.

BlobBatch

A BlobBatch represents an aggregated set of operations on blobs. Currently, only delete and setAccessTier are supported.

BlobBatchClient

A BlobBatchClient allows you to make batched requests to the Azure Storage Blob service.

See https://docs.microsoft.com/en-us/rest/api/storageservices/blob-batch

BlobClient

A BlobClient represents a URL to an Azure Storage blob; the blob may be a block blob, append blob, or page blob.

BlobLeaseClient

A client that manages leases for a ContainerClient or a BlobClient.

BlobSASPermissions

ONLY AVAILABLE IN NODE.JS RUNTIME.

This is a helper class to construct a string representing the permissions granted by a ServiceSAS to a blob. Setting a value to true means that any SAS which uses these permissions will grant permissions for that operation. Once all the values are set, this should be serialized with toString and set as the permissions field on a BlobSASSignatureValues object. It is possible to construct the permissions string without this class, but the order of the permissions is particular and this class guarantees correctness.

BlobServiceClient

A BlobServiceClient represents a Client to the Azure Storage Blob service allowing you to manipulate blob containers.

BlockBlobClient

BlockBlobClient defines a set of operations applicable to block blobs.

ContainerClient

A ContainerClient represents a URL to the Azure Storage container allowing you to manipulate its blobs.

ContainerSASPermissions

This is a helper class to construct a string representing the permissions granted by a ServiceSAS to a container. Setting a value to true means that any SAS which uses these permissions will grant permissions for that operation. Once all the values are set, this should be serialized with toString and set as the permissions field on a BlobSASSignatureValues object. It is possible to construct the permissions string without this class, but the order of the permissions is particular and this class guarantees correctness.

Credential

Credential is an abstract class for Azure Storage HTTP requests signing. This class will host an credentialPolicyCreator factory which generates CredentialPolicy.

CredentialPolicy

Credential policy used to sign HTTP(S) requests before sending. This is an abstract class.

HttpHeaders

A collection of HTTP header key/value pairs.

PageBlobClient

PageBlobClient defines a set of operations applicable to page blobs.

Pipeline

A Pipeline class containing HTTP request policies. You can create a default Pipeline by calling newPipeline. Or you can create a Pipeline with your own policies by the constructor of Pipeline.

Refer to newPipeline and provided policies before implementing your customized Pipeline.

RequestPolicyOptions

Optional properties that can be used when creating a RequestPolicy.

RestError

An error resulting from an HTTP request to a service endpoint.

SASQueryParameters

Represents the components that make up an Azure Storage SAS' query parameters. This type is not constructed directly by the user; it is only generated by the AccountSASSignatureValues and BlobSASSignatureValues types. Once generated, it can be encoded into a toString() and appended to a URL directly (though caution should be taken here in case there are existing query parameters, which might affect the appropriate means of appending these query parameters).

NOTE: Instances of this class are immutable.

StorageBrowserPolicy

StorageBrowserPolicy will handle differences between Node.js and browser runtime, including:

  1. Browsers cache GET/HEAD requests by adding conditional headers such as 'IF_MODIFIED_SINCE'. StorageBrowserPolicy is a policy used to add a timestamp query to GET/HEAD request URL thus avoid the browser cache.

  2. Remove cookie header for security

  3. Remove content-length header to avoid browsers warning

StorageBrowserPolicyFactory

StorageBrowserPolicyFactory is a factory class helping generating StorageBrowserPolicy objects.

StorageRetryPolicy

Retry policy with exponential retry and linear retry implemented.

StorageRetryPolicyFactory

StorageRetryPolicyFactory is a factory class helping generating StorageRetryPolicy objects.

StorageSharedKeyCredential

ONLY AVAILABLE IN NODE.JS RUNTIME.

StorageSharedKeyCredential for account key authorization of Azure Storage service.

StorageSharedKeyCredentialPolicy

StorageSharedKeyCredentialPolicy is a policy used to sign HTTP request with a shared key.

WebResource

Creates a new WebResource object.

This class provides an abstraction over a REST call by being library / implementation agnostic and wrapping the necessary properties to initiate a request.

Interfaces

AccessPolicy

An Access policy

AccountSASPermissionsLike

A type that looks like an account SAS permission. Used in AccountSASPermissions to parse SAS permissions from raw objects.

AccountSASSignatureValues

ONLY AVAILABLE IN NODE.JS RUNTIME.

AccountSASSignatureValues is used to generate a Shared Access Signature (SAS) for an Azure Storage account. Once all the values here are set appropriately, call generateAccountSASQueryParameters to obtain a representation of the SAS which can actually be applied to blob urls. Note: that both this class and SASQueryParameters exist because the former is mutable and a logical representation while the latter is immutable and used to generate actual REST requests.

See https://docs.microsoft.com/en-us/azure/storage/common/storage-dotnet-shared-access-signature-part-1 for more conceptual information on SAS See https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas for descriptions of the parameters, including which are required

AppendBlobAppendBlockFromURLOptions

Options to configure the appendBlockFromURL operation.

AppendBlobAppendBlockFromUrlHeaders

Defines headers for AppendBlob_appendBlockFromUrl operation.

AppendBlobAppendBlockHeaders

Defines headers for AppendBlob_appendBlock operation.

AppendBlobAppendBlockOptions

Options to configure the appendBlock operation.

AppendBlobCreateHeaders

Defines headers for AppendBlob_create operation.

AppendBlobCreateIfNotExistsOptions

Options to configure createIfNotExists operation.

AppendBlobCreateIfNotExistsResponse

Contains response data for the <xref:appendBlobClient.createIfNotExists> operation.

AppendBlobCreateOptions

Options to configure create operation.

AppendBlobRequestConditions

Conditions to add to the creation of this append blob.

AppendBlobSealOptions

Options to configure seal operation.

AppendPositionAccessConditions

Parameter group

BatchSubRequest

A request associated with a batch operation.

BatchSubResponse

The response data associated with a single request within a batch operation.

BlobAbortCopyFromURLHeaders

Defines headers for Blob_abortCopyFromURL operation.

BlobAbortCopyFromURLOptions

Options to configure the abortCopyFromURL operation.

BlobAcquireLeaseOptions

Options to configure Blob - Acquire Lease operation.

BlobBatchSubmitBatchOptionalParams

Options to configure the Service - Submit Batch Optional Params.

BlobBeginCopyFromURLOptions

Options to configure the beginCopyFromURL operation.

BlobBeginCopyFromURLResponse

Contains response data for the beginCopyFromURL operation.

BlobBeginCopyFromUrlPollState

The state used by the poller returned from beginCopyFromURL.

This state is passed into the user-specified onProgress callback whenever copy progress is detected.

BlobBreakLeaseOptions

Options to configure Blob - Break Lease operation.

BlobChangeLeaseOptions

Options to configure Blob - Change Lease operation.

BlobCopyFromURLHeaders

Defines headers for Blob_copyFromURL operation.

BlobCreateSnapshotHeaders

Defines headers for Blob_createSnapshot operation.

BlobCreateSnapshotOptions

Options to configure the createSnapshot operation.

BlobDeleteHeaders

Defines headers for Blob_delete operation.

BlobDeleteIfExistsResponse

Contains response data for the deleteIfExists operation.

BlobDeleteImmutabilityPolicyHeaders

Defines headers for Blob_deleteImmutabilityPolicy operation.

BlobDeleteImmutabilityPolicyOptions

Options for deleting immutability policy deleteImmutabilityPolicy operation.

BlobDeleteOptions

Options to configure the delete operation.

BlobDownloadHeaders

Defines headers for Blob_download operation.

BlobDownloadOptionalParams

Optional parameters.

BlobDownloadOptions

Options to configure the download operation.

BlobDownloadResponseParsed

Contains response data for the download operation.

BlobDownloadToBufferOptions

Option interface for the downloadToBuffer operation.

BlobExistsOptions

Options to configure the exists operation.

BlobFlatListSegment

An interface representing BlobFlatListSegment.

BlobFlatListSegmentModel
BlobGenerateSasUrlOptions

Options to configure generateSasUrl operation.

BlobGetPropertiesHeaders

Defines headers for Blob_getProperties operation.

BlobGetPropertiesOptions

Options to configure the getProperties operation.

BlobGetPropertiesResponse

Contains response data for the getProperties operation.

BlobGetTagsHeaders

Defines headers for Blob_getTags operation.

BlobGetTagsOptions

Options to configure the getTags operation.

BlobHTTPHeaders

Parameter group

BlobHierarchyListSegment

An interface representing BlobHierarchyListSegment.

BlobHierarchyListSegmentModel
BlobImmutabilityPolicy

Describe immutable policy for blob.

BlobItem

An Azure Storage blob

BlobItemInternal

An Azure Storage blob

BlobPrefix
BlobProperties

Properties of a blob

BlobQueryArrowConfiguration

Options to query blob with Apache Arrow format. Only valid for outputTextConfiguration.

BlobQueryArrowField

Describe a field in BlobQueryArrowConfiguration.

BlobQueryCsvTextConfiguration

Options to query blob with CSV format.

BlobQueryError

Blob query error type.

BlobQueryHeaders

Defines headers for Blob_query operation.

BlobQueryJsonTextConfiguration

Options to query blob with JSON format.

BlobQueryParquetConfiguration

Options to query blob with Parquet format. Only valid for inputTextConfiguration.

BlobReleaseLeaseOptions

Options to configure Blob - Release Lease operation.

BlobRenewLeaseOptions

Options to configure Blob - Renew Lease operation.

BlobRequestConditions

standard HTTP conditional headers, tags condition and lease condition

BlobSASPermissionsLike

A type that looks like a Blob SAS permission. Used in BlobSASPermissions to parse SAS permissions from raw objects.

BlobSASSignatureValues

ONLY AVAILABLE IN NODE.JS RUNTIME.

BlobSASSignatureValues is used to help generating Blob service SAS tokens for containers or blobs.

BlobServiceProperties

Storage Service Properties.

BlobServiceStatistics

Stats for the storage service.

BlobSetHTTPHeadersHeaders

Defines headers for Blob_setHttpHeaders operation.

BlobSetHTTPHeadersOptions

Options to configure the setHTTPHeaders operation.

BlobSetImmutabilityPolicyHeaders

Defines headers for Blob_setImmutabilityPolicy operation.

BlobSetImmutabilityPolicyOptions

Options for setting immutability policy setImmutabilityPolicy operation.

BlobSetLegalHoldHeaders

Defines headers for Blob_setLegalHold operation.

BlobSetLegalHoldOptions

Options for setting legal hold setLegalHold operation.

BlobSetMetadataHeaders

Defines headers for Blob_setMetadata operation.

BlobSetMetadataOptions

Options to configure the setMetadata operation.

BlobSetTagsHeaders

Defines headers for Blob_setTags operation.

BlobSetTagsOptions

Options to configure the setTags operation.

BlobSetTierHeaders

Defines headers for Blob_setTier operation.

BlobSetTierOptions

Options to configure the setAccessTier operation.

BlobStartCopyFromURLHeaders

Defines headers for Blob_startCopyFromURL operation.

BlobStartCopyFromURLOptions

Options to configure the beginCopyFromURL operation.

BlobSyncCopyFromURLOptions

Options to configure the syncCopyFromURL operation.

BlobTag
BlobTags

Blob tags

BlobUndeleteHeaders

Defines headers for Blob_undelete operation.

BlobUndeleteOptions

Options to configure the undelete operation.

Block

Represents a single block in a block blob. It describes the block's ID and size.

BlockBlobCommitBlockListHeaders

Defines headers for BlockBlob_commitBlockList operation.

BlockBlobCommitBlockListOptions

Options to configure commitBlockList operation.

BlockBlobGetBlockListHeaders

Defines headers for BlockBlob_getBlockList operation.

BlockBlobGetBlockListOptions

Options to configure getBlockList operation.

BlockBlobParallelUploadOptions

Option interface for uploadFile and <xref:BlockBlobClient.uploadSeekableStream>.

BlockBlobPutBlobFromUrlHeaders

Defines headers for BlockBlob_putBlobFromUrl operation.

BlockBlobQueryOptions

Options to configure query operation.

BlockBlobStageBlockFromURLHeaders

Defines headers for BlockBlob_stageBlockFromURL operation.

BlockBlobStageBlockFromURLOptions

Options to configure stageBlockFromURL operation.

BlockBlobStageBlockHeaders

Defines headers for BlockBlob_stageBlock operation.

BlockBlobStageBlockOptions

Options to configure stageBlock operation.

BlockBlobSyncUploadFromURLOptions

Options to configure syncUploadFromURL operation.

BlockBlobUploadHeaders

Defines headers for BlockBlob_upload operation.

BlockBlobUploadOptions

Options to configure upload operation.

BlockBlobUploadStreamOptions

Option interface for the uploadStream operation.

BlockList
CommonGenerateSasUrlOptions

Common options of BlobGenerateSasUrlOptions and ContainerGenerateSasUrlOptions.

CommonOptions

An interface for options common to every remote operation.

ContainerAcquireLeaseOptions

Options to configure Container - Acquire Lease operation.

ContainerBreakLeaseOptionalParams

Optional parameters.

ContainerBreakLeaseOptions

Options to configure Container - Break Lease operation.

ContainerChangeLeaseOptions

Options to configure Container - Change Lease operation.

ContainerCreateHeaders

Defines headers for Container_create operation.

ContainerCreateIfNotExistsResponse

Contains response data for the createIfNotExists operation.

ContainerCreateOptions

Options to configure create operation.

ContainerDeleteBlobOptions

Options to configure the deleteBlob operation.

ContainerDeleteHeaders

Defines headers for Container_delete operation.

ContainerDeleteIfExistsResponse

Contains response data for the deleteIfExists operation.

ContainerDeleteMethodOptions

Options to configure delete operation.

ContainerEncryptionScope

Parameter group

ContainerExistsOptions

Options to configure exists operation.

ContainerFilterBlobsHeaders

Defines headers for Container_filterBlobs operation.

ContainerFindBlobByTagsOptions

Options to configure the findBlobsByTags operation.

ContainerGenerateSasUrlOptions

Options to configure generateSasUrl operation.

ContainerGetAccessPolicyHeaders

Defines headers for Container_getAccessPolicy operation.

ContainerGetAccessPolicyOptions

Options to configure getAccessPolicy operation.

ContainerGetPropertiesHeaders

Defines headers for Container_getProperties operation.

ContainerGetPropertiesOptions

Options to configure getProperties operation.

ContainerItem

An Azure Storage container

ContainerListBlobFlatSegmentHeaders

Defines headers for Container_listBlobFlatSegment operation.

ContainerListBlobHierarchySegmentHeaders

Defines headers for Container_listBlobHierarchySegment operation.

ContainerListBlobsOptions

Options to configure Container - List Blobs operations.

See:

ContainerProperties

Properties of a container

ContainerReleaseLeaseOptions

Options to configure Container - Release Lease operation.

ContainerRenameHeaders

Defines headers for Container_rename operation.

ContainerRenewLeaseOptions

Options to configure Container - Renew Lease operation.

ContainerRequestConditions

Conditions to meet for the container.

ContainerSASPermissionsLike

A type that looks like a Container SAS permission. Used in ContainerSASPermissions to parse SAS permissions from raw objects.

ContainerSetAccessPolicyHeaders

Defines headers for Container_setAccessPolicy operation.

ContainerSetAccessPolicyOptions

Options to configure setAccessPolicy operation.

ContainerSetMetadataHeaders

Defines headers for Container_setMetadata operation.

ContainerSetMetadataOptions

Options to configure setMetadata operation.

ContainerUndeleteHeaders

Defines headers for Container_restore operation.

CorsRule

CORS is an HTTP feature that enables a web application running under one domain to access resources in another domain. Web browsers implement a security restriction known as same-origin policy that prevents a web page from calling APIs in a different domain; CORS provides a secure way to allow one domain (the origin domain) to call APIs in another domain

CpkInfo

Parameter group

FilterBlobItem

Blob info from a findBlobsByTags

FilterBlobItemModel

Blob info from a Filter Blobs API call

FilterBlobSegment

Segment response of findBlobsByTags operation.

FilterBlobSegmentModel

The result of a Filter Blobs API call

GeoReplication

Geo-Replication information for the Secondary Storage Service

HttpAuthorization

Represents authentication information in Authorization, ProxyAuthorization, WWW-Authenticate, and Proxy-Authenticate header values.

HttpOperationResponse

Wrapper object for http request and response. Deserialized object is stored in the parsedBody property when the response body is received in JSON or XML.

IHttpClient

An interface that can send HttpRequests and receive promised HttpResponses.

Lease

The details for a specific lease.

LeaseAccessConditions

Parameter group

LeaseOperationOptions

Configures lease operations.

ListBlobsFlatSegmentResponse

An enumeration of blobs

ListBlobsFlatSegmentResponseModel

An enumeration of blobs

ListBlobsHierarchySegmentResponse

An enumeration of blobs

ListBlobsHierarchySegmentResponseModel

An enumeration of blobs

ListContainersSegmentResponse

An enumeration of containers

Logging

Azure Analytics Logging settings.

MatchConditions

Specifies HTTP options for conditional requests based on ETag matching.

Metadata

A map of name-value pairs to associate with the resource.

Metrics

a summary of request statistics grouped by API in hour or minute aggregates for blobs

ModificationConditions

Specifies HTTP options for conditional requests based on modification time.

ModifiedAccessConditions

standard HTTP conditional headers and tags condition.

ModifiedAccessConditionsModel

Parameter group

ObjectReplicationPolicy

Contains Object Replication Policy ID and the respective list of ObjectReplicationRule. This is used when retrieving the Object Replication Properties on the source blob. The policy id for the destination blob is set in ObjectReplicationDestinationPolicyId of the respective method responses (e.g. <xref:BlobProperties.ObjectReplicationDestinationPolicyId>.

ObjectReplicationRule

Contains the Object Replication Rule ID and ObjectReplicationStatus of a blob. There can be more than one ObjectReplicationRule under a ObjectReplicationPolicy.

PageBlobClearPagesHeaders

Defines headers for PageBlob_clearPages operation.

PageBlobClearPagesOptions

Options to configure the clearPages operation.

PageBlobCopyIncrementalHeaders

Defines headers for PageBlob_copyIncremental operation.

PageBlobCreateHeaders

Defines headers for PageBlob_create operation.

PageBlobCreateIfNotExistsOptions

Options to configure the createIfNotExists operation.

PageBlobCreateIfNotExistsResponse

Contains response data for the createIfNotExists operation.

PageBlobCreateOptions

Options to configure the create operation.

PageBlobGetPageRangesDiffHeaders

Defines headers for PageBlob_getPageRangesDiff operation.

PageBlobGetPageRangesDiffOptions

Options to configure the <xref:PageBlobClient.getRangesDiff> operation.

PageBlobGetPageRangesDiffResponse

Contains response data for the getPageRangesDiff(number, number, string, PageBlobGetPageRangesDiffOptions) operation.

PageBlobGetPageRangesHeaders

Defines headers for PageBlob_getPageRanges operation.

PageBlobGetPageRangesOptions

Options to configure the getPageRanges operation.

PageBlobGetPageRangesResponse

Contains response data for the getPageRanges(number, number, PageBlobGetPageRangesOptions) operation.

PageBlobListPageRangesDiffOptions

Options to configure the listPageRangesDiff operation.

PageBlobListPageRangesOptions

Options to configure the listPageRanges operation.

PageBlobRequestConditions

Conditions to add to the creation of this page blob.

PageBlobResizeHeaders

Defines headers for PageBlob_resize operation.

PageBlobResizeOptions

Options to configure resize operation.

PageBlobStartCopyIncrementalOptions

Options to configure startCopyIncremental operation.

PageBlobUpdateSequenceNumberHeaders

Defines headers for PageBlob_updateSequenceNumber operation.

PageBlobUpdateSequenceNumberOptions

Options to configure updateSequenceNumber operation.

PageBlobUploadPagesFromURLHeaders

Defines headers for PageBlob_uploadPagesFromURL operation.

PageBlobUploadPagesFromURLOptions

Options to configure uploadPagesFromURL operation.

PageBlobUploadPagesHeaders

Defines headers for PageBlob_uploadPages operation.

PageBlobUploadPagesOptions

Options to configure the uploadPages operation.

PageList

List of page ranges for a blob.

PageRangeInfo
ParsedBatchResponse

The multipart/mixed response which contains the response for each subrequest.

PipelineLike

An interface for the Pipeline class containing HTTP request policies. You can create a default Pipeline by calling newPipeline. Or you can create a Pipeline with your own policies by the constructor of Pipeline.

Refer to newPipeline and provided policies before implementing your customized Pipeline.

PipelineOptions

Option interface for Pipeline constructor.

PollOperationState

PollOperationState contains an opinionated list of the smallest set of properties needed to define any long running operation poller.

While the Poller class works as the local control mechanism to start triggering, wait for, and potentially cancel a long running operation, the PollOperationState documents the status of the remote long running operation.

It should be updated at least when the operation starts, when it's finished, and when it's cancelled. Though, implementations can have any other number of properties that can be updated by other reasons.

PollerLike

Abstract representation of a poller, intended to expose just the minimal API that the user needs to work with.

PollerLikeWithCancellation

Abstract representation of a poller, intended to expose just the minimal API that the user needs to work with.

Range

Range for Blob Service Operations.

See https://docs.microsoft.com/en-us/rest/api/storageservices/specifying-the-range-header-for-blob-service-operations

RequestPolicy

The underlying structure of a request policy.

RetentionPolicy

the retention policy which determines how long the associated data should persist

SASQueryParametersOptions

Options to construct SASQueryParameters.

SasIPRange

Allowed IP range for a SAS.

SequenceNumberAccessConditions

Parameter group

ServiceFilterBlobsHeaders

Defines headers for Service_filterBlobs operation.

ServiceFindBlobByTagsOptions

Options to configure the findBlobsByTags operation.

ServiceGenerateAccountSasUrlOptions

Options to configure generateAccountSasUrl operation.

ServiceGetAccountInfoHeaders

Defines headers for Service_getAccountInfo operation.

ServiceGetAccountInfoOptions

Options to configure the getAccountInfo operation.

ServiceGetPropertiesHeaders

Defines headers for Service_getProperties operation.

ServiceGetPropertiesOptions

Options to configure the getProperties operation.

ServiceGetStatisticsHeaders

Defines headers for Service_getStatistics operation.

ServiceGetStatisticsOptions

Options to configure the getStatistics operation.

ServiceGetUserDelegationKeyHeaders

Defines headers for Service_getUserDelegationKey operation.

ServiceGetUserDelegationKeyOptions

Options to configure the Service - Get User Delegation Key.

ServiceListContainersOptions

Options to configure the listContainers operation.

ServiceListContainersSegmentHeaders

Defines headers for Service_listContainersSegment operation.

ServiceRenameContainerOptions

Options to configure <xref:BlobServiceClient.renameContainer> operation.

ServiceSetPropertiesHeaders

Defines headers for Service_setProperties operation.

ServiceSetPropertiesOptions

Options to configure the setProperties operation.

ServiceSubmitBatchHeaders

Defines headers for Service_submitBatch operation.

ServiceSubmitBatchOptionalParamsModel

Optional parameters.

ServiceUndeleteContainerOptions

Options to configure undeleteContainer operation.

SignedIdentifier

Signed identifier.

SignedIdentifierModel

signed identifier

StaticWebsite

The properties that enable an account to host a static website

StoragePipelineOptions

Options interface for the newPipeline function.

StorageRetryOptions

Storage Blob retry options interface.

TagConditions

Specifies HTTP options for conditional requests based on blob tags.

UserDelegationKey

A user delegation key.

UserDelegationKeyModel

A user delegation key

Type Aliases

AccessTier

Defines values for AccessTier.

AccountKind

Defines values for AccountKind.

AppendBlobAppendBlockFromUrlResponse

Contains response data for the appendBlockFromUrl operation.

AppendBlobAppendBlockResponse

Contains response data for the appendBlock operation.

AppendBlobCreateResponse

Contains response data for the create operation.

ArchiveStatus

Defines values for ArchiveStatus.

BlobAbortCopyFromURLResponse

Contains response data for the abortCopyFromURL operation.

BlobBatchDeleteBlobsResponse

Contains response data for the deleteBlobs(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, BlobDeleteOptions) operation.

BlobBatchSetBlobsAccessTierResponse

Contains response data for the setBlobsAccessTier(string[], StorageSharedKeyCredential | AnonymousCredential | TokenCredential, AccessTier, BlobSetTierOptions) operation.

BlobBatchSubmitBatchResponse

Contains response data for blob batch operations.

BlobCopyFromURLResponse

Contains response data for the copyFromURL operation.

BlobCopySourceTags

Defines values for BlobCopySourceTags.

BlobCreateSnapshotResponse

Contains response data for the createSnapshot operation.

BlobDeleteImmutabilityPolicyResponse

Contains response data for the deleteImmutabilityPolicy operation.

BlobDeleteResponse

Contains response data for the delete operation.

BlobDownloadResponseModel

Contains response data for the download operation.

BlobGetPropertiesResponseModel

Contains response data for the getProperties operation.

BlobGetTagsResponse

Contains response data for the getTags operation.

BlobImmutabilityPolicyMode

Defines values for BlobImmutabilityPolicyMode.

BlobQueryArrowFieldType

The type of a BlobQueryArrowField.

BlobQueryResponseModel

Contains response data for the query operation.

BlobSetHTTPHeadersResponse

Contains response data for the setHttpHeaders operation.

BlobSetImmutabilityPolicyResponse

Contains response data for the setImmutabilityPolicy operation.

BlobSetLegalHoldResponse

Contains response data for the setLegalHold operation.

BlobSetMetadataResponse

Contains response data for the setMetadata operation.

BlobSetTagsResponse

Contains response data for the setTags operation.

BlobSetTierResponse

Contains response data for the setTier operation.

BlobStartCopyFromURLResponse

Contains response data for the startCopyFromURL operation.

BlobType

Defines values for BlobType.

BlobUndeleteResponse

Contains response data for the undelete operation.

BlobUploadCommonResponse

Response type for uploadFile, uploadStream, and <xref:BlockBlobClient.uploadBrowserDate>.

BlockBlobCommitBlockListResponse

Contains response data for the commitBlockList operation.

BlockBlobGetBlockListResponse

Contains response data for the getBlockList operation.

BlockBlobPutBlobFromUrlResponse

Contains response data for the putBlobFromUrl operation.

BlockBlobStageBlockFromURLResponse

Contains response data for the stageBlockFromURL operation.

BlockBlobStageBlockResponse

Contains response data for the stageBlock operation.

BlockBlobUploadResponse

Contains response data for the upload operation.

BlockListType

Defines values for BlockListType.

ContainerCreateResponse

Contains response data for the create operation.

ContainerDeleteResponse

Contains response data for the delete operation.

ContainerFindBlobsByTagsSegmentResponse

The response of findBlobsByTags operation.

ContainerGetAccessPolicyResponse

Contains response data for the getAccessPolicy operation.

ContainerGetPropertiesResponse

Contains response data for the getProperties operation.

ContainerListBlobFlatSegmentResponse

Contains response data for the listBlobFlatSegment operation.

ContainerListBlobHierarchySegmentResponse

Contains response data for the listBlobHierarchySegment operation.

ContainerRenameResponse

Contains response data for the rename operation.

ContainerSetAccessPolicyResponse

Contains response data for the setAccessPolicy operation.

ContainerSetMetadataResponse

Contains response data for the setMetadata operation.

ContainerUndeleteResponse

Contains response data for the restore operation.

CopyPollerBlobClient

Defines the operations from a BlobClient that are needed for the poller returned by beginCopyFromURL to work.

CopyStatusType

Defines values for CopyStatusType.

CredentialPolicyCreator

A factory function that creates a new CredentialPolicy that uses the provided nextPolicy.

DeleteSnapshotsOptionType

Defines values for DeleteSnapshotsOptionType.

EncryptionAlgorithmType

Defines values for EncryptionAlgorithmType.
KnownEncryptionAlgorithmType can be used interchangeably with EncryptionAlgorithmType, this enum contains the known values that the service supports.

Know values supported by the service

AES256

GeoReplicationStatusType

Defines values for GeoReplicationStatusType.

HttpRequestBody

Possible HTTP request body types

LeaseDurationType

Defines values for LeaseDurationType.

LeaseOperationResponse

Contains the response data for operations that create, modify, or delete a lease.

See BlobLeaseClient.

LeaseStateType

Defines values for LeaseStateType.

LeaseStatusType

Defines values for LeaseStatusType.

ObjectReplicationStatus

Specifies the Replication Status of a blob. This is used when a storage account has Object Replication Policy(s) applied. See ObjectReplicationPolicy and ObjectReplicationRule.

PageBlobClearPagesResponse

Contains response data for the clearPages operation.

PageBlobCopyIncrementalResponse

Contains response data for the copyIncremental operation.

PageBlobCreateResponse

Contains response data for the create operation.

PageBlobGetPageRangesDiffResponseModel

Contains response data for the getPageRangesDiff operation.

PageBlobGetPageRangesResponseModel

Contains response data for the getPageRanges operation.

PageBlobResizeResponse

Contains response data for the resize operation.

PageBlobUpdateSequenceNumberResponse

Contains response data for the updateSequenceNumber operation.

PageBlobUploadPagesFromURLResponse

Contains response data for the uploadPagesFromURL operation.

PageBlobUploadPagesResponse

Contains response data for the uploadPages operation.

PublicAccessType

Defines values for PublicAccessType.

RehydratePriority

Defines values for RehydratePriority.

RequestPolicyFactory

Creates a new RequestPolicy per-request that uses the provided nextPolicy.

SequenceNumberActionType

Defines values for SequenceNumberActionType.

ServiceFindBlobsByTagsSegmentResponse

The response of findBlobsByTags operation.

ServiceGetAccountInfoResponse

Contains response data for the getAccountInfo operation.

ServiceGetPropertiesResponse

Contains response data for the getProperties operation.

ServiceGetStatisticsResponse

Contains response data for the getStatistics operation.

ServiceGetUserDelegationKeyResponse

Contains response data for the getUserDelegationKey(Date, Date, ServiceGetUserDelegationKeyOptions) operation.

ServiceListContainersSegmentResponse

Contains response data for the listContainersSegment operation.

ServiceSetPropertiesResponse

Contains response data for the setProperties operation.

ServiceSubmitBatchResponseModel

Contains response data for the submitBatch operation.

SkuName

Defines values for SkuName.

SyncCopyStatusType

Defines values for SyncCopyStatusType.

Tags

Blob tags.

Enums

BlockBlobTier

Represents the access tier on a blob. For detailed information about block blob level tiering see Hot, cool and archive storage tiers.

KnownEncryptionAlgorithmType

Known values of EncryptionAlgorithmType that the service accepts.

PremiumPageBlobTier

Specifies the page blob tier to set the blob to. This is only applicable to page blobs on premium storage accounts. Please see here for detailed information on the corresponding IOPS and throughput per PageBlobTier.

SASProtocol

Protocols for generated SAS.

StorageBlobAudience

Defines the known cloud audiences for Storage.

StorageRetryPolicyType

RetryPolicy types.

Functions

deserializationPolicy(DeserializationContentTypes, SerializerOptions)

Create a new serialization RequestPolicyCreator that will serialized HTTP request bodies as they pass through the HTTP pipeline.

generateAccountSASQueryParameters(AccountSASSignatureValues, StorageSharedKeyCredential)

ONLY AVAILABLE IN NODE.JS RUNTIME.

Generates a SASQueryParameters object which contains all SAS query parameters needed to make an actual REST request.

See https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas

generateBlobSASQueryParameters(BlobSASSignatureValues, StorageSharedKeyCredential)

ONLY AVAILABLE IN NODE.JS RUNTIME.

Creates an instance of SASQueryParameters.

Only accepts required settings needed to create a SAS. For optional settings please set corresponding properties directly, such as permissions, startsOn and identifier.

WARNING: When identifier is not provided, permissions and expiresOn are required. You MUST assign value to identifier or expiresOn & permissions manually if you initial with this constructor.

Fill in the required details before running the following snippets.

Example usage:

// Generate service level SAS for a container
const containerSAS = generateBlobSASQueryParameters({
    containerName, // Required
    permissions: ContainerSASPermissions.parse("racwdl"), // Required
    startsOn: new Date(), // Optional
    expiresOn: new Date(new Date().valueOf() + 86400), // Required. Date type
    ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
    protocol: SASProtocol.HttpsAndHttp, // Optional
    version: "2016-05-31" // Optional
  },
  sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();

Example using an identifier:

// Generate service level SAS for a container with identifier
// startsOn & permissions are optional when identifier is provided
const identifier = "unique-id";
await containerClient.setAccessPolicy(undefined, [
  {
    accessPolicy: {
      expiresOn: new Date(new Date().valueOf() + 86400), // Date type
      permissions: ContainerSASPermissions.parse("racwdl").toString(),
      startsOn: new Date() // Date type
    },
    id: identifier
  }
]);

const containerSAS = generateBlobSASQueryParameters(
  {
    containerName, // Required
    identifier // Required
  },
  sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();

Example using a blob name:

// Generate service level SAS for a blob
const blobSAS = generateBlobSASQueryParameters({
    containerName, // Required
    blobName, // Required
    permissions: BlobSASPermissions.parse("racwd"), // Required
    startsOn: new Date(), // Optional
    expiresOn: new Date(new Date().valueOf() + 86400), // Required. Date type
    cacheControl: "cache-control-override", // Optional
    contentDisposition: "content-disposition-override", // Optional
    contentEncoding: "content-encoding-override", // Optional
    contentLanguage: "content-language-override", // Optional
    contentType: "content-type-override", // Optional
    ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
    protocol: SASProtocol.HttpsAndHttp, // Optional
    version: "2016-05-31" // Optional
  },
  sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();
generateBlobSASQueryParameters(BlobSASSignatureValues, UserDelegationKey, string)

ONLY AVAILABLE IN NODE.JS RUNTIME.

Creates an instance of SASQueryParameters. WARNING: identifier will be ignored when generating user delegation SAS, permissions and expiresOn are required.

Example usage:

// Generate user delegation SAS for a container
const userDelegationKey = await blobServiceClient.getUserDelegationKey(startsOn, expiresOn);
const containerSAS = generateBlobSASQueryParameters({
    containerName, // Required
    permissions: ContainerSASPermissions.parse("racwdl"), // Required
    startsOn, // Optional. Date type
    expiresOn, // Required. Date type
    ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
    protocol: SASProtocol.HttpsAndHttp, // Optional
    version: "2018-11-09" // Must greater than or equal to 2018-11-09 to generate user delegation SAS
  },
  userDelegationKey, // UserDelegationKey
  accountName
).toString();
getBlobServiceAccountAudience(string)
isPipelineLike(unknown)

A helper to decide if a given argument satisfies the Pipeline contract

newPipeline(StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Creates a new Pipeline object with Credential provided.

Function Details

deserializationPolicy(DeserializationContentTypes, SerializerOptions)

Create a new serialization RequestPolicyCreator that will serialized HTTP request bodies as they pass through the HTTP pipeline.

function deserializationPolicy(deserializationContentTypes?: DeserializationContentTypes, parsingOptions?: SerializerOptions): RequestPolicyFactory

Parameters

deserializationContentTypes
DeserializationContentTypes
parsingOptions
SerializerOptions

Returns

generateAccountSASQueryParameters(AccountSASSignatureValues, StorageSharedKeyCredential)

ONLY AVAILABLE IN NODE.JS RUNTIME.

Generates a SASQueryParameters object which contains all SAS query parameters needed to make an actual REST request.

See https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas

function generateAccountSASQueryParameters(accountSASSignatureValues: AccountSASSignatureValues, sharedKeyCredential: StorageSharedKeyCredential): SASQueryParameters

Parameters

accountSASSignatureValues
AccountSASSignatureValues
sharedKeyCredential
StorageSharedKeyCredential

Returns

generateBlobSASQueryParameters(BlobSASSignatureValues, StorageSharedKeyCredential)

ONLY AVAILABLE IN NODE.JS RUNTIME.

Creates an instance of SASQueryParameters.

Only accepts required settings needed to create a SAS. For optional settings please set corresponding properties directly, such as permissions, startsOn and identifier.

WARNING: When identifier is not provided, permissions and expiresOn are required. You MUST assign value to identifier or expiresOn & permissions manually if you initial with this constructor.

Fill in the required details before running the following snippets.

Example usage:

// Generate service level SAS for a container
const containerSAS = generateBlobSASQueryParameters({
    containerName, // Required
    permissions: ContainerSASPermissions.parse("racwdl"), // Required
    startsOn: new Date(), // Optional
    expiresOn: new Date(new Date().valueOf() + 86400), // Required. Date type
    ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
    protocol: SASProtocol.HttpsAndHttp, // Optional
    version: "2016-05-31" // Optional
  },
  sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();

Example using an identifier:

// Generate service level SAS for a container with identifier
// startsOn & permissions are optional when identifier is provided
const identifier = "unique-id";
await containerClient.setAccessPolicy(undefined, [
  {
    accessPolicy: {
      expiresOn: new Date(new Date().valueOf() + 86400), // Date type
      permissions: ContainerSASPermissions.parse("racwdl").toString(),
      startsOn: new Date() // Date type
    },
    id: identifier
  }
]);

const containerSAS = generateBlobSASQueryParameters(
  {
    containerName, // Required
    identifier // Required
  },
  sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();

Example using a blob name:

// Generate service level SAS for a blob
const blobSAS = generateBlobSASQueryParameters({
    containerName, // Required
    blobName, // Required
    permissions: BlobSASPermissions.parse("racwd"), // Required
    startsOn: new Date(), // Optional
    expiresOn: new Date(new Date().valueOf() + 86400), // Required. Date type
    cacheControl: "cache-control-override", // Optional
    contentDisposition: "content-disposition-override", // Optional
    contentEncoding: "content-encoding-override", // Optional
    contentLanguage: "content-language-override", // Optional
    contentType: "content-type-override", // Optional
    ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
    protocol: SASProtocol.HttpsAndHttp, // Optional
    version: "2016-05-31" // Optional
  },
  sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();
function generateBlobSASQueryParameters(blobSASSignatureValues: BlobSASSignatureValues, sharedKeyCredential: StorageSharedKeyCredential): SASQueryParameters

Parameters

blobSASSignatureValues
BlobSASSignatureValues
sharedKeyCredential
StorageSharedKeyCredential

Returns

generateBlobSASQueryParameters(BlobSASSignatureValues, UserDelegationKey, string)

ONLY AVAILABLE IN NODE.JS RUNTIME.

Creates an instance of SASQueryParameters. WARNING: identifier will be ignored when generating user delegation SAS, permissions and expiresOn are required.

Example usage:

// Generate user delegation SAS for a container
const userDelegationKey = await blobServiceClient.getUserDelegationKey(startsOn, expiresOn);
const containerSAS = generateBlobSASQueryParameters({
    containerName, // Required
    permissions: ContainerSASPermissions.parse("racwdl"), // Required
    startsOn, // Optional. Date type
    expiresOn, // Required. Date type
    ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
    protocol: SASProtocol.HttpsAndHttp, // Optional
    version: "2018-11-09" // Must greater than or equal to 2018-11-09 to generate user delegation SAS
  },
  userDelegationKey, // UserDelegationKey
  accountName
).toString();
function generateBlobSASQueryParameters(blobSASSignatureValues: BlobSASSignatureValues, userDelegationKey: UserDelegationKey, accountName: string): SASQueryParameters

Parameters

blobSASSignatureValues
BlobSASSignatureValues
userDelegationKey
UserDelegationKey

Return value of blobServiceClient.getUserDelegationKey()

accountName

string

Returns

getBlobServiceAccountAudience(string)

function getBlobServiceAccountAudience(storageAccountName: string): string

Parameters

storageAccountName

string

Returns

string

isPipelineLike(unknown)

A helper to decide if a given argument satisfies the Pipeline contract

function isPipelineLike(pipeline: unknown): pipeline

Parameters

pipeline

unknown

An argument that may be a Pipeline

Returns

pipeline

true when the argument satisfies the Pipeline contract

newPipeline(StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)

Creates a new Pipeline object with Credential provided.

function newPipeline(credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, pipelineOptions?: StoragePipelineOptions): Pipeline

Parameters

credential

StorageSharedKeyCredential | AnonymousCredential | TokenCredential

Such as AnonymousCredential, StorageSharedKeyCredential or any credential from the @azure/identity package to authenticate requests to the service. You can also provide an object that implements the TokenCredential interface. If not specified, AnonymousCredential is used.

pipelineOptions
StoragePipelineOptions

Optional. Options.

Returns

A new Pipeline object.