@azure/storage-blob 12.27.0 → 12.28.0-beta.2

package/dist/react-native/ContainerClient.d.ts

@@ -0,0 +1,1101 @@
+import type { AbortSignalLike } from "@azure/abort-controller";
+import type { RequestBodyType as HttpRequestBody } from "@azure/core-rest-pipeline";
+import type { TokenCredential } from "@azure/core-auth";
+import type { PagedAsyncIterableIterator } from "@azure/core-paging";
+import { AnonymousCredential } from "./credentials/AnonymousCredential.js";
+import { StorageSharedKeyCredential } from "./credentials/StorageSharedKeyCredential.js";
+import type { BlobDeleteResponse, BlobPrefix, BlobProperties, BlockBlobUploadResponse, ContainerCreateResponse, ContainerDeleteResponse, ContainerEncryptionScope, ContainerFilterBlobsHeaders, ContainerGetAccessPolicyHeaders, ContainerGetAccountInfoResponse, ContainerGetPropertiesResponse, ContainerListBlobFlatSegmentHeaders, ContainerListBlobHierarchySegmentHeaders, ContainerSetAccessPolicyResponse, ContainerSetMetadataResponse, FilterBlobItem, FilterBlobSegment, FilterBlobSegmentModel, LeaseAccessConditions, ListBlobsFlatSegmentResponseModel, ListBlobsHierarchySegmentResponseModel, PublicAccessType, SignedIdentifierModel } from "./generatedModels.js";
+import type { Metadata, ObjectReplicationPolicy, Tags, ContainerRequestConditions, ModifiedAccessConditions } from "./models.js";
+import type { PipelineLike, StoragePipelineOptions } from "./Pipeline.js";
+import type { CommonOptions } from "./StorageClient.js";
+import { StorageClient } from "./StorageClient.js";
+import type { WithResponse } from "./utils/utils.common.js";
+import type { ContainerSASPermissions } from "./sas/ContainerSASPermissions.js";
+import { BlobLeaseClient } from "./BlobLeaseClient.js";
+import type { BlobDeleteOptions, BlockBlobUploadOptions, CommonGenerateSasUrlOptions } from "./Clients.js";
+import { AppendBlobClient, BlobClient, BlockBlobClient, PageBlobClient } from "./Clients.js";
+import { BlobBatchClient } from "./BlobBatchClient.js";
+import type { UserDelegationKey } from "./BlobServiceClient.js";
+/**
+ * Options to configure {@link ContainerClient.create} operation.
+ */
+export interface ContainerCreateOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the @azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * A collection of key-value string pair to associate with the container.
+     */
+    metadata?: Metadata;
+    /**
+     * Specifies whether data in the container may be accessed publicly and the level of access. Possible values include:
+     * - `container`: Specifies full public read access for container and blob data. Clients can enumerate blobs within the container via anonymous request, but cannot enumerate containers within the storage account.
+     * - `blob`: Specifies public read access for blobs. Blob data within this container can be read via anonymous request, but container data is not available. Clients cannot enumerate blobs within the container via anonymous request.
+     */
+    access?: PublicAccessType;
+    /**
+     * Container encryption scope info.
+     */
+    containerEncryptionScope?: ContainerEncryptionScope;
+}
+/**
+ * Options to configure {@link ContainerClient.getProperties} operation.
+ */
+export interface ContainerGetPropertiesOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the @azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * If specified, contains the lease id that must be matched and lease with this id
+     * must be active in order for the operation to succeed.
+     */
+    conditions?: LeaseAccessConditions;
+}
+/**
+ * Options to configure {@link ContainerClient.delete} operation.
+ */
+export interface ContainerDeleteMethodOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the @azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * Conditions to meet when deleting the container.
+     */
+    conditions?: ContainerRequestConditions;
+}
+/**
+ * Options to configure {@link ContainerClient.exists} operation.
+ */
+export interface ContainerExistsOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the @azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+}
+/**
+ * Options to configure {@link ContainerClient.setMetadata} operation.
+ */
+export interface ContainerSetMetadataOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the @azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * If specified, contains the lease id that must be matched and lease with this id
+     * must be active in order for the operation to succeed.
+     */
+    conditions?: ContainerRequestConditions;
+}
+/**
+ * Options to configure {@link ContainerClient.getAccessPolicy} operation.
+ */
+export interface ContainerGetAccessPolicyOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the @azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * If specified, contains the lease id that must be matched and lease with this id
+     * must be active in order for the operation to succeed.
+     */
+    conditions?: LeaseAccessConditions;
+}
+/**
+ * Signed identifier.
+ */
+export interface SignedIdentifier {
+    /**
+     * a unique id
+     */
+    id: string;
+    /**
+     * Access Policy
+     */
+    accessPolicy: {
+        /**
+         * Optional. The date-time the policy is active
+         */
+        startsOn?: Date;
+        /**
+         * Optional. The date-time the policy expires
+         */
+        expiresOn?: Date;
+        /**
+         * The permissions for the acl policy
+         * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-container-acl
+         */
+        permissions?: string;
+    };
+}
+/**
+ * Contains response data for the {@link ContainerClient.getAccessPolicy} operation.
+ */
+export declare type ContainerGetAccessPolicyResponse = WithResponse<{
+    signedIdentifiers: SignedIdentifier[];
+} & ContainerGetAccessPolicyHeaders, ContainerGetAccessPolicyHeaders, SignedIdentifierModel>;
+/**
+ * Options to configure {@link ContainerClient.setAccessPolicy} operation.
+ */
+export interface ContainerSetAccessPolicyOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * Conditions to meet when setting the access policy.
+     */
+    conditions?: ContainerRequestConditions;
+}
+/**
+ * Options to configure Container - Acquire Lease operation.
+ */
+export interface ContainerAcquireLeaseOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * Conditions to meet when acquiring the lease.
+     */
+    conditions?: ModifiedAccessConditions;
+}
+/**
+ * Options to configure Container - Release Lease operation.
+ */
+export interface ContainerReleaseLeaseOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * Conditions to meet when releasing the lease.
+     */
+    conditions?: ModifiedAccessConditions;
+}
+/**
+ * Options to configure Container - Renew Lease operation.
+ */
+export interface ContainerRenewLeaseOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * Conditions to meet when renewing the lease.
+     */
+    conditions?: ModifiedAccessConditions;
+}
+/**
+ * Options to configure Container - Break Lease operation.
+ */
+export interface ContainerBreakLeaseOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * Conditions to meet when breaking the lease.
+     */
+    conditions?: ModifiedAccessConditions;
+}
+/**
+ * Options to configure Container - Change Lease operation.
+ */
+export interface ContainerChangeLeaseOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * Conditions to meet when changing the lease.
+     */
+    conditions?: ModifiedAccessConditions;
+}
+/**
+ * Options to configure the {@link ContainerClient.deleteBlob} operation.
+ */
+export interface ContainerDeleteBlobOptions extends BlobDeleteOptions {
+    /**
+     * An opaque DateTime value that, when present, specifies the version
+     * of the blob to delete. It's for service version 2019-10-10 and newer.
+     */
+    versionId?: string;
+}
+/**
+ * An interface representing BlobHierarchyListSegment.
+ */
+export interface BlobHierarchyListSegment {
+    blobPrefixes?: BlobPrefix[];
+    blobItems: BlobItem[];
+}
+/**
+ * An enumeration of blobs
+ */
+export interface ListBlobsHierarchySegmentResponse {
+    serviceEndpoint: string;
+    containerName: string;
+    prefix?: string;
+    marker?: string;
+    maxPageSize?: number;
+    delimiter?: string;
+    segment: BlobHierarchyListSegment;
+    continuationToken?: string;
+}
+/**
+ * Contains response data for the listBlobHierarchySegment operation.
+ */
+export type ContainerListBlobHierarchySegmentResponse = WithResponse<ListBlobsHierarchySegmentResponse & ContainerListBlobHierarchySegmentHeaders, ContainerListBlobHierarchySegmentHeaders, ListBlobsHierarchySegmentResponseModel>;
+/**
+ * An Azure Storage blob
+ */
+export interface BlobItem {
+    name: string;
+    deleted: boolean;
+    snapshot: string;
+    versionId?: string;
+    isCurrentVersion?: boolean;
+    properties: BlobProperties;
+    metadata?: {
+        [propertyName: string]: string;
+    };
+    tags?: Tags;
+    objectReplicationSourceProperties?: ObjectReplicationPolicy[];
+    hasVersionsOnly?: boolean;
+}
+/**
+ * An interface representing BlobFlatListSegment.
+ */
+export interface BlobFlatListSegment {
+    blobItems: BlobItem[];
+}
+/**
+ * An enumeration of blobs
+ */
+export interface ListBlobsFlatSegmentResponse {
+    serviceEndpoint: string;
+    containerName: string;
+    prefix?: string;
+    marker?: string;
+    maxPageSize?: number;
+    segment: BlobFlatListSegment;
+    continuationToken?: string;
+}
+/**
+ * Contains response data for the listBlobFlatSegment operation.
+ */
+export type ContainerListBlobFlatSegmentResponse = WithResponse<ListBlobsFlatSegmentResponse & ContainerListBlobFlatSegmentHeaders, ContainerListBlobFlatSegmentHeaders, ListBlobsFlatSegmentResponseModel>;
+/**
+ * Options to configure Container - List Blobs operations.
+ *
+ * See:
+ * - {@link ContainerClient.listBlobsFlat}
+ * - {@link ContainerClient.listBlobsByHierarchy}
+ */
+export interface ContainerListBlobsOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+    /**
+     * Filters the results to return only containers
+     * whose name begins with the specified prefix.
+     */
+    prefix?: string;
+    /**
+     * Specifies whether metadata related to any current or previous Copy Blob operation should be included in the response.
+     */
+    includeCopy?: boolean;
+    /**
+     * Specifies whether soft deleted blobs should be included in the response.
+     */
+    includeDeleted?: boolean;
+    /**
+     * Specifies whether blob metadata be returned in the response.
+     */
+    includeMetadata?: boolean;
+    /**
+     * Specifies whether snapshots should be included in the enumeration. Snapshots are listed from oldest to newest in the response.
+     */
+    includeSnapshots?: boolean;
+    /**
+     * Specifies whether versions should be included in the enumeration. Versions are listed from oldest to newest in the response.
+     */
+    includeVersions?: boolean;
+    /**
+     * Specifies whether blobs for which blocks have been uploaded, but which have not been committed using Put Block List, be included in the response.
+     */
+    includeUncommitedBlobs?: boolean;
+    /**
+     * Specifies whether blob tags be returned in the response.
+     */
+    includeTags?: boolean;
+    /**
+     * Specifies whether deleted blob with versions be returned in the response.
+     */
+    includeDeletedWithVersions?: boolean;
+    /**
+     * Specifies whether blob immutability policy be returned in the response.
+     */
+    includeImmutabilityPolicy?: boolean;
+    /**
+     * Specifies whether blob legal hold be returned in the response.
+     */
+    includeLegalHold?: boolean;
+}
+/**
+ * Contains response data for the {@link ContainerClient.createIfNotExists} operation.
+ */
+export interface ContainerCreateIfNotExistsResponse extends ContainerCreateResponse {
+    /**
+     * Indicate whether the container is successfully created. Is false when the container is not changed as it already exists.
+     */
+    succeeded: boolean;
+}
+/**
+ * Contains response data for the {@link ContainerClient.deleteIfExists} operation.
+ */
+export interface ContainerDeleteIfExistsResponse extends ContainerDeleteResponse {
+    /**
+     * Indicate whether the container is successfully deleted. Is false if the container does not exist in the first place.
+     */
+    succeeded: boolean;
+}
+/**
+ * Options to configure {@link ContainerClient.generateSasUrl} operation.
+ */
+export interface ContainerGenerateSasUrlOptions extends CommonGenerateSasUrlOptions {
+    /**
+     * Optional only when identifier is provided. Specifies the list of permissions to be associated with the SAS.
+     */
+    permissions?: ContainerSASPermissions;
+}
+/**
+ * Options to configure the {@link BlobServiceClient.findBlobsByTags} operation.
+ */
+export interface ContainerFindBlobByTagsOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+}
+/**
+ * The response of {@link BlobServiceClient.findBlobsByTags} operation.
+ */
+export type ContainerFindBlobsByTagsSegmentResponse = WithResponse<FilterBlobSegment & ContainerFilterBlobsHeaders, ContainerFilterBlobsHeaders, FilterBlobSegmentModel>;
+/**
+ * Options to configure the {@link ContainerClient.getAccountInfo} operation.
+ */
+export interface ContainerGetAccountInfoOptions extends CommonOptions {
+    /**
+     * An implementation of the `AbortSignalLike` interface to signal the request to cancel the operation.
+     * For example, use the &commat;azure/abort-controller to create an `AbortSignal`.
+     */
+    abortSignal?: AbortSignalLike;
+}
+/**
+ * A ContainerClient represents a URL to the Azure Storage container allowing you to manipulate its blobs.
+ */
+export declare class ContainerClient extends StorageClient {
+    /**
+     * containerContext provided by protocol layer.
+     */
+    private containerContext;
+    private _containerName;
+    /**
+     * The name of the container.
+     */
+    get containerName(): string;
+    /**
+     *
+     * Creates an instance of ContainerClient.
+     *
+     * @param connectionString - Account connection string or a SAS connection string of an Azure storage account.
+     *                                  [ Note - Account connection string can only be used in NODE.JS runtime. ]
+     *                                  Account connection string example -
+     *                                  `DefaultEndpointsProtocol=https;AccountName=myaccount;AccountKey=accountKey;EndpointSuffix=core.windows.net`
+     *                                  SAS connection string example -
+     *                                  `BlobEndpoint=https://myaccount.blob.core.windows.net/;QueueEndpoint=https://myaccount.queue.core.windows.net/;FileEndpoint=https://myaccount.file.core.windows.net/;TableEndpoint=https://myaccount.table.core.windows.net/;SharedAccessSignature=sasString`
+     * @param containerName - Container name.
+     * @param options - Optional. Options to configure the HTTP pipeline.
+     */
+    constructor(connectionString: string, containerName: string, options?: StoragePipelineOptions);
+    /**
+     * Creates an instance of ContainerClient.
+     * This method accepts an URL pointing to a container.
+     * Encoded URL string will NOT be escaped twice, only special characters in URL path will be escaped.
+     * If a blob name includes ? or %, blob name must be encoded in the URL.
+     *
+     * @param url - A URL string pointing to Azure Storage container, such as
+     *                     "https://myaccount.blob.core.windows.net/mycontainer". You can
+     *                     append a SAS if using AnonymousCredential, such as
+     *                     "https://myaccount.blob.core.windows.net/mycontainer?sasString".
+     * @param credential -  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.
+     * @param options - Optional. Options to configure the HTTP pipeline.
+     */
+    constructor(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions);
+    /**
+     * Creates an instance of ContainerClient.
+     * This method accepts an URL pointing to a container.
+     * Encoded URL string will NOT be escaped twice, only special characters in URL path will be escaped.
+     * If a blob name includes ? or %, blob name must be encoded in the URL.
+     *
+     * @param url - A URL string pointing to Azure Storage container, such as
+     *                     "https://myaccount.blob.core.windows.net/mycontainer". You can
+     *                     append a SAS if using AnonymousCredential, such as
+     *                     "https://myaccount.blob.core.windows.net/mycontainer?sasString".
+     * @param pipeline - Call newPipeline() to create a default
+     *                            pipeline, or provide a customized pipeline.
+     */
+    constructor(url: string, pipeline: PipelineLike);
+    /**
+     * Creates a new container under the specified account. If the container with
+     * the same name already exists, the operation fails.
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-container
+     * Naming rules: @see https://learn.microsoft.com/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata
+     *
+     * @param options - Options to Container Create operation.
+     *
+     *
+     * Example usage:
+     *
+     * ```ts snippet:ContainerClientCreate
+     * import { BlobServiceClient } from "@azure/storage-blob";
+     * import { DefaultAzureCredential } from "@azure/identity";
+     *
+     * const account = "<account>";
+     * const blobServiceClient = new BlobServiceClient(
+     *   `https://${account}.blob.core.windows.net`,
+     *   new DefaultAzureCredential(),
+     * );
+     *
+     * const containerName = "<container name>";
+     * const containerClient = blobServiceClient.getContainerClient(containerName);
+     * const createContainerResponse = await containerClient.create();
+     * console.log("Container was created successfully", createContainerResponse.requestId);
+     * ```
+     */
+    create(options?: ContainerCreateOptions): Promise<ContainerCreateResponse>;
+    /**
+     * Creates a new container under the specified account. If the container with
+     * the same name already exists, it is not changed.
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-container
+     * Naming rules: @see https://learn.microsoft.com/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata
+     *
+     * @param options -
+     */
+    createIfNotExists(options?: ContainerCreateOptions): Promise<ContainerCreateIfNotExistsResponse>;
+    /**
+     * Returns true if the Azure container resource represented by this client exists; false otherwise.
+     *
+     * NOTE: use this function with care since an existing container might be deleted by other clients or
+     * applications. Vice versa new containers with the same name might be added by other clients or
+     * applications after this function completes.
+     *
+     * @param options -
+     */
+    exists(options?: ContainerExistsOptions): Promise<boolean>;
+    /**
+     * Creates a {@link BlobClient}
+     *
+     * @param blobName - A blob name
+     * @returns A new BlobClient object for the given blob name.
+     */
+    getBlobClient(blobName: string): BlobClient;
+    /**
+     * Creates an {@link AppendBlobClient}
+     *
+     * @param blobName - An append blob name
+     */
+    getAppendBlobClient(blobName: string): AppendBlobClient;
+    /**
+     * Creates a {@link BlockBlobClient}
+     *
+     * @param blobName - A block blob name
+     *
+     *
+     * Example usage:
+     *
+     * ```ts snippet:ClientsUpload
+     * import { BlobServiceClient } from "@azure/storage-blob";
+     * import { DefaultAzureCredential } from "@azure/identity";
+     *
+     * const account = "<account>";
+     * const blobServiceClient = new BlobServiceClient(
+     *   `https://${account}.blob.core.windows.net`,
+     *   new DefaultAzureCredential(),
+     * );
+     *
+     * const containerName = "<container name>";
+     * const blobName = "<blob name>";
+     * const containerClient = blobServiceClient.getContainerClient(containerName);
+     * const blockBlobClient = containerClient.getBlockBlobClient(blobName);
+     *
+     * const content = "Hello world!";
+     * const uploadBlobResponse = await blockBlobClient.upload(content, content.length);
+     * ```
+     */
+    getBlockBlobClient(blobName: string): BlockBlobClient;
+    /**
+     * Creates a {@link PageBlobClient}
+     *
+     * @param blobName - A page blob name
+     */
+    getPageBlobClient(blobName: string): PageBlobClient;
+    /**
+     * Returns all user-defined metadata and system properties for the specified
+     * container. The data returned does not include the container's list of blobs.
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-container-properties
+     *
+     * WARNING: The `metadata` object returned in the response will have its keys in lowercase, even if
+     * they originally contained uppercase characters. This differs from the metadata keys returned by
+     * the `listContainers` method of {@link BlobServiceClient} using the `includeMetadata` option, which
+     * will retain their original casing.
+     *
+     * @param options - Options to Container Get Properties operation.
+     */
+    getProperties(options?: ContainerGetPropertiesOptions): Promise<ContainerGetPropertiesResponse>;
+    /**
+     * Marks the specified container for deletion. The container and any blobs
+     * contained within it are later deleted during garbage collection.
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-container
+     *
+     * @param options - Options to Container Delete operation.
+     */
+    delete(options?: ContainerDeleteMethodOptions): Promise<ContainerDeleteResponse>;
+    /**
+     * Marks the specified container for deletion if it exists. The container and any blobs
+     * contained within it are later deleted during garbage collection.
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-container
+     *
+     * @param options - Options to Container Delete operation.
+     */
+    deleteIfExists(options?: ContainerDeleteMethodOptions): Promise<ContainerDeleteIfExistsResponse>;
+    /**
+     * Sets one or more user-defined name-value pairs for the specified container.
+     *
+     * If no option provided, or no metadata defined in the parameter, the container
+     * metadata will be removed.
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-container-metadata
+     *
+     * @param metadata - Replace existing metadata with this value.
+     *                            If no value provided the existing metadata will be removed.
+     * @param options - Options to Container Set Metadata operation.
+     */
+    setMetadata(metadata?: Metadata, options?: ContainerSetMetadataOptions): Promise<ContainerSetMetadataResponse>;
+    /**
+     * Gets the permissions for the specified container. The permissions indicate
+     * whether container data may be accessed publicly.
+     *
+     * WARNING: JavaScript Date will potentially lose precision when parsing startsOn and expiresOn strings.
+     * For example, new Date("2018-12-31T03:44:23.8827891Z").toISOString() will get "2018-12-31T03:44:23.882Z".
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-container-acl
+     *
+     * @param options - Options to Container Get Access Policy operation.
+     */
+    getAccessPolicy(options?: ContainerGetAccessPolicyOptions): Promise<ContainerGetAccessPolicyResponse>;
+    /**
+     * Sets the permissions for the specified container. The permissions indicate
+     * whether blobs in a container may be accessed publicly.
+     *
+     * When you set permissions for a container, the existing permissions are replaced.
+     * If no access or containerAcl provided, the existing container ACL will be
+     * removed.
+     *
+     * When you establish a stored access policy on a 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 will
+     * fail with status code 403 (Forbidden), until the access policy becomes active.
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-container-acl
+     *
+     * @param access - The level of public access to data in the container.
+     * @param containerAcl - Array of elements each having a unique Id and details of the access policy.
+     * @param options - Options to Container Set Access Policy operation.
+     */
+    setAccessPolicy(access?: PublicAccessType, containerAcl?: SignedIdentifier[], options?: ContainerSetAccessPolicyOptions): Promise<ContainerSetAccessPolicyResponse>;
+    /**
+     * Get a {@link BlobLeaseClient} that manages leases on the container.
+     *
+     * @param proposeLeaseId - Initial proposed lease Id.
+     * @returns A new BlobLeaseClient object for managing leases on the container.
+     */
+    getBlobLeaseClient(proposeLeaseId?: string): BlobLeaseClient;
+    /**
+     * Creates a new block blob, or updates the content of an existing block blob.
+     *
+     * Updating an existing block blob overwrites any existing metadata on the blob.
+     * Partial updates are not supported; the content of the existing blob is
+     * overwritten with the new content. To perform a partial update of a block blob's,
+     * use {@link BlockBlobClient.stageBlock} and {@link BlockBlobClient.commitBlockList}.
+     *
+     * This is a non-parallel uploading method, please use {@link BlockBlobClient.uploadFile},
+     * {@link BlockBlobClient.uploadStream} or {@link BlockBlobClient.uploadBrowserData} for better
+     * performance with concurrency uploading.
+     *
+     * @see https://learn.microsoft.com/rest/api/storageservices/put-blob
+     *
+     * @param blobName - Name of the block blob to create or update.
+     * @param body - Blob, string, ArrayBuffer, ArrayBufferView or a function
+     *                               which returns a new Readable stream whose offset is from data source beginning.
+     * @param contentLength - Length of body in bytes. Use Buffer.byteLength() to calculate body length for a
+     *                               string including non non-Base64/Hex-encoded characters.
+     * @param options - Options to configure the Block Blob Upload operation.
+     * @returns Block Blob upload response data and the corresponding BlockBlobClient instance.
+     */
+    uploadBlockBlob(blobName: string, body: HttpRequestBody, contentLength: number, options?: BlockBlobUploadOptions): Promise<{
+        blockBlobClient: BlockBlobClient;
+        response: BlockBlobUploadResponse;
+    }>;
+    /**
+     * Marks the specified blob or snapshot for deletion. The blob is later deleted
+     * during garbage collection. Note that in order to delete a blob, you must delete
+     * all of its snapshots. You can delete both at the same time with the Delete
+     * Blob operation.
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-blob
+     *
+     * @param blobName -
+     * @param options - Options to Blob Delete operation.
+     * @returns Block blob deletion response data.
+     */
+    deleteBlob(blobName: string, options?: ContainerDeleteBlobOptions): Promise<BlobDeleteResponse>;
+    /**
+     * listBlobFlatSegment returns a single segment of blobs starting from the
+     * specified Marker. Use an empty Marker to start enumeration from the beginning.
+     * After getting a segment, process it, and then call listBlobsFlatSegment again
+     * (passing the the previously-returned Marker) to get the next segment.
+     * @see https://learn.microsoft.com/rest/api/storageservices/list-blobs
+     *
+     * @param marker - A string value that identifies the portion of the list to be returned with the next list operation.
+     * @param options - Options to Container List Blob Flat Segment operation.
+     */
+    private listBlobFlatSegment;
+    /**
+     * listBlobHierarchySegment returns a single segment of blobs starting from
+     * the specified Marker. Use an empty Marker to start enumeration from the
+     * beginning. After getting a segment, process it, and then call listBlobsHierarchicalSegment
+     * again (passing the the previously-returned Marker) to get the next segment.
+     * @see https://learn.microsoft.com/rest/api/storageservices/list-blobs
+     *
+     * @param delimiter - The character or string used to define the virtual hierarchy
+     * @param marker - A string value that identifies the portion of the list to be returned with the next list operation.
+     * @param options - Options to Container List Blob Hierarchy Segment operation.
+     */
+    private listBlobHierarchySegment;
+    /**
+     * Returns an AsyncIterableIterator for ContainerListBlobFlatSegmentResponse
+     *
+     * @param marker - A string value that identifies the portion of
+     *                          the list of blobs to be returned with the next listing operation. The
+     *                          operation returns the ContinuationToken value within the response body if the
+     *                          listing operation did not return all blobs remaining to be listed
+     *                          with the current page. The ContinuationToken value can be used as the value for
+     *                          the marker parameter in a subsequent call to request the next page of list
+     *                          items. The marker value is opaque to the client.
+     * @param options - Options to list blobs operation.
+     */
+    private listSegments;
+    /**
+     * Returns an AsyncIterableIterator of {@link BlobItem} objects
+     *
+     * @param options - Options to list blobs operation.
+     */
+    private listItems;
+    /**
+     * Returns an async iterable iterator to list all the blobs
+     * under the specified account.
+     *
+     * .byPage() returns an async iterable iterator to list the blobs in pages.
+     *
+     * ```ts snippet:ReadmeSampleListBlobs_Multiple
+     * import { BlobServiceClient } from "@azure/storage-blob";
+     * import { DefaultAzureCredential } from "@azure/identity";
+     *
+     * const account = "<account>";
+     * const blobServiceClient = new BlobServiceClient(
+     *   `https://${account}.blob.core.windows.net`,
+     *   new DefaultAzureCredential(),
+     * );
+     *
+     * const containerName = "<container name>";
+     * const containerClient = blobServiceClient.getContainerClient(containerName);
+     *
+     * // Example using `for await` syntax
+     * let i = 1;
+     * const blobs = containerClient.listBlobsFlat();
+     * for await (const blob of blobs) {
+     *   console.log(`Blob ${i++}: ${blob.name}`);
+     * }
+     *
+     * // Example using `iter.next()` syntax
+     * i = 1;
+     * const iter = containerClient.listBlobsFlat();
+     * let { value, done } = await iter.next();
+     * while (!done) {
+     *   console.log(`Blob ${i++}: ${value.name}`);
+     *   ({ value, done } = await iter.next());
+     * }
+     *
+     * // Example using `byPage()` syntax
+     * i = 1;
+     * for await (const page of containerClient.listBlobsFlat().byPage({ maxPageSize: 20 })) {
+     *   for (const blob of page.segment.blobItems) {
+     *     console.log(`Blob ${i++}: ${blob.name}`);
+     *   }
+     * }
+     *
+     * // Example using paging with a marker
+     * i = 1;
+     * let iterator = containerClient.listBlobsFlat().byPage({ maxPageSize: 2 });
+     * let response = (await iterator.next()).value;
+     * // Prints 2 blob names
+     * if (response.segment.blobItems) {
+     *   for (const blob of response.segment.blobItems) {
+     *     console.log(`Blob ${i++}: ${blob.name}`);
+     *   }
+     * }
+     * // Gets next marker
+     * let marker = response.continuationToken;
+     * // Passing next marker as continuationToken
+     * iterator = containerClient.listBlobsFlat().byPage({ continuationToken: marker, maxPageSize: 10 });
+     * response = (await iterator.next()).value;
+     * // Prints 10 blob names
+     * if (response.segment.blobItems) {
+     *   for (const blob of response.segment.blobItems) {
+     *     console.log(`Blob ${i++}: ${blob.name}`);
+     *   }
+     * }
+     * ```
+     *
+     * @param options - Options to list blobs.
+     * @returns An asyncIterableIterator that supports paging.
+     */
+    listBlobsFlat(options?: ContainerListBlobsOptions): PagedAsyncIterableIterator<BlobItem, ContainerListBlobFlatSegmentResponse>;
+    /**
+     * Returns an AsyncIterableIterator for ContainerListBlobHierarchySegmentResponse
+     *
+     * @param delimiter - The character or string used to define the virtual hierarchy
+     * @param marker - A string value that identifies the portion of
+     *                          the list of blobs to be returned with the next listing operation. The
+     *                          operation returns the ContinuationToken value within the response body if the
+     *                          listing operation did not return all blobs remaining to be listed
+     *                          with the current page. The ContinuationToken value can be used as the value for
+     *                          the marker parameter in a subsequent call to request the next page of list
+     *                          items. The marker value is opaque to the client.
+     * @param options - Options to list blobs operation.
+     */
+    private listHierarchySegments;
+    /**
+     * Returns an AsyncIterableIterator for {@link BlobPrefix} and {@link BlobItem} objects.
+     *
+     * @param delimiter - The character or string used to define the virtual hierarchy
+     * @param options - Options to list blobs operation.
+     */
+    private listItemsByHierarchy;
+    /**
+     * Returns an async iterable iterator to list all the blobs by hierarchy.
+     * under the specified account.
+     *
+     * .byPage() returns an async iterable iterator to list the blobs by hierarchy in pages.
+     *
+     * ```ts snippet:ReadmeSampleListBlobsByHierarchy
+     * import { BlobServiceClient } from "@azure/storage-blob";
+     * import { DefaultAzureCredential } from "@azure/identity";
+     *
+     * const account = "<account>";
+     * const blobServiceClient = new BlobServiceClient(
+     *   `https://${account}.blob.core.windows.net`,
+     *   new DefaultAzureCredential(),
+     * );
+     *
+     * const containerName = "<container name>";
+     * const containerClient = blobServiceClient.getContainerClient(containerName);
+     *
+     * // Example using `for await` syntax
+     * let i = 1;
+     * const blobs = containerClient.listBlobsByHierarchy("/");
+     * for await (const blob of blobs) {
+     *   if (blob.kind === "prefix") {
+     *     console.log(`\tBlobPrefix: ${blob.name}`);
+     *   } else {
+     *     console.log(`\tBlobItem: name - ${blob.name}`);
+     *   }
+     * }
+     *
+     * // Example using `iter.next()` syntax
+     * i = 1;
+     * const iter = containerClient.listBlobsByHierarchy("/");
+     * let { value, done } = await iter.next();
+     * while (!done) {
+     *   if (value.kind === "prefix") {
+     *     console.log(`\tBlobPrefix: ${value.name}`);
+     *   } else {
+     *     console.log(`\tBlobItem: name - ${value.name}`);
+     *   }
+     *   ({ value, done } = await iter.next());
+     * }
+     *
+     * // Example using `byPage()` syntax
+     * i = 1;
+     * for await (const page of containerClient.listBlobsByHierarchy("/").byPage({ maxPageSize: 20 })) {
+     *   const segment = page.segment;
+     *   if (segment.blobPrefixes) {
+     *     for (const prefix of segment.blobPrefixes) {
+     *       console.log(`\tBlobPrefix: ${prefix.name}`);
+     *     }
+     *   }
+     *   for (const blob of page.segment.blobItems) {
+     *     console.log(`\tBlobItem: name - ${blob.name}`);
+     *   }
+     * }
+     *
+     * // Example using paging with a marker
+     * i = 1;
+     * let iterator = containerClient.listBlobsByHierarchy("/").byPage({ maxPageSize: 2 });
+     * let response = (await iterator.next()).value;
+     * // Prints 2 blob names
+     * if (response.blobPrefixes) {
+     *   for (const prefix of response.blobPrefixes) {
+     *     console.log(`\tBlobPrefix: ${prefix.name}`);
+     *   }
+     * }
+     * if (response.segment.blobItems) {
+     *   for (const blob of response.segment.blobItems) {
+     *     console.log(`\tBlobItem: name - ${blob.name}`);
+     *   }
+     * }
+     * // Gets next marker
+     * let marker = response.continuationToken;
+     * // Passing next marker as continuationToken
+     * iterator = containerClient
+     *   .listBlobsByHierarchy("/")
+     *   .byPage({ continuationToken: marker, maxPageSize: 10 });
+     * response = (await iterator.next()).value;
+     * // Prints 10 blob names
+     * if (response.blobPrefixes) {
+     *   for (const prefix of response.blobPrefixes) {
+     *     console.log(`\tBlobPrefix: ${prefix.name}`);
+     *   }
+     * }
+     * if (response.segment.blobItems) {
+     *   for (const blob of response.segment.blobItems) {
+     *     console.log(`Blob ${i++}: ${blob.name}`);
+     *   }
+     * }
+     * ```
+     *
+     * @param delimiter - The character or string used to define the virtual hierarchy
+     * @param options - Options to list blobs operation.
+     */
+    listBlobsByHierarchy(delimiter: string, options?: ContainerListBlobsOptions): PagedAsyncIterableIterator<({
+        kind: "prefix";
+    } & BlobPrefix) | ({
+        kind: "blob";
+    } & BlobItem), ContainerListBlobHierarchySegmentResponse>;
+    /**
+     * The Filter Blobs operation enables callers to list blobs in the container whose tags
+     * match a given search expression.
+     *
+     * @param tagFilterSqlExpression - The where parameter enables the caller to query blobs whose tags match a given expression.
+     *                                        The given expression must evaluate to true for a blob to be returned in the results.
+     *                                        The[OData - ABNF] filter syntax rule defines the formal grammar for the value of the where query parameter;
+     *                                        however, only a subset of the OData filter syntax is supported in the Blob service.
+     * @param marker - A string value that identifies the portion of
+     *                          the list of blobs to be returned with the next listing operation. The
+     *                          operation returns the continuationToken value within the response body if the
+     *                          listing operation did not return all blobs remaining to be listed
+     *                          with the current page. The continuationToken value can be used as the value for
+     *                          the marker parameter in a subsequent call to request the next page of list
+     *                          items. The marker value is opaque to the client.
+     * @param options - Options to find blobs by tags.
+     */
+    private findBlobsByTagsSegment;
+    /**
+     * Returns an AsyncIterableIterator for ContainerFindBlobsByTagsSegmentResponse.
+     *
+     * @param tagFilterSqlExpression -  The where parameter enables the caller to query blobs whose tags match a given expression.
+     *                                         The given expression must evaluate to true for a blob to be returned in the results.
+     *                                         The[OData - ABNF] filter syntax rule defines the formal grammar for the value of the where query parameter;
+     *                                         however, only a subset of the OData filter syntax is supported in the Blob service.
+     * @param marker - A string value that identifies the portion of
+     *                          the list of blobs to be returned with the next listing operation. The
+     *                          operation returns the continuationToken value within the response body if the
+     *                          listing operation did not return all blobs remaining to be listed
+     *                          with the current page. The continuationToken value can be used as the value for
+     *                          the marker parameter in a subsequent call to request the next page of list
+     *                          items. The marker value is opaque to the client.
+     * @param options - Options to find blobs by tags.
+     */
+    private findBlobsByTagsSegments;
+    /**
+     * Returns an AsyncIterableIterator for blobs.
+     *
+     * @param tagFilterSqlExpression -  The where parameter enables the caller to query blobs whose tags match a given expression.
+     *                                         The given expression must evaluate to true for a blob to be returned in the results.
+     *                                         The[OData - ABNF] filter syntax rule defines the formal grammar for the value of the where query parameter;
+     *                                         however, only a subset of the OData filter syntax is supported in the Blob service.
+     * @param options - Options to findBlobsByTagsItems.
+     */
+    private findBlobsByTagsItems;
+    /**
+     * Returns an async iterable iterator to find all blobs with specified tag
+     * under the specified container.
+     *
+     * .byPage() returns an async iterable iterator to list the blobs in pages.
+     *
+     * Example using `for await` syntax:
+     *
+     * ```ts snippet:ReadmeSampleFindBlobsByTags
+     * import { BlobServiceClient } from "@azure/storage-blob";
+     * import { DefaultAzureCredential } from "@azure/identity";
+     *
+     * const account = "<account>";
+     * const blobServiceClient = new BlobServiceClient(
+     *   `https://${account}.blob.core.windows.net`,
+     *   new DefaultAzureCredential(),
+     * );
+     *
+     * const containerName = "<container name>";
+     * const containerClient = blobServiceClient.getContainerClient(containerName);
+     *
+     * // Example using `for await` syntax
+     * let i = 1;
+     * for await (const blob of containerClient.findBlobsByTags("tagkey='tagvalue'")) {
+     *   console.log(`Blob ${i++}: ${blob.name}`);
+     * }
+     *
+     * // Example using `iter.next()` syntax
+     * i = 1;
+     * const iter = containerClient.findBlobsByTags("tagkey='tagvalue'");
+     * let { value, done } = await iter.next();
+     * while (!done) {
+     *   console.log(`Blob ${i++}: ${value.name}`);
+     *   ({ value, done } = await iter.next());
+     * }
+     *
+     * // Example using `byPage()` syntax
+     * i = 1;
+     * for await (const page of containerClient
+     *   .findBlobsByTags("tagkey='tagvalue'")
+     *   .byPage({ maxPageSize: 20 })) {
+     *   for (const blob of page.blobs) {
+     *     console.log(`Blob ${i++}: ${blob.name}`);
+     *   }
+     * }
+     *
+     * // Example using paging with a marker
+     * i = 1;
+     * let iterator = containerClient.findBlobsByTags("tagkey='tagvalue'").byPage({ maxPageSize: 2 });
+     * let response = (await iterator.next()).value;
+     * // Prints 2 blob names
+     * if (response.blobs) {
+     *   for (const blob of response.blobs) {
+     *     console.log(`Blob ${i++}: ${blob.name}`);
+     *   }
+     * }
+     * // Gets next marker
+     * let marker = response.continuationToken;
+     * // Passing next marker as continuationToken
+     * iterator = containerClient
+     *   .findBlobsByTags("tagkey='tagvalue'")
+     *   .byPage({ continuationToken: marker, maxPageSize: 10 });
+     * response = (await iterator.next()).value;
+     * // Prints 10 blob names
+     * if (response.blobs) {
+     *   for (const blob of response.blobs) {
+     *     console.log(`Blob ${i++}: ${blob.name}`);
+     *   }
+     * }
+     * ```
+     *
+     * @param tagFilterSqlExpression -  The where parameter enables the caller to query blobs whose tags match a given expression.
+     *                                         The given expression must evaluate to true for a blob to be returned in the results.
+     *                                         The[OData - ABNF] filter syntax rule defines the formal grammar for the value of the where query parameter;
+     *                                         however, only a subset of the OData filter syntax is supported in the Blob service.
+     * @param options - Options to find blobs by tags.
+     */
+    findBlobsByTags(tagFilterSqlExpression: string, options?: ContainerFindBlobByTagsOptions): PagedAsyncIterableIterator<FilterBlobItem, ContainerFindBlobsByTagsSegmentResponse>;
+    /**
+     * The Get Account Information operation returns the sku name and account kind
+     * for the specified account.
+     * The Get Account Information operation is available on service versions beginning
+     * with version 2018-03-28.
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-account-information
+     *
+     * @param options - Options to the Service Get Account Info operation.
+     * @returns Response data for the Service Get Account Info operation.
+     */
+    getAccountInfo(options?: ContainerGetAccountInfoOptions): Promise<ContainerGetAccountInfoResponse>;
+    private getContainerNameFromUrl;
+    /**
+     * Only available for ContainerClient constructed with a shared key credential.
+     *
+     * Generates a Blob Container Service Shared Access Signature (SAS) URI based on the client properties
+     * and parameters passed in. The SAS is signed by the shared key credential of the client.
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     *
+     * @param options - Optional parameters.
+     * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
+     */
+    generateSasUrl(options: ContainerGenerateSasUrlOptions): Promise<string>;
+    /**
+     * Only available for ContainerClient constructed with a shared key credential.
+     *
+     * Generates string to sign for a Blob Container Service Shared Access Signature (SAS) URI
+     * based on the client properties and parameters passed in. The SAS is signed by the shared key credential of the client.
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     *
+     * @param options - Optional parameters.
+     * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
+     */
+    generateSasStringToSign(options: ContainerGenerateSasUrlOptions): string;
+    /**
+     * Generates a Blob Container Service Shared Access Signature (SAS) URI based on the client properties
+     * and parameters passed in. The SAS is signed by the input user delegation key.
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     *
+     * @param options - Optional parameters.
+     * @param userDelegationKey -  Return value of `blobServiceClient.getUserDelegationKey()`
+     * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
+     */
+    generateUserDelegationSasUrl(options: ContainerGenerateSasUrlOptions, userDelegationKey: UserDelegationKey): Promise<string>;
+    /**
+     * Generates string to sign for a Blob Container Service Shared Access Signature (SAS) URI
+     * based on the client properties and parameters passed in. The SAS is signed by the input user delegation key.
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     *
+     * @param options - Optional parameters.
+     * @param userDelegationKey -  Return value of `blobServiceClient.getUserDelegationKey()`
+     * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
+     */
+    generateUserDelegationSasStringToSign(options: ContainerGenerateSasUrlOptions, userDelegationKey: UserDelegationKey): string;
+    /**
+     * Creates a BlobBatchClient object to conduct batch operations.
+     *
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/blob-batch
+     *
+     * @returns A new BlobBatchClient object for this container.
+     */
+    getBlobBatchClient(): BlobBatchClient;
+}
+//# sourceMappingURL=ContainerClient.d.ts.map