From 0304f6a847cb2ceb207617bbdb3d001995a01469 Mon Sep 17 00:00:00 2001 From: Isabelle Date: Mon, 27 Jul 2026 09:30:13 -0700 Subject: [PATCH 01/13] checkpoint --- .../file/share/ShareClientBuilder.java | 4 +- .../file/share/ShareFileClientBuilder.java | 4 +- .../file/share/ShareServiceClientBuilder.java | 4 +- .../file/share/ShareServiceVersion.java | 71 +- .../implementation/AzureFileStorageImpl.java | 146 +- .../share/implementation/DirectoriesImpl.java | 4582 ++---- .../file/share/implementation/FilesImpl.java | 11656 +++------------- .../share/implementation/ServicesImpl.java | 2142 +-- .../file/share/implementation/SharesImpl.java | 6744 +++------ .../share/implementation/XmlSerializer.java | 78 + .../XmlSerializerProviders.java | 29 + .../models/DeleteSnapshotsOptionType.java | 8 +- .../implementation/models/DirectoryItem.java | 112 +- .../share/implementation/models/FileItem.java | 115 +- .../implementation/models/FileProperty.java | 183 +- .../FilesAndDirectoriesListSegment.java | 74 +- .../implementation/models/HandleItem.java | 232 +- .../share/implementation/models/KeyInfo.java | 36 +- ...istFilesAndDirectoriesSegmentResponse.java | 252 +- .../models/ListFilesIncludeType.java | 12 +- .../models/ListSharesIncludeType.java | 10 +- .../ShareFileRangeWriteFromUrlType.java | 51 + .../models/ShareFileRangeWriteType.java | 9 +- .../models/ShareItemInternal.java | 136 +- .../models/SharePermission.java | 36 +- .../models/SharePropertiesInternal.java | 660 +- .../models/ShareSignedIdentifierWrapper.java | 65 +- .../implementation/models/ShareStats.java | 43 +- .../implementation/models/StringEncoded.java | 42 +- .../implementation/models/package-info.java | 6 +- .../storage/file/share/models/ClearRange.java | 55 +- .../share/models/FileLastWrittenMode.java | 8 +- .../share/models/FilePermissionFormat.java | 8 +- .../share/models/FilePropertySemantics.java | 8 +- .../storage/file/share/models/FileRange.java | 45 +- .../file/share/models/LeaseDurationType.java | 9 +- .../file/share/models/LeaseStateType.java | 12 +- .../file/share/models/LeaseStatusType.java | 6 +- .../file/share/models/ModeCopyMode.java | 8 +- .../file/share/models/NfsFileType.java | 10 +- .../file/share/models/OwnerCopyMode.java | 8 +- .../share/models/PermissionCopyModeType.java | 8 +- .../file/share/models/ShareAccessPolicy.java | 6 +- .../file/share/models/ShareAccessTier.java | 12 +- .../file/share/models/ShareCorsRule.java | 120 +- .../models/ShareFileHandleAccessRights.java | 8 +- .../file/share/models/ShareFileRangeList.java | 30 +- .../file/share/models/ShareMetrics.java | 67 +- .../file/share/models/ShareNfsSettings.java | 2 +- .../ShareNfsSettingsEncryptionInTransit.java | 2 +- .../share/models/ShareProtocolSettings.java | 2 +- .../share/models/ShareRetentionPolicy.java | 70 +- .../file/share/models/ShareRootSquash.java | 10 +- .../share/models/ShareServiceProperties.java | 56 +- .../share/models/ShareSignedIdentifier.java | 41 +- .../file/share/models/ShareSmbSettings.java | 2 +- .../ShareSmbSettingsEncryptionInTransit.java | 2 +- .../file/share/models/ShareTokenIntent.java | 4 +- .../file/share/models/SmbMultichannel.java | 2 +- .../file/share/models/UserDelegationKey.java | 118 +- .../azure-storage-file-share_metadata.json | 1 + .../main/java/ShareStorageCustomization.java | 237 + .../tsp-location.yaml | 4 + 63 files changed, 7221 insertions(+), 21302 deletions(-) create mode 100644 sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java create mode 100644 sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java create mode 100644 sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java create mode 100644 sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json create mode 100644 sdk/storage/azure-storage-file-share/tsp-location.yaml diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClientBuilder.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClientBuilder.java index 60330e2073e4..82a069d83da5 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClientBuilder.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClientBuilder.java @@ -675,7 +675,7 @@ AzureFileStorageImpl buildFileStorageImplClient() { endpoint, retryOptions, coreRetryOptions, logOptions, clientOptions, httpClient, perCallPolicies, perRetryPolicies, configuration, audience, LOGGER); - return new AzureFileStorageImpl(pipeline, serviceVersion.getVersion(), shareTokenIntent, endpoint, - allowTrailingDot, allowSourceTrailingDot); + return new AzureFileStorageImpl(pipeline, endpoint, shareTokenIntent, allowTrailingDot, allowSourceTrailingDot, + serviceVersion); } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileClientBuilder.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileClientBuilder.java index fe1fbc329ade..3570830ee7cf 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileClientBuilder.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileClientBuilder.java @@ -208,8 +208,8 @@ private AzureFileStorageImpl constructImpl() { endpoint, retryOptions, coreRetryOptions, logOptions, clientOptions, httpClient, perCallPolicies, perRetryPolicies, configuration, audience, LOGGER); - return new AzureFileStorageImpl(pipeline, getServiceVersion().getVersion(), shareTokenIntent, endpoint, - allowTrailingDot, allowSourceTrailingDot); + return new AzureFileStorageImpl(pipeline, endpoint, shareTokenIntent, allowTrailingDot, allowSourceTrailingDot, + getServiceVersion()); } /** diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceClientBuilder.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceClientBuilder.java index dddee6529049..0a4edf5d4633 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceClientBuilder.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceClientBuilder.java @@ -617,7 +617,7 @@ AzureFileStorageImpl buildFileStorageImplClient() { endpoint, retryOptions, coreRetryOptions, logOptions, clientOptions, httpClient, perCallPolicies, perRetryPolicies, configuration, audience, LOGGER); - return new AzureFileStorageImpl(pipeline, serviceVersion.getVersion(), shareTokenIntent, endpoint, - allowTrailingDot, allowSourceTrailingDot); + return new AzureFileStorageImpl(pipeline, endpoint, shareTokenIntent, allowTrailingDot, allowSourceTrailingDot, + serviceVersion); } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceVersion.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceVersion.java index 20d1e6de7cea..75d35a61cdf1 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceVersion.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceVersion.java @@ -1,166 +1,167 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share; import com.azure.core.util.ServiceVersion; /** - * The versions of Azure Storage File supported by this client library. + * Service version of FileClient. */ public enum ShareServiceVersion implements ServiceVersion { /** - * Service version {@code 2019-02-02}. + * Enum value 2019-02-02. */ V2019_02_02("2019-02-02"), /** - * Service version {@code 2019-07-07}. + * Enum value 2019-07-07. */ V2019_07_07("2019-07-07"), /** - * Service version {@code 2019-12-12}. + * Enum value 2019-12-12. */ V2019_12_12("2019-12-12"), /** - * Service version {@code 2020-02-10}. + * Enum value 2020-02-10. */ V2020_02_10("2020-02-10"), /** - * Service version {@code 2020-04-08}. + * Enum value 2020-04-08. */ V2020_04_08("2020-04-08"), /** - * Service version {@code 2020-06-12}. + * Enum value 2020-06-12. */ V2020_06_12("2020-06-12"), /** - * Service version {@code 2020-08-04}. + * Enum value 2020-08-04. */ V2020_08_04("2020-08-04"), /** - * Service version {@code 2020-10-02}. + * Enum value 2020-10-02. */ V2020_10_02("2020-10-02"), /** - * Service version {@code 2020-12-06}. + * Enum value 2020-12-06. */ V2020_12_06("2020-12-06"), /** - * Service version {@code 2021-02-12}. + * Enum value 2021-02-12. */ V2021_02_12("2021-02-12"), /** - * Service version {@code 2021-04-10}. + * Enum value 2021-04-10. */ V2021_04_10("2021-04-10"), /** - * Service version {@code 2021-06-08}. + * Enum value 2021-06-08. */ V2021_06_08("2021-06-08"), /** - * Service version {@code 2021-08-06}. + * Enum value 2021-08-06. */ V2021_08_06("2021-08-06"), /** - * Service version {@code 2021-10-04}. + * Enum value 2021-10-04. */ V2021_10_04("2021-10-04"), /** - * Service version {@code 2021-12-02}. + * Enum value 2021-12-02. */ V2021_12_02("2021-12-02"), /** - * Service version {@code 2022-11-02}. + * Enum value 2022-11-02. */ V2022_11_02("2022-11-02"), /** - * Service version {@code 2023-01-03}. + * Enum value 2023-01-03. */ V2023_01_03("2023-01-03"), /** - * Service version {@code 2023-05-03}. + * Enum value 2023-05-03. */ V2023_05_03("2023-05-03"), /** - * Service version {@code 2023-08-03}. + * Enum value 2023-08-03. */ V2023_08_03("2023-08-03"), /** - * Service version {@code 2023-11-03}. + * Enum value 2023-11-03. */ V2023_11_03("2023-11-03"), /** - * Service version {@code 2024-02-04}. + * Enum value 2024-02-04. */ V2024_02_04("2024-02-04"), /** - * Service version {@code 2024-05-04}. + * Enum value 2024-05-04. */ V2024_05_04("2024-05-04"), /** - * Service version {@code 2024-08-04}. + * Enum value 2024-08-04. */ V2024_08_04("2024-08-04"), /** - * Service version {@code 2024-11-04}. + * Enum value 2024-11-04. */ V2024_11_04("2024-11-04"), /** - * Service version {@code 2025-01-05}. + * Enum value 2025-01-05. */ V2025_01_05("2025-01-05"), /** - * Service version {@code 2025-05-05}. + * Enum value 2025-05-05. */ V2025_05_05("2025-05-05"), /** - * Service version {@code 2025-07-05}. + * Enum value 2025-07-05. */ V2025_07_05("2025-07-05"), /** - * Service version {@code 2025-11-05}. + * Enum value 2025-11-05. */ V2025_11_05("2025-11-05"), /** - * Service version {@code 2026-02-06}. + * Enum value 2026-02-06. */ V2026_02_06("2026-02-06"), /** - * Service version {@code 2026-04-06}. + * Enum value 2026-04-06. */ V2026_04_06("2026-04-06"), /** - * Service version {@code 2026-06-06}. + * Enum value 2026-06-06. */ V2026_06_06("2026-06-06"); @@ -179,9 +180,9 @@ public String getVersion() { } /** - * Gets the latest service version supported by this client library - * - * @return the latest {@link ShareServiceVersion} + * Gets the latest service version supported by this client library. + * + * @return The latest {@link ShareServiceVersion}. */ public static ShareServiceVersion getLatest() { return V2026_06_06; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java index b46ccad58938..076c00869967 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation; @@ -10,6 +10,7 @@ import com.azure.core.http.policy.UserAgentPolicy; import com.azure.core.util.serializer.JacksonAdapter; import com.azure.core.util.serializer.SerializerAdapter; +import com.azure.storage.file.share.ShareServiceVersion; import com.azure.storage.file.share.models.ShareTokenIntent; /** @@ -17,26 +18,26 @@ */ public final class AzureFileStorageImpl { /** - * Specifies the version of the operation to use for this request. + * The URL of the service account, share, directory or file that is the target of the desired operation. */ - private final String version; + private final String url; /** - * Gets Specifies the version of the operation to use for this request. + * Gets The URL of the service account, share, directory or file that is the target of the desired operation. * - * @return the version value. + * @return the url value. */ - public String getVersion() { - return this.version; + public String getUrl() { + return this.url; } /** - * Valid value is backup. + * Valid values are 'backup'. */ private final ShareTokenIntent fileRequestIntent; /** - * Gets Valid value is backup. + * Gets Valid values are 'backup'. * * @return the fileRequestIntent value. */ @@ -45,26 +46,12 @@ public ShareTokenIntent getFileRequestIntent() { } /** - * The URL of the service account, share, directory or file that is the target of the desired operation. - */ - private final String url; - - /** - * Gets The URL of the service account, share, directory or file that is the target of the desired operation. - * - * @return the url value. - */ - public String getUrl() { - return this.url; - } - - /** - * If true, the trailing dot will not be trimmed from the target URI. + * If true, the trailing dot will not be trimmed from the target file/directory path. */ private final boolean allowTrailingDot; /** - * Gets If true, the trailing dot will not be trimmed from the target URI. + * Gets If true, the trailing dot will not be trimmed from the target file/directory path. * * @return the allowTrailingDot value. */ @@ -86,6 +73,20 @@ public boolean isAllowSourceTrailingDot() { return this.allowSourceTrailingDot; } + /** + * Service version. + */ + private final ShareServiceVersion serviceVersion; + + /** + * Gets Service version. + * + * @return the serviceVersion value. + */ + public ShareServiceVersion getServiceVersion() { + return this.serviceVersion; + } + /** * The HTTP pipeline to send requests through. */ @@ -115,91 +116,91 @@ public SerializerAdapter getSerializerAdapter() { } /** - * The ServicesImpl object to access its operations. + * The DirectoriesImpl object to access its operations. */ - private final ServicesImpl services; + private final DirectoriesImpl directories; /** - * Gets the ServicesImpl object to access its operations. + * Gets the DirectoriesImpl object to access its operations. * - * @return the ServicesImpl object. + * @return the DirectoriesImpl object. */ - public ServicesImpl getServices() { - return this.services; + public DirectoriesImpl getDirectories() { + return this.directories; } /** - * The SharesImpl object to access its operations. + * The FilesImpl object to access its operations. */ - private final SharesImpl shares; + private final FilesImpl files; /** - * Gets the SharesImpl object to access its operations. + * Gets the FilesImpl object to access its operations. * - * @return the SharesImpl object. + * @return the FilesImpl object. */ - public SharesImpl getShares() { - return this.shares; + public FilesImpl getFiles() { + return this.files; } /** - * The DirectoriesImpl object to access its operations. + * The ServicesImpl object to access its operations. */ - private final DirectoriesImpl directories; + private final ServicesImpl services; /** - * Gets the DirectoriesImpl object to access its operations. + * Gets the ServicesImpl object to access its operations. * - * @return the DirectoriesImpl object. + * @return the ServicesImpl object. */ - public DirectoriesImpl getDirectories() { - return this.directories; + public ServicesImpl getServices() { + return this.services; } /** - * The FilesImpl object to access its operations. + * The SharesImpl object to access its operations. */ - private final FilesImpl files; + private final SharesImpl shares; /** - * Gets the FilesImpl object to access its operations. + * Gets the SharesImpl object to access its operations. * - * @return the FilesImpl object. + * @return the SharesImpl object. */ - public FilesImpl getFiles() { - return this.files; + public SharesImpl getShares() { + return this.shares; } /** * Initializes an instance of AzureFileStorage client. * - * @param version Specifies the version of the operation to use for this request. - * @param fileRequestIntent Valid value is backup. * @param url The URL of the service account, share, directory or file that is the target of the desired operation. - * @param allowTrailingDot If true, the trailing dot will not be trimmed from the target URI. + * @param fileRequestIntent Valid values are 'backup'. + * @param allowTrailingDot If true, the trailing dot will not be trimmed from the target file/directory path. * @param allowSourceTrailingDot If true, the trailing dot will not be trimmed from the source URI. + * @param serviceVersion Service version. */ - public AzureFileStorageImpl(String version, ShareTokenIntent fileRequestIntent, String url, - boolean allowTrailingDot, boolean allowSourceTrailingDot) { + public AzureFileStorageImpl(String url, ShareTokenIntent fileRequestIntent, boolean allowTrailingDot, + boolean allowSourceTrailingDot, ShareServiceVersion serviceVersion) { this(new HttpPipelineBuilder().policies(new UserAgentPolicy(), new RetryPolicy()).build(), - JacksonAdapter.createDefaultSerializerAdapter(), version, fileRequestIntent, url, allowTrailingDot, - allowSourceTrailingDot); + JacksonAdapter.createDefaultSerializerAdapter(), url, fileRequestIntent, allowTrailingDot, + allowSourceTrailingDot, serviceVersion); } /** * Initializes an instance of AzureFileStorage client. * * @param httpPipeline The HTTP pipeline to send requests through. - * @param version Specifies the version of the operation to use for this request. - * @param fileRequestIntent Valid value is backup. * @param url The URL of the service account, share, directory or file that is the target of the desired operation. - * @param allowTrailingDot If true, the trailing dot will not be trimmed from the target URI. + * @param fileRequestIntent Valid values are 'backup'. + * @param allowTrailingDot If true, the trailing dot will not be trimmed from the target file/directory path. * @param allowSourceTrailingDot If true, the trailing dot will not be trimmed from the source URI. + * @param serviceVersion Service version. */ - public AzureFileStorageImpl(HttpPipeline httpPipeline, String version, ShareTokenIntent fileRequestIntent, - String url, boolean allowTrailingDot, boolean allowSourceTrailingDot) { - this(httpPipeline, JacksonAdapter.createDefaultSerializerAdapter(), version, fileRequestIntent, url, - allowTrailingDot, allowSourceTrailingDot); + public AzureFileStorageImpl(HttpPipeline httpPipeline, String url, ShareTokenIntent fileRequestIntent, + boolean allowTrailingDot, boolean allowSourceTrailingDot, ShareServiceVersion serviceVersion) { + this(httpPipeline, JacksonAdapter.createDefaultSerializerAdapter(), url, fileRequestIntent, allowTrailingDot, + allowSourceTrailingDot, serviceVersion); } /** @@ -207,24 +208,25 @@ public AzureFileStorageImpl(HttpPipeline httpPipeline, String version, ShareToke * * @param httpPipeline The HTTP pipeline to send requests through. * @param serializerAdapter The serializer to serialize an object into a string. - * @param version Specifies the version of the operation to use for this request. - * @param fileRequestIntent Valid value is backup. * @param url The URL of the service account, share, directory or file that is the target of the desired operation. - * @param allowTrailingDot If true, the trailing dot will not be trimmed from the target URI. + * @param fileRequestIntent Valid values are 'backup'. + * @param allowTrailingDot If true, the trailing dot will not be trimmed from the target file/directory path. * @param allowSourceTrailingDot If true, the trailing dot will not be trimmed from the source URI. + * @param serviceVersion Service version. */ - public AzureFileStorageImpl(HttpPipeline httpPipeline, SerializerAdapter serializerAdapter, String version, - ShareTokenIntent fileRequestIntent, String url, boolean allowTrailingDot, boolean allowSourceTrailingDot) { + public AzureFileStorageImpl(HttpPipeline httpPipeline, SerializerAdapter serializerAdapter, String url, + ShareTokenIntent fileRequestIntent, boolean allowTrailingDot, boolean allowSourceTrailingDot, + ShareServiceVersion serviceVersion) { this.httpPipeline = httpPipeline; this.serializerAdapter = serializerAdapter; - this.version = version; - this.fileRequestIntent = fileRequestIntent; this.url = url; + this.fileRequestIntent = fileRequestIntent; this.allowTrailingDot = allowTrailingDot; this.allowSourceTrailingDot = allowSourceTrailingDot; - this.services = new ServicesImpl(this); - this.shares = new SharesImpl(this); + this.serviceVersion = serviceVersion; this.directories = new DirectoriesImpl(this); this.files = new FilesImpl(this); + this.services = new ServicesImpl(this); + this.shares = new SharesImpl(this); } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java index f166775a06c6..ea3905283eee 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation; import com.azure.core.annotation.Delete; @@ -9,41 +9,31 @@ import com.azure.core.annotation.HeaderParam; import com.azure.core.annotation.Host; import com.azure.core.annotation.HostParam; -import com.azure.core.annotation.PathParam; import com.azure.core.annotation.Put; -import com.azure.core.annotation.QueryParam; import com.azure.core.annotation.ReturnType; import com.azure.core.annotation.ServiceInterface; import com.azure.core.annotation.ServiceMethod; import com.azure.core.annotation.UnexpectedResponseExceptionType; +import com.azure.core.exception.ClientAuthenticationException; +import com.azure.core.exception.HttpResponseException; +import com.azure.core.exception.ResourceModifiedException; +import com.azure.core.exception.ResourceNotFoundException; +import com.azure.core.http.rest.PagedFlux; +import com.azure.core.http.rest.PagedIterable; +import com.azure.core.http.rest.PagedResponse; +import com.azure.core.http.rest.PagedResponseBase; +import com.azure.core.http.rest.RequestOptions; import com.azure.core.http.rest.Response; -import com.azure.core.http.rest.ResponseBase; import com.azure.core.http.rest.RestProxy; +import com.azure.core.util.BinaryData; import com.azure.core.util.Context; import com.azure.core.util.FluxUtil; -import com.azure.storage.file.share.implementation.models.CopyFileSmbInfo; -import com.azure.storage.file.share.implementation.models.DestinationLeaseAccessConditions; -import com.azure.storage.file.share.implementation.models.DirectoriesCreateHeaders; -import com.azure.storage.file.share.implementation.models.DirectoriesDeleteHeaders; -import com.azure.storage.file.share.implementation.models.DirectoriesForceCloseHandlesHeaders; -import com.azure.storage.file.share.implementation.models.DirectoriesGetPropertiesHeaders; -import com.azure.storage.file.share.implementation.models.DirectoriesListFilesAndDirectoriesSegmentHeaders; -import com.azure.storage.file.share.implementation.models.DirectoriesListHandlesHeaders; -import com.azure.storage.file.share.implementation.models.DirectoriesRenameHeaders; -import com.azure.storage.file.share.implementation.models.DirectoriesSetMetadataHeaders; -import com.azure.storage.file.share.implementation.models.DirectoriesSetPropertiesHeaders; -import com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse; -import com.azure.storage.file.share.implementation.models.ListFilesIncludeType; -import com.azure.storage.file.share.implementation.models.ListHandlesResponse; +import com.azure.storage.file.share.ShareServiceVersion; import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal; -import com.azure.storage.file.share.implementation.models.SourceLeaseAccessConditions; import com.azure.storage.file.share.implementation.util.ModelHelper; -import com.azure.storage.file.share.models.FilePermissionFormat; -import com.azure.storage.file.share.models.FilePropertySemantics; import com.azure.storage.file.share.models.ShareTokenIntent; import java.util.List; import java.util.Map; -import java.util.Objects; import java.util.stream.Collectors; import reactor.core.publisher.Mono; @@ -73,6 +63,19 @@ public final class DirectoriesImpl { this.client = client; } + /** + * Gets Service version. + * + * @return the serviceVersion value. + */ + public ShareServiceVersion getServiceVersion() { + try { + return client.getServiceVersion(); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + /** * The interface defining all the services for AzureFileStorageDirectories to be used by the proxy service to * perform REST calls. @@ -81,3688 +84,1277 @@ public final class DirectoriesImpl { @ServiceInterface(name = "AzureFileStorageDirectories") public interface DirectoriesService { - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> create(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") + @Put("?restype=directory") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> create(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{directory}") + @Put("?restype=directory") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase createSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response createNoCustomHeadersSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("directory") String directory, @QueryParam("restype") String restype, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getProperties(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getPropertiesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response createSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{directory}") + @Get("?restype=directory") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getPropertiesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getProperties(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{directory}") + @Get("?restype=directory") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getPropertiesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Delete("/{shareName}/{directory}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> delete(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getPropertiesSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Delete("/{shareName}/{directory}") + @Delete("?restype=directory") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> deleteNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> delete(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Delete("/{shareName}/{directory}") + @Delete("?restype=directory") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase deleteSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Delete("/{shareName}/{directory}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response deleteNoCustomHeadersSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("directory") String directory, @QueryParam("restype") String restype, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setProperties(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setPropertiesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase setPropertiesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response setPropertiesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setMetadata(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setMetadataNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase setMetadataSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response setMetadataNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> - listFilesAndDirectoriesSegment(@HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("directory") String directory, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("prefix") String prefix, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @QueryParam("include") String include, - @HeaderParam("x-ms-file-extended-info") Boolean includeExtendedInfo, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listFilesAndDirectoriesSegmentNoCustomHeaders( - @HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("directory") String directory, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("prefix") String prefix, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @QueryParam("include") String include, - @HeaderParam("x-ms-file-extended-info") Boolean includeExtendedInfo, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response deleteSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase - listFilesAndDirectoriesSegmentSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("directory") String directory, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("prefix") String prefix, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @QueryParam("include") String include, - @HeaderParam("x-ms-file-extended-info") Boolean includeExtendedInfo, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{directory}") + @Put("?restype=directory&comp=properties") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response listFilesAndDirectoriesSegmentNoCustomHeadersSync( - @HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("directory") String directory, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("prefix") String prefix, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @QueryParam("include") String include, - @HeaderParam("x-ms-file-extended-info") Boolean includeExtendedInfo, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> setProperties(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{directory}") + @Put("?restype=directory&comp=properties") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listHandles(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("comp") String comp, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-recursive") Boolean recursive, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response setPropertiesSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{directory}") + @Put("?restype=directory&comp=metadata") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listHandlesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("comp") String comp, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-recursive") Boolean recursive, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> setMetadata(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{directory}") + @Put("?restype=directory&comp=metadata") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase listHandlesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("comp") String comp, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-recursive") Boolean recursive, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response setMetadataSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{directory}") + @Get("?restype=directory&comp=list") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response listHandlesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("comp") String comp, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-recursive") Boolean recursive, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> listFilesAndDirectoriesSegment(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{directory}") + @Get("?restype=directory&comp=list") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> forceCloseHandles(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @QueryParam("marker") String marker, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-recursive") Boolean recursive, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response listFilesAndDirectoriesSegmentSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{directory}") + @Get("?comp=listhandles") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> forceCloseHandlesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @QueryParam("marker") String marker, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-recursive") Boolean recursive, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> listHandles(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{directory}") + @Get("?comp=listhandles") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase forceCloseHandlesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @QueryParam("marker") String marker, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-recursive") Boolean recursive, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response listHandlesSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{directory}") + @Put("?comp=forceclosehandles") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response forceCloseHandlesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @QueryParam("marker") String marker, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-recursive") Boolean recursive, - @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> forceCloseHandles(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{directory}") + @Put("?comp=forceclosehandles") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> rename(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-rename-source") String renameSource, - @HeaderParam("x-ms-file-rename-replace-if-exists") Boolean replaceIfExists, - @HeaderParam("x-ms-file-rename-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-source-lease-id") String sourceLeaseId, - @HeaderParam("x-ms-destination-lease-id") String destinationLeaseId, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-meta-") Map metadata, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response forceCloseHandlesSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{directory}") + @Put("?restype=directory&comp=rename") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> renameNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> rename(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-rename-source") String renameSource, - @HeaderParam("x-ms-file-rename-replace-if-exists") Boolean replaceIfExists, - @HeaderParam("x-ms-file-rename-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-source-lease-id") String sourceLeaseId, - @HeaderParam("x-ms-destination-lease-id") String destinationLeaseId, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{directory}") + @Put("?restype=directory&comp=rename") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase renameSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("directory") String directory, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response renameSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-rename-source") String renameSource, - @HeaderParam("x-ms-file-rename-replace-if-exists") Boolean replaceIfExists, - @HeaderParam("x-ms-file-rename-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-source-lease-id") String sourceLeaseId, - @HeaderParam("x-ms-destination-lease-id") String destinationLeaseId, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{directory}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response renameNoCustomHeadersSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("directory") String directory, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-file-rename-source") String renameSource, - @HeaderParam("x-ms-file-rename-replace-if-exists") Boolean replaceIfExists, - @HeaderParam("x-ms-file-rename-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-source-lease-id") String sourceLeaseId, - @HeaderParam("x-ms-destination-lease-id") String destinationLeaseId, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); } /** * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-file-permissionStringNoIf specified the permission (security descriptor) + * shall be set for the directory/file. This header can be used if Permission size is <= 8KB, else + * x-ms-file-permission-key header shall be used. Default value: Inherit. If SDDL is specified as input, it must + * have owner, group and dacl. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-permission-keyStringNoKey of the permission to be set for the + * directory/file. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set. Default value: 'Archive' for file and 'Directory' for directory. 'None' can also be specified as + * default.
x-ms-file-creation-timeStringNoCreation time for the file/directory. Default + * value: Now.
x-ms-file-last-write-timeStringNoLast write time for the file/directory. + * Default value: Now.
x-ms-file-change-timeStringNoChange time for the file/directory. Default + * value: Now.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
x-ms-file-property-semanticsStringNoSMB only. Default value is New. Allowed + * values: "New", "Restore".
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createWithResponseAsync(String shareName, - String directory, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, String group, - String fileMode, FilePropertySemantics filePropertySemantics) { + public Mono> createWithResponseAsync(RequestOptions requestOptions) { return FluxUtil - .withContext(context -> createWithResponseAsync(shareName, directory, timeout, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, owner, group, fileMode, filePropertySemantics, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createWithResponseAsync(String shareName, - String directory, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, String group, - String fileMode, FilePropertySemantics filePropertySemantics, Context context) { - final String restype = "directory"; - final String accept = "application/xml"; - return service - .create(this.client.getUrl(), shareName, directory, restype, this.client.isAllowTrailingDot(), timeout, - metadata, this.client.getVersion(), filePermission, filePermissionFormat, filePermissionKey, - fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, this.client.getFileRequestIntent(), - owner, group, fileMode, filePropertySemantics, accept, context) + .withContext(context -> service.create(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createAsync(String shareName, String directory, Integer timeout, Map metadata, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, - String group, String fileMode, FilePropertySemantics filePropertySemantics) { - return createWithResponseAsync(shareName, directory, timeout, metadata, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, owner, group, - fileMode, filePropertySemantics) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-file-permissionStringNoIf specified the permission (security descriptor) + * shall be set for the directory/file. This header can be used if Permission size is <= 8KB, else + * x-ms-file-permission-key header shall be used. Default value: Inherit. If SDDL is specified as input, it must + * have owner, group and dacl. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-permission-keyStringNoKey of the permission to be set for the + * directory/file. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set. Default value: 'Archive' for file and 'Directory' for directory. 'None' can also be specified as + * default.
x-ms-file-creation-timeStringNoCreation time for the file/directory. Default + * value: Now.
x-ms-file-last-write-timeStringNoLast write time for the file/directory. + * Default value: Now.
x-ms-file-change-timeStringNoChange time for the file/directory. Default + * value: Now.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
x-ms-file-property-semanticsStringNoSMB only. Default value is New. Allowed + * values: "New", "Restore".
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createAsync(String shareName, String directory, Integer timeout, Map metadata, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, - String group, String fileMode, FilePropertySemantics filePropertySemantics, Context context) { - return createWithResponseAsync(shareName, directory, timeout, metadata, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, owner, group, - fileMode, filePropertySemantics, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + public Response createWithResponse(RequestOptions requestOptions) { + try { + return service.createSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Returns all system properties for the specified directory, and can also be used to check the existence of a + * directory. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createNoCustomHeadersWithResponseAsync(String shareName, String directory, - Integer timeout, Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String owner, String group, String fileMode, - FilePropertySemantics filePropertySemantics) { + public Mono> getPropertiesWithResponseAsync(RequestOptions requestOptions) { return FluxUtil - .withContext(context -> createNoCustomHeadersWithResponseAsync(shareName, directory, timeout, metadata, - filePermission, filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, - fileLastWriteTime, fileChangeTime, owner, group, fileMode, filePropertySemantics, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createNoCustomHeadersWithResponseAsync(String shareName, String directory, - Integer timeout, Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String owner, String group, String fileMode, FilePropertySemantics filePropertySemantics, - Context context) { - final String restype = "directory"; - final String accept = "application/xml"; - return service - .createNoCustomHeaders(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), timeout, metadata, this.client.getVersion(), filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, this.client.getFileRequestIntent(), owner, group, fileMode, filePropertySemantics, - accept, context) + .withContext( + context -> service.getProperties(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * Returns all system properties for the specified directory, and can also be used to check the existence of a + * directory. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase createWithResponse(String shareName, String directory, - Integer timeout, Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String owner, String group, String fileMode, FilePropertySemantics filePropertySemantics, - Context context) { + public Response getPropertiesWithResponse(RequestOptions requestOptions) { try { - final String restype = "directory"; - final String accept = "application/xml"; - return service.createSync(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), timeout, metadata, this.client.getVersion(), filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, this.client.getFileRequestIntent(), owner, group, fileMode, filePropertySemantics, - accept, context); + return service.getPropertiesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void create(String shareName, String directory, Integer timeout, Map metadata, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, - String group, String fileMode, FilePropertySemantics filePropertySemantics) { - createWithResponse(shareName, directory, timeout, metadata, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, owner, group, - fileMode, filePropertySemantics, Context.NONE); + public Mono> deleteWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext(context -> service.delete(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Creates a new directory under the specified share or parent directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response createNoCustomHeadersWithResponse(String shareName, String directory, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String owner, String group, String fileMode, FilePropertySemantics filePropertySemantics, - Context context) { + public Response deleteWithResponse(RequestOptions requestOptions) { try { - final String restype = "directory"; - final String accept = "application/xml"; - return service.createNoCustomHeadersSync(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), timeout, metadata, this.client.getVersion(), filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, this.client.getFileRequestIntent(), owner, group, fileMode, filePropertySemantics, - accept, context); + return service.deleteSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + * Sets properties for the specified directory. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-permissionStringNoIf specified the permission (security descriptor) + * shall be set for the directory/file. This header can be used if Permission size is <= 8KB, else + * x-ms-file-permission-key header shall be used. Default value: Inherit. If SDDL is specified as input, it must + * have owner, group and dacl. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-permission-keyStringNoKey of the permission to be set for the + * directory/file. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set. Default value: 'Archive' for file and 'Directory' for directory. 'None' can also be specified as + * default.
x-ms-file-creation-timeStringNoCreation time for the file/directory. Default + * value: Now.
x-ms-file-last-write-timeStringNoLast write time for the file/directory. + * Default value: Now.
x-ms-file-change-timeStringNoChange time for the file/directory. Default + * value: Now.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesWithResponseAsync(String shareName, - String directory, String sharesnapshot, Integer timeout) { + public Mono> setPropertiesWithResponseAsync(RequestOptions requestOptions) { return FluxUtil .withContext( - context -> getPropertiesWithResponseAsync(shareName, directory, sharesnapshot, timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesWithResponseAsync(String shareName, - String directory, String sharesnapshot, Integer timeout, Context context) { - final String restype = "directory"; - final String accept = "application/xml"; - return service - .getProperties(this.client.getUrl(), shareName, directory, restype, this.client.isAllowTrailingDot(), - sharesnapshot, timeout, this.client.getVersion(), this.client.getFileRequestIntent(), accept, context) + context -> service.setProperties(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPropertiesAsync(String shareName, String directory, String sharesnapshot, Integer timeout) { - return getPropertiesWithResponseAsync(shareName, directory, sharesnapshot, timeout) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * Sets properties for the specified directory. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-permissionStringNoIf specified the permission (security descriptor) + * shall be set for the directory/file. This header can be used if Permission size is <= 8KB, else + * x-ms-file-permission-key header shall be used. Default value: Inherit. If SDDL is specified as input, it must + * have owner, group and dacl. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-permission-keyStringNoKey of the permission to be set for the + * directory/file. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set. Default value: 'Archive' for file and 'Directory' for directory. 'None' can also be specified as + * default.
x-ms-file-creation-timeStringNoCreation time for the file/directory. Default + * value: Now.
x-ms-file-last-write-timeStringNoLast write time for the file/directory. + * Default value: Now.
x-ms-file-change-timeStringNoChange time for the file/directory. Default + * value: Now.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPropertiesAsync(String shareName, String directory, String sharesnapshot, Integer timeout, - Context context) { - return getPropertiesWithResponseAsync(shareName, directory, sharesnapshot, timeout, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + public Response setPropertiesWithResponse(RequestOptions requestOptions) { + try { + return service.setPropertiesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Sets one or more user-defined name-value pairs for the specified directory. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesNoCustomHeadersWithResponseAsync(String shareName, String directory, - String sharesnapshot, Integer timeout) { + public Mono> setMetadataWithResponseAsync(RequestOptions requestOptions) { return FluxUtil - .withContext(context -> getPropertiesNoCustomHeadersWithResponseAsync(shareName, directory, sharesnapshot, - timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesNoCustomHeadersWithResponseAsync(String shareName, String directory, - String sharesnapshot, Integer timeout, Context context) { - final String restype = "directory"; - final String accept = "application/xml"; - return service - .getPropertiesNoCustomHeaders(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), sharesnapshot, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context) + .withContext( + context -> service.setMetadata(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * Sets one or more user-defined name-value pairs for the specified directory. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase getPropertiesWithResponse(String shareName, - String directory, String sharesnapshot, Integer timeout, Context context) { + public Response setMetadataWithResponse(RequestOptions requestOptions) { try { - final String restype = "directory"; - final String accept = "application/xml"; - return service.getPropertiesSync(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), sharesnapshot, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context); + return service.setMetadataSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Returns a list of files and directories under the specified share or directory. It lists the contents only for a + * single level of the directory hierarchy. + *

Query Parameters

+ * + * + * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
prefixStringNoFilters the results to return only items whose name begins with + * the specified prefix.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
includeList<String>NoInclude this parameter to specify one or more + * datasets to include in the response. In the form of "," separated string.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-extended-infoBooleanNoInclude extended information.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     ServiceEndpoint: String (Required)
+     *     ShareName: String (Required)
+     *     ShareSnapshot: String (Optional)
+     *     Encoded: Boolean (Optional)
+     *     DirectoryPath: String (Required)
+     *     Prefix (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     Marker: String (Optional)
+     *     MaxResults: Integer (Optional)
+     *     Entries (Required): {
+     *         Directory (Required): [
+     *              (Required){
+     *                 Name (Required): (recursive schema, see Name above)
+     *                 FileId: String (Optional)
+     *                 Properties (Optional): {
+     *                     Content-Length: long (Required)
+     *                     CreationTime: OffsetDateTime (Optional)
+     *                     LastAccessTime: OffsetDateTime (Optional)
+     *                     LastWriteTime: OffsetDateTime (Optional)
+     *                     ChangeTime: OffsetDateTime (Optional)
+     *                     Last-Modified: DateTimeRfc1123 (Optional)
+     *                     Etag: String (Optional)
+     *                 }
+     *                 Attributes: String (Optional)
+     *                 PermissionKey: String (Optional)
+     *             }
+     *         ]
+     *         File (Required): [
+     *              (Required){
+     *                 Name (Required): (recursive schema, see Name above)
+     *                 FileId: String (Optional)
+     *                 Properties (Required): (recursive schema, see Properties above)
+     *                 Attributes: String (Optional)
+     *                 PermissionKey: String (Optional)
+     *             }
+     *         ]
+     *     }
+     *     NextMarker: String (Required)
+     *     DirectoryId: String (Optional)
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of directories and files along with {@link Response} on successful completion of + * {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void getProperties(String shareName, String directory, String sharesnapshot, Integer timeout) { - getPropertiesWithResponse(shareName, directory, sharesnapshot, timeout, Context.NONE); + public Mono> listFilesAndDirectoriesSegmentWithResponseAsync(RequestOptions requestOptions) { + final String accept = "application/xml"; + return FluxUtil + .withContext(context -> service.listFilesAndDirectoriesSegment(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), accept, requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Returns all system properties for the specified directory, and can also be used to check the existence of a - * directory. The data returned does not include the files in the directory or any subdirectories. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. + * Returns a list of files and directories under the specified share or directory. It lists the contents only for a + * single level of the directory hierarchy. + *

Query Parameters

+ * + * + * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
prefixStringNoFilters the results to return only items whose name begins with + * the specified prefix.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
includeList<String>NoInclude this parameter to specify one or more + * datasets to include in the response. In the form of "," separated string.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-extended-infoBooleanNoInclude extended information.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     ServiceEndpoint: String (Required)
+     *     ShareName: String (Required)
+     *     ShareSnapshot: String (Optional)
+     *     Encoded: Boolean (Optional)
+     *     DirectoryPath: String (Required)
+     *     Prefix (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     Marker: String (Optional)
+     *     MaxResults: Integer (Optional)
+     *     Entries (Required): {
+     *         Directory (Required): [
+     *              (Required){
+     *                 Name (Required): (recursive schema, see Name above)
+     *                 FileId: String (Optional)
+     *                 Properties (Optional): {
+     *                     Content-Length: long (Required)
+     *                     CreationTime: OffsetDateTime (Optional)
+     *                     LastAccessTime: OffsetDateTime (Optional)
+     *                     LastWriteTime: OffsetDateTime (Optional)
+     *                     ChangeTime: OffsetDateTime (Optional)
+     *                     Last-Modified: DateTimeRfc1123 (Optional)
+     *                     Etag: String (Optional)
+     *                 }
+     *                 Attributes: String (Optional)
+     *                 PermissionKey: String (Optional)
+     *             }
+     *         ]
+     *         File (Required): [
+     *              (Required){
+     *                 Name (Required): (recursive schema, see Name above)
+     *                 FileId: String (Optional)
+     *                 Properties (Required): (recursive schema, see Properties above)
+     *                 Attributes: String (Optional)
+     *                 PermissionKey: String (Optional)
+     *             }
+     *         ]
+     *     }
+     *     NextMarker: String (Required)
+     *     DirectoryId: String (Optional)
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of directories and files along with {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response getPropertiesNoCustomHeadersWithResponse(String shareName, String directory, - String sharesnapshot, Integer timeout, Context context) { + public Response listFilesAndDirectoriesSegmentWithResponse(RequestOptions requestOptions) { try { - final String restype = "directory"; final String accept = "application/xml"; - return service.getPropertiesNoCustomHeadersSync(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), sharesnapshot, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context); + return service.listFilesAndDirectoriesSegmentSync(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteWithResponseAsync(String shareName, - String directory, Integer timeout) { - return FluxUtil.withContext(context -> deleteWithResponseAsync(shareName, directory, timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteWithResponseAsync(String shareName, - String directory, Integer timeout, Context context) { - final String restype = "directory"; + * Lists handles for directory. + *

Query Parameters

+ * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-recursiveBooleanNoSpecifies operation should apply to the directory + * specified in the URI, its files, its subdirectories and their files.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HandleId: String (Required)
+     *     Path (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     FileId: String (Required)
+     *     ParentId: String (Optional)
+     *     SessionId: String (Required)
+     *     ClientIp: String (Required)
+     *     ClientName: String (Required)
+     *     OpenTime: DateTimeRfc1123 (Required)
+     *     LastReconnectTime: DateTimeRfc1123 (Optional)
+     *     AccessRightList (Optional): [
+     *         String(Read/Write/Delete) (Optional)
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of handles along with {@link PagedResponse} on successful completion of {@link Mono}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + private Mono> listHandlesSinglePageAsync(RequestOptions requestOptions) { final String accept = "application/xml"; - return service - .delete(this.client.getUrl(), shareName, directory, restype, this.client.isAllowTrailingDot(), timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + return FluxUtil + .withContext(context -> service.listHandles(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), accept, requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) + .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), + getValues(res.getValue(), "Entries"), null, null)); } /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono deleteAsync(String shareName, String directory, Integer timeout) { - return deleteWithResponseAsync(shareName, directory, timeout) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + * Lists handles for directory. + *

Query Parameters

+ * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-recursiveBooleanNoSpecifies operation should apply to the directory + * specified in the URI, its files, its subdirectories and their files.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HandleId: String (Required)
+     *     Path (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     FileId: String (Required)
+     *     ParentId: String (Optional)
+     *     SessionId: String (Required)
+     *     ClientIp: String (Required)
+     *     ClientName: String (Required)
+     *     OpenTime: DateTimeRfc1123 (Required)
+     *     LastReconnectTime: DateTimeRfc1123 (Optional)
+     *     AccessRightList (Optional): [
+     *         String(Read/Write/Delete) (Optional)
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of handles as paginated response with {@link PagedFlux}. + */ + @ServiceMethod(returns = ReturnType.COLLECTION) + public PagedFlux listHandlesAsync(RequestOptions requestOptions) { + return new PagedFlux<>(() -> listHandlesSinglePageAsync(requestOptions)); } /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono deleteAsync(String shareName, String directory, Integer timeout, Context context) { - return deleteWithResponseAsync(shareName, directory, timeout, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + * Lists handles for directory. + *

Query Parameters

+ * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-recursiveBooleanNoSpecifies operation should apply to the directory + * specified in the URI, its files, its subdirectories and their files.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HandleId: String (Required)
+     *     Path (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     FileId: String (Required)
+     *     ParentId: String (Optional)
+     *     SessionId: String (Required)
+     *     ClientIp: String (Required)
+     *     ClientName: String (Required)
+     *     OpenTime: DateTimeRfc1123 (Required)
+     *     LastReconnectTime: DateTimeRfc1123 (Optional)
+     *     AccessRightList (Optional): [
+     *         String(Read/Write/Delete) (Optional)
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of handles along with {@link PagedResponse}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + private PagedResponse listHandlesSinglePage(RequestOptions requestOptions) { + try { + final String accept = "application/xml"; + Response res = service.listHandlesSync(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); + return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), + getValues(res.getValue(), "Entries"), null, null); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteNoCustomHeadersWithResponseAsync(String shareName, String directory, - Integer timeout) { - return FluxUtil - .withContext(context -> deleteNoCustomHeadersWithResponseAsync(shareName, directory, timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + * Lists handles for directory. + *

Query Parameters

+ * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-recursiveBooleanNoSpecifies operation should apply to the directory + * specified in the URI, its files, its subdirectories and their files.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HandleId: String (Required)
+     *     Path (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     FileId: String (Required)
+     *     ParentId: String (Optional)
+     *     SessionId: String (Required)
+     *     ClientIp: String (Required)
+     *     ClientName: String (Required)
+     *     OpenTime: DateTimeRfc1123 (Required)
+     *     LastReconnectTime: DateTimeRfc1123 (Optional)
+     *     AccessRightList (Optional): [
+     *         String(Read/Write/Delete) (Optional)
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of handles as paginated response with {@link PagedIterable}. + */ + @ServiceMethod(returns = ReturnType.COLLECTION) + public PagedIterable listHandles(RequestOptions requestOptions) { + return new PagedIterable<>(() -> listHandlesSinglePage(requestOptions)); } /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Closes all handles open for given directory. + *

Query Parameters

+ * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-recursiveBooleanNoSpecifies operation should apply to the directory + * specified in the URI, its files, its subdirectories and their files.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk ('*') is a wildcard + * that specifies all handles. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteNoCustomHeadersWithResponseAsync(String shareName, String directory, - Integer timeout, Context context) { - final String restype = "directory"; - final String accept = "application/xml"; - return service - .deleteNoCustomHeaders(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), timeout, this.client.getVersion(), this.client.getFileRequestIntent(), - accept, context) + public Mono> forceCloseHandlesWithResponseAsync(String handleId, RequestOptions requestOptions) { + return FluxUtil + .withContext(context -> service.forceCloseHandles(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), handleId, this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * Closes all handles open for given directory. + *

Query Parameters

+ * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-recursiveBooleanNoSpecifies operation should apply to the directory + * specified in the URI, its files, its subdirectories and their files.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk ('*') is a wildcard + * that specifies all handles. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase deleteWithResponse(String shareName, String directory, - Integer timeout, Context context) { + public Response forceCloseHandlesWithResponse(String handleId, RequestOptions requestOptions) { try { - final String restype = "directory"; - final String accept = "application/xml"; - return service.deleteSync(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), timeout, this.client.getVersion(), this.client.getFileRequestIntent(), - accept, context); + return service.forceCloseHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + handleId, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, + Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. + * Renames a directory. By default, the destination is overwritten and if the destination already exists and has a + * read-only attribute set, the operation will fail. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-rename-replace-if-existsBooleanNoBoolean. Default value is false. + * Set to true to indicate that the destination should be overwritten.
x-ms-file-rename-ignore-readonlyBooleanNoBoolean. Default value is false. Set + * to true to overwrite the destination even if it has the read-only attribute set.
x-ms-source-lease-idStringNoRequired if the source file has an active + * lease.
x-ms-destination-lease-idStringNoRequired if the destination has an active + * lease.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set.
x-ms-file-creation-timeStringNoCreation time for the directory.
x-ms-file-last-write-timeStringNoLast write time for the directory.
x-ms-file-change-timeStringNoChange time for the directory.
x-ms-file-permissionStringNoIf specified the permission shall be set for the + * directory.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-file-permission-keyStringNoKey of the permission to be set.
x-ms-metaStringNoOptional. User-defined metadata for the resource.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void delete(String shareName, String directory, Integer timeout) { - deleteWithResponse(shareName, directory, timeout, Context.NONE); + public Mono> renameWithResponseAsync(String renameSource, RequestOptions requestOptions) { + return FluxUtil + .withContext(context -> service.rename(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + renameSource, this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), + this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Removes the specified empty directory. Note that the directory must be empty before it can be deleted. + * Renames a directory. By default, the destination is overwritten and if the destination already exists and has a + * read-only attribute set, the operation will fail. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-rename-replace-if-existsBooleanNoBoolean. Default value is false. + * Set to true to indicate that the destination should be overwritten.
x-ms-file-rename-ignore-readonlyBooleanNoBoolean. Default value is false. Set + * to true to overwrite the destination even if it has the read-only attribute set.
x-ms-source-lease-idStringNoRequired if the source file has an active + * lease.
x-ms-destination-lease-idStringNoRequired if the destination has an active + * lease.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set.
x-ms-file-creation-timeStringNoCreation time for the directory.
x-ms-file-last-write-timeStringNoLast write time for the directory.
x-ms-file-change-timeStringNoChange time for the directory.
x-ms-file-permissionStringNoIf specified the permission shall be set for the + * directory.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-file-permission-keyStringNoKey of the permission to be set.
x-ms-metaStringNoOptional. User-defined metadata for the resource.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response deleteNoCustomHeadersWithResponse(String shareName, String directory, Integer timeout, - Context context) { + public Response renameWithResponse(String renameSource, RequestOptions requestOptions) { try { - final String restype = "directory"; - final String accept = "application/xml"; - return service.deleteNoCustomHeadersSync(this.client.getUrl(), shareName, directory, restype, - this.client.isAllowTrailingDot(), timeout, this.client.getVersion(), this.client.getFileRequestIntent(), - accept, context); + return service.renameSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), renameSource, + this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesWithResponseAsync(String shareName, - String directory, Integer timeout, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String owner, String group, String fileMode) { - return FluxUtil - .withContext(context -> setPropertiesWithResponseAsync(shareName, directory, timeout, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, owner, group, fileMode, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesWithResponseAsync(String shareName, - String directory, Integer timeout, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String owner, String group, String fileMode, Context context) { - final String restype = "directory"; - final String comp = "properties"; - final String accept = "application/xml"; - return service - .setProperties(this.client.getUrl(), shareName, directory, restype, comp, timeout, this.client.getVersion(), - filePermission, filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, - fileLastWriteTime, fileChangeTime, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), - owner, group, fileMode, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setPropertiesAsync(String shareName, String directory, Integer timeout, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, String group, - String fileMode) { - return setPropertiesWithResponseAsync(shareName, directory, timeout, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, owner, group, - fileMode).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setPropertiesAsync(String shareName, String directory, Integer timeout, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, String group, - String fileMode, Context context) { - return setPropertiesWithResponseAsync(shareName, directory, timeout, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, owner, group, - fileMode, context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesNoCustomHeadersWithResponseAsync(String shareName, String directory, - Integer timeout, String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, - String group, String fileMode) { - return FluxUtil - .withContext(context -> setPropertiesNoCustomHeadersWithResponseAsync(shareName, directory, timeout, - filePermission, filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, - fileLastWriteTime, fileChangeTime, owner, group, fileMode, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesNoCustomHeadersWithResponseAsync(String shareName, String directory, - Integer timeout, String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, - String group, String fileMode, Context context) { - final String restype = "directory"; - final String comp = "properties"; - final String accept = "application/xml"; - return service - .setPropertiesNoCustomHeaders(this.client.getUrl(), shareName, directory, restype, comp, timeout, - this.client.getVersion(), filePermission, filePermissionFormat, filePermissionKey, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), owner, group, fileMode, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase setPropertiesWithResponse(String shareName, - String directory, Integer timeout, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String owner, String group, String fileMode, Context context) { - try { - final String restype = "directory"; - final String comp = "properties"; - final String accept = "application/xml"; - return service.setPropertiesSync(this.client.getUrl(), shareName, directory, restype, comp, timeout, - this.client.getVersion(), filePermission, filePermissionFormat, filePermissionKey, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), owner, group, fileMode, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void setProperties(String shareName, String directory, Integer timeout, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, String group, - String fileMode) { - setPropertiesWithResponse(shareName, directory, timeout, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, owner, group, - fileMode, Context.NONE); - } - - /** - * Sets properties on the directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response setPropertiesNoCustomHeadersWithResponse(String shareName, String directory, Integer timeout, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String owner, - String group, String fileMode, Context context) { - try { - final String restype = "directory"; - final String comp = "properties"; - final String accept = "application/xml"; - return service.setPropertiesNoCustomHeadersSync(this.client.getUrl(), shareName, directory, restype, comp, - timeout, this.client.getVersion(), filePermission, filePermissionFormat, filePermissionKey, - fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), owner, group, fileMode, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataWithResponseAsync(String shareName, - String directory, Integer timeout, Map metadata) { - return FluxUtil - .withContext(context -> setMetadataWithResponseAsync(shareName, directory, timeout, metadata, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataWithResponseAsync(String shareName, - String directory, Integer timeout, Map metadata, Context context) { - final String restype = "directory"; - final String comp = "metadata"; - final String accept = "application/xml"; - return service - .setMetadata(this.client.getUrl(), shareName, directory, restype, comp, timeout, metadata, - this.client.getVersion(), this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setMetadataAsync(String shareName, String directory, Integer timeout, - Map metadata) { - return setMetadataWithResponseAsync(shareName, directory, timeout, metadata) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setMetadataAsync(String shareName, String directory, Integer timeout, - Map metadata, Context context) { - return setMetadataWithResponseAsync(shareName, directory, timeout, metadata, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataNoCustomHeadersWithResponseAsync(String shareName, String directory, - Integer timeout, Map metadata) { - return FluxUtil.withContext( - context -> setMetadataNoCustomHeadersWithResponseAsync(shareName, directory, timeout, metadata, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataNoCustomHeadersWithResponseAsync(String shareName, String directory, - Integer timeout, Map metadata, Context context) { - final String restype = "directory"; - final String comp = "metadata"; - final String accept = "application/xml"; - return service - .setMetadataNoCustomHeaders(this.client.getUrl(), shareName, directory, restype, comp, timeout, metadata, - this.client.getVersion(), this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase setMetadataWithResponse(String shareName, String directory, - Integer timeout, Map metadata, Context context) { - try { - final String restype = "directory"; - final String comp = "metadata"; - final String accept = "application/xml"; - return service.setMetadataSync(this.client.getUrl(), shareName, directory, restype, comp, timeout, metadata, - this.client.getVersion(), this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void setMetadata(String shareName, String directory, Integer timeout, Map metadata) { - setMetadataWithResponse(shareName, directory, timeout, metadata, Context.NONE); - } - - /** - * Updates user defined metadata for the specified directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response setMetadataNoCustomHeadersWithResponse(String shareName, String directory, Integer timeout, - Map metadata, Context context) { - try { - final String restype = "directory"; - final String comp = "metadata"; - final String accept = "application/xml"; - return service.setMetadataNoCustomHeadersSync(this.client.getUrl(), shareName, directory, restype, comp, - timeout, metadata, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files along with {@link ResponseBase} on successful completion of - * {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - listFilesAndDirectoriesSegmentWithResponseAsync(String shareName, String directory, String prefix, - String sharesnapshot, String marker, Integer maxresults, Integer timeout, - List include, Boolean includeExtendedInfo) { - return FluxUtil - .withContext(context -> listFilesAndDirectoriesSegmentWithResponseAsync(shareName, directory, prefix, - sharesnapshot, marker, maxresults, timeout, include, includeExtendedInfo, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files along with {@link ResponseBase} on successful completion of - * {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - listFilesAndDirectoriesSegmentWithResponseAsync(String shareName, String directory, String prefix, - String sharesnapshot, String marker, Integer maxresults, Integer timeout, - List include, Boolean includeExtendedInfo, Context context) { - final String restype = "directory"; - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - return service.listFilesAndDirectoriesSegment(this.client.getUrl(), shareName, directory, restype, comp, prefix, - sharesnapshot, marker, maxresults, timeout, this.client.getVersion(), includeConverted, includeExtendedInfo, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono listFilesAndDirectoriesSegmentAsync(String shareName, - String directory, String prefix, String sharesnapshot, String marker, Integer maxresults, Integer timeout, - List include, Boolean includeExtendedInfo) { - return listFilesAndDirectoriesSegmentWithResponseAsync(shareName, directory, prefix, sharesnapshot, marker, - maxresults, timeout, include, includeExtendedInfo) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono listFilesAndDirectoriesSegmentAsync(String shareName, - String directory, String prefix, String sharesnapshot, String marker, Integer maxresults, Integer timeout, - List include, Boolean includeExtendedInfo, Context context) { - return listFilesAndDirectoriesSegmentWithResponseAsync(shareName, directory, prefix, sharesnapshot, marker, - maxresults, timeout, include, includeExtendedInfo, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files along with {@link Response} on successful completion of - * {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - listFilesAndDirectoriesSegmentNoCustomHeadersWithResponseAsync(String shareName, String directory, - String prefix, String sharesnapshot, String marker, Integer maxresults, Integer timeout, - List include, Boolean includeExtendedInfo) { - return FluxUtil - .withContext(context -> listFilesAndDirectoriesSegmentNoCustomHeadersWithResponseAsync(shareName, directory, - prefix, sharesnapshot, marker, maxresults, timeout, include, includeExtendedInfo, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files along with {@link Response} on successful completion of - * {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - listFilesAndDirectoriesSegmentNoCustomHeadersWithResponseAsync(String shareName, String directory, - String prefix, String sharesnapshot, String marker, Integer maxresults, Integer timeout, - List include, Boolean includeExtendedInfo, Context context) { - final String restype = "directory"; - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - return service - .listFilesAndDirectoriesSegmentNoCustomHeaders(this.client.getUrl(), shareName, directory, restype, comp, - prefix, sharesnapshot, marker, maxresults, timeout, this.client.getVersion(), includeConverted, - includeExtendedInfo, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files along with {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase - listFilesAndDirectoriesSegmentWithResponse(String shareName, String directory, String prefix, - String sharesnapshot, String marker, Integer maxresults, Integer timeout, - List include, Boolean includeExtendedInfo, Context context) { - try { - final String restype = "directory"; - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - return service.listFilesAndDirectoriesSegmentSync(this.client.getUrl(), shareName, directory, restype, comp, - prefix, sharesnapshot, marker, maxresults, timeout, this.client.getVersion(), includeConverted, - includeExtendedInfo, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ListFilesAndDirectoriesSegmentResponse listFilesAndDirectoriesSegment(String shareName, String directory, - String prefix, String sharesnapshot, String marker, Integer maxresults, Integer timeout, - List include, Boolean includeExtendedInfo) { - try { - return listFilesAndDirectoriesSegmentWithResponse(shareName, directory, prefix, sharesnapshot, marker, - maxresults, timeout, include, includeExtendedInfo, Context.NONE).getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns a list of files or directories under the specified share or directory. It lists the contents only for a - * single level of the directory hierarchy. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param includeExtendedInfo Include extended information. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of directories and files along with {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response listFilesAndDirectoriesSegmentNoCustomHeadersWithResponse( - String shareName, String directory, String prefix, String sharesnapshot, String marker, Integer maxresults, - Integer timeout, List include, Boolean includeExtendedInfo, Context context) { - try { - final String restype = "directory"; - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - return service.listFilesAndDirectoriesSegmentNoCustomHeadersSync(this.client.getUrl(), shareName, directory, - restype, comp, prefix, sharesnapshot, marker, maxresults, timeout, this.client.getVersion(), - includeConverted, includeExtendedInfo, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listHandlesWithResponseAsync( - String shareName, String directory, String marker, Integer maxresults, Integer timeout, String sharesnapshot, - Boolean recursive) { - return FluxUtil - .withContext(context -> listHandlesWithResponseAsync(shareName, directory, marker, maxresults, timeout, - sharesnapshot, recursive, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listHandlesWithResponseAsync( - String shareName, String directory, String marker, Integer maxresults, Integer timeout, String sharesnapshot, - Boolean recursive, Context context) { - final String comp = "listhandles"; - final String accept = "application/xml"; - return service - .listHandles(this.client.getUrl(), shareName, directory, comp, marker, maxresults, timeout, sharesnapshot, - recursive, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono listHandlesAsync(String shareName, String directory, String marker, - Integer maxresults, Integer timeout, String sharesnapshot, Boolean recursive) { - return listHandlesWithResponseAsync(shareName, directory, marker, maxresults, timeout, sharesnapshot, recursive) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono listHandlesAsync(String shareName, String directory, String marker, - Integer maxresults, Integer timeout, String sharesnapshot, Boolean recursive, Context context) { - return listHandlesWithResponseAsync(shareName, directory, marker, maxresults, timeout, sharesnapshot, recursive, - context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listHandlesNoCustomHeadersWithResponseAsync(String shareName, - String directory, String marker, Integer maxresults, Integer timeout, String sharesnapshot, Boolean recursive) { - return FluxUtil - .withContext(context -> listHandlesNoCustomHeadersWithResponseAsync(shareName, directory, marker, - maxresults, timeout, sharesnapshot, recursive, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listHandlesNoCustomHeadersWithResponseAsync(String shareName, - String directory, String marker, Integer maxresults, Integer timeout, String sharesnapshot, Boolean recursive, - Context context) { - final String comp = "listhandles"; - final String accept = "application/xml"; - return service - .listHandlesNoCustomHeaders(this.client.getUrl(), shareName, directory, comp, marker, maxresults, timeout, - sharesnapshot, recursive, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase listHandlesWithResponse(String shareName, - String directory, String marker, Integer maxresults, Integer timeout, String sharesnapshot, Boolean recursive, - Context context) { - try { - final String comp = "listhandles"; - final String accept = "application/xml"; - return service.listHandlesSync(this.client.getUrl(), shareName, directory, comp, marker, maxresults, - timeout, sharesnapshot, recursive, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ListHandlesResponse listHandles(String shareName, String directory, String marker, Integer maxresults, - Integer timeout, String sharesnapshot, Boolean recursive) { - try { - return listHandlesWithResponse(shareName, directory, marker, maxresults, timeout, sharesnapshot, recursive, - Context.NONE).getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Lists handles for directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response listHandlesNoCustomHeadersWithResponse(String shareName, String directory, - String marker, Integer maxresults, Integer timeout, String sharesnapshot, Boolean recursive, Context context) { - try { - final String comp = "listhandles"; - final String accept = "application/xml"; - return service.listHandlesNoCustomHeadersSync(this.client.getUrl(), shareName, directory, comp, marker, - maxresults, timeout, sharesnapshot, recursive, this.client.getVersion(), - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> forceCloseHandlesWithResponseAsync( - String shareName, String directory, String handleId, Integer timeout, String marker, String sharesnapshot, - Boolean recursive) { - return FluxUtil - .withContext(context -> forceCloseHandlesWithResponseAsync(shareName, directory, handleId, timeout, marker, - sharesnapshot, recursive, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> forceCloseHandlesWithResponseAsync( - String shareName, String directory, String handleId, Integer timeout, String marker, String sharesnapshot, - Boolean recursive, Context context) { - final String comp = "forceclosehandles"; - final String accept = "application/xml"; - return service - .forceCloseHandles(this.client.getUrl(), shareName, directory, comp, timeout, marker, sharesnapshot, - handleId, recursive, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono forceCloseHandlesAsync(String shareName, String directory, String handleId, Integer timeout, - String marker, String sharesnapshot, Boolean recursive) { - return forceCloseHandlesWithResponseAsync(shareName, directory, handleId, timeout, marker, sharesnapshot, - recursive).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono forceCloseHandlesAsync(String shareName, String directory, String handleId, Integer timeout, - String marker, String sharesnapshot, Boolean recursive, Context context) { - return forceCloseHandlesWithResponseAsync(shareName, directory, handleId, timeout, marker, sharesnapshot, - recursive, context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> forceCloseHandlesNoCustomHeadersWithResponseAsync(String shareName, String directory, - String handleId, Integer timeout, String marker, String sharesnapshot, Boolean recursive) { - return FluxUtil - .withContext(context -> forceCloseHandlesNoCustomHeadersWithResponseAsync(shareName, directory, handleId, - timeout, marker, sharesnapshot, recursive, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> forceCloseHandlesNoCustomHeadersWithResponseAsync(String shareName, String directory, - String handleId, Integer timeout, String marker, String sharesnapshot, Boolean recursive, Context context) { - final String comp = "forceclosehandles"; - final String accept = "application/xml"; - return service - .forceCloseHandlesNoCustomHeaders(this.client.getUrl(), shareName, directory, comp, timeout, marker, - sharesnapshot, handleId, recursive, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase forceCloseHandlesWithResponse(String shareName, - String directory, String handleId, Integer timeout, String marker, String sharesnapshot, Boolean recursive, - Context context) { - try { - final String comp = "forceclosehandles"; - final String accept = "application/xml"; - return service.forceCloseHandlesSync(this.client.getUrl(), shareName, directory, comp, timeout, marker, - sharesnapshot, handleId, recursive, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void forceCloseHandles(String shareName, String directory, String handleId, Integer timeout, String marker, - String sharesnapshot, Boolean recursive) { - forceCloseHandlesWithResponse(shareName, directory, handleId, timeout, marker, sharesnapshot, recursive, - Context.NONE); - } - - /** - * Closes all handles open for given directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param recursive Specifies operation should apply to the directory specified in the URI, its files, its - * subdirectories and their files. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response forceCloseHandlesNoCustomHeadersWithResponse(String shareName, String directory, - String handleId, Integer timeout, String marker, String sharesnapshot, Boolean recursive, Context context) { - try { - final String comp = "forceclosehandles"; - final String accept = "application/xml"; - return service.forceCloseHandlesNoCustomHeadersSync(this.client.getUrl(), shareName, directory, comp, - timeout, marker, sharesnapshot, handleId, recursive, this.client.getVersion(), - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renameWithResponseAsync(String shareName, - String directory, String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - Map metadata, SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo) { - return FluxUtil - .withContext(context -> renameWithResponseAsync(shareName, directory, renameSource, timeout, - replaceIfExists, ignoreReadOnly, filePermission, filePermissionFormat, filePermissionKey, metadata, - sourceLeaseAccessConditions, destinationLeaseAccessConditions, copyFileSmbInfo, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renameWithResponseAsync(String shareName, - String directory, String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - Map metadata, SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - Context context) { - final String restype = "directory"; - final String comp = "rename"; - final String accept = "application/xml"; - String sourceLeaseIdInternal = null; - if (sourceLeaseAccessConditions != null) { - sourceLeaseIdInternal = sourceLeaseAccessConditions.getSourceLeaseId(); - } - String sourceLeaseId = sourceLeaseIdInternal; - String destinationLeaseIdInternal = null; - if (destinationLeaseAccessConditions != null) { - destinationLeaseIdInternal = destinationLeaseAccessConditions.getDestinationLeaseId(); - } - String destinationLeaseId = destinationLeaseIdInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - return service - .rename(this.client.getUrl(), shareName, directory, restype, comp, timeout, this.client.getVersion(), - renameSource, replaceIfExists, ignoreReadOnly, sourceLeaseId, destinationLeaseId, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, filePermission, filePermissionFormat, - filePermissionKey, metadata, this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono renameAsync(String shareName, String directory, String renameSource, Integer timeout, - Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo) { - return renameWithResponseAsync(shareName, directory, renameSource, timeout, replaceIfExists, ignoreReadOnly, - filePermission, filePermissionFormat, filePermissionKey, metadata, sourceLeaseAccessConditions, - destinationLeaseAccessConditions, copyFileSmbInfo) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono renameAsync(String shareName, String directory, String renameSource, Integer timeout, - Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - Context context) { - return renameWithResponseAsync(shareName, directory, renameSource, timeout, replaceIfExists, ignoreReadOnly, - filePermission, filePermissionFormat, filePermissionKey, metadata, sourceLeaseAccessConditions, - destinationLeaseAccessConditions, copyFileSmbInfo, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renameNoCustomHeadersWithResponseAsync(String shareName, String directory, - String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo) { - return FluxUtil - .withContext(context -> renameNoCustomHeadersWithResponseAsync(shareName, directory, renameSource, timeout, - replaceIfExists, ignoreReadOnly, filePermission, filePermissionFormat, filePermissionKey, metadata, - sourceLeaseAccessConditions, destinationLeaseAccessConditions, copyFileSmbInfo, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renameNoCustomHeadersWithResponseAsync(String shareName, String directory, - String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - Context context) { - final String restype = "directory"; - final String comp = "rename"; - final String accept = "application/xml"; - String sourceLeaseIdInternal = null; - if (sourceLeaseAccessConditions != null) { - sourceLeaseIdInternal = sourceLeaseAccessConditions.getSourceLeaseId(); - } - String sourceLeaseId = sourceLeaseIdInternal; - String destinationLeaseIdInternal = null; - if (destinationLeaseAccessConditions != null) { - destinationLeaseIdInternal = destinationLeaseAccessConditions.getDestinationLeaseId(); - } - String destinationLeaseId = destinationLeaseIdInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - return service - .renameNoCustomHeaders(this.client.getUrl(), shareName, directory, restype, comp, timeout, - this.client.getVersion(), renameSource, replaceIfExists, ignoreReadOnly, sourceLeaseId, - destinationLeaseId, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, filePermission, - filePermissionFormat, filePermissionKey, metadata, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase renameWithResponse(String shareName, String directory, - String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - Context context) { + private List getValues(BinaryData binaryData, String path) { try { - final String restype = "directory"; - final String comp = "rename"; - final String accept = "application/xml"; - String sourceLeaseIdInternal = null; - if (sourceLeaseAccessConditions != null) { - sourceLeaseIdInternal = sourceLeaseAccessConditions.getSourceLeaseId(); + try { + Map obj = binaryData.toObject(Map.class); + List values = (List) obj.get(path); + return values.stream().map(BinaryData::fromObject).collect(Collectors.toList()); + } catch (RuntimeException e) { + return null; } - String sourceLeaseId = sourceLeaseIdInternal; - String destinationLeaseIdInternal = null; - if (destinationLeaseAccessConditions != null) { - destinationLeaseIdInternal = destinationLeaseAccessConditions.getDestinationLeaseId(); - } - String destinationLeaseId = destinationLeaseIdInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - return service.renameSync(this.client.getUrl(), shareName, directory, restype, comp, timeout, - this.client.getVersion(), renameSource, replaceIfExists, ignoreReadOnly, sourceLeaseId, - destinationLeaseId, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, filePermission, - filePermissionFormat, filePermissionKey, metadata, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void rename(String shareName, String directory, String renameSource, Integer timeout, - Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo) { - renameWithResponse(shareName, directory, renameSource, timeout, replaceIfExists, ignoreReadOnly, filePermission, - filePermissionFormat, filePermissionKey, metadata, sourceLeaseAccessConditions, - destinationLeaseAccessConditions, copyFileSmbInfo, Context.NONE); - } - - /** - * Renames a directory. - * - * @param shareName The name of the target share. - * @param directory The path of the target directory. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response renameNoCustomHeadersWithResponse(String shareName, String directory, String renameSource, - Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - Context context) { + private String getNextLink(BinaryData binaryData, String path) { try { - final String restype = "directory"; - final String comp = "rename"; - final String accept = "application/xml"; - String sourceLeaseIdInternal = null; - if (sourceLeaseAccessConditions != null) { - sourceLeaseIdInternal = sourceLeaseAccessConditions.getSourceLeaseId(); - } - String sourceLeaseId = sourceLeaseIdInternal; - String destinationLeaseIdInternal = null; - if (destinationLeaseAccessConditions != null) { - destinationLeaseIdInternal = destinationLeaseAccessConditions.getDestinationLeaseId(); - } - String destinationLeaseId = destinationLeaseIdInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); + try { + Map obj = binaryData.toObject(Map.class); + return (String) obj.get(path); + } catch (RuntimeException e) { + return null; } - String fileChangeTime = fileChangeTimeInternal; - return service.renameNoCustomHeadersSync(this.client.getUrl(), shareName, directory, restype, comp, timeout, - this.client.getVersion(), renameSource, replaceIfExists, ignoreReadOnly, sourceLeaseId, - destinationLeaseId, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, filePermission, - filePermissionFormat, filePermissionKey, metadata, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java index e47e219591fd..2528415bdc9e 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java @@ -1,9 +1,8 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation; -import com.azure.core.annotation.BodyParam; import com.azure.core.annotation.Delete; import com.azure.core.annotation.ExpectedResponses; import com.azure.core.annotation.Get; @@ -11,64 +10,34 @@ import com.azure.core.annotation.HeaderParam; import com.azure.core.annotation.Host; import com.azure.core.annotation.HostParam; -import com.azure.core.annotation.PathParam; import com.azure.core.annotation.Put; import com.azure.core.annotation.QueryParam; import com.azure.core.annotation.ReturnType; import com.azure.core.annotation.ServiceInterface; import com.azure.core.annotation.ServiceMethod; import com.azure.core.annotation.UnexpectedResponseExceptionType; +import com.azure.core.exception.ClientAuthenticationException; +import com.azure.core.exception.HttpResponseException; +import com.azure.core.exception.ResourceModifiedException; +import com.azure.core.exception.ResourceNotFoundException; +import com.azure.core.http.HttpHeaderName; +import com.azure.core.http.rest.PagedFlux; +import com.azure.core.http.rest.PagedIterable; +import com.azure.core.http.rest.PagedResponse; +import com.azure.core.http.rest.PagedResponseBase; +import com.azure.core.http.rest.RequestOptions; import com.azure.core.http.rest.Response; -import com.azure.core.http.rest.ResponseBase; import com.azure.core.http.rest.RestProxy; -import com.azure.core.http.rest.StreamResponse; -import com.azure.core.util.Base64Util; import com.azure.core.util.BinaryData; import com.azure.core.util.Context; import com.azure.core.util.FluxUtil; -import com.azure.storage.file.share.implementation.models.CopyFileSmbInfo; -import com.azure.storage.file.share.implementation.models.DestinationLeaseAccessConditions; -import com.azure.storage.file.share.implementation.models.FilesAbortCopyHeaders; -import com.azure.storage.file.share.implementation.models.FilesAcquireLeaseHeaders; -import com.azure.storage.file.share.implementation.models.FilesBreakLeaseHeaders; -import com.azure.storage.file.share.implementation.models.FilesChangeLeaseHeaders; -import com.azure.storage.file.share.implementation.models.FilesCreateHardLinkHeaders; -import com.azure.storage.file.share.implementation.models.FilesCreateHeaders; -import com.azure.storage.file.share.implementation.models.FilesCreateSymbolicLinkHeaders; -import com.azure.storage.file.share.implementation.models.FilesDeleteHeaders; -import com.azure.storage.file.share.implementation.models.FilesDownloadHeaders; -import com.azure.storage.file.share.implementation.models.FilesForceCloseHandlesHeaders; -import com.azure.storage.file.share.implementation.models.FilesGetPropertiesHeaders; -import com.azure.storage.file.share.implementation.models.FilesGetRangeListHeaders; -import com.azure.storage.file.share.implementation.models.FilesGetSymbolicLinkHeaders; -import com.azure.storage.file.share.implementation.models.FilesListHandlesHeaders; -import com.azure.storage.file.share.implementation.models.FilesReleaseLeaseHeaders; -import com.azure.storage.file.share.implementation.models.FilesRenameHeaders; -import com.azure.storage.file.share.implementation.models.FilesSetHttpHeadersHeaders; -import com.azure.storage.file.share.implementation.models.FilesSetMetadataHeaders; -import com.azure.storage.file.share.implementation.models.FilesStartCopyHeaders; -import com.azure.storage.file.share.implementation.models.FilesUploadRangeFromURLHeaders; -import com.azure.storage.file.share.implementation.models.FilesUploadRangeHeaders; -import com.azure.storage.file.share.implementation.models.ListHandlesResponse; -import com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType; +import com.azure.storage.file.share.ShareServiceVersion; import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal; -import com.azure.storage.file.share.implementation.models.SourceLeaseAccessConditions; import com.azure.storage.file.share.implementation.util.ModelHelper; -import com.azure.storage.file.share.models.FileLastWrittenMode; -import com.azure.storage.file.share.models.FilePermissionFormat; -import com.azure.storage.file.share.models.FilePropertySemantics; -import com.azure.storage.file.share.models.ModeCopyMode; -import com.azure.storage.file.share.models.NfsFileType; -import com.azure.storage.file.share.models.OwnerCopyMode; -import com.azure.storage.file.share.models.PermissionCopyModeType; -import com.azure.storage.file.share.models.ShareFileHttpHeaders; -import com.azure.storage.file.share.models.ShareFileRangeList; import com.azure.storage.file.share.models.ShareTokenIntent; -import com.azure.storage.file.share.models.SourceModifiedAccessConditions; -import java.io.InputStream; -import java.nio.ByteBuffer; +import java.util.List; import java.util.Map; -import reactor.core.publisher.Flux; +import java.util.stream.Collectors; import reactor.core.publisher.Mono; /** @@ -96,6 +65,19 @@ public final class FilesImpl { this.client = client; } + /** + * Gets Service version. + * + * @return the serviceVersion value. + */ + public ShareServiceVersion getServiceVersion() { + try { + return client.getServiceVersion(); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + /** * The interface defining all the services for AzureFileStorageFiles to be used by the proxy service to perform REST * calls. @@ -104,2653 +86,713 @@ public final class FilesImpl { @ServiceInterface(name = "AzureFileStorageFiles") public interface FilesService { - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> create(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") long fileContentLength, - @HeaderParam("x-ms-type") String fileTypeConstant, @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("x-ms-file-file-type") NfsFileType nfsFileType, - @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Content-Length") Long contentLength, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") Flux optionalbody, @HeaderParam("Accept") String accept, - Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") long fileContentLength, - @HeaderParam("x-ms-type") String fileTypeConstant, @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("x-ms-file-file-type") NfsFileType nfsFileType, - @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Content-Length") Long contentLength, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") Flux optionalbody, @HeaderParam("Accept") String accept, - Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> create(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") long fileContentLength, - @HeaderParam("x-ms-type") String fileTypeConstant, @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("x-ms-file-file-type") NfsFileType nfsFileType, - @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Content-Length") Long contentLength, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") BinaryData optionalbody, @HeaderParam("Accept") String accept, - Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") long fileContentLength, - @HeaderParam("x-ms-type") String fileTypeConstant, @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("x-ms-file-file-type") NfsFileType nfsFileType, - @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Content-Length") Long contentLength, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") BinaryData optionalbody, @HeaderParam("Accept") String accept, - Context context); - - @Put("/{shareName}/{fileName}") + @Put("/") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase createSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") long fileContentLength, - @HeaderParam("x-ms-type") String fileTypeConstant, @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("x-ms-file-file-type") NfsFileType nfsFileType, - @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Content-Length") Long contentLength, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") BinaryData optionalbody, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> create(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-content-length") long fileContentLength, @HeaderParam("x-ms-type") String fileType, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") + @Put("/") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response createNoCustomHeadersSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("fileName") String fileName, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-content-length") long fileContentLength, - @HeaderParam("x-ms-type") String fileTypeConstant, @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("x-ms-file-file-type") NfsFileType nfsFileType, - @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-file-property-semantics") FilePropertySemantics filePropertySemantics, - @HeaderParam("Content-Length") Long contentLength, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") BinaryData optionalbody, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response createSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-content-length") long fileContentLength, @HeaderParam("x-ms-type") String fileType, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200, 206 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono>> download(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-range") String range, - @HeaderParam("x-ms-range-get-content-md5") Boolean rangeGetContentMD5, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") + @Get("/") @ExpectedResponses({ 200, 206 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono downloadNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-range") String range, - @HeaderParam("x-ms-range-get-content-md5") Boolean rangeGetContentMD5, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200, 206 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase downloadSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-range") String range, - @HeaderParam("x-ms-range-get-content-md5") Boolean rangeGetContentMD5, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200, 206 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response downloadNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-range") String range, - @HeaderParam("x-ms-range-get-content-md5") Boolean rangeGetContentMD5, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Head("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getProperties(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> download(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Head("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getPropertiesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, + @Get("/") + @ExpectedResponses({ 200, 206 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response downloadSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Head("/{shareName}/{fileName}") + @Head("/") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getPropertiesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getProperties(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Head("/{shareName}/{fileName}") + @Head("/") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getPropertiesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getPropertiesSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Delete("/{shareName}/{fileName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> delete(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Delete("/{shareName}/{fileName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> deleteNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Delete("/{shareName}/{fileName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase deleteSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Delete("/{shareName}/{fileName}") + @Delete("/") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response deleteNoCustomHeadersSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("fileName") String fileName, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setHttpHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") Long fileContentLength, - @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setHttpHeadersNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") Long fileContentLength, - @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> delete(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase setHttpHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") Long fileContentLength, - @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, + @Delete("/") + @ExpectedResponses({ 202 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response deleteSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=properties") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response setHttpHeadersNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-content-length") Long fileContentLength, - @HeaderParam("x-ms-content-type") String contentType, - @HeaderParam("x-ms-content-encoding") String contentEncoding, - @HeaderParam("x-ms-content-language") String contentLanguage, - @HeaderParam("x-ms-cache-control") String cacheControl, @HeaderParam("x-ms-content-md5") String contentMd5, - @HeaderParam("x-ms-content-disposition") String contentDisposition, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> uploadRange(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-write") ShareFileRangeWriteType fileRangeWrite, - @HeaderParam("Content-Length") long contentLength, @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> setHttpHeaders(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") Flux optionalbody, @HeaderParam("Accept") String accept, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> uploadRangeNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-write") ShareFileRangeWriteType fileRangeWrite, - @HeaderParam("Content-Length") long contentLength, @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, + @Put("?comp=properties") + @ExpectedResponses({ 200 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response setHttpHeadersSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") Flux optionalbody, @HeaderParam("Accept") String accept, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> uploadRange(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-write") ShareFileRangeWriteType fileRangeWrite, - @HeaderParam("Content-Length") long contentLength, @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, + @Put("?comp=metadata") + @ExpectedResponses({ 200 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> setMetadata(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") BinaryData optionalbody, @HeaderParam("Accept") String accept, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> uploadRangeNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-write") ShareFileRangeWriteType fileRangeWrite, - @HeaderParam("Content-Length") long contentLength, @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, + @Put("?comp=metadata") + @ExpectedResponses({ 200 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response setMetadataSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") BinaryData optionalbody, @HeaderParam("Accept") String accept, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=lease") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase uploadRangeSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-write") ShareFileRangeWriteType fileRangeWrite, - @HeaderParam("Content-Length") long contentLength, @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") BinaryData optionalbody, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> acquireLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=lease") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response uploadRangeNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-write") ShareFileRangeWriteType fileRangeWrite, - @HeaderParam("Content-Length") long contentLength, @HeaderParam("Content-MD5") String contentMD5, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-structured-body") String structuredBodyType, - @HeaderParam("x-ms-structured-content-length") Long structuredContentLength, - @BodyParam("application/octet-stream") BinaryData optionalbody, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response acquireLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setMetadata(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setMetadataNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase setMetadataSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response setMetadataNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> acquireLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-duration") Integer duration, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> acquireLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-duration") Integer duration, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase acquireLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-duration") Integer duration, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response acquireLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-duration") Integer duration, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> releaseLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> releaseLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase releaseLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response releaseLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") + @Put("?comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> changeLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> releaseLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> changeLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response releaseLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase changeLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> changeLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response changeLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> breakLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> breakLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response changeLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=lease") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase breakLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> breakLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=lease") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response breakLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @HeaderParam("x-ms-lease-action") String action, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response breakLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=range") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> uploadRangeFromURL(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-copy-source") String copySource, - @HeaderParam("x-ms-source-range") String sourceRange, - @HeaderParam("x-ms-write") String fileRangeWriteFromUrl, @HeaderParam("Content-Length") long contentLength, - @HeaderParam("x-ms-source-content-crc64") String sourceContentCrc64, - @HeaderParam("x-ms-source-if-match-crc64") String sourceIfMatchCrc64, - @HeaderParam("x-ms-source-if-none-match-crc64") String sourceIfNoneMatchCrc64, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-copy-source-authorization") String copySourceAuthorization, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> uploadRange(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("Range") String range, @HeaderParam("x-ms-write") String fileRangeWrite, + @HeaderParam("Content-Length") long contentLength, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=range") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> uploadRangeFromURLNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-copy-source") String copySource, - @HeaderParam("x-ms-source-range") String sourceRange, - @HeaderParam("x-ms-write") String fileRangeWriteFromUrl, @HeaderParam("Content-Length") long contentLength, - @HeaderParam("x-ms-source-content-crc64") String sourceContentCrc64, - @HeaderParam("x-ms-source-if-match-crc64") String sourceIfMatchCrc64, - @HeaderParam("x-ms-source-if-none-match-crc64") String sourceIfNoneMatchCrc64, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-copy-source-authorization") String copySourceAuthorization, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response uploadRangeSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("Range") String range, @HeaderParam("x-ms-write") String fileRangeWrite, + @HeaderParam("Content-Length") long contentLength, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=range") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase uploadRangeFromURLSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-copy-source") String copySource, - @HeaderParam("x-ms-source-range") String sourceRange, - @HeaderParam("x-ms-write") String fileRangeWriteFromUrl, @HeaderParam("Content-Length") long contentLength, - @HeaderParam("x-ms-source-content-crc64") String sourceContentCrc64, - @HeaderParam("x-ms-source-if-match-crc64") String sourceIfMatchCrc64, - @HeaderParam("x-ms-source-if-none-match-crc64") String sourceIfNoneMatchCrc64, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-copy-source-authorization") String copySourceAuthorization, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> uploadRangeFromUrl(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("Range") String range, + @HeaderParam("x-ms-copy-source") String copySource, @HeaderParam("x-ms-write") String fileRangeWriteFromUrl, + @HeaderParam("Content-Length") long contentLength, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=range") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response uploadRangeFromURLNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-range") String range, @HeaderParam("x-ms-copy-source") String copySource, - @HeaderParam("x-ms-source-range") String sourceRange, - @HeaderParam("x-ms-write") String fileRangeWriteFromUrl, @HeaderParam("Content-Length") long contentLength, - @HeaderParam("x-ms-source-content-crc64") String sourceContentCrc64, - @HeaderParam("x-ms-source-if-match-crc64") String sourceIfMatchCrc64, - @HeaderParam("x-ms-source-if-none-match-crc64") String sourceIfNoneMatchCrc64, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-copy-source-authorization") String copySourceAuthorization, - @HeaderParam("x-ms-file-last-write-time") FileLastWrittenMode fileLastWrittenMode, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response uploadRangeFromUrlSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("Range") String range, + @HeaderParam("x-ms-copy-source") String copySource, @HeaderParam("x-ms-write") String fileRangeWriteFromUrl, + @HeaderParam("Content-Length") long contentLength, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getRangeList(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("sharesnapshot") String sharesnapshot, - @QueryParam("prevsharesnapshot") String prevsharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-range") String range, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-file-support-rename") Boolean supportRename, @HeaderParam("Accept") String accept, - Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getRangeListNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("sharesnapshot") String sharesnapshot, - @QueryParam("prevsharesnapshot") String prevsharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-range") String range, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-file-support-rename") Boolean supportRename, @HeaderParam("Accept") String accept, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Get("/{shareName}/{fileName}") + @Get("?comp=rangelist") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getRangeListSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("sharesnapshot") String sharesnapshot, - @QueryParam("prevsharesnapshot") String prevsharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-range") String range, - @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getRangeList(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-file-support-rename") Boolean supportRename, @HeaderParam("Accept") String accept, - Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Get("/{shareName}/{fileName}") + @Get("?comp=rangelist") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getRangeListNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("sharesnapshot") String sharesnapshot, - @QueryParam("prevsharesnapshot") String prevsharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-range") String range, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-file-support-rename") Boolean supportRename, @HeaderParam("Accept") String accept, - Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> startCopy(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-copy-source") String copySource, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-permission-copy-mode") PermissionCopyModeType filePermissionCopyMode, - @HeaderParam("x-ms-file-copy-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-copy-set-archive") Boolean setArchiveAttribute, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, - @HeaderParam("x-ms-file-mode-copy-mode") ModeCopyMode fileModeCopyMode, - @HeaderParam("x-ms-file-owner-copy-mode") OwnerCopyMode fileOwnerCopyMode, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> startCopyNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-copy-source") String copySource, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-permission-copy-mode") PermissionCopyModeType filePermissionCopyMode, - @HeaderParam("x-ms-file-copy-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-copy-set-archive") Boolean setArchiveAttribute, - @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getRangeListSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, - @HeaderParam("x-ms-file-mode-copy-mode") ModeCopyMode fileModeCopyMode, - @HeaderParam("x-ms-file-owner-copy-mode") OwnerCopyMode fileOwnerCopyMode, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") + @Put("/") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase startCopySync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-copy-source") String copySource, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-permission-copy-mode") PermissionCopyModeType filePermissionCopyMode, - @HeaderParam("x-ms-file-copy-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-copy-set-archive") Boolean setArchiveAttribute, - @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> startCopy(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-copy-source") String copySource, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, - @HeaderParam("x-ms-file-mode-copy-mode") ModeCopyMode fileModeCopyMode, - @HeaderParam("x-ms-file-owner-copy-mode") OwnerCopyMode fileOwnerCopyMode, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("/") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response startCopyNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-copy-source") String copySource, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-permission-copy-mode") PermissionCopyModeType filePermissionCopyMode, - @HeaderParam("x-ms-file-copy-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-copy-set-archive") Boolean setArchiveAttribute, - @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response startCopySync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-copy-source") String copySource, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-mode") String fileMode, - @HeaderParam("x-ms-file-mode-copy-mode") ModeCopyMode fileModeCopyMode, - @HeaderParam("x-ms-file-owner-copy-mode") OwnerCopyMode fileOwnerCopyMode, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 204 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> abortCopy(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("copyid") String copyId, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-copy-action") String copyActionAbortConstant, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 204 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> abortCopyNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("copyid") String copyId, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-copy-action") String copyActionAbortConstant, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=copy") @ExpectedResponses({ 204 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase abortCopySync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("copyid") String copyId, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-copy-action") String copyActionAbortConstant, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> abortCopy(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-copy-action") String copyActionAbortConstant, @QueryParam("copyid") String copyid, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=copy") @ExpectedResponses({ 204 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response abortCopyNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("copyid") String copyId, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-copy-action") String copyActionAbortConstant, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listHandles(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listHandlesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase listHandlesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response listHandlesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> forceCloseHandles(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @QueryParam("marker") String marker, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> forceCloseHandlesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @QueryParam("marker") String marker, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response abortCopySync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-copy-action") String copyActionAbortConstant, @QueryParam("copyid") String copyid, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Get("?comp=listhandles") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase forceCloseHandlesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @QueryParam("marker") String marker, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> listHandles(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") + @Get("?comp=listhandles") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response forceCloseHandlesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @QueryParam("marker") String marker, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response listHandlesSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=forceclosehandles") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> rename(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-file-rename-source") String renameSource, - @HeaderParam("x-ms-file-rename-replace-if-exists") Boolean replaceIfExists, - @HeaderParam("x-ms-file-rename-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-source-lease-id") String sourceLeaseId, - @HeaderParam("x-ms-destination-lease-id") String destinationLeaseId, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-content-type") String contentType, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> forceCloseHandles(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=forceclosehandles") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> renameNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-file-rename-source") String renameSource, - @HeaderParam("x-ms-file-rename-replace-if-exists") Boolean replaceIfExists, - @HeaderParam("x-ms-file-rename-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-source-lease-id") String sourceLeaseId, - @HeaderParam("x-ms-destination-lease-id") String destinationLeaseId, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-content-type") String contentType, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response forceCloseHandlesSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-handle-id") String handleId, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, - @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=rename") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase renameSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-file-rename-source") String renameSource, - @HeaderParam("x-ms-file-rename-replace-if-exists") Boolean replaceIfExists, - @HeaderParam("x-ms-file-rename-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-source-lease-id") String sourceLeaseId, - @HeaderParam("x-ms-destination-lease-id") String destinationLeaseId, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-content-type") String contentType, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> rename(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-rename-source") String renameSource, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?comp=rename") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response renameNoCustomHeadersSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @PathParam("fileName") String fileName, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response renameSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-rename-source") String renameSource, - @HeaderParam("x-ms-file-rename-replace-if-exists") Boolean replaceIfExists, - @HeaderParam("x-ms-file-rename-ignore-readonly") Boolean ignoreReadOnly, - @HeaderParam("x-ms-source-lease-id") String sourceLeaseId, - @HeaderParam("x-ms-destination-lease-id") String destinationLeaseId, - @HeaderParam("x-ms-file-attributes") String fileAttributes, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-file-change-time") String fileChangeTime, - @HeaderParam("x-ms-file-permission") String filePermission, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-content-type") String contentType, @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, @HeaderParam("x-ms-source-allow-trailing-dot") Boolean allowSourceTrailingDot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createSymbolicLink(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-client-request-id") String requestId, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-link-text") String linkText, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createSymbolicLinkNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-client-request-id") String requestId, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-link-text") String linkText, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?restype=symboliclink") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase createSymbolicLinkSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-client-request-id") String requestId, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-link-text") String linkText, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> createSymbolicLink(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-link-text") String linkText, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?restype=symboliclink") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response createSymbolicLinkNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-file-creation-time") String fileCreationTime, - @HeaderParam("x-ms-file-last-write-time") String fileLastWriteTime, - @HeaderParam("x-ms-client-request-id") String requestId, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-owner") String owner, @HeaderParam("x-ms-group") String group, - @HeaderParam("x-ms-link-text") String linkText, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response createSymbolicLinkSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-link-text") String linkText, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{fileName}") + @Get("?restype=symboliclink") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getSymbolicLink(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getSymbolicLink(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{fileName}") + @Get("?restype=symboliclink") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getSymbolicLinkNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getSymbolicLinkSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getSymbolicLinkSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}/{fileName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getSymbolicLinkNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createHardLink(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-type") String fileTypeConstant, - @HeaderParam("x-ms-client-request-id") String requestId, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-target-file") String targetFile, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createHardLinkNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-type") String fileTypeConstant, - @HeaderParam("x-ms-client-request-id") String requestId, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-target-file") String targetFile, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}/{fileName}") + @Put("?restype=hardlink") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase createHardLinkSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-type") String fileTypeConstant, - @HeaderParam("x-ms-client-request-id") String requestId, @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> createHardLink(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-type") String fileType, @HeaderParam("x-ms-file-target-file") String targetFile, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}/{fileName}") + @Put("?restype=hardlink") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response createHardLinkNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @PathParam("fileName") String fileName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-type") String fileTypeConstant, - @HeaderParam("x-ms-client-request-id") String requestId, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-target-file") String targetFile, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createWithResponseAsync(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, Flux optionalbody, ShareFileHttpHeaders shareFileHttpHeaders) { - return FluxUtil - .withContext(context -> createWithResponseAsync(shareName, fileName, fileContentLength, timeout, metadata, - filePermission, filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, - fileLastWriteTime, fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, contentMD5, - filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, optionalbody, - shareFileHttpHeaders, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createWithResponseAsync(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, Flux optionalbody, ShareFileHttpHeaders shareFileHttpHeaders, - Context context) { - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service - .create(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), timeout, - this.client.getVersion(), fileContentLength, fileTypeConstant, contentType, contentEncoding, - contentLanguage, cacheControl, contentMd5Converted, contentDisposition, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, this.client.getFileRequestIntent(), owner, group, fileMode, nfsFileType, - contentMD5Converted, filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, - optionalbody, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createAsync(String shareName, String fileName, long fileContentLength, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, NfsFileType nfsFileType, - byte[] contentMD5, FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, Flux optionalbody, ShareFileHttpHeaders shareFileHttpHeaders) { - return createWithResponseAsync(shareName, fileName, fileContentLength, timeout, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, contentMD5, filePropertySemantics, - contentLength, structuredBodyType, structuredContentLength, optionalbody, shareFileHttpHeaders) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createAsync(String shareName, String fileName, long fileContentLength, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, NfsFileType nfsFileType, - byte[] contentMD5, FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, Flux optionalbody, ShareFileHttpHeaders shareFileHttpHeaders, - Context context) { - return createWithResponseAsync(shareName, fileName, fileContentLength, timeout, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, contentMD5, filePropertySemantics, - contentLength, structuredBodyType, structuredContentLength, optionalbody, shareFileHttpHeaders, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createNoCustomHeadersWithResponseAsync(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, Flux optionalbody, ShareFileHttpHeaders shareFileHttpHeaders) { - return FluxUtil - .withContext(context -> createNoCustomHeadersWithResponseAsync(shareName, fileName, fileContentLength, - timeout, metadata, filePermission, filePermissionFormat, filePermissionKey, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, - contentMD5, filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, - optionalbody, shareFileHttpHeaders, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createNoCustomHeadersWithResponseAsync(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, Flux optionalbody, ShareFileHttpHeaders shareFileHttpHeaders, - Context context) { - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service - .createNoCustomHeaders(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), timeout, - this.client.getVersion(), fileContentLength, fileTypeConstant, contentType, contentEncoding, - contentLanguage, cacheControl, contentMd5Converted, contentDisposition, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, this.client.getFileRequestIntent(), owner, group, fileMode, nfsFileType, - contentMD5Converted, filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, - optionalbody, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createWithResponseAsync(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders) { - return FluxUtil - .withContext(context -> createWithResponseAsync(shareName, fileName, fileContentLength, timeout, metadata, - filePermission, filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, - fileLastWriteTime, fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, contentMD5, - filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, optionalbody, - shareFileHttpHeaders, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createWithResponseAsync(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders, - Context context) { - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service - .create(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), timeout, - this.client.getVersion(), fileContentLength, fileTypeConstant, contentType, contentEncoding, - contentLanguage, cacheControl, contentMd5Converted, contentDisposition, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, this.client.getFileRequestIntent(), owner, group, fileMode, nfsFileType, - contentMD5Converted, filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, - optionalbody, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createAsync(String shareName, String fileName, long fileContentLength, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, NfsFileType nfsFileType, - byte[] contentMD5, FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders) { - return createWithResponseAsync(shareName, fileName, fileContentLength, timeout, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, contentMD5, filePropertySemantics, - contentLength, structuredBodyType, structuredContentLength, optionalbody, shareFileHttpHeaders) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createAsync(String shareName, String fileName, long fileContentLength, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, NfsFileType nfsFileType, - byte[] contentMD5, FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders, - Context context) { - return createWithResponseAsync(shareName, fileName, fileContentLength, timeout, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, contentMD5, filePropertySemantics, - contentLength, structuredBodyType, structuredContentLength, optionalbody, shareFileHttpHeaders, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createNoCustomHeadersWithResponseAsync(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders) { - return FluxUtil - .withContext(context -> createNoCustomHeadersWithResponseAsync(shareName, fileName, fileContentLength, - timeout, metadata, filePermission, filePermissionFormat, filePermissionKey, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, - contentMD5, filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, - optionalbody, shareFileHttpHeaders, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response createHardLinkSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-type") String fileType, @HeaderParam("x-ms-file-target-file") String targetFile, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); } /** - * Creates a new file or replaces a file. Can also initialize the file with content. + * Creates a new file or replaces a file. Note it only initializes the file with no content. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
Content-TypeStringNoThe content type. Allowed values: + * "application/octet-stream".
x-ms-content-typeStringNoSets the MIME content type of the file. The default + * type is 'application/octet-stream'.
x-ms-content-encodingStringNoSpecifies which content encodings have been + * applied to the file.
x-ms-content-languageStringNoSpecifies the natural languages used by this + * resource.
x-ms-cache-controlStringNoSets the file's cache control. The File service + * stores this value but does not use or modify it.
x-ms-content-md5byte[]NoAn MD5 hash of the file content. This hash is used to + * verify the integrity of the file during transport.
x-ms-content-dispositionStringNoSets the file's Content-Disposition + * header.
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-file-permissionStringNoIf specified the permission (security descriptor) + * shall be set for the directory/file. This header can be used if Permission size is <= 8KB, else + * x-ms-file-permission-key header shall be used. Default value: Inherit. If SDDL is specified as input, it must + * have owner, group and dacl. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-permission-keyStringNoKey of the permission to be set for the + * directory/file. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set. Default value: 'Archive' for file and 'Directory' for directory. 'None' can also be specified as + * default.
x-ms-file-creation-timeStringNoCreation time for the file/directory. Default + * value: Now.
x-ms-file-last-write-timeStringNoLast write time for the file/directory. + * Default value: Now.
x-ms-file-change-timeStringNoChange time for the file/directory. Default + * value: Now.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
x-ms-file-file-typeStringNoOptional, NFS only. Type of the file or directory. + * Allowed values: "Regular", "Directory", "SymLink".
Content-MD5byte[]NoAn MD5 hash of the content. This hash is used to verify the + * integrity of the data during transport.
x-ms-file-property-semanticsStringNoSMB only. Default value is New. Allowed + * values: "New", "Restore".
Content-LengthLongNoSpecifies the number of bytes being transmitted in the + * request body. When the x-ms-write header is set to clear, the value of this header must be set to + * zero."
x-ms-structured-bodyStringNoSpecifies the response content should be returned + * as a structured message and specifies the message schema version and properties.
x-ms-structured-content-lengthLongNoRequired if the request body is a + * structured message. Specifies the length of the blob/file content inside the message body. Will always be smaller + * than Content-Length.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Request Body Schema

+ * + * 
+     * {@code
+     * BinaryData
+     * }
+     *
* - * @param shareName The name of the target share. - * @param fileName The path of the target file. * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createNoCustomHeadersWithResponseAsync(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders, - Context context) { - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service - .createNoCustomHeaders(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), timeout, - this.client.getVersion(), fileContentLength, fileTypeConstant, contentType, contentEncoding, - contentLanguage, cacheControl, contentMd5Converted, contentDisposition, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, this.client.getFileRequestIntent(), owner, group, fileMode, nfsFileType, - contentMD5Converted, filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, - optionalbody, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase createWithResponse(String shareName, String fileName, - long fileContentLength, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, NfsFileType nfsFileType, byte[] contentMD5, - FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders, - Context context) { - try { - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); + public Mono> createWithResponseAsync(long fileContentLength, RequestOptions requestOptions) { + final String fileType = "file"; + RequestOptions requestOptionsLocal = requestOptions == null ? new RequestOptions() : requestOptions; + requestOptionsLocal.addRequestCallback(requestLocal -> { + if (requestLocal.getBody() != null && requestLocal.getHeaders().get(HttpHeaderName.CONTENT_TYPE) == null) { + requestLocal.getHeaders().set(HttpHeaderName.CONTENT_TYPE, "application/octet-stream"); } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service.createSync(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), - timeout, this.client.getVersion(), fileContentLength, fileTypeConstant, contentType, contentEncoding, - contentLanguage, cacheControl, contentMd5Converted, contentDisposition, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, this.client.getFileRequestIntent(), owner, group, fileMode, nfsFileType, - contentMD5Converted, filePropertySemantics, contentLength, structuredBodyType, structuredContentLength, - optionalbody, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void create(String shareName, String fileName, long fileContentLength, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, NfsFileType nfsFileType, - byte[] contentMD5, FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders) { - createWithResponse(shareName, fileName, fileContentLength, timeout, metadata, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, owner, group, fileMode, nfsFileType, contentMD5, filePropertySemantics, - contentLength, structuredBodyType, structuredContentLength, optionalbody, shareFileHttpHeaders, - Context.NONE); - } - - /** - * Creates a new file or replaces a file. Can also initialize the file with content. + }); + return FluxUtil + .withContext(context -> service.create(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + fileContentLength, fileType, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), + requestOptionsLocal, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Creates a new file or replaces a file. Note it only initializes the file with no content. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
Content-TypeStringNoThe content type. Allowed values: + * "application/octet-stream".
x-ms-content-typeStringNoSets the MIME content type of the file. The default + * type is 'application/octet-stream'.
x-ms-content-encodingStringNoSpecifies which content encodings have been + * applied to the file.
x-ms-content-languageStringNoSpecifies the natural languages used by this + * resource.
x-ms-cache-controlStringNoSets the file's cache control. The File service + * stores this value but does not use or modify it.
x-ms-content-md5byte[]NoAn MD5 hash of the file content. This hash is used to + * verify the integrity of the file during transport.
x-ms-content-dispositionStringNoSets the file's Content-Disposition + * header.
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-file-permissionStringNoIf specified the permission (security descriptor) + * shall be set for the directory/file. This header can be used if Permission size is <= 8KB, else + * x-ms-file-permission-key header shall be used. Default value: Inherit. If SDDL is specified as input, it must + * have owner, group and dacl. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-permission-keyStringNoKey of the permission to be set for the + * directory/file. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set. Default value: 'Archive' for file and 'Directory' for directory. 'None' can also be specified as + * default.
x-ms-file-creation-timeStringNoCreation time for the file/directory. Default + * value: Now.
x-ms-file-last-write-timeStringNoLast write time for the file/directory. + * Default value: Now.
x-ms-file-change-timeStringNoChange time for the file/directory. Default + * value: Now.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
x-ms-file-file-typeStringNoOptional, NFS only. Type of the file or directory. + * Allowed values: "Regular", "Directory", "SymLink".
Content-MD5byte[]NoAn MD5 hash of the content. This hash is used to verify the + * integrity of the data during transport.
x-ms-file-property-semanticsStringNoSMB only. Default value is New. Allowed + * values: "New", "Restore".
Content-LengthLongNoSpecifies the number of bytes being transmitted in the + * request body. When the x-ms-write header is set to clear, the value of this header must be set to + * zero."
x-ms-structured-bodyStringNoSpecifies the response content should be returned + * as a structured message and specifies the message schema version and properties.
x-ms-structured-content-lengthLongNoRequired if the request body is a + * structured message. Specifies the length of the blob/file content inside the message body. Will always be smaller + * than Content-Length.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Request Body Schema

+ * + * 
+     * {@code
+     * BinaryData
+     * }
+     *
* - * @param shareName The name of the target share. - * @param fileName The path of the target file. * @param fileContentLength Specifies the maximum size for the file, up to 4 TB. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param nfsFileType Optional, NFS only. Type of the file or directory. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param filePropertySemantics SMB only, default value is New. New will forcefully add the ARCHIVE attribute flag - * and alter the permissions specified in x-ms-file-permission to inherit missing permissions from the parent. - * Restore will apply changes without further modification. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response createNoCustomHeadersWithResponse(String shareName, String fileName, long fileContentLength, - Integer timeout, Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, NfsFileType nfsFileType, - byte[] contentMD5, FilePropertySemantics filePropertySemantics, Long contentLength, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, ShareFileHttpHeaders shareFileHttpHeaders, - Context context) { + public Response createWithResponse(long fileContentLength, RequestOptions requestOptions) { try { - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service.createNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, - this.client.isAllowTrailingDot(), timeout, this.client.getVersion(), fileContentLength, - fileTypeConstant, contentType, contentEncoding, contentLanguage, cacheControl, contentMd5Converted, - contentDisposition, metadata, filePermission, filePermissionFormat, filePermissionKey, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, leaseId, this.client.getFileRequestIntent(), owner, - group, fileMode, nfsFileType, contentMD5Converted, filePropertySemantics, contentLength, - structuredBodyType, structuredContentLength, optionalbody, accept, context); + final String fileType = "file"; + RequestOptions requestOptionsLocal = requestOptions == null ? new RequestOptions() : requestOptions; + requestOptionsLocal.addRequestCallback(requestLocal -> { + if (requestLocal.getBody() != null + && requestLocal.getHeaders().get(HttpHeaderName.CONTENT_TYPE) == null) { + requestLocal.getHeaders().set(HttpHeaderName.CONTENT_TYPE, "application/octet-stream"); + } + }); + return service.createSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + fileContentLength, fileType, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), + requestOptionsLocal, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } @@ -2758,7052 +800,1942 @@ public Response createNoCustomHeadersWithResponse(String shareName, String /** * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response body along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono>> downloadWithResponseAsync(String shareName, - String fileName, Integer timeout, String range, Boolean rangeGetContentMD5, String structuredBodyType, - String leaseId) { - return FluxUtil - .withContext(context -> downloadWithResponseAsync(shareName, fileName, timeout, range, rangeGetContentMD5, - structuredBodyType, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response body along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono>> downloadWithResponseAsync(String shareName, - String fileName, Integer timeout, String range, Boolean rangeGetContentMD5, String structuredBodyType, - String leaseId, Context context) { - final String accept = "application/xml"; - return service - .download(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), timeout, - this.client.getVersion(), range, rangeGetContentMD5, structuredBodyType, leaseId, - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Flux downloadAsync(String shareName, String fileName, Integer timeout, String range, - Boolean rangeGetContentMD5, String structuredBodyType, String leaseId) { - return downloadWithResponseAsync(shareName, fileName, timeout, range, rangeGetContentMD5, structuredBodyType, - leaseId).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMapMany(fluxByteBufferResponse -> fluxByteBufferResponse.getValue()); - } - - /** - * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Flux downloadAsync(String shareName, String fileName, Integer timeout, String range, - Boolean rangeGetContentMD5, String structuredBodyType, String leaseId, Context context) { - return downloadWithResponseAsync(shareName, fileName, timeout, range, rangeGetContentMD5, structuredBodyType, - leaseId, context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMapMany(fluxByteBufferResponse -> fluxByteBufferResponse.getValue()); - } - - /** - * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response body on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono downloadNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, String range, Boolean rangeGetContentMD5, String structuredBodyType, String leaseId) { + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
RangeStringNoReturn file data only from the specified byte range.
x-ms-range-get-content-md5BooleanNoWhen this header is set to true and + * specified together with the Range header, the service returns the MD5 hash for the range, as long as the range is + * less than or equal to 4 MB in size.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-structured-bodyStringNoSpecifies the response content should be returned + * as a structured message and specifies the message schema version and properties.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * BinaryData
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the response body along with {@link Response} on successful completion of {@link Mono}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + public Mono> downloadWithResponseAsync(RequestOptions requestOptions) { + final String accept = "application/octet-stream"; return FluxUtil - .withContext(context -> downloadNoCustomHeadersWithResponseAsync(shareName, fileName, timeout, range, - rangeGetContentMD5, structuredBodyType, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response body on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono downloadNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, String range, Boolean rangeGetContentMD5, String structuredBodyType, String leaseId, - Context context) { - final String accept = "application/xml"; - return service - .downloadNoCustomHeaders(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), - timeout, this.client.getVersion(), range, rangeGetContentMD5, structuredBodyType, leaseId, - this.client.getFileRequestIntent(), accept, context) + .withContext(context -> service.download(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response body along with {@link ResponseBase}. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
RangeStringNoReturn file data only from the specified byte range.
x-ms-range-get-content-md5BooleanNoWhen this header is set to true and + * specified together with the Range header, the service returns the MD5 hash for the range, as long as the range is + * less than or equal to 4 MB in size.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-structured-bodyStringNoSpecifies the response content should be returned + * as a structured message and specifies the message schema version and properties.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * BinaryData
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the response body along with {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase downloadWithResponse(String shareName, String fileName, - Integer timeout, String range, Boolean rangeGetContentMD5, String structuredBodyType, String leaseId, - Context context) { + public Response downloadWithResponse(RequestOptions requestOptions) { try { - final String accept = "application/xml"; - return service.downloadSync(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), - timeout, this.client.getVersion(), range, rangeGetContentMD5, structuredBodyType, leaseId, - this.client.getFileRequestIntent(), accept, context); + final String accept = "application/octet-stream"; + return service.downloadSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions, + Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response. + * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public InputStream download(String shareName, String fileName, Integer timeout, String range, - Boolean rangeGetContentMD5, String structuredBodyType, String leaseId) { - try { - return downloadWithResponse(shareName, fileName, timeout, range, rangeGetContentMD5, structuredBodyType, - leaseId, Context.NONE).getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Reads or downloads a file from the system, including its metadata and properties. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Return file data only from the specified byte range. - * @param rangeGetContentMD5 When this header is set to true and specified together with the Range header, the - * service returns the MD5 hash for the range, as long as the range is less than or equal to 4 MB in size. - * @param structuredBodyType Specifies the response content should be returned as a structured message and specifies - * the message schema version and properties. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the response body along with {@link Response}. + public Mono> getPropertiesWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext( + context -> service.getProperties(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response downloadNoCustomHeadersWithResponse(String shareName, String fileName, Integer timeout, - String range, Boolean rangeGetContentMD5, String structuredBodyType, String leaseId, Context context) { + public Response getPropertiesWithResponse(RequestOptions requestOptions) { try { - final String accept = "application/xml"; - return service.downloadNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, - this.client.isAllowTrailingDot(), timeout, this.client.getVersion(), range, rangeGetContentMD5, - structuredBodyType, leaseId, this.client.getFileRequestIntent(), accept, context); + return service.getPropertiesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesWithResponseAsync(String shareName, - String fileName, String sharesnapshot, Integer timeout, String leaseId) { - return FluxUtil.withContext( - context -> getPropertiesWithResponseAsync(shareName, fileName, sharesnapshot, timeout, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesWithResponseAsync(String shareName, - String fileName, String sharesnapshot, Integer timeout, String leaseId, Context context) { - final String accept = "application/xml"; - return service - .getProperties(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), sharesnapshot, - timeout, this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * Removes the file from the storage account. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPropertiesAsync(String shareName, String fileName, String sharesnapshot, Integer timeout, - String leaseId) { - return getPropertiesWithResponseAsync(shareName, fileName, sharesnapshot, timeout, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPropertiesAsync(String shareName, String fileName, String sharesnapshot, Integer timeout, - String leaseId, Context context) { - return getPropertiesWithResponseAsync(shareName, fileName, sharesnapshot, timeout, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String sharesnapshot, Integer timeout, String leaseId) { - return FluxUtil - .withContext(context -> getPropertiesNoCustomHeadersWithResponseAsync(shareName, fileName, sharesnapshot, - timeout, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String sharesnapshot, Integer timeout, String leaseId, Context context) { - final String accept = "application/xml"; - return service - .getPropertiesNoCustomHeaders(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), - sharesnapshot, timeout, this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase getPropertiesWithResponse(String shareName, String fileName, - String sharesnapshot, Integer timeout, String leaseId, Context context) { - try { - final String accept = "application/xml"; - return service.getPropertiesSync(this.client.getUrl(), shareName, fileName, - this.client.isAllowTrailingDot(), sharesnapshot, timeout, this.client.getVersion(), leaseId, - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void getProperties(String shareName, String fileName, String sharesnapshot, Integer timeout, - String leaseId) { - getPropertiesWithResponse(shareName, fileName, sharesnapshot, timeout, leaseId, Context.NONE); - } - - /** - * Returns all user-defined metadata, standard HTTP properties, and system properties for the file. It does not - * return the content of the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response getPropertiesNoCustomHeadersWithResponse(String shareName, String fileName, - String sharesnapshot, Integer timeout, String leaseId, Context context) { - try { - final String accept = "application/xml"; - return service.getPropertiesNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, - this.client.isAllowTrailingDot(), sharesnapshot, timeout, this.client.getVersion(), leaseId, - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteWithResponseAsync(String shareName, String fileName, - Integer timeout, String leaseId) { - return FluxUtil.withContext(context -> deleteWithResponseAsync(shareName, fileName, timeout, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteWithResponseAsync(String shareName, String fileName, - Integer timeout, String leaseId, Context context) { - final String accept = "application/xml"; - return service - .delete(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono deleteAsync(String shareName, String fileName, Integer timeout, String leaseId) { - return deleteWithResponseAsync(shareName, fileName, timeout, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono deleteAsync(String shareName, String fileName, Integer timeout, String leaseId, Context context) { - return deleteWithResponseAsync(shareName, fileName, timeout, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, String leaseId) { - return FluxUtil - .withContext( - context -> deleteNoCustomHeadersWithResponseAsync(shareName, fileName, timeout, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, String leaseId, Context context) { - final String accept = "application/xml"; - return service - .deleteNoCustomHeaders(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase deleteWithResponse(String shareName, String fileName, Integer timeout, - String leaseId, Context context) { - try { - final String accept = "application/xml"; - return service.deleteSync(this.client.getUrl(), shareName, fileName, this.client.isAllowTrailingDot(), - timeout, this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void delete(String shareName, String fileName, Integer timeout, String leaseId) { - deleteWithResponse(shareName, fileName, timeout, leaseId, Context.NONE); - } - - /** - * removes the file from the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response deleteNoCustomHeadersWithResponse(String shareName, String fileName, Integer timeout, - String leaseId, Context context) { - try { - final String accept = "application/xml"; - return service.deleteNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, - this.client.isAllowTrailingDot(), timeout, this.client.getVersion(), leaseId, - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setHttpHeadersWithResponseAsync(String shareName, - String fileName, Integer timeout, Long fileContentLength, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, ShareFileHttpHeaders shareFileHttpHeaders) { - return FluxUtil - .withContext(context -> setHttpHeadersWithResponseAsync(shareName, fileName, timeout, fileContentLength, - filePermission, filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, - fileLastWriteTime, fileChangeTime, leaseId, owner, group, fileMode, shareFileHttpHeaders, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setHttpHeadersWithResponseAsync(String shareName, - String fileName, Integer timeout, Long fileContentLength, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String fileAttributes, - String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, String owner, - String group, String fileMode, ShareFileHttpHeaders shareFileHttpHeaders, Context context) { - final String comp = "properties"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - return service - .setHttpHeaders(this.client.getUrl(), shareName, fileName, comp, timeout, this.client.getVersion(), - fileContentLength, contentType, contentEncoding, contentLanguage, cacheControl, contentMd5Converted, - contentDisposition, filePermission, filePermissionFormat, filePermissionKey, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, leaseId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), owner, group, fileMode, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setHttpHeadersAsync(String shareName, String fileName, Integer timeout, Long fileContentLength, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, - String owner, String group, String fileMode, ShareFileHttpHeaders shareFileHttpHeaders) { - return setHttpHeadersWithResponseAsync(shareName, fileName, timeout, fileContentLength, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, owner, group, fileMode, shareFileHttpHeaders) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setHttpHeadersAsync(String shareName, String fileName, Integer timeout, Long fileContentLength, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, - String owner, String group, String fileMode, ShareFileHttpHeaders shareFileHttpHeaders, Context context) { - return setHttpHeadersWithResponseAsync(shareName, fileName, timeout, fileContentLength, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, owner, group, fileMode, shareFileHttpHeaders, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setHttpHeadersNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, Long fileContentLength, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, - ShareFileHttpHeaders shareFileHttpHeaders) { - return FluxUtil - .withContext(context -> setHttpHeadersNoCustomHeadersWithResponseAsync(shareName, fileName, timeout, - fileContentLength, filePermission, filePermissionFormat, filePermissionKey, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, leaseId, owner, group, fileMode, - shareFileHttpHeaders, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setHttpHeadersNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, Long fileContentLength, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, - ShareFileHttpHeaders shareFileHttpHeaders, Context context) { - final String comp = "properties"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - return service - .setHttpHeadersNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, timeout, - this.client.getVersion(), fileContentLength, contentType, contentEncoding, contentLanguage, - cacheControl, contentMd5Converted, contentDisposition, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, leaseId, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), owner, group, fileMode, accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase setHttpHeadersWithResponse(String shareName, String fileName, - Integer timeout, Long fileContentLength, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, - ShareFileHttpHeaders shareFileHttpHeaders, Context context) { - try { - final String comp = "properties"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - return service.setHttpHeadersSync(this.client.getUrl(), shareName, fileName, comp, timeout, - this.client.getVersion(), fileContentLength, contentType, contentEncoding, contentLanguage, - cacheControl, contentMd5Converted, contentDisposition, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, leaseId, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), owner, group, fileMode, accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void setHttpHeaders(String shareName, String fileName, Integer timeout, Long fileContentLength, - String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, - String fileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime, String leaseId, - String owner, String group, String fileMode, ShareFileHttpHeaders shareFileHttpHeaders) { - setHttpHeadersWithResponse(shareName, fileName, timeout, fileContentLength, filePermission, - filePermissionFormat, filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, leaseId, owner, group, fileMode, shareFileHttpHeaders, Context.NONE); - } - - /** - * Sets HTTP headers on the file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param fileContentLength Resizes a file to the specified size. If the specified byte value is less than the - * current size of the file, then all ranges above the specified byte value are cleared. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param fileAttributes If specified, the provided file attributes shall be set. Default value: ‘Archive’ for file - * and ‘Directory’ for directory. ‘None’ can also be specified as default. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param fileChangeTime Change time for the file/directory. Default value: Now. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response setHttpHeadersNoCustomHeadersWithResponse(String shareName, String fileName, Integer timeout, - Long fileContentLength, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String fileAttributes, String fileCreationTime, String fileLastWriteTime, - String fileChangeTime, String leaseId, String owner, String group, String fileMode, - ShareFileHttpHeaders shareFileHttpHeaders, Context context) { - try { - final String comp = "properties"; - final String accept = "application/xml"; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - String contentEncodingInternal = null; - if (shareFileHttpHeaders != null) { - contentEncodingInternal = shareFileHttpHeaders.getContentEncoding(); - } - String contentEncoding = contentEncodingInternal; - String contentLanguageInternal = null; - if (shareFileHttpHeaders != null) { - contentLanguageInternal = shareFileHttpHeaders.getContentLanguage(); - } - String contentLanguage = contentLanguageInternal; - String cacheControlInternal = null; - if (shareFileHttpHeaders != null) { - cacheControlInternal = shareFileHttpHeaders.getCacheControl(); - } - String cacheControl = cacheControlInternal; - byte[] contentMd5Internal = null; - if (shareFileHttpHeaders != null) { - contentMd5Internal = shareFileHttpHeaders.getContentMd5(); - } - byte[] contentMd5 = contentMd5Internal; - String contentDispositionInternal = null; - if (shareFileHttpHeaders != null) { - contentDispositionInternal = shareFileHttpHeaders.getContentDisposition(); - } - String contentDisposition = contentDispositionInternal; - String contentMd5Converted = Base64Util.encodeToString(contentMd5); - return service.setHttpHeadersNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, timeout, - this.client.getVersion(), fileContentLength, contentType, contentEncoding, contentLanguage, - cacheControl, contentMd5Converted, contentDisposition, filePermission, filePermissionFormat, - filePermissionKey, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, leaseId, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), owner, group, fileMode, accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeWithResponseAsync(String shareName, - String fileName, String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, - byte[] contentMD5, String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, Flux optionalbody) { - return FluxUtil - .withContext(context -> uploadRangeWithResponseAsync(shareName, fileName, range, fileRangeWrite, - contentLength, timeout, contentMD5, leaseId, fileLastWrittenMode, structuredBodyType, - structuredContentLength, optionalbody, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeWithResponseAsync(String shareName, - String fileName, String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, - byte[] contentMD5, String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, Flux optionalbody, Context context) { - final String comp = "range"; - final String accept = "application/xml"; - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service - .uploadRange(this.client.getUrl(), shareName, fileName, comp, timeout, range, fileRangeWrite, contentLength, - contentMD5Converted, this.client.getVersion(), leaseId, fileLastWrittenMode, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), structuredBodyType, - structuredContentLength, optionalbody, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono uploadRangeAsync(String shareName, String fileName, String range, - ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, String leaseId, - FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, Long structuredContentLength, - Flux optionalbody) { - return uploadRangeWithResponseAsync(shareName, fileName, range, fileRangeWrite, contentLength, timeout, - contentMD5, leaseId, fileLastWrittenMode, structuredBodyType, structuredContentLength, optionalbody) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono uploadRangeAsync(String shareName, String fileName, String range, - ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, String leaseId, - FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, Long structuredContentLength, - Flux optionalbody, Context context) { - return uploadRangeWithResponseAsync(shareName, fileName, range, fileRangeWrite, contentLength, timeout, - contentMD5, leaseId, fileLastWrittenMode, structuredBodyType, structuredContentLength, optionalbody, - context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, - String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, Flux optionalbody) { - return FluxUtil - .withContext(context -> uploadRangeNoCustomHeadersWithResponseAsync(shareName, fileName, range, - fileRangeWrite, contentLength, timeout, contentMD5, leaseId, fileLastWrittenMode, structuredBodyType, - structuredContentLength, optionalbody, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, - String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, Flux optionalbody, Context context) { - final String comp = "range"; - final String accept = "application/xml"; - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service - .uploadRangeNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, timeout, range, fileRangeWrite, - contentLength, contentMD5Converted, this.client.getVersion(), leaseId, fileLastWrittenMode, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), structuredBodyType, - structuredContentLength, optionalbody, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeWithResponseAsync(String shareName, - String fileName, String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, - byte[] contentMD5, String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody) { - return FluxUtil - .withContext(context -> uploadRangeWithResponseAsync(shareName, fileName, range, fileRangeWrite, - contentLength, timeout, contentMD5, leaseId, fileLastWrittenMode, structuredBodyType, - structuredContentLength, optionalbody, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeWithResponseAsync(String shareName, - String fileName, String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, - byte[] contentMD5, String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, Context context) { - final String comp = "range"; - final String accept = "application/xml"; - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service - .uploadRange(this.client.getUrl(), shareName, fileName, comp, timeout, range, fileRangeWrite, contentLength, - contentMD5Converted, this.client.getVersion(), leaseId, fileLastWrittenMode, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), structuredBodyType, - structuredContentLength, optionalbody, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono uploadRangeAsync(String shareName, String fileName, String range, - ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, String leaseId, - FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, Long structuredContentLength, - BinaryData optionalbody) { - return uploadRangeWithResponseAsync(shareName, fileName, range, fileRangeWrite, contentLength, timeout, - contentMD5, leaseId, fileLastWrittenMode, structuredBodyType, structuredContentLength, optionalbody) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono uploadRangeAsync(String shareName, String fileName, String range, - ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, String leaseId, - FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, Long structuredContentLength, - BinaryData optionalbody, Context context) { - return uploadRangeWithResponseAsync(shareName, fileName, range, fileRangeWrite, contentLength, timeout, - contentMD5, leaseId, fileLastWrittenMode, structuredBodyType, structuredContentLength, optionalbody, - context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, - String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody) { - return FluxUtil - .withContext(context -> uploadRangeNoCustomHeadersWithResponseAsync(shareName, fileName, range, - fileRangeWrite, contentLength, timeout, contentMD5, leaseId, fileLastWrittenMode, structuredBodyType, - structuredContentLength, optionalbody, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, - String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, Context context) { - final String comp = "range"; - final String accept = "application/xml"; - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service - .uploadRangeNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, timeout, range, fileRangeWrite, - contentLength, contentMD5Converted, this.client.getVersion(), leaseId, fileLastWrittenMode, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), structuredBodyType, - structuredContentLength, optionalbody, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase uploadRangeWithResponse(String shareName, String fileName, - String range, ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, - String leaseId, FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, - Long structuredContentLength, BinaryData optionalbody, Context context) { - try { - final String comp = "range"; - final String accept = "application/xml"; - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service.uploadRangeSync(this.client.getUrl(), shareName, fileName, comp, timeout, range, - fileRangeWrite, contentLength, contentMD5Converted, this.client.getVersion(), leaseId, - fileLastWrittenMode, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), - structuredBodyType, structuredContentLength, optionalbody, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void uploadRange(String shareName, String fileName, String range, ShareFileRangeWriteType fileRangeWrite, - long contentLength, Integer timeout, byte[] contentMD5, String leaseId, FileLastWrittenMode fileLastWrittenMode, - String structuredBodyType, Long structuredContentLength, BinaryData optionalbody) { - uploadRangeWithResponse(shareName, fileName, range, fileRangeWrite, contentLength, timeout, contentMD5, leaseId, - fileLastWrittenMode, structuredBodyType, structuredContentLength, optionalbody, Context.NONE); - } - - /** - * Upload a range of bytes to a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. - * For an update operation, the range can be up to 4 MB in size. For a clear operation, the range can be up to the - * value of the file's full size. The File service accepts only a single byte range for the Range and 'x-ms-range' - * headers, and the byte range must be specified in the following format: bytes=startByte-endByte. - * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request - * body into the specified range. The Range and Content-Length headers must match to perform the update. - Clear: - * Clears the specified range and releases the space used in storage for that range. To clear a range, set the - * Content-Length header to zero, and set the Range header to a value that indicates the range to clear, up to - * maximum file size. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param contentMD5 An MD5 hash of the content. This hash is used to verify the integrity of the data during - * transport. When the Content-MD5 header is specified, the File service compares the hash of the content that has - * arrived with the header value that was sent. If the two hashes do not match, the operation will fail with error - * code 400 (Bad Request). - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param structuredBodyType Required if the request body is a structured message. Specifies the message schema - * version and properties. - * @param structuredContentLength Required if the request body is a structured message. Specifies the length of the - * blob/file content inside the message body. Will always be smaller than Content-Length. - * @param optionalbody Initial data. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response uploadRangeNoCustomHeadersWithResponse(String shareName, String fileName, String range, - ShareFileRangeWriteType fileRangeWrite, long contentLength, Integer timeout, byte[] contentMD5, String leaseId, - FileLastWrittenMode fileLastWrittenMode, String structuredBodyType, Long structuredContentLength, - BinaryData optionalbody, Context context) { - try { - final String comp = "range"; - final String accept = "application/xml"; - String contentMD5Converted = Base64Util.encodeToString(contentMD5); - return service.uploadRangeNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, timeout, - range, fileRangeWrite, contentLength, contentMD5Converted, this.client.getVersion(), leaseId, - fileLastWrittenMode, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), - structuredBodyType, structuredContentLength, optionalbody, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataWithResponseAsync(String shareName, - String fileName, Integer timeout, Map metadata, String leaseId) { - return FluxUtil - .withContext( - context -> setMetadataWithResponseAsync(shareName, fileName, timeout, metadata, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataWithResponseAsync(String shareName, - String fileName, Integer timeout, Map metadata, String leaseId, Context context) { - final String comp = "metadata"; - final String accept = "application/xml"; - return service - .setMetadata(this.client.getUrl(), shareName, fileName, comp, timeout, metadata, this.client.getVersion(), - leaseId, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setMetadataAsync(String shareName, String fileName, Integer timeout, Map metadata, - String leaseId) { - return setMetadataWithResponseAsync(shareName, fileName, timeout, metadata, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setMetadataAsync(String shareName, String fileName, Integer timeout, Map metadata, - String leaseId, Context context) { - return setMetadataWithResponseAsync(shareName, fileName, timeout, metadata, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, Map metadata, String leaseId) { - return FluxUtil - .withContext(context -> setMetadataNoCustomHeadersWithResponseAsync(shareName, fileName, timeout, metadata, - leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, Map metadata, String leaseId, Context context) { - final String comp = "metadata"; - final String accept = "application/xml"; - return service - .setMetadataNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, timeout, metadata, - this.client.getVersion(), leaseId, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), - accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase setMetadataWithResponse(String shareName, String fileName, - Integer timeout, Map metadata, String leaseId, Context context) { - try { - final String comp = "metadata"; - final String accept = "application/xml"; - return service.setMetadataSync(this.client.getUrl(), shareName, fileName, comp, timeout, metadata, - this.client.getVersion(), leaseId, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), - accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void setMetadata(String shareName, String fileName, Integer timeout, Map metadata, - String leaseId) { - setMetadataWithResponse(shareName, fileName, timeout, metadata, leaseId, Context.NONE); - } - - /** - * Updates user-defined metadata for the specified file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response setMetadataNoCustomHeadersWithResponse(String shareName, String fileName, Integer timeout, - Map metadata, String leaseId, Context context) { - try { - final String comp = "metadata"; - final String accept = "application/xml"; - return service.setMetadataNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, timeout, - metadata, this.client.getVersion(), leaseId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> acquireLeaseWithResponseAsync(String shareName, - String fileName, Integer timeout, Integer duration, String proposedLeaseId, String requestId) { - return FluxUtil - .withContext(context -> acquireLeaseWithResponseAsync(shareName, fileName, timeout, duration, - proposedLeaseId, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> acquireLeaseWithResponseAsync(String shareName, - String fileName, Integer timeout, Integer duration, String proposedLeaseId, String requestId, Context context) { - final String comp = "lease"; - final String action = "acquire"; - final String accept = "application/xml"; - return service - .acquireLease(this.client.getUrl(), shareName, fileName, comp, action, timeout, duration, proposedLeaseId, - this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono acquireLeaseAsync(String shareName, String fileName, Integer timeout, Integer duration, - String proposedLeaseId, String requestId) { - return acquireLeaseWithResponseAsync(shareName, fileName, timeout, duration, proposedLeaseId, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono acquireLeaseAsync(String shareName, String fileName, Integer timeout, Integer duration, - String proposedLeaseId, String requestId, Context context) { - return acquireLeaseWithResponseAsync(shareName, fileName, timeout, duration, proposedLeaseId, requestId, - context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> acquireLeaseNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, Integer duration, String proposedLeaseId, String requestId) { - return FluxUtil - .withContext(context -> acquireLeaseNoCustomHeadersWithResponseAsync(shareName, fileName, timeout, duration, - proposedLeaseId, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> acquireLeaseNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, Integer duration, String proposedLeaseId, String requestId, Context context) { - final String comp = "lease"; - final String action = "acquire"; - final String accept = "application/xml"; - return service - .acquireLeaseNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, action, timeout, duration, - proposedLeaseId, this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase acquireLeaseWithResponse(String shareName, String fileName, - Integer timeout, Integer duration, String proposedLeaseId, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "acquire"; - final String accept = "application/xml"; - return service.acquireLeaseSync(this.client.getUrl(), shareName, fileName, comp, action, timeout, duration, - proposedLeaseId, this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void acquireLease(String shareName, String fileName, Integer timeout, Integer duration, - String proposedLeaseId, String requestId) { - acquireLeaseWithResponse(shareName, fileName, timeout, duration, proposedLeaseId, requestId, Context.NONE); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response acquireLeaseNoCustomHeadersWithResponse(String shareName, String fileName, Integer timeout, - Integer duration, String proposedLeaseId, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "acquire"; - final String accept = "application/xml"; - return service.acquireLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, action, - timeout, duration, proposedLeaseId, this.client.getVersion(), requestId, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> releaseLeaseWithResponseAsync(String shareName, - String fileName, String leaseId, Integer timeout, String requestId) { - return FluxUtil - .withContext( - context -> releaseLeaseWithResponseAsync(shareName, fileName, leaseId, timeout, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> releaseLeaseWithResponseAsync(String shareName, - String fileName, String leaseId, Integer timeout, String requestId, Context context) { - final String comp = "lease"; - final String action = "release"; - final String accept = "application/xml"; - return service - .releaseLease(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, - this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono releaseLeaseAsync(String shareName, String fileName, String leaseId, Integer timeout, - String requestId) { - return releaseLeaseWithResponseAsync(shareName, fileName, leaseId, timeout, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono releaseLeaseAsync(String shareName, String fileName, String leaseId, Integer timeout, - String requestId, Context context) { - return releaseLeaseWithResponseAsync(shareName, fileName, leaseId, timeout, requestId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> releaseLeaseNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String leaseId, Integer timeout, String requestId) { - return FluxUtil - .withContext(context -> releaseLeaseNoCustomHeadersWithResponseAsync(shareName, fileName, leaseId, timeout, - requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> releaseLeaseNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String leaseId, Integer timeout, String requestId, Context context) { - final String comp = "lease"; - final String action = "release"; - final String accept = "application/xml"; - return service - .releaseLeaseNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, - this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase releaseLeaseWithResponse(String shareName, String fileName, - String leaseId, Integer timeout, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "release"; - final String accept = "application/xml"; - return service.releaseLeaseSync(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, - this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void releaseLease(String shareName, String fileName, String leaseId, Integer timeout, String requestId) { - releaseLeaseWithResponse(shareName, fileName, leaseId, timeout, requestId, Context.NONE); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response releaseLeaseNoCustomHeadersWithResponse(String shareName, String fileName, String leaseId, - Integer timeout, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "release"; - final String accept = "application/xml"; - return service.releaseLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, action, - timeout, leaseId, this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> changeLeaseWithResponseAsync(String shareName, - String fileName, String leaseId, Integer timeout, String proposedLeaseId, String requestId) { - return FluxUtil - .withContext(context -> changeLeaseWithResponseAsync(shareName, fileName, leaseId, timeout, proposedLeaseId, - requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> changeLeaseWithResponseAsync(String shareName, - String fileName, String leaseId, Integer timeout, String proposedLeaseId, String requestId, Context context) { - final String comp = "lease"; - final String action = "change"; - final String accept = "application/xml"; - return service - .changeLease(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, proposedLeaseId, - this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono changeLeaseAsync(String shareName, String fileName, String leaseId, Integer timeout, - String proposedLeaseId, String requestId) { - return changeLeaseWithResponseAsync(shareName, fileName, leaseId, timeout, proposedLeaseId, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono changeLeaseAsync(String shareName, String fileName, String leaseId, Integer timeout, - String proposedLeaseId, String requestId, Context context) { - return changeLeaseWithResponseAsync(shareName, fileName, leaseId, timeout, proposedLeaseId, requestId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> changeLeaseNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String leaseId, Integer timeout, String proposedLeaseId, String requestId) { - return FluxUtil - .withContext(context -> changeLeaseNoCustomHeadersWithResponseAsync(shareName, fileName, leaseId, timeout, - proposedLeaseId, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> changeLeaseNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String leaseId, Integer timeout, String proposedLeaseId, String requestId, Context context) { - final String comp = "lease"; - final String action = "change"; - final String accept = "application/xml"; - return service - .changeLeaseNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, - proposedLeaseId, this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase changeLeaseWithResponse(String shareName, String fileName, - String leaseId, Integer timeout, String proposedLeaseId, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "change"; - final String accept = "application/xml"; - return service.changeLeaseSync(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, - proposedLeaseId, this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void changeLease(String shareName, String fileName, String leaseId, Integer timeout, String proposedLeaseId, - String requestId) { - changeLeaseWithResponse(shareName, fileName, leaseId, timeout, proposedLeaseId, requestId, Context.NONE); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response changeLeaseNoCustomHeadersWithResponse(String shareName, String fileName, String leaseId, - Integer timeout, String proposedLeaseId, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "change"; - final String accept = "application/xml"; - return service.changeLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, action, - timeout, leaseId, proposedLeaseId, this.client.getVersion(), requestId, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> breakLeaseWithResponseAsync(String shareName, - String fileName, Integer timeout, String leaseId, String requestId) { - return FluxUtil - .withContext( - context -> breakLeaseWithResponseAsync(shareName, fileName, timeout, leaseId, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> breakLeaseWithResponseAsync(String shareName, - String fileName, Integer timeout, String leaseId, String requestId, Context context) { - final String comp = "lease"; - final String action = "break"; - final String accept = "application/xml"; - return service - .breakLease(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, - this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono breakLeaseAsync(String shareName, String fileName, Integer timeout, String leaseId, - String requestId) { - return breakLeaseWithResponseAsync(shareName, fileName, timeout, leaseId, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono breakLeaseAsync(String shareName, String fileName, Integer timeout, String leaseId, - String requestId, Context context) { - return breakLeaseWithResponseAsync(shareName, fileName, timeout, leaseId, requestId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> breakLeaseNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, String leaseId, String requestId) { - return FluxUtil - .withContext(context -> breakLeaseNoCustomHeadersWithResponseAsync(shareName, fileName, timeout, leaseId, - requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> breakLeaseNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, String leaseId, String requestId, Context context) { - final String comp = "lease"; - final String action = "break"; - final String accept = "application/xml"; - return service - .breakLeaseNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, - this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase breakLeaseWithResponse(String shareName, String fileName, - Integer timeout, String leaseId, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "break"; - final String accept = "application/xml"; - return service.breakLeaseSync(this.client.getUrl(), shareName, fileName, comp, action, timeout, leaseId, - this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void breakLease(String shareName, String fileName, Integer timeout, String leaseId, String requestId) { - breakLeaseWithResponse(shareName, fileName, timeout, leaseId, requestId, Context.NONE); - } - - /** - * [Update] The Lease File operation establishes and manages a lock on a file for write and delete operations. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response breakLeaseNoCustomHeadersWithResponse(String shareName, String fileName, Integer timeout, - String leaseId, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "break"; - final String accept = "application/xml"; - return service.breakLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, action, - timeout, leaseId, this.client.getVersion(), requestId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeFromURLWithResponseAsync( - String shareName, String fileName, String range, String copySource, long contentLength, Integer timeout, - String sourceRange, byte[] sourceContentCrc64, String leaseId, String copySourceAuthorization, - FileLastWrittenMode fileLastWrittenMode, SourceModifiedAccessConditions sourceModifiedAccessConditions) { - return FluxUtil - .withContext(context -> uploadRangeFromURLWithResponseAsync(shareName, fileName, range, copySource, - contentLength, timeout, sourceRange, sourceContentCrc64, leaseId, copySourceAuthorization, - fileLastWrittenMode, sourceModifiedAccessConditions, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeFromURLWithResponseAsync( - String shareName, String fileName, String range, String copySource, long contentLength, Integer timeout, - String sourceRange, byte[] sourceContentCrc64, String leaseId, String copySourceAuthorization, - FileLastWrittenMode fileLastWrittenMode, SourceModifiedAccessConditions sourceModifiedAccessConditions, - Context context) { - final String comp = "range"; - final String fileRangeWriteFromUrl = "update"; - final String accept = "application/xml"; - byte[] sourceIfMatchCrc64Internal = null; - if (sourceModifiedAccessConditions != null) { - sourceIfMatchCrc64Internal = sourceModifiedAccessConditions.getSourceIfMatchCrc64(); - } - byte[] sourceIfMatchCrc64 = sourceIfMatchCrc64Internal; - byte[] sourceIfNoneMatchCrc64Internal = null; - if (sourceModifiedAccessConditions != null) { - sourceIfNoneMatchCrc64Internal = sourceModifiedAccessConditions.getSourceIfNoneMatchCrc64(); - } - byte[] sourceIfNoneMatchCrc64 = sourceIfNoneMatchCrc64Internal; - String sourceContentCrc64Converted = Base64Util.encodeToString(sourceContentCrc64); - String sourceIfMatchCrc64Converted = Base64Util.encodeToString(sourceIfMatchCrc64); - String sourceIfNoneMatchCrc64Converted = Base64Util.encodeToString(sourceIfNoneMatchCrc64); - return service - .uploadRangeFromURL(this.client.getUrl(), shareName, fileName, comp, timeout, range, copySource, - sourceRange, fileRangeWriteFromUrl, contentLength, sourceContentCrc64Converted, - sourceIfMatchCrc64Converted, sourceIfNoneMatchCrc64Converted, this.client.getVersion(), leaseId, - copySourceAuthorization, fileLastWrittenMode, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono uploadRangeFromURLAsync(String shareName, String fileName, String range, String copySource, - long contentLength, Integer timeout, String sourceRange, byte[] sourceContentCrc64, String leaseId, - String copySourceAuthorization, FileLastWrittenMode fileLastWrittenMode, - SourceModifiedAccessConditions sourceModifiedAccessConditions) { - return uploadRangeFromURLWithResponseAsync(shareName, fileName, range, copySource, contentLength, timeout, - sourceRange, sourceContentCrc64, leaseId, copySourceAuthorization, fileLastWrittenMode, - sourceModifiedAccessConditions) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono uploadRangeFromURLAsync(String shareName, String fileName, String range, String copySource, - long contentLength, Integer timeout, String sourceRange, byte[] sourceContentCrc64, String leaseId, - String copySourceAuthorization, FileLastWrittenMode fileLastWrittenMode, - SourceModifiedAccessConditions sourceModifiedAccessConditions, Context context) { - return uploadRangeFromURLWithResponseAsync(shareName, fileName, range, copySource, contentLength, timeout, - sourceRange, sourceContentCrc64, leaseId, copySourceAuthorization, fileLastWrittenMode, - sourceModifiedAccessConditions, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeFromURLNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String range, String copySource, long contentLength, Integer timeout, String sourceRange, - byte[] sourceContentCrc64, String leaseId, String copySourceAuthorization, - FileLastWrittenMode fileLastWrittenMode, SourceModifiedAccessConditions sourceModifiedAccessConditions) { - return FluxUtil - .withContext(context -> uploadRangeFromURLNoCustomHeadersWithResponseAsync(shareName, fileName, range, - copySource, contentLength, timeout, sourceRange, sourceContentCrc64, leaseId, copySourceAuthorization, - fileLastWrittenMode, sourceModifiedAccessConditions, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> uploadRangeFromURLNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String range, String copySource, long contentLength, Integer timeout, String sourceRange, - byte[] sourceContentCrc64, String leaseId, String copySourceAuthorization, - FileLastWrittenMode fileLastWrittenMode, SourceModifiedAccessConditions sourceModifiedAccessConditions, - Context context) { - final String comp = "range"; - final String fileRangeWriteFromUrl = "update"; - final String accept = "application/xml"; - byte[] sourceIfMatchCrc64Internal = null; - if (sourceModifiedAccessConditions != null) { - sourceIfMatchCrc64Internal = sourceModifiedAccessConditions.getSourceIfMatchCrc64(); - } - byte[] sourceIfMatchCrc64 = sourceIfMatchCrc64Internal; - byte[] sourceIfNoneMatchCrc64Internal = null; - if (sourceModifiedAccessConditions != null) { - sourceIfNoneMatchCrc64Internal = sourceModifiedAccessConditions.getSourceIfNoneMatchCrc64(); - } - byte[] sourceIfNoneMatchCrc64 = sourceIfNoneMatchCrc64Internal; - String sourceContentCrc64Converted = Base64Util.encodeToString(sourceContentCrc64); - String sourceIfMatchCrc64Converted = Base64Util.encodeToString(sourceIfMatchCrc64); - String sourceIfNoneMatchCrc64Converted = Base64Util.encodeToString(sourceIfNoneMatchCrc64); - return service - .uploadRangeFromURLNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, timeout, range, - copySource, sourceRange, fileRangeWriteFromUrl, contentLength, sourceContentCrc64Converted, - sourceIfMatchCrc64Converted, sourceIfNoneMatchCrc64Converted, this.client.getVersion(), leaseId, - copySourceAuthorization, fileLastWrittenMode, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase uploadRangeFromURLWithResponse(String shareName, - String fileName, String range, String copySource, long contentLength, Integer timeout, String sourceRange, - byte[] sourceContentCrc64, String leaseId, String copySourceAuthorization, - FileLastWrittenMode fileLastWrittenMode, SourceModifiedAccessConditions sourceModifiedAccessConditions, - Context context) { - try { - final String comp = "range"; - final String fileRangeWriteFromUrl = "update"; - final String accept = "application/xml"; - byte[] sourceIfMatchCrc64Internal = null; - if (sourceModifiedAccessConditions != null) { - sourceIfMatchCrc64Internal = sourceModifiedAccessConditions.getSourceIfMatchCrc64(); - } - byte[] sourceIfMatchCrc64 = sourceIfMatchCrc64Internal; - byte[] sourceIfNoneMatchCrc64Internal = null; - if (sourceModifiedAccessConditions != null) { - sourceIfNoneMatchCrc64Internal = sourceModifiedAccessConditions.getSourceIfNoneMatchCrc64(); - } - byte[] sourceIfNoneMatchCrc64 = sourceIfNoneMatchCrc64Internal; - String sourceContentCrc64Converted = Base64Util.encodeToString(sourceContentCrc64); - String sourceIfMatchCrc64Converted = Base64Util.encodeToString(sourceIfMatchCrc64); - String sourceIfNoneMatchCrc64Converted = Base64Util.encodeToString(sourceIfNoneMatchCrc64); - return service.uploadRangeFromURLSync(this.client.getUrl(), shareName, fileName, comp, timeout, range, - copySource, sourceRange, fileRangeWriteFromUrl, contentLength, sourceContentCrc64Converted, - sourceIfMatchCrc64Converted, sourceIfNoneMatchCrc64Converted, this.client.getVersion(), leaseId, - copySourceAuthorization, fileLastWrittenMode, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void uploadRangeFromURL(String shareName, String fileName, String range, String copySource, - long contentLength, Integer timeout, String sourceRange, byte[] sourceContentCrc64, String leaseId, - String copySourceAuthorization, FileLastWrittenMode fileLastWrittenMode, - SourceModifiedAccessConditions sourceModifiedAccessConditions) { - uploadRangeFromURLWithResponse(shareName, fileName, range, copySource, contentLength, timeout, sourceRange, - sourceContentCrc64, leaseId, copySourceAuthorization, fileLastWrittenMode, sourceModifiedAccessConditions, - Context.NONE); - } - - /** - * Upload a range of bytes to a file where the contents are read from a URL. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param range Writes data to the specified byte range in the file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param contentLength Specifies the number of bytes being transmitted in the request body. When the x-ms-write - * header is set to clear, the value of this header must be set to zero. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sourceRange Bytes of source data in the specified range. - * @param sourceContentCrc64 Specify the crc64 calculated for the range of bytes that must be read from the copy - * source. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param copySourceAuthorization Only Bearer type is supported. Credentials should be a valid OAuth access token to - * copy source. - * @param fileLastWrittenMode If the file last write time should be preserved or overwritten. - * @param sourceModifiedAccessConditions Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response uploadRangeFromURLNoCustomHeadersWithResponse(String shareName, String fileName, String range, - String copySource, long contentLength, Integer timeout, String sourceRange, byte[] sourceContentCrc64, - String leaseId, String copySourceAuthorization, FileLastWrittenMode fileLastWrittenMode, - SourceModifiedAccessConditions sourceModifiedAccessConditions, Context context) { - try { - final String comp = "range"; - final String fileRangeWriteFromUrl = "update"; - final String accept = "application/xml"; - byte[] sourceIfMatchCrc64Internal = null; - if (sourceModifiedAccessConditions != null) { - sourceIfMatchCrc64Internal = sourceModifiedAccessConditions.getSourceIfMatchCrc64(); - } - byte[] sourceIfMatchCrc64 = sourceIfMatchCrc64Internal; - byte[] sourceIfNoneMatchCrc64Internal = null; - if (sourceModifiedAccessConditions != null) { - sourceIfNoneMatchCrc64Internal = sourceModifiedAccessConditions.getSourceIfNoneMatchCrc64(); - } - byte[] sourceIfNoneMatchCrc64 = sourceIfNoneMatchCrc64Internal; - String sourceContentCrc64Converted = Base64Util.encodeToString(sourceContentCrc64); - String sourceIfMatchCrc64Converted = Base64Util.encodeToString(sourceIfMatchCrc64); - String sourceIfNoneMatchCrc64Converted = Base64Util.encodeToString(sourceIfNoneMatchCrc64); - return service.uploadRangeFromURLNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, - timeout, range, copySource, sourceRange, fileRangeWriteFromUrl, contentLength, - sourceContentCrc64Converted, sourceIfMatchCrc64Converted, sourceIfNoneMatchCrc64Converted, - this.client.getVersion(), leaseId, copySourceAuthorization, fileLastWrittenMode, - this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getRangeListWithResponseAsync( - String shareName, String fileName, String sharesnapshot, String prevsharesnapshot, Integer timeout, - String range, String leaseId, Boolean supportRename) { - return FluxUtil - .withContext(context -> getRangeListWithResponseAsync(shareName, fileName, sharesnapshot, prevsharesnapshot, - timeout, range, leaseId, supportRename, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getRangeListWithResponseAsync( - String shareName, String fileName, String sharesnapshot, String prevsharesnapshot, Integer timeout, - String range, String leaseId, Boolean supportRename, Context context) { - final String comp = "rangelist"; - final String accept = "application/xml"; - return service - .getRangeList(this.client.getUrl(), shareName, fileName, comp, sharesnapshot, prevsharesnapshot, timeout, - this.client.getVersion(), range, leaseId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), supportRename, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getRangeListAsync(String shareName, String fileName, String sharesnapshot, - String prevsharesnapshot, Integer timeout, String range, String leaseId, Boolean supportRename) { - return getRangeListWithResponseAsync(shareName, fileName, sharesnapshot, prevsharesnapshot, timeout, range, - leaseId, supportRename) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getRangeListAsync(String shareName, String fileName, String sharesnapshot, - String prevsharesnapshot, Integer timeout, String range, String leaseId, Boolean supportRename, - Context context) { - return getRangeListWithResponseAsync(shareName, fileName, sharesnapshot, prevsharesnapshot, timeout, range, - leaseId, supportRename, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getRangeListNoCustomHeadersWithResponseAsync(String shareName, - String fileName, String sharesnapshot, String prevsharesnapshot, Integer timeout, String range, String leaseId, - Boolean supportRename) { - return FluxUtil - .withContext(context -> getRangeListNoCustomHeadersWithResponseAsync(shareName, fileName, sharesnapshot, - prevsharesnapshot, timeout, range, leaseId, supportRename, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getRangeListNoCustomHeadersWithResponseAsync(String shareName, - String fileName, String sharesnapshot, String prevsharesnapshot, Integer timeout, String range, String leaseId, - Boolean supportRename, Context context) { - final String comp = "rangelist"; - final String accept = "application/xml"; - return service - .getRangeListNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, sharesnapshot, - prevsharesnapshot, timeout, this.client.getVersion(), range, leaseId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), supportRename, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges along with {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase getRangeListWithResponse(String shareName, - String fileName, String sharesnapshot, String prevsharesnapshot, Integer timeout, String range, String leaseId, - Boolean supportRename, Context context) { - try { - final String comp = "rangelist"; - final String accept = "application/xml"; - return service.getRangeListSync(this.client.getUrl(), shareName, fileName, comp, sharesnapshot, - prevsharesnapshot, timeout, this.client.getVersion(), range, leaseId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), supportRename, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ShareFileRangeList getRangeList(String shareName, String fileName, String sharesnapshot, - String prevsharesnapshot, Integer timeout, String range, String leaseId, Boolean supportRename) { - try { - return getRangeListWithResponse(shareName, fileName, sharesnapshot, prevsharesnapshot, timeout, range, - leaseId, supportRename, Context.NONE).getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns the list of valid ranges for a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param prevsharesnapshot The previous snapshot parameter is an opaque DateTime value that, when present, - * specifies the previous snapshot. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param range Specifies the range of bytes over which to list ranges, inclusively. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param supportRename This header is allowed only when PrevShareSnapshot query parameter is set. Determines - * whether the changed ranges for a file that has been renamed or moved between the target snapshot (or the live - * file) and the previous snapshot should be listed. If the value is true, the valid changed ranges for the file - * will be returned. If the value is false, the operation will result in a failure with 409 (Conflict) response. The - * default value is false. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the list of file ranges along with {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response getRangeListNoCustomHeadersWithResponse(String shareName, String fileName, - String sharesnapshot, String prevsharesnapshot, Integer timeout, String range, String leaseId, - Boolean supportRename, Context context) { - try { - final String comp = "rangelist"; - final String accept = "application/xml"; - return service.getRangeListNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, - sharesnapshot, prevsharesnapshot, timeout, this.client.getVersion(), range, leaseId, - this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), supportRename, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> startCopyWithResponseAsync(String shareName, String fileName, - String copySource, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String leaseId, String owner, String group, - String fileMode, ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, - CopyFileSmbInfo copyFileSmbInfo) { - return FluxUtil - .withContext(context -> startCopyWithResponseAsync(shareName, fileName, copySource, timeout, metadata, - filePermission, filePermissionFormat, filePermissionKey, leaseId, owner, group, fileMode, - fileModeCopyMode, fileOwnerCopyMode, copyFileSmbInfo, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> startCopyWithResponseAsync(String shareName, String fileName, - String copySource, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String leaseId, String owner, String group, - String fileMode, ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, - CopyFileSmbInfo copyFileSmbInfo, Context context) { - final String accept = "application/xml"; - PermissionCopyModeType filePermissionCopyModeInternal = null; - if (copyFileSmbInfo != null) { - filePermissionCopyModeInternal = copyFileSmbInfo.getFilePermissionCopyMode(); - } - PermissionCopyModeType filePermissionCopyMode = filePermissionCopyModeInternal; - Boolean ignoreReadOnlyInternal = null; - if (copyFileSmbInfo != null) { - ignoreReadOnlyInternal = copyFileSmbInfo.isIgnoreReadOnly(); - } - Boolean ignoreReadOnly = ignoreReadOnlyInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - Boolean setArchiveAttributeInternal = null; - if (copyFileSmbInfo != null) { - setArchiveAttributeInternal = copyFileSmbInfo.isSetArchiveAttribute(); - } - Boolean setArchiveAttribute = setArchiveAttributeInternal; - return service - .startCopy(this.client.getUrl(), shareName, fileName, timeout, this.client.getVersion(), metadata, - copySource, filePermission, filePermissionFormat, filePermissionKey, filePermissionCopyMode, - ignoreReadOnly, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, - setArchiveAttribute, leaseId, this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), - this.client.getFileRequestIntent(), owner, group, fileMode, fileModeCopyMode, fileOwnerCopyMode, accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono startCopyAsync(String shareName, String fileName, String copySource, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String leaseId, String owner, String group, String fileMode, - ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, CopyFileSmbInfo copyFileSmbInfo) { - return startCopyWithResponseAsync(shareName, fileName, copySource, timeout, metadata, filePermission, - filePermissionFormat, filePermissionKey, leaseId, owner, group, fileMode, fileModeCopyMode, - fileOwnerCopyMode, copyFileSmbInfo) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono startCopyAsync(String shareName, String fileName, String copySource, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String leaseId, String owner, String group, String fileMode, - ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, CopyFileSmbInfo copyFileSmbInfo, - Context context) { - return startCopyWithResponseAsync(shareName, fileName, copySource, timeout, metadata, filePermission, - filePermissionFormat, filePermissionKey, leaseId, owner, group, fileMode, fileModeCopyMode, - fileOwnerCopyMode, copyFileSmbInfo, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> startCopyNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String copySource, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String leaseId, String owner, String group, - String fileMode, ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, - CopyFileSmbInfo copyFileSmbInfo) { - return FluxUtil - .withContext(context -> startCopyNoCustomHeadersWithResponseAsync(shareName, fileName, copySource, timeout, - metadata, filePermission, filePermissionFormat, filePermissionKey, leaseId, owner, group, fileMode, - fileModeCopyMode, fileOwnerCopyMode, copyFileSmbInfo, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> startCopyNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String copySource, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String leaseId, String owner, String group, - String fileMode, ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, - CopyFileSmbInfo copyFileSmbInfo, Context context) { - final String accept = "application/xml"; - PermissionCopyModeType filePermissionCopyModeInternal = null; - if (copyFileSmbInfo != null) { - filePermissionCopyModeInternal = copyFileSmbInfo.getFilePermissionCopyMode(); - } - PermissionCopyModeType filePermissionCopyMode = filePermissionCopyModeInternal; - Boolean ignoreReadOnlyInternal = null; - if (copyFileSmbInfo != null) { - ignoreReadOnlyInternal = copyFileSmbInfo.isIgnoreReadOnly(); - } - Boolean ignoreReadOnly = ignoreReadOnlyInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - Boolean setArchiveAttributeInternal = null; - if (copyFileSmbInfo != null) { - setArchiveAttributeInternal = copyFileSmbInfo.isSetArchiveAttribute(); - } - Boolean setArchiveAttribute = setArchiveAttributeInternal; - return service - .startCopyNoCustomHeaders(this.client.getUrl(), shareName, fileName, timeout, this.client.getVersion(), - metadata, copySource, filePermission, filePermissionFormat, filePermissionKey, filePermissionCopyMode, - ignoreReadOnly, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, - setArchiveAttribute, leaseId, this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), - this.client.getFileRequestIntent(), owner, group, fileMode, fileModeCopyMode, fileOwnerCopyMode, accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase startCopyWithResponse(String shareName, String fileName, - String copySource, Integer timeout, Map metadata, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, String leaseId, String owner, String group, - String fileMode, ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, - CopyFileSmbInfo copyFileSmbInfo, Context context) { - try { - final String accept = "application/xml"; - PermissionCopyModeType filePermissionCopyModeInternal = null; - if (copyFileSmbInfo != null) { - filePermissionCopyModeInternal = copyFileSmbInfo.getFilePermissionCopyMode(); - } - PermissionCopyModeType filePermissionCopyMode = filePermissionCopyModeInternal; - Boolean ignoreReadOnlyInternal = null; - if (copyFileSmbInfo != null) { - ignoreReadOnlyInternal = copyFileSmbInfo.isIgnoreReadOnly(); - } - Boolean ignoreReadOnly = ignoreReadOnlyInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - Boolean setArchiveAttributeInternal = null; - if (copyFileSmbInfo != null) { - setArchiveAttributeInternal = copyFileSmbInfo.isSetArchiveAttribute(); - } - Boolean setArchiveAttribute = setArchiveAttributeInternal; - return service.startCopySync(this.client.getUrl(), shareName, fileName, timeout, this.client.getVersion(), - metadata, copySource, filePermission, filePermissionFormat, filePermissionKey, filePermissionCopyMode, - ignoreReadOnly, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, - setArchiveAttribute, leaseId, this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), - this.client.getFileRequestIntent(), owner, group, fileMode, fileModeCopyMode, fileOwnerCopyMode, accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void startCopy(String shareName, String fileName, String copySource, Integer timeout, - Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String leaseId, String owner, String group, String fileMode, - ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, CopyFileSmbInfo copyFileSmbInfo) { - startCopyWithResponse(shareName, fileName, copySource, timeout, metadata, filePermission, filePermissionFormat, - filePermissionKey, leaseId, owner, group, fileMode, fileModeCopyMode, fileOwnerCopyMode, copyFileSmbInfo, - Context.NONE); - } - - /** - * Copies a blob or file to a destination file within the storage account. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. To copy a file to another - * file within the same storage account, you may use Shared Key to authenticate the source file. If you are copying - * a file from another storage account, or if you are copying a blob from the same storage account or another - * storage account, then you must authenticate the source file or blob using a shared access signature. If the - * source is a public blob, no authentication is required to perform the copy operation. A file in a share snapshot - * can also be specified as a copy source. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param fileMode Optional, NFS only. The file mode of the file or directory. - * @param fileModeCopyMode NFS only. Applicable only when the copy source is a File. Determines the copy behavior of - * the mode bits of the file. source: The mode on the destination file is copied from the source file. override: The - * mode on the destination file is determined via the x-ms-mode header. - * @param fileOwnerCopyMode NFS only. Determines the copy behavior of the owner user identifier (UID) and group - * identifier (GID) of the file. source: The owner user identifier (UID) and group identifier (GID) on the - * destination file is copied from the source file. override: The owner user identifier (UID) and group identifier - * (GID) on the destination file is determined via the x-ms-owner and x-ms-group headers. - * @param copyFileSmbInfo Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response startCopyNoCustomHeadersWithResponse(String shareName, String fileName, String copySource, - Integer timeout, Map metadata, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, String leaseId, String owner, String group, String fileMode, - ModeCopyMode fileModeCopyMode, OwnerCopyMode fileOwnerCopyMode, CopyFileSmbInfo copyFileSmbInfo, - Context context) { - try { - final String accept = "application/xml"; - PermissionCopyModeType filePermissionCopyModeInternal = null; - if (copyFileSmbInfo != null) { - filePermissionCopyModeInternal = copyFileSmbInfo.getFilePermissionCopyMode(); - } - PermissionCopyModeType filePermissionCopyMode = filePermissionCopyModeInternal; - Boolean ignoreReadOnlyInternal = null; - if (copyFileSmbInfo != null) { - ignoreReadOnlyInternal = copyFileSmbInfo.isIgnoreReadOnly(); - } - Boolean ignoreReadOnly = ignoreReadOnlyInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - Boolean setArchiveAttributeInternal = null; - if (copyFileSmbInfo != null) { - setArchiveAttributeInternal = copyFileSmbInfo.isSetArchiveAttribute(); - } - Boolean setArchiveAttribute = setArchiveAttributeInternal; - return service.startCopyNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, timeout, - this.client.getVersion(), metadata, copySource, filePermission, filePermissionFormat, filePermissionKey, - filePermissionCopyMode, ignoreReadOnly, fileAttributes, fileCreationTime, fileLastWriteTime, - fileChangeTime, setArchiveAttribute, leaseId, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), owner, group, fileMode, - fileModeCopyMode, fileOwnerCopyMode, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> abortCopyWithResponseAsync(String shareName, String fileName, - String copyId, Integer timeout, String leaseId) { - return FluxUtil - .withContext(context -> abortCopyWithResponseAsync(shareName, fileName, copyId, timeout, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> abortCopyWithResponseAsync(String shareName, String fileName, - String copyId, Integer timeout, String leaseId, Context context) { - final String comp = "copy"; - final String copyActionAbortConstant = "abort"; - final String accept = "application/xml"; - return service - .abortCopy(this.client.getUrl(), shareName, fileName, comp, copyId, timeout, copyActionAbortConstant, - this.client.getVersion(), leaseId, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), - accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono abortCopyAsync(String shareName, String fileName, String copyId, Integer timeout, - String leaseId) { - return abortCopyWithResponseAsync(shareName, fileName, copyId, timeout, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono abortCopyAsync(String shareName, String fileName, String copyId, Integer timeout, String leaseId, - Context context) { - return abortCopyWithResponseAsync(shareName, fileName, copyId, timeout, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> abortCopyNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String copyId, Integer timeout, String leaseId) { - return FluxUtil - .withContext(context -> abortCopyNoCustomHeadersWithResponseAsync(shareName, fileName, copyId, timeout, - leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> abortCopyNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String copyId, Integer timeout, String leaseId, Context context) { - final String comp = "copy"; - final String copyActionAbortConstant = "abort"; - final String accept = "application/xml"; - return service - .abortCopyNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, copyId, timeout, - copyActionAbortConstant, this.client.getVersion(), leaseId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase abortCopyWithResponse(String shareName, String fileName, - String copyId, Integer timeout, String leaseId, Context context) { - try { - final String comp = "copy"; - final String copyActionAbortConstant = "abort"; - final String accept = "application/xml"; - return service.abortCopySync(this.client.getUrl(), shareName, fileName, comp, copyId, timeout, - copyActionAbortConstant, this.client.getVersion(), leaseId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void abortCopy(String shareName, String fileName, String copyId, Integer timeout, String leaseId) { - abortCopyWithResponse(shareName, fileName, copyId, timeout, leaseId, Context.NONE); - } - - /** - * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param copyId The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response abortCopyNoCustomHeadersWithResponse(String shareName, String fileName, String copyId, - Integer timeout, String leaseId, Context context) { - try { - final String comp = "copy"; - final String copyActionAbortConstant = "abort"; - final String accept = "application/xml"; - return service.abortCopyNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, copyId, - timeout, copyActionAbortConstant, this.client.getVersion(), leaseId, this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listHandlesWithResponseAsync( - String shareName, String fileName, String marker, Integer maxresults, Integer timeout, String sharesnapshot) { - return FluxUtil - .withContext(context -> listHandlesWithResponseAsync(shareName, fileName, marker, maxresults, timeout, - sharesnapshot, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listHandlesWithResponseAsync( - String shareName, String fileName, String marker, Integer maxresults, Integer timeout, String sharesnapshot, - Context context) { - final String comp = "listhandles"; - final String accept = "application/xml"; - return service - .listHandles(this.client.getUrl(), shareName, fileName, comp, marker, maxresults, timeout, sharesnapshot, - this.client.getVersion(), this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono listHandlesAsync(String shareName, String fileName, String marker, - Integer maxresults, Integer timeout, String sharesnapshot) { - return listHandlesWithResponseAsync(shareName, fileName, marker, maxresults, timeout, sharesnapshot) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono listHandlesAsync(String shareName, String fileName, String marker, - Integer maxresults, Integer timeout, String sharesnapshot, Context context) { - return listHandlesWithResponseAsync(shareName, fileName, marker, maxresults, timeout, sharesnapshot, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listHandlesNoCustomHeadersWithResponseAsync(String shareName, - String fileName, String marker, Integer maxresults, Integer timeout, String sharesnapshot) { - return FluxUtil - .withContext(context -> listHandlesNoCustomHeadersWithResponseAsync(shareName, fileName, marker, maxresults, - timeout, sharesnapshot, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listHandlesNoCustomHeadersWithResponseAsync(String shareName, - String fileName, String marker, Integer maxresults, Integer timeout, String sharesnapshot, Context context) { - final String comp = "listhandles"; - final String accept = "application/xml"; - return service - .listHandlesNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, marker, maxresults, timeout, - sharesnapshot, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase listHandlesWithResponse(String shareName, - String fileName, String marker, Integer maxresults, Integer timeout, String sharesnapshot, Context context) { - try { - final String comp = "listhandles"; - final String accept = "application/xml"; - return service.listHandlesSync(this.client.getUrl(), shareName, fileName, comp, marker, maxresults, timeout, - sharesnapshot, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ListHandlesResponse listHandles(String shareName, String fileName, String marker, Integer maxresults, - Integer timeout, String sharesnapshot) { - try { - return listHandlesWithResponse(shareName, fileName, marker, maxresults, timeout, sharesnapshot, - Context.NONE).getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Lists handles for file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of handles along with {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response listHandlesNoCustomHeadersWithResponse(String shareName, String fileName, - String marker, Integer maxresults, Integer timeout, String sharesnapshot, Context context) { - try { - final String comp = "listhandles"; - final String accept = "application/xml"; - return service.listHandlesNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, marker, - maxresults, timeout, sharesnapshot, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> forceCloseHandlesWithResponseAsync(String shareName, - String fileName, String handleId, Integer timeout, String marker, String sharesnapshot) { - return FluxUtil - .withContext(context -> forceCloseHandlesWithResponseAsync(shareName, fileName, handleId, timeout, marker, - sharesnapshot, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> forceCloseHandlesWithResponseAsync(String shareName, - String fileName, String handleId, Integer timeout, String marker, String sharesnapshot, Context context) { - final String comp = "forceclosehandles"; - final String accept = "application/xml"; - return service - .forceCloseHandles(this.client.getUrl(), shareName, fileName, comp, timeout, marker, sharesnapshot, - handleId, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono forceCloseHandlesAsync(String shareName, String fileName, String handleId, Integer timeout, - String marker, String sharesnapshot) { - return forceCloseHandlesWithResponseAsync(shareName, fileName, handleId, timeout, marker, sharesnapshot) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono forceCloseHandlesAsync(String shareName, String fileName, String handleId, Integer timeout, - String marker, String sharesnapshot, Context context) { - return forceCloseHandlesWithResponseAsync(shareName, fileName, handleId, timeout, marker, sharesnapshot, - context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> forceCloseHandlesNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String handleId, Integer timeout, String marker, String sharesnapshot) { + public Mono> deleteWithResponseAsync(RequestOptions requestOptions) { return FluxUtil - .withContext(context -> forceCloseHandlesNoCustomHeadersWithResponseAsync(shareName, fileName, handleId, - timeout, marker, sharesnapshot, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> forceCloseHandlesNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String handleId, Integer timeout, String marker, String sharesnapshot, Context context) { - final String comp = "forceclosehandles"; - final String accept = "application/xml"; - return service - .forceCloseHandlesNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, timeout, marker, - sharesnapshot, handleId, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase forceCloseHandlesWithResponse(String shareName, - String fileName, String handleId, Integer timeout, String marker, String sharesnapshot, Context context) { - try { - final String comp = "forceclosehandles"; - final String accept = "application/xml"; - return service.forceCloseHandlesSync(this.client.getUrl(), shareName, fileName, comp, timeout, marker, - sharesnapshot, handleId, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void forceCloseHandles(String shareName, String fileName, String handleId, Integer timeout, String marker, - String sharesnapshot) { - forceCloseHandlesWithResponse(shareName, fileName, handleId, timeout, marker, sharesnapshot, Context.NONE); - } - - /** - * Closes all handles open for given file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk (‘*’) is a wildcard - * that specifies all handles. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response forceCloseHandlesNoCustomHeadersWithResponse(String shareName, String fileName, - String handleId, Integer timeout, String marker, String sharesnapshot, Context context) { - try { - final String comp = "forceclosehandles"; - final String accept = "application/xml"; - return service.forceCloseHandlesNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, - timeout, marker, sharesnapshot, handleId, this.client.getVersion(), this.client.isAllowTrailingDot(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renameWithResponseAsync(String shareName, String fileName, - String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders) { - return FluxUtil.withContext(context -> renameWithResponseAsync(shareName, fileName, renameSource, timeout, - replaceIfExists, ignoreReadOnly, filePermission, filePermissionFormat, filePermissionKey, metadata, - sourceLeaseAccessConditions, destinationLeaseAccessConditions, copyFileSmbInfo, shareFileHttpHeaders, - context)).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renameWithResponseAsync(String shareName, String fileName, - String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders, Context context) { - final String comp = "rename"; - final String accept = "application/xml"; - String sourceLeaseIdInternal = null; - if (sourceLeaseAccessConditions != null) { - sourceLeaseIdInternal = sourceLeaseAccessConditions.getSourceLeaseId(); - } - String sourceLeaseId = sourceLeaseIdInternal; - String destinationLeaseIdInternal = null; - if (destinationLeaseAccessConditions != null) { - destinationLeaseIdInternal = destinationLeaseAccessConditions.getDestinationLeaseId(); - } - String destinationLeaseId = destinationLeaseIdInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - return service - .rename(this.client.getUrl(), shareName, fileName, comp, timeout, this.client.getVersion(), renameSource, - replaceIfExists, ignoreReadOnly, sourceLeaseId, destinationLeaseId, fileAttributes, fileCreationTime, - fileLastWriteTime, fileChangeTime, filePermission, filePermissionFormat, filePermissionKey, metadata, - contentType, this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono renameAsync(String shareName, String fileName, String renameSource, Integer timeout, - Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders) { - return renameWithResponseAsync(shareName, fileName, renameSource, timeout, replaceIfExists, ignoreReadOnly, - filePermission, filePermissionFormat, filePermissionKey, metadata, sourceLeaseAccessConditions, - destinationLeaseAccessConditions, copyFileSmbInfo, shareFileHttpHeaders) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + .withContext(context -> service.delete(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Removes the file from the storage account. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono renameAsync(String shareName, String fileName, String renameSource, Integer timeout, - Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders, Context context) { - return renameWithResponseAsync(shareName, fileName, renameSource, timeout, replaceIfExists, ignoreReadOnly, - filePermission, filePermissionFormat, filePermissionKey, metadata, sourceLeaseAccessConditions, - destinationLeaseAccessConditions, copyFileSmbInfo, shareFileHttpHeaders, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + public Response deleteWithResponse(RequestOptions requestOptions) { + try { + return service.deleteSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Sets HTTP headers on a file. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-content-lengthLongNoSpecifies the number of bytes being + * transmitted.
x-ms-content-typeStringNoSets the MIME content type of the file. The default + * type is 'application/octet-stream'.
x-ms-content-encodingStringNoSpecifies which content encodings have been + * applied to the file.
x-ms-content-languageStringNoSpecifies the natural languages used by this + * resource.
x-ms-cache-controlStringNoSets the file's cache control. The File service + * stores this value but does not use or modify it.
x-ms-content-md5byte[]NoAn MD5 hash of the file content. This hash is used to + * verify the integrity of the file during transport.
x-ms-content-dispositionStringNoSets the file's Content-Disposition + * header.
x-ms-file-permissionStringNoIf specified the permission (security descriptor) + * shall be set for the directory/file. This header can be used if Permission size is <= 8KB, else + * x-ms-file-permission-key header shall be used. Default value: Inherit. If SDDL is specified as input, it must + * have owner, group and dacl. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-permission-keyStringNoKey of the permission to be set for the + * directory/file. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set. Default value: 'Archive' for file and 'Directory' for directory. 'None' can also be specified as + * default.
x-ms-file-creation-timeStringNoCreation time for the file/directory. Default + * value: Now.
x-ms-file-last-write-timeStringNoLast write time for the file/directory. + * Default value: Now.
x-ms-file-change-timeStringNoChange time for the file/directory. Default + * value: Now.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renameNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders) { - return FluxUtil.withContext(context -> renameNoCustomHeadersWithResponseAsync(shareName, fileName, renameSource, - timeout, replaceIfExists, ignoreReadOnly, filePermission, filePermissionFormat, filePermissionKey, metadata, - sourceLeaseAccessConditions, destinationLeaseAccessConditions, copyFileSmbInfo, shareFileHttpHeaders, - context)).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. + public Mono> setHttpHeadersWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext( + context -> service.setHttpHeaders(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Sets HTTP headers on a file. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-content-lengthLongNoSpecifies the number of bytes being + * transmitted.
x-ms-content-typeStringNoSets the MIME content type of the file. The default + * type is 'application/octet-stream'.
x-ms-content-encodingStringNoSpecifies which content encodings have been + * applied to the file.
x-ms-content-languageStringNoSpecifies the natural languages used by this + * resource.
x-ms-cache-controlStringNoSets the file's cache control. The File service + * stores this value but does not use or modify it.
x-ms-content-md5byte[]NoAn MD5 hash of the file content. This hash is used to + * verify the integrity of the file during transport.
x-ms-content-dispositionStringNoSets the file's Content-Disposition + * header.
x-ms-file-permissionStringNoIf specified the permission (security descriptor) + * shall be set for the directory/file. This header can be used if Permission size is <= 8KB, else + * x-ms-file-permission-key header shall be used. Default value: Inherit. If SDDL is specified as input, it must + * have owner, group and dacl. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-permission-keyStringNoKey of the permission to be set for the + * directory/file. Note: Only one of the x-ms-file-permission or x-ms-file-permission-key should be + * specified.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set. Default value: 'Archive' for file and 'Directory' for directory. 'None' can also be specified as + * default.
x-ms-file-creation-timeStringNoCreation time for the file/directory. Default + * value: Now.
x-ms-file-last-write-timeStringNoLast write time for the file/directory. + * Default value: Now.
x-ms-file-change-timeStringNoChange time for the file/directory. Default + * value: Now.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renameNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders, Context context) { - final String comp = "rename"; - final String accept = "application/xml"; - String sourceLeaseIdInternal = null; - if (sourceLeaseAccessConditions != null) { - sourceLeaseIdInternal = sourceLeaseAccessConditions.getSourceLeaseId(); - } - String sourceLeaseId = sourceLeaseIdInternal; - String destinationLeaseIdInternal = null; - if (destinationLeaseAccessConditions != null) { - destinationLeaseIdInternal = destinationLeaseAccessConditions.getDestinationLeaseId(); - } - String destinationLeaseId = destinationLeaseIdInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); + public Response setHttpHeadersWithResponse(RequestOptions requestOptions) { + try { + return service.setHttpHeadersSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); } - String contentType = contentTypeInternal; - return service - .renameNoCustomHeaders(this.client.getUrl(), shareName, fileName, comp, timeout, this.client.getVersion(), - renameSource, replaceIfExists, ignoreReadOnly, sourceLeaseId, destinationLeaseId, fileAttributes, - fileCreationTime, fileLastWriteTime, fileChangeTime, filePermission, filePermissionFormat, - filePermissionKey, metadata, contentType, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * Sets one or more user-defined name-value pairs for the specified file. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + public Mono> setMetadataWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext( + context -> service.setMetadata(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Sets one or more user-defined name-value pairs for the specified file. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase renameWithResponse(String shareName, String fileName, - String renameSource, Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders, Context context) { + public Response setMetadataWithResponse(RequestOptions requestOptions) { try { - final String comp = "rename"; - final String accept = "application/xml"; - String sourceLeaseIdInternal = null; - if (sourceLeaseAccessConditions != null) { - sourceLeaseIdInternal = sourceLeaseAccessConditions.getSourceLeaseId(); - } - String sourceLeaseId = sourceLeaseIdInternal; - String destinationLeaseIdInternal = null; - if (destinationLeaseAccessConditions != null) { - destinationLeaseIdInternal = destinationLeaseAccessConditions.getDestinationLeaseId(); - } - String destinationLeaseId = destinationLeaseIdInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - return service.renameSync(this.client.getUrl(), shareName, fileName, comp, timeout, - this.client.getVersion(), renameSource, replaceIfExists, ignoreReadOnly, sourceLeaseId, - destinationLeaseId, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, filePermission, - filePermissionFormat, filePermissionKey, metadata, contentType, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context); + return service.setMetadataSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * The Lease File operation establishes and manages a lock on a file for write and delete operations. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-durationIntegerNoSpecifies the duration of the lease, in seconds, + * or negative one (-1) for a lease that never expires. A non-infinite lease can be between 15 and 60 seconds. A + * lease duration cannot be changed using renew or change.
x-ms-proposed-lease-idStringNoProposed lease ID, in a GUID string format. The + * File service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid + * Constructor (String) for a list of valid GUID string formats.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void rename(String shareName, String fileName, String renameSource, Integer timeout, Boolean replaceIfExists, - Boolean ignoreReadOnly, String filePermission, FilePermissionFormat filePermissionFormat, - String filePermissionKey, Map metadata, SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders) { - renameWithResponse(shareName, fileName, renameSource, timeout, replaceIfExists, ignoreReadOnly, filePermission, - filePermissionFormat, filePermissionKey, metadata, sourceLeaseAccessConditions, - destinationLeaseAccessConditions, copyFileSmbInfo, shareFileHttpHeaders, Context.NONE); - } - - /** - * Renames a file. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param replaceIfExists Optional. A boolean value for if the destination file already exists, whether this request - * will overwrite the file or not. If true, the rename will succeed and will overwrite the destination file. If not - * provided or if false and the destination file does exist, the request will not overwrite the destination file. If - * provided and the destination file doesn’t exist, the rename will succeed. Note: This value does not override the - * x-ms-file-copy-ignore-read-only header value. - * @param ignoreReadOnly Optional. A boolean value that specifies whether the ReadOnly attribute on a preexisting - * destination file should be respected. If true, the rename will succeed, otherwise, a previous file at the - * destination with the ReadOnly attribute set will cause the rename to fail. - * @param filePermission If specified the permission (security descriptor) shall be set for the directory/file. This - * header can be used if Permission size is <= 8KB, else x-ms-file-permission-key header shall be used. Default - * value: Inherit. If SDDL is specified as input, it must have owner, group and dacl. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the - * x-ms-file-permission or x-ms-file-permission-key should be specified. - * @param metadata A name-value pair to associate with a file storage object. - * @param sourceLeaseAccessConditions Parameter group. - * @param destinationLeaseAccessConditions Parameter group. - * @param copyFileSmbInfo Parameter group. - * @param shareFileHttpHeaders Parameter group. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + public Mono> acquireLeaseWithResponseAsync(RequestOptions requestOptions) { + final String action = "acquire"; + return FluxUtil + .withContext(context -> service.acquireLease(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), action, this.client.getFileRequestIntent(), + this.client.isAllowTrailingDot(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * The Lease File operation establishes and manages a lock on a file for write and delete operations. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-durationIntegerNoSpecifies the duration of the lease, in seconds, + * or negative one (-1) for a lease that never expires. A non-infinite lease can be between 15 and 60 seconds. A + * lease duration cannot be changed using renew or change.
x-ms-proposed-lease-idStringNoProposed lease ID, in a GUID string format. The + * File service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid + * Constructor (String) for a list of valid GUID string formats.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response renameNoCustomHeadersWithResponse(String shareName, String fileName, String renameSource, - Integer timeout, Boolean replaceIfExists, Boolean ignoreReadOnly, String filePermission, - FilePermissionFormat filePermissionFormat, String filePermissionKey, Map metadata, - SourceLeaseAccessConditions sourceLeaseAccessConditions, - DestinationLeaseAccessConditions destinationLeaseAccessConditions, CopyFileSmbInfo copyFileSmbInfo, - ShareFileHttpHeaders shareFileHttpHeaders, Context context) { + public Response acquireLeaseWithResponse(RequestOptions requestOptions) { try { - final String comp = "rename"; - final String accept = "application/xml"; - String sourceLeaseIdInternal = null; - if (sourceLeaseAccessConditions != null) { - sourceLeaseIdInternal = sourceLeaseAccessConditions.getSourceLeaseId(); - } - String sourceLeaseId = sourceLeaseIdInternal; - String destinationLeaseIdInternal = null; - if (destinationLeaseAccessConditions != null) { - destinationLeaseIdInternal = destinationLeaseAccessConditions.getDestinationLeaseId(); - } - String destinationLeaseId = destinationLeaseIdInternal; - String fileAttributesInternal = null; - if (copyFileSmbInfo != null) { - fileAttributesInternal = copyFileSmbInfo.getFileAttributes(); - } - String fileAttributes = fileAttributesInternal; - String fileCreationTimeInternal = null; - if (copyFileSmbInfo != null) { - fileCreationTimeInternal = copyFileSmbInfo.getFileCreationTime(); - } - String fileCreationTime = fileCreationTimeInternal; - String fileLastWriteTimeInternal = null; - if (copyFileSmbInfo != null) { - fileLastWriteTimeInternal = copyFileSmbInfo.getFileLastWriteTime(); - } - String fileLastWriteTime = fileLastWriteTimeInternal; - String fileChangeTimeInternal = null; - if (copyFileSmbInfo != null) { - fileChangeTimeInternal = copyFileSmbInfo.getFileChangeTime(); - } - String fileChangeTime = fileChangeTimeInternal; - String contentTypeInternal = null; - if (shareFileHttpHeaders != null) { - contentTypeInternal = shareFileHttpHeaders.getContentType(); - } - String contentType = contentTypeInternal; - return service.renameNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, comp, timeout, - this.client.getVersion(), renameSource, replaceIfExists, ignoreReadOnly, sourceLeaseId, - destinationLeaseId, fileAttributes, fileCreationTime, fileLastWriteTime, fileChangeTime, filePermission, - filePermissionFormat, filePermissionKey, metadata, contentType, this.client.isAllowTrailingDot(), - this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), accept, context); + final String action = "acquire"; + return service.acquireLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), action, + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Creates a symbolic link. + * The Lease File operation establishes and manages a lock on a file for write and delete operations. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createSymbolicLinkWithResponseAsync( - String shareName, String fileName, String linkText, Integer timeout, Map metadata, - String fileCreationTime, String fileLastWriteTime, String requestId, String leaseId, String owner, - String group) { + public Mono> releaseLeaseWithResponseAsync(String leaseId, RequestOptions requestOptions) { + final String action = "release"; return FluxUtil - .withContext(context -> createSymbolicLinkWithResponseAsync(shareName, fileName, linkText, timeout, - metadata, fileCreationTime, fileLastWriteTime, requestId, leaseId, owner, group, context)) + .withContext(context -> service.releaseLease(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), leaseId, action, this.client.getFileRequestIntent(), + this.client.isAllowTrailingDot(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Creates a symbolic link. + * The Lease File operation establishes and manages a lock on a file for write and delete operations. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createSymbolicLinkWithResponseAsync( - String shareName, String fileName, String linkText, Integer timeout, Map metadata, - String fileCreationTime, String fileLastWriteTime, String requestId, String leaseId, String owner, String group, - Context context) { - final String restype = "symboliclink"; - final String accept = "application/xml"; - return service - .createSymbolicLink(this.client.getUrl(), shareName, fileName, restype, timeout, this.client.getVersion(), - metadata, fileCreationTime, fileLastWriteTime, requestId, leaseId, owner, group, linkText, - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + public Response releaseLeaseWithResponse(String leaseId, RequestOptions requestOptions) { + try { + final String action = "release"; + return service.releaseLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), leaseId, + action, this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, + Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Creates a symbolic link. + * The Lease File operation establishes and manages a lock on a file for write and delete operations. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-proposed-lease-idStringNoProposed lease ID, in a GUID string format. The + * File service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid + * Constructor (String) for a list of valid GUID string formats.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createSymbolicLinkAsync(String shareName, String fileName, String linkText, Integer timeout, - Map metadata, String fileCreationTime, String fileLastWriteTime, String requestId, - String leaseId, String owner, String group) { - return createSymbolicLinkWithResponseAsync(shareName, fileName, linkText, timeout, metadata, fileCreationTime, - fileLastWriteTime, requestId, leaseId, owner, group) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a symbolic link. + public Mono> changeLeaseWithResponseAsync(String leaseId, RequestOptions requestOptions) { + final String action = "change"; + return FluxUtil + .withContext(context -> service.changeLease(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), leaseId, action, this.client.getFileRequestIntent(), + this.client.isAllowTrailingDot(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * The Lease File operation establishes and manages a lock on a file for write and delete operations. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-proposed-lease-idStringNoProposed lease ID, in a GUID string format. The + * File service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid + * Constructor (String) for a list of valid GUID string formats.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createSymbolicLinkAsync(String shareName, String fileName, String linkText, Integer timeout, - Map metadata, String fileCreationTime, String fileLastWriteTime, String requestId, - String leaseId, String owner, String group, Context context) { - return createSymbolicLinkWithResponseAsync(shareName, fileName, linkText, timeout, metadata, fileCreationTime, - fileLastWriteTime, requestId, leaseId, owner, group, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + public Response changeLeaseWithResponse(String leaseId, RequestOptions requestOptions) { + try { + final String action = "change"; + return service.changeLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), leaseId, + action, this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, + Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Creates a symbolic link. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * The Lease File operation establishes and manages a lock on a file for write and delete operations. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createSymbolicLinkNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String linkText, Integer timeout, Map metadata, String fileCreationTime, - String fileLastWriteTime, String requestId, String leaseId, String owner, String group) { + public Mono> breakLeaseWithResponseAsync(RequestOptions requestOptions) { + final String action = "break"; return FluxUtil - .withContext(context -> createSymbolicLinkNoCustomHeadersWithResponseAsync(shareName, fileName, linkText, - timeout, metadata, fileCreationTime, fileLastWriteTime, requestId, leaseId, owner, group, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + .withContext(context -> service.breakLease(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), action, this.client.getFileRequestIntent(), + this.client.isAllowTrailingDot(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * The Lease File operation establishes and manages a lock on a file for write and delete operations. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + public Response breakLeaseWithResponse(RequestOptions requestOptions) { + try { + final String action = "break"; + return service.breakLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), action, + this.client.getFileRequestIntent(), this.client.isAllowTrailingDot(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Creates a symbolic link. + * Upload a range of bytes to a file. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
Content-TypeStringNoThe content type. Allowed values: + * "application/octet-stream".
Content-MD5byte[]NoAn MD5 hash of the content. This hash is used to verify the + * integrity of the data during transport.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-file-last-write-timeStringNoIf the file last write time should be + * preserved or overwritten. Allowed values: "Now", "Preserve".
x-ms-structured-bodyStringNoSpecifies the response content should be returned + * as a structured message and specifies the message schema version and properties.
x-ms-structured-content-lengthLongNoRequired if the request body is a + * structured message. Specifies the length of the blob/file content inside the message body. Will always be smaller + * than Content-Length.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Request Body Schema

+ * + * 
+     * {@code
+     * BinaryData
+     * }
+     *
* - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. + * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request + * body into the specified range. - Clear: Clears the specified range and releases the space used in storage for + * that range. Allowed values: "update", "clear". + * @param contentLength The number of bytes being transmitted in the request body. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createSymbolicLinkNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String linkText, Integer timeout, Map metadata, String fileCreationTime, - String fileLastWriteTime, String requestId, String leaseId, String owner, String group, Context context) { - final String restype = "symboliclink"; - final String accept = "application/xml"; - return service - .createSymbolicLinkNoCustomHeaders(this.client.getUrl(), shareName, fileName, restype, timeout, - this.client.getVersion(), metadata, fileCreationTime, fileLastWriteTime, requestId, leaseId, owner, - group, linkText, this.client.getFileRequestIntent(), accept, context) + public Mono> uploadRangeWithResponseAsync(String range, String fileRangeWrite, long contentLength, + RequestOptions requestOptions) { + RequestOptions requestOptionsLocal = requestOptions == null ? new RequestOptions() : requestOptions; + requestOptionsLocal.addRequestCallback(requestLocal -> { + if (requestLocal.getBody() != null && requestLocal.getHeaders().get(HttpHeaderName.CONTENT_TYPE) == null) { + requestLocal.getHeaders().set(HttpHeaderName.CONTENT_TYPE, "application/octet-stream"); + } + }); + return FluxUtil + .withContext(context -> service.uploadRange(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), range, fileRangeWrite, contentLength, + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptionsLocal, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Creates a symbolic link. + * Upload a range of bytes to a file. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
Content-TypeStringNoThe content type. Allowed values: + * "application/octet-stream".
Content-MD5byte[]NoAn MD5 hash of the content. This hash is used to verify the + * integrity of the data during transport.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-file-last-write-timeStringNoIf the file last write time should be + * preserved or overwritten. Allowed values: "Now", "Preserve".
x-ms-structured-bodyStringNoSpecifies the response content should be returned + * as a structured message and specifies the message schema version and properties.
x-ms-structured-content-lengthLongNoRequired if the request body is a + * structured message. Specifies the length of the blob/file content inside the message body. Will always be smaller + * than Content-Length.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Request Body Schema

+ * + * 
+     * {@code
+     * BinaryData
+     * }
+     *
* - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. + * @param fileRangeWrite Specify one of the following options: - Update: Writes the bytes specified by the request + * body into the specified range. - Clear: Clears the specified range and releases the space used in storage for + * that range. Allowed values: "update", "clear". + * @param contentLength The number of bytes being transmitted in the request body. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase createSymbolicLinkWithResponse(String shareName, - String fileName, String linkText, Integer timeout, Map metadata, String fileCreationTime, - String fileLastWriteTime, String requestId, String leaseId, String owner, String group, Context context) { + public Response uploadRangeWithResponse(String range, String fileRangeWrite, long contentLength, + RequestOptions requestOptions) { try { - final String restype = "symboliclink"; - final String accept = "application/xml"; - return service.createSymbolicLinkSync(this.client.getUrl(), shareName, fileName, restype, timeout, - this.client.getVersion(), metadata, fileCreationTime, fileLastWriteTime, requestId, leaseId, owner, - group, linkText, this.client.getFileRequestIntent(), accept, context); + RequestOptions requestOptionsLocal = requestOptions == null ? new RequestOptions() : requestOptions; + requestOptionsLocal.addRequestCallback(requestLocal -> { + if (requestLocal.getBody() != null + && requestLocal.getHeaders().get(HttpHeaderName.CONTENT_TYPE) == null) { + requestLocal.getHeaders().set(HttpHeaderName.CONTENT_TYPE, "application/octet-stream"); + } + }); + return service.uploadRangeSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), range, + fileRangeWrite, contentLength, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), + requestOptionsLocal, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Creates a symbolic link. + * Upload a range of bytes to a file where the contents are read from a URL. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-source-rangeStringNoBytes of source data in the specified + * range.
x-ms-source-content-crc64byte[]NoSpecify the CRC64 hash of the source + * content.
x-ms-source-if-match-crc64byte[]NoSpecify the CRC64 hash value to check for + * source content integrity.
x-ms-source-if-none-match-crc64byte[]NoSpecify the CRC64 hash value to check + * for source content mismatch.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-copy-source-authorizationStringNoOnly Bearer type is supported. + * Credentials should be a valid OAuth access token to copy source.
x-ms-file-last-write-timeStringNoIf the file last write time should be + * preserved or overwritten. Allowed values: "Now", "Preserve".
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. + * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. + * @param fileRangeWriteFromUrl Only update is supported. Allowed values: "update". + * @param contentLength The number of bytes being transmitted in the request body. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void createSymbolicLink(String shareName, String fileName, String linkText, Integer timeout, - Map metadata, String fileCreationTime, String fileLastWriteTime, String requestId, - String leaseId, String owner, String group) { - createSymbolicLinkWithResponse(shareName, fileName, linkText, timeout, metadata, fileCreationTime, - fileLastWriteTime, requestId, leaseId, owner, group, Context.NONE); + public Mono> uploadRangeFromUrlWithResponseAsync(String range, String copySource, + String fileRangeWriteFromUrl, long contentLength, RequestOptions requestOptions) { + return FluxUtil + .withContext(context -> service.uploadRangeFromUrl(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), range, copySource, fileRangeWriteFromUrl, contentLength, + this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), + this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Creates a symbolic link. + * Upload a range of bytes to a file where the contents are read from a URL. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-source-rangeStringNoBytes of source data in the specified + * range.
x-ms-source-content-crc64byte[]NoSpecify the CRC64 hash of the source + * content.
x-ms-source-if-match-crc64byte[]NoSpecify the CRC64 hash value to check for + * source content integrity.
x-ms-source-if-none-match-crc64byte[]NoSpecify the CRC64 hash value to check + * for source content mismatch.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-copy-source-authorizationStringNoOnly Bearer type is supported. + * Credentials should be a valid OAuth access token to copy source.
x-ms-file-last-write-timeStringNoIf the file last write time should be + * preserved or overwritten. Allowed values: "Now", "Preserve".
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param linkText NFS only. Required. The path to the original file, the symbolic link is pointing to. The path is - * of type string which is not resolved and is stored as is. The path can be absolute path or the relative path - * depending on the content stored in the symbolic link file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param fileCreationTime Creation time for the file/directory. Default value: Now. - * @param fileLastWriteTime Last write time for the file/directory. Default value: Now. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param owner Optional, NFS only. The owner of the file or directory. - * @param group Optional, NFS only. The owning group of the file or directory. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param range Specifies the range of bytes to be written. Both the start and end of the range must be specified. + * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. + * @param fileRangeWriteFromUrl Only update is supported. Allowed values: "update". + * @param contentLength The number of bytes being transmitted in the request body. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response createSymbolicLinkNoCustomHeadersWithResponse(String shareName, String fileName, - String linkText, Integer timeout, Map metadata, String fileCreationTime, - String fileLastWriteTime, String requestId, String leaseId, String owner, String group, Context context) { + public Response uploadRangeFromUrlWithResponse(String range, String copySource, String fileRangeWriteFromUrl, + long contentLength, RequestOptions requestOptions) { try { - final String restype = "symboliclink"; - final String accept = "application/xml"; - return service.createSymbolicLinkNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, restype, - timeout, this.client.getVersion(), metadata, fileCreationTime, fileLastWriteTime, requestId, leaseId, - owner, group, linkText, this.client.getFileRequestIntent(), accept, context); + return service.uploadRangeFromUrlSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + range, copySource, fileRangeWriteFromUrl, contentLength, this.client.isAllowTrailingDot(), + this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), requestOptions, + Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + * Returns the list of valid page ranges for a file or snapshot of a file. + *

Query Parameters

+ * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
prevsharesnapshotStringNoThe previous snapshot parameter is an opaque DateTime + * value that specifies a previous file snapshot to compare against.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
RangeStringNoReturn file data only from the specified byte range.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-file-support-renameBooleanNoThis header is allowed only when + * PrevShareSnapshot query parameter is set. Determines whether the changed ranges for a file that has been renamed + * or moved should be listed.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     Range (Optional): [
+     *          (Optional){
+     *             Start: long (Required)
+     *             End: long (Required)
+     *         }
+     *     ]
+     *     ClearRange (Optional): [
+     *          (Optional){
+     *             Start: long (Required)
+     *             End: long (Required)
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the list of file ranges along with {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getSymbolicLinkWithResponseAsync(String shareName, - String fileName, Integer timeout, String sharesnapshot, String requestId) { + public Mono> getRangeListWithResponseAsync(RequestOptions requestOptions) { + final String accept = "application/xml"; return FluxUtil - .withContext(context -> getSymbolicLinkWithResponseAsync(shareName, fileName, timeout, sharesnapshot, - requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + .withContext(context -> service.getRangeList(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), accept, requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Returns the list of valid page ranges for a file or snapshot of a file. + *

Query Parameters

+ * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
prevsharesnapshotStringNoThe previous snapshot parameter is an opaque DateTime + * value that specifies a previous file snapshot to compare against.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
RangeStringNoReturn file data only from the specified byte range.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-file-support-renameBooleanNoThis header is allowed only when + * PrevShareSnapshot query parameter is set. Determines whether the changed ranges for a file that has been renamed + * or moved should be listed.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     Range (Optional): [
+     *          (Optional){
+     *             Start: long (Required)
+     *             End: long (Required)
+     *         }
+     *     ]
+     *     ClearRange (Optional): [
+     *          (Optional){
+     *             Start: long (Required)
+     *             End: long (Required)
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the list of file ranges along with {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getSymbolicLinkWithResponseAsync(String shareName, - String fileName, Integer timeout, String sharesnapshot, String requestId, Context context) { - final String restype = "symboliclink"; - final String accept = "application/xml"; - return service - .getSymbolicLink(this.client.getUrl(), shareName, fileName, restype, timeout, sharesnapshot, - this.client.getVersion(), requestId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + public Response getRangeListWithResponse(RequestOptions requestOptions) { + try { + final String accept = "application/xml"; + return service.getRangeListSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions, + Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * Copies a blob or file to a destination file within the storage account. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-file-permissionStringNoIf specified the permission shall be set for the + * file.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-file-permission-keyStringNoKey of the permission to be set.
x-ms-file-permission-copy-modeStringNoSpecifies the option to copy file + * security descriptor from source file or to set it using the value which is defined by the header value of + * x-ms-file-permission or x-ms-file-permission-key. Allowed values: "source", "override".
x-ms-file-copy-ignore-readonlyBooleanNoA boolean value that specifies whether + * the ReadOnly attribute on a preexisting destination file should be respected or overridden.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set.
x-ms-file-creation-timeStringNoCreation time for the file.
x-ms-file-last-write-timeStringNoLast write time for the file.
x-ms-file-change-timeStringNoChange time for the file.
x-ms-file-copy-set-archiveBooleanNoOptional. Sets the archive attribute on the + * destination file.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
x-ms-file-mode-copy-modeStringNoSpecifies mode copy option for the file. + * Allowed values: "source", "override".
x-ms-file-owner-copy-modeStringNoSpecifies owner copy option for the file. + * Allowed values: "source", "override".
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getSymbolicLinkAsync(String shareName, String fileName, Integer timeout, String sharesnapshot, - String requestId) { - return getSymbolicLinkWithResponseAsync(shareName, fileName, timeout, sharesnapshot, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + public Mono> startCopyWithResponseAsync(String copySource, RequestOptions requestOptions) { + return FluxUtil + .withContext(context -> service.startCopy(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), copySource, this.client.isAllowTrailingDot(), + this.client.isAllowSourceTrailingDot(), this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * Copies a blob or file to a destination file within the storage account. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-file-permissionStringNoIf specified the permission shall be set for the + * file.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-file-permission-keyStringNoKey of the permission to be set.
x-ms-file-permission-copy-modeStringNoSpecifies the option to copy file + * security descriptor from source file or to set it using the value which is defined by the header value of + * x-ms-file-permission or x-ms-file-permission-key. Allowed values: "source", "override".
x-ms-file-copy-ignore-readonlyBooleanNoA boolean value that specifies whether + * the ReadOnly attribute on a preexisting destination file should be respected or overridden.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set.
x-ms-file-creation-timeStringNoCreation time for the file.
x-ms-file-last-write-timeStringNoLast write time for the file.
x-ms-file-change-timeStringNoChange time for the file.
x-ms-file-copy-set-archiveBooleanNoOptional. Sets the archive attribute on the + * destination file.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
x-ms-modeStringNoOptional, NFS only. The file mode of the file or + * directory.
x-ms-file-mode-copy-modeStringNoSpecifies mode copy option for the file. + * Allowed values: "source", "override".
x-ms-file-owner-copy-modeStringNoSpecifies owner copy option for the file. + * Allowed values: "source", "override".
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param copySource Specifies the URL of the source file or blob, up to 2 KB in length. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getSymbolicLinkAsync(String shareName, String fileName, Integer timeout, String sharesnapshot, - String requestId, Context context) { - return getSymbolicLinkWithResponseAsync(shareName, fileName, timeout, sharesnapshot, requestId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + public Response startCopyWithResponse(String copySource, RequestOptions requestOptions) { + try { + return service.startCopySync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), copySource, + this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param copyid The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getSymbolicLinkNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, String sharesnapshot, String requestId) { + public Mono> abortCopyWithResponseAsync(String copyid, RequestOptions requestOptions) { + final String copyActionAbortConstant = "abort"; return FluxUtil - .withContext(context -> getSymbolicLinkNoCustomHeadersWithResponseAsync(shareName, fileName, timeout, - sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getSymbolicLinkNoCustomHeadersWithResponseAsync(String shareName, String fileName, - Integer timeout, String sharesnapshot, String requestId, Context context) { - final String restype = "symboliclink"; - final String accept = "application/xml"; - return service - .getSymbolicLinkNoCustomHeaders(this.client.getUrl(), shareName, fileName, restype, timeout, sharesnapshot, - this.client.getVersion(), requestId, this.client.getFileRequestIntent(), accept, context) + .withContext(context -> service.abortCopy(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), copyActionAbortConstant, copyid, + this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * Aborts a pending Copy File operation, and leaves a destination file with zero length and full metadata. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param copyid The copy identifier provided in the x-ms-copy-id header of the original Copy File operation. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase getSymbolicLinkWithResponse(String shareName, - String fileName, Integer timeout, String sharesnapshot, String requestId, Context context) { + public Response abortCopyWithResponse(String copyid, RequestOptions requestOptions) { try { - final String restype = "symboliclink"; - final String accept = "application/xml"; - return service.getSymbolicLinkSync(this.client.getUrl(), shareName, fileName, restype, timeout, - sharesnapshot, this.client.getVersion(), requestId, this.client.getFileRequestIntent(), accept, - context); + final String copyActionAbortConstant = "abort"; + return service.abortCopySync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + copyActionAbortConstant, copyid, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), + requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void getSymbolicLink(String shareName, String fileName, Integer timeout, String sharesnapshot, - String requestId) { - getSymbolicLinkWithResponse(shareName, fileName, timeout, sharesnapshot, requestId, Context.NONE); + * Lists handles for file. + *

Query Parameters

+ * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HandleId: String (Required)
+     *     Path (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     FileId: String (Required)
+     *     ParentId: String (Optional)
+     *     SessionId: String (Required)
+     *     ClientIp: String (Required)
+     *     ClientName: String (Required)
+     *     OpenTime: DateTimeRfc1123 (Required)
+     *     LastReconnectTime: DateTimeRfc1123 (Optional)
+     *     AccessRightList (Optional): [
+     *         String(Read/Write/Delete) (Optional)
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of handles along with {@link PagedResponse} on successful completion of {@link Mono}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + private Mono> listHandlesSinglePageAsync(RequestOptions requestOptions) { + final String accept = "application/xml"; + return FluxUtil + .withContext(context -> service.listHandles(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), accept, requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) + .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), + getValues(res.getValue(), "Entries"), null, null)); } /** - * The getSymbolicLink operation. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response getSymbolicLinkNoCustomHeadersWithResponse(String shareName, String fileName, Integer timeout, - String sharesnapshot, String requestId, Context context) { + * Lists handles for file. + *

Query Parameters

+ * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HandleId: String (Required)
+     *     Path (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     FileId: String (Required)
+     *     ParentId: String (Optional)
+     *     SessionId: String (Required)
+     *     ClientIp: String (Required)
+     *     ClientName: String (Required)
+     *     OpenTime: DateTimeRfc1123 (Required)
+     *     LastReconnectTime: DateTimeRfc1123 (Optional)
+     *     AccessRightList (Optional): [
+     *         String(Read/Write/Delete) (Optional)
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of handles as paginated response with {@link PagedFlux}. + */ + @ServiceMethod(returns = ReturnType.COLLECTION) + public PagedFlux listHandlesAsync(RequestOptions requestOptions) { + return new PagedFlux<>(() -> listHandlesSinglePageAsync(requestOptions)); + } + + /** + * Lists handles for file. + *

Query Parameters

+ * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HandleId: String (Required)
+     *     Path (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     FileId: String (Required)
+     *     ParentId: String (Optional)
+     *     SessionId: String (Required)
+     *     ClientIp: String (Required)
+     *     ClientName: String (Required)
+     *     OpenTime: DateTimeRfc1123 (Required)
+     *     LastReconnectTime: DateTimeRfc1123 (Optional)
+     *     AccessRightList (Optional): [
+     *         String(Read/Write/Delete) (Optional)
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of handles along with {@link PagedResponse}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + private PagedResponse listHandlesSinglePage(RequestOptions requestOptions) { try { - final String restype = "symboliclink"; final String accept = "application/xml"; - return service.getSymbolicLinkNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, restype, - timeout, sharesnapshot, this.client.getVersion(), requestId, this.client.getFileRequestIntent(), accept, - context); + Response res = service.listHandlesSync(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); + return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), + getValues(res.getValue(), "Entries"), null, null); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Creates a hard link. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + * Lists handles for file. + *

Query Parameters

+ * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HandleId: String (Required)
+     *     Path (Required): {
+     *         Encoded: Boolean (Optional)
+     *         content: String (Optional)
+     *     }
+     *     FileId: String (Required)
+     *     ParentId: String (Optional)
+     *     SessionId: String (Required)
+     *     ClientIp: String (Required)
+     *     ClientName: String (Required)
+     *     OpenTime: DateTimeRfc1123 (Required)
+     *     LastReconnectTime: DateTimeRfc1123 (Optional)
+     *     AccessRightList (Optional): [
+     *         String(Read/Write/Delete) (Optional)
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return an enumeration of handles as paginated response with {@link PagedIterable}. + */ + @ServiceMethod(returns = ReturnType.COLLECTION) + public PagedIterable listHandles(RequestOptions requestOptions) { + return new PagedIterable<>(() -> listHandlesSinglePage(requestOptions)); + } + + /** + * Closes all handles open for given file. + *

Query Parameters

+ * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + * + * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk ('*') is a wildcard + * that specifies all handles. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createHardLinkWithResponseAsync(String shareName, - String fileName, String targetFile, Integer timeout, String requestId, String leaseId) { + public Mono> forceCloseHandlesWithResponseAsync(String handleId, RequestOptions requestOptions) { return FluxUtil - .withContext(context -> createHardLinkWithResponseAsync(shareName, fileName, targetFile, timeout, requestId, - leaseId, context)) + .withContext(context -> service.forceCloseHandles(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), handleId, this.client.isAllowTrailingDot(), + this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Creates a hard link. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + * Closes all handles open for given file. + *

Query Parameters

+ * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + * + * @param handleId Specifies handle ID opened on the file or directory to be closed. Asterisk ('*') is a wildcard + * that specifies all handles. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createHardLinkWithResponseAsync(String shareName, - String fileName, String targetFile, Integer timeout, String requestId, String leaseId, Context context) { - final String restype = "hardlink"; - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - return service - .createHardLink(this.client.getUrl(), shareName, fileName, restype, timeout, this.client.getVersion(), - fileTypeConstant, requestId, leaseId, targetFile, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + public Response forceCloseHandlesWithResponse(String handleId, RequestOptions requestOptions) { + try { + return service.forceCloseHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + handleId, this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), requestOptions, + Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Creates a hard link. + * Renames a file. By default, the destination is overwritten and if the destination already exists and has a + * read-only attribute set, the operation will fail. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-rename-replace-if-existsBooleanNoBoolean. Default value is false. + * Set to true to indicate that the destination should be overwritten.
x-ms-file-rename-ignore-readonlyBooleanNoBoolean. Default value is false. Set + * to true to overwrite the destination even if it has the read-only attribute set.
x-ms-source-lease-idStringNoRequired if the source file has an active + * lease.
x-ms-destination-lease-idStringNoRequired if the destination has an active + * lease.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set.
x-ms-file-creation-timeStringNoCreation time for the file.
x-ms-file-last-write-timeStringNoLast write time for the file.
x-ms-file-change-timeStringNoChange time for the file.
x-ms-file-permissionStringNoIf specified the permission shall be set for the + * file.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-file-permission-keyStringNoKey of the permission to be set.
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-content-typeStringNoSets the MIME content type of the file.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createHardLinkAsync(String shareName, String fileName, String targetFile, Integer timeout, - String requestId, String leaseId) { - return createHardLinkWithResponseAsync(shareName, fileName, targetFile, timeout, requestId, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a hard link. + public Mono> renameWithResponseAsync(String renameSource, RequestOptions requestOptions) { + return FluxUtil + .withContext(context -> service.rename(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + renameSource, this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), + this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Renames a file. By default, the destination is overwritten and if the destination already exists and has a + * read-only attribute set, the operation will fail. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-rename-replace-if-existsBooleanNoBoolean. Default value is false. + * Set to true to indicate that the destination should be overwritten.
x-ms-file-rename-ignore-readonlyBooleanNoBoolean. Default value is false. Set + * to true to overwrite the destination even if it has the read-only attribute set.
x-ms-source-lease-idStringNoRequired if the source file has an active + * lease.
x-ms-destination-lease-idStringNoRequired if the destination has an active + * lease.
x-ms-file-attributesStringNoIf specified, the provided file attributes shall + * be set.
x-ms-file-creation-timeStringNoCreation time for the file.
x-ms-file-last-write-timeStringNoLast write time for the file.
x-ms-file-change-timeStringNoChange time for the file.
x-ms-file-permissionStringNoIf specified the permission shall be set for the + * file.
x-ms-file-permission-formatStringNoOptional. Used to set permission format. + * Allowed values: "Sddl", "Binary".
x-ms-file-permission-keyStringNoKey of the permission to be set.
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-content-typeStringNoSets the MIME content type of the file.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * @param renameSource Required. Specifies the URI-style path of the source file, up to 2 KB in length. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createHardLinkAsync(String shareName, String fileName, String targetFile, Integer timeout, - String requestId, String leaseId, Context context) { - return createHardLinkWithResponseAsync(shareName, fileName, targetFile, timeout, requestId, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + public Response renameWithResponse(String renameSource, RequestOptions requestOptions) { + try { + return service.renameSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), renameSource, + this.client.isAllowTrailingDot(), this.client.isAllowSourceTrailingDot(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Creates a hard link. - * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Creates a symbolic link to a target file. NFS only. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-file-creation-timeStringNoCreation time for the file.
x-ms-file-last-write-timeStringNoLast write time for the file.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param linkText NFS only. The path to the original file, the symbolic link is pointing to. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createHardLinkNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String targetFile, Integer timeout, String requestId, String leaseId) { + public Mono> createSymbolicLinkWithResponseAsync(String linkText, RequestOptions requestOptions) { return FluxUtil - .withContext(context -> createHardLinkNoCustomHeadersWithResponseAsync(shareName, fileName, targetFile, - timeout, requestId, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + .withContext(context -> service.createSymbolicLink(this.client.getUrl(), + this.client.getServiceVersion().getVersion(), linkText, this.client.getFileRequestIntent(), + requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Creates a symbolic link to a target file. NFS only. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-file-creation-timeStringNoCreation time for the file.
x-ms-file-last-write-timeStringNoLast write time for the file.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-ownerStringNoOptional, NFS only. The owner of the file or + * directory.
x-ms-groupStringNoOptional, NFS only. The owning group of the file or + * directory.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param linkText NFS only. The path to the original file, the symbolic link is pointing to. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + public Response createSymbolicLinkWithResponse(String linkText, RequestOptions requestOptions) { + try { + return service.createSymbolicLinkSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + linkText, this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Creates a hard link. + * Returns the target of a symbolic link. NFS only. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createHardLinkNoCustomHeadersWithResponseAsync(String shareName, String fileName, - String targetFile, Integer timeout, String requestId, String leaseId, Context context) { - final String restype = "hardlink"; - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - return service - .createHardLinkNoCustomHeaders(this.client.getUrl(), shareName, fileName, restype, timeout, - this.client.getVersion(), fileTypeConstant, requestId, leaseId, targetFile, - this.client.getFileRequestIntent(), accept, context) + public Mono> getSymbolicLinkWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext( + context -> service.getSymbolicLink(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Creates a hard link. + * Returns the target of a symbolic link. NFS only. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. - * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase createHardLinkWithResponse(String shareName, String fileName, - String targetFile, Integer timeout, String requestId, String leaseId, Context context) { + public Response getSymbolicLinkWithResponse(RequestOptions requestOptions) { try { - final String restype = "hardlink"; - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - return service.createHardLinkSync(this.client.getUrl(), shareName, fileName, restype, timeout, - this.client.getVersion(), fileTypeConstant, requestId, leaseId, targetFile, - this.client.getFileRequestIntent(), accept, context); + return service.getSymbolicLinkSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Creates a hard link. + * Creates a hard link to a target file. NFS only. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * to 2 KiB in length. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void createHardLink(String shareName, String fileName, String targetFile, Integer timeout, String requestId, - String leaseId) { - createHardLinkWithResponse(shareName, fileName, targetFile, timeout, requestId, leaseId, Context.NONE); + public Mono> createHardLinkWithResponseAsync(String targetFile, RequestOptions requestOptions) { + final String fileType = "file"; + return FluxUtil + .withContext( + context -> service.createHardLink(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + fileType, targetFile, this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Creates a hard link. + * Creates a hard link to a target file. NFS only. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param fileName The path of the target file. * @param targetFile NFS only. Required. Specifies the path of the target file to which the link will be created, up - * to 2 KiB in length. It should be full path of the target from the root.The target file must be in the same share - * and hence the same storage account. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * to 2 KiB in length. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response createHardLinkNoCustomHeadersWithResponse(String shareName, String fileName, - String targetFile, Integer timeout, String requestId, String leaseId, Context context) { + public Response createHardLinkWithResponse(String targetFile, RequestOptions requestOptions) { try { - final String restype = "hardlink"; - final String fileTypeConstant = "file"; - final String accept = "application/xml"; - return service.createHardLinkNoCustomHeadersSync(this.client.getUrl(), shareName, fileName, restype, - timeout, this.client.getVersion(), fileTypeConstant, requestId, leaseId, targetFile, - this.client.getFileRequestIntent(), accept, context); + final String fileType = "file"; + return service.createHardLinkSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + fileType, targetFile, this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + + private List getValues(BinaryData binaryData, String path) { + try { + try { + Map obj = binaryData.toObject(Map.class); + List values = (List) obj.get(path); + return values.stream().map(BinaryData::fromObject).collect(Collectors.toList()); + } catch (RuntimeException e) { + return null; + } + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + + private String getNextLink(BinaryData binaryData, String path) { + try { + try { + Map obj = binaryData.toObject(Map.class); + return (String) obj.get(path); + } catch (RuntimeException e) { + return null; + } } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java index f84362b77754..9fc092330722 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation; import com.azure.core.annotation.BodyParam; @@ -9,39 +9,32 @@ import com.azure.core.annotation.HeaderParam; import com.azure.core.annotation.Host; import com.azure.core.annotation.HostParam; -import com.azure.core.annotation.PathParam; import com.azure.core.annotation.Post; import com.azure.core.annotation.Put; -import com.azure.core.annotation.QueryParam; import com.azure.core.annotation.ReturnType; import com.azure.core.annotation.ServiceInterface; import com.azure.core.annotation.ServiceMethod; import com.azure.core.annotation.UnexpectedResponseExceptionType; +import com.azure.core.exception.ClientAuthenticationException; +import com.azure.core.exception.HttpResponseException; +import com.azure.core.exception.ResourceModifiedException; +import com.azure.core.exception.ResourceNotFoundException; import com.azure.core.http.rest.PagedFlux; import com.azure.core.http.rest.PagedIterable; import com.azure.core.http.rest.PagedResponse; import com.azure.core.http.rest.PagedResponseBase; +import com.azure.core.http.rest.RequestOptions; import com.azure.core.http.rest.Response; -import com.azure.core.http.rest.ResponseBase; import com.azure.core.http.rest.RestProxy; +import com.azure.core.util.BinaryData; import com.azure.core.util.Context; import com.azure.core.util.FluxUtil; -import com.azure.storage.file.share.implementation.models.KeyInfo; -import com.azure.storage.file.share.implementation.models.ListSharesIncludeType; -import com.azure.storage.file.share.implementation.models.ListSharesResponse; -import com.azure.storage.file.share.implementation.models.ServicesGetPropertiesHeaders; -import com.azure.storage.file.share.implementation.models.ServicesGetUserDelegationKeyHeaders; -import com.azure.storage.file.share.implementation.models.ServicesListSharesSegmentHeaders; -import com.azure.storage.file.share.implementation.models.ServicesListSharesSegmentNextHeaders; -import com.azure.storage.file.share.implementation.models.ServicesSetPropertiesHeaders; -import com.azure.storage.file.share.implementation.models.ShareItemInternal; +import com.azure.storage.file.share.ShareServiceVersion; import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal; import com.azure.storage.file.share.implementation.util.ModelHelper; -import com.azure.storage.file.share.models.ShareServiceProperties; import com.azure.storage.file.share.models.ShareTokenIntent; -import com.azure.storage.file.share.models.UserDelegationKey; import java.util.List; -import java.util.Objects; +import java.util.Map; import java.util.stream.Collectors; import reactor.core.publisher.Mono; @@ -70,6 +63,19 @@ public final class ServicesImpl { this.client = client; } + /** + * Gets Service version. + * + * @return the serviceVersion value. + */ + public ShareServiceVersion getServiceVersion() { + try { + return client.getServiceVersion(); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + /** * The interface defining all the services for AzureFileStorageServices to be used by the proxy service to perform * REST calls. @@ -78,401 +84,238 @@ public final class ServicesImpl { @ServiceInterface(name = "AzureFileStorageServices") public interface ServicesService { - @Put("/") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setProperties(@HostParam("url") String url, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/xml") ShareServiceProperties shareServiceProperties, - @HeaderParam("Accept") String accept, Context context); - - @Put("/") + @Put("/?restype=service&comp=properties") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setPropertiesNoCustomHeaders(@HostParam("url") String url, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> setProperties(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("Content-Type") String contentType, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/xml") ShareServiceProperties shareServiceProperties, - @HeaderParam("Accept") String accept, Context context); + @BodyParam("application/xml") BinaryData storageServiceProperties, RequestOptions requestOptions, + Context context); - @Put("/") + @Put("/?restype=service&comp=properties") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase setPropertiesSync(@HostParam("url") String url, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response setPropertiesSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("Content-Type") String contentType, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/xml") ShareServiceProperties shareServiceProperties, - @HeaderParam("Accept") String accept, Context context); + @BodyParam("application/xml") BinaryData storageServiceProperties, RequestOptions requestOptions, + Context context); - @Put("/") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response setPropertiesNoCustomHeadersSync(@HostParam("url") String url, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/xml") ShareServiceProperties shareServiceProperties, - @HeaderParam("Accept") String accept, Context context); - - @Get("/") + @Get("/?restype=service&comp=properties") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getProperties( - @HostParam("url") String url, @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getProperties(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Get("/") + @Get("/?restype=service&comp=properties") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getPropertiesNoCustomHeaders(@HostParam("url") String url, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getPropertiesSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Get("/") + @Get("/?comp=list") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getPropertiesSync( - @HostParam("url") String url, @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> listSharesSegment(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Get("/") + @Get("/?comp=list") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getPropertiesNoCustomHeadersSync(@HostParam("url") String url, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response listSharesSegmentSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Get("/") + @Post("/?restype=service&comp=userdelegationkey") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listSharesSegment( - @HostParam("url") String url, @QueryParam("comp") String comp, @QueryParam("prefix") String prefix, - @QueryParam("marker") String marker, @QueryParam("maxresults") Integer maxresults, - @QueryParam("include") String include, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listSharesSegmentNoCustomHeaders(@HostParam("url") String url, - @QueryParam("comp") String comp, @QueryParam("prefix") String prefix, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("include") String include, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/") + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getUserDelegationKey(@HostParam("url") String url, + @HeaderParam("Content-Type") String contentType, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("Accept") String accept, @BodyParam("application/xml") BinaryData keyInfo, + RequestOptions requestOptions, Context context); + + @Post("/?restype=service&comp=userdelegationkey") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase listSharesSegmentSync( - @HostParam("url") String url, @QueryParam("comp") String comp, @QueryParam("prefix") String prefix, - @QueryParam("marker") String marker, @QueryParam("maxresults") Integer maxresults, - @QueryParam("include") String include, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response listSharesSegmentNoCustomHeadersSync(@HostParam("url") String url, - @QueryParam("comp") String comp, @QueryParam("prefix") String prefix, @QueryParam("marker") String marker, - @QueryParam("maxresults") Integer maxresults, @QueryParam("include") String include, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Post("/") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getUserDelegationKey( - @HostParam("url") String url, @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, @BodyParam("application/xml") KeyInfo keyInfo, - @HeaderParam("Accept") String accept, Context context); - - @Post("/") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getUserDelegationKeyNoCustomHeaders(@HostParam("url") String url, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, @BodyParam("application/xml") KeyInfo keyInfo, - @HeaderParam("Accept") String accept, Context context); - - @Post("/") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getUserDelegationKeySync( - @HostParam("url") String url, @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, @BodyParam("application/xml") KeyInfo keyInfo, - @HeaderParam("Accept") String accept, Context context); - - @Post("/") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getUserDelegationKeyNoCustomHeadersSync(@HostParam("url") String url, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, @BodyParam("application/xml") KeyInfo keyInfo, - @HeaderParam("Accept") String accept, Context context); - - @Get("{nextLink}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listSharesSegmentNext( - @PathParam(value = "nextLink", encoded = true) String nextLink, @HostParam("url") String url, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("{nextLink}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> listSharesSegmentNextNoCustomHeaders( - @PathParam(value = "nextLink", encoded = true) String nextLink, @HostParam("url") String url, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("{nextLink}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase listSharesSegmentNextSync( - @PathParam(value = "nextLink", encoded = true) String nextLink, @HostParam("url") String url, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("{nextLink}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response listSharesSegmentNextNoCustomHeadersSync( - @PathParam(value = "nextLink", encoded = true) String nextLink, @HostParam("url") String url, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - } - - /** - * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - setPropertiesWithResponseAsync(ShareServiceProperties shareServiceProperties, Integer timeout) { - return FluxUtil.withContext(context -> setPropertiesWithResponseAsync(shareServiceProperties, timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesWithResponseAsync( - ShareServiceProperties shareServiceProperties, Integer timeout, Context context) { - final String restype = "service"; - final String comp = "properties"; - final String accept = "application/xml"; - return service - .setProperties(this.client.getUrl(), restype, comp, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), shareServiceProperties, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setPropertiesAsync(ShareServiceProperties shareServiceProperties, Integer timeout) { - return setPropertiesWithResponseAsync(shareServiceProperties, timeout) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getUserDelegationKeySync(@HostParam("url") String url, + @HeaderParam("Content-Type") String contentType, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("Accept") String accept, @BodyParam("application/xml") BinaryData keyInfo, + RequestOptions requestOptions, Context context); } /** * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setPropertiesAsync(ShareServiceProperties shareServiceProperties, Integer timeout, - Context context) { - return setPropertiesWithResponseAsync(shareServiceProperties, timeout, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Request Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HourMetrics (Optional): {
+     *         Version: String (Required)
+     *         Enabled: boolean (Required)
+     *         IncludeAPIs: Boolean (Optional)
+     *         RetentionPolicy (Optional): {
+     *             Enabled: boolean (Required)
+     *             Days: Integer (Optional)
+     *         }
+     *     }
+     *     MinuteMetrics (Optional): (recursive schema, see MinuteMetrics above)
+     *     ProtocolSettings (Optional): {
+     *         SMB (Optional): {
+     *             Multichannel (Optional): {
+     *                 Enabled: Boolean (Optional)
+     *             }
+     *             EncryptionInTransit (Optional): {
+     *                 Required: Boolean (Optional)
+     *             }
+     *         }
+     *         NFS (Optional): {
+     *             EncryptionInTransit (Optional): {
+     *                 Required: Boolean (Optional)
+     *             }
+     *         }
+     *     }
+     *     Cors (Optional): [
+     *          (Optional){
+     *             AllowedOrigins: String (Required)
+     *             AllowedMethods: String (Required)
+     *             AllowedHeaders: String (Required)
+     *             ExposedHeaders: String (Required)
+     *             MaxAgeInSeconds: int (Required)
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param storageServiceProperties Storage service properties. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - setPropertiesNoCustomHeadersWithResponseAsync(ShareServiceProperties shareServiceProperties, Integer timeout) { + public Mono> setPropertiesWithResponseAsync(BinaryData storageServiceProperties, + RequestOptions requestOptions) { + final String contentType = "application/xml"; return FluxUtil .withContext( - context -> setPropertiesNoCustomHeadersWithResponseAsync(shareServiceProperties, timeout, context)) + context -> service.setProperties(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + contentType, this.client.getFileRequestIntent(), storageServiceProperties, requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesNoCustomHeadersWithResponseAsync( - ShareServiceProperties shareServiceProperties, Integer timeout, Context context) { - final String restype = "service"; - final String comp = "properties"; - final String accept = "application/xml"; - return service - .setPropertiesNoCustomHeaders(this.client.getUrl(), restype, comp, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), shareServiceProperties, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase - setPropertiesWithResponse(ShareServiceProperties shareServiceProperties, Integer timeout, Context context) { - try { - final String restype = "service"; - final String comp = "properties"; - final String accept = "application/xml"; - return service.setPropertiesSync(this.client.getUrl(), restype, comp, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), shareServiceProperties, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void setProperties(ShareServiceProperties shareServiceProperties, Integer timeout) { - setPropertiesWithResponse(shareServiceProperties, timeout, Context.NONE); - } - - /** - * Sets properties for a storage account's File service endpoint, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules. - * - * @param shareServiceProperties The StorageService properties. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Request Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HourMetrics (Optional): {
+     *         Version: String (Required)
+     *         Enabled: boolean (Required)
+     *         IncludeAPIs: Boolean (Optional)
+     *         RetentionPolicy (Optional): {
+     *             Enabled: boolean (Required)
+     *             Days: Integer (Optional)
+     *         }
+     *     }
+     *     MinuteMetrics (Optional): (recursive schema, see MinuteMetrics above)
+     *     ProtocolSettings (Optional): {
+     *         SMB (Optional): {
+     *             Multichannel (Optional): {
+     *                 Enabled: Boolean (Optional)
+     *             }
+     *             EncryptionInTransit (Optional): {
+     *                 Required: Boolean (Optional)
+     *             }
+     *         }
+     *         NFS (Optional): {
+     *             EncryptionInTransit (Optional): {
+     *                 Required: Boolean (Optional)
+     *             }
+     *         }
+     *     }
+     *     Cors (Optional): [
+     *          (Optional){
+     *             AllowedOrigins: String (Required)
+     *             AllowedMethods: String (Required)
+     *             AllowedHeaders: String (Required)
+     *             ExposedHeaders: String (Required)
+     *             MaxAgeInSeconds: int (Required)
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param storageServiceProperties Storage service properties. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response setPropertiesNoCustomHeadersWithResponse(ShareServiceProperties shareServiceProperties, - Integer timeout, Context context) { + public Response setPropertiesWithResponse(BinaryData storageServiceProperties, + RequestOptions requestOptions) { try { - final String restype = "service"; - final String comp = "properties"; - final String accept = "application/xml"; - return service.setPropertiesNoCustomHeadersSync(this.client.getUrl(), restype, comp, timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), shareServiceProperties, accept, context); + final String contentType = "application/xml"; + return service.setPropertiesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + contentType, this.client.getFileRequestIntent(), storageServiceProperties, requestOptions, + Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } @@ -481,211 +324,142 @@ public Response setPropertiesNoCustomHeadersWithResponse(ShareServicePrope /** * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the properties of a storage account's File service, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules along with {@link ResponseBase} on successful completion of - * {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - getPropertiesWithResponseAsync(Integer timeout) { - return FluxUtil.withContext(context -> getPropertiesWithResponseAsync(timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and - * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the properties of a storage account's File service, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules along with {@link ResponseBase} on successful completion of - * {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - getPropertiesWithResponseAsync(Integer timeout, Context context) { - final String restype = "service"; - final String comp = "properties"; - final String accept = "application/xml"; - return service - .getProperties(this.client.getUrl(), restype, comp, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and - * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the properties of a storage account's File service, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPropertiesAsync(Integer timeout) { - return getPropertiesWithResponseAsync(timeout) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and - * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the properties of a storage account's File service, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPropertiesAsync(Integer timeout, Context context) { - return getPropertiesWithResponseAsync(timeout, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and - * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the properties of a storage account's File service, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules along with {@link Response} on successful completion of - * {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesNoCustomHeadersWithResponseAsync(Integer timeout) { - return FluxUtil.withContext(context -> getPropertiesNoCustomHeadersWithResponseAsync(timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and - * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HourMetrics (Optional): {
+     *         Version: String (Required)
+     *         Enabled: boolean (Required)
+     *         IncludeAPIs: Boolean (Optional)
+     *         RetentionPolicy (Optional): {
+     *             Enabled: boolean (Required)
+     *             Days: Integer (Optional)
+     *         }
+     *     }
+     *     MinuteMetrics (Optional): (recursive schema, see MinuteMetrics above)
+     *     ProtocolSettings (Optional): {
+     *         SMB (Optional): {
+     *             Multichannel (Optional): {
+     *                 Enabled: Boolean (Optional)
+     *             }
+     *             EncryptionInTransit (Optional): {
+     *                 Required: Boolean (Optional)
+     *             }
+     *         }
+     *         NFS (Optional): {
+     *             EncryptionInTransit (Optional): {
+     *                 Required: Boolean (Optional)
+     *             }
+     *         }
+     *     }
+     *     Cors (Optional): [
+     *          (Optional){
+     *             AllowedOrigins: String (Required)
+     *             AllowedMethods: String (Required)
+     *             AllowedHeaders: String (Required)
+     *             ExposedHeaders: String (Required)
+     *             MaxAgeInSeconds: int (Required)
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the properties of a storage account's File service, including properties for Storage Analytics metrics * and CORS (Cross-Origin Resource Sharing) rules along with {@link Response} on successful completion of * {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesNoCustomHeadersWithResponseAsync(Integer timeout, - Context context) { - final String restype = "service"; - final String comp = "properties"; + public Mono> getPropertiesWithResponseAsync(RequestOptions requestOptions) { final String accept = "application/xml"; - return service - .getPropertiesNoCustomHeaders(this.client.getUrl(), restype, comp, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context) + return FluxUtil + .withContext( + context -> service.getProperties(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), accept, requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the properties of a storage account's File service, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules along with {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase getPropertiesWithResponse(Integer timeout, - Context context) { - try { - final String restype = "service"; - final String comp = "properties"; - final String accept = "application/xml"; - return service.getPropertiesSync(this.client.getUrl(), restype, comp, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and - * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the properties of a storage account's File service, including properties for Storage Analytics metrics - * and CORS (Cross-Origin Resource Sharing) rules. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ShareServiceProperties getProperties(Integer timeout) { - try { - return getPropertiesWithResponse(timeout, Context.NONE).getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Gets the properties of a storage account's File service, including properties for Storage Analytics metrics and - * CORS (Cross-Origin Resource Sharing) rules. - * - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     HourMetrics (Optional): {
+     *         Version: String (Required)
+     *         Enabled: boolean (Required)
+     *         IncludeAPIs: Boolean (Optional)
+     *         RetentionPolicy (Optional): {
+     *             Enabled: boolean (Required)
+     *             Days: Integer (Optional)
+     *         }
+     *     }
+     *     MinuteMetrics (Optional): (recursive schema, see MinuteMetrics above)
+     *     ProtocolSettings (Optional): {
+     *         SMB (Optional): {
+     *             Multichannel (Optional): {
+     *                 Enabled: Boolean (Optional)
+     *             }
+     *             EncryptionInTransit (Optional): {
+     *                 Required: Boolean (Optional)
+     *             }
+     *         }
+     *         NFS (Optional): {
+     *             EncryptionInTransit (Optional): {
+     *                 Required: Boolean (Optional)
+     *             }
+     *         }
+     *     }
+     *     Cors (Optional): [
+     *          (Optional){
+     *             AllowedOrigins: String (Required)
+     *             AllowedMethods: String (Required)
+     *             AllowedHeaders: String (Required)
+     *             ExposedHeaders: String (Required)
+     *             MaxAgeInSeconds: int (Required)
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the properties of a storage account's File service, including properties for Storage Analytics metrics * and CORS (Cross-Origin Resource Sharing) rules along with {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response getPropertiesNoCustomHeadersWithResponse(Integer timeout, Context context) { + public Response getPropertiesWithResponse(RequestOptions requestOptions) { try { - final String restype = "service"; - final String comp = "properties"; final String accept = "application/xml"; - return service.getPropertiesNoCustomHeadersSync(this.client.getUrl(), restype, comp, timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), accept, context); + return service.getPropertiesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } @@ -693,434 +467,234 @@ public Response getPropertiesNoCustomHeadersWithResponse /** * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listSharesSegmentSinglePageAsync(String prefix, String marker, - Integer maxresults, List include, Integer timeout) { - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - return FluxUtil - .withContext(context -> service.listSharesSegment(this.client.getUrl(), comp, prefix, marker, maxresults, - includeConverted, timeout, this.client.getVersion(), this.client.getFileRequestIntent(), accept, - context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), res.getDeserializedHeaders())); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listSharesSegmentSinglePageAsync(String prefix, String marker, - Integer maxresults, List include, Integer timeout, Context context) { - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - return service - .listSharesSegment(this.client.getUrl(), comp, prefix, marker, maxresults, includeConverted, timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), res.getDeserializedHeaders())); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares as paginated response with {@link PagedFlux}. - */ - @ServiceMethod(returns = ReturnType.COLLECTION) - public PagedFlux listSharesSegmentAsync(String prefix, String marker, Integer maxresults, - List include, Integer timeout) { - return new PagedFlux<>(() -> listSharesSegmentSinglePageAsync(prefix, marker, maxresults, include, timeout), - nextLink -> listSharesSegmentNextSinglePageAsync(nextLink)); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares as paginated response with {@link PagedFlux}. - */ - @ServiceMethod(returns = ReturnType.COLLECTION) - public PagedFlux listSharesSegmentAsync(String prefix, String marker, Integer maxresults, - List include, Integer timeout, Context context) { - return new PagedFlux<>( - () -> listSharesSegmentSinglePageAsync(prefix, marker, maxresults, include, timeout, context), - nextLink -> listSharesSegmentNextSinglePageAsync(nextLink, context)); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
prefixStringNoFilters the results to return only items whose name begins with + * the specified prefix.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
includeList<String>NoInclude this parameter to specify one or more + * datasets to include in the response. In the form of "," separated string.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     Name: String (Required)
+     *     Snapshot: String (Optional)
+     *     Deleted: Boolean (Optional)
+     *     Version: String (Optional)
+     *     Properties (Required): {
+     *         Last-Modified: DateTimeRfc1123 (Required)
+     *         Etag: String (Required)
+     *         Quota: int (Required)
+     *         ProvisionedIops: Integer (Optional)
+     *         ProvisionedIngressMBps: Integer (Optional)
+     *         ProvisionedEgressMBps: Integer (Optional)
+     *         ProvisionedBandwidthMiBps: Integer (Optional)
+     *         NextAllowedQuotaDowngradeTime: DateTimeRfc1123 (Optional)
+     *         DeletedTime: DateTimeRfc1123 (Optional)
+     *         RemainingRetentionDays: Integer (Optional)
+     *         AccessTier: String (Optional)
+     *         AccessTierChangeTime: DateTimeRfc1123 (Optional)
+     *         AccessTierTransitionState: String (Optional)
+     *         LeaseStatus: String(locked/unlocked) (Optional)
+     *         LeaseState: String(available/leased/expired/breaking/broken) (Optional)
+     *         LeaseDuration: String(infinite/fixed) (Optional)
+     *         EnabledProtocols: String (Optional)
+     *         RootSquash: String(NoRootSquash/RootSquash/AllSquash) (Optional)
+     *         EnableSnapshotVirtualDirectoryAccess: Boolean (Optional)
+     *         PaidBurstingEnabled: Boolean (Optional)
+     *         PaidBurstingMaxIops: Long (Optional)
+     *         PaidBurstingMaxBandwidthMibps: Long (Optional)
+     *         IncludedBurstIops: Long (Optional)
+     *         MaxBurstCreditsForIops: Long (Optional)
+     *         NextAllowedProvisionedIopsDowngradeTime: DateTimeRfc1123 (Optional)
+     *         NextAllowedProvisionedBandwidthDowngradeTime: DateTimeRfc1123 (Optional)
+     *         EnableSmbDirectoryLease: Boolean (Optional)
+     *     }
+     *     Metadata (Optional): {
+     *         String: String (Required)
+     *     }
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return an enumeration of shares along with {@link PagedResponse} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listSharesSegmentNoCustomHeadersSinglePageAsync(String prefix, - String marker, Integer maxresults, List include, Integer timeout) { - final String comp = "list"; + private Mono> listSharesSegmentSinglePageAsync(RequestOptions requestOptions) { final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); return FluxUtil - .withContext(context -> service.listSharesSegmentNoCustomHeaders(this.client.getUrl(), comp, prefix, marker, - maxresults, includeConverted, timeout, this.client.getVersion(), this.client.getFileRequestIntent(), - accept, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), null)); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listSharesSegmentNoCustomHeadersSinglePageAsync(String prefix, - String marker, Integer maxresults, List include, Integer timeout, Context context) { - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - return service - .listSharesSegmentNoCustomHeaders(this.client.getUrl(), comp, prefix, marker, maxresults, includeConverted, - timeout, this.client.getVersion(), this.client.getFileRequestIntent(), accept, context) + .withContext( + context -> service.listSharesSegment(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), accept, requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), null)); + getValues(res.getValue(), "Shares"), null, null)); } /** * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
prefixStringNoFilters the results to return only items whose name begins with + * the specified prefix.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
includeList<String>NoInclude this parameter to specify one or more + * datasets to include in the response. In the form of "," separated string.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     Name: String (Required)
+     *     Snapshot: String (Optional)
+     *     Deleted: Boolean (Optional)
+     *     Version: String (Optional)
+     *     Properties (Required): {
+     *         Last-Modified: DateTimeRfc1123 (Required)
+     *         Etag: String (Required)
+     *         Quota: int (Required)
+     *         ProvisionedIops: Integer (Optional)
+     *         ProvisionedIngressMBps: Integer (Optional)
+     *         ProvisionedEgressMBps: Integer (Optional)
+     *         ProvisionedBandwidthMiBps: Integer (Optional)
+     *         NextAllowedQuotaDowngradeTime: DateTimeRfc1123 (Optional)
+     *         DeletedTime: DateTimeRfc1123 (Optional)
+     *         RemainingRetentionDays: Integer (Optional)
+     *         AccessTier: String (Optional)
+     *         AccessTierChangeTime: DateTimeRfc1123 (Optional)
+     *         AccessTierTransitionState: String (Optional)
+     *         LeaseStatus: String(locked/unlocked) (Optional)
+     *         LeaseState: String(available/leased/expired/breaking/broken) (Optional)
+     *         LeaseDuration: String(infinite/fixed) (Optional)
+     *         EnabledProtocols: String (Optional)
+     *         RootSquash: String(NoRootSquash/RootSquash/AllSquash) (Optional)
+     *         EnableSnapshotVirtualDirectoryAccess: Boolean (Optional)
+     *         PaidBurstingEnabled: Boolean (Optional)
+     *         PaidBurstingMaxIops: Long (Optional)
+     *         PaidBurstingMaxBandwidthMibps: Long (Optional)
+     *         IncludedBurstIops: Long (Optional)
+     *         MaxBurstCreditsForIops: Long (Optional)
+     *         NextAllowedProvisionedIopsDowngradeTime: DateTimeRfc1123 (Optional)
+     *         NextAllowedProvisionedBandwidthDowngradeTime: DateTimeRfc1123 (Optional)
+     *         EnableSmbDirectoryLease: Boolean (Optional)
+     *     }
+     *     Metadata (Optional): {
+     *         String: String (Required)
+     *     }
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return an enumeration of shares as paginated response with {@link PagedFlux}. */ @ServiceMethod(returns = ReturnType.COLLECTION) - public PagedFlux listSharesSegmentNoCustomHeadersAsync(String prefix, String marker, - Integer maxresults, List include, Integer timeout) { - return new PagedFlux<>( - () -> listSharesSegmentNoCustomHeadersSinglePageAsync(prefix, marker, maxresults, include, timeout), - nextLink -> listSharesSegmentNextSinglePageAsync(nextLink)); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares as paginated response with {@link PagedFlux}. - */ - @ServiceMethod(returns = ReturnType.COLLECTION) - public PagedFlux listSharesSegmentNoCustomHeadersAsync(String prefix, String marker, - Integer maxresults, List include, Integer timeout, Context context) { - return new PagedFlux<>(() -> listSharesSegmentNoCustomHeadersSinglePageAsync(prefix, marker, maxresults, - include, timeout, context), nextLink -> listSharesSegmentNextSinglePageAsync(nextLink, context)); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public PagedResponse listSharesSegmentSinglePage(String prefix, String marker, - Integer maxresults, List include, Integer timeout) { - try { - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - ResponseBase res = service.listSharesSegmentSync( - this.client.getUrl(), comp, prefix, marker, maxresults, includeConverted, timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), accept, Context.NONE); - return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), res.getDeserializedHeaders()); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public PagedResponse listSharesSegmentSinglePage(String prefix, String marker, - Integer maxresults, List include, Integer timeout, Context context) { - try { - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - ResponseBase res = service.listSharesSegmentSync( - this.client.getUrl(), comp, prefix, marker, maxresults, includeConverted, timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), accept, context); - return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), res.getDeserializedHeaders()); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares as paginated response with {@link PagedIterable}. - */ - @ServiceMethod(returns = ReturnType.COLLECTION) - public PagedIterable listSharesSegment(String prefix, String marker, Integer maxresults, - List include, Integer timeout) { - return new PagedIterable<>(() -> listSharesSegmentSinglePage(prefix, marker, maxresults, include, timeout), - nextLink -> listSharesSegmentNextSinglePage(nextLink)); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares as paginated response with {@link PagedIterable}. - */ - @ServiceMethod(returns = ReturnType.COLLECTION) - public PagedIterable listSharesSegment(String prefix, String marker, Integer maxresults, - List include, Integer timeout, Context context) { - return new PagedIterable<>( - () -> listSharesSegmentSinglePage(prefix, marker, maxresults, include, timeout, context), - nextLink -> listSharesSegmentNextSinglePage(nextLink, context)); + public PagedFlux listSharesSegmentAsync(RequestOptions requestOptions) { + return new PagedFlux<>(() -> listSharesSegmentSinglePageAsync(requestOptions)); } /** * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
prefixStringNoFilters the results to return only items whose name begins with + * the specified prefix.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
includeList<String>NoInclude this parameter to specify one or more + * datasets to include in the response. In the form of "," separated string.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     Name: String (Required)
+     *     Snapshot: String (Optional)
+     *     Deleted: Boolean (Optional)
+     *     Version: String (Optional)
+     *     Properties (Required): {
+     *         Last-Modified: DateTimeRfc1123 (Required)
+     *         Etag: String (Required)
+     *         Quota: int (Required)
+     *         ProvisionedIops: Integer (Optional)
+     *         ProvisionedIngressMBps: Integer (Optional)
+     *         ProvisionedEgressMBps: Integer (Optional)
+     *         ProvisionedBandwidthMiBps: Integer (Optional)
+     *         NextAllowedQuotaDowngradeTime: DateTimeRfc1123 (Optional)
+     *         DeletedTime: DateTimeRfc1123 (Optional)
+     *         RemainingRetentionDays: Integer (Optional)
+     *         AccessTier: String (Optional)
+     *         AccessTierChangeTime: DateTimeRfc1123 (Optional)
+     *         AccessTierTransitionState: String (Optional)
+     *         LeaseStatus: String(locked/unlocked) (Optional)
+     *         LeaseState: String(available/leased/expired/breaking/broken) (Optional)
+     *         LeaseDuration: String(infinite/fixed) (Optional)
+     *         EnabledProtocols: String (Optional)
+     *         RootSquash: String(NoRootSquash/RootSquash/AllSquash) (Optional)
+     *         EnableSnapshotVirtualDirectoryAccess: Boolean (Optional)
+     *         PaidBurstingEnabled: Boolean (Optional)
+     *         PaidBurstingMaxIops: Long (Optional)
+     *         PaidBurstingMaxBandwidthMibps: Long (Optional)
+     *         IncludedBurstIops: Long (Optional)
+     *         MaxBurstCreditsForIops: Long (Optional)
+     *         NextAllowedProvisionedIopsDowngradeTime: DateTimeRfc1123 (Optional)
+     *         NextAllowedProvisionedBandwidthDowngradeTime: DateTimeRfc1123 (Optional)
+     *         EnableSmbDirectoryLease: Boolean (Optional)
+     *     }
+     *     Metadata (Optional): {
+     *         String: String (Required)
+     *     }
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return an enumeration of shares along with {@link PagedResponse}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public PagedResponse listSharesSegmentNoCustomHeadersSinglePage(String prefix, String marker, - Integer maxresults, List include, Integer timeout) { + private PagedResponse listSharesSegmentSinglePage(RequestOptions requestOptions) { try { - final String comp = "list"; final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - Response res = service.listSharesSegmentNoCustomHeadersSync(this.client.getUrl(), comp, - prefix, marker, maxresults, includeConverted, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, Context.NONE); + Response res + = service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), null); + getValues(res.getValue(), "Shares"), null, null); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } @@ -1128,506 +702,214 @@ public PagedResponse listSharesSegmentNoCustomHeadersSinglePa /** * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public PagedResponse listSharesSegmentNoCustomHeadersSinglePage(String prefix, String marker, - Integer maxresults, List include, Integer timeout, Context context) { - try { - final String comp = "list"; - final String accept = "application/xml"; - String includeConverted = (include == null) - ? null - : include.stream() - .map(paramItemValue -> Objects.toString(paramItemValue, "")) - .collect(Collectors.joining(",")); - Response res = service.listSharesSegmentNoCustomHeadersSync(this.client.getUrl(), comp, - prefix, marker, maxresults, includeConverted, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context); - return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), null); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
prefixStringNoFilters the results to return only items whose name begins with + * the specified prefix.
markerStringNoA string value that identifies the portion of the list to be + * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
includeList<String>NoInclude this parameter to specify one or more + * datasets to include in the response. In the form of "," separated string.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     Name: String (Required)
+     *     Snapshot: String (Optional)
+     *     Deleted: Boolean (Optional)
+     *     Version: String (Optional)
+     *     Properties (Required): {
+     *         Last-Modified: DateTimeRfc1123 (Required)
+     *         Etag: String (Required)
+     *         Quota: int (Required)
+     *         ProvisionedIops: Integer (Optional)
+     *         ProvisionedIngressMBps: Integer (Optional)
+     *         ProvisionedEgressMBps: Integer (Optional)
+     *         ProvisionedBandwidthMiBps: Integer (Optional)
+     *         NextAllowedQuotaDowngradeTime: DateTimeRfc1123 (Optional)
+     *         DeletedTime: DateTimeRfc1123 (Optional)
+     *         RemainingRetentionDays: Integer (Optional)
+     *         AccessTier: String (Optional)
+     *         AccessTierChangeTime: DateTimeRfc1123 (Optional)
+     *         AccessTierTransitionState: String (Optional)
+     *         LeaseStatus: String(locked/unlocked) (Optional)
+     *         LeaseState: String(available/leased/expired/breaking/broken) (Optional)
+     *         LeaseDuration: String(infinite/fixed) (Optional)
+     *         EnabledProtocols: String (Optional)
+     *         RootSquash: String(NoRootSquash/RootSquash/AllSquash) (Optional)
+     *         EnableSnapshotVirtualDirectoryAccess: Boolean (Optional)
+     *         PaidBurstingEnabled: Boolean (Optional)
+     *         PaidBurstingMaxIops: Long (Optional)
+     *         PaidBurstingMaxBandwidthMibps: Long (Optional)
+     *         IncludedBurstIops: Long (Optional)
+     *         MaxBurstCreditsForIops: Long (Optional)
+     *         NextAllowedProvisionedIopsDowngradeTime: DateTimeRfc1123 (Optional)
+     *         NextAllowedProvisionedBandwidthDowngradeTime: DateTimeRfc1123 (Optional)
+     *         EnableSmbDirectoryLease: Boolean (Optional)
+     *     }
+     *     Metadata (Optional): {
+     *         String: String (Required)
+     *     }
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return an enumeration of shares as paginated response with {@link PagedIterable}. */ @ServiceMethod(returns = ReturnType.COLLECTION) - public PagedIterable listSharesSegmentNoCustomHeaders(String prefix, String marker, - Integer maxresults, List include, Integer timeout) { - return new PagedIterable<>( - () -> listSharesSegmentNoCustomHeadersSinglePage(prefix, marker, maxresults, include, timeout), - nextLink -> listSharesSegmentNextSinglePage(nextLink)); - } - - /** - * The List Shares Segment operation returns a list of the shares and share snapshots under the specified account. - * - * @param prefix Filters the results to return only entries whose name begins with the specified prefix. - * @param marker A string value that identifies the portion of the list to be returned with the next list operation. - * The operation returns a marker value within the response body if the list returned was not complete. The marker - * value may then be used in a subsequent call to request the next set of list items. The marker value is opaque to - * the client. - * @param maxresults Specifies the maximum number of entries to return. If the request does not specify maxresults, - * or specifies a value greater than 5,000, the server will return up to 5,000 items. - * @param include Include this parameter to specify one or more datasets to include in the response. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares as paginated response with {@link PagedIterable}. - */ - @ServiceMethod(returns = ReturnType.COLLECTION) - public PagedIterable listSharesSegmentNoCustomHeaders(String prefix, String marker, - Integer maxresults, List include, Integer timeout, Context context) { - return new PagedIterable<>( - () -> listSharesSegmentNoCustomHeadersSinglePage(prefix, marker, maxresults, include, timeout, context), - nextLink -> listSharesSegmentNextSinglePage(nextLink, context)); - } - - /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. + public PagedIterable listSharesSegment(RequestOptions requestOptions) { + return new PagedIterable<>(() -> listSharesSegmentSinglePage(requestOptions)); + } + + /** + * Retrieves a user delegation key for the File service. This can be used to generate a user delegation SAS. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Request Body Schema

+ * + * 
+     * {@code
+     * {
+     *     Start: String (Optional)
+     *     Expiry: String (Required)
+     *     DelegatedUserTid: String (Optional)
+     * }
+     * }
+     *
+ * + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     SignedOid: String (Required)
+     *     SignedTid: String (Required)
+     *     SignedStart: OffsetDateTime (Required)
+     *     SignedExpiry: OffsetDateTime (Required)
+     *     SignedService: String (Required)
+     *     SignedVersion: String (Required)
+     *     SignedDelegatedUserTid: String (Optional)
+     *     Value: String (Required)
+     * }
+     * }
+     *
* * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a user delegation key along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - getUserDelegationKeyWithResponseAsync(KeyInfo keyInfo, Integer timeout, String requestId) { - return FluxUtil - .withContext(context -> getUserDelegationKeyWithResponseAsync(keyInfo, timeout, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. - * - * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a user delegation key along with {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - getUserDelegationKeyWithResponseAsync(KeyInfo keyInfo, Integer timeout, String requestId, Context context) { - final String restype = "service"; - final String comp = "userdelegationkey"; - final String accept = "application/xml"; - return service - .getUserDelegationKey(this.client.getUrl(), restype, comp, timeout, this.client.getVersion(), requestId, - keyInfo, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. - * - * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a user delegation key on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getUserDelegationKeyAsync(KeyInfo keyInfo, Integer timeout, String requestId) { - return getUserDelegationKeyWithResponseAsync(keyInfo, timeout, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. - * - * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a user delegation key on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getUserDelegationKeyAsync(KeyInfo keyInfo, Integer timeout, String requestId, - Context context) { - return getUserDelegationKeyWithResponseAsync(keyInfo, timeout, requestId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. - * - * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a user delegation key along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getUserDelegationKeyNoCustomHeadersWithResponseAsync(KeyInfo keyInfo, - Integer timeout, String requestId) { - return FluxUtil - .withContext( - context -> getUserDelegationKeyNoCustomHeadersWithResponseAsync(keyInfo, timeout, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. - * - * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return a user delegation key along with {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getUserDelegationKeyNoCustomHeadersWithResponseAsync(KeyInfo keyInfo, - Integer timeout, String requestId, Context context) { - final String restype = "service"; - final String comp = "userdelegationkey"; + public Mono> getUserDelegationKeyWithResponseAsync(BinaryData keyInfo, + RequestOptions requestOptions) { + final String contentType = "application/xml"; final String accept = "application/xml"; - return service - .getUserDelegationKeyNoCustomHeaders(this.client.getUrl(), restype, comp, timeout, this.client.getVersion(), - requestId, keyInfo, accept, context) + return FluxUtil + .withContext(context -> service.getUserDelegationKey(this.client.getUrl(), contentType, + this.client.getServiceVersion().getVersion(), accept, keyInfo, requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. + * Retrieves a user delegation key for the File service. This can be used to generate a user delegation SAS. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Request Body Schema

+ * + * 
+     * {@code
+     * {
+     *     Start: String (Optional)
+     *     Expiry: String (Required)
+     *     DelegatedUserTid: String (Optional)
+     * }
+     * }
+     *
+ * + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     SignedOid: String (Required)
+     *     SignedTid: String (Required)
+     *     SignedStart: OffsetDateTime (Required)
+     *     SignedExpiry: OffsetDateTime (Required)
+     *     SignedService: String (Required)
+     *     SignedVersion: String (Required)
+     *     SignedDelegatedUserTid: String (Optional)
+     *     Value: String (Required)
+     * }
+     * }
+     *
* * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a user delegation key along with {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase - getUserDelegationKeyWithResponse(KeyInfo keyInfo, Integer timeout, String requestId, Context context) { - try { - final String restype = "service"; - final String comp = "userdelegationkey"; - final String accept = "application/xml"; - return service.getUserDelegationKeySync(this.client.getUrl(), restype, comp, timeout, - this.client.getVersion(), requestId, keyInfo, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. - * - * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a user delegation key. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public UserDelegationKey getUserDelegationKey(KeyInfo keyInfo, Integer timeout, String requestId) { - try { - return getUserDelegationKeyWithResponse(keyInfo, timeout, requestId, Context.NONE).getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Retrieves a user delegation key for the File service. This is only a valid operation when using bearer token - * authentication. - * - * @param keyInfo Key information. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return a user delegation key along with {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response getUserDelegationKeyNoCustomHeadersWithResponse(KeyInfo keyInfo, Integer timeout, - String requestId, Context context) { + public Response getUserDelegationKeyWithResponse(BinaryData keyInfo, RequestOptions requestOptions) { try { - final String restype = "service"; - final String comp = "userdelegationkey"; + final String contentType = "application/xml"; final String accept = "application/xml"; - return service.getUserDelegationKeyNoCustomHeadersSync(this.client.getUrl(), restype, comp, timeout, - this.client.getVersion(), requestId, keyInfo, accept, context); + return service.getUserDelegationKeySync(this.client.getUrl(), contentType, + this.client.getServiceVersion().getVersion(), accept, keyInfo, requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } - /** - * Get the next page of items. - * - * @param nextLink The URL to get the next list of items. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listSharesSegmentNextSinglePageAsync(String nextLink) { - final String accept = "application/xml"; - return FluxUtil - .withContext(context -> service.listSharesSegmentNext(nextLink, this.client.getUrl(), - this.client.getVersion(), this.client.getFileRequestIntent(), accept, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), res.getDeserializedHeaders())); - } - - /** - * Get the next page of items. - * - * @param nextLink The URL to get the next list of items. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listSharesSegmentNextSinglePageAsync(String nextLink, - Context context) { - final String accept = "application/xml"; - return service - .listSharesSegmentNext(nextLink, this.client.getUrl(), this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), res.getDeserializedHeaders())); - } - - /** - * Get the next page of items. - * - * @param nextLink The URL to get the next list of items. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listSharesSegmentNextNoCustomHeadersSinglePageAsync(String nextLink) { - final String accept = "application/xml"; - return FluxUtil - .withContext(context -> service.listSharesSegmentNextNoCustomHeaders(nextLink, this.client.getUrl(), - this.client.getVersion(), this.client.getFileRequestIntent(), accept, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), null)); - } - - /** - * Get the next page of items. - * - * @param nextLink The URL to get the next list of items. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> listSharesSegmentNextNoCustomHeadersSinglePageAsync(String nextLink, - Context context) { - final String accept = "application/xml"; - return service - .listSharesSegmentNextNoCustomHeaders(nextLink, this.client.getUrl(), this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), null)); - } - - /** - * Get the next page of items. - * - * @param nextLink The URL to get the next list of items. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public PagedResponse listSharesSegmentNextSinglePage(String nextLink) { - try { - final String accept = "application/xml"; - ResponseBase res - = service.listSharesSegmentNextSync(nextLink, this.client.getUrl(), this.client.getVersion(), - this.client.getFileRequestIntent(), accept, Context.NONE); - return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), res.getDeserializedHeaders()); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Get the next page of items. - * - * @param nextLink The URL to get the next list of items. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public PagedResponse listSharesSegmentNextSinglePage(String nextLink, Context context) { - try { - final String accept = "application/xml"; - ResponseBase res - = service.listSharesSegmentNextSync(nextLink, this.client.getUrl(), this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context); - return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), res.getDeserializedHeaders()); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Get the next page of items. - * - * @param nextLink The URL to get the next list of items. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public PagedResponse listSharesSegmentNextNoCustomHeadersSinglePage(String nextLink) { + private List getValues(BinaryData binaryData, String path) { try { - final String accept = "application/xml"; - Response res - = service.listSharesSegmentNextNoCustomHeadersSync(nextLink, this.client.getUrl(), - this.client.getVersion(), this.client.getFileRequestIntent(), accept, Context.NONE); - return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), null); + try { + Map obj = binaryData.toObject(Map.class); + List values = (List) obj.get(path); + return values.stream().map(BinaryData::fromObject).collect(Collectors.toList()); + } catch (RuntimeException e) { + return null; + } } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } - /** - * Get the next page of items. - * - * @param nextLink The URL to get the next list of items. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return an enumeration of shares along with {@link PagedResponse}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public PagedResponse listSharesSegmentNextNoCustomHeadersSinglePage(String nextLink, - Context context) { + private String getNextLink(BinaryData binaryData, String path) { try { - final String accept = "application/xml"; - Response res = service.listSharesSegmentNextNoCustomHeadersSync(nextLink, - this.client.getUrl(), this.client.getVersion(), this.client.getFileRequestIntent(), accept, context); - return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - res.getValue().getShareItems(), res.getValue().getNextMarker(), null); + try { + Map obj = binaryData.toObject(Map.class); + return (String) obj.get(path); + } catch (RuntimeException e) { + return null; + } } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java index 1ce207620adc..716d79980157 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation; import com.azure.core.annotation.BodyParam; @@ -10,48 +10,26 @@ import com.azure.core.annotation.HeaderParam; import com.azure.core.annotation.Host; import com.azure.core.annotation.HostParam; -import com.azure.core.annotation.PathParam; import com.azure.core.annotation.Put; -import com.azure.core.annotation.QueryParam; import com.azure.core.annotation.ReturnType; import com.azure.core.annotation.ServiceInterface; import com.azure.core.annotation.ServiceMethod; import com.azure.core.annotation.UnexpectedResponseExceptionType; +import com.azure.core.exception.ClientAuthenticationException; +import com.azure.core.exception.HttpResponseException; +import com.azure.core.exception.ResourceModifiedException; +import com.azure.core.exception.ResourceNotFoundException; +import com.azure.core.http.HttpHeaderName; +import com.azure.core.http.rest.RequestOptions; import com.azure.core.http.rest.Response; -import com.azure.core.http.rest.ResponseBase; import com.azure.core.http.rest.RestProxy; +import com.azure.core.util.BinaryData; import com.azure.core.util.Context; import com.azure.core.util.FluxUtil; -import com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType; -import com.azure.storage.file.share.implementation.models.SharePermission; -import com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper; -import com.azure.storage.file.share.implementation.models.ShareStats; +import com.azure.storage.file.share.ShareServiceVersion; import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal; -import com.azure.storage.file.share.implementation.models.SharesAcquireLeaseHeaders; -import com.azure.storage.file.share.implementation.models.SharesBreakLeaseHeaders; -import com.azure.storage.file.share.implementation.models.SharesChangeLeaseHeaders; -import com.azure.storage.file.share.implementation.models.SharesCreateHeaders; -import com.azure.storage.file.share.implementation.models.SharesCreatePermissionHeaders; -import com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders; -import com.azure.storage.file.share.implementation.models.SharesDeleteHeaders; -import com.azure.storage.file.share.implementation.models.SharesGetAccessPolicyHeaders; -import com.azure.storage.file.share.implementation.models.SharesGetPermissionHeaders; -import com.azure.storage.file.share.implementation.models.SharesGetPropertiesHeaders; -import com.azure.storage.file.share.implementation.models.SharesGetStatisticsHeaders; -import com.azure.storage.file.share.implementation.models.SharesReleaseLeaseHeaders; -import com.azure.storage.file.share.implementation.models.SharesRenewLeaseHeaders; -import com.azure.storage.file.share.implementation.models.SharesRestoreHeaders; -import com.azure.storage.file.share.implementation.models.SharesSetAccessPolicyHeaders; -import com.azure.storage.file.share.implementation.models.SharesSetMetadataHeaders; -import com.azure.storage.file.share.implementation.models.SharesSetPropertiesHeaders; import com.azure.storage.file.share.implementation.util.ModelHelper; -import com.azure.storage.file.share.models.FilePermissionFormat; -import com.azure.storage.file.share.models.ShareAccessTier; -import com.azure.storage.file.share.models.ShareRootSquash; -import com.azure.storage.file.share.models.ShareSignedIdentifier; import com.azure.storage.file.share.models.ShareTokenIntent; -import java.util.List; -import java.util.Map; import reactor.core.publisher.Mono; /** @@ -79,6 +57,19 @@ public final class SharesImpl { this.client = client; } + /** + * Gets Service version. + * + * @return the serviceVersion value. + */ + public ShareServiceVersion getServiceVersion() { + try { + return client.getServiceVersion(); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + /** * The interface defining all the services for AzureFileStorageShares to be used by the proxy service to perform * REST calls. @@ -87,5450 +78,1831 @@ public final class SharesImpl { @ServiceInterface(name = "AzureFileStorageShares") public interface SharesService { - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> create(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-share-quota") Integer quota, @HeaderParam("x-ms-access-tier") ShareAccessTier accessTier, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-enabled-protocols") String enabledProtocols, - @HeaderParam("x-ms-root-squash") ShareRootSquash rootSquash, - @HeaderParam("x-ms-enable-snapshot-virtual-directory-access") Boolean enableSnapshotVirtualDirectoryAccess, - @HeaderParam("x-ms-share-paid-bursting-enabled") Boolean paidBurstingEnabled, - @HeaderParam("x-ms-share-paid-bursting-max-bandwidth-mibps") Long paidBurstingMaxBandwidthMibps, - @HeaderParam("x-ms-share-paid-bursting-max-iops") Long paidBurstingMaxIops, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-share-provisioned-iops") Long shareProvisionedIops, - @HeaderParam("x-ms-share-provisioned-bandwidth-mibps") Long shareProvisionedBandwidthMibps, - @HeaderParam("x-ms-enable-smb-directory-lease") Boolean enableSmbDirectoryLease, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") + @Put("?restype=share") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-share-quota") Integer quota, @HeaderParam("x-ms-access-tier") ShareAccessTier accessTier, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-enabled-protocols") String enabledProtocols, - @HeaderParam("x-ms-root-squash") ShareRootSquash rootSquash, - @HeaderParam("x-ms-enable-snapshot-virtual-directory-access") Boolean enableSnapshotVirtualDirectoryAccess, - @HeaderParam("x-ms-share-paid-bursting-enabled") Boolean paidBurstingEnabled, - @HeaderParam("x-ms-share-paid-bursting-max-bandwidth-mibps") Long paidBurstingMaxBandwidthMibps, - @HeaderParam("x-ms-share-paid-bursting-max-iops") Long paidBurstingMaxIops, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-share-provisioned-iops") Long shareProvisionedIops, - @HeaderParam("x-ms-share-provisioned-bandwidth-mibps") Long shareProvisionedBandwidthMibps, - @HeaderParam("x-ms-enable-smb-directory-lease") Boolean enableSmbDirectoryLease, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase createSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-meta-") Map metadata, - @HeaderParam("x-ms-share-quota") Integer quota, @HeaderParam("x-ms-access-tier") ShareAccessTier accessTier, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-enabled-protocols") String enabledProtocols, - @HeaderParam("x-ms-root-squash") ShareRootSquash rootSquash, - @HeaderParam("x-ms-enable-snapshot-virtual-directory-access") Boolean enableSnapshotVirtualDirectoryAccess, - @HeaderParam("x-ms-share-paid-bursting-enabled") Boolean paidBurstingEnabled, - @HeaderParam("x-ms-share-paid-bursting-max-bandwidth-mibps") Long paidBurstingMaxBandwidthMibps, - @HeaderParam("x-ms-share-paid-bursting-max-iops") Long paidBurstingMaxIops, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-share-provisioned-iops") Long shareProvisionedIops, - @HeaderParam("x-ms-share-provisioned-bandwidth-mibps") Long shareProvisionedBandwidthMibps, - @HeaderParam("x-ms-enable-smb-directory-lease") Boolean enableSmbDirectoryLease, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> create(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response createNoCustomHeadersSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @QueryParam("restype") String restype, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-share-quota") Integer quota, - @HeaderParam("x-ms-access-tier") ShareAccessTier accessTier, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-enabled-protocols") String enabledProtocols, - @HeaderParam("x-ms-root-squash") ShareRootSquash rootSquash, - @HeaderParam("x-ms-enable-snapshot-virtual-directory-access") Boolean enableSnapshotVirtualDirectoryAccess, - @HeaderParam("x-ms-share-paid-bursting-enabled") Boolean paidBurstingEnabled, - @HeaderParam("x-ms-share-paid-bursting-max-bandwidth-mibps") Long paidBurstingMaxBandwidthMibps, - @HeaderParam("x-ms-share-paid-bursting-max-iops") Long paidBurstingMaxIops, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-share-provisioned-iops") Long shareProvisionedIops, - @HeaderParam("x-ms-share-provisioned-bandwidth-mibps") Long shareProvisionedBandwidthMibps, - @HeaderParam("x-ms-enable-smb-directory-lease") Boolean enableSmbDirectoryLease, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getProperties(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getPropertiesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response createSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}") + @Get("?restype=share") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getPropertiesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getProperties(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}") + @Get("?restype=share") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getPropertiesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Delete("/{shareName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> delete(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-delete-snapshots") DeleteSnapshotsOptionType deleteSnapshots, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Delete("/{shareName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> deleteNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-delete-snapshots") DeleteSnapshotsOptionType deleteSnapshots, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getPropertiesSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Delete("/{shareName}") + @Delete("?restype=share") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase deleteSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("sharesnapshot") String sharesnapshot, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-delete-snapshots") DeleteSnapshotsOptionType deleteSnapshots, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> delete(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Delete("/{shareName}") + @Delete("?restype=share") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response deleteNoCustomHeadersSync(@HostParam("url") String url, @PathParam("shareName") String shareName, - @QueryParam("restype") String restype, @QueryParam("sharesnapshot") String sharesnapshot, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-delete-snapshots") DeleteSnapshotsOptionType deleteSnapshots, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> acquireLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-duration") Integer duration, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> acquireLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-duration") Integer duration, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response deleteSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase acquireLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-duration") Integer duration, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> acquireLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response acquireLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-duration") Integer duration, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> releaseLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> releaseLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase releaseLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response releaseLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> changeLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> changeLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response acquireLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase changeLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> releaseLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response changeLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-proposed-lease-id") String proposedLeaseId, @HeaderParam("x-ms-version") String version, - @QueryParam("sharesnapshot") String sharesnapshot, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response releaseLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> renewLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> changeLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> renewLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response changeLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase renewLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> renewLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response renewLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-version") String version, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> breakLease(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-break-period") Integer breakPeriod, - @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> breakLeaseNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-break-period") Integer breakPeriod, - @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response renewLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase breakLeaseSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-break-period") Integer breakPeriod, - @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> breakLease(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=lease") @ExpectedResponses({ 202 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response breakLeaseNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("comp") String comp, - @HeaderParam("x-ms-lease-action") String action, @QueryParam("restype") String restype, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-lease-break-period") Integer breakPeriod, - @HeaderParam("x-ms-lease-id") String leaseId, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-client-request-id") String requestId, @QueryParam("sharesnapshot") String sharesnapshot, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createSnapshot(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createSnapshotNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase createSnapshotSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response createSnapshotNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createPermission(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/json") SharePermission sharePermission, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response breakLeaseSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-lease-action") String action, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=snapshot") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> createPermissionNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/json") SharePermission sharePermission, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> createSnapshot(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=snapshot") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase createPermissionSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/json") SharePermission sharePermission, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response createSnapshotSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=filepermission") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response createPermissionNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/json") SharePermission sharePermission, @HeaderParam("Accept") String accept, - Context context); - - @Get("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getPermission(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getPermissionNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getPermissionSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getPermissionNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @HeaderParam("x-ms-file-permission-key") String filePermissionKey, - @HeaderParam("x-ms-file-permission-format") FilePermissionFormat filePermissionFormat, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setProperties(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-share-quota") Integer quota, - @HeaderParam("x-ms-access-tier") ShareAccessTier accessTier, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-root-squash") ShareRootSquash rootSquash, - @HeaderParam("x-ms-enable-snapshot-virtual-directory-access") Boolean enableSnapshotVirtualDirectoryAccess, - @HeaderParam("x-ms-share-paid-bursting-enabled") Boolean paidBurstingEnabled, - @HeaderParam("x-ms-share-paid-bursting-max-bandwidth-mibps") Long paidBurstingMaxBandwidthMibps, - @HeaderParam("x-ms-share-paid-bursting-max-iops") Long paidBurstingMaxIops, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-share-provisioned-iops") Long shareProvisionedIops, - @HeaderParam("x-ms-share-provisioned-bandwidth-mibps") Long shareProvisionedBandwidthMibps, - @HeaderParam("x-ms-enable-smb-directory-lease") Boolean enableSmbDirectoryLease, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setPropertiesNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-share-quota") Integer quota, - @HeaderParam("x-ms-access-tier") ShareAccessTier accessTier, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-root-squash") ShareRootSquash rootSquash, - @HeaderParam("x-ms-enable-snapshot-virtual-directory-access") Boolean enableSnapshotVirtualDirectoryAccess, - @HeaderParam("x-ms-share-paid-bursting-enabled") Boolean paidBurstingEnabled, - @HeaderParam("x-ms-share-paid-bursting-max-bandwidth-mibps") Long paidBurstingMaxBandwidthMibps, - @HeaderParam("x-ms-share-paid-bursting-max-iops") Long paidBurstingMaxIops, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-share-provisioned-iops") Long shareProvisionedIops, - @HeaderParam("x-ms-share-provisioned-bandwidth-mibps") Long shareProvisionedBandwidthMibps, - @HeaderParam("x-ms-enable-smb-directory-lease") Boolean enableSmbDirectoryLease, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase setPropertiesSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-share-quota") Integer quota, - @HeaderParam("x-ms-access-tier") ShareAccessTier accessTier, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-root-squash") ShareRootSquash rootSquash, - @HeaderParam("x-ms-enable-snapshot-virtual-directory-access") Boolean enableSnapshotVirtualDirectoryAccess, - @HeaderParam("x-ms-share-paid-bursting-enabled") Boolean paidBurstingEnabled, - @HeaderParam("x-ms-share-paid-bursting-max-bandwidth-mibps") Long paidBurstingMaxBandwidthMibps, - @HeaderParam("x-ms-share-paid-bursting-max-iops") Long paidBurstingMaxIops, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-share-provisioned-iops") Long shareProvisionedIops, - @HeaderParam("x-ms-share-provisioned-bandwidth-mibps") Long shareProvisionedBandwidthMibps, - @HeaderParam("x-ms-enable-smb-directory-lease") Boolean enableSmbDirectoryLease, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response setPropertiesNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-share-quota") Integer quota, - @HeaderParam("x-ms-access-tier") ShareAccessTier accessTier, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-root-squash") ShareRootSquash rootSquash, - @HeaderParam("x-ms-enable-snapshot-virtual-directory-access") Boolean enableSnapshotVirtualDirectoryAccess, - @HeaderParam("x-ms-share-paid-bursting-enabled") Boolean paidBurstingEnabled, - @HeaderParam("x-ms-share-paid-bursting-max-bandwidth-mibps") Long paidBurstingMaxBandwidthMibps, - @HeaderParam("x-ms-share-paid-bursting-max-iops") Long paidBurstingMaxIops, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("x-ms-share-provisioned-iops") Long shareProvisionedIops, - @HeaderParam("x-ms-share-provisioned-bandwidth-mibps") Long shareProvisionedBandwidthMibps, - @HeaderParam("x-ms-enable-smb-directory-lease") Boolean enableSmbDirectoryLease, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setMetadata(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setMetadataNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase setMetadataSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Put("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response setMetadataNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-meta-") Map metadata, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - - @Get("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getAccessPolicy( - @HostParam("url") String url, @PathParam("shareName") String shareName, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> createPermission(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("Content-Type") String contentType, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @BodyParam("application/json") BinaryData permission, RequestOptions requestOptions, Context context); - @Get("/{shareName}") - @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getAccessPolicyNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, + @Put("?restype=share&comp=filepermission") + @ExpectedResponses({ 201 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response createPermissionSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("Content-Type") String contentType, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @BodyParam("application/json") BinaryData permission, RequestOptions requestOptions, Context context); - @Get("/{shareName}") + @Get("?restype=share&comp=filepermission") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getAccessPolicySync( - @HostParam("url") String url, @PathParam("shareName") String shareName, - @QueryParam("restype") String restype, @QueryParam("comp") String comp, - @QueryParam("timeout") Integer timeout, @HeaderParam("x-ms-version") String version, - @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getPermission(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-permission-key") String filePermissionKey, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Get("/{shareName}") + @Get("?restype=share&comp=filepermission") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getAccessPolicyNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getPermissionSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-permission-key") String filePermissionKey, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=properties") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setAccessPolicy(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/xml") ShareSignedIdentifierWrapper shareAcl, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> setProperties(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=properties") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> setAccessPolicyNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/xml") ShareSignedIdentifierWrapper shareAcl, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response setPropertiesSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=metadata") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase setAccessPolicySync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/xml") ShareSignedIdentifierWrapper shareAcl, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> setMetadata(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=metadata") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response setAccessPolicyNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @BodyParam("application/xml") ShareSignedIdentifierWrapper shareAcl, @HeaderParam("Accept") String accept, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response setMetadataSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, Context context); - @Get("/{shareName}") + @Get("?restype=share&comp=acl") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getStatistics(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getAccessPolicy(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Get("/{shareName}") + @Get("?restype=share&comp=acl") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> getStatisticsNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getAccessPolicySync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Get("/{shareName}") + @Put("?restype=share&comp=acl") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase getStatisticsSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> setAccessPolicy(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Get("/{shareName}") + @Put("?restype=share&comp=acl") @ExpectedResponses({ 200 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response getStatisticsNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-lease-id") String leaseId, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response setAccessPolicySync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> restore(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-deleted-share-name") String deletedShareName, - @HeaderParam("x-ms-deleted-share-version") String deletedShareVersion, + @Get("?restype=share&comp=stats") + @ExpectedResponses({ 200 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> getStatistics(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}") - @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Mono> restoreNoCustomHeaders(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-deleted-share-name") String deletedShareName, - @HeaderParam("x-ms-deleted-share-version") String deletedShareVersion, + @Get("?restype=share&comp=stats") + @ExpectedResponses({ 200 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response getStatisticsSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=undelete") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - ResponseBase restoreSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-deleted-share-name") String deletedShareName, - @HeaderParam("x-ms-deleted-share-version") String deletedShareVersion, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> restore(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); - @Put("/{shareName}") + @Put("?restype=share&comp=undelete") @ExpectedResponses({ 201 }) - @UnexpectedResponseExceptionType(ShareStorageExceptionInternal.class) - Response restoreNoCustomHeadersSync(@HostParam("url") String url, - @PathParam("shareName") String shareName, @QueryParam("restype") String restype, - @QueryParam("comp") String comp, @QueryParam("timeout") Integer timeout, - @HeaderParam("x-ms-version") String version, @HeaderParam("x-ms-client-request-id") String requestId, - @HeaderParam("x-ms-deleted-share-name") String deletedShareName, - @HeaderParam("x-ms-deleted-share-version") String deletedShareVersion, - @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, - @HeaderParam("Accept") String accept, Context context); - } - - /** - * Creates a new share under the specified account. If the share with the same name already exists, the operation - * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createWithResponseAsync(String shareName, Integer timeout, - Map metadata, Integer quota, ShareAccessTier accessTier, String enabledProtocols, - ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, - Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, Long shareProvisionedIops, - Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease) { - return FluxUtil - .withContext(context -> createWithResponseAsync(shareName, timeout, metadata, quota, accessTier, - enabledProtocols, rootSquash, enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, - paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, shareProvisionedIops, - shareProvisionedBandwidthMibps, enableSmbDirectoryLease, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new share under the specified account. If the share with the same name already exists, the operation - * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createWithResponseAsync(String shareName, Integer timeout, - Map metadata, Integer quota, ShareAccessTier accessTier, String enabledProtocols, - ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, - Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, Long shareProvisionedIops, - Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease, Context context) { - final String restype = "share"; - final String accept = "application/xml"; - return service.create(this.client.getUrl(), shareName, restype, timeout, metadata, quota, accessTier, - this.client.getVersion(), enabledProtocols, rootSquash, enableSnapshotVirtualDirectoryAccess, - paidBurstingEnabled, paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, this.client.getFileRequestIntent(), - shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new share under the specified account. If the share with the same name already exists, the operation - * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createAsync(String shareName, Integer timeout, Map metadata, Integer quota, - ShareAccessTier accessTier, String enabledProtocols, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease) { - return createWithResponseAsync(shareName, timeout, metadata, quota, accessTier, enabledProtocols, rootSquash, - enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, paidBurstingMaxBandwidthMibps, - paidBurstingMaxIops, shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a new share under the specified account. If the share with the same name already exists, the operation - * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createAsync(String shareName, Integer timeout, Map metadata, Integer quota, - ShareAccessTier accessTier, String enabledProtocols, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease, Context context) { - return createWithResponseAsync(shareName, timeout, metadata, quota, accessTier, enabledProtocols, rootSquash, - enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, paidBurstingMaxBandwidthMibps, - paidBurstingMaxIops, shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response restoreSync(@HostParam("url") String url, @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, RequestOptions requestOptions, + Context context); } /** * Creates a new share under the specified account. If the share with the same name already exists, the operation * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-share-quotaIntegerNoSpecifies the maximum size of the share, in + * gigabytes.
x-ms-access-tierStringNoSpecifies the access tier of the share. Allowed + * values: "TransactionOptimized", "Hot", "Cool", "Premium".
x-ms-enabled-protocolsStringNoProtocols to enable on the share.
x-ms-root-squashStringNoRoot squash to set on the share. Only valid for NFS + * shares. Allowed values: "NoRootSquash", "RootSquash", "AllSquash".
x-ms-enable-snapshot-virtual-directory-accessBooleanNoOptional. Used to enable + * snapshot virtual directory access.
x-ms-share-paid-bursting-enabledBooleanNoOptional. Boolean. Default if not + * specified is false. This property enables paid bursting.
x-ms-share-paid-bursting-max-iopsLongNoOptional. Integer. Default if not + * specified is the maximum IOPS the file share can support. Current maximum for a file share is 102,400 + * IOPS.
x-ms-share-paid-bursting-max-bandwidth-mibpsLongNoOptional. Integer. Default + * if not specified is the maximum throughput the file share can support. Current maximum for a file share is 10,340 + * MiB/sec.
x-ms-share-provisioned-iopsLongNoOptional. Specifies the provisioned IOPS of + * the share.
x-ms-share-provisioned-bandwidth-mibpsLongNoOptional. Specifies the + * provisioned bandwidth of the share, in MiBps.
x-ms-enable-smb-directory-leaseBooleanNoOptional. Used to enable SMB directory + * lease.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Map metadata, Integer quota, ShareAccessTier accessTier, String enabledProtocols, - ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, - Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, Long shareProvisionedIops, - Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease) { + public Mono> createWithResponseAsync(RequestOptions requestOptions) { return FluxUtil - .withContext(context -> createNoCustomHeadersWithResponseAsync(shareName, timeout, metadata, quota, - accessTier, enabledProtocols, rootSquash, enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, - paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, shareProvisionedIops, - shareProvisionedBandwidthMibps, enableSmbDirectoryLease, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a new share under the specified account. If the share with the same name already exists, the operation - * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Map metadata, Integer quota, ShareAccessTier accessTier, String enabledProtocols, - ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, - Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, Long shareProvisionedIops, - Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease, Context context) { - final String restype = "share"; - final String accept = "application/xml"; - return service.createNoCustomHeaders(this.client.getUrl(), shareName, restype, timeout, metadata, quota, - accessTier, this.client.getVersion(), enabledProtocols, rootSquash, enableSnapshotVirtualDirectoryAccess, - paidBurstingEnabled, paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, this.client.getFileRequestIntent(), - shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease, accept, context) + .withContext(context -> service.create(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** * Creates a new share under the specified account. If the share with the same name already exists, the operation * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase createWithResponse(String shareName, Integer timeout, - Map metadata, Integer quota, ShareAccessTier accessTier, String enabledProtocols, - ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, - Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, Long shareProvisionedIops, - Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease, Context context) { - try { - final String restype = "share"; - final String accept = "application/xml"; - return service.createSync(this.client.getUrl(), shareName, restype, timeout, metadata, quota, accessTier, - this.client.getVersion(), enabledProtocols, rootSquash, enableSnapshotVirtualDirectoryAccess, - paidBurstingEnabled, paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, - this.client.getFileRequestIntent(), shareProvisionedIops, shareProvisionedBandwidthMibps, - enableSmbDirectoryLease, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Creates a new share under the specified account. If the share with the same name already exists, the operation - * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void create(String shareName, Integer timeout, Map metadata, Integer quota, - ShareAccessTier accessTier, String enabledProtocols, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease) { - createWithResponse(shareName, timeout, metadata, quota, accessTier, enabledProtocols, rootSquash, - enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, paidBurstingMaxBandwidthMibps, - paidBurstingMaxIops, shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease, - Context.NONE); - } - - /** - * Creates a new share under the specified account. If the share with the same name already exists, the operation - * fails. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param enabledProtocols Protocols to enable on the share. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response createNoCustomHeadersWithResponse(String shareName, Integer timeout, - Map metadata, Integer quota, ShareAccessTier accessTier, String enabledProtocols, - ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, - Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, Long shareProvisionedIops, - Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease, Context context) { - try { - final String restype = "share"; - final String accept = "application/xml"; - return service.createNoCustomHeadersSync(this.client.getUrl(), shareName, restype, timeout, metadata, quota, - accessTier, this.client.getVersion(), enabledProtocols, rootSquash, - enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, paidBurstingMaxBandwidthMibps, - paidBurstingMaxIops, this.client.getFileRequestIntent(), shareProvisionedIops, - shareProvisionedBandwidthMibps, enableSmbDirectoryLease, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesWithResponseAsync(String shareName, - String sharesnapshot, Integer timeout, String leaseId) { - return FluxUtil - .withContext(context -> getPropertiesWithResponseAsync(shareName, sharesnapshot, timeout, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesWithResponseAsync(String shareName, - String sharesnapshot, Integer timeout, String leaseId, Context context) { - final String restype = "share"; - final String accept = "application/xml"; - return service - .getProperties(this.client.getUrl(), shareName, restype, sharesnapshot, timeout, this.client.getVersion(), - leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPropertiesAsync(String shareName, String sharesnapshot, Integer timeout, String leaseId) { - return getPropertiesWithResponseAsync(shareName, sharesnapshot, timeout, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPropertiesAsync(String shareName, String sharesnapshot, Integer timeout, String leaseId, - Context context) { - return getPropertiesWithResponseAsync(shareName, sharesnapshot, timeout, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesNoCustomHeadersWithResponseAsync(String shareName, String sharesnapshot, - Integer timeout, String leaseId) { - return FluxUtil - .withContext(context -> getPropertiesNoCustomHeadersWithResponseAsync(shareName, sharesnapshot, timeout, - leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPropertiesNoCustomHeadersWithResponseAsync(String shareName, String sharesnapshot, - Integer timeout, String leaseId, Context context) { - final String restype = "share"; - final String accept = "application/xml"; - return service - .getPropertiesNoCustomHeaders(this.client.getUrl(), shareName, restype, sharesnapshot, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase getPropertiesWithResponse(String shareName, - String sharesnapshot, Integer timeout, String leaseId, Context context) { - try { - final String restype = "share"; - final String accept = "application/xml"; - return service.getPropertiesSync(this.client.getUrl(), shareName, restype, sharesnapshot, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void getProperties(String shareName, String sharesnapshot, Integer timeout, String leaseId) { - getPropertiesWithResponse(shareName, sharesnapshot, timeout, leaseId, Context.NONE); - } - - /** - * Returns all user-defined metadata and system properties for the specified share or share snapshot. The data - * returned does not include the share's list of files. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response getPropertiesNoCustomHeadersWithResponse(String shareName, String sharesnapshot, - Integer timeout, String leaseId, Context context) { - try { - final String restype = "share"; - final String accept = "application/xml"; - return service.getPropertiesNoCustomHeadersSync(this.client.getUrl(), shareName, restype, sharesnapshot, - timeout, this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteWithResponseAsync(String shareName, String sharesnapshot, - Integer timeout, DeleteSnapshotsOptionType deleteSnapshots, String leaseId) { - return FluxUtil.withContext( - context -> deleteWithResponseAsync(shareName, sharesnapshot, timeout, deleteSnapshots, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteWithResponseAsync(String shareName, String sharesnapshot, - Integer timeout, DeleteSnapshotsOptionType deleteSnapshots, String leaseId, Context context) { - final String restype = "share"; - final String accept = "application/xml"; - return service - .delete(this.client.getUrl(), shareName, restype, sharesnapshot, timeout, this.client.getVersion(), - deleteSnapshots, leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono deleteAsync(String shareName, String sharesnapshot, Integer timeout, - DeleteSnapshotsOptionType deleteSnapshots, String leaseId) { - return deleteWithResponseAsync(shareName, sharesnapshot, timeout, deleteSnapshots, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono deleteAsync(String shareName, String sharesnapshot, Integer timeout, - DeleteSnapshotsOptionType deleteSnapshots, String leaseId, Context context) { - return deleteWithResponseAsync(shareName, sharesnapshot, timeout, deleteSnapshots, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteNoCustomHeadersWithResponseAsync(String shareName, String sharesnapshot, - Integer timeout, DeleteSnapshotsOptionType deleteSnapshots, String leaseId) { - return FluxUtil - .withContext(context -> deleteNoCustomHeadersWithResponseAsync(shareName, sharesnapshot, timeout, - deleteSnapshots, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> deleteNoCustomHeadersWithResponseAsync(String shareName, String sharesnapshot, - Integer timeout, DeleteSnapshotsOptionType deleteSnapshots, String leaseId, Context context) { - final String restype = "share"; - final String accept = "application/xml"; - return service - .deleteNoCustomHeaders(this.client.getUrl(), shareName, restype, sharesnapshot, timeout, - this.client.getVersion(), deleteSnapshots, leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase deleteWithResponse(String shareName, String sharesnapshot, - Integer timeout, DeleteSnapshotsOptionType deleteSnapshots, String leaseId, Context context) { - try { - final String restype = "share"; - final String accept = "application/xml"; - return service.deleteSync(this.client.getUrl(), shareName, restype, sharesnapshot, timeout, - this.client.getVersion(), deleteSnapshots, leaseId, this.client.getFileRequestIntent(), accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void delete(String shareName, String sharesnapshot, Integer timeout, - DeleteSnapshotsOptionType deleteSnapshots, String leaseId) { - deleteWithResponse(shareName, sharesnapshot, timeout, deleteSnapshots, leaseId, Context.NONE); - } - - /** - * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files - * contained within it are later deleted during garbage collection. - * - * @param shareName The name of the target share. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param deleteSnapshots Specifies the option include to delete the base share and all of its snapshots. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response deleteNoCustomHeadersWithResponse(String shareName, String sharesnapshot, Integer timeout, - DeleteSnapshotsOptionType deleteSnapshots, String leaseId, Context context) { - try { - final String restype = "share"; - final String accept = "application/xml"; - return service.deleteNoCustomHeadersSync(this.client.getUrl(), shareName, restype, sharesnapshot, timeout, - this.client.getVersion(), deleteSnapshots, leaseId, this.client.getFileRequestIntent(), accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> acquireLeaseWithResponseAsync(String shareName, - Integer timeout, Integer duration, String proposedLeaseId, String sharesnapshot, String requestId) { - return FluxUtil - .withContext(context -> acquireLeaseWithResponseAsync(shareName, timeout, duration, proposedLeaseId, - sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> acquireLeaseWithResponseAsync(String shareName, - Integer timeout, Integer duration, String proposedLeaseId, String sharesnapshot, String requestId, - Context context) { - final String comp = "lease"; - final String action = "acquire"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .acquireLease(this.client.getUrl(), shareName, comp, action, restype, timeout, duration, proposedLeaseId, - this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono acquireLeaseAsync(String shareName, Integer timeout, Integer duration, String proposedLeaseId, - String sharesnapshot, String requestId) { - return acquireLeaseWithResponseAsync(shareName, timeout, duration, proposedLeaseId, sharesnapshot, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono acquireLeaseAsync(String shareName, Integer timeout, Integer duration, String proposedLeaseId, - String sharesnapshot, String requestId, Context context) { - return acquireLeaseWithResponseAsync(shareName, timeout, duration, proposedLeaseId, sharesnapshot, requestId, - context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> acquireLeaseNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Integer duration, String proposedLeaseId, String sharesnapshot, String requestId) { - return FluxUtil - .withContext(context -> acquireLeaseNoCustomHeadersWithResponseAsync(shareName, timeout, duration, - proposedLeaseId, sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> acquireLeaseNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Integer duration, String proposedLeaseId, String sharesnapshot, String requestId, Context context) { - final String comp = "lease"; - final String action = "acquire"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .acquireLeaseNoCustomHeaders(this.client.getUrl(), shareName, comp, action, restype, timeout, duration, - proposedLeaseId, this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), - accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase acquireLeaseWithResponse(String shareName, Integer timeout, - Integer duration, String proposedLeaseId, String sharesnapshot, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "acquire"; - final String restype = "share"; - final String accept = "application/xml"; - return service.acquireLeaseSync(this.client.getUrl(), shareName, comp, action, restype, timeout, duration, - proposedLeaseId, this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), - accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void acquireLease(String shareName, Integer timeout, Integer duration, String proposedLeaseId, - String sharesnapshot, String requestId) { - acquireLeaseWithResponse(shareName, timeout, duration, proposedLeaseId, sharesnapshot, requestId, Context.NONE); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param duration Specifies the duration of the lease, in seconds, or negative one (-1) for a lease that never - * expires. A non-infinite lease can be between 15 and 60 seconds. A lease duration cannot be changed using renew or - * change. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response acquireLeaseNoCustomHeadersWithResponse(String shareName, Integer timeout, Integer duration, - String proposedLeaseId, String sharesnapshot, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "acquire"; - final String restype = "share"; - final String accept = "application/xml"; - return service.acquireLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, comp, action, restype, - timeout, duration, proposedLeaseId, this.client.getVersion(), sharesnapshot, requestId, - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> releaseLeaseWithResponseAsync(String shareName, - String leaseId, Integer timeout, String sharesnapshot, String requestId) { - return FluxUtil.withContext( - context -> releaseLeaseWithResponseAsync(shareName, leaseId, timeout, sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> releaseLeaseWithResponseAsync(String shareName, - String leaseId, Integer timeout, String sharesnapshot, String requestId, Context context) { - final String comp = "lease"; - final String action = "release"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .releaseLease(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, - this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono releaseLeaseAsync(String shareName, String leaseId, Integer timeout, String sharesnapshot, - String requestId) { - return releaseLeaseWithResponseAsync(shareName, leaseId, timeout, sharesnapshot, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono releaseLeaseAsync(String shareName, String leaseId, Integer timeout, String sharesnapshot, - String requestId, Context context) { - return releaseLeaseWithResponseAsync(shareName, leaseId, timeout, sharesnapshot, requestId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> releaseLeaseNoCustomHeadersWithResponseAsync(String shareName, String leaseId, - Integer timeout, String sharesnapshot, String requestId) { - return FluxUtil - .withContext(context -> releaseLeaseNoCustomHeadersWithResponseAsync(shareName, leaseId, timeout, - sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> releaseLeaseNoCustomHeadersWithResponseAsync(String shareName, String leaseId, - Integer timeout, String sharesnapshot, String requestId, Context context) { - final String comp = "lease"; - final String action = "release"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .releaseLeaseNoCustomHeaders(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, - this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase releaseLeaseWithResponse(String shareName, String leaseId, - Integer timeout, String sharesnapshot, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "release"; - final String restype = "share"; - final String accept = "application/xml"; - return service.releaseLeaseSync(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, - this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void releaseLease(String shareName, String leaseId, Integer timeout, String sharesnapshot, - String requestId) { - releaseLeaseWithResponse(shareName, leaseId, timeout, sharesnapshot, requestId, Context.NONE); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response releaseLeaseNoCustomHeadersWithResponse(String shareName, String leaseId, Integer timeout, - String sharesnapshot, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "release"; - final String restype = "share"; - final String accept = "application/xml"; - return service.releaseLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, comp, action, restype, - timeout, leaseId, this.client.getVersion(), sharesnapshot, requestId, - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> changeLeaseWithResponseAsync(String shareName, - String leaseId, Integer timeout, String proposedLeaseId, String sharesnapshot, String requestId) { - return FluxUtil - .withContext(context -> changeLeaseWithResponseAsync(shareName, leaseId, timeout, proposedLeaseId, - sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> changeLeaseWithResponseAsync(String shareName, - String leaseId, Integer timeout, String proposedLeaseId, String sharesnapshot, String requestId, - Context context) { - final String comp = "lease"; - final String action = "change"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .changeLease(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, proposedLeaseId, - this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono changeLeaseAsync(String shareName, String leaseId, Integer timeout, String proposedLeaseId, - String sharesnapshot, String requestId) { - return changeLeaseWithResponseAsync(shareName, leaseId, timeout, proposedLeaseId, sharesnapshot, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono changeLeaseAsync(String shareName, String leaseId, Integer timeout, String proposedLeaseId, - String sharesnapshot, String requestId, Context context) { - return changeLeaseWithResponseAsync(shareName, leaseId, timeout, proposedLeaseId, sharesnapshot, requestId, - context).onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> changeLeaseNoCustomHeadersWithResponseAsync(String shareName, String leaseId, - Integer timeout, String proposedLeaseId, String sharesnapshot, String requestId) { - return FluxUtil - .withContext(context -> changeLeaseNoCustomHeadersWithResponseAsync(shareName, leaseId, timeout, - proposedLeaseId, sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> changeLeaseNoCustomHeadersWithResponseAsync(String shareName, String leaseId, - Integer timeout, String proposedLeaseId, String sharesnapshot, String requestId, Context context) { - final String comp = "lease"; - final String action = "change"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .changeLeaseNoCustomHeaders(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, - proposedLeaseId, this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), - accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase changeLeaseWithResponse(String shareName, String leaseId, - Integer timeout, String proposedLeaseId, String sharesnapshot, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "change"; - final String restype = "share"; - final String accept = "application/xml"; - return service.changeLeaseSync(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, - proposedLeaseId, this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), - accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void changeLease(String shareName, String leaseId, Integer timeout, String proposedLeaseId, - String sharesnapshot, String requestId) { - changeLeaseWithResponse(shareName, leaseId, timeout, proposedLeaseId, sharesnapshot, requestId, Context.NONE); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param proposedLeaseId Proposed lease ID, in a GUID string format. The File service returns 400 (Invalid request) - * if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID - * string formats. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response changeLeaseNoCustomHeadersWithResponse(String shareName, String leaseId, Integer timeout, - String proposedLeaseId, String sharesnapshot, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "change"; - final String restype = "share"; - final String accept = "application/xml"; - return service.changeLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, comp, action, restype, - timeout, leaseId, proposedLeaseId, this.client.getVersion(), sharesnapshot, requestId, - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renewLeaseWithResponseAsync(String shareName, - String leaseId, Integer timeout, String sharesnapshot, String requestId) { - return FluxUtil - .withContext( - context -> renewLeaseWithResponseAsync(shareName, leaseId, timeout, sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renewLeaseWithResponseAsync(String shareName, - String leaseId, Integer timeout, String sharesnapshot, String requestId, Context context) { - final String comp = "lease"; - final String action = "renew"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .renewLease(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, - this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono renewLeaseAsync(String shareName, String leaseId, Integer timeout, String sharesnapshot, - String requestId) { - return renewLeaseWithResponseAsync(shareName, leaseId, timeout, sharesnapshot, requestId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono renewLeaseAsync(String shareName, String leaseId, Integer timeout, String sharesnapshot, - String requestId, Context context) { - return renewLeaseWithResponseAsync(shareName, leaseId, timeout, sharesnapshot, requestId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renewLeaseNoCustomHeadersWithResponseAsync(String shareName, String leaseId, - Integer timeout, String sharesnapshot, String requestId) { - return FluxUtil - .withContext(context -> renewLeaseNoCustomHeadersWithResponseAsync(shareName, leaseId, timeout, - sharesnapshot, requestId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> renewLeaseNoCustomHeadersWithResponseAsync(String shareName, String leaseId, - Integer timeout, String sharesnapshot, String requestId, Context context) { - final String comp = "lease"; - final String action = "renew"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .renewLeaseNoCustomHeaders(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, - this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase renewLeaseWithResponse(String shareName, String leaseId, - Integer timeout, String sharesnapshot, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "renew"; - final String restype = "share"; - final String accept = "application/xml"; - return service.renewLeaseSync(this.client.getUrl(), shareName, comp, action, restype, timeout, leaseId, - this.client.getVersion(), sharesnapshot, requestId, this.client.getFileRequestIntent(), accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void renewLease(String shareName, String leaseId, Integer timeout, String sharesnapshot, String requestId) { - renewLeaseWithResponse(shareName, leaseId, timeout, sharesnapshot, requestId, Context.NONE); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param leaseId Specifies the current lease ID on the resource. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response renewLeaseNoCustomHeadersWithResponse(String shareName, String leaseId, Integer timeout, - String sharesnapshot, String requestId, Context context) { - try { - final String comp = "lease"; - final String action = "renew"; - final String restype = "share"; - final String accept = "application/xml"; - return service.renewLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, comp, action, restype, - timeout, leaseId, this.client.getVersion(), sharesnapshot, requestId, - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> breakLeaseWithResponseAsync(String shareName, - Integer timeout, Integer breakPeriod, String leaseId, String requestId, String sharesnapshot) { - return FluxUtil - .withContext(context -> breakLeaseWithResponseAsync(shareName, timeout, breakPeriod, leaseId, requestId, - sharesnapshot, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> breakLeaseWithResponseAsync(String shareName, - Integer timeout, Integer breakPeriod, String leaseId, String requestId, String sharesnapshot, Context context) { - final String comp = "lease"; - final String action = "break"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .breakLease(this.client.getUrl(), shareName, comp, action, restype, timeout, breakPeriod, leaseId, - this.client.getVersion(), requestId, sharesnapshot, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono breakLeaseAsync(String shareName, Integer timeout, Integer breakPeriod, String leaseId, - String requestId, String sharesnapshot) { - return breakLeaseWithResponseAsync(shareName, timeout, breakPeriod, leaseId, requestId, sharesnapshot) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono breakLeaseAsync(String shareName, Integer timeout, Integer breakPeriod, String leaseId, - String requestId, String sharesnapshot, Context context) { - return breakLeaseWithResponseAsync(shareName, timeout, breakPeriod, leaseId, requestId, sharesnapshot, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> breakLeaseNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Integer breakPeriod, String leaseId, String requestId, String sharesnapshot) { - return FluxUtil - .withContext(context -> breakLeaseNoCustomHeadersWithResponseAsync(shareName, timeout, breakPeriod, leaseId, - requestId, sharesnapshot, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> breakLeaseNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Integer breakPeriod, String leaseId, String requestId, String sharesnapshot, Context context) { - final String comp = "lease"; - final String action = "break"; - final String restype = "share"; - final String accept = "application/xml"; - return service - .breakLeaseNoCustomHeaders(this.client.getUrl(), shareName, comp, action, restype, timeout, breakPeriod, - leaseId, this.client.getVersion(), requestId, sharesnapshot, this.client.getFileRequestIntent(), accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase breakLeaseWithResponse(String shareName, Integer timeout, - Integer breakPeriod, String leaseId, String requestId, String sharesnapshot, Context context) { - try { - final String comp = "lease"; - final String action = "break"; - final String restype = "share"; - final String accept = "application/xml"; - return service.breakLeaseSync(this.client.getUrl(), shareName, comp, action, restype, timeout, breakPeriod, - leaseId, this.client.getVersion(), requestId, sharesnapshot, this.client.getFileRequestIntent(), accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void breakLease(String shareName, Integer timeout, Integer breakPeriod, String leaseId, String requestId, - String sharesnapshot) { - breakLeaseWithResponse(shareName, timeout, breakPeriod, leaseId, requestId, sharesnapshot, Context.NONE); - } - - /** - * The Lease Share operation establishes and manages a lock on a share, or the specified snapshot for set and delete - * share operations. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param breakPeriod For a break operation, proposed duration the lease should continue before it is broken, in - * seconds, between 0 and 60. This break period is only used if it is shorter than the time remaining on the lease. - * If longer, the time remaining on the lease is used. A new lease will not be available before the break period has - * expired, but the lease may be held for longer than the break period. If this header does not appear with a break - * operation, a fixed-duration lease breaks after the remaining lease period elapses, and an infinite lease breaks - * immediately. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param sharesnapshot The snapshot parameter is an opaque DateTime value that, when present, specifies the share - * snapshot to query. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response breakLeaseNoCustomHeadersWithResponse(String shareName, Integer timeout, Integer breakPeriod, - String leaseId, String requestId, String sharesnapshot, Context context) { - try { - final String comp = "lease"; - final String action = "break"; - final String restype = "share"; - final String accept = "application/xml"; - return service.breakLeaseNoCustomHeadersSync(this.client.getUrl(), shareName, comp, action, restype, - timeout, breakPeriod, leaseId, this.client.getVersion(), requestId, sharesnapshot, - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createSnapshotWithResponseAsync(String shareName, - Integer timeout, Map metadata) { - return FluxUtil.withContext(context -> createSnapshotWithResponseAsync(shareName, timeout, metadata, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createSnapshotWithResponseAsync(String shareName, - Integer timeout, Map metadata, Context context) { - final String restype = "share"; - final String comp = "snapshot"; - final String accept = "application/xml"; - return service - .createSnapshot(this.client.getUrl(), shareName, restype, comp, timeout, metadata, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createSnapshotAsync(String shareName, Integer timeout, Map metadata) { - return createSnapshotWithResponseAsync(shareName, timeout, metadata) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createSnapshotAsync(String shareName, Integer timeout, Map metadata, - Context context) { - return createSnapshotWithResponseAsync(shareName, timeout, metadata, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createSnapshotNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Map metadata) { - return FluxUtil - .withContext( - context -> createSnapshotNoCustomHeadersWithResponseAsync(shareName, timeout, metadata, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createSnapshotNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Map metadata, Context context) { - final String restype = "share"; - final String comp = "snapshot"; - final String accept = "application/xml"; - return service - .createSnapshotNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, timeout, metadata, - this.client.getVersion(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase createSnapshotWithResponse(String shareName, Integer timeout, - Map metadata, Context context) { - try { - final String restype = "share"; - final String comp = "snapshot"; - final String accept = "application/xml"; - return service.createSnapshotSync(this.client.getUrl(), shareName, restype, comp, timeout, metadata, - this.client.getVersion(), this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void createSnapshot(String shareName, Integer timeout, Map metadata) { - createSnapshotWithResponse(shareName, timeout, metadata, Context.NONE); - } - - /** - * Creates a read-only snapshot of a share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response createSnapshotNoCustomHeadersWithResponse(String shareName, Integer timeout, - Map metadata, Context context) { - try { - final String restype = "share"; - final String comp = "snapshot"; - final String accept = "application/xml"; - return service.createSnapshotNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, timeout, - metadata, this.client.getVersion(), this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createPermissionWithResponseAsync(String shareName, - SharePermission sharePermission, Integer timeout) { - return FluxUtil - .withContext(context -> createPermissionWithResponseAsync(shareName, sharePermission, timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createPermissionWithResponseAsync(String shareName, - SharePermission sharePermission, Integer timeout, Context context) { - final String restype = "share"; - final String comp = "filepermission"; - final String accept = "application/xml"; - return service - .createPermission(this.client.getUrl(), shareName, restype, comp, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), sharePermission, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createPermissionAsync(String shareName, SharePermission sharePermission, Integer timeout) { - return createPermissionWithResponseAsync(shareName, sharePermission, timeout) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono createPermissionAsync(String shareName, SharePermission sharePermission, Integer timeout, - Context context) { - return createPermissionWithResponseAsync(shareName, sharePermission, timeout, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createPermissionNoCustomHeadersWithResponseAsync(String shareName, - SharePermission sharePermission, Integer timeout) { - return FluxUtil.withContext( - context -> createPermissionNoCustomHeadersWithResponseAsync(shareName, sharePermission, timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> createPermissionNoCustomHeadersWithResponseAsync(String shareName, - SharePermission sharePermission, Integer timeout, Context context) { - final String restype = "share"; - final String comp = "filepermission"; - final String accept = "application/xml"; - return service - .createPermissionNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), sharePermission, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase createPermissionWithResponse(String shareName, - SharePermission sharePermission, Integer timeout, Context context) { - try { - final String restype = "share"; - final String comp = "filepermission"; - final String accept = "application/xml"; - return service.createPermissionSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), sharePermission, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void createPermission(String shareName, SharePermission sharePermission, Integer timeout) { - createPermissionWithResponse(shareName, sharePermission, timeout, Context.NONE); - } - - /** - * Create a permission (a security descriptor). - * - * @param shareName The name of the target share. - * @param sharePermission A permission (a security descriptor) at the share level. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response createPermissionNoCustomHeadersWithResponse(String shareName, SharePermission sharePermission, - Integer timeout, Context context) { - try { - final String restype = "share"; - final String comp = "filepermission"; - final String accept = "application/xml"; - return service.createPermissionNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), this.client.getFileRequestIntent(), sharePermission, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level along with {@link ResponseBase} on successful - * completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPermissionWithResponseAsync( - String shareName, String filePermissionKey, FilePermissionFormat filePermissionFormat, Integer timeout) { - return FluxUtil - .withContext(context -> getPermissionWithResponseAsync(shareName, filePermissionKey, filePermissionFormat, - timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level along with {@link ResponseBase} on successful - * completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPermissionWithResponseAsync( - String shareName, String filePermissionKey, FilePermissionFormat filePermissionFormat, Integer timeout, - Context context) { - final String restype = "share"; - final String comp = "filepermission"; - final String accept = "application/json"; - return service - .getPermission(this.client.getUrl(), shareName, restype, comp, filePermissionKey, filePermissionFormat, - timeout, this.client.getVersion(), this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPermissionAsync(String shareName, String filePermissionKey, - FilePermissionFormat filePermissionFormat, Integer timeout) { - return getPermissionWithResponseAsync(shareName, filePermissionKey, filePermissionFormat, timeout) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getPermissionAsync(String shareName, String filePermissionKey, - FilePermissionFormat filePermissionFormat, Integer timeout, Context context) { - return getPermissionWithResponseAsync(shareName, filePermissionKey, filePermissionFormat, timeout, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level along with {@link Response} on successful - * completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPermissionNoCustomHeadersWithResponseAsync(String shareName, - String filePermissionKey, FilePermissionFormat filePermissionFormat, Integer timeout) { - return FluxUtil - .withContext(context -> getPermissionNoCustomHeadersWithResponseAsync(shareName, filePermissionKey, - filePermissionFormat, timeout, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level along with {@link Response} on successful - * completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getPermissionNoCustomHeadersWithResponseAsync(String shareName, - String filePermissionKey, FilePermissionFormat filePermissionFormat, Integer timeout, Context context) { - final String restype = "share"; - final String comp = "filepermission"; - final String accept = "application/json"; - return service - .getPermissionNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, filePermissionKey, - filePermissionFormat, timeout, this.client.getVersion(), this.client.getFileRequestIntent(), accept, - context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level along with {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase getPermissionWithResponse(String shareName, - String filePermissionKey, FilePermissionFormat filePermissionFormat, Integer timeout, Context context) { - try { - final String restype = "share"; - final String comp = "filepermission"; - final String accept = "application/json"; - return service.getPermissionSync(this.client.getUrl(), shareName, restype, comp, filePermissionKey, - filePermissionFormat, timeout, this.client.getVersion(), this.client.getFileRequestIntent(), accept, - context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public SharePermission getPermission(String shareName, String filePermissionKey, - FilePermissionFormat filePermissionFormat, Integer timeout) { - try { - return getPermissionWithResponse(shareName, filePermissionKey, filePermissionFormat, timeout, Context.NONE) - .getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns the permission (security descriptor) for a given key. - * - * @param shareName The name of the target share. - * @param filePermissionKey Key of the permission to be set for the directory/file. - * @param filePermissionFormat Optional. Available for version 2023-06-01 and later. Specifies the format in which - * the permission is returned. Acceptable values are SDDL or binary. If x-ms-file-permission-format is unspecified - * or explicitly set to SDDL, the permission is returned in SDDL format. If x-ms-file-permission-format is - * explicitly set to binary, the permission is returned as a base64 string representing the binary encoding of the - * permission. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a permission (a security descriptor) at the share level along with {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response getPermissionNoCustomHeadersWithResponse(String shareName, - String filePermissionKey, FilePermissionFormat filePermissionFormat, Integer timeout, Context context) { - try { - final String restype = "share"; - final String comp = "filepermission"; - final String accept = "application/json"; - return service.getPermissionNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, - filePermissionKey, filePermissionFormat, timeout, this.client.getVersion(), - this.client.getFileRequestIntent(), accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesWithResponseAsync(String shareName, - Integer timeout, Integer quota, ShareAccessTier accessTier, String leaseId, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease) { - return FluxUtil.withContext(context -> setPropertiesWithResponseAsync(shareName, timeout, quota, accessTier, - leaseId, rootSquash, enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, - paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, shareProvisionedIops, shareProvisionedBandwidthMibps, - enableSmbDirectoryLease, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesWithResponseAsync(String shareName, - Integer timeout, Integer quota, ShareAccessTier accessTier, String leaseId, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease, Context context) { - final String restype = "share"; - final String comp = "properties"; - final String accept = "application/xml"; - return service - .setProperties(this.client.getUrl(), shareName, restype, comp, timeout, this.client.getVersion(), quota, - accessTier, leaseId, rootSquash, enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, - paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, this.client.getFileRequestIntent(), - shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setPropertiesAsync(String shareName, Integer timeout, Integer quota, ShareAccessTier accessTier, - String leaseId, ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, - Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, - Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease) { - return setPropertiesWithResponseAsync(shareName, timeout, quota, accessTier, leaseId, rootSquash, - enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, paidBurstingMaxBandwidthMibps, - paidBurstingMaxIops, shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setPropertiesAsync(String shareName, Integer timeout, Integer quota, ShareAccessTier accessTier, - String leaseId, ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, - Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, - Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease, - Context context) { - return setPropertiesWithResponseAsync(shareName, timeout, quota, accessTier, leaseId, rootSquash, - enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, paidBurstingMaxBandwidthMibps, - paidBurstingMaxIops, shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Integer quota, ShareAccessTier accessTier, String leaseId, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease) { - return FluxUtil - .withContext(context -> setPropertiesNoCustomHeadersWithResponseAsync(shareName, timeout, quota, accessTier, - leaseId, rootSquash, enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, - paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, shareProvisionedIops, - shareProvisionedBandwidthMibps, enableSmbDirectoryLease, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setPropertiesNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Integer quota, ShareAccessTier accessTier, String leaseId, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease, Context context) { - final String restype = "share"; - final String comp = "properties"; - final String accept = "application/xml"; - return service.setPropertiesNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), quota, accessTier, leaseId, rootSquash, enableSnapshotVirtualDirectoryAccess, - paidBurstingEnabled, paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, this.client.getFileRequestIntent(), - shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease, accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase setPropertiesWithResponse(String shareName, Integer timeout, - Integer quota, ShareAccessTier accessTier, String leaseId, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease, Context context) { - try { - final String restype = "share"; - final String comp = "properties"; - final String accept = "application/xml"; - return service.setPropertiesSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), quota, accessTier, leaseId, rootSquash, enableSnapshotVirtualDirectoryAccess, - paidBurstingEnabled, paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, - this.client.getFileRequestIntent(), shareProvisionedIops, shareProvisionedBandwidthMibps, - enableSmbDirectoryLease, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public void setProperties(String shareName, Integer timeout, Integer quota, ShareAccessTier accessTier, - String leaseId, ShareRootSquash rootSquash, Boolean enableSnapshotVirtualDirectoryAccess, - Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, Long paidBurstingMaxIops, - Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, Boolean enableSmbDirectoryLease) { - setPropertiesWithResponse(shareName, timeout, quota, accessTier, leaseId, rootSquash, - enableSnapshotVirtualDirectoryAccess, paidBurstingEnabled, paidBurstingMaxBandwidthMibps, - paidBurstingMaxIops, shareProvisionedIops, shareProvisionedBandwidthMibps, enableSmbDirectoryLease, - Context.NONE); - } - - /** - * Sets properties for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param quota Specifies the maximum size of the share, in gigabytes. - * @param accessTier Specifies the access tier of the share. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param rootSquash Root squash to set on the share. Only valid for NFS shares. - * @param enableSnapshotVirtualDirectoryAccess The enableSnapshotVirtualDirectoryAccess parameter. - * @param paidBurstingEnabled Optional. Boolean. Default if not specified is false. This property enables paid - * bursting. - * @param paidBurstingMaxBandwidthMibps Optional. Integer. Default if not specified is the maximum throughput the - * file share can support. Current maximum for a file share is 10,340 MiB/sec. - * @param paidBurstingMaxIops Optional. Integer. Default if not specified is the maximum IOPS the file share can - * support. Current maximum for a file share is 102,400 IOPS. - * @param shareProvisionedIops Optional. Supported in version 2025-01-05 and later. Only allowed for provisioned v2 - * file shares. Specifies the provisioned number of input/output operations per second (IOPS) of the share. If this - * is not specified, the provisioned IOPS is set to value calculated based on recommendation formula. - * @param shareProvisionedBandwidthMibps Optional. Supported in version 2025-01-05 and later. Only allowed for - * provisioned v2 file shares. Specifies the provisioned bandwidth of the share, in mebibytes per second (MiBps). If - * this is not specified, the provisioned bandwidth is set to value calculated based on recommendation formula. - * @param enableSmbDirectoryLease SMB only, default is true. Specifies whether granting of new directory leases for - * directories present in a share are to be enabled or disabled. An input of true specifies that granting of new - * directory leases is to be allowed. An input of false specifies that granting of new directory leases is to be - * blocked. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Response setPropertiesNoCustomHeadersWithResponse(String shareName, Integer timeout, Integer quota, - ShareAccessTier accessTier, String leaseId, ShareRootSquash rootSquash, - Boolean enableSnapshotVirtualDirectoryAccess, Boolean paidBurstingEnabled, Long paidBurstingMaxBandwidthMibps, - Long paidBurstingMaxIops, Long shareProvisionedIops, Long shareProvisionedBandwidthMibps, - Boolean enableSmbDirectoryLease, Context context) { - try { - final String restype = "share"; - final String comp = "properties"; - final String accept = "application/xml"; - return service.setPropertiesNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), quota, accessTier, leaseId, rootSquash, enableSnapshotVirtualDirectoryAccess, - paidBurstingEnabled, paidBurstingMaxBandwidthMibps, paidBurstingMaxIops, - this.client.getFileRequestIntent(), shareProvisionedIops, shareProvisionedBandwidthMibps, - enableSmbDirectoryLease, accept, context); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataWithResponseAsync(String shareName, - Integer timeout, Map metadata, String leaseId) { - return FluxUtil - .withContext(context -> setMetadataWithResponseAsync(shareName, timeout, metadata, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataWithResponseAsync(String shareName, - Integer timeout, Map metadata, String leaseId, Context context) { - final String restype = "share"; - final String comp = "metadata"; - final String accept = "application/xml"; - return service - .setMetadata(this.client.getUrl(), shareName, restype, comp, timeout, metadata, this.client.getVersion(), - leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setMetadataAsync(String shareName, Integer timeout, Map metadata, - String leaseId) { - return setMetadataWithResponseAsync(shareName, timeout, metadata, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setMetadataAsync(String shareName, Integer timeout, Map metadata, String leaseId, - Context context) { - return setMetadataWithResponseAsync(shareName, timeout, metadata, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Map metadata, String leaseId) { - return FluxUtil - .withContext( - context -> setMetadataNoCustomHeadersWithResponseAsync(shareName, timeout, metadata, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setMetadataNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - Map metadata, String leaseId, Context context) { - final String restype = "share"; - final String comp = "metadata"; - final String accept = "application/xml"; - return service - .setMetadataNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, timeout, metadata, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-share-quotaIntegerNoSpecifies the maximum size of the share, in + * gigabytes.
x-ms-access-tierStringNoSpecifies the access tier of the share. Allowed + * values: "TransactionOptimized", "Hot", "Cool", "Premium".
x-ms-enabled-protocolsStringNoProtocols to enable on the share.
x-ms-root-squashStringNoRoot squash to set on the share. Only valid for NFS + * shares. Allowed values: "NoRootSquash", "RootSquash", "AllSquash".
x-ms-enable-snapshot-virtual-directory-accessBooleanNoOptional. Used to enable + * snapshot virtual directory access.
x-ms-share-paid-bursting-enabledBooleanNoOptional. Boolean. Default if not + * specified is false. This property enables paid bursting.
x-ms-share-paid-bursting-max-iopsLongNoOptional. Integer. Default if not + * specified is the maximum IOPS the file share can support. Current maximum for a file share is 102,400 + * IOPS.
x-ms-share-paid-bursting-max-bandwidth-mibpsLongNoOptional. Integer. Default + * if not specified is the maximum throughput the file share can support. Current maximum for a file share is 10,340 + * MiB/sec.
x-ms-share-provisioned-iopsLongNoOptional. Specifies the provisioned IOPS of + * the share.
x-ms-share-provisioned-bandwidth-mibpsLongNoOptional. Specifies the + * provisioned bandwidth of the share, in MiBps.
x-ms-enable-smb-directory-leaseBooleanNoOptional. Used to enable SMB directory + * lease.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase setMetadataWithResponse(String shareName, Integer timeout, - Map metadata, String leaseId, Context context) { + public Response createWithResponse(RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "metadata"; - final String accept = "application/xml"; - return service.setMetadataSync(this.client.getUrl(), shareName, restype, comp, timeout, metadata, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); + return service.createSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Returns all user-defined metadata and system properties for the specified share or share snapshot. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void setMetadata(String shareName, Integer timeout, Map metadata, String leaseId) { - setMetadataWithResponse(shareName, timeout, metadata, leaseId, Context.NONE); - } - - /** - * Sets one or more user-defined name-value pairs for the specified share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param metadata A name-value pair to associate with a file storage object. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + public Mono> getPropertiesWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext( + context -> service.getProperties(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Returns all user-defined metadata and system properties for the specified share or share snapshot. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response setMetadataNoCustomHeadersWithResponse(String shareName, Integer timeout, - Map metadata, String leaseId, Context context) { + public Response getPropertiesWithResponse(RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "metadata"; - final String accept = "application/xml"; - return service.setMetadataNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, timeout, - metadata, this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); + return service.getPropertiesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Returns information about stored access policies specified on the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers along with {@link ResponseBase} on successful completion of - * {@link Mono}. + * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files + * contained within it are later deleted during garbage collection. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-delete-snapshotsStringNoSpecifies the option include to delete the base + * share and all of its snapshots. Allowed values: "include", "include-leased".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - getAccessPolicyWithResponseAsync(String shareName, Integer timeout, String leaseId) { - return FluxUtil.withContext(context -> getAccessPolicyWithResponseAsync(shareName, timeout, leaseId, context)) + public Mono> deleteWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext(context -> service.delete(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Returns information about stored access policies specified on the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers along with {@link ResponseBase} on successful completion of - * {@link Mono}. + * Operation marks the specified share or share snapshot for deletion. The share or share snapshot and any files + * contained within it are later deleted during garbage collection. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-delete-snapshotsStringNoSpecifies the option include to delete the base + * share and all of its snapshots. Allowed values: "include", "include-leased".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - getAccessPolicyWithResponseAsync(String shareName, Integer timeout, String leaseId, Context context) { - final String restype = "share"; - final String comp = "acl"; - final String accept = "application/xml"; - return service - .getAccessPolicy(this.client.getUrl(), shareName, restype, comp, timeout, this.client.getVersion(), leaseId, - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + public Response deleteWithResponse(RequestOptions requestOptions) { + try { + return service.deleteSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Returns information about stored access policies specified on the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers on successful completion of {@link Mono}. + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-durationIntegerNoSpecifies the duration of the lease, in seconds, + * or negative one (-1) for a lease that never expires. A non-infinite lease can be between 15 and 60 seconds. A + * lease duration cannot be changed using renew or change.
x-ms-proposed-lease-idStringNoProposed lease ID, in a GUID string format. The + * File service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid + * Constructor (String) for a list of valid GUID string formats.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getAccessPolicyAsync(String shareName, Integer timeout, String leaseId) { - return getAccessPolicyWithResponseAsync(shareName, timeout, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); - } - - /** - * Returns information about stored access policies specified on the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers on successful completion of {@link Mono}. + public Mono> acquireLeaseWithResponseAsync(RequestOptions requestOptions) { + final String action = "acquire"; + return FluxUtil + .withContext( + context -> service.acquireLease(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + action, this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-durationIntegerNoSpecifies the duration of the lease, in seconds, + * or negative one (-1) for a lease that never expires. A non-infinite lease can be between 15 and 60 seconds. A + * lease duration cannot be changed using renew or change.
x-ms-proposed-lease-idStringNoProposed lease ID, in a GUID string format. The + * File service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid + * Constructor (String) for a list of valid GUID string formats.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getAccessPolicyAsync(String shareName, Integer timeout, String leaseId, - Context context) { - return getAccessPolicyWithResponseAsync(shareName, timeout, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); + public Response acquireLeaseWithResponse(RequestOptions requestOptions) { + try { + final String action = "acquire"; + return service.acquireLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), action, + this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Returns information about stored access policies specified on the share. + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers along with {@link Response} on successful completion of {@link Mono}. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> - getAccessPolicyNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, String leaseId) { + public Mono> releaseLeaseWithResponseAsync(String leaseId, RequestOptions requestOptions) { + final String action = "release"; return FluxUtil .withContext( - context -> getAccessPolicyNoCustomHeadersWithResponseAsync(shareName, timeout, leaseId, context)) + context -> service.releaseLease(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + leaseId, action, this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Returns information about stored access policies specified on the share. + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getAccessPolicyNoCustomHeadersWithResponseAsync( - String shareName, Integer timeout, String leaseId, Context context) { - final String restype = "share"; - final String comp = "acl"; - final String accept = "application/xml"; - return service - .getAccessPolicyNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Returns information about stored access policies specified on the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers along with {@link ResponseBase}. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase - getAccessPolicyWithResponse(String shareName, Integer timeout, String leaseId, Context context) { + public Response releaseLeaseWithResponse(String leaseId, RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "acl"; - final String accept = "application/xml"; - return service.getAccessPolicySync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); + final String action = "release"; + return service.releaseLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), leaseId, + action, this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Returns information about stored access policies specified on the share. + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-proposed-lease-idStringNoProposed lease ID, in a GUID string format. The + * File service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid + * Constructor (String) for a list of valid GUID string formats.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ShareSignedIdentifierWrapper getAccessPolicy(String shareName, Integer timeout, String leaseId) { - try { - return getAccessPolicyWithResponse(shareName, timeout, leaseId, Context.NONE).getValue(); - } catch (ShareStorageExceptionInternal internalException) { - throw ModelHelper.mapToShareStorageException(internalException); - } - } - - /** - * Returns information about stored access policies specified on the share. + public Mono> changeLeaseWithResponseAsync(String leaseId, RequestOptions requestOptions) { + final String action = "change"; + return FluxUtil + .withContext( + context -> service.changeLease(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + leaseId, action, this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-proposed-lease-idStringNoProposed lease ID, in a GUID string format. The + * File service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid + * Constructor (String) for a list of valid GUID string formats.
+ * You can add these to a request with {@link RequestOptions#addHeader} * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return a collection of signed identifiers along with {@link Response}. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response getAccessPolicyNoCustomHeadersWithResponse(String shareName, - Integer timeout, String leaseId, Context context) { + public Response changeLeaseWithResponse(String leaseId, RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "acl"; - final String accept = "application/xml"; - return service.getAccessPolicyNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); + final String action = "change"; + return service.changeLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), leaseId, + action, this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Sets a stored access policy for use with shared access signatures. + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setAccessPolicyWithResponseAsync(String shareName, - Integer timeout, String leaseId, List shareAcl) { + public Mono> renewLeaseWithResponseAsync(String leaseId, RequestOptions requestOptions) { + final String action = "renew"; return FluxUtil - .withContext(context -> setAccessPolicyWithResponseAsync(shareName, timeout, leaseId, shareAcl, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Sets a stored access policy for use with shared access signatures. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setAccessPolicyWithResponseAsync(String shareName, - Integer timeout, String leaseId, List shareAcl, Context context) { - final String restype = "share"; - final String comp = "acl"; - final String accept = "application/xml"; - ShareSignedIdentifierWrapper shareAclConverted = new ShareSignedIdentifierWrapper(shareAcl); - return service - .setAccessPolicy(this.client.getUrl(), shareName, restype, comp, timeout, this.client.getVersion(), leaseId, - this.client.getFileRequestIntent(), shareAclConverted, accept, context) + .withContext( + context -> service.renewLease(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + leaseId, action, this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Sets a stored access policy for use with shared access signatures. + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * @param leaseId Specifies the current lease ID on the resource. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setAccessPolicyAsync(String shareName, Integer timeout, String leaseId, - List shareAcl) { - return setAccessPolicyWithResponseAsync(shareName, timeout, leaseId, shareAcl) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); + public Response renewLeaseWithResponse(String leaseId, RequestOptions requestOptions) { + try { + final String action = "renew"; + return service.renewLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), leaseId, + action, this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Sets a stored access policy for use with shared access signatures. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-break-periodIntegerNoFor a break operation, proposed duration the + * lease should continue before it is broken, in seconds, between 0 and 60. This break period is only used if it is + * shorter than the time remaining on the lease. If longer, the time remaining on the lease is used. A new lease + * will not be available before the break period has expired, but the lease may be held for longer than the break + * period. If this header does not appear with a break operation, a fixed-duration lease breaks after the remaining + * lease period elapses, and an infinite lease breaks immediately.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono setAccessPolicyAsync(String shareName, Integer timeout, String leaseId, - List shareAcl, Context context) { - return setAccessPolicyWithResponseAsync(shareName, timeout, leaseId, shareAcl, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Sets a stored access policy for use with shared access signatures. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. + public Mono> breakLeaseWithResponseAsync(RequestOptions requestOptions) { + final String action = "break"; + return FluxUtil + .withContext( + context -> service.breakLease(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + action, this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * The Lease Share operation establishes and manages a lock on a share for delete operations. The lock duration can + * be 15 to 60 seconds, or can be infinite. + *

Query Parameters

+ * + * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that + * specifies a share snapshot.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-break-periodIntegerNoFor a break operation, proposed duration the + * lease should continue before it is broken, in seconds, between 0 and 60. This break period is only used if it is + * shorter than the time remaining on the lease. If longer, the time remaining on the lease is used. A new lease + * will not be available before the break period has expired, but the lease may be held for longer than the break + * period. If this header does not appear with a break operation, a fixed-duration lease breaks after the remaining + * lease period elapses, and an infinite lease breaks immediately.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setAccessPolicyNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - String leaseId, List shareAcl) { - return FluxUtil.withContext( - context -> setAccessPolicyNoCustomHeadersWithResponseAsync(shareName, timeout, leaseId, shareAcl, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + public Response breakLeaseWithResponse(RequestOptions requestOptions) { + try { + final String action = "break"; + return service.breakLeaseSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), action, + this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Sets a stored access policy for use with shared access signatures. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Creates a read-only snapshot of a share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> setAccessPolicyNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - String leaseId, List shareAcl, Context context) { - final String restype = "share"; - final String comp = "acl"; - final String accept = "application/xml"; - ShareSignedIdentifierWrapper shareAclConverted = new ShareSignedIdentifierWrapper(shareAcl); - return service.setAccessPolicyNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), shareAclConverted, accept, context) + public Mono> createSnapshotWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext( + context -> service.createSnapshot(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Sets a stored access policy for use with shared access signatures. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * Creates a read-only snapshot of a share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase setAccessPolicyWithResponse(String shareName, - Integer timeout, String leaseId, List shareAcl, Context context) { + public Response createSnapshotWithResponse(RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "acl"; - final String accept = "application/xml"; - ShareSignedIdentifierWrapper shareAclConverted = new ShareSignedIdentifierWrapper(shareAcl); - return service.setAccessPolicySync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), shareAclConverted, accept, - context); + return service.createSnapshotSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Sets a stored access policy for use with shared access signatures. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Create a permission (a security descriptor). This is used to support file level ACLs for SMB shares. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Request Body Schema

+ * + * 
+     * {@code
+     * {
+     *     permission: String (Required)
+     *     format: String(Sddl/Binary) (Optional)
+     * }
+     * }
+     *
+ * + * @param permission A permission (a security descriptor) at the share level. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void setAccessPolicy(String shareName, Integer timeout, String leaseId, - List shareAcl) { - setAccessPolicyWithResponse(shareName, timeout, leaseId, shareAcl, Context.NONE); - } - - /** - * Sets a stored access policy for use with shared access signatures. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param shareAcl The ACL for the share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + public Mono> createPermissionWithResponseAsync(BinaryData permission, + RequestOptions requestOptions) { + final String contentType = "application/json"; + return FluxUtil + .withContext( + context -> service.createPermission(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + contentType, this.client.getFileRequestIntent(), permission, requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Create a permission (a security descriptor). This is used to support file level ACLs for SMB shares. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Request Body Schema

+ * + * 
+     * {@code
+     * {
+     *     permission: String (Required)
+     *     format: String(Sddl/Binary) (Optional)
+     * }
+     * }
+     *
+ * + * @param permission A permission (a security descriptor) at the share level. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response setAccessPolicyNoCustomHeadersWithResponse(String shareName, Integer timeout, String leaseId, - List shareAcl, Context context) { + public Response createPermissionWithResponse(BinaryData permission, RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "acl"; - final String accept = "application/xml"; - ShareSignedIdentifierWrapper shareAclConverted = new ShareSignedIdentifierWrapper(shareAcl); - return service.setAccessPolicyNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), shareAclConverted, accept, - context); + final String contentType = "application/json"; + return service.createPermissionSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + contentType, this.client.getFileRequestIntent(), permission, requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share along with {@link ResponseBase} on successful completion of {@link Mono}. + * Returns the permission (security descriptor) for a given permission key. This is used to support file level ACLs + * for SMB shares. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-permission-formatStringNoOptional. Specifies the format in which the + * permission is returned. Acceptable values are SDDL or binary. Allowed values: "Sddl", "Binary".
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     permission: String (Required)
+     *     format: String(Sddl/Binary) (Optional)
+     * }
+     * }
+     *
+ * + * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the + * x-ms-file-permission or x-ms-file-permission-key should be specified. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return a permission (a security descriptor) at the share level along with {@link Response} on successful + * completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getStatisticsWithResponseAsync(String shareName, - Integer timeout, String leaseId) { - return FluxUtil.withContext(context -> getStatisticsWithResponseAsync(shareName, timeout, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share along with {@link ResponseBase} on successful completion of {@link Mono}. + public Mono> getPermissionWithResponseAsync(String filePermissionKey, + RequestOptions requestOptions) { + final String accept = "application/json"; + return FluxUtil + .withContext( + context -> service.getPermission(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + filePermissionKey, this.client.getFileRequestIntent(), accept, requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Returns the permission (security descriptor) for a given permission key. This is used to support file level ACLs + * for SMB shares. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-file-permission-formatStringNoOptional. Specifies the format in which the + * permission is returned. Acceptable values are SDDL or binary. Allowed values: "Sddl", "Binary".
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     permission: String (Required)
+     *     format: String(Sddl/Binary) (Optional)
+     * }
+     * }
+     *
+ * + * @param filePermissionKey Key of the permission to be set for the directory/file. Note: Only one of the + * x-ms-file-permission or x-ms-file-permission-key should be specified. + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return a permission (a security descriptor) at the share level along with {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getStatisticsWithResponseAsync(String shareName, - Integer timeout, String leaseId, Context context) { - final String restype = "share"; - final String comp = "stats"; - final String accept = "application/xml"; - return service - .getStatistics(this.client.getUrl(), shareName, restype, comp, timeout, this.client.getVersion(), leaseId, - this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + public Response getPermissionWithResponse(String filePermissionKey, RequestOptions requestOptions) { + try { + final String accept = "application/json"; + return service.getPermissionSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + filePermissionKey, this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share on successful completion of {@link Mono}. + * Sets properties for the specified share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-share-quotaIntegerNoSpecifies the maximum size of the share, in + * gigabytes.
x-ms-access-tierStringNoSpecifies the access tier of the share. Allowed + * values: "TransactionOptimized", "Hot", "Cool", "Premium".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-root-squashStringNoRoot squash to set on the share. Only valid for NFS + * shares. Allowed values: "NoRootSquash", "RootSquash", "AllSquash".
x-ms-enable-snapshot-virtual-directory-accessBooleanNoOptional. Used to enable + * snapshot virtual directory access.
x-ms-share-paid-bursting-enabledBooleanNoOptional. Boolean. Default if not + * specified is false. This property enables paid bursting.
x-ms-share-paid-bursting-max-iopsLongNoOptional. Integer. Default if not + * specified is the maximum IOPS the file share can support. Current maximum for a file share is 102,400 + * IOPS.
x-ms-share-paid-bursting-max-bandwidth-mibpsLongNoOptional. Integer. Default + * if not specified is the maximum throughput the file share can support. Current maximum for a file share is 10,340 + * MiB/sec.
x-ms-share-provisioned-iopsLongNoOptional. Specifies the provisioned IOPS of + * the share.
x-ms-share-provisioned-bandwidth-mibpsLongNoOptional. Specifies the + * provisioned bandwidth of the share, in MiBps.
x-ms-enable-smb-directory-leaseBooleanNoOptional. Used to enable SMB directory + * lease.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getStatisticsAsync(String shareName, Integer timeout, String leaseId) { - return getStatisticsWithResponseAsync(shareName, timeout, leaseId) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); + public Mono> setPropertiesWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext( + context -> service.setProperties(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share on successful completion of {@link Mono}. + * Sets properties for the specified share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-share-quotaIntegerNoSpecifies the maximum size of the share, in + * gigabytes.
x-ms-access-tierStringNoSpecifies the access tier of the share. Allowed + * values: "TransactionOptimized", "Hot", "Cool", "Premium".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
x-ms-root-squashStringNoRoot squash to set on the share. Only valid for NFS + * shares. Allowed values: "NoRootSquash", "RootSquash", "AllSquash".
x-ms-enable-snapshot-virtual-directory-accessBooleanNoOptional. Used to enable + * snapshot virtual directory access.
x-ms-share-paid-bursting-enabledBooleanNoOptional. Boolean. Default if not + * specified is false. This property enables paid bursting.
x-ms-share-paid-bursting-max-iopsLongNoOptional. Integer. Default if not + * specified is the maximum IOPS the file share can support. Current maximum for a file share is 102,400 + * IOPS.
x-ms-share-paid-bursting-max-bandwidth-mibpsLongNoOptional. Integer. Default + * if not specified is the maximum throughput the file share can support. Current maximum for a file share is 10,340 + * MiB/sec.
x-ms-share-provisioned-iopsLongNoOptional. Specifies the provisioned IOPS of + * the share.
x-ms-share-provisioned-bandwidth-mibpsLongNoOptional. Specifies the + * provisioned bandwidth of the share, in MiBps.
x-ms-enable-smb-directory-leaseBooleanNoOptional. Used to enable SMB directory + * lease.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono getStatisticsAsync(String shareName, Integer timeout, String leaseId, Context context) { - return getStatisticsWithResponseAsync(shareName, timeout, leaseId, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(res -> Mono.justOrEmpty(res.getValue())); + public Response setPropertiesWithResponse(RequestOptions requestOptions) { + try { + return service.setPropertiesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } } /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share along with {@link Response} on successful completion of {@link Mono}. + * Sets one or more user-defined name-value pairs for the specified share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getStatisticsNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - String leaseId) { + public Mono> setMetadataWithResponseAsync(RequestOptions requestOptions) { return FluxUtil - .withContext(context -> getStatisticsNoCustomHeadersWithResponseAsync(shareName, timeout, leaseId, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share along with {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> getStatisticsNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - String leaseId, Context context) { - final String restype = "share"; - final String comp = "stats"; - final String accept = "application/xml"; - return service - .getStatisticsNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context) + .withContext( + context -> service.setMetadata(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share along with {@link ResponseBase}. + * Sets one or more user-defined name-value pairs for the specified share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-metaStringNoOptional. User-defined metadata for the resource.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase getStatisticsWithResponse(String shareName, - Integer timeout, String leaseId, Context context) { + public Response setMetadataWithResponse(RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "stats"; - final String accept = "application/xml"; - return service.getStatisticsSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); + return service.setMetadataSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share. + * Returns information about stored access policies specified on the share that may be used with Shared Access + * Signatures. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     SignedIdentifier (Required): [
+     *          (Required){
+     *             Id: String (Required)
+     *             AccessPolicy (Optional): {
+     *                 Start: OffsetDateTime (Optional)
+     *                 Expiry: OffsetDateTime (Optional)
+     *                 Permission: String (Optional)
+     *             }
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return represents an array of signed identifiers along with {@link Response} on successful completion of + * {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ShareStats getStatistics(String shareName, Integer timeout, String leaseId) { + public Mono> getAccessPolicyWithResponseAsync(RequestOptions requestOptions) { + final String accept = "application/xml"; + return FluxUtil + .withContext( + context -> service.getAccessPolicy(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), accept, requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Returns information about stored access policies specified on the share that may be used with Shared Access + * Signatures. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     SignedIdentifier (Required): [
+     *          (Required){
+     *             Id: String (Required)
+     *             AccessPolicy (Optional): {
+     *                 Start: OffsetDateTime (Optional)
+     *                 Expiry: OffsetDateTime (Optional)
+     *                 Permission: String (Optional)
+     *             }
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return represents an array of signed identifiers along with {@link Response}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + public Response getAccessPolicyWithResponse(RequestOptions requestOptions) { try { - return getStatisticsWithResponse(shareName, timeout, leaseId, Context.NONE).getValue(); + final String accept = "application/xml"; + return service.getAccessPolicySync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Retrieves statistics related to the share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param leaseId If specified, the operation only succeeds if the resource's lease is active and matches this ID. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return stats for the share along with {@link Response}. + * Sets stored access policies for the share that may be used with Shared Access Signatures. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
Content-TypeStringNoThe content type. Allowed values: + * "application/xml".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Request Body Schema

+ * + * 
+     * {@code
+     * {
+     *     SignedIdentifier (Required): [
+     *          (Required){
+     *             Id: String (Required)
+     *             AccessPolicy (Optional): {
+     *                 Start: OffsetDateTime (Optional)
+     *                 Expiry: OffsetDateTime (Optional)
+     *                 Permission: String (Optional)
+     *             }
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. + */ + @ServiceMethod(returns = ReturnType.SINGLE) + public Mono> setAccessPolicyWithResponseAsync(RequestOptions requestOptions) { + RequestOptions requestOptionsLocal = requestOptions == null ? new RequestOptions() : requestOptions; + requestOptionsLocal.addRequestCallback(requestLocal -> { + if (requestLocal.getBody() != null && requestLocal.getHeaders().get(HttpHeaderName.CONTENT_TYPE) == null) { + requestLocal.getHeaders().set(HttpHeaderName.CONTENT_TYPE, "application/xml"); + } + }); + return FluxUtil + .withContext( + context -> service.setAccessPolicy(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptionsLocal, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Sets stored access policies for the share that may be used with Shared Access Signatures. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
Content-TypeStringNoThe content type. Allowed values: + * "application/xml".
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Request Body Schema

+ * + * 
+     * {@code
+     * {
+     *     SignedIdentifier (Required): [
+     *          (Required){
+     *             Id: String (Required)
+     *             AccessPolicy (Optional): {
+     *                 Start: OffsetDateTime (Optional)
+     *                 Expiry: OffsetDateTime (Optional)
+     *                 Permission: String (Optional)
+     *             }
+     *         }
+     *     ]
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response getStatisticsNoCustomHeadersWithResponse(String shareName, Integer timeout, - String leaseId, Context context) { + public Response setAccessPolicyWithResponse(RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "stats"; - final String accept = "application/xml"; - return service.getStatisticsNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), leaseId, this.client.getFileRequestIntent(), accept, context); + RequestOptions requestOptionsLocal = requestOptions == null ? new RequestOptions() : requestOptions; + requestOptionsLocal.addRequestCallback(requestLocal -> { + if (requestLocal.getBody() != null + && requestLocal.getHeaders().get(HttpHeaderName.CONTENT_TYPE) == null) { + requestLocal.getHeaders().set(HttpHeaderName.CONTENT_TYPE, "application/xml"); + } + }); + return service.setAccessPolicySync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptionsLocal, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> restoreWithResponseAsync(String shareName, Integer timeout, - String requestId, String deletedShareName, String deletedShareVersion) { - return FluxUtil - .withContext(context -> restoreWithResponseAsync(shareName, timeout, requestId, deletedShareName, - deletedShareVersion, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase} on successful completion of {@link Mono}. + * Retrieves statistics related to the share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     ShareUsageBytes: long (Required)
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return stats for the share along with {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> restoreWithResponseAsync(String shareName, Integer timeout, - String requestId, String deletedShareName, String deletedShareVersion, Context context) { - final String restype = "share"; - final String comp = "undelete"; + public Mono> getStatisticsWithResponseAsync(RequestOptions requestOptions) { final String accept = "application/xml"; - return service - .restore(this.client.getUrl(), shareName, restype, comp, timeout, this.client.getVersion(), requestId, - deletedShareName, deletedShareVersion, this.client.getFileRequestIntent(), accept, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono restoreAsync(String shareName, Integer timeout, String requestId, String deletedShareName, - String deletedShareVersion) { - return restoreWithResponseAsync(shareName, timeout, requestId, deletedShareName, deletedShareVersion) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return A {@link Mono} that completes when a successful response is received. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono restoreAsync(String shareName, Integer timeout, String requestId, String deletedShareName, - String deletedShareVersion, Context context) { - return restoreWithResponseAsync(shareName, timeout, requestId, deletedShareName, deletedShareVersion, context) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) - .flatMap(ignored -> Mono.empty()); - } - - /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> restoreNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - String requestId, String deletedShareName, String deletedShareVersion) { return FluxUtil - .withContext(context -> restoreNoCustomHeadersWithResponseAsync(shareName, timeout, requestId, - deletedShareName, deletedShareVersion, context)) - .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); - } - - /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link Response} on successful completion of {@link Mono}. - */ - @ServiceMethod(returns = ReturnType.SINGLE) - public Mono> restoreNoCustomHeadersWithResponseAsync(String shareName, Integer timeout, - String requestId, String deletedShareName, String deletedShareVersion, Context context) { - final String restype = "share"; - final String comp = "undelete"; - final String accept = "application/xml"; - return service - .restoreNoCustomHeaders(this.client.getUrl(), shareName, restype, comp, timeout, this.client.getVersion(), - requestId, deletedShareName, deletedShareVersion, this.client.getFileRequestIntent(), accept, context) + .withContext( + context -> service.getStatistics(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), accept, requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); } /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. - * @return the {@link ResponseBase}. + * Retrieves statistics related to the share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the + * file.
+ * You can add these to a request with {@link RequestOptions#addHeader} + *

Response Body Schema

+ * + * 
+     * {@code
+     * {
+     *     ShareUsageBytes: long (Required)
+     * }
+     * }
+     *
+ * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return stats for the share along with {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public ResponseBase restoreWithResponse(String shareName, Integer timeout, - String requestId, String deletedShareName, String deletedShareVersion, Context context) { + public Response getStatisticsWithResponse(RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "undelete"; final String accept = "application/xml"; - return service.restoreSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), requestId, deletedShareName, deletedShareVersion, - this.client.getFileRequestIntent(), accept, context); + return service.getStatisticsSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } } /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + * Restores a previously deleted share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-deleted-share-nameStringNoSpecifies the name of the previously-deleted + * share.
x-ms-deleted-share-versionStringNoSpecifies the version of the + * previously-deleted share.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. + * @return the {@link Response} on successful completion of {@link Mono}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public void restore(String shareName, Integer timeout, String requestId, String deletedShareName, - String deletedShareVersion) { - restoreWithResponse(shareName, timeout, requestId, deletedShareName, deletedShareVersion, Context.NONE); - } - - /** - * Restores a previously deleted Share. - * - * @param shareName The name of the target share. - * @param timeout The timeout parameter is expressed in seconds. For more information, see <a - * href="https://learn.microsoft.com/rest/api/storageservices/Setting-Timeouts-for-File-Service-Operations">Setting - * Timeouts for File Service Operations.</a>. - * @param requestId Provides a client-generated, opaque value with a 1 KB character limit that is recorded in the - * analytics logs when storage analytics logging is enabled. - * @param deletedShareName Specifies the name of the previously-deleted share. - * @param deletedShareVersion Specifies the version of the previously-deleted share. - * @param context The context to associate with this operation. - * @throws IllegalArgumentException thrown if parameters fail the validation. - * @throws ShareStorageExceptionInternal thrown if the request is rejected by server. - * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent. + public Mono> restoreWithResponseAsync(RequestOptions requestOptions) { + return FluxUtil + .withContext(context -> service.restore(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context)) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException); + } + + /** + * Restores a previously deleted share. + *

Query Parameters

+ * + * + * + * + *
Query Parameters
NameTypeRequiredDescription
timeoutIntegerNoThe timeout parameter is expressed in seconds.
+ * You can add these to a request with {@link RequestOptions#addQueryParam} + *

Header Parameters

+ * + * + * + * + * + *
Header Parameters
NameTypeRequiredDescription
x-ms-deleted-share-nameStringNoSpecifies the name of the previously-deleted + * share.
x-ms-deleted-share-versionStringNoSpecifies the version of the + * previously-deleted share.
+ * You can add these to a request with {@link RequestOptions#addHeader} + * + * @param requestOptions The options to configure the HTTP request before HTTP client sends it. + * @throws HttpResponseException thrown if the request is rejected by server. + * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401. + * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404. + * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409. * @return the {@link Response}. */ @ServiceMethod(returns = ReturnType.SINGLE) - public Response restoreNoCustomHeadersWithResponse(String shareName, Integer timeout, String requestId, - String deletedShareName, String deletedShareVersion, Context context) { + public Response restoreWithResponse(RequestOptions requestOptions) { try { - final String restype = "share"; - final String comp = "undelete"; - final String accept = "application/xml"; - return service.restoreNoCustomHeadersSync(this.client.getUrl(), shareName, restype, comp, timeout, - this.client.getVersion(), requestId, deletedShareName, deletedShareVersion, - this.client.getFileRequestIntent(), accept, context); + return service.restoreSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, Context.NONE); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java new file mode 100644 index 000000000000..15a0ab771cf7 --- /dev/null +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java @@ -0,0 +1,78 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. +// Code generated by Microsoft (R) TypeSpec Code Generator. + +package com.azure.storage.file.share.implementation; + +import com.azure.core.util.serializer.ObjectSerializer; +import com.azure.core.util.serializer.TypeReference; +import com.azure.xml.XmlReader; +import com.azure.xml.XmlSerializable; +import com.azure.xml.XmlWriter; +import java.io.IOException; +import java.io.InputStream; +import java.io.OutputStream; +import java.io.UncheckedIOException; +import java.lang.reflect.InvocationTargetException; +import java.lang.reflect.Method; +import java.util.concurrent.ConcurrentHashMap; +import javax.xml.stream.XMLStreamException; +import reactor.core.publisher.Mono; + +// DO NOT modify this helper class + +/** + * An {@link ObjectSerializer} implementation that serializes and deserializes {@link XmlSerializable} types using + * {@code azure-xml}. Deserialization relies on the generated static {@code fromXml(XmlReader)} factory method on the + * target type. + */ +public final class XmlSerializer implements ObjectSerializer { + + private static final ConcurrentHashMap, Method> FROM_XML_CACHE = new ConcurrentHashMap<>(); + + @Override + @SuppressWarnings("unchecked") + public T deserialize(InputStream stream, TypeReference typeReference) { + Class clazz = (Class) typeReference.getJavaClass(); + Method fromXml = FROM_XML_CACHE.computeIfAbsent(clazz, c -> { + try { + return c.getDeclaredMethod("fromXml", XmlReader.class); + } catch (NoSuchMethodException e) { + throw new IllegalStateException( + "Type " + c.getName() + " does not have a static fromXml(XmlReader) method.", e); + } + }); + try (XmlReader xmlReader = XmlReader.fromStream(stream)) { + return (T) fromXml.invoke(null, xmlReader); + } catch (XMLStreamException | IllegalAccessException e) { + throw new IllegalStateException(e); + } catch (InvocationTargetException e) { + throw new IllegalStateException(e.getCause() == null ? e : e.getCause()); + } + } + + @Override + public Mono deserializeAsync(InputStream stream, TypeReference typeReference) { + return Mono.fromCallable(() -> deserialize(stream, typeReference)); + } + + @Override + public void serialize(OutputStream stream, Object value) { + if (!(value instanceof XmlSerializable)) { + throw new IllegalArgumentException("Value must implement XmlSerializable to be serialized as XML, but was: " + + (value == null ? "null" : value.getClass().getName())); + } + try (XmlWriter xmlWriter = XmlWriter.toStream(stream)) { + xmlWriter.writeStartDocument(); + xmlWriter.writeXml((XmlSerializable) value); + xmlWriter.flush(); + } catch (XMLStreamException e) { + throw new UncheckedIOException(new IOException(e)); + } + } + + @Override + public Mono serializeAsync(OutputStream stream, Object value) { + return Mono.fromRunnable(() -> serialize(stream, value)); + } +} diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java new file mode 100644 index 000000000000..fdbe36863c39 --- /dev/null +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java @@ -0,0 +1,29 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. +// Code generated by Microsoft (R) TypeSpec Code Generator. + +package com.azure.storage.file.share.implementation; + +import com.azure.core.util.serializer.ObjectSerializer; + +// DO NOT modify this helper class + +/** + * This class is a proxy for creating an {@link ObjectSerializer} that serializes and deserializes XML payloads using + * {@code azure-xml}. It mirrors the pattern of {@code JsonSerializerProviders} in {@code azure-core}, but for XML. + */ +public final class XmlSerializerProviders { + + /** + * Creates an instance of an XML {@link ObjectSerializer}. + * + * @return A new instance of an XML {@link ObjectSerializer}. + */ + public static ObjectSerializer createInstance() { + return new XmlSerializer(); + } + + private XmlSerializerProviders() { + // no-op + } +} diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java index 5db13033adbf..d5f4687cb9c1 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java @@ -1,20 +1,20 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; /** - * Defines values for DeleteSnapshotsOptionType. + * The delete snapshots option type. */ public enum DeleteSnapshotsOptionType { /** - * Enum value include. + * include. */ INCLUDE("include"), /** - * Enum value include-leased. + * include-leased. */ INCLUDE_LEASED("include-leased"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java index 5b72c5ea86d4..26103c5e8d7b 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.xml.XmlReader; import com.azure.xml.XmlSerializable; import com.azure.xml.XmlToken; @@ -16,16 +16,16 @@ /** * A listed directory item. */ -@Fluent +@Immutable public final class DirectoryItem implements XmlSerializable { /* - * The Name property. + * The directory name. */ @Generated - private StringEncoded name; + private final StringEncoded name; /* - * The FileId property. + * The file ID. */ @Generated private String fileId; @@ -37,26 +37,29 @@ public final class DirectoryItem implements XmlSerializable { private FileProperty properties; /* - * The Attributes property. + * The file attributes. */ @Generated private String attributes; /* - * The PermissionKey property. + * The permission key. */ @Generated private String permissionKey; /** * Creates an instance of DirectoryItem class. + * + * @param name the name value to set. */ @Generated - public DirectoryItem() { + private DirectoryItem(StringEncoded name) { + this.name = name; } /** - * Get the name property: The Name property. + * Get the name property: The directory name. * * @return the name value. */ @@ -66,19 +69,7 @@ public StringEncoded getName() { } /** - * Set the name property: The Name property. - * - * @param name the name value to set. - * @return the DirectoryItem object itself. - */ - @Generated - public DirectoryItem setName(StringEncoded name) { - this.name = name; - return this; - } - - /** - * Get the fileId property: The FileId property. + * Get the fileId property: The file ID. * * @return the fileId value. */ @@ -87,18 +78,6 @@ public String getFileId() { return this.fileId; } - /** - * Set the fileId property: The FileId property. - * - * @param fileId the fileId value to set. - * @return the DirectoryItem object itself. - */ - @Generated - public DirectoryItem setFileId(String fileId) { - this.fileId = fileId; - return this; - } - /** * Get the properties property: File properties. * @@ -110,19 +89,7 @@ public FileProperty getProperties() { } /** - * Set the properties property: File properties. - * - * @param properties the properties value to set. - * @return the DirectoryItem object itself. - */ - @Generated - public DirectoryItem setProperties(FileProperty properties) { - this.properties = properties; - return this; - } - - /** - * Get the attributes property: The Attributes property. + * Get the attributes property: The file attributes. * * @return the attributes value. */ @@ -132,19 +99,7 @@ public String getAttributes() { } /** - * Set the attributes property: The Attributes property. - * - * @param attributes the attributes value to set. - * @return the DirectoryItem object itself. - */ - @Generated - public DirectoryItem setAttributes(String attributes) { - this.attributes = attributes; - return this; - } - - /** - * Get the permissionKey property: The PermissionKey property. + * Get the permissionKey property: The permission key. * * @return the permissionKey value. */ @@ -153,18 +108,6 @@ public String getPermissionKey() { return this.permissionKey; } - /** - * Set the permissionKey property: The PermissionKey property. - * - * @param permissionKey the permissionKey value to set. - * @return the DirectoryItem object itself. - */ - @Generated - public DirectoryItem setPermissionKey(String permissionKey) { - this.permissionKey = permissionKey; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @@ -190,6 +133,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of DirectoryItem if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the DirectoryItem. */ @Generated @@ -205,6 +149,7 @@ public static DirectoryItem fromXml(XmlReader xmlReader) throws XMLStreamExcepti * cases where the model can deserialize from different root element names. * @return An instance of DirectoryItem if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the DirectoryItem. */ @Generated @@ -212,24 +157,33 @@ public static DirectoryItem fromXml(XmlReader xmlReader, String rootElementName) String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "Directory" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - DirectoryItem deserializedDirectoryItem = new DirectoryItem(); + StringEncoded name = null; + String fileId = null; + FileProperty properties = null; + String attributes = null; + String permissionKey = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("Name".equals(elementName.getLocalPart())) { - deserializedDirectoryItem.name = StringEncoded.fromXml(reader, "Name"); + name = StringEncoded.fromXml(reader, "Name"); } else if ("FileId".equals(elementName.getLocalPart())) { - deserializedDirectoryItem.fileId = reader.getStringElement(); + fileId = reader.getStringElement(); } else if ("Properties".equals(elementName.getLocalPart())) { - deserializedDirectoryItem.properties = FileProperty.fromXml(reader, "Properties"); + properties = FileProperty.fromXml(reader, "Properties"); } else if ("Attributes".equals(elementName.getLocalPart())) { - deserializedDirectoryItem.attributes = reader.getStringElement(); + attributes = reader.getStringElement(); } else if ("PermissionKey".equals(elementName.getLocalPart())) { - deserializedDirectoryItem.permissionKey = reader.getStringElement(); + permissionKey = reader.getStringElement(); } else { reader.skipElement(); } } + DirectoryItem deserializedDirectoryItem = new DirectoryItem(name); + deserializedDirectoryItem.fileId = fileId; + deserializedDirectoryItem.properties = properties; + deserializedDirectoryItem.attributes = attributes; + deserializedDirectoryItem.permissionKey = permissionKey; return deserializedDirectoryItem; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java index c8338e96372d..27e60beab2c4 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.xml.XmlReader; import com.azure.xml.XmlSerializable; import com.azure.xml.XmlToken; @@ -16,16 +16,16 @@ /** * A listed file item. */ -@Fluent +@Immutable public final class FileItem implements XmlSerializable { /* - * The Name property. + * The file name. */ @Generated - private StringEncoded name; + private final StringEncoded name; /* - * The FileId property. + * The file ID. */ @Generated private String fileId; @@ -34,29 +34,34 @@ public final class FileItem implements XmlSerializable { * File properties. */ @Generated - private FileProperty properties; + private final FileProperty properties; /* - * The Attributes property. + * The file attributes. */ @Generated private String attributes; /* - * The PermissionKey property. + * The permission key. */ @Generated private String permissionKey; /** * Creates an instance of FileItem class. + * + * @param name the name value to set. + * @param properties the properties value to set. */ @Generated - public FileItem() { + private FileItem(StringEncoded name, FileProperty properties) { + this.name = name; + this.properties = properties; } /** - * Get the name property: The Name property. + * Get the name property: The file name. * * @return the name value. */ @@ -66,19 +71,7 @@ public StringEncoded getName() { } /** - * Set the name property: The Name property. - * - * @param name the name value to set. - * @return the FileItem object itself. - */ - @Generated - public FileItem setName(StringEncoded name) { - this.name = name; - return this; - } - - /** - * Get the fileId property: The FileId property. + * Get the fileId property: The file ID. * * @return the fileId value. */ @@ -87,18 +80,6 @@ public String getFileId() { return this.fileId; } - /** - * Set the fileId property: The FileId property. - * - * @param fileId the fileId value to set. - * @return the FileItem object itself. - */ - @Generated - public FileItem setFileId(String fileId) { - this.fileId = fileId; - return this; - } - /** * Get the properties property: File properties. * @@ -110,19 +91,7 @@ public FileProperty getProperties() { } /** - * Set the properties property: File properties. - * - * @param properties the properties value to set. - * @return the FileItem object itself. - */ - @Generated - public FileItem setProperties(FileProperty properties) { - this.properties = properties; - return this; - } - - /** - * Get the attributes property: The Attributes property. + * Get the attributes property: The file attributes. * * @return the attributes value. */ @@ -132,19 +101,7 @@ public String getAttributes() { } /** - * Set the attributes property: The Attributes property. - * - * @param attributes the attributes value to set. - * @return the FileItem object itself. - */ - @Generated - public FileItem setAttributes(String attributes) { - this.attributes = attributes; - return this; - } - - /** - * Get the permissionKey property: The PermissionKey property. + * Get the permissionKey property: The permission key. * * @return the permissionKey value. */ @@ -153,18 +110,6 @@ public String getPermissionKey() { return this.permissionKey; } - /** - * Set the permissionKey property: The PermissionKey property. - * - * @param permissionKey the permissionKey value to set. - * @return the FileItem object itself. - */ - @Generated - public FileItem setPermissionKey(String permissionKey) { - this.permissionKey = permissionKey; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @@ -190,6 +135,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of FileItem if the XmlReader was pointing to an instance of it, or null if it was pointing to * XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the FileItem. */ @Generated @@ -205,30 +151,39 @@ public static FileItem fromXml(XmlReader xmlReader) throws XMLStreamException { * cases where the model can deserialize from different root element names. * @return An instance of FileItem if the XmlReader was pointing to an instance of it, or null if it was pointing to * XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the FileItem. */ @Generated public static FileItem fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "File" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - FileItem deserializedFileItem = new FileItem(); + StringEncoded name = null; + String fileId = null; + FileProperty properties = null; + String attributes = null; + String permissionKey = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("Name".equals(elementName.getLocalPart())) { - deserializedFileItem.name = StringEncoded.fromXml(reader, "Name"); + name = StringEncoded.fromXml(reader, "Name"); } else if ("FileId".equals(elementName.getLocalPart())) { - deserializedFileItem.fileId = reader.getStringElement(); + fileId = reader.getStringElement(); } else if ("Properties".equals(elementName.getLocalPart())) { - deserializedFileItem.properties = FileProperty.fromXml(reader, "Properties"); + properties = FileProperty.fromXml(reader, "Properties"); } else if ("Attributes".equals(elementName.getLocalPart())) { - deserializedFileItem.attributes = reader.getStringElement(); + attributes = reader.getStringElement(); } else if ("PermissionKey".equals(elementName.getLocalPart())) { - deserializedFileItem.permissionKey = reader.getStringElement(); + permissionKey = reader.getStringElement(); } else { reader.skipElement(); } } + FileItem deserializedFileItem = new FileItem(name, properties); + deserializedFileItem.fileId = fileId; + deserializedFileItem.attributes = attributes; + deserializedFileItem.permissionKey = permissionKey; return deserializedFileItem; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java index 7bf07bbc0a4d..4ae98053073d 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.core.util.CoreUtils; import com.azure.core.util.DateTimeRfc1123; import com.azure.xml.XmlReader; @@ -21,63 +21,68 @@ /** * File properties. */ -@Fluent +@Immutable public final class FileProperty implements XmlSerializable { /* - * Content length of the file. This value may not be up-to-date since an SMB client may have modified the file - * locally. The value of Content-Length may not reflect that fact until the handle is closed or the op-lock is - * broken. To retrieve current property values, call Get File Properties. + * Content length of the file. This value may not be up-to-date since an SMB + * client may have modified the file locally. The value of Content-Length may not + * reflect that fact until the handle is closed or the op-lock is broken. To + * retrieve current property values, call Get File Properties. */ @Generated - private long contentLength; + private final long contentLength; /* - * The CreationTime property. + * The creation time. */ @Generated private OffsetDateTime creationTime; /* - * The LastAccessTime property. + * The last access time. */ @Generated private OffsetDateTime lastAccessTime; /* - * The LastWriteTime property. + * The last write time. */ @Generated private OffsetDateTime lastWriteTime; /* - * The ChangeTime property. + * The change time. */ @Generated private OffsetDateTime changeTime; /* - * The Last-Modified property. + * The last modified time. */ @Generated private DateTimeRfc1123 lastModified; /* - * The Etag property. + * The ETag of the file. */ @Generated - private String etag; + private String eTag; /** * Creates an instance of FileProperty class. + * + * @param contentLength the contentLength value to set. */ @Generated - public FileProperty() { + private FileProperty(long contentLength) { + this.contentLength = contentLength; } /** - * Get the contentLength property: Content length of the file. This value may not be up-to-date since an SMB client - * may have modified the file locally. The value of Content-Length may not reflect that fact until the handle is - * closed or the op-lock is broken. To retrieve current property values, call Get File Properties. + * Get the contentLength property: Content length of the file. This value may not be up-to-date since an SMB + * client may have modified the file locally. The value of Content-Length may not + * reflect that fact until the handle is closed or the op-lock is broken. To + * retrieve current property values, call Get File Properties. * * @return the contentLength value. */ @@ -87,21 +92,7 @@ public long getContentLength() { } /** - * Set the contentLength property: Content length of the file. This value may not be up-to-date since an SMB client - * may have modified the file locally. The value of Content-Length may not reflect that fact until the handle is - * closed or the op-lock is broken. To retrieve current property values, call Get File Properties. - * - * @param contentLength the contentLength value to set. - * @return the FileProperty object itself. - */ - @Generated - public FileProperty setContentLength(long contentLength) { - this.contentLength = contentLength; - return this; - } - - /** - * Get the creationTime property: The CreationTime property. + * Get the creationTime property: The creation time. * * @return the creationTime value. */ @@ -111,19 +102,7 @@ public OffsetDateTime getCreationTime() { } /** - * Set the creationTime property: The CreationTime property. - * - * @param creationTime the creationTime value to set. - * @return the FileProperty object itself. - */ - @Generated - public FileProperty setCreationTime(OffsetDateTime creationTime) { - this.creationTime = creationTime; - return this; - } - - /** - * Get the lastAccessTime property: The LastAccessTime property. + * Get the lastAccessTime property: The last access time. * * @return the lastAccessTime value. */ @@ -133,19 +112,7 @@ public OffsetDateTime getLastAccessTime() { } /** - * Set the lastAccessTime property: The LastAccessTime property. - * - * @param lastAccessTime the lastAccessTime value to set. - * @return the FileProperty object itself. - */ - @Generated - public FileProperty setLastAccessTime(OffsetDateTime lastAccessTime) { - this.lastAccessTime = lastAccessTime; - return this; - } - - /** - * Get the lastWriteTime property: The LastWriteTime property. + * Get the lastWriteTime property: The last write time. * * @return the lastWriteTime value. */ @@ -155,19 +122,7 @@ public OffsetDateTime getLastWriteTime() { } /** - * Set the lastWriteTime property: The LastWriteTime property. - * - * @param lastWriteTime the lastWriteTime value to set. - * @return the FileProperty object itself. - */ - @Generated - public FileProperty setLastWriteTime(OffsetDateTime lastWriteTime) { - this.lastWriteTime = lastWriteTime; - return this; - } - - /** - * Get the changeTime property: The ChangeTime property. + * Get the changeTime property: The change time. * * @return the changeTime value. */ @@ -177,19 +132,7 @@ public OffsetDateTime getChangeTime() { } /** - * Set the changeTime property: The ChangeTime property. - * - * @param changeTime the changeTime value to set. - * @return the FileProperty object itself. - */ - @Generated - public FileProperty setChangeTime(OffsetDateTime changeTime) { - this.changeTime = changeTime; - return this; - } - - /** - * Get the lastModified property: The Last-Modified property. + * Get the lastModified property: The last modified time. * * @return the lastModified value. */ @@ -202,41 +145,13 @@ public OffsetDateTime getLastModified() { } /** - * Set the lastModified property: The Last-Modified property. - * - * @param lastModified the lastModified value to set. - * @return the FileProperty object itself. - */ - @Generated - public FileProperty setLastModified(OffsetDateTime lastModified) { - if (lastModified == null) { - this.lastModified = null; - } else { - this.lastModified = new DateTimeRfc1123(lastModified); - } - return this; - } - - /** - * Get the etag property: The Etag property. - * - * @return the etag value. - */ - @Generated - public String getEtag() { - return this.etag; - } - - /** - * Set the etag property: The Etag property. + * Get the eTag property: The ETag of the file. * - * @param etag the etag value to set. - * @return the FileProperty object itself. + * @return the eTag value. */ @Generated - public FileProperty setEtag(String etag) { - this.etag = etag; - return this; + public String getETag() { + return this.eTag; } @Generated @@ -260,7 +175,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt xmlWriter.writeStringElement("ChangeTime", this.changeTime == null ? null : DateTimeFormatter.ISO_OFFSET_DATE_TIME.format(this.changeTime)); xmlWriter.writeStringElement("Last-Modified", Objects.toString(this.lastModified, null)); - xmlWriter.writeStringElement("Etag", this.etag); + xmlWriter.writeStringElement("Etag", this.eTag); return xmlWriter.writeEndElement(); } @@ -270,6 +185,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of FileProperty if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the FileProperty. */ @Generated @@ -285,6 +201,7 @@ public static FileProperty fromXml(XmlReader xmlReader) throws XMLStreamExceptio * cases where the model can deserialize from different root element names. * @return An instance of FileProperty if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the FileProperty. */ @Generated @@ -292,32 +209,44 @@ public static FileProperty fromXml(XmlReader xmlReader, String rootElementName) String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "FileProperty" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - FileProperty deserializedFileProperty = new FileProperty(); + long contentLength = 0L; + OffsetDateTime creationTime = null; + OffsetDateTime lastAccessTime = null; + OffsetDateTime lastWriteTime = null; + OffsetDateTime changeTime = null; + DateTimeRfc1123 lastModified = null; + String eTag = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("Content-Length".equals(elementName.getLocalPart())) { - deserializedFileProperty.contentLength = reader.getLongElement(); + contentLength = reader.getLongElement(); } else if ("CreationTime".equals(elementName.getLocalPart())) { - deserializedFileProperty.creationTime + creationTime = reader.getNullableElement(dateString -> CoreUtils.parseBestOffsetDateTime(dateString)); } else if ("LastAccessTime".equals(elementName.getLocalPart())) { - deserializedFileProperty.lastAccessTime + lastAccessTime = reader.getNullableElement(dateString -> CoreUtils.parseBestOffsetDateTime(dateString)); } else if ("LastWriteTime".equals(elementName.getLocalPart())) { - deserializedFileProperty.lastWriteTime + lastWriteTime = reader.getNullableElement(dateString -> CoreUtils.parseBestOffsetDateTime(dateString)); } else if ("ChangeTime".equals(elementName.getLocalPart())) { - deserializedFileProperty.changeTime - = reader.getNullableElement(dateString -> CoreUtils.parseBestOffsetDateTime(dateString)); + changeTime = reader.getNullableElement(dateString -> CoreUtils.parseBestOffsetDateTime(dateString)); } else if ("Last-Modified".equals(elementName.getLocalPart())) { - deserializedFileProperty.lastModified = reader.getNullableElement(DateTimeRfc1123::new); + lastModified = reader.getNullableElement(DateTimeRfc1123::new); } else if ("Etag".equals(elementName.getLocalPart())) { - deserializedFileProperty.etag = reader.getStringElement(); + eTag = reader.getStringElement(); } else { reader.skipElement(); } } + FileProperty deserializedFileProperty = new FileProperty(contentLength); + deserializedFileProperty.creationTime = creationTime; + deserializedFileProperty.lastAccessTime = lastAccessTime; + deserializedFileProperty.lastWriteTime = lastWriteTime; + deserializedFileProperty.changeTime = changeTime; + deserializedFileProperty.lastModified = lastModified; + deserializedFileProperty.eTag = eTag; return deserializedFileProperty; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java index db47d0b499b2..14bf552a66ea 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.xml.XmlReader; import com.azure.xml.XmlSerializable; import com.azure.xml.XmlToken; @@ -18,29 +18,34 @@ /** * Abstract for entries that can be listed from Directory. */ -@Fluent +@Immutable public final class FilesAndDirectoriesListSegment implements XmlSerializable { /* - * The DirectoryItems property. + * The directory items. */ @Generated - private List directoryItems = new ArrayList<>(); + private final List directoryItems; /* - * The FileItems property. + * The file items. */ @Generated - private List fileItems = new ArrayList<>(); + private final List fileItems; /** * Creates an instance of FilesAndDirectoriesListSegment class. + * + * @param directoryItems the directoryItems value to set. + * @param fileItems the fileItems value to set. */ @Generated - public FilesAndDirectoriesListSegment() { + private FilesAndDirectoriesListSegment(List directoryItems, List fileItems) { + this.directoryItems = directoryItems; + this.fileItems = fileItems; } /** - * Get the directoryItems property: The DirectoryItems property. + * Get the directoryItems property: The directory items. * * @return the directoryItems value. */ @@ -50,19 +55,7 @@ public List getDirectoryItems() { } /** - * Set the directoryItems property: The DirectoryItems property. - * - * @param directoryItems the directoryItems value to set. - * @return the FilesAndDirectoriesListSegment object itself. - */ - @Generated - public FilesAndDirectoriesListSegment setDirectoryItems(List directoryItems) { - this.directoryItems = directoryItems; - return this; - } - - /** - * Get the fileItems property: The FileItems property. + * Get the fileItems property: The file items. * * @return the fileItems value. */ @@ -71,18 +64,6 @@ public List getFileItems() { return this.fileItems; } - /** - * Set the fileItems property: The FileItems property. - * - * @param fileItems the fileItems value to set. - * @return the FilesAndDirectoriesListSegment object itself. - */ - @Generated - public FilesAndDirectoriesListSegment setFileItems(List fileItems) { - this.fileItems = fileItems; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @@ -92,7 +73,8 @@ public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLStreamException { - rootElementName = rootElementName == null || rootElementName.isEmpty() ? "Entries" : rootElementName; + rootElementName + = rootElementName == null || rootElementName.isEmpty() ? "FilesAndDirectoriesListSegment" : rootElementName; xmlWriter.writeStartElement(rootElementName); if (this.directoryItems != null) { for (DirectoryItem element : this.directoryItems) { @@ -113,6 +95,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of FilesAndDirectoriesListSegment if the XmlReader was pointing to an instance of it, or null * if it was pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the FilesAndDirectoriesListSegment. */ @Generated @@ -128,30 +111,35 @@ public static FilesAndDirectoriesListSegment fromXml(XmlReader xmlReader) throws * cases where the model can deserialize from different root element names. * @return An instance of FilesAndDirectoriesListSegment if the XmlReader was pointing to an instance of it, or null * if it was pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the FilesAndDirectoriesListSegment. */ @Generated public static FilesAndDirectoriesListSegment fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { String finalRootElementName - = rootElementName == null || rootElementName.isEmpty() ? "Entries" : rootElementName; + = rootElementName == null || rootElementName.isEmpty() ? "FilesAndDirectoriesListSegment" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - FilesAndDirectoriesListSegment deserializedFilesAndDirectoriesListSegment - = new FilesAndDirectoriesListSegment(); + List directoryItems = null; + List fileItems = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("Directory".equals(elementName.getLocalPart())) { - deserializedFilesAndDirectoriesListSegment.directoryItems - .add(DirectoryItem.fromXml(reader, "Directory")); + if (directoryItems == null) { + directoryItems = new ArrayList<>(); + } + directoryItems.add(DirectoryItem.fromXml(reader, "Directory")); } else if ("File".equals(elementName.getLocalPart())) { - deserializedFilesAndDirectoriesListSegment.fileItems.add(FileItem.fromXml(reader, "File")); + if (fileItems == null) { + fileItems = new ArrayList<>(); + } + fileItems.add(FileItem.fromXml(reader, "File")); } else { reader.skipElement(); } } - - return deserializedFilesAndDirectoriesListSegment; + return new FilesAndDirectoriesListSegment(directoryItems, fileItems); }); } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java index b2077e8f68c5..cce00424903d 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.core.util.DateTimeRfc1123; import com.azure.storage.file.share.models.ShareFileHandleAccessRights; import com.azure.xml.XmlReader; @@ -22,25 +22,25 @@ /** * A listed Azure Storage handle item. */ -@Fluent +@Immutable public final class HandleItem implements XmlSerializable { /* * XSMB service handle ID */ @Generated - private String handleId; + private final String handleId; /* - * The Path property. + * The path. */ @Generated - private StringEncoded path; + private final StringEncoded path; /* * FileId uniquely identifies the file or directory. */ @Generated - private String fileId; + private final String fileId; /* * ParentId uniquely identifies the parent directory of the object. @@ -52,25 +52,26 @@ public final class HandleItem implements XmlSerializable { * SMB session ID in context of which the file handle was opened */ @Generated - private String sessionId; + private final String sessionId; /* * Client IP that opened the handle */ @Generated - private String clientIp; + private final String clientIp; /* * Name of the client machine where the share is being mounted */ @Generated - private String clientName; + private final String clientName; /* - * Time when the session that previously opened the handle has last been reconnected. (UTC) + * Time when the session that previously opened the handle has last been + * reconnected. (UTC) */ @Generated - private DateTimeRfc1123 openTime; + private final DateTimeRfc1123 openTime; /* * Time handle was last connected to (UTC) @@ -79,16 +80,36 @@ public final class HandleItem implements XmlSerializable { private DateTimeRfc1123 lastReconnectTime; /* - * The AccessRightList property. + * The access rights. */ @Generated private List accessRightList; /** * Creates an instance of HandleItem class. + * + * @param handleId the handleId value to set. + * @param path the path value to set. + * @param fileId the fileId value to set. + * @param sessionId the sessionId value to set. + * @param clientIp the clientIp value to set. + * @param clientName the clientName value to set. + * @param openTime the openTime value to set. */ @Generated - public HandleItem() { + private HandleItem(String handleId, StringEncoded path, String fileId, String sessionId, String clientIp, + String clientName, OffsetDateTime openTime) { + this.handleId = handleId; + this.path = path; + this.fileId = fileId; + this.sessionId = sessionId; + this.clientIp = clientIp; + this.clientName = clientName; + if (openTime == null) { + this.openTime = null; + } else { + this.openTime = new DateTimeRfc1123(openTime); + } } /** @@ -102,19 +123,7 @@ public String getHandleId() { } /** - * Set the handleId property: XSMB service handle ID. - * - * @param handleId the handleId value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setHandleId(String handleId) { - this.handleId = handleId; - return this; - } - - /** - * Get the path property: The Path property. + * Get the path property: The path. * * @return the path value. */ @@ -123,18 +132,6 @@ public StringEncoded getPath() { return this.path; } - /** - * Set the path property: The Path property. - * - * @param path the path value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setPath(StringEncoded path) { - this.path = path; - return this; - } - /** * Get the fileId property: FileId uniquely identifies the file or directory. * @@ -145,18 +142,6 @@ public String getFileId() { return this.fileId; } - /** - * Set the fileId property: FileId uniquely identifies the file or directory. - * - * @param fileId the fileId value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setFileId(String fileId) { - this.fileId = fileId; - return this; - } - /** * Get the parentId property: ParentId uniquely identifies the parent directory of the object. * @@ -167,18 +152,6 @@ public String getParentId() { return this.parentId; } - /** - * Set the parentId property: ParentId uniquely identifies the parent directory of the object. - * - * @param parentId the parentId value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setParentId(String parentId) { - this.parentId = parentId; - return this; - } - /** * Get the sessionId property: SMB session ID in context of which the file handle was opened. * @@ -189,18 +162,6 @@ public String getSessionId() { return this.sessionId; } - /** - * Set the sessionId property: SMB session ID in context of which the file handle was opened. - * - * @param sessionId the sessionId value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setSessionId(String sessionId) { - this.sessionId = sessionId; - return this; - } - /** * Get the clientIp property: Client IP that opened the handle. * @@ -211,18 +172,6 @@ public String getClientIp() { return this.clientIp; } - /** - * Set the clientIp property: Client IP that opened the handle. - * - * @param clientIp the clientIp value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setClientIp(String clientIp) { - this.clientIp = clientIp; - return this; - } - /** * Get the clientName property: Name of the client machine where the share is being mounted. * @@ -234,20 +183,8 @@ public String getClientName() { } /** - * Set the clientName property: Name of the client machine where the share is being mounted. - * - * @param clientName the clientName value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setClientName(String clientName) { - this.clientName = clientName; - return this; - } - - /** - * Get the openTime property: Time when the session that previously opened the handle has last been reconnected. - * (UTC). + * Get the openTime property: Time when the session that previously opened the handle has last been + * reconnected. (UTC). * * @return the openTime value. */ @@ -259,23 +196,6 @@ public OffsetDateTime getOpenTime() { return this.openTime.getDateTime(); } - /** - * Set the openTime property: Time when the session that previously opened the handle has last been reconnected. - * (UTC). - * - * @param openTime the openTime value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setOpenTime(OffsetDateTime openTime) { - if (openTime == null) { - this.openTime = null; - } else { - this.openTime = new DateTimeRfc1123(openTime); - } - return this; - } - /** * Get the lastReconnectTime property: Time handle was last connected to (UTC). * @@ -290,23 +210,7 @@ public OffsetDateTime getLastReconnectTime() { } /** - * Set the lastReconnectTime property: Time handle was last connected to (UTC). - * - * @param lastReconnectTime the lastReconnectTime value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setLastReconnectTime(OffsetDateTime lastReconnectTime) { - if (lastReconnectTime == null) { - this.lastReconnectTime = null; - } else { - this.lastReconnectTime = new DateTimeRfc1123(lastReconnectTime); - } - return this; - } - - /** - * Get the accessRightList property: The AccessRightList property. + * Get the accessRightList property: The access rights. * * @return the accessRightList value. */ @@ -318,18 +222,6 @@ public List getAccessRightList() { return this.accessRightList; } - /** - * Set the accessRightList property: The AccessRightList property. - * - * @param accessRightList the accessRightList value to set. - * @return the HandleItem object itself. - */ - @Generated - public HandleItem setAccessRightList(List accessRightList) { - this.accessRightList = accessRightList; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @@ -366,6 +258,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of HandleItem if the XmlReader was pointing to an instance of it, or null if it was pointing * to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the HandleItem. */ @Generated @@ -381,43 +274,55 @@ public static HandleItem fromXml(XmlReader xmlReader) throws XMLStreamException * cases where the model can deserialize from different root element names. * @return An instance of HandleItem if the XmlReader was pointing to an instance of it, or null if it was pointing * to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the HandleItem. */ @Generated public static HandleItem fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "Handle" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - HandleItem deserializedHandleItem = new HandleItem(); + String handleId = null; + StringEncoded path = null; + String fileId = null; + String parentId = null; + String sessionId = null; + String clientIp = null; + String clientName = null; + OffsetDateTime openTime = null; + DateTimeRfc1123 lastReconnectTime = null; + List accessRightList = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("HandleId".equals(elementName.getLocalPart())) { - deserializedHandleItem.handleId = reader.getStringElement(); + handleId = reader.getStringElement(); } else if ("Path".equals(elementName.getLocalPart())) { - deserializedHandleItem.path = StringEncoded.fromXml(reader, "Path"); + path = StringEncoded.fromXml(reader, "Path"); } else if ("FileId".equals(elementName.getLocalPart())) { - deserializedHandleItem.fileId = reader.getStringElement(); + fileId = reader.getStringElement(); } else if ("ParentId".equals(elementName.getLocalPart())) { - deserializedHandleItem.parentId = reader.getStringElement(); + parentId = reader.getStringElement(); } else if ("SessionId".equals(elementName.getLocalPart())) { - deserializedHandleItem.sessionId = reader.getStringElement(); + sessionId = reader.getStringElement(); } else if ("ClientIp".equals(elementName.getLocalPart())) { - deserializedHandleItem.clientIp = reader.getStringElement(); + clientIp = reader.getStringElement(); } else if ("ClientName".equals(elementName.getLocalPart())) { - deserializedHandleItem.clientName = reader.getStringElement(); + clientName = reader.getStringElement(); } else if ("OpenTime".equals(elementName.getLocalPart())) { - deserializedHandleItem.openTime = reader.getNullableElement(DateTimeRfc1123::new); + DateTimeRfc1123 openTimeHolder = reader.getNullableElement(DateTimeRfc1123::new); + if (openTimeHolder != null) { + openTime = openTimeHolder.getDateTime(); + } } else if ("LastReconnectTime".equals(elementName.getLocalPart())) { - deserializedHandleItem.lastReconnectTime = reader.getNullableElement(DateTimeRfc1123::new); + lastReconnectTime = reader.getNullableElement(DateTimeRfc1123::new); } else if ("AccessRightList".equals(elementName.getLocalPart())) { while (reader.nextElement() != XmlToken.END_ELEMENT) { elementName = reader.getElementName(); if ("AccessRight".equals(elementName.getLocalPart())) { - if (deserializedHandleItem.accessRightList == null) { - deserializedHandleItem.accessRightList = new ArrayList<>(); + if (accessRightList == null) { + accessRightList = new ArrayList<>(); } - deserializedHandleItem.accessRightList - .add(ShareFileHandleAccessRights.fromString(reader.getStringElement())); + accessRightList.add(ShareFileHandleAccessRights.fromString(reader.getStringElement())); } else { reader.skipElement(); } @@ -426,6 +331,11 @@ public static HandleItem fromXml(XmlReader xmlReader, String rootElementName) th reader.skipElement(); } } + HandleItem deserializedHandleItem + = new HandleItem(handleId, path, fileId, sessionId, clientIp, clientName, openTime); + deserializedHandleItem.parentId = parentId; + deserializedHandleItem.lastReconnectTime = lastReconnectTime; + deserializedHandleItem.accessRightList = accessRightList; return deserializedHandleItem; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java index 9f8c17da76c5..feb84be0c907 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; @@ -28,7 +28,7 @@ public final class KeyInfo implements XmlSerializable { * The date-time the key expires in ISO 8601 UTC time */ @Generated - private String expiry; + private final String expiry; /* * The delegated user tenant id in Azure AD @@ -38,9 +38,12 @@ public final class KeyInfo implements XmlSerializable { /** * Creates an instance of KeyInfo class. + * + * @param expiry the expiry value to set. */ @Generated - public KeyInfo() { + public KeyInfo(String expiry) { + this.expiry = expiry; } /** @@ -75,18 +78,6 @@ public String getExpiry() { return this.expiry; } - /** - * Set the expiry property: The date-time the key expires in ISO 8601 UTC time. - * - * @param expiry the expiry value to set. - * @return the KeyInfo object itself. - */ - @Generated - public KeyInfo setExpiry(String expiry) { - this.expiry = expiry; - return this; - } - /** * Get the delegatedUserTenantId property: The delegated user tenant id in Azure AD. * @@ -132,6 +123,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of KeyInfo if the XmlReader was pointing to an instance of it, or null if it was pointing to * XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the KeyInfo. */ @Generated @@ -147,6 +139,7 @@ public static KeyInfo fromXml(XmlReader xmlReader) throws XMLStreamException { * cases where the model can deserialize from different root element names. * @return An instance of KeyInfo if the XmlReader was pointing to an instance of it, or null if it was pointing to * XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the KeyInfo. */ @Generated @@ -154,20 +147,25 @@ public static KeyInfo fromXml(XmlReader xmlReader, String rootElementName) throw String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "KeyInfo" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - KeyInfo deserializedKeyInfo = new KeyInfo(); + String start = null; + String expiry = null; + String delegatedUserTenantId = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("Start".equals(elementName.getLocalPart())) { - deserializedKeyInfo.start = reader.getStringElement(); + start = reader.getStringElement(); } else if ("Expiry".equals(elementName.getLocalPart())) { - deserializedKeyInfo.expiry = reader.getStringElement(); + expiry = reader.getStringElement(); } else if ("DelegatedUserTid".equals(elementName.getLocalPart())) { - deserializedKeyInfo.delegatedUserTenantId = reader.getStringElement(); + delegatedUserTenantId = reader.getStringElement(); } else { reader.skipElement(); } } + KeyInfo deserializedKeyInfo = new KeyInfo(expiry); + deserializedKeyInfo.start = start; + deserializedKeyInfo.delegatedUserTenantId = delegatedUserTenantId; return deserializedKeyInfo; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java index b35802e502a8..4f5aa76cfef1 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.xml.XmlReader; import com.azure.xml.XmlSerializable; import com.azure.xml.XmlToken; @@ -16,53 +16,53 @@ /** * An enumeration of directories and files. */ -@Fluent +@Immutable public final class ListFilesAndDirectoriesSegmentResponse implements XmlSerializable { /* - * The ServiceEndpoint property. + * The service endpoint. */ @Generated - private String serviceEndpoint; + private final String serviceEndpoint; /* - * The ShareName property. + * The share name. */ @Generated - private String shareName; + private final String shareName; /* - * The ShareSnapshot property. + * The share snapshot. */ @Generated private String shareSnapshot; /* - * The Encoded property. + * Whether the listing is encoded. */ @Generated private Boolean encoded; /* - * The DirectoryPath property. + * The directory path. */ @Generated - private String directoryPath; + private final String directoryPath; /* - * The Prefix property. + * The prefix. */ @Generated - private StringEncoded prefix; + private final StringEncoded prefix; /* - * The Marker property. + * The marker. */ @Generated private String marker; /* - * The MaxResults property. + * The max results. */ @Generated private Integer maxResults; @@ -71,29 +71,43 @@ public final class ListFilesAndDirectoriesSegmentResponse * Abstract for entries that can be listed from Directory. */ @Generated - private FilesAndDirectoriesListSegment segment; + private final FilesAndDirectoriesListSegment segment; /* - * The NextMarker property. + * The next marker. */ @Generated - private String nextMarker; + private final String nextMarker; /* - * The DirectoryId property. + * The directory ID. */ @Generated private String directoryId; /** * Creates an instance of ListFilesAndDirectoriesSegmentResponse class. + * + * @param serviceEndpoint the serviceEndpoint value to set. + * @param shareName the shareName value to set. + * @param directoryPath the directoryPath value to set. + * @param prefix the prefix value to set. + * @param segment the segment value to set. + * @param nextMarker the nextMarker value to set. */ @Generated - public ListFilesAndDirectoriesSegmentResponse() { + private ListFilesAndDirectoriesSegmentResponse(String serviceEndpoint, String shareName, String directoryPath, + StringEncoded prefix, FilesAndDirectoriesListSegment segment, String nextMarker) { + this.serviceEndpoint = serviceEndpoint; + this.shareName = shareName; + this.directoryPath = directoryPath; + this.prefix = prefix; + this.segment = segment; + this.nextMarker = nextMarker; } /** - * Get the serviceEndpoint property: The ServiceEndpoint property. + * Get the serviceEndpoint property: The service endpoint. * * @return the serviceEndpoint value. */ @@ -103,19 +117,7 @@ public String getServiceEndpoint() { } /** - * Set the serviceEndpoint property: The ServiceEndpoint property. - * - * @param serviceEndpoint the serviceEndpoint value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setServiceEndpoint(String serviceEndpoint) { - this.serviceEndpoint = serviceEndpoint; - return this; - } - - /** - * Get the shareName property: The ShareName property. + * Get the shareName property: The share name. * * @return the shareName value. */ @@ -125,19 +127,7 @@ public String getShareName() { } /** - * Set the shareName property: The ShareName property. - * - * @param shareName the shareName value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setShareName(String shareName) { - this.shareName = shareName; - return this; - } - - /** - * Get the shareSnapshot property: The ShareSnapshot property. + * Get the shareSnapshot property: The share snapshot. * * @return the shareSnapshot value. */ @@ -147,19 +137,7 @@ public String getShareSnapshot() { } /** - * Set the shareSnapshot property: The ShareSnapshot property. - * - * @param shareSnapshot the shareSnapshot value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setShareSnapshot(String shareSnapshot) { - this.shareSnapshot = shareSnapshot; - return this; - } - - /** - * Get the encoded property: The Encoded property. + * Get the encoded property: Whether the listing is encoded. * * @return the encoded value. */ @@ -169,19 +147,7 @@ public Boolean isEncoded() { } /** - * Set the encoded property: The Encoded property. - * - * @param encoded the encoded value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setEncoded(Boolean encoded) { - this.encoded = encoded; - return this; - } - - /** - * Get the directoryPath property: The DirectoryPath property. + * Get the directoryPath property: The directory path. * * @return the directoryPath value. */ @@ -191,19 +157,7 @@ public String getDirectoryPath() { } /** - * Set the directoryPath property: The DirectoryPath property. - * - * @param directoryPath the directoryPath value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setDirectoryPath(String directoryPath) { - this.directoryPath = directoryPath; - return this; - } - - /** - * Get the prefix property: The Prefix property. + * Get the prefix property: The prefix. * * @return the prefix value. */ @@ -213,19 +167,7 @@ public StringEncoded getPrefix() { } /** - * Set the prefix property: The Prefix property. - * - * @param prefix the prefix value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setPrefix(StringEncoded prefix) { - this.prefix = prefix; - return this; - } - - /** - * Get the marker property: The Marker property. + * Get the marker property: The marker. * * @return the marker value. */ @@ -235,19 +177,7 @@ public String getMarker() { } /** - * Set the marker property: The Marker property. - * - * @param marker the marker value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setMarker(String marker) { - this.marker = marker; - return this; - } - - /** - * Get the maxResults property: The MaxResults property. + * Get the maxResults property: The max results. * * @return the maxResults value. */ @@ -256,18 +186,6 @@ public Integer getMaxResults() { return this.maxResults; } - /** - * Set the maxResults property: The MaxResults property. - * - * @param maxResults the maxResults value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setMaxResults(Integer maxResults) { - this.maxResults = maxResults; - return this; - } - /** * Get the segment property: Abstract for entries that can be listed from Directory. * @@ -279,19 +197,7 @@ public FilesAndDirectoriesListSegment getSegment() { } /** - * Set the segment property: Abstract for entries that can be listed from Directory. - * - * @param segment the segment value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setSegment(FilesAndDirectoriesListSegment segment) { - this.segment = segment; - return this; - } - - /** - * Get the nextMarker property: The NextMarker property. + * Get the nextMarker property: The next marker. * * @return the nextMarker value. */ @@ -301,19 +207,7 @@ public String getNextMarker() { } /** - * Set the nextMarker property: The NextMarker property. - * - * @param nextMarker the nextMarker value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setNextMarker(String nextMarker) { - this.nextMarker = nextMarker; - return this; - } - - /** - * Get the directoryId property: The DirectoryId property. + * Get the directoryId property: The directory ID. * * @return the directoryId value. */ @@ -322,18 +216,6 @@ public String getDirectoryId() { return this.directoryId; } - /** - * Set the directoryId property: The DirectoryId property. - * - * @param directoryId the directoryId value to set. - * @return the ListFilesAndDirectoriesSegmentResponse object itself. - */ - @Generated - public ListFilesAndDirectoriesSegmentResponse setDirectoryId(String directoryId) { - this.directoryId = directoryId; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @@ -365,6 +247,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of ListFilesAndDirectoriesSegmentResponse if the XmlReader was pointing to an instance of it, * or null if it was pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ListFilesAndDirectoriesSegmentResponse. */ @Generated @@ -380,6 +263,7 @@ public static ListFilesAndDirectoriesSegmentResponse fromXml(XmlReader xmlReader * cases where the model can deserialize from different root element names. * @return An instance of ListFilesAndDirectoriesSegmentResponse if the XmlReader was pointing to an instance of it, * or null if it was pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ListFilesAndDirectoriesSegmentResponse. */ @Generated @@ -388,38 +272,44 @@ public static ListFilesAndDirectoriesSegmentResponse fromXml(XmlReader xmlReader String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "EnumerationResults" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - ListFilesAndDirectoriesSegmentResponse deserializedListFilesAndDirectoriesSegmentResponse - = new ListFilesAndDirectoriesSegmentResponse(); - deserializedListFilesAndDirectoriesSegmentResponse.serviceEndpoint - = reader.getStringAttribute(null, "ServiceEndpoint"); - deserializedListFilesAndDirectoriesSegmentResponse.shareName = reader.getStringAttribute(null, "ShareName"); - deserializedListFilesAndDirectoriesSegmentResponse.shareSnapshot - = reader.getStringAttribute(null, "ShareSnapshot"); - deserializedListFilesAndDirectoriesSegmentResponse.encoded - = reader.getNullableAttribute(null, "Encoded", Boolean::parseBoolean); - deserializedListFilesAndDirectoriesSegmentResponse.directoryPath - = reader.getStringAttribute(null, "DirectoryPath"); + StringEncoded prefix = null; + String marker = null; + Integer maxResults = null; + FilesAndDirectoriesListSegment segment = null; + String nextMarker = null; + String directoryId = null; + String serviceEndpoint = reader.getStringAttribute(null, "ServiceEndpoint"); + String shareName = reader.getStringAttribute(null, "ShareName"); + String shareSnapshot = reader.getStringAttribute(null, "ShareSnapshot"); + Boolean encoded = reader.getNullableAttribute(null, "Encoded", Boolean::parseBoolean); + String directoryPath = reader.getStringAttribute(null, "DirectoryPath"); while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("Prefix".equals(elementName.getLocalPart())) { - deserializedListFilesAndDirectoriesSegmentResponse.prefix = StringEncoded.fromXml(reader, "Prefix"); + prefix = StringEncoded.fromXml(reader, "Prefix"); } else if ("Marker".equals(elementName.getLocalPart())) { - deserializedListFilesAndDirectoriesSegmentResponse.marker = reader.getStringElement(); + marker = reader.getStringElement(); } else if ("MaxResults".equals(elementName.getLocalPart())) { - deserializedListFilesAndDirectoriesSegmentResponse.maxResults - = reader.getNullableElement(Integer::parseInt); + maxResults = reader.getNullableElement(Integer::parseInt); } else if ("Entries".equals(elementName.getLocalPart())) { - deserializedListFilesAndDirectoriesSegmentResponse.segment - = FilesAndDirectoriesListSegment.fromXml(reader, "Entries"); + segment = FilesAndDirectoriesListSegment.fromXml(reader, "Entries"); } else if ("NextMarker".equals(elementName.getLocalPart())) { - deserializedListFilesAndDirectoriesSegmentResponse.nextMarker = reader.getStringElement(); + nextMarker = reader.getStringElement(); } else if ("DirectoryId".equals(elementName.getLocalPart())) { - deserializedListFilesAndDirectoriesSegmentResponse.directoryId = reader.getStringElement(); + directoryId = reader.getStringElement(); } else { reader.skipElement(); } } + ListFilesAndDirectoriesSegmentResponse deserializedListFilesAndDirectoriesSegmentResponse + = new ListFilesAndDirectoriesSegmentResponse(serviceEndpoint, shareName, directoryPath, prefix, segment, + nextMarker); + deserializedListFilesAndDirectoriesSegmentResponse.shareSnapshot = shareSnapshot; + deserializedListFilesAndDirectoriesSegmentResponse.encoded = encoded; + deserializedListFilesAndDirectoriesSegmentResponse.marker = marker; + deserializedListFilesAndDirectoriesSegmentResponse.maxResults = maxResults; + deserializedListFilesAndDirectoriesSegmentResponse.directoryId = directoryId; return deserializedListFilesAndDirectoriesSegmentResponse; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java index 183e5958cebb..aaade8e50502 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java @@ -1,30 +1,30 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; /** - * Defines values for ListFilesIncludeType. + * The type of file information to include in the listing. */ public enum ListFilesIncludeType { /** - * Enum value Timestamps. + * Timestamps. */ TIMESTAMPS("Timestamps"), /** - * Enum value Etag. + * Etag. */ ETAG("Etag"), /** - * Enum value Attributes. + * Attributes. */ ATTRIBUTES("Attributes"), /** - * Enum value PermissionKey. + * PermissionKey. */ PERMISSION_KEY("PermissionKey"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java index 7f0c639c4d57..0f1c837c88af 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java @@ -1,25 +1,25 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; /** - * Defines values for ListSharesIncludeType. + * The type of share information to include in the listing. */ public enum ListSharesIncludeType { /** - * Enum value snapshots. + * snapshots. */ SNAPSHOTS("snapshots"), /** - * Enum value metadata. + * metadata. */ METADATA("metadata"), /** - * Enum value deleted. + * deleted. */ DELETED("deleted"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java new file mode 100644 index 000000000000..9f6d8327d669 --- /dev/null +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java @@ -0,0 +1,51 @@ +// Copyright (c) Microsoft Corporation. All rights reserved. +// Licensed under the MIT License. +// Code generated by Microsoft (R) TypeSpec Code Generator. + +package com.azure.storage.file.share.implementation.models; + +/** + * Only update is supported: - Update: Writes the bytes downloaded from the source url into the specified range. + */ +public enum ShareFileRangeWriteFromUrlType { + /** + * Writes the bytes specified by the source URL into the specified range. + */ + UPDATE("update"); + + /** + * The actual serialized value for a ShareFileRangeWriteFromUrlType instance. + */ + private final String value; + + ShareFileRangeWriteFromUrlType(String value) { + this.value = value; + } + + /** + * Parses a serialized value to a ShareFileRangeWriteFromUrlType instance. + * + * @param value the serialized value to parse. + * @return the parsed ShareFileRangeWriteFromUrlType object, or null if unable to parse. + */ + public static ShareFileRangeWriteFromUrlType fromString(String value) { + if (value == null) { + return null; + } + ShareFileRangeWriteFromUrlType[] items = ShareFileRangeWriteFromUrlType.values(); + for (ShareFileRangeWriteFromUrlType item : items) { + if (item.toString().equalsIgnoreCase(value)) { + return item; + } + } + return null; + } + + /** + * {@inheritDoc} + */ + @Override + public String toString() { + return this.value; + } +} diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java index 8578835707de..dc488a7b9fee 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java @@ -1,20 +1,21 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; /** - * Defines values for ShareFileRangeWriteType. + * Specify one of the following options: - Update: Writes the bytes specified by the request body into the specified + * range. - Clear: Clears the specified range and releases the space used in storage for that range. */ public enum ShareFileRangeWriteType { /** - * Enum value update. + * Writes the bytes specified by the request body into the specified range. */ UPDATE("update"), /** - * Enum value clear. + * Clears the specified range and releases the space used in storage for that range. */ CLEAR("clear"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java index 251fad989940..0ee19a8742ea 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.xml.XmlReader; import com.azure.xml.XmlSerializable; import com.azure.xml.XmlToken; @@ -18,28 +18,28 @@ /** * A listed Azure Storage share item. */ -@Fluent +@Immutable public final class ShareItemInternal implements XmlSerializable { /* - * The Name property. + * The share name. */ @Generated - private String name; + private final String name; /* - * The Snapshot property. + * The share snapshot. */ @Generated private String snapshot; /* - * The Deleted property. + * Whether the share is deleted. */ @Generated private Boolean deleted; /* - * The Version property. + * The share version. */ @Generated private String version; @@ -48,7 +48,7 @@ public final class ShareItemInternal implements XmlSerializable @@ -58,13 +58,18 @@ public final class ShareItemInternal implements XmlSerializable getMetadata() { return this.metadata; } - /** - * Set the metadata property: Dictionary of <string>. - * - * @param metadata the metadata value to set. - * @return the ShareItemInternal object itself. - */ - @Generated - public ShareItemInternal setMetadata(Map metadata) { - this.metadata = metadata; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @@ -227,6 +160,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of ShareItemInternal if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareItemInternal. */ @Generated @@ -242,38 +176,48 @@ public static ShareItemInternal fromXml(XmlReader xmlReader) throws XMLStreamExc * cases where the model can deserialize from different root element names. * @return An instance of ShareItemInternal if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareItemInternal. */ @Generated public static ShareItemInternal fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "Share" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - ShareItemInternal deserializedShareItemInternal = new ShareItemInternal(); + String name = null; + String snapshot = null; + Boolean deleted = null; + String version = null; + SharePropertiesInternal properties = null; + Map metadata = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("Name".equals(elementName.getLocalPart())) { - deserializedShareItemInternal.name = reader.getStringElement(); + name = reader.getStringElement(); } else if ("Snapshot".equals(elementName.getLocalPart())) { - deserializedShareItemInternal.snapshot = reader.getStringElement(); + snapshot = reader.getStringElement(); } else if ("Deleted".equals(elementName.getLocalPart())) { - deserializedShareItemInternal.deleted = reader.getNullableElement(Boolean::parseBoolean); + deleted = reader.getNullableElement(Boolean::parseBoolean); } else if ("Version".equals(elementName.getLocalPart())) { - deserializedShareItemInternal.version = reader.getStringElement(); + version = reader.getStringElement(); } else if ("Properties".equals(elementName.getLocalPart())) { - deserializedShareItemInternal.properties = SharePropertiesInternal.fromXml(reader, "Properties"); + properties = SharePropertiesInternal.fromXml(reader, "Properties"); } else if ("Metadata".equals(elementName.getLocalPart())) { while (reader.nextElement() != XmlToken.END_ELEMENT) { - if (deserializedShareItemInternal.metadata == null) { - deserializedShareItemInternal.metadata = new LinkedHashMap<>(); + if (metadata == null) { + metadata = new LinkedHashMap<>(); } - deserializedShareItemInternal.metadata.put(reader.getElementName().getLocalPart(), - reader.getStringElement()); + metadata.put(reader.getElementName().getLocalPart(), reader.getStringElement()); } } else { reader.skipElement(); } } + ShareItemInternal deserializedShareItemInternal = new ShareItemInternal(name, properties); + deserializedShareItemInternal.snapshot = snapshot; + deserializedShareItemInternal.deleted = deleted; + deserializedShareItemInternal.version = version; + deserializedShareItemInternal.metadata = metadata; return deserializedShareItemInternal; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java index 3ff783c96742..3e6c057e9408 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; @@ -22,19 +22,22 @@ public final class SharePermission implements JsonSerializable * The permission in the Security Descriptor Definition Language (SDDL). */ @Generated - private String permission; + private final String permission; /* - * The format property. + * The permission format. */ @Generated private FilePermissionFormat format; /** * Creates an instance of SharePermission class. + * + * @param permission the permission value to set. */ @Generated - public SharePermission() { + public SharePermission(String permission) { + this.permission = permission; } /** @@ -48,19 +51,7 @@ public String getPermission() { } /** - * Set the permission property: The permission in the Security Descriptor Definition Language (SDDL). - * - * @param permission the permission value to set. - * @return the SharePermission object itself. - */ - @Generated - public SharePermission setPermission(String permission) { - this.permission = permission; - return this; - } - - /** - * Get the format property: The format property. + * Get the format property: The permission format. * * @return the format value. */ @@ -70,7 +61,7 @@ public FilePermissionFormat getFormat() { } /** - * Set the format property: The format property. + * Set the format property: The permission format. * * @param format the format value to set. * @return the SharePermission object itself. @@ -105,19 +96,22 @@ public JsonWriter toJson(JsonWriter jsonWriter) throws IOException { @Generated public static SharePermission fromJson(JsonReader jsonReader) throws IOException { return jsonReader.readObject(reader -> { - SharePermission deserializedSharePermission = new SharePermission(); + String permission = null; + FilePermissionFormat format = null; while (reader.nextToken() != JsonToken.END_OBJECT) { String fieldName = reader.getFieldName(); reader.nextToken(); if ("permission".equals(fieldName)) { - deserializedSharePermission.permission = reader.getString(); + permission = reader.getString(); } else if ("format".equals(fieldName)) { - deserializedSharePermission.format = FilePermissionFormat.fromString(reader.getString()); + format = FilePermissionFormat.fromString(reader.getString()); } else { reader.skipChildren(); } } + SharePermission deserializedSharePermission = new SharePermission(permission); + deserializedSharePermission.format = format; return deserializedSharePermission; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java index b59ff963df07..bfeefd12e42f 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.core.util.DateTimeRfc1123; import com.azure.storage.file.share.models.LeaseDurationType; import com.azure.storage.file.share.models.LeaseStateType; @@ -16,8 +16,6 @@ import com.azure.xml.XmlToken; import com.azure.xml.XmlWriter; import java.time.OffsetDateTime; -import java.util.LinkedHashMap; -import java.util.Map; import java.util.Objects; import javax.xml.namespace.QName; import javax.xml.stream.XMLStreamException; @@ -25,82 +23,82 @@ /** * Properties of a share. */ -@Fluent +@Immutable public final class SharePropertiesInternal implements XmlSerializable { /* - * The Last-Modified property. + * The last modified time. */ @Generated - private DateTimeRfc1123 lastModified; + private final DateTimeRfc1123 lastModified; /* - * The Etag property. + * The ETag of the share. */ @Generated - private String eTag; + private final String eTag; /* - * The Quota property. + * The share quota. */ @Generated - private int quota; + private final int quota; /* - * The ProvisionedIops property. + * The provisioned IOPS. */ @Generated private Integer provisionedIops; /* - * The ProvisionedIngressMBps property. + * The provisioned ingress in MBps. */ @Generated private Integer provisionedIngressMBps; /* - * The ProvisionedEgressMBps property. + * The provisioned egress in MBps. */ @Generated private Integer provisionedEgressMBps; /* - * The ProvisionedBandwidthMiBps property. + * The provisioned bandwidth in MiBps. */ @Generated private Integer provisionedBandwidthMiBps; /* - * The NextAllowedQuotaDowngradeTime property. + * The next allowed quota downgrade time. */ @Generated private DateTimeRfc1123 nextAllowedQuotaDowngradeTime; /* - * The DeletedTime property. + * The deleted time. */ @Generated private DateTimeRfc1123 deletedTime; /* - * The RemainingRetentionDays property. + * The remaining retention days. */ @Generated private Integer remainingRetentionDays; /* - * The AccessTier property. + * The access tier. */ @Generated private String accessTier; /* - * The AccessTierChangeTime property. + * The access tier change time. */ @Generated private DateTimeRfc1123 accessTierChangeTime; /* - * The AccessTierTransitionState property. + * The access tier transition state. */ @Generated private String accessTierTransitionState; @@ -118,92 +116,98 @@ public final class SharePropertiesInternal implements XmlSerializable - */ - @Generated - private Map metadata; - /** * Creates an instance of SharePropertiesInternal class. + * + * @param lastModified the lastModified value to set. + * @param eTag the eTag value to set. + * @param quota the quota value to set. */ @Generated - public SharePropertiesInternal() { + private SharePropertiesInternal(OffsetDateTime lastModified, String eTag, int quota) { + if (lastModified == null) { + this.lastModified = null; + } else { + this.lastModified = new DateTimeRfc1123(lastModified); + } + this.eTag = eTag; + this.quota = quota; } /** - * Get the lastModified property: The Last-Modified property. + * Get the lastModified property: The last modified time. * * @return the lastModified value. */ @@ -216,23 +220,7 @@ public OffsetDateTime getLastModified() { } /** - * Set the lastModified property: The Last-Modified property. - * - * @param lastModified the lastModified value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setLastModified(OffsetDateTime lastModified) { - if (lastModified == null) { - this.lastModified = null; - } else { - this.lastModified = new DateTimeRfc1123(lastModified); - } - return this; - } - - /** - * Get the eTag property: The Etag property. + * Get the eTag property: The ETag of the share. * * @return the eTag value. */ @@ -242,19 +230,7 @@ public String getETag() { } /** - * Set the eTag property: The Etag property. - * - * @param eTag the eTag value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setETag(String eTag) { - this.eTag = eTag; - return this; - } - - /** - * Get the quota property: The Quota property. + * Get the quota property: The share quota. * * @return the quota value. */ @@ -264,19 +240,7 @@ public int getQuota() { } /** - * Set the quota property: The Quota property. - * - * @param quota the quota value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setQuota(int quota) { - this.quota = quota; - return this; - } - - /** - * Get the provisionedIops property: The ProvisionedIops property. + * Get the provisionedIops property: The provisioned IOPS. * * @return the provisionedIops value. */ @@ -286,19 +250,7 @@ public Integer getProvisionedIops() { } /** - * Set the provisionedIops property: The ProvisionedIops property. - * - * @param provisionedIops the provisionedIops value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setProvisionedIops(Integer provisionedIops) { - this.provisionedIops = provisionedIops; - return this; - } - - /** - * Get the provisionedIngressMBps property: The ProvisionedIngressMBps property. + * Get the provisionedIngressMBps property: The provisioned ingress in MBps. * * @return the provisionedIngressMBps value. */ @@ -308,19 +260,7 @@ public Integer getProvisionedIngressMBps() { } /** - * Set the provisionedIngressMBps property: The ProvisionedIngressMBps property. - * - * @param provisionedIngressMBps the provisionedIngressMBps value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setProvisionedIngressMBps(Integer provisionedIngressMBps) { - this.provisionedIngressMBps = provisionedIngressMBps; - return this; - } - - /** - * Get the provisionedEgressMBps property: The ProvisionedEgressMBps property. + * Get the provisionedEgressMBps property: The provisioned egress in MBps. * * @return the provisionedEgressMBps value. */ @@ -330,19 +270,7 @@ public Integer getProvisionedEgressMBps() { } /** - * Set the provisionedEgressMBps property: The ProvisionedEgressMBps property. - * - * @param provisionedEgressMBps the provisionedEgressMBps value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setProvisionedEgressMBps(Integer provisionedEgressMBps) { - this.provisionedEgressMBps = provisionedEgressMBps; - return this; - } - - /** - * Get the provisionedBandwidthMiBps property: The ProvisionedBandwidthMiBps property. + * Get the provisionedBandwidthMiBps property: The provisioned bandwidth in MiBps. * * @return the provisionedBandwidthMiBps value. */ @@ -352,19 +280,7 @@ public Integer getProvisionedBandwidthMiBps() { } /** - * Set the provisionedBandwidthMiBps property: The ProvisionedBandwidthMiBps property. - * - * @param provisionedBandwidthMiBps the provisionedBandwidthMiBps value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setProvisionedBandwidthMiBps(Integer provisionedBandwidthMiBps) { - this.provisionedBandwidthMiBps = provisionedBandwidthMiBps; - return this; - } - - /** - * Get the nextAllowedQuotaDowngradeTime property: The NextAllowedQuotaDowngradeTime property. + * Get the nextAllowedQuotaDowngradeTime property: The next allowed quota downgrade time. * * @return the nextAllowedQuotaDowngradeTime value. */ @@ -377,23 +293,7 @@ public OffsetDateTime getNextAllowedQuotaDowngradeTime() { } /** - * Set the nextAllowedQuotaDowngradeTime property: The NextAllowedQuotaDowngradeTime property. - * - * @param nextAllowedQuotaDowngradeTime the nextAllowedQuotaDowngradeTime value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setNextAllowedQuotaDowngradeTime(OffsetDateTime nextAllowedQuotaDowngradeTime) { - if (nextAllowedQuotaDowngradeTime == null) { - this.nextAllowedQuotaDowngradeTime = null; - } else { - this.nextAllowedQuotaDowngradeTime = new DateTimeRfc1123(nextAllowedQuotaDowngradeTime); - } - return this; - } - - /** - * Get the deletedTime property: The DeletedTime property. + * Get the deletedTime property: The deleted time. * * @return the deletedTime value. */ @@ -406,23 +306,7 @@ public OffsetDateTime getDeletedTime() { } /** - * Set the deletedTime property: The DeletedTime property. - * - * @param deletedTime the deletedTime value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setDeletedTime(OffsetDateTime deletedTime) { - if (deletedTime == null) { - this.deletedTime = null; - } else { - this.deletedTime = new DateTimeRfc1123(deletedTime); - } - return this; - } - - /** - * Get the remainingRetentionDays property: The RemainingRetentionDays property. + * Get the remainingRetentionDays property: The remaining retention days. * * @return the remainingRetentionDays value. */ @@ -432,19 +316,7 @@ public Integer getRemainingRetentionDays() { } /** - * Set the remainingRetentionDays property: The RemainingRetentionDays property. - * - * @param remainingRetentionDays the remainingRetentionDays value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setRemainingRetentionDays(Integer remainingRetentionDays) { - this.remainingRetentionDays = remainingRetentionDays; - return this; - } - - /** - * Get the accessTier property: The AccessTier property. + * Get the accessTier property: The access tier. * * @return the accessTier value. */ @@ -454,19 +326,7 @@ public String getAccessTier() { } /** - * Set the accessTier property: The AccessTier property. - * - * @param accessTier the accessTier value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setAccessTier(String accessTier) { - this.accessTier = accessTier; - return this; - } - - /** - * Get the accessTierChangeTime property: The AccessTierChangeTime property. + * Get the accessTierChangeTime property: The access tier change time. * * @return the accessTierChangeTime value. */ @@ -479,23 +339,7 @@ public OffsetDateTime getAccessTierChangeTime() { } /** - * Set the accessTierChangeTime property: The AccessTierChangeTime property. - * - * @param accessTierChangeTime the accessTierChangeTime value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setAccessTierChangeTime(OffsetDateTime accessTierChangeTime) { - if (accessTierChangeTime == null) { - this.accessTierChangeTime = null; - } else { - this.accessTierChangeTime = new DateTimeRfc1123(accessTierChangeTime); - } - return this; - } - - /** - * Get the accessTierTransitionState property: The AccessTierTransitionState property. + * Get the accessTierTransitionState property: The access tier transition state. * * @return the accessTierTransitionState value. */ @@ -504,18 +348,6 @@ public String getAccessTierTransitionState() { return this.accessTierTransitionState; } - /** - * Set the accessTierTransitionState property: The AccessTierTransitionState property. - * - * @param accessTierTransitionState the accessTierTransitionState value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setAccessTierTransitionState(String accessTierTransitionState) { - this.accessTierTransitionState = accessTierTransitionState; - return this; - } - /** * Get the leaseStatus property: The current lease status of the share. * @@ -526,18 +358,6 @@ public LeaseStatusType getLeaseStatus() { return this.leaseStatus; } - /** - * Set the leaseStatus property: The current lease status of the share. - * - * @param leaseStatus the leaseStatus value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setLeaseStatus(LeaseStatusType leaseStatus) { - this.leaseStatus = leaseStatus; - return this; - } - /** * Get the leaseState property: Lease state of the share. * @@ -548,18 +368,6 @@ public LeaseStateType getLeaseState() { return this.leaseState; } - /** - * Set the leaseState property: Lease state of the share. - * - * @param leaseState the leaseState value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setLeaseState(LeaseStateType leaseState) { - this.leaseState = leaseState; - return this; - } - /** * Get the leaseDuration property: When a share is leased, specifies whether the lease is of infinite or fixed * duration. @@ -572,20 +380,7 @@ public LeaseDurationType getLeaseDuration() { } /** - * Set the leaseDuration property: When a share is leased, specifies whether the lease is of infinite or fixed - * duration. - * - * @param leaseDuration the leaseDuration value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setLeaseDuration(LeaseDurationType leaseDuration) { - this.leaseDuration = leaseDuration; - return this; - } - - /** - * Get the enabledProtocols property: The EnabledProtocols property. + * Get the enabledProtocols property: The enabled protocols. * * @return the enabledProtocols value. */ @@ -595,19 +390,7 @@ public String getEnabledProtocols() { } /** - * Set the enabledProtocols property: The EnabledProtocols property. - * - * @param enabledProtocols the enabledProtocols value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setEnabledProtocols(String enabledProtocols) { - this.enabledProtocols = enabledProtocols; - return this; - } - - /** - * Get the rootSquash property: The RootSquash property. + * Get the rootSquash property: The root squash setting. * * @return the rootSquash value. */ @@ -617,19 +400,7 @@ public ShareRootSquash getRootSquash() { } /** - * Set the rootSquash property: The RootSquash property. - * - * @param rootSquash the rootSquash value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setRootSquash(ShareRootSquash rootSquash) { - this.rootSquash = rootSquash; - return this; - } - - /** - * Get the enableSnapshotVirtualDirectoryAccess property: The EnableSnapshotVirtualDirectoryAccess property. + * Get the enableSnapshotVirtualDirectoryAccess property: Whether snapshot virtual directory access is enabled. * * @return the enableSnapshotVirtualDirectoryAccess value. */ @@ -639,20 +410,7 @@ public Boolean isEnableSnapshotVirtualDirectoryAccess() { } /** - * Set the enableSnapshotVirtualDirectoryAccess property: The EnableSnapshotVirtualDirectoryAccess property. - * - * @param enableSnapshotVirtualDirectoryAccess the enableSnapshotVirtualDirectoryAccess value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal - setEnableSnapshotVirtualDirectoryAccess(Boolean enableSnapshotVirtualDirectoryAccess) { - this.enableSnapshotVirtualDirectoryAccess = enableSnapshotVirtualDirectoryAccess; - return this; - } - - /** - * Get the paidBurstingEnabled property: The PaidBurstingEnabled property. + * Get the paidBurstingEnabled property: Whether paid bursting is enabled. * * @return the paidBurstingEnabled value. */ @@ -662,19 +420,7 @@ public Boolean isPaidBurstingEnabled() { } /** - * Set the paidBurstingEnabled property: The PaidBurstingEnabled property. - * - * @param paidBurstingEnabled the paidBurstingEnabled value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setPaidBurstingEnabled(Boolean paidBurstingEnabled) { - this.paidBurstingEnabled = paidBurstingEnabled; - return this; - } - - /** - * Get the paidBurstingMaxIops property: The PaidBurstingMaxIops property. + * Get the paidBurstingMaxIops property: The maximum IOPS for paid bursting. * * @return the paidBurstingMaxIops value. */ @@ -684,19 +430,7 @@ public Long getPaidBurstingMaxIops() { } /** - * Set the paidBurstingMaxIops property: The PaidBurstingMaxIops property. - * - * @param paidBurstingMaxIops the paidBurstingMaxIops value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setPaidBurstingMaxIops(Long paidBurstingMaxIops) { - this.paidBurstingMaxIops = paidBurstingMaxIops; - return this; - } - - /** - * Get the paidBurstingMaxBandwidthMibps property: The PaidBurstingMaxBandwidthMibps property. + * Get the paidBurstingMaxBandwidthMibps property: The maximum bandwidth for paid bursting in MiBps. * * @return the paidBurstingMaxBandwidthMibps value. */ @@ -706,19 +440,7 @@ public Long getPaidBurstingMaxBandwidthMibps() { } /** - * Set the paidBurstingMaxBandwidthMibps property: The PaidBurstingMaxBandwidthMibps property. - * - * @param paidBurstingMaxBandwidthMibps the paidBurstingMaxBandwidthMibps value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setPaidBurstingMaxBandwidthMibps(Long paidBurstingMaxBandwidthMibps) { - this.paidBurstingMaxBandwidthMibps = paidBurstingMaxBandwidthMibps; - return this; - } - - /** - * Get the includedBurstIops property: The IncludedBurstIops property. + * Get the includedBurstIops property: The included burst IOPS. * * @return the includedBurstIops value. */ @@ -728,19 +450,7 @@ public Long getIncludedBurstIops() { } /** - * Set the includedBurstIops property: The IncludedBurstIops property. - * - * @param includedBurstIops the includedBurstIops value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setIncludedBurstIops(Long includedBurstIops) { - this.includedBurstIops = includedBurstIops; - return this; - } - - /** - * Get the maxBurstCreditsForIops property: The MaxBurstCreditsForIops property. + * Get the maxBurstCreditsForIops property: The maximum burst credits for IOPS. * * @return the maxBurstCreditsForIops value. */ @@ -750,19 +460,7 @@ public Long getMaxBurstCreditsForIops() { } /** - * Set the maxBurstCreditsForIops property: The MaxBurstCreditsForIops property. - * - * @param maxBurstCreditsForIops the maxBurstCreditsForIops value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setMaxBurstCreditsForIops(Long maxBurstCreditsForIops) { - this.maxBurstCreditsForIops = maxBurstCreditsForIops; - return this; - } - - /** - * Get the nextAllowedProvisionedIopsDowngradeTime property: The NextAllowedProvisionedIopsDowngradeTime property. + * Get the nextAllowedProvisionedIopsDowngradeTime property: The next allowed provisioned IOPS downgrade time. * * @return the nextAllowedProvisionedIopsDowngradeTime value. */ @@ -775,25 +473,8 @@ public OffsetDateTime getNextAllowedProvisionedIopsDowngradeTime() { } /** - * Set the nextAllowedProvisionedIopsDowngradeTime property: The NextAllowedProvisionedIopsDowngradeTime property. - * - * @param nextAllowedProvisionedIopsDowngradeTime the nextAllowedProvisionedIopsDowngradeTime value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal - setNextAllowedProvisionedIopsDowngradeTime(OffsetDateTime nextAllowedProvisionedIopsDowngradeTime) { - if (nextAllowedProvisionedIopsDowngradeTime == null) { - this.nextAllowedProvisionedIopsDowngradeTime = null; - } else { - this.nextAllowedProvisionedIopsDowngradeTime = new DateTimeRfc1123(nextAllowedProvisionedIopsDowngradeTime); - } - return this; - } - - /** - * Get the nextAllowedProvisionedBandwidthDowngradeTime property: The NextAllowedProvisionedBandwidthDowngradeTime - * property. + * Get the nextAllowedProvisionedBandwidthDowngradeTime property: The next allowed provisioned bandwidth downgrade + * time. * * @return the nextAllowedProvisionedBandwidthDowngradeTime value. */ @@ -806,27 +487,7 @@ public OffsetDateTime getNextAllowedProvisionedBandwidthDowngradeTime() { } /** - * Set the nextAllowedProvisionedBandwidthDowngradeTime property: The NextAllowedProvisionedBandwidthDowngradeTime - * property. - * - * @param nextAllowedProvisionedBandwidthDowngradeTime the nextAllowedProvisionedBandwidthDowngradeTime value to - * set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal - setNextAllowedProvisionedBandwidthDowngradeTime(OffsetDateTime nextAllowedProvisionedBandwidthDowngradeTime) { - if (nextAllowedProvisionedBandwidthDowngradeTime == null) { - this.nextAllowedProvisionedBandwidthDowngradeTime = null; - } else { - this.nextAllowedProvisionedBandwidthDowngradeTime - = new DateTimeRfc1123(nextAllowedProvisionedBandwidthDowngradeTime); - } - return this; - } - - /** - * Get the enableSmbDirectoryLease property: The EnableSmbDirectoryLease property. + * Get the enableSmbDirectoryLease property: Whether SMB directory lease is enabled. * * @return the enableSmbDirectoryLease value. */ @@ -835,40 +496,6 @@ public Boolean isEnableSmbDirectoryLease() { return this.enableSmbDirectoryLease; } - /** - * Set the enableSmbDirectoryLease property: The EnableSmbDirectoryLease property. - * - * @param enableSmbDirectoryLease the enableSmbDirectoryLease value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setEnableSmbDirectoryLease(Boolean enableSmbDirectoryLease) { - this.enableSmbDirectoryLease = enableSmbDirectoryLease; - return this; - } - - /** - * Get the metadata property: Dictionary of <string>. - * - * @return the metadata value. - */ - @Generated - public Map getMetadata() { - return this.metadata; - } - - /** - * Set the metadata property: Dictionary of <string>. - * - * @param metadata the metadata value to set. - * @return the SharePropertiesInternal object itself. - */ - @Generated - public SharePropertiesInternal setMetadata(Map metadata) { - this.metadata = metadata; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @@ -913,13 +540,6 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt xmlWriter.writeStringElement("NextAllowedProvisionedBandwidthDowngradeTime", Objects.toString(this.nextAllowedProvisionedBandwidthDowngradeTime, null)); xmlWriter.writeBooleanElement("EnableSmbDirectoryLease", this.enableSmbDirectoryLease); - if (this.metadata != null) { - xmlWriter.writeStartElement("Metadata"); - for (Map.Entry entry : this.metadata.entrySet()) { - xmlWriter.writeStringElement(entry.getKey(), entry.getValue()); - } - xmlWriter.writeEndElement(); - } return xmlWriter.writeEndElement(); } @@ -929,6 +549,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of SharePropertiesInternal if the XmlReader was pointing to an instance of it, or null if it * was pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the SharePropertiesInternal. */ @Generated @@ -944,6 +565,7 @@ public static SharePropertiesInternal fromXml(XmlReader xmlReader) throws XMLStr * cases where the model can deserialize from different root element names. * @return An instance of SharePropertiesInternal if the XmlReader was pointing to an instance of it, or null if it * was pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the SharePropertiesInternal. */ @Generated @@ -952,94 +574,126 @@ public static SharePropertiesInternal fromXml(XmlReader xmlReader, String rootEl String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "SharePropertiesInternal" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - SharePropertiesInternal deserializedSharePropertiesInternal = new SharePropertiesInternal(); + OffsetDateTime lastModified = null; + String eTag = null; + int quota = 0; + Integer provisionedIops = null; + Integer provisionedIngressMBps = null; + Integer provisionedEgressMBps = null; + Integer provisionedBandwidthMiBps = null; + DateTimeRfc1123 nextAllowedQuotaDowngradeTime = null; + DateTimeRfc1123 deletedTime = null; + Integer remainingRetentionDays = null; + String accessTier = null; + DateTimeRfc1123 accessTierChangeTime = null; + String accessTierTransitionState = null; + LeaseStatusType leaseStatus = null; + LeaseStateType leaseState = null; + LeaseDurationType leaseDuration = null; + String enabledProtocols = null; + ShareRootSquash rootSquash = null; + Boolean enableSnapshotVirtualDirectoryAccess = null; + Boolean paidBurstingEnabled = null; + Long paidBurstingMaxIops = null; + Long paidBurstingMaxBandwidthMibps = null; + Long includedBurstIops = null; + Long maxBurstCreditsForIops = null; + DateTimeRfc1123 nextAllowedProvisionedIopsDowngradeTime = null; + DateTimeRfc1123 nextAllowedProvisionedBandwidthDowngradeTime = null; + Boolean enableSmbDirectoryLease = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("Last-Modified".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.lastModified = reader.getNullableElement(DateTimeRfc1123::new); + DateTimeRfc1123 lastModifiedHolder = reader.getNullableElement(DateTimeRfc1123::new); + if (lastModifiedHolder != null) { + lastModified = lastModifiedHolder.getDateTime(); + } } else if ("Etag".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.eTag = reader.getStringElement(); + eTag = reader.getStringElement(); } else if ("Quota".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.quota = reader.getIntElement(); + quota = reader.getIntElement(); } else if ("ProvisionedIops".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.provisionedIops = reader.getNullableElement(Integer::parseInt); + provisionedIops = reader.getNullableElement(Integer::parseInt); } else if ("ProvisionedIngressMBps".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.provisionedIngressMBps - = reader.getNullableElement(Integer::parseInt); + provisionedIngressMBps = reader.getNullableElement(Integer::parseInt); } else if ("ProvisionedEgressMBps".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.provisionedEgressMBps - = reader.getNullableElement(Integer::parseInt); + provisionedEgressMBps = reader.getNullableElement(Integer::parseInt); } else if ("ProvisionedBandwidthMiBps".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.provisionedBandwidthMiBps - = reader.getNullableElement(Integer::parseInt); + provisionedBandwidthMiBps = reader.getNullableElement(Integer::parseInt); } else if ("NextAllowedQuotaDowngradeTime".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.nextAllowedQuotaDowngradeTime - = reader.getNullableElement(DateTimeRfc1123::new); + nextAllowedQuotaDowngradeTime = reader.getNullableElement(DateTimeRfc1123::new); } else if ("DeletedTime".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.deletedTime = reader.getNullableElement(DateTimeRfc1123::new); + deletedTime = reader.getNullableElement(DateTimeRfc1123::new); } else if ("RemainingRetentionDays".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.remainingRetentionDays - = reader.getNullableElement(Integer::parseInt); + remainingRetentionDays = reader.getNullableElement(Integer::parseInt); } else if ("AccessTier".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.accessTier = reader.getStringElement(); + accessTier = reader.getStringElement(); } else if ("AccessTierChangeTime".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.accessTierChangeTime - = reader.getNullableElement(DateTimeRfc1123::new); + accessTierChangeTime = reader.getNullableElement(DateTimeRfc1123::new); } else if ("AccessTierTransitionState".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.accessTierTransitionState = reader.getStringElement(); + accessTierTransitionState = reader.getStringElement(); } else if ("LeaseStatus".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.leaseStatus - = LeaseStatusType.fromString(reader.getStringElement()); + leaseStatus = LeaseStatusType.fromString(reader.getStringElement()); } else if ("LeaseState".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.leaseState - = LeaseStateType.fromString(reader.getStringElement()); + leaseState = LeaseStateType.fromString(reader.getStringElement()); } else if ("LeaseDuration".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.leaseDuration - = LeaseDurationType.fromString(reader.getStringElement()); + leaseDuration = LeaseDurationType.fromString(reader.getStringElement()); } else if ("EnabledProtocols".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.enabledProtocols = reader.getStringElement(); + enabledProtocols = reader.getStringElement(); } else if ("RootSquash".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.rootSquash - = ShareRootSquash.fromString(reader.getStringElement()); + rootSquash = ShareRootSquash.fromString(reader.getStringElement()); } else if ("EnableSnapshotVirtualDirectoryAccess".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.enableSnapshotVirtualDirectoryAccess - = reader.getNullableElement(Boolean::parseBoolean); + enableSnapshotVirtualDirectoryAccess = reader.getNullableElement(Boolean::parseBoolean); } else if ("PaidBurstingEnabled".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.paidBurstingEnabled - = reader.getNullableElement(Boolean::parseBoolean); + paidBurstingEnabled = reader.getNullableElement(Boolean::parseBoolean); } else if ("PaidBurstingMaxIops".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.paidBurstingMaxIops - = reader.getNullableElement(Long::parseLong); + paidBurstingMaxIops = reader.getNullableElement(Long::parseLong); } else if ("PaidBurstingMaxBandwidthMibps".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.paidBurstingMaxBandwidthMibps - = reader.getNullableElement(Long::parseLong); + paidBurstingMaxBandwidthMibps = reader.getNullableElement(Long::parseLong); } else if ("IncludedBurstIops".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.includedBurstIops = reader.getNullableElement(Long::parseLong); + includedBurstIops = reader.getNullableElement(Long::parseLong); } else if ("MaxBurstCreditsForIops".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.maxBurstCreditsForIops - = reader.getNullableElement(Long::parseLong); + maxBurstCreditsForIops = reader.getNullableElement(Long::parseLong); } else if ("NextAllowedProvisionedIopsDowngradeTime".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.nextAllowedProvisionedIopsDowngradeTime - = reader.getNullableElement(DateTimeRfc1123::new); + nextAllowedProvisionedIopsDowngradeTime = reader.getNullableElement(DateTimeRfc1123::new); } else if ("NextAllowedProvisionedBandwidthDowngradeTime".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.nextAllowedProvisionedBandwidthDowngradeTime - = reader.getNullableElement(DateTimeRfc1123::new); + nextAllowedProvisionedBandwidthDowngradeTime = reader.getNullableElement(DateTimeRfc1123::new); } else if ("EnableSmbDirectoryLease".equals(elementName.getLocalPart())) { - deserializedSharePropertiesInternal.enableSmbDirectoryLease - = reader.getNullableElement(Boolean::parseBoolean); - } else if ("Metadata".equals(elementName.getLocalPart())) { - while (reader.nextElement() != XmlToken.END_ELEMENT) { - if (deserializedSharePropertiesInternal.metadata == null) { - deserializedSharePropertiesInternal.metadata = new LinkedHashMap<>(); - } - deserializedSharePropertiesInternal.metadata.put(reader.getElementName().getLocalPart(), - reader.getStringElement()); - } + enableSmbDirectoryLease = reader.getNullableElement(Boolean::parseBoolean); } else { reader.skipElement(); } } + SharePropertiesInternal deserializedSharePropertiesInternal + = new SharePropertiesInternal(lastModified, eTag, quota); + deserializedSharePropertiesInternal.provisionedIops = provisionedIops; + deserializedSharePropertiesInternal.provisionedIngressMBps = provisionedIngressMBps; + deserializedSharePropertiesInternal.provisionedEgressMBps = provisionedEgressMBps; + deserializedSharePropertiesInternal.provisionedBandwidthMiBps = provisionedBandwidthMiBps; + deserializedSharePropertiesInternal.nextAllowedQuotaDowngradeTime = nextAllowedQuotaDowngradeTime; + deserializedSharePropertiesInternal.deletedTime = deletedTime; + deserializedSharePropertiesInternal.remainingRetentionDays = remainingRetentionDays; + deserializedSharePropertiesInternal.accessTier = accessTier; + deserializedSharePropertiesInternal.accessTierChangeTime = accessTierChangeTime; + deserializedSharePropertiesInternal.accessTierTransitionState = accessTierTransitionState; + deserializedSharePropertiesInternal.leaseStatus = leaseStatus; + deserializedSharePropertiesInternal.leaseState = leaseState; + deserializedSharePropertiesInternal.leaseDuration = leaseDuration; + deserializedSharePropertiesInternal.enabledProtocols = enabledProtocols; + deserializedSharePropertiesInternal.rootSquash = rootSquash; + deserializedSharePropertiesInternal.enableSnapshotVirtualDirectoryAccess + = enableSnapshotVirtualDirectoryAccess; + deserializedSharePropertiesInternal.paidBurstingEnabled = paidBurstingEnabled; + deserializedSharePropertiesInternal.paidBurstingMaxIops = paidBurstingMaxIops; + deserializedSharePropertiesInternal.paidBurstingMaxBandwidthMibps = paidBurstingMaxBandwidthMibps; + deserializedSharePropertiesInternal.includedBurstIops = includedBurstIops; + deserializedSharePropertiesInternal.maxBurstCreditsForIops = maxBurstCreditsForIops; + deserializedSharePropertiesInternal.nextAllowedProvisionedIopsDowngradeTime + = nextAllowedProvisionedIopsDowngradeTime; + deserializedSharePropertiesInternal.nextAllowedProvisionedBandwidthDowngradeTime + = nextAllowedProvisionedBandwidthDowngradeTime; + deserializedSharePropertiesInternal.enableSmbDirectoryLease = enableSmbDirectoryLease; return deserializedSharePropertiesInternal; }); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java index 59ed1707bcee..626be22c9c2a 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java @@ -1,10 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.storage.file.share.models.ShareSignedIdentifier; import com.azure.xml.XmlReader; import com.azure.xml.XmlSerializable; @@ -16,27 +17,34 @@ import javax.xml.stream.XMLStreamException; /** - * A wrapper around List<ShareSignedIdentifier> which provides top-level metadata for serialization. + * Represents an array of signed identifiers. */ +@Immutable public final class ShareSignedIdentifierWrapper implements XmlSerializable { - private final List signedIdentifiers; + /* + * The array of signed identifiers. + */ + @Generated + private final List items; /** - * Creates an instance of ShareSignedIdentifierWrapper. + * Creates an instance of ShareSignedIdentifierWrapper class. * - * @param signedIdentifiers the list. + * @param items the items value to set. */ - public ShareSignedIdentifierWrapper(List signedIdentifiers) { - this.signedIdentifiers = signedIdentifiers; + @Generated + public ShareSignedIdentifierWrapper(List items) { + this.items = items; } /** - * Get the List<ShareSignedIdentifier> contained in this wrapper. + * Get the items property: The array of signed identifiers. * - * @return the List<ShareSignedIdentifier>. + * @return the items value. */ - public List items() { - return signedIdentifiers; + @Generated + public List getItems() { + return this.items; } @Generated @@ -50,26 +58,46 @@ public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLStreamException { rootElementName = rootElementName == null || rootElementName.isEmpty() ? "SignedIdentifiers" : rootElementName; xmlWriter.writeStartElement(rootElementName); - if (signedIdentifiers != null) { - for (ShareSignedIdentifier element : signedIdentifiers) { + if (this.items != null) { + for (ShareSignedIdentifier element : this.items) { xmlWriter.writeXml(element, "SignedIdentifier"); } } return xmlWriter.writeEndElement(); } + /** + * Reads an instance of ShareSignedIdentifierWrapper from the XmlReader. + * + * @param xmlReader The XmlReader being read. + * @return An instance of ShareSignedIdentifierWrapper if the XmlReader was pointing to an instance of it, or null + * if it was pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. + * @throws XMLStreamException If an error occurs while reading the ShareSignedIdentifierWrapper. + */ @Generated public static ShareSignedIdentifierWrapper fromXml(XmlReader xmlReader) throws XMLStreamException { return fromXml(xmlReader, null); } + /** + * Reads an instance of ShareSignedIdentifierWrapper from the XmlReader. + * + * @param xmlReader The XmlReader being read. + * @param rootElementName Optional root element name to override the default defined by the model. Used to support + * cases where the model can deserialize from different root element names. + * @return An instance of ShareSignedIdentifierWrapper if the XmlReader was pointing to an instance of it, or null + * if it was pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. + * @throws XMLStreamException If an error occurs while reading the ShareSignedIdentifierWrapper. + */ @Generated public static ShareSignedIdentifierWrapper fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { - rootElementName = rootElementName == null || rootElementName.isEmpty() ? "SignedIdentifiers" : rootElementName; - return xmlReader.readObject(rootElementName, reader -> { + String finalRootElementName + = rootElementName == null || rootElementName.isEmpty() ? "SignedIdentifiers" : rootElementName; + return xmlReader.readObject(finalRootElementName, reader -> { List items = null; - while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); @@ -77,10 +105,9 @@ public static ShareSignedIdentifierWrapper fromXml(XmlReader xmlReader, String r if (items == null) { items = new ArrayList<>(); } - - items.add(ShareSignedIdentifier.fromXml(reader)); + items.add(ShareSignedIdentifier.fromXml(reader, "SignedIdentifier")); } else { - reader.nextElement(); + reader.skipElement(); } } return new ShareSignedIdentifierWrapper(items); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java index 86dc8c23dd3c..7acc3dbdf56a 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java @@ -1,11 +1,11 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.xml.XmlReader; import com.azure.xml.XmlSerializable; import com.azure.xml.XmlToken; @@ -16,25 +16,28 @@ /** * Stats for the share. */ -@Fluent +@Immutable public final class ShareStats implements XmlSerializable { /* - * The approximate size of the data stored in bytes, rounded up to the nearest gigabyte. Note that this value may - * not include all recently created or recently resized files. + * The approximate size of the data stored in bytes. Note that this value may not + * include all recently created or recently resized files. */ @Generated - private long shareUsageBytes; + private final long shareUsageBytes; /** * Creates an instance of ShareStats class. + * + * @param shareUsageBytes the shareUsageBytes value to set. */ @Generated - public ShareStats() { + private ShareStats(long shareUsageBytes) { + this.shareUsageBytes = shareUsageBytes; } /** - * Get the shareUsageBytes property: The approximate size of the data stored in bytes, rounded up to the nearest - * gigabyte. Note that this value may not include all recently created or recently resized files. + * Get the shareUsageBytes property: The approximate size of the data stored in bytes. Note that this value may not + * include all recently created or recently resized files. * * @return the shareUsageBytes value. */ @@ -43,19 +46,6 @@ public long getShareUsageBytes() { return this.shareUsageBytes; } - /** - * Set the shareUsageBytes property: The approximate size of the data stored in bytes, rounded up to the nearest - * gigabyte. Note that this value may not include all recently created or recently resized files. - * - * @param shareUsageBytes the shareUsageBytes value to set. - * @return the ShareStats object itself. - */ - @Generated - public ShareStats setShareUsageBytes(long shareUsageBytes) { - this.shareUsageBytes = shareUsageBytes; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @@ -77,6 +67,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt * @param xmlReader The XmlReader being read. * @return An instance of ShareStats if the XmlReader was pointing to an instance of it, or null if it was pointing * to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareStats. */ @Generated @@ -92,6 +83,7 @@ public static ShareStats fromXml(XmlReader xmlReader) throws XMLStreamException * cases where the model can deserialize from different root element names. * @return An instance of ShareStats if the XmlReader was pointing to an instance of it, or null if it was pointing * to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareStats. */ @Generated @@ -99,18 +91,17 @@ public static ShareStats fromXml(XmlReader xmlReader, String rootElementName) th String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "ShareStats" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - ShareStats deserializedShareStats = new ShareStats(); + long shareUsageBytes = 0L; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); if ("ShareUsageBytes".equals(elementName.getLocalPart())) { - deserializedShareStats.shareUsageBytes = reader.getLongElement(); + shareUsageBytes = reader.getLongElement(); } else { reader.skipElement(); } } - - return deserializedShareStats; + return new ShareStats(shareUsageBytes); }); } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java index d8c7c503a309..f79e4a456101 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java @@ -1,29 +1,29 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.implementation.models; -import com.azure.core.annotation.Fluent; import com.azure.core.annotation.Generated; +import com.azure.core.annotation.Immutable; import com.azure.xml.XmlReader; import com.azure.xml.XmlSerializable; import com.azure.xml.XmlWriter; import javax.xml.stream.XMLStreamException; /** - * The StringEncoded model. + * An encoded string value. */ -@Fluent +@Immutable public final class StringEncoded implements XmlSerializable { /* - * The Encoded property. + * Whether the value is encoded. */ @Generated private Boolean encoded; /* - * The content property. + * The string content. */ @Generated private String content; @@ -32,11 +32,11 @@ public final class StringEncoded implements XmlSerializable { * Creates an instance of StringEncoded class. */ @Generated - public StringEncoded() { + private StringEncoded() { } /** - * Get the encoded property: The Encoded property. + * Get the encoded property: Whether the value is encoded. * * @return the encoded value. */ @@ -46,19 +46,7 @@ public Boolean isEncoded() { } /** - * Set the encoded property: The Encoded property. - * - * @param encoded the encoded value to set. - * @return the StringEncoded object itself. - */ - @Generated - public StringEncoded setEncoded(Boolean encoded) { - this.encoded = encoded; - return this; - } - - /** - * Get the content property: The content property. + * Get the content property: The string content. * * @return the content value. */ @@ -67,18 +55,6 @@ public String getContent() { return this.content; } - /** - * Set the content property: The content property. - * - * @param content the content value to set. - * @return the StringEncoded object itself. - */ - @Generated - public StringEncoded setContent(String content) { - this.content = content; - return this; - } - @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/package-info.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/package-info.java index e6ea6efc5e04..fada2577345a 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/package-info.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/package-info.java @@ -1,9 +1,9 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. /** - * Package containing the data models for AzureFileStorage. - * null. + * Package containing the data models for File. + * Azure File Storage provides scalable file shares in the cloud using SMB and NFS protocols. */ package com.azure.storage.file.share.implementation.models; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ClearRange.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ClearRange.java index d3969c043497..1ed9c3a7b488 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ClearRange.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ClearRange.java @@ -1,7 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. - +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Fluent; @@ -14,18 +13,19 @@ import javax.xml.stream.XMLStreamException; /** - * The ClearRange model. + * A clear range. */ @Fluent public final class ClearRange implements XmlSerializable { + /* - * The Start property. + * Start of the range. */ @Generated private long start; /* - * The End property. + * End of the range. */ @Generated private long end; @@ -38,8 +38,20 @@ public ClearRange() { } /** - * Get the start property: The Start property. - * + * Creates an instance of ClearRange class. + * + * @param start the start value to set. + * @param end the end value to set. + */ + @Generated + private ClearRange(long start, long end) { + this.start = start; + this.end = end; + } + + /** + * Get the start property: Start of the range. + * * @return the start value. */ @Generated @@ -48,8 +60,8 @@ public long getStart() { } /** - * Set the start property: The Start property. - * + * Set the start property. + * * @param start the start value to set. * @return the ClearRange object itself. */ @@ -60,8 +72,8 @@ public ClearRange setStart(long start) { } /** - * Get the end property: The End property. - * + * Get the end property: End of the range. + * * @return the end value. */ @Generated @@ -70,8 +82,8 @@ public long getEnd() { } /** - * Set the end property: The End property. - * + * Set the end property. + * * @param end the end value to set. * @return the ClearRange object itself. */ @@ -99,10 +111,11 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt /** * Reads an instance of ClearRange from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @return An instance of ClearRange if the XmlReader was pointing to an instance of it, or null if it was pointing * to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ClearRange. */ @Generated @@ -112,12 +125,13 @@ public static ClearRange fromXml(XmlReader xmlReader) throws XMLStreamException /** * Reads an instance of ClearRange from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @param rootElementName Optional root element name to override the default defined by the model. Used to support * cases where the model can deserialize from different root element names. * @return An instance of ClearRange if the XmlReader was pointing to an instance of it, or null if it was pointing * to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ClearRange. */ @Generated @@ -125,20 +139,19 @@ public static ClearRange fromXml(XmlReader xmlReader, String rootElementName) th String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "ClearRange" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - ClearRange deserializedClearRange = new ClearRange(); + long start = 0L; + long end = 0L; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); - if ("Start".equals(elementName.getLocalPart())) { - deserializedClearRange.start = reader.getLongElement(); + start = reader.getLongElement(); } else if ("End".equals(elementName.getLocalPart())) { - deserializedClearRange.end = reader.getLongElement(); + end = reader.getLongElement(); } else { reader.skipElement(); } } - - return deserializedClearRange; + return new ClearRange(start, end); }); } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java index 9fa71849d4ff..6a4a7266f725 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java @@ -1,20 +1,20 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; /** - * Defines values for FileLastWrittenMode. + * The file last written mode. */ public enum FileLastWrittenMode { /** - * Enum value Now. + * Now. */ NOW("Now"), /** - * Enum value Preserve. + * Preserve. */ PRESERVE("Preserve"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java index 1d27e03370b1..7dfc63cd996a 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java @@ -1,20 +1,20 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; /** - * Defines values for FilePermissionFormat. + * The file permission format. */ public enum FilePermissionFormat { /** - * Enum value Sddl. + * Sddl. */ SDDL("Sddl"), /** - * Enum value Binary. + * Binary. */ BINARY("Binary"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java index 09d3dbc64747..9d1c591c76c0 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; @@ -9,17 +9,17 @@ import java.util.Collection; /** - * Defines values for FilePropertySemantics. + * The file property semantics. */ public final class FilePropertySemantics extends ExpandableStringEnum { /** - * Static value New for FilePropertySemantics. + * New. */ @Generated public static final FilePropertySemantics NEW = fromString("New"); /** - * Static value Restore for FilePropertySemantics. + * Restore. */ @Generated public static final FilePropertySemantics RESTORE = fromString("Restore"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FileRange.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FileRange.java index 879911696146..3671fa342237 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FileRange.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/FileRange.java @@ -1,7 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. - +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Fluent; @@ -18,6 +17,7 @@ */ @Fluent public final class FileRange implements XmlSerializable { + /* * Start of the range. */ @@ -37,9 +37,21 @@ public final class FileRange implements XmlSerializable { public FileRange() { } + /** + * Creates an instance of FileRange class. + * + * @param start the start value to set. + * @param end the end value to set. + */ + @Generated + private FileRange(long start, long end) { + this.start = start; + this.end = end; + } + /** * Get the start property: Start of the range. - * + * * @return the start value. */ @Generated @@ -48,8 +60,8 @@ public long getStart() { } /** - * Set the start property: Start of the range. - * + * Set the start property. + * * @param start the start value to set. * @return the FileRange object itself. */ @@ -61,7 +73,7 @@ public FileRange setStart(long start) { /** * Get the end property: End of the range. - * + * * @return the end value. */ @Generated @@ -70,8 +82,8 @@ public long getEnd() { } /** - * Set the end property: End of the range. - * + * Set the end property. + * * @param end the end value to set. * @return the FileRange object itself. */ @@ -99,10 +111,11 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt /** * Reads an instance of FileRange from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @return An instance of FileRange if the XmlReader was pointing to an instance of it, or null if it was pointing * to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the FileRange. */ @Generated @@ -112,32 +125,32 @@ public static FileRange fromXml(XmlReader xmlReader) throws XMLStreamException { /** * Reads an instance of FileRange from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @param rootElementName Optional root element name to override the default defined by the model. Used to support * cases where the model can deserialize from different root element names. * @return An instance of FileRange if the XmlReader was pointing to an instance of it, or null if it was pointing * to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the FileRange. */ @Generated public static FileRange fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "Range" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - FileRange deserializedFileRange = new FileRange(); + long start = 0L; + long end = 0L; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); - if ("Start".equals(elementName.getLocalPart())) { - deserializedFileRange.start = reader.getLongElement(); + start = reader.getLongElement(); } else if ("End".equals(elementName.getLocalPart())) { - deserializedFileRange.end = reader.getLongElement(); + end = reader.getLongElement(); } else { reader.skipElement(); } } - - return deserializedFileRange; + return new FileRange(start, end); }); } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java index b065e6d5b08a..39c3bed0ce9c 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java @@ -1,20 +1,21 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; /** - * When a share is leased, specifies whether the lease is of infinite or fixed duration. + * When a share is leased, specifies whether the lease is of infinite or fixed + * duration. */ public enum LeaseDurationType { /** - * Enum value infinite. + * infinite. */ INFINITE("infinite"), /** - * Enum value fixed. + * fixed. */ FIXED("fixed"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseStateType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseStateType.java index e00c467b6e96..ed07b186ac83 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseStateType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseStateType.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; @@ -9,27 +9,27 @@ */ public enum LeaseStateType { /** - * Enum value available. + * available. */ AVAILABLE("available"), /** - * Enum value leased. + * leased. */ LEASED("leased"), /** - * Enum value expired. + * expired. */ EXPIRED("expired"), /** - * Enum value breaking. + * breaking. */ BREAKING("breaking"), /** - * Enum value broken. + * broken. */ BROKEN("broken"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java index 872d8e77c233..4c62a6487679 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; @@ -9,12 +9,12 @@ */ public enum LeaseStatusType { /** - * Enum value locked. + * locked. */ LOCKED("locked"), /** - * Enum value unlocked. + * unlocked. */ UNLOCKED("unlocked"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java index e9908d9bdc1b..d16f9defb9d3 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java @@ -1,20 +1,20 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; /** - * Defines values for ModeCopyMode. + * The mode copy mode. */ public enum ModeCopyMode { /** - * Enum value source. + * source. */ SOURCE("source"), /** - * Enum value override. + * override. */ OVERRIDE("override"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/NfsFileType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/NfsFileType.java index c252495b5def..dc2f39d7b581 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/NfsFileType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/NfsFileType.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; @@ -9,23 +9,23 @@ import java.util.Collection; /** - * Defines values for NfsFileType. + * The NFS file type. */ public final class NfsFileType extends ExpandableStringEnum { /** - * Static value Regular for NfsFileType. + * Regular. */ @Generated public static final NfsFileType REGULAR = fromString("Regular"); /** - * Static value Directory for NfsFileType. + * Directory. */ @Generated public static final NfsFileType DIRECTORY = fromString("Directory"); /** - * Static value SymLink for NfsFileType. + * SymLink. */ @Generated public static final NfsFileType SYM_LINK = fromString("SymLink"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java index 657a96030d45..37c1f0a4c988 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java @@ -1,20 +1,20 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; /** - * Defines values for OwnerCopyMode. + * The owner copy mode. */ public enum OwnerCopyMode { /** - * Enum value source. + * source. */ SOURCE("source"), /** - * Enum value override. + * override. */ OVERRIDE("override"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java index bc14fbda053f..1d5387362489 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java @@ -1,20 +1,20 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; /** - * Defines values for PermissionCopyModeType. + * The permission copy mode type. */ public enum PermissionCopyModeType { /** - * Enum value source. + * source. */ SOURCE("source"), /** - * Enum value override. + * override. */ OVERRIDE("override"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java index 1e42a446e87f..95b33932bb23 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; @@ -121,7 +121,7 @@ public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLStreamException { - rootElementName = rootElementName == null || rootElementName.isEmpty() ? "ShareAccessPolicy" : rootElementName; + rootElementName = rootElementName == null || rootElementName.isEmpty() ? "AccessPolicy" : rootElementName; xmlWriter.writeStartElement(rootElementName); xmlWriter.writeStringElement("Start", this.startsOn == null ? null : DateTimeFormatter.ISO_OFFSET_DATE_TIME.format(this.startsOn)); @@ -157,7 +157,7 @@ public static ShareAccessPolicy fromXml(XmlReader xmlReader) throws XMLStreamExc @Generated public static ShareAccessPolicy fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { String finalRootElementName - = rootElementName == null || rootElementName.isEmpty() ? "ShareAccessPolicy" : rootElementName; + = rootElementName == null || rootElementName.isEmpty() ? "AccessPolicy" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { ShareAccessPolicy deserializedShareAccessPolicy = new ShareAccessPolicy(); while (reader.nextElement() != XmlToken.END_ELEMENT) { diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java index 9db1dce97296..a6a200f202cb 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; @@ -9,29 +9,29 @@ import java.util.Collection; /** - * Defines values for ShareAccessTier. + * The access tier of the share. */ public final class ShareAccessTier extends ExpandableStringEnum { /** - * Static value TransactionOptimized for ShareAccessTier. + * TransactionOptimized. */ @Generated public static final ShareAccessTier TRANSACTION_OPTIMIZED = fromString("TransactionOptimized"); /** - * Static value Hot for ShareAccessTier. + * Hot. */ @Generated public static final ShareAccessTier HOT = fromString("Hot"); /** - * Static value Cool for ShareAccessTier. + * Cool. */ @Generated public static final ShareAccessTier COOL = fromString("Cool"); /** - * Static value Premium for ShareAccessTier. + * Premium. */ @Generated public static final ShareAccessTier PREMIUM = fromString("Premium"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java index 78bd5058d79f..f255e0f4e3ba 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java @@ -1,7 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. - +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Fluent; @@ -14,24 +13,28 @@ import javax.xml.stream.XMLStreamException; /** - * 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. + * 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. */ @Fluent public final class ShareCorsRule implements XmlSerializable { + /* - * The origin domains that are permitted to make a request against the storage service via CORS. The origin domain - * is the domain from which the request originates. Note that the origin must be an exact case-sensitive match with - * the origin that the user age sends to the service. You can also use the wildcard character '*' to allow all - * origin domains to make requests via CORS. + * The origin domains that are permitted to make a request against the storage + * service via CORS. The origin domain is the domain from which the request + * originates. Note that the origin must be an exact case-sensitive match with the + * origin that the user age sends to the service. You can also use the wildcard + * character '*' to allow all origin domains to make requests via CORS. */ @Generated private String allowedOrigins; /* - * The methods (HTTP request verbs) that the origin domain may use for a CORS request. (comma separated) + * The methods (HTTP request verbs) that the origin domain may use for a CORS + * request. (comma separated) */ @Generated private String allowedMethods; @@ -43,14 +46,15 @@ public final class ShareCorsRule implements XmlSerializable { private String allowedHeaders; /* - * The response headers that may be sent in the response to the CORS request and exposed by the browser to the - * request issuer. + * The response headers that may be sent in the response to the CORS request and + * exposed by the browser to the request issuer. */ @Generated private String exposedHeaders; /* - * The maximum amount time that a browser should cache the preflight OPTIONS request. + * The maximum amount time that a browser should cache the preflight OPTIONS + * request. */ @Generated private int maxAgeInSeconds; @@ -62,12 +66,32 @@ public final class ShareCorsRule implements XmlSerializable { public ShareCorsRule() { } + /** + * Creates an instance of ShareCorsRule class. + * + * @param allowedOrigins the allowedOrigins value to set. + * @param allowedMethods the allowedMethods value to set. + * @param allowedHeaders the allowedHeaders value to set. + * @param exposedHeaders the exposedHeaders value to set. + * @param maxAgeInSeconds the maxAgeInSeconds value to set. + */ + @Generated + public ShareCorsRule(String allowedOrigins, String allowedMethods, String allowedHeaders, String exposedHeaders, + int maxAgeInSeconds) { + this.allowedOrigins = allowedOrigins; + this.allowedMethods = allowedMethods; + this.allowedHeaders = allowedHeaders; + this.exposedHeaders = exposedHeaders; + this.maxAgeInSeconds = maxAgeInSeconds; + } + /** * Get the allowedOrigins property: The origin domains that are permitted to make a request against the storage - * service via CORS. The origin domain is the domain from which the request originates. Note that the origin must be - * an exact case-sensitive match with the origin that the user age sends to the service. You can also use the - * wildcard character '*' to allow all origin domains to make requests via CORS. - * + * service via CORS. The origin domain is the domain from which the request + * originates. Note that the origin must be an exact case-sensitive match with the + * origin that the user age sends to the service. You can also use the wildcard + * character '*' to allow all origin domains to make requests via CORS. + * * @return the allowedOrigins value. */ @Generated @@ -76,11 +100,8 @@ public String getAllowedOrigins() { } /** - * Set the allowedOrigins property: The origin domains that are permitted to make a request against the storage - * service via CORS. The origin domain is the domain from which the request originates. Note that the origin must be - * an exact case-sensitive match with the origin that the user age sends to the service. You can also use the - * wildcard character '*' to allow all origin domains to make requests via CORS. - * + * Set the allowedOrigins property. + * * @param allowedOrigins the allowedOrigins value to set. * @return the ShareCorsRule object itself. */ @@ -93,7 +114,7 @@ public ShareCorsRule setAllowedOrigins(String allowedOrigins) { /** * Get the allowedMethods property: The methods (HTTP request verbs) that the origin domain may use for a CORS * request. (comma separated). - * + * * @return the allowedMethods value. */ @Generated @@ -102,9 +123,8 @@ public String getAllowedMethods() { } /** - * Set the allowedMethods property: The methods (HTTP request verbs) that the origin domain may use for a CORS - * request. (comma separated). - * + * Set the allowedMethods property. + * * @param allowedMethods the allowedMethods value to set. * @return the ShareCorsRule object itself. */ @@ -116,7 +136,7 @@ public ShareCorsRule setAllowedMethods(String allowedMethods) { /** * Get the allowedHeaders property: The request headers that the origin domain may specify on the CORS request. - * + * * @return the allowedHeaders value. */ @Generated @@ -125,8 +145,8 @@ public String getAllowedHeaders() { } /** - * Set the allowedHeaders property: The request headers that the origin domain may specify on the CORS request. - * + * Set the allowedHeaders property. + * * @param allowedHeaders the allowedHeaders value to set. * @return the ShareCorsRule object itself. */ @@ -139,7 +159,7 @@ public ShareCorsRule setAllowedHeaders(String allowedHeaders) { /** * Get the exposedHeaders property: The response headers that may be sent in the response to the CORS request and * exposed by the browser to the request issuer. - * + * * @return the exposedHeaders value. */ @Generated @@ -148,9 +168,8 @@ public String getExposedHeaders() { } /** - * Set the exposedHeaders property: The response headers that may be sent in the response to the CORS request and - * exposed by the browser to the request issuer. - * + * Set the exposedHeaders property. + * * @param exposedHeaders the exposedHeaders value to set. * @return the ShareCorsRule object itself. */ @@ -163,7 +182,7 @@ public ShareCorsRule setExposedHeaders(String exposedHeaders) { /** * Get the maxAgeInSeconds property: The maximum amount time that a browser should cache the preflight OPTIONS * request. - * + * * @return the maxAgeInSeconds value. */ @Generated @@ -172,9 +191,8 @@ public int getMaxAgeInSeconds() { } /** - * Set the maxAgeInSeconds property: The maximum amount time that a browser should cache the preflight OPTIONS - * request. - * + * Set the maxAgeInSeconds property. + * * @param maxAgeInSeconds the maxAgeInSeconds value to set. * @return the ShareCorsRule object itself. */ @@ -205,10 +223,11 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt /** * Reads an instance of ShareCorsRule from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @return An instance of ShareCorsRule if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareCorsRule. */ @Generated @@ -218,12 +237,13 @@ public static ShareCorsRule fromXml(XmlReader xmlReader) throws XMLStreamExcepti /** * Reads an instance of ShareCorsRule from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @param rootElementName Optional root element name to override the default defined by the model. Used to support * cases where the model can deserialize from different root element names. * @return An instance of ShareCorsRule if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareCorsRule. */ @Generated @@ -231,26 +251,28 @@ public static ShareCorsRule fromXml(XmlReader xmlReader, String rootElementName) String finalRootElementName = rootElementName == null || rootElementName.isEmpty() ? "CorsRule" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - ShareCorsRule deserializedShareCorsRule = new ShareCorsRule(); + String allowedOrigins = null; + String allowedMethods = null; + String allowedHeaders = null; + String exposedHeaders = null; + int maxAgeInSeconds = 0; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); - if ("AllowedOrigins".equals(elementName.getLocalPart())) { - deserializedShareCorsRule.allowedOrigins = reader.getStringElement(); + allowedOrigins = reader.getStringElement(); } else if ("AllowedMethods".equals(elementName.getLocalPart())) { - deserializedShareCorsRule.allowedMethods = reader.getStringElement(); + allowedMethods = reader.getStringElement(); } else if ("AllowedHeaders".equals(elementName.getLocalPart())) { - deserializedShareCorsRule.allowedHeaders = reader.getStringElement(); + allowedHeaders = reader.getStringElement(); } else if ("ExposedHeaders".equals(elementName.getLocalPart())) { - deserializedShareCorsRule.exposedHeaders = reader.getStringElement(); + exposedHeaders = reader.getStringElement(); } else if ("MaxAgeInSeconds".equals(elementName.getLocalPart())) { - deserializedShareCorsRule.maxAgeInSeconds = reader.getIntElement(); + maxAgeInSeconds = reader.getIntElement(); } else { reader.skipElement(); } } - - return deserializedShareCorsRule; + return new ShareCorsRule(allowedOrigins, allowedMethods, allowedHeaders, exposedHeaders, maxAgeInSeconds); }); } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java index 6941120c8d2f..6fb5a1f25366 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; @@ -9,17 +9,17 @@ */ public enum ShareFileHandleAccessRights { /** - * Enum value Read. + * Read. */ READ("Read"), /** - * Enum value Write. + * Write. */ WRITE("Write"), /** - * Enum value Delete. + * Delete. */ DELETE("Delete"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java index 9f670646d07c..0d0443808903 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java @@ -1,7 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. - +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Fluent; @@ -20,14 +19,15 @@ */ @Fluent public final class ShareFileRangeList implements XmlSerializable { + /* - * The Ranges property. + * The file ranges. */ @Generated private List ranges = new ArrayList<>(); /* - * The ClearRanges property. + * The clear ranges. */ @Generated private List clearRanges = new ArrayList<>(); @@ -40,8 +40,8 @@ public ShareFileRangeList() { } /** - * Get the ranges property: The Ranges property. - * + * Get the ranges property: The file ranges. + * * @return the ranges value. */ @Generated @@ -50,8 +50,8 @@ public List getRanges() { } /** - * Set the ranges property: The Ranges property. - * + * Set the ranges property. + * * @param ranges the ranges value to set. * @return the ShareFileRangeList object itself. */ @@ -62,8 +62,8 @@ public ShareFileRangeList setRanges(List ranges) { } /** - * Get the clearRanges property: The ClearRanges property. - * + * Get the clearRanges property: The clear ranges. + * * @return the clearRanges value. */ @Generated @@ -72,8 +72,8 @@ public List getClearRanges() { } /** - * Set the clearRanges property: The ClearRanges property. - * + * Set the clearRanges property. + * * @param clearRanges the clearRanges value to set. * @return the ShareFileRangeList object itself. */ @@ -109,7 +109,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt /** * Reads an instance of ShareFileRangeList from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @return An instance of ShareFileRangeList if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. @@ -122,7 +122,7 @@ public static ShareFileRangeList fromXml(XmlReader xmlReader) throws XMLStreamEx /** * Reads an instance of ShareFileRangeList from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @param rootElementName Optional root element name to override the default defined by the model. Used to support * cases where the model can deserialize from different root element names. @@ -137,7 +137,6 @@ public static ShareFileRangeList fromXml(XmlReader xmlReader, String rootElement ShareFileRangeList deserializedShareFileRangeList = new ShareFileRangeList(); while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); - if ("Range".equals(elementName.getLocalPart())) { deserializedShareFileRangeList.ranges.add(FileRange.fromXml(reader, "Range")); } else if ("ClearRange".equals(elementName.getLocalPart())) { @@ -146,7 +145,6 @@ public static ShareFileRangeList fromXml(XmlReader xmlReader, String rootElement reader.skipElement(); } } - return deserializedShareFileRangeList; }); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareMetrics.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareMetrics.java index 718d61119d36..9646e9757a48 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareMetrics.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareMetrics.java @@ -1,7 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. - +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Fluent; @@ -18,6 +17,7 @@ */ @Fluent public final class ShareMetrics implements XmlSerializable { + /* * The version of Storage Analytics to configure. */ @@ -31,7 +31,8 @@ public final class ShareMetrics implements XmlSerializable { private boolean enabled; /* - * Indicates whether metrics should generate summary statistics for called API operations. + * Indicates whether metrics should generate summary statistics for called API + * operations. */ @Generated private Boolean includeApis; @@ -49,9 +50,21 @@ public final class ShareMetrics implements XmlSerializable { public ShareMetrics() { } + /** + * Creates an instance of ShareMetrics class. + * + * @param version the version value to set. + * @param enabled the enabled value to set. + */ + @Generated + public ShareMetrics(String version, boolean enabled) { + this.version = version; + this.enabled = enabled; + } + /** * Get the version property: The version of Storage Analytics to configure. - * + * * @return the version value. */ @Generated @@ -60,8 +73,8 @@ public String getVersion() { } /** - * Set the version property: The version of Storage Analytics to configure. - * + * Set the version property. + * * @param version the version value to set. * @return the ShareMetrics object itself. */ @@ -73,7 +86,7 @@ public ShareMetrics setVersion(String version) { /** * Get the enabled property: Indicates whether metrics are enabled for the File service. - * + * * @return the enabled value. */ @Generated @@ -82,8 +95,8 @@ public boolean isEnabled() { } /** - * Set the enabled property: Indicates whether metrics are enabled for the File service. - * + * Set the enabled property. + * * @param enabled the enabled value to set. * @return the ShareMetrics object itself. */ @@ -96,7 +109,7 @@ public ShareMetrics setEnabled(boolean enabled) { /** * Get the includeApis property: Indicates whether metrics should generate summary statistics for called API * operations. - * + * * @return the includeApis value. */ @Generated @@ -107,7 +120,7 @@ public Boolean isIncludeApis() { /** * Set the includeApis property: Indicates whether metrics should generate summary statistics for called API * operations. - * + * * @param includeApis the includeApis value to set. * @return the ShareMetrics object itself. */ @@ -119,7 +132,7 @@ public ShareMetrics setIncludeApis(Boolean includeApis) { /** * Get the retentionPolicy property: The retention policy. - * + * * @return the retentionPolicy value. */ @Generated @@ -129,7 +142,7 @@ public ShareRetentionPolicy getRetentionPolicy() { /** * Set the retentionPolicy property: The retention policy. - * + * * @param retentionPolicy the retentionPolicy value to set. * @return the ShareMetrics object itself. */ @@ -148,7 +161,7 @@ public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLStreamException { - rootElementName = rootElementName == null || rootElementName.isEmpty() ? "ShareMetrics" : rootElementName; + rootElementName = rootElementName == null || rootElementName.isEmpty() ? "Metrics" : rootElementName; xmlWriter.writeStartElement(rootElementName); xmlWriter.writeStringElement("Version", this.version); xmlWriter.writeBooleanElement("Enabled", this.enabled); @@ -159,10 +172,11 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt /** * Reads an instance of ShareMetrics from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @return An instance of ShareMetrics if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareMetrics. */ @Generated @@ -172,36 +186,41 @@ public static ShareMetrics fromXml(XmlReader xmlReader) throws XMLStreamExceptio /** * Reads an instance of ShareMetrics from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @param rootElementName Optional root element name to override the default defined by the model. Used to support * cases where the model can deserialize from different root element names. * @return An instance of ShareMetrics if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareMetrics. */ @Generated public static ShareMetrics fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { String finalRootElementName - = rootElementName == null || rootElementName.isEmpty() ? "ShareMetrics" : rootElementName; + = rootElementName == null || rootElementName.isEmpty() ? "Metrics" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - ShareMetrics deserializedShareMetrics = new ShareMetrics(); + String version = null; + boolean enabled = false; + Boolean includeApis = null; + ShareRetentionPolicy retentionPolicy = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); - if ("Version".equals(elementName.getLocalPart())) { - deserializedShareMetrics.version = reader.getStringElement(); + version = reader.getStringElement(); } else if ("Enabled".equals(elementName.getLocalPart())) { - deserializedShareMetrics.enabled = reader.getBooleanElement(); + enabled = reader.getBooleanElement(); } else if ("IncludeAPIs".equals(elementName.getLocalPart())) { - deserializedShareMetrics.includeApis = reader.getNullableElement(Boolean::parseBoolean); + includeApis = reader.getNullableElement(Boolean::parseBoolean); } else if ("RetentionPolicy".equals(elementName.getLocalPart())) { - deserializedShareMetrics.retentionPolicy = ShareRetentionPolicy.fromXml(reader, "RetentionPolicy"); + retentionPolicy = ShareRetentionPolicy.fromXml(reader, "RetentionPolicy"); } else { reader.skipElement(); } } - + ShareMetrics deserializedShareMetrics = new ShareMetrics(version, enabled); + deserializedShareMetrics.includeApis = includeApis; + deserializedShareMetrics.retentionPolicy = retentionPolicy; return deserializedShareMetrics; }); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java index 73a774a63d08..6a1eb8bc98ea 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java index 3ab4d10f37a2..43bcac5227cc 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java index 31dc752c64ad..c4d639121c45 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java index 0783d2157471..b4691c332d49 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java @@ -1,7 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. - +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Fluent; @@ -18,16 +17,18 @@ */ @Fluent public final class ShareRetentionPolicy implements XmlSerializable { + /* - * Indicates whether a retention policy is enabled for the File service. If false, metrics data is retained, and the - * user is responsible for deleting it. + * Indicates whether a retention policy is enabled for the File service. If false, + * metrics data is retained, and the user is responsible for deleting it. */ @Generated private boolean enabled; /* - * Indicates the number of days that metrics data should be retained. All data older than this value will be - * deleted. Metrics data is deleted on a best-effort basis after the retention period expires. + * Indicates the number of days that metrics data should be retained. All data + * older than this value will be deleted. Metrics data is deleted on a best-effort + * basis after the retention period expires. */ @Generated private Integer days; @@ -40,9 +41,19 @@ public ShareRetentionPolicy() { } /** - * Get the enabled property: Indicates whether a retention policy is enabled for the File service. If false, metrics - * data is retained, and the user is responsible for deleting it. - * + * Creates an instance of ShareRetentionPolicy class. + * + * @param enabled the enabled value to set. + */ + @Generated + public ShareRetentionPolicy(boolean enabled) { + this.enabled = enabled; + } + + /** + * Get the enabled property: Indicates whether a retention policy is enabled for the File service. If false, + * metrics data is retained, and the user is responsible for deleting it. + * * @return the enabled value. */ @Generated @@ -51,9 +62,8 @@ public boolean isEnabled() { } /** - * Set the enabled property: Indicates whether a retention policy is enabled for the File service. If false, metrics - * data is retained, and the user is responsible for deleting it. - * + * Set the enabled property. + * * @param enabled the enabled value to set. * @return the ShareRetentionPolicy object itself. */ @@ -64,9 +74,10 @@ public ShareRetentionPolicy setEnabled(boolean enabled) { } /** - * Get the days property: Indicates the number of days that metrics data should be retained. All data older than - * this value will be deleted. Metrics data is deleted on a best-effort basis after the retention period expires. - * + * Get the days property: Indicates the number of days that metrics data should be retained. All data + * older than this value will be deleted. Metrics data is deleted on a best-effort + * basis after the retention period expires. + * * @return the days value. */ @Generated @@ -75,9 +86,10 @@ public Integer getDays() { } /** - * Set the days property: Indicates the number of days that metrics data should be retained. All data older than - * this value will be deleted. Metrics data is deleted on a best-effort basis after the retention period expires. - * + * Set the days property: Indicates the number of days that metrics data should be retained. All data + * older than this value will be deleted. Metrics data is deleted on a best-effort + * basis after the retention period expires. + * * @param days the days value to set. * @return the ShareRetentionPolicy object itself. */ @@ -96,8 +108,7 @@ public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException { @Generated @Override public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLStreamException { - rootElementName - = rootElementName == null || rootElementName.isEmpty() ? "ShareRetentionPolicy" : rootElementName; + rootElementName = rootElementName == null || rootElementName.isEmpty() ? "RetentionPolicy" : rootElementName; xmlWriter.writeStartElement(rootElementName); xmlWriter.writeBooleanElement("Enabled", this.enabled); xmlWriter.writeNumberElement("Days", this.days); @@ -106,10 +117,11 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt /** * Reads an instance of ShareRetentionPolicy from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @return An instance of ShareRetentionPolicy if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareRetentionPolicy. */ @Generated @@ -119,32 +131,34 @@ public static ShareRetentionPolicy fromXml(XmlReader xmlReader) throws XMLStream /** * Reads an instance of ShareRetentionPolicy from the XmlReader. - * + * * @param xmlReader The XmlReader being read. * @param rootElementName Optional root element name to override the default defined by the model. Used to support * cases where the model can deserialize from different root element names. * @return An instance of ShareRetentionPolicy if the XmlReader was pointing to an instance of it, or null if it was * pointing to XML null. + * @throws IllegalStateException If the deserialized XML object was missing any required properties. * @throws XMLStreamException If an error occurs while reading the ShareRetentionPolicy. */ @Generated public static ShareRetentionPolicy fromXml(XmlReader xmlReader, String rootElementName) throws XMLStreamException { String finalRootElementName - = rootElementName == null || rootElementName.isEmpty() ? "ShareRetentionPolicy" : rootElementName; + = rootElementName == null || rootElementName.isEmpty() ? "RetentionPolicy" : rootElementName; return xmlReader.readObject(finalRootElementName, reader -> { - ShareRetentionPolicy deserializedShareRetentionPolicy = new ShareRetentionPolicy(); + boolean enabled = false; + Integer days = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); - if ("Enabled".equals(elementName.getLocalPart())) { - deserializedShareRetentionPolicy.enabled = reader.getBooleanElement(); + enabled = reader.getBooleanElement(); } else if ("Days".equals(elementName.getLocalPart())) { - deserializedShareRetentionPolicy.days = reader.getNullableElement(Integer::parseInt); + days = reader.getNullableElement(Integer::parseInt); } else { reader.skipElement(); } } - + ShareRetentionPolicy deserializedShareRetentionPolicy = new ShareRetentionPolicy(enabled); + deserializedShareRetentionPolicy.days = days; return deserializedShareRetentionPolicy; }); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java index 84b022714b9e..78c6e122f7ac 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java @@ -1,25 +1,25 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; /** - * Defines values for ShareRootSquash. + * The root squash setting for the share. */ public enum ShareRootSquash { /** - * Enum value NoRootSquash. + * NoRootSquash. */ NO_ROOT_SQUASH("NoRootSquash"), /** - * Enum value RootSquash. + * RootSquash. */ ROOT_SQUASH("RootSquash"), /** - * Enum value AllSquash. + * AllSquash. */ ALL_SQUASH("AllSquash"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java index 300369a662cc..ad65f177ca83 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; @@ -33,16 +33,16 @@ public final class ShareServiceProperties implements XmlSerializable cors; + private ShareProtocolSettings protocol; /* - * Protocol settings + * The set of CORS rules. */ @Generated - private ShareProtocolSettings protocol; + private List cors; /** * Creates an instance of ShareServiceProperties class. @@ -96,49 +96,49 @@ public ShareServiceProperties setMinuteMetrics(ShareMetrics minuteMetrics) { } /** - * Get the cors property: The set of CORS rules. + * Get the protocol property: Protocol settings. * - * @return the cors value. + * @return the protocol value. */ @Generated - public List getCors() { - if (this.cors == null) { - this.cors = new ArrayList<>(); - } - return this.cors; + public ShareProtocolSettings getProtocol() { + return this.protocol; } /** - * Set the cors property: The set of CORS rules. + * Set the protocol property: Protocol settings. * - * @param cors the cors value to set. + * @param protocol the protocol value to set. * @return the ShareServiceProperties object itself. */ @Generated - public ShareServiceProperties setCors(List cors) { - this.cors = cors; + public ShareServiceProperties setProtocol(ShareProtocolSettings protocol) { + this.protocol = protocol; return this; } /** - * Get the protocol property: Protocol settings. + * Get the cors property: The set of CORS rules. * - * @return the protocol value. + * @return the cors value. */ @Generated - public ShareProtocolSettings getProtocol() { - return this.protocol; + public List getCors() { + if (this.cors == null) { + this.cors = new ArrayList<>(); + } + return this.cors; } /** - * Set the protocol property: Protocol settings. + * Set the cors property: The set of CORS rules. * - * @param protocol the protocol value to set. + * @param cors the cors value to set. * @return the ShareServiceProperties object itself. */ @Generated - public ShareServiceProperties setProtocol(ShareProtocolSettings protocol) { - this.protocol = protocol; + public ShareServiceProperties setCors(List cors) { + this.cors = cors; return this; } @@ -156,6 +156,7 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt xmlWriter.writeStartElement(rootElementName); xmlWriter.writeXml(this.hourMetrics, "HourMetrics"); xmlWriter.writeXml(this.minuteMetrics, "MinuteMetrics"); + xmlWriter.writeXml(this.protocol, "ProtocolSettings"); if (this.cors != null) { xmlWriter.writeStartElement("Cors"); for (ShareCorsRule element : this.cors) { @@ -163,7 +164,6 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt } xmlWriter.writeEndElement(); } - xmlWriter.writeXml(this.protocol, "ProtocolSettings"); return xmlWriter.writeEndElement(); } @@ -204,6 +204,9 @@ public static ShareServiceProperties fromXml(XmlReader xmlReader, String rootEle deserializedShareServiceProperties.hourMetrics = ShareMetrics.fromXml(reader, "HourMetrics"); } else if ("MinuteMetrics".equals(elementName.getLocalPart())) { deserializedShareServiceProperties.minuteMetrics = ShareMetrics.fromXml(reader, "MinuteMetrics"); + } else if ("ProtocolSettings".equals(elementName.getLocalPart())) { + deserializedShareServiceProperties.protocol + = ShareProtocolSettings.fromXml(reader, "ProtocolSettings"); } else if ("Cors".equals(elementName.getLocalPart())) { while (reader.nextElement() != XmlToken.END_ELEMENT) { elementName = reader.getElementName(); @@ -216,9 +219,6 @@ public static ShareServiceProperties fromXml(XmlReader xmlReader, String rootEle reader.skipElement(); } } - } else if ("ProtocolSettings".equals(elementName.getLocalPart())) { - deserializedShareServiceProperties.protocol - = ShareProtocolSettings.fromXml(reader, "ProtocolSettings"); } else { reader.skipElement(); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java index a002cb98e5fe..1fc17530e5b2 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java @@ -1,7 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. - +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Fluent; @@ -18,6 +17,7 @@ */ @Fluent public final class ShareSignedIdentifier implements XmlSerializable { + /* * A unique id. */ @@ -37,9 +37,19 @@ public final class ShareSignedIdentifier implements XmlSerializable { - ShareSignedIdentifier deserializedShareSignedIdentifier = new ShareSignedIdentifier(); + String id = null; + ShareAccessPolicy accessPolicy = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); - if ("Id".equals(elementName.getLocalPart())) { - deserializedShareSignedIdentifier.id = reader.getStringElement(); + id = reader.getStringElement(); } else if ("AccessPolicy".equals(elementName.getLocalPart())) { - deserializedShareSignedIdentifier.accessPolicy = ShareAccessPolicy.fromXml(reader, "AccessPolicy"); + accessPolicy = ShareAccessPolicy.fromXml(reader, "AccessPolicy"); } else { reader.skipElement(); } } - + ShareSignedIdentifier deserializedShareSignedIdentifier = new ShareSignedIdentifier(id); + deserializedShareSignedIdentifier.accessPolicy = accessPolicy; return deserializedShareSignedIdentifier; }); } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java index db2f5a1ece99..068b8bb48054 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java index 64e46a883d22..c4d8ece32f27 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java index f1a5f8d3791f..11d41cd8120c 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Generated; @@ -14,7 +14,7 @@ public final class ShareTokenIntent extends ExpandableStringEnum { /** - * Static value backup for ShareTokenIntent. + * backup. */ @Generated public static final ShareTokenIntent BACKUP = fromString("backup"); diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java index 77783c2023c4..901b5d4fb903 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java @@ -1,6 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java index a7dde992c297..7506c093a84b 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java @@ -1,7 +1,6 @@ // Copyright (c) Microsoft Corporation. All rights reserved. // Licensed under the MIT License. -// Code generated by Microsoft (R) AutoRest Code Generator. - +// Code generated by Microsoft (R) TypeSpec Code Generator. package com.azure.storage.file.share.models; import com.azure.core.annotation.Fluent; @@ -21,6 +20,7 @@ */ @Fluent public final class UserDelegationKey implements XmlSerializable { + /* * The Azure Active Directory object ID in GUID format. */ @@ -58,7 +58,8 @@ public final class UserDelegationKey implements XmlSerializable { - UserDelegationKey deserializedUserDelegationKey = new UserDelegationKey(); + String signedObjectId = null; + String signedTenantId = null; + OffsetDateTime signedStart = null; + OffsetDateTime signedExpiry = null; + String signedService = null; + String signedVersion = null; + String signedDelegatedUserTenantId = null; + String value = null; while (reader.nextElement() != XmlToken.END_ELEMENT) { QName elementName = reader.getElementName(); - if ("SignedOid".equals(elementName.getLocalPart())) { - deserializedUserDelegationKey.signedObjectId = reader.getStringElement(); + signedObjectId = reader.getStringElement(); } else if ("SignedTid".equals(elementName.getLocalPart())) { - deserializedUserDelegationKey.signedTenantId = reader.getStringElement(); + signedTenantId = reader.getStringElement(); } else if ("SignedStart".equals(elementName.getLocalPart())) { - deserializedUserDelegationKey.signedStart + signedStart = reader.getNullableElement(dateString -> CoreUtils.parseBestOffsetDateTime(dateString)); } else if ("SignedExpiry".equals(elementName.getLocalPart())) { - deserializedUserDelegationKey.signedExpiry + signedExpiry = reader.getNullableElement(dateString -> CoreUtils.parseBestOffsetDateTime(dateString)); } else if ("SignedService".equals(elementName.getLocalPart())) { - deserializedUserDelegationKey.signedService = reader.getStringElement(); + signedService = reader.getStringElement(); } else if ("SignedVersion".equals(elementName.getLocalPart())) { - deserializedUserDelegationKey.signedVersion = reader.getStringElement(); + signedVersion = reader.getStringElement(); } else if ("SignedDelegatedUserTid".equals(elementName.getLocalPart())) { - deserializedUserDelegationKey.signedDelegatedUserTenantId = reader.getStringElement(); + signedDelegatedUserTenantId = reader.getStringElement(); } else if ("Value".equals(elementName.getLocalPart())) { - deserializedUserDelegationKey.value = reader.getStringElement(); + value = reader.getStringElement(); } else { reader.skipElement(); } } - + UserDelegationKey deserializedUserDelegationKey = new UserDelegationKey(signedObjectId, signedTenantId, + signedStart, signedExpiry, signedService, signedVersion, value); + deserializedUserDelegationKey.signedDelegatedUserTenantId = signedDelegatedUserTenantId; return deserializedUserDelegationKey; }); } diff --git a/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json b/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json new file mode 100644 index 000000000000..3abfaf07889f --- /dev/null +++ b/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json @@ -0,0 +1 @@ +{"flavor":"azure","apiVersions":{"Storage.File":"2026-06-06"},"crossLanguagePackageId":"Storage.File","crossLanguageVersion":"741c448defd6","crossLanguageDefinitions":{"com.azure.storage.file.share.AzureFileStorageBuilder":"Storage.File","com.azure.storage.file.share.DirectoryAsyncClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryAsyncClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryAsyncClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryAsyncClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.FileAsyncClient":"Storage.File.File","com.azure.storage.file.share.FileAsyncClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileAsyncClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient":"Storage.File.File","com.azure.storage.file.share.FileClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.ServiceAsyncClient":"Storage.File.Service","com.azure.storage.file.share.ServiceAsyncClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceAsyncClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceAsyncClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient":"Storage.File.Service","com.azure.storage.file.share.ServiceClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ShareAsyncClient":"Storage.File.Share","com.azure.storage.file.share.ShareAsyncClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareAsyncClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient":"Storage.File.Share","com.azure.storage.file.share.ShareClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType":"Storage.File.DeleteSnapshotsOptionType","com.azure.storage.file.share.implementation.models.DirectoryItem":"Storage.File.DirectoryItem","com.azure.storage.file.share.implementation.models.FileItem":"Storage.File.FileItem","com.azure.storage.file.share.implementation.models.FileProperty":"Storage.File.FileProperty","com.azure.storage.file.share.implementation.models.FilesAndDirectoriesListSegment":"Storage.File.FilesAndDirectoriesListSegment","com.azure.storage.file.share.implementation.models.HandleItem":"Storage.File.HandleItem","com.azure.storage.file.share.implementation.models.KeyInfo":"Storage.File.KeyInfo","com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse":"Storage.File.ListFilesAndDirectoriesSegmentResponse","com.azure.storage.file.share.implementation.models.ListFilesIncludeType":"Storage.File.ListFilesIncludeType","com.azure.storage.file.share.implementation.models.ListSharesIncludeType":"Storage.File.ListSharesIncludeType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteFromUrlType":"Storage.File.FileRangeWriteFromUrlType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType":"Storage.File.FileRangeWriteType","com.azure.storage.file.share.implementation.models.ShareItemInternal":"Storage.File.ShareItemInternal","com.azure.storage.file.share.implementation.models.SharePermission":"Storage.File.SharePermission","com.azure.storage.file.share.implementation.models.SharePropertiesInternal":"Storage.File.SharePropertiesInternal","com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper":"Storage.File.SignedIdentifiers","com.azure.storage.file.share.implementation.models.ShareStats":"Storage.File.ShareStats","com.azure.storage.file.share.implementation.models.StringEncoded":"Storage.File.StringEncoded","com.azure.storage.file.share.models.ClearRange":"Storage.File.ClearRange","com.azure.storage.file.share.models.FileLastWrittenMode":"Storage.File.FileLastWrittenMode","com.azure.storage.file.share.models.FilePermissionFormat":"Storage.File.FilePermissionFormat","com.azure.storage.file.share.models.FilePropertySemantics":"Storage.File.FilePropertySemantics","com.azure.storage.file.share.models.FileRange":"Storage.File.FileRange","com.azure.storage.file.share.models.LeaseDurationType":"Storage.File.LeaseDurationType","com.azure.storage.file.share.models.LeaseStateType":"Storage.File.LeaseStateType","com.azure.storage.file.share.models.LeaseStatusType":"Storage.File.LeaseStatusType","com.azure.storage.file.share.models.ModeCopyMode":"Storage.File.ModeCopyMode","com.azure.storage.file.share.models.NfsFileType":"Storage.File.NfsFileType","com.azure.storage.file.share.models.OwnerCopyMode":"Storage.File.OwnerCopyMode","com.azure.storage.file.share.models.PermissionCopyModeType":"Storage.File.PermissionCopyModeType","com.azure.storage.file.share.models.ShareAccessPolicy":"Storage.File.AccessPolicy","com.azure.storage.file.share.models.ShareAccessTier":"Storage.File.ShareAccessTier","com.azure.storage.file.share.models.ShareCorsRule":"Storage.File.CorsRule","com.azure.storage.file.share.models.ShareFileHandleAccessRights":"Storage.File.AccessRight","com.azure.storage.file.share.models.ShareFileRangeList":"Storage.File.ShareFileRangeList","com.azure.storage.file.share.models.ShareMetrics":"Storage.File.Metrics","com.azure.storage.file.share.models.ShareNfsSettings":"Storage.File.ShareNfsSettings","com.azure.storage.file.share.models.ShareNfsSettingsEncryptionInTransit":"Storage.File.ShareNfsSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareProtocolSettings":"Storage.File.ShareProtocolSettings","com.azure.storage.file.share.models.ShareRetentionPolicy":"Storage.File.RetentionPolicy","com.azure.storage.file.share.models.ShareRootSquash":"Storage.File.ShareRootSquash","com.azure.storage.file.share.models.ShareServiceProperties":"Storage.File.StorageServiceProperties","com.azure.storage.file.share.models.ShareSignedIdentifier":"Storage.File.SignedIdentifier","com.azure.storage.file.share.models.ShareSmbSettings":"Storage.File.ShareSmbSettings","com.azure.storage.file.share.models.ShareSmbSettingsEncryptionInTransit":"Storage.File.ShareSmbSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareTokenIntent":"Storage.File.ShareTokenIntent","com.azure.storage.file.share.models.SmbMultichannel":"Storage.File.SmbMultichannel","com.azure.storage.file.share.models.UserDelegationKey":"Storage.File.UserDelegationKey"},"generatedFiles":["src/main/java/com/azure/storage/file/share/AzureFileStorageBuilder.java","src/main/java/com/azure/storage/file/share/DirectoryAsyncClient.java","src/main/java/com/azure/storage/file/share/DirectoryClient.java","src/main/java/com/azure/storage/file/share/FileAsyncClient.java","src/main/java/com/azure/storage/file/share/FileClient.java","src/main/java/com/azure/storage/file/share/FileServiceVersion.java","src/main/java/com/azure/storage/file/share/ServiceAsyncClient.java","src/main/java/com/azure/storage/file/share/ServiceClient.java","src/main/java/com/azure/storage/file/share/ShareAsyncClient.java","src/main/java/com/azure/storage/file/share/ShareClient.java","src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java","src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java","src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java","src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java","src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java","src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java","src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java","src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java","src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java","src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java","src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java","src/main/java/com/azure/storage/file/share/implementation/models/package-info.java","src/main/java/com/azure/storage/file/share/implementation/package-info.java","src/main/java/com/azure/storage/file/share/models/ClearRange.java","src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java","src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java","src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java","src/main/java/com/azure/storage/file/share/models/FileRange.java","src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java","src/main/java/com/azure/storage/file/share/models/LeaseStateType.java","src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java","src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java","src/main/java/com/azure/storage/file/share/models/NfsFileType.java","src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java","src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java","src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java","src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java","src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java","src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java","src/main/java/com/azure/storage/file/share/models/ShareMetrics.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java","src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java","src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java","src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java","src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java","src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java","src/main/java/com/azure/storage/file/share/models/package-info.java","src/main/java/com/azure/storage/file/share/package-info.java","src/main/java/module-info.java"]} \ No newline at end of file diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java index 74f8922fbf89..a401db9ffc1f 100644 --- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java +++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java @@ -2,19 +2,26 @@ // Licensed under the MIT License. import com.azure.autorest.customization.Customization; +import com.azure.autorest.customization.Editor; import com.azure.autorest.customization.LibraryCustomization; import com.azure.autorest.customization.PackageCustomization; import com.github.javaparser.ParseProblemException; import com.github.javaparser.StaticJavaParser; +import com.github.javaparser.ast.Modifier; import com.github.javaparser.ast.NodeList; +import com.github.javaparser.ast.body.BodyDeclaration; +import com.github.javaparser.ast.body.ConstructorDeclaration; import com.github.javaparser.ast.body.MethodDeclaration; import com.github.javaparser.ast.body.Parameter; +import com.github.javaparser.ast.body.VariableDeclarator; import com.github.javaparser.ast.stmt.BlockStmt; import com.github.javaparser.ast.stmt.CatchClause; import com.github.javaparser.ast.stmt.Statement; import com.github.javaparser.ast.stmt.TryStmt; import com.github.javaparser.ast.type.ClassOrInterfaceType; import com.github.javaparser.ast.type.Type; +import com.github.javaparser.javadoc.Javadoc; +import com.github.javaparser.javadoc.description.JavadocDescription; import org.slf4j.Logger; import java.util.Arrays; @@ -24,8 +31,55 @@ * Customization class for File Share Storage. */ public class ShareStorageCustomization extends Customization { + private static final String PKG_ROOT = "src/main/java/com/azure/storage/file/share/"; + + private static final String MODELS_PACKAGE = "com.azure.storage.file.share.models"; + + // Models that shipped as @Fluent (public no-arg ctor + setters) before the TypeSpec migration. With + // required-fields-as-ctor-args:true (which must stay true so new models keep required params on the ctor) these + // regenerate as @Immutable with a required-args ctor and no setters -- a breaking change. FluentModelRestorer + // restores the shipped fluent shape per-model. Expand this list from the RevApi "method removed" report. + private static final List FLUENT_MODELS_TO_RESTORE = Arrays.asList( + "FileRange", "ClearRange", "ShareCorsRule", "ShareFileRangeList", "ShareMetrics", "ShareRetentionPolicy", + "ShareSignedIdentifier", "UserDelegationKey"); + + // Generated convenience clients + builders emitted by typespec-java on top of the + // implementation/*Impl operation layer. The public surface is the hand-written Share*-prefixed + // clients, so delete the generated ones. + private static final List GENERATED_CLIENTS_TO_REMOVE = Arrays.asList( + "ServiceClient", "ServiceAsyncClient", + "DirectoryClient", "DirectoryAsyncClient", + "FileClient", "FileAsyncClient", + "ShareClient", "ShareAsyncClient", + // Main service-client public surface — the impl (AzureFileStorageImpl) is kept; only the + // public client/async-client/builder are removed. Both naming variants are listed because + // removeFile is a no-op when absent. + "FileClientBuilder", + "AzureFileStorageClient", "AzureFileStorageAsyncClient", "AzureFileStorageClientBuilder", + "AzureFileStorageBuilder"); + // NOTE: FileServiceVersion is NOT in this list. It is generated (via @clientApiVersions with the full historical + // version set), then RENAMED to ShareServiceVersion with the *Impl references retyped, in + // renameServiceVersionToShareServiceVersion (which also deletes the generated FileServiceVersion.java). + + // module-info.java and package-info.java are hand-authored: the module descriptor carries the + // full requires/exports/opens (incl. transitive com.azure.storage.common and the sas/options/ + // specialized exports), and the package-info files carry the public API Javadoc. typespec-java + // regenerates minimal versions that overwrite them (dropping com.azure.storage.common visibility); + // removeFile drops the generated copies during postprocessing so the hand-written files survive. + private static final List GENERATED_DESCRIPTOR_FILES_TO_REMOVE = Arrays.asList( + "src/main/java/module-info.java", + "src/main/java/com/azure/storage/file/share/package-info.java", + "src/main/java/com/azure/storage/file/share/models/package-info.java", + "src/main/java/com/azure/storage/file/share/implementation/package-info.java"); + @Override public void customize(LibraryCustomization customization, Logger logger) { + removeGeneratedConvenienceClients(customization, logger); + + renameServiceVersionToShareServiceVersion(customization, logger); + + restoreFluentModels(customization, logger); + customization.getClass("com.azure.storage.file.share.models", "ShareTokenIntent") .customizeAst(ast -> ast.getClassByName("ShareTokenIntent").ifPresent(clazz -> clazz.setJavadocComment( "The request intent specifies requests that are intended for backup/admin type operations, meaning " @@ -35,6 +89,189 @@ public void customize(LibraryCustomization customization, Logger logger) { updateImplToMapInternalException(customization.getPackage("com.azure.storage.file.share.implementation")); } + /** + * Deletes the generated convenience clients / builder / service version so the shipped public + * surface is limited to the hand-written Share*-prefixed clients. The generated + * {@code implementation/*Impl} operation layer is retained and continues to be wrapped by the + * hand-written clients. + * + * @param customization The library customization. + * @param logger The logger. + */ + private static void removeGeneratedConvenienceClients(LibraryCustomization customization, Logger logger) { + for (String className : GENERATED_CLIENTS_TO_REMOVE) { + String path = PKG_ROOT + className + ".java"; + customization.getRawEditor().removeFile(path); + logger.info("Removed generated client file: {}", path); + } + for (String path : GENERATED_DESCRIPTOR_FILES_TO_REMOVE) { + customization.getRawEditor().removeFile(path); + logger.info("Removed generated descriptor file (hand-written version preserved): {}", path); + } + } + + /** + * Renames the generated {@code FileServiceVersion} enum to {@code ShareServiceVersion} and retypes the + * {@code *Impl} references accordingly. typespec-java names the service-version enum {@code FileServiceVersion}; + * the {@code @clientApiVersions} augment in client.tsp populates it with the full historical version set. Its + * public shape ({@code implements ServiceVersion}, {@code getVersion()}, {@code getLatest()}, and the version + * constants) is identical to the shipped hand-written {@code ShareServiceVersion}, so overwriting + * {@code ShareServiceVersion.java} with the renamed generated content is not a breaking change and keeps the + * enum generated (single source of truth = client.tsp). + * + * @param customization The library customization. + * @param logger The logger. + */ + private static void renameServiceVersionToShareServiceVersion(LibraryCustomization customization, Logger logger) { + Editor editor = customization.getRawEditor(); + + // Rename the generated enum: write its (renamed) content over ShareServiceVersion.java, delete the original. + String generatedEnumPath = PKG_ROOT + "FileServiceVersion.java"; + String shareEnumPath = PKG_ROOT + "ShareServiceVersion.java"; + String enumContent = editor.getFileContent(generatedEnumPath); + if (enumContent != null) { + editor.replaceFile(shareEnumPath, enumContent.replace("FileServiceVersion", "ShareServiceVersion")); + editor.removeFile(generatedEnumPath); + logger.info("Renamed generated FileServiceVersion enum to ShareServiceVersion"); + } + + // Retype the FileServiceVersion references in the *Impl classes to the renamed ShareServiceVersion. + for (String impl : Arrays.asList("AzureFileStorageImpl", "DirectoriesImpl", "FilesImpl", "ServicesImpl", + "SharesImpl")) { + String path = PKG_ROOT + "implementation/" + impl + ".java"; + String content = editor.getFileContent(path); + if (content == null) { + continue; + } + String updated = content.replace("FileServiceVersion", "ShareServiceVersion"); + if (!updated.equals(content)) { + editor.replaceFile(path, updated); + logger.info("Retyped FileServiceVersion -> ShareServiceVersion in {}", path); + } + } + } + + /** + * Restores the "fluent" shape of models that shipped as {@code @Fluent} (public no-arg constructor + setters) + * before the TypeSpec migration. With {@code required-fields-as-ctor-args: true} (which must stay true so new + * models keep required parameters on their constructor) these regenerate as {@code @Immutable} with a + * required-args constructor and no setters -- a breaking change. Each named model is converted back purely via the + * JavaParser AST (no string replacement): {@code @Immutable} becomes {@code @Fluent}, {@code final} is removed from + * instance fields, a public no-arg constructor is added, and a public fluent setter is added for each field. The + * generated required-args constructor and {@code fromXml}/{@code fromJson} deserialization are left untouched. + * + * @param customization The library customization. + * @param logger The logger. + */ + private static void restoreFluentModels(LibraryCustomization customization, Logger logger) { + PackageCustomization models = customization.getPackage(MODELS_PACKAGE); + for (String modelName : FLUENT_MODELS_TO_RESTORE) { + restoreFluentModel(models, modelName, logger); + } + } + + private static void restoreFluentModel(PackageCustomization models, String modelName, Logger logger) { + models.getClass(modelName).customizeAst(ast -> { + ast.addImport("com.azure.core.annotation.Fluent"); + ast.addImport("com.azure.core.annotation.Generated"); + ast.getClassByName(modelName).ifPresent(clazz -> { + // @Immutable -> @Fluent + clazz.getAnnotationByName("Immutable").ifPresent(annotation -> annotation.remove()); + if (!clazz.isAnnotationPresent("Fluent")) { + clazz.addMarkerAnnotation("Fluent"); + } + + NodeList> members = clazz.getMembers(); + + // Ensure a public no-arg constructor exists, positioned as the first constructor (right after the + // fields) to match the shipped layout. Widen an existing private no-arg ctor in place, otherwise + // insert a new one ahead of the generated required-args constructor. + boolean hasNoArgConstructor = clazz.getConstructors().stream() + .anyMatch(ctor -> ctor.getParameters().isEmpty()); + if (hasNoArgConstructor) { + clazz.getConstructors().stream() + .filter(ctor -> ctor.getParameters().isEmpty()) + .forEach(ctor -> ctor.setModifiers(Modifier.Keyword.PUBLIC)); + } else { + ConstructorDeclaration noArgConstructor = new ConstructorDeclaration(); + noArgConstructor.setName(modelName); + noArgConstructor.setModifiers(Modifier.Keyword.PUBLIC); + noArgConstructor.setBody(StaticJavaParser.parseBlock("{}")); + noArgConstructor.addMarkerAnnotation("Generated"); + noArgConstructor.setJavadocComment(new Javadoc( + JavadocDescription.parseText("Creates an instance of " + modelName + " class."))); + int firstConstructorIndex = indexOfFirstConstructor(members); + if (firstConstructorIndex >= 0) { + members.add(firstConstructorIndex, noArgConstructor); + } else { + members.add(noArgConstructor); + } + } + + // Un-finalize instance fields and add a fluent setter immediately after each field's getter, so the + // getter/setter pairs sit together as they did in the shipped model. + clazz.getFields().stream() + .filter(field -> !field.isStatic()) + .forEach(field -> { + field.removeModifier(Modifier.Keyword.FINAL); + VariableDeclarator variable = field.getVariable(0); + String fieldName = variable.getNameAsString(); + String setterName + = "set" + Character.toUpperCase(fieldName.charAt(0)) + fieldName.substring(1); + if (!clazz.getMethodsByName(setterName).isEmpty()) { + return; + } + + MethodDeclaration setter = new MethodDeclaration(); + setter.setName(setterName); + setter.setModifiers(Modifier.Keyword.PUBLIC); + setter.setType(modelName); + setter.addParameter(variable.getTypeAsString(), fieldName); + setter.setBody(StaticJavaParser.parseBlock( + "{ this." + fieldName + " = " + fieldName + "; return this; }")); + setter.addMarkerAnnotation("Generated"); + setter.setJavadocComment(new Javadoc( + JavadocDescription.parseText("Set the " + fieldName + " property.")) + .addBlockTag("param", fieldName, "the " + fieldName + " value to set.") + .addBlockTag("return", "the " + modelName + " object itself.")); + + int getterIndex = indexOfGetter(members, fieldName); + if (getterIndex >= 0) { + members.add(getterIndex + 1, setter); + } else { + members.add(setter); + } + }); + }); + logger.info("Restored fluent shape for model: {}", modelName); + }); + } + + private static int indexOfFirstConstructor(NodeList> members) { + for (int i = 0; i < members.size(); i++) { + if (members.get(i) instanceof ConstructorDeclaration) { + return i; + } + } + return -1; + } + + private static int indexOfGetter(NodeList> members, String fieldName) { + String capitalized = Character.toUpperCase(fieldName.charAt(0)) + fieldName.substring(1); + String getterName = "get" + capitalized; + String booleanGetterName = "is" + capitalized; + for (int i = 0; i < members.size(); i++) { + BodyDeclaration member = members.get(i); + if (member instanceof MethodDeclaration) { + String name = ((MethodDeclaration) member).getNameAsString(); + if (name.equals(getterName) || name.equals(booleanGetterName)) { + return i; + } + } + } + return -1; + } + /** * Customizes the implementation classes that will perform calls to the service. The following logic is used: *

diff --git a/sdk/storage/azure-storage-file-share/tsp-location.yaml b/sdk/storage/azure-storage-file-share/tsp-location.yaml new file mode 100644 index 000000000000..1a710edd36c7 --- /dev/null +++ b/sdk/storage/azure-storage-file-share/tsp-location.yaml @@ -0,0 +1,4 @@ +directory: specification/storage/data-plane/FileStorage +commit: +repo: +additionalDirectories: From e5ffacc212eab7cd0ddfefa9efde48e5e21c7d5a Mon Sep 17 00:00:00 2001 From: Isabelle Date: Mon, 27 Jul 2026 09:50:15 -0700 Subject: [PATCH 02/13] checkpoint 2 - conv layer customization --- .../file/share/implementation/SharesImpl.java | 42 ++++++++ .../main/java/ShareStorageCustomization.java | 100 ++++++++++++++++++ 2 files changed, 142 insertions(+) diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java index 716d79980157..f7a22a0972e3 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java @@ -22,14 +22,17 @@ import com.azure.core.http.HttpHeaderName; import com.azure.core.http.rest.RequestOptions; import com.azure.core.http.rest.Response; +import com.azure.core.http.rest.ResponseBase; import com.azure.core.http.rest.RestProxy; import com.azure.core.util.BinaryData; import com.azure.core.util.Context; import com.azure.core.util.FluxUtil; import com.azure.storage.file.share.ShareServiceVersion; import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal; +import com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders; import com.azure.storage.file.share.implementation.util.ModelHelper; import com.azure.storage.file.share.models.ShareTokenIntent; +import java.util.Map; import reactor.core.publisher.Mono; /** @@ -1907,4 +1910,43 @@ public Response restoreWithResponse(RequestOptions requestOptions) { throw ModelHelper.mapToShareStorageException(internalException); } } + + public Mono> createSnapshotWithResponseAsync(String shareName, + Integer timeout, Map metadata, Context context) { + RequestOptions requestOptions = buildCreateSnapshotRequestOptions(timeout, metadata); + String url = this.client.getUrl() + "/" + shareName; + return service + .createSnapshot(url, this.client.getServiceVersion().getVersion(), this.client.getFileRequestIntent(), + requestOptions, context) + .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) + .map(response -> new ResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(), + response.getValue(), new SharesCreateSnapshotHeaders(response.getHeaders()))); + } + + public ResponseBase createSnapshotWithResponse(String shareName, Integer timeout, + Map metadata, Context context) { + RequestOptions requestOptions = buildCreateSnapshotRequestOptions(timeout, metadata); + String url = this.client.getUrl() + "/" + shareName; + try { + Response response = service.createSnapshotSync(url, this.client.getServiceVersion().getVersion(), + this.client.getFileRequestIntent(), requestOptions, context); + return new ResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(), + response.getValue(), new SharesCreateSnapshotHeaders(response.getHeaders())); + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + + private static RequestOptions buildCreateSnapshotRequestOptions(Integer timeout, Map metadata) { + RequestOptions requestOptions = new RequestOptions(); + if (timeout != null) { + requestOptions.addQueryParam("timeout", String.valueOf(timeout)); + } + if (metadata != null) { + for (Map.Entry entry : metadata.entrySet()) { + requestOptions.setHeader(HttpHeaderName.fromString("x-ms-meta-" + entry.getKey()), entry.getValue()); + } + } + return requestOptions; + } } diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java index a401db9ffc1f..2fbb5c56e6d5 100644 --- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java +++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java @@ -87,6 +87,10 @@ public void customize(LibraryCustomization customization, Logger logger) { + "required RBAC permission."))); updateImplToMapInternalException(customization.getPackage("com.azure.storage.file.share.implementation")); + + // Must run AFTER updateImplToMapInternalException so the typed wrappers added here are not walked + // (and double-wrapped) by that pass. Wrappers embed their own error mapping. + addTypedImplWrappers(customization, logger); } /** @@ -272,6 +276,102 @@ private static int indexOfGetter(NodeList> members, String fi return -1; } + /** + * Adds typed convenience overloads on the generated {@code *Impl} classes that mirror the shape emitted by the + * pre-migration swagger {@code generate-client-as-impl} code (typed parameters + {@code ResponseBase} + * return type). typespec-java only emits protocol methods + * ({@code xxxWithResponse[Async](RequestOptions) -> Response/BinaryData}) which discard typed + * response headers and drop the typed request parameters. The shipped hand-written {@code Share*} clients rely on + * the swagger-shaped signatures, so this method reinstates them per the TypeSpec team's interim guidance: + * "a manual mapping can be added from the implementation layer {@code Response} to + * {@code ResponseBase}." Each wrapper builds a {@link RequestOptions} from its + * typed parameters, calls the generated {@code service} proxy directly with a share-scoped URL, maps the raw + * response into a typed {@code ResponseBase} using the {@code *Headers} constructor that consumes the raw + * {@link com.azure.core.http.HttpHeaders}, and applies {@code ShareStorageExceptionInternal} error mapping. + *

+ * The {@code *Headers} classes in {@code implementation/models} are the pre-migration AutoRest-generated files + * that typespec-java does not yet emit; they are kept as-is (treated as hand-written) until the emitter grows an + * equivalent of the TypeScript emitter's {@code include-headers-in-response} option. + * + * @param customization The library customization. + * @param logger The logger. + */ + private static void addTypedImplWrappers(LibraryCustomization customization, Logger logger) { + // createSnapshot (SharesImpl) -- template implementation, extend to the remaining operations. + customization.getClass("com.azure.storage.file.share.implementation", "SharesImpl").customizeAst(ast -> { + // ResponseBase / SharesCreateSnapshotHeaders / Map are not present in the emitted file; the rest + // (RequestOptions, Response, HttpHeaderName, Context, Mono, ShareStorageExceptionInternal, ModelHelper) + // are already imported by typespec-java's emit + updateImplToMapInternalException. + ast.addImport("com.azure.core.http.rest.ResponseBase"); + ast.addImport("com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders"); + ast.addImport("java.util.Map"); + + ast.getClassByName("SharesImpl").ifPresent(clazz -> { + addBodyDeclaration(clazz, + "public Mono>" + + " createSnapshotWithResponseAsync(String shareName, Integer timeout," + + " Map metadata, Context context) {\n" + + " RequestOptions requestOptions = buildCreateSnapshotRequestOptions(timeout, metadata);\n" + + " String url = this.client.getUrl() + \"/\" + shareName;\n" + + " return service.createSnapshot(url, this.client.getServiceVersion().getVersion(),\n" + + " this.client.getFileRequestIntent(), requestOptions, context)\n" + + " .onErrorMap(ShareStorageExceptionInternal.class," + + " ModelHelper::mapToShareStorageException)\n" + + " .map(response -> new ResponseBase<>(response.getRequest()," + + " response.getStatusCode(),\n" + + " response.getHeaders(), response.getValue(),\n" + + " new SharesCreateSnapshotHeaders(response.getHeaders())));\n" + + "}\n"); + + addBodyDeclaration(clazz, + "public ResponseBase" + + " createSnapshotWithResponse(String shareName, Integer timeout," + + " Map metadata, Context context) {\n" + + " RequestOptions requestOptions = buildCreateSnapshotRequestOptions(timeout, metadata);\n" + + " String url = this.client.getUrl() + \"/\" + shareName;\n" + + " try {\n" + + " Response response = service.createSnapshotSync(url," + + " this.client.getServiceVersion().getVersion(),\n" + + " this.client.getFileRequestIntent(), requestOptions, context);\n" + + " return new ResponseBase<>(response.getRequest(), response.getStatusCode(),\n" + + " response.getHeaders(), response.getValue(),\n" + + " new SharesCreateSnapshotHeaders(response.getHeaders()));\n" + + " } catch (ShareStorageExceptionInternal internalException) {\n" + + " throw ModelHelper.mapToShareStorageException(internalException);\n" + + " }\n" + + "}\n"); + + // Shared RequestOptions builder for both overloads. Kept private + static so it does not extend the + // impl's public surface. timeout -> ?timeout=N query param; metadata -> x-ms-meta- headers. + addBodyDeclaration(clazz, + "private static RequestOptions buildCreateSnapshotRequestOptions(" + + "Integer timeout, Map metadata) {\n" + + " RequestOptions requestOptions = new RequestOptions();\n" + + " if (timeout != null) {\n" + + " requestOptions.addQueryParam(\"timeout\", String.valueOf(timeout));\n" + + " }\n" + + " if (metadata != null) {\n" + + " for (Map.Entry entry : metadata.entrySet()) {\n" + + " requestOptions.setHeader(" + + "HttpHeaderName.fromString(\"x-ms-meta-\" + entry.getKey()),\n" + + " entry.getValue());\n" + + " }\n" + + " }\n" + + " return requestOptions;\n" + + "}\n"); + }); + logger.info("Added typed createSnapshot wrappers to SharesImpl"); + }); + } + + /** + * Parses {@code source} as a body declaration (method/constructor/field) and appends it to {@code clazz}. + */ + private static void addBodyDeclaration(com.github.javaparser.ast.body.ClassOrInterfaceDeclaration clazz, + String source) { + clazz.addMember(StaticJavaParser.parseBodyDeclaration(source)); + } + /** * Customizes the implementation classes that will perform calls to the service. The following logic is used: *

From dc99c1abfff77407fcbe9a3a54b3f8efec809923 Mon Sep 17 00:00:00 2001 From: Isabelle Date: Mon, 10 Aug 2026 11:05:16 -0700 Subject: [PATCH 03/13] swapping to handwritten seriveversion --- .../file/share/ShareServiceVersion.java | 2 +- .../implementation/AzureFileStorageImpl.java | 12 +- .../share/implementation/DirectoriesImpl.java | 110 ++++- .../file/share/implementation/FilesImpl.java | 393 +++++++++++++++++- .../share/implementation/ServicesImpl.java | 110 ++++- .../file/share/implementation/SharesImpl.java | 4 +- .../file/share/models/NfsFileType.java | 6 +- .../file/share/models/ShareFileRangeList.java | 31 -- .../file/share/models/ShareNfsSettings.java | 2 +- .../azure-storage-file-share_metadata.json | 2 +- .../main/java/ShareStorageCustomization.java | 59 +-- 11 files changed, 591 insertions(+), 140 deletions(-) diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceVersion.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceVersion.java index f6d2047c25ef..a31427b5a053 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceVersion.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceVersion.java @@ -186,7 +186,7 @@ public String getVersion() { /** * Gets the latest service version supported by this client library. - * + * * @return The latest {@link ShareServiceVersion}. */ public static ShareServiceVersion getLatest() { diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java index 076c00869967..198e6cdb2e76 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java @@ -10,7 +10,7 @@ import com.azure.core.http.policy.UserAgentPolicy; import com.azure.core.util.serializer.JacksonAdapter; import com.azure.core.util.serializer.SerializerAdapter; -import com.azure.storage.file.share.ShareServiceVersion; +import com.azure.storage.file.share.FileServiceVersion; import com.azure.storage.file.share.models.ShareTokenIntent; /** @@ -76,14 +76,14 @@ public boolean isAllowSourceTrailingDot() { /** * Service version. */ - private final ShareServiceVersion serviceVersion; + private final FileServiceVersion serviceVersion; /** * Gets Service version. * * @return the serviceVersion value. */ - public ShareServiceVersion getServiceVersion() { + public FileServiceVersion getServiceVersion() { return this.serviceVersion; } @@ -181,7 +181,7 @@ public SharesImpl getShares() { * @param serviceVersion Service version. */ public AzureFileStorageImpl(String url, ShareTokenIntent fileRequestIntent, boolean allowTrailingDot, - boolean allowSourceTrailingDot, ShareServiceVersion serviceVersion) { + boolean allowSourceTrailingDot, FileServiceVersion serviceVersion) { this(new HttpPipelineBuilder().policies(new UserAgentPolicy(), new RetryPolicy()).build(), JacksonAdapter.createDefaultSerializerAdapter(), url, fileRequestIntent, allowTrailingDot, allowSourceTrailingDot, serviceVersion); @@ -198,7 +198,7 @@ public AzureFileStorageImpl(String url, ShareTokenIntent fileRequestIntent, bool * @param serviceVersion Service version. */ public AzureFileStorageImpl(HttpPipeline httpPipeline, String url, ShareTokenIntent fileRequestIntent, - boolean allowTrailingDot, boolean allowSourceTrailingDot, ShareServiceVersion serviceVersion) { + boolean allowTrailingDot, boolean allowSourceTrailingDot, FileServiceVersion serviceVersion) { this(httpPipeline, JacksonAdapter.createDefaultSerializerAdapter(), url, fileRequestIntent, allowTrailingDot, allowSourceTrailingDot, serviceVersion); } @@ -216,7 +216,7 @@ public AzureFileStorageImpl(HttpPipeline httpPipeline, String url, ShareTokenInt */ public AzureFileStorageImpl(HttpPipeline httpPipeline, SerializerAdapter serializerAdapter, String url, ShareTokenIntent fileRequestIntent, boolean allowTrailingDot, boolean allowSourceTrailingDot, - ShareServiceVersion serviceVersion) { + FileServiceVersion serviceVersion) { this.httpPipeline = httpPipeline; this.serializerAdapter = serializerAdapter; this.url = url; diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java index ea3905283eee..18dbd16d7103 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java @@ -28,7 +28,7 @@ import com.azure.core.util.BinaryData; import com.azure.core.util.Context; import com.azure.core.util.FluxUtil; -import com.azure.storage.file.share.ShareServiceVersion; +import com.azure.storage.file.share.FileServiceVersion; import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal; import com.azure.storage.file.share.implementation.util.ModelHelper; import com.azure.storage.file.share.models.ShareTokenIntent; @@ -68,7 +68,7 @@ public final class DirectoriesImpl { * * @return the serviceVersion value. */ - public ShareServiceVersion getServiceVersion() { + public FileServiceVersion getServiceVersion() { try { return client.getServiceVersion(); } catch (ShareStorageExceptionInternal internalException) { @@ -957,7 +957,15 @@ private Mono> listHandlesSinglePageAsync(RequestOption this.client.getFileRequestIntent(), accept, requestOptions, context)) .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException) .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - getValues(res.getValue(), "Entries"), null, null)); + getXmlValues(res.getValue(), reader -> { + try { + return BinaryData.fromObject( + com.azure.storage.file.share.implementation.models.HandleItem.fromXml(reader, "Handle"), + XML_SERIALIZER); + } catch (javax.xml.stream.XMLStreamException e) { + throw new IllegalStateException(e); + } + }, "Entries", "Handle"), null, null)); } /** @@ -1079,7 +1087,15 @@ private PagedResponse listHandlesSinglePage(RequestOptions requestOp this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE); return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(), - getValues(res.getValue(), "Entries"), null, null); + getXmlValues(res.getValue(), reader -> { + try { + return BinaryData.fromObject( + com.azure.storage.file.share.implementation.models.HandleItem.fromXml(reader, "Handle"), + XML_SERIALIZER); + } catch (javax.xml.stream.XMLStreamException e) { + throw new IllegalStateException(e); + } + }, "Entries", "Handle"), null, null); } catch (ShareStorageExceptionInternal internalException) { throw ModelHelper.mapToShareStorageException(internalException); } @@ -1333,11 +1349,14 @@ public Response renameWithResponse(String renameSource, RequestOptions req } } - private List getValues(BinaryData binaryData, String path) { + private List getValues(BinaryData binaryData, String... path) { try { try { - Map obj = binaryData.toObject(Map.class); - List values = (List) obj.get(path); + Object value = binaryData.toObject(Map.class); + for (String segment : path) { + value = ((Map) value).get(segment); + } + List values = (List) value; return values.stream().map(BinaryData::fromObject).collect(Collectors.toList()); } catch (RuntimeException e) { return null; @@ -1347,11 +1366,14 @@ private List getValues(BinaryData binaryData, String path) { } } - private String getNextLink(BinaryData binaryData, String path) { + private String getNextLink(BinaryData binaryData, String... path) { try { try { - Map obj = binaryData.toObject(Map.class); - return (String) obj.get(path); + Object value = binaryData.toObject(Map.class); + for (String segment : path) { + value = ((Map) value).get(segment); + } + return (String) value; } catch (RuntimeException e) { return null; } @@ -1359,4 +1381,72 @@ private String getNextLink(BinaryData binaryData, String path) { throw ModelHelper.mapToShareStorageException(internalException); } } + + private static final com.azure.core.util.serializer.ObjectSerializer XML_SERIALIZER + = XmlSerializerProviders.createInstance(); + + private List getXmlValues(BinaryData binaryData, + java.util.function.Function valueReader, String... path) { + try { + try (com.azure.xml.XmlReader reader = com.azure.xml.XmlReader.fromStream(binaryData.toStream())) { + reader.nextElement(); + return getXmlValues(reader, valueReader, path, 0); + } catch (javax.xml.stream.XMLStreamException e) { + throw new IllegalStateException("Failed to read XML pageable response.", e); + } + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + + private List getXmlValues(com.azure.xml.XmlReader reader, + java.util.function.Function valueReader, String[] path, int pathIndex) + throws javax.xml.stream.XMLStreamException { + try { + List values = new java.util.ArrayList<>(); + while (reader.nextElement() != com.azure.xml.XmlToken.END_ELEMENT) { + if (!reader.elementNameMatches(path[pathIndex])) { + reader.skipElement(); + } else if (pathIndex == path.length - 1) { + values.add(valueReader.apply(reader)); + } else { + values.addAll(getXmlValues(reader, valueReader, path, pathIndex + 1)); + } + } + return values; + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + + private String getXmlNextLink(BinaryData binaryData, String... path) { + try { + try (com.azure.xml.XmlReader reader = com.azure.xml.XmlReader.fromStream(binaryData.toStream())) { + reader.nextElement(); + return getXmlNextLink(reader, path, 0); + } catch (javax.xml.stream.XMLStreamException e) { + throw new IllegalStateException("Failed to read XML pageable response.", e); + } + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } + + private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int pathIndex) + throws javax.xml.stream.XMLStreamException { + try { + while (reader.nextElement() != com.azure.xml.XmlToken.END_ELEMENT) { + if (!reader.elementNameMatches(path[pathIndex])) { + reader.skipElement(); + } else if (pathIndex == path.length - 1) { + return reader.getStringElement(); + } else { + return getXmlNextLink(reader, path, pathIndex + 1); + } + } + return null; + } catch (ShareStorageExceptionInternal internalException) { + throw ModelHelper.mapToShareStorageException(internalException); + } + } } diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java index 728fdba28e62..02fede0b8c72 100644 --- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java +++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java @@ -31,7 +31,7 @@ import com.azure.core.util.BinaryData; import com.azure.core.util.Context; import com.azure.core.util.FluxUtil; -import com.azure.storage.file.share.ShareServiceVersion; +import com.azure.storage.file.share.FileServiceVersion; import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal; import com.azure.storage.file.share.implementation.util.ModelHelper; import com.azure.storage.file.share.models.ShareTokenIntent; @@ -70,7 +70,7 @@ public final class FilesImpl { * * @return the serviceVersion value. */ - public ShareServiceVersion getServiceVersion() { + public FileServiceVersion getServiceVersion() { try { return client.getServiceVersion(); } catch (ShareStorageExceptionInternal internalException) { @@ -398,6 +398,30 @@ Response getRangeListSync(@HostParam("url") String url, @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); + @Get("?comp=rangelist") + @ExpectedResponses({ 200 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Mono> listAllRanges(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); + + @Get("?comp=rangelist") + @ExpectedResponses({ 200 }) + @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) + @UnexpectedResponseExceptionType(value = ResourceNotFoundException.class, code = { 404 }) + @UnexpectedResponseExceptionType(value = ResourceModifiedException.class, code = { 409 }) + @UnexpectedResponseExceptionType(HttpResponseException.class) + Response listAllRangesSync(@HostParam("url") String url, + @HeaderParam("x-ms-version") String xMsVersion, + @HeaderParam("x-ms-allow-trailing-dot") Boolean allowTrailingDot, + @HeaderParam("x-ms-file-request-intent") ShareTokenIntent fileRequestIntent, + @HeaderParam("Accept") String accept, RequestOptions requestOptions, Context context); + @Put("/") @ExpectedResponses({ 202 }) @UnexpectedResponseExceptionType(value = ClientAuthenticationException.class, code = { 401 }) @@ -661,7 +685,7 @@ Response createHardLinkSync(@HostParam("url") String url, @HeaderParam("x- * * You can add these to a request with {@link RequestOptions#addHeader} *

Request Body Schema

- * + * * 
      * {@code
      * BinaryData
@@ -764,7 +788,7 @@ public Mono> createWithResponseAsync(long fileContentLength, Requ
      * 
      * You can add these to a request with {@link RequestOptions#addHeader}
      * 
Request Body Schema

-     *
+     * 
      * 
      * {@code
      * BinaryData
@@ -822,7 +846,7 @@ public Response createWithResponse(long fileContentLength, RequestOptions
      * 
      * You can add these to a request with {@link RequestOptions#addHeader}
      * 
Response Body Schema

-     *
+     * 
      * 
      * {@code
      * BinaryData
@@ -869,7 +893,7 @@ public Mono> downloadWithResponseAsync(RequestOptions reque
      * 
      * You can add these to a request with {@link RequestOptions#addHeader}
      * 
Response Body Schema

-     *
+     * 
      * 
      * {@code
      * BinaryData
@@ -1567,7 +1591,7 @@ public Response breakLeaseWithResponse(RequestOptions requestOptions) {
      * 
      * You can add these to a request with {@link RequestOptions#addHeader}
      * 
Request Body Schema

-     *
+     * 
      * 
      * {@code
      * BinaryData
@@ -1631,7 +1655,7 @@ public Mono> uploadRangeWithResponseAsync(String range, String fi
      * 
      * You can add these to a request with {@link RequestOptions#addHeader}
      * 
Request Body Schema

-     *
+     * 
      * 
      * {@code
      * BinaryData
@@ -1801,7 +1825,7 @@ public Response uploadRangeFromUrlWithResponse(String range, String copySo
      * 
      * You can add these to a request with {@link RequestOptions#addHeader}
      * 
Response Body Schema

-     *
+     * 
      * 
      * {@code
      * {
@@ -1864,7 +1888,7 @@ public Mono> getRangeListWithResponseAsync(RequestOptions r
      * 
      * You can add these to a request with {@link RequestOptions#addHeader}
      * 
Response Body Schema

-     *
+     * 
      * 
      * {@code
      * {
@@ -1903,6 +1927,241 @@ public Response getRangeListWithResponse(RequestOptions requestOptio
         }
     }
 
+    /**
+     * Returns a paginated list of valid page ranges for a file or snapshot of a file.
+     * 
Query Parameters

+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that
+     * specifies a share snapshot.
prevsharesnapshotStringNoThe previous snapshot parameter is an opaque DateTime
+     * value that specifies a previous file snapshot to compare against.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
markerStringNoA string value that identifies the portion of the list to be
+     * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.

+     * You can add these to a request with {@link RequestOptions#addQueryParam}
+     * 
Header Parameters

+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
Header Parameters
NameTypeRequiredDescription
RangeStringNoReturn file data only from the specified byte range.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the
+     * file.
x-ms-file-support-renameBooleanNoThis header is allowed only when
+     * PrevShareSnapshot query parameter is set. Determines whether the changed ranges for a file that has been renamed
+     * or moved should be listed.

+     * You can add these to a request with {@link RequestOptions#addHeader}
+     * 
Response Body Schema

+     * 
+     * 
+     * {@code
+     * {
+     *     Start: long (Required)
+     *     End: long (Required)
+     * }
+     * }
+     * 

+     *
+     * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+     * @throws HttpResponseException thrown if the request is rejected by server.
+     * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+     * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+     * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+     * @return the paginated list of file ranges along with {@link PagedResponse} on successful completion of
+     * {@link Mono}.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    private Mono> listAllRangesSinglePageAsync(RequestOptions requestOptions) {
+        final String accept = "application/xml";
+        return FluxUtil
+            .withContext(context -> service.listAllRanges(this.client.getUrl(),
+                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
+                this.client.getFileRequestIntent(), accept, requestOptions, context))
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
+            .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(),
+                getXmlValues(res.getValue(), reader -> {
+                    try {
+                        return BinaryData.fromObject(
+                            com.azure.storage.file.share.models.FileRange.fromXml(reader, "Range"), XML_SERIALIZER);
+                    } catch (javax.xml.stream.XMLStreamException e) {
+                        throw new IllegalStateException(e);
+                    }
+                }, "Range", "Range"), null, null));
+    }
+
+    /**
+     * Returns a paginated list of valid page ranges for a file or snapshot of a file.
+     * 
Query Parameters

+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that
+     * specifies a share snapshot.
prevsharesnapshotStringNoThe previous snapshot parameter is an opaque DateTime
+     * value that specifies a previous file snapshot to compare against.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
markerStringNoA string value that identifies the portion of the list to be
+     * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.

+     * You can add these to a request with {@link RequestOptions#addQueryParam}
+     * 
Header Parameters

+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
Header Parameters
NameTypeRequiredDescription
RangeStringNoReturn file data only from the specified byte range.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the
+     * file.
x-ms-file-support-renameBooleanNoThis header is allowed only when
+     * PrevShareSnapshot query parameter is set. Determines whether the changed ranges for a file that has been renamed
+     * or moved should be listed.

+     * You can add these to a request with {@link RequestOptions#addHeader}
+     * 
Response Body Schema

+     * 
+     * 
+     * {@code
+     * {
+     *     Start: long (Required)
+     *     End: long (Required)
+     * }
+     * }
+     * 

+     *
+     * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+     * @throws HttpResponseException thrown if the request is rejected by server.
+     * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+     * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+     * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+     * @return the paginated list of file ranges as paginated response with {@link PagedFlux}.
+     */
+    @ServiceMethod(returns = ReturnType.COLLECTION)
+    public PagedFlux listAllRangesAsync(RequestOptions requestOptions) {
+        return new PagedFlux<>(() -> listAllRangesSinglePageAsync(requestOptions));
+    }
+
+    /**
+     * Returns a paginated list of valid page ranges for a file or snapshot of a file.
+     * 
Query Parameters

+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that
+     * specifies a share snapshot.
prevsharesnapshotStringNoThe previous snapshot parameter is an opaque DateTime
+     * value that specifies a previous file snapshot to compare against.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
markerStringNoA string value that identifies the portion of the list to be
+     * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.

+     * You can add these to a request with {@link RequestOptions#addQueryParam}
+     * 
Header Parameters

+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
Header Parameters
NameTypeRequiredDescription
RangeStringNoReturn file data only from the specified byte range.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the
+     * file.
x-ms-file-support-renameBooleanNoThis header is allowed only when
+     * PrevShareSnapshot query parameter is set. Determines whether the changed ranges for a file that has been renamed
+     * or moved should be listed.

+     * You can add these to a request with {@link RequestOptions#addHeader}
+     * 
Response Body Schema

+     * 
+     * 
+     * {@code
+     * {
+     *     Start: long (Required)
+     *     End: long (Required)
+     * }
+     * }
+     * 

+     *
+     * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+     * @throws HttpResponseException thrown if the request is rejected by server.
+     * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+     * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+     * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+     * @return the paginated list of file ranges along with {@link PagedResponse}.
+     */
+    @ServiceMethod(returns = ReturnType.SINGLE)
+    private PagedResponse listAllRangesSinglePage(RequestOptions requestOptions) {
+        try {
+            final String accept = "application/xml";
+            Response res = service.listAllRangesSync(this.client.getUrl(),
+                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
+                this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
+            return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(),
+                getXmlValues(res.getValue(), reader -> {
+                    try {
+                        return BinaryData.fromObject(
+                            com.azure.storage.file.share.models.FileRange.fromXml(reader, "Range"), XML_SERIALIZER);
+                    } catch (javax.xml.stream.XMLStreamException e) {
+                        throw new IllegalStateException(e);
+                    }
+                }, "Range", "Range"), null, null);
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    /**
+     * Returns a paginated list of valid page ranges for a file or snapshot of a file.
+     * 
Query Parameters

+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
Query Parameters
NameTypeRequiredDescription
sharesnapshotStringNoThe snapshot parameter is an opaque DateTime value that
+     * specifies a share snapshot.
prevsharesnapshotStringNoThe previous snapshot parameter is an opaque DateTime
+     * value that specifies a previous file snapshot to compare against.
timeoutIntegerNoThe timeout parameter is expressed in seconds.
markerStringNoA string value that identifies the portion of the list to be
+     * returned with the next listing operation.
maxresultsIntegerNoSpecifies the maximum number of items to return.

+     * You can add these to a request with {@link RequestOptions#addQueryParam}
+     * 
Header Parameters

+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
+     * 
Header Parameters
NameTypeRequiredDescription
RangeStringNoReturn file data only from the specified byte range.
x-ms-lease-idStringNoIf specified, the lease ID must match the lease ID of the
+     * file.
x-ms-file-support-renameBooleanNoThis header is allowed only when
+     * PrevShareSnapshot query parameter is set. Determines whether the changed ranges for a file that has been renamed
+     * or moved should be listed.

+     * You can add these to a request with {@link RequestOptions#addHeader}
+     * 
Response Body Schema

+     * 
+     * 
+     * {@code
+     * {
+     *     Start: long (Required)
+     *     End: long (Required)
+     * }
+     * }
+     * 

+     *
+     * @param requestOptions The options to configure the HTTP request before HTTP client sends it.
+     * @throws HttpResponseException thrown if the request is rejected by server.
+     * @throws ClientAuthenticationException thrown if the request is rejected by server on status code 401.
+     * @throws ResourceNotFoundException thrown if the request is rejected by server on status code 404.
+     * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
+     * @return the paginated list of file ranges as paginated response with {@link PagedIterable}.
+     */
+    @ServiceMethod(returns = ReturnType.COLLECTION)
+    public PagedIterable listAllRanges(RequestOptions requestOptions) {
+        return new PagedIterable<>(() -> listAllRangesSinglePage(requestOptions));
+    }
+
     /**
      * Copies a blob or file to a destination file within the storage account.
      * 
Query Parameters

@@ -2120,7 +2379,7 @@ public Response abortCopyWithResponse(String copyid, RequestOptions reques
      * 
      * You can add these to a request with {@link RequestOptions#addQueryParam}
      * 
Response Body Schema

-     *
+     * 
      * 
      * {@code
      * {
@@ -2159,7 +2418,15 @@ private Mono> listHandlesSinglePageAsync(RequestOption
                 this.client.getFileRequestIntent(), accept, requestOptions, context))
             .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
             .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(),
-                getValues(res.getValue(), "Entries"), null, null));
+                getXmlValues(res.getValue(), reader -> {
+                    try {
+                        return BinaryData.fromObject(
+                            com.azure.storage.file.share.implementation.models.HandleItem.fromXml(reader, "Handle"),
+                            XML_SERIALIZER);
+                    } catch (javax.xml.stream.XMLStreamException e) {
+                        throw new IllegalStateException(e);
+                    }
+                }, "Entries", "Handle"), null, null));
     }
 
     /**
@@ -2177,7 +2444,7 @@ private Mono> listHandlesSinglePageAsync(RequestOption
      * 
      * You can add these to a request with {@link RequestOptions#addQueryParam}
      * 
Response Body Schema

-     *
+     * 
      * 
      * {@code
      * {
@@ -2227,7 +2494,7 @@ public PagedFlux listHandlesAsync(RequestOptions requestOptions) {
      * 
      * You can add these to a request with {@link RequestOptions#addQueryParam}
      * 
Response Body Schema

-     *
+     * 
      * 
      * {@code
      * {
@@ -2265,7 +2532,15 @@ private PagedResponse listHandlesSinglePage(RequestOptions requestOp
                 this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
                 this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
             return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(),
-                getValues(res.getValue(), "Entries"), null, null);
+                getXmlValues(res.getValue(), reader -> {
+                    try {
+                        return BinaryData.fromObject(
+                            com.azure.storage.file.share.implementation.models.HandleItem.fromXml(reader, "Handle"),
+                            XML_SERIALIZER);
+                    } catch (javax.xml.stream.XMLStreamException e) {
+                        throw new IllegalStateException(e);
+                    }
+                }, "Entries", "Handle"), null, null);
         } catch (ShareStorageExceptionInternal internalException) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
@@ -2286,7 +2561,7 @@ private PagedResponse listHandlesSinglePage(RequestOptions requestOp
      * 
      * You can add these to a request with {@link RequestOptions#addQueryParam}
      * 
Response Body Schema

-     *
+     * 
      * 
      * {@code
      * {
@@ -2714,11 +2989,14 @@ public Response createHardLinkWithResponse(String targetFile, RequestOptio
         }
     }
 
-    private List getValues(BinaryData binaryData, String path) {
+    private List getValues(BinaryData binaryData, String... path) {
         try {
             try {
-                Map obj = binaryData.toObject(Map.class);
-                List values = (List) obj.get(path);
+                Object value = binaryData.toObject(Map.class);
+                for (String segment : path) {
+                    value = ((Map) value).get(segment);
+                }
+                List values = (List) value;
                 return values.stream().map(BinaryData::fromObject).collect(Collectors.toList());
             } catch (RuntimeException e) {
                 return null;
@@ -2728,11 +3006,14 @@ private List getValues(BinaryData binaryData, String path) {
         }
     }
 
-    private String getNextLink(BinaryData binaryData, String path) {
+    private String getNextLink(BinaryData binaryData, String... path) {
         try {
             try {
-                Map obj = binaryData.toObject(Map.class);
-                return (String) obj.get(path);
+                Object value = binaryData.toObject(Map.class);
+                for (String segment : path) {
+                    value = ((Map) value).get(segment);
+                }
+                return (String) value;
             } catch (RuntimeException e) {
                 return null;
             }
@@ -2740,4 +3021,72 @@ private String getNextLink(BinaryData binaryData, String path) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
     }
+
+    private static final com.azure.core.util.serializer.ObjectSerializer XML_SERIALIZER
+        = XmlSerializerProviders.createInstance();
+
+    private List getXmlValues(BinaryData binaryData,
+        java.util.function.Function valueReader, String... path) {
+        try {
+            try (com.azure.xml.XmlReader reader = com.azure.xml.XmlReader.fromStream(binaryData.toStream())) {
+                reader.nextElement();
+                return getXmlValues(reader, valueReader, path, 0);
+            } catch (javax.xml.stream.XMLStreamException e) {
+                throw new IllegalStateException("Failed to read XML pageable response.", e);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    private List getXmlValues(com.azure.xml.XmlReader reader,
+        java.util.function.Function valueReader, String[] path, int pathIndex)
+        throws javax.xml.stream.XMLStreamException {
+        try {
+            List values = new java.util.ArrayList<>();
+            while (reader.nextElement() != com.azure.xml.XmlToken.END_ELEMENT) {
+                if (!reader.elementNameMatches(path[pathIndex])) {
+                    reader.skipElement();
+                } else if (pathIndex == path.length - 1) {
+                    values.add(valueReader.apply(reader));
+                } else {
+                    values.addAll(getXmlValues(reader, valueReader, path, pathIndex + 1));
+                }
+            }
+            return values;
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    private String getXmlNextLink(BinaryData binaryData, String... path) {
+        try {
+            try (com.azure.xml.XmlReader reader = com.azure.xml.XmlReader.fromStream(binaryData.toStream())) {
+                reader.nextElement();
+                return getXmlNextLink(reader, path, 0);
+            } catch (javax.xml.stream.XMLStreamException e) {
+                throw new IllegalStateException("Failed to read XML pageable response.", e);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int pathIndex)
+        throws javax.xml.stream.XMLStreamException {
+        try {
+            while (reader.nextElement() != com.azure.xml.XmlToken.END_ELEMENT) {
+                if (!reader.elementNameMatches(path[pathIndex])) {
+                    reader.skipElement();
+                } else if (pathIndex == path.length - 1) {
+                    return reader.getStringElement();
+                } else {
+                    return getXmlNextLink(reader, path, pathIndex + 1);
+                }
+            }
+            return null;
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
index 9fc092330722..b3286333cd98 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
@@ -29,7 +29,7 @@
 import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.FluxUtil;
-import com.azure.storage.file.share.ShareServiceVersion;
+import com.azure.storage.file.share.FileServiceVersion;
 import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
 import com.azure.storage.file.share.models.ShareTokenIntent;
@@ -68,7 +68,7 @@ public final class ServicesImpl {
      *
      * @return the serviceVersion value.
      */
-    public ShareServiceVersion getServiceVersion() {
+    public FileServiceVersion getServiceVersion() {
         try {
             return client.getServiceVersion();
         } catch (ShareStorageExceptionInternal internalException) {
@@ -542,7 +542,15 @@ private Mono> listSharesSegmentSinglePageAsync(Request
                     this.client.getFileRequestIntent(), accept, requestOptions, context))
             .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
             .map(res -> new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(),
-                getValues(res.getValue(), "Shares"), null, null));
+                getXmlValues(res.getValue(), reader -> {
+                    try {
+                        return BinaryData
+                            .fromObject(com.azure.storage.file.share.implementation.models.ShareItemInternal
+                                .fromXml(reader, "Share"), XML_SERIALIZER);
+                    } catch (javax.xml.stream.XMLStreamException e) {
+                        throw new IllegalStateException(e);
+                    }
+                }, "Shares", "Share"), null, null));
     }
 
     /**
@@ -694,7 +702,15 @@ private PagedResponse listSharesSegmentSinglePage(RequestOptions req
                 = service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
                     this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
             return new PagedResponseBase<>(res.getRequest(), res.getStatusCode(), res.getHeaders(),
-                getValues(res.getValue(), "Shares"), null, null);
+                getXmlValues(res.getValue(), reader -> {
+                    try {
+                        return BinaryData
+                            .fromObject(com.azure.storage.file.share.implementation.models.ShareItemInternal
+                                .fromXml(reader, "Share"), XML_SERIALIZER);
+                    } catch (javax.xml.stream.XMLStreamException e) {
+                        throw new IllegalStateException(e);
+                    }
+                }, "Shares", "Share"), null, null);
         } catch (ShareStorageExceptionInternal internalException) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
@@ -888,11 +904,14 @@ public Response getUserDelegationKeyWithResponse(BinaryData keyInfo,
         }
     }
 
-    private List getValues(BinaryData binaryData, String path) {
+    private List getValues(BinaryData binaryData, String... path) {
         try {
             try {
-                Map obj = binaryData.toObject(Map.class);
-                List values = (List) obj.get(path);
+                Object value = binaryData.toObject(Map.class);
+                for (String segment : path) {
+                    value = ((Map) value).get(segment);
+                }
+                List values = (List) value;
                 return values.stream().map(BinaryData::fromObject).collect(Collectors.toList());
             } catch (RuntimeException e) {
                 return null;
@@ -902,11 +921,14 @@ private List getValues(BinaryData binaryData, String path) {
         }
     }
 
-    private String getNextLink(BinaryData binaryData, String path) {
+    private String getNextLink(BinaryData binaryData, String... path) {
         try {
             try {
-                Map obj = binaryData.toObject(Map.class);
-                return (String) obj.get(path);
+                Object value = binaryData.toObject(Map.class);
+                for (String segment : path) {
+                    value = ((Map) value).get(segment);
+                }
+                return (String) value;
             } catch (RuntimeException e) {
                 return null;
             }
@@ -914,4 +936,72 @@ private String getNextLink(BinaryData binaryData, String path) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
     }
+
+    private static final com.azure.core.util.serializer.ObjectSerializer XML_SERIALIZER
+        = XmlSerializerProviders.createInstance();
+
+    private List getXmlValues(BinaryData binaryData,
+        java.util.function.Function valueReader, String... path) {
+        try {
+            try (com.azure.xml.XmlReader reader = com.azure.xml.XmlReader.fromStream(binaryData.toStream())) {
+                reader.nextElement();
+                return getXmlValues(reader, valueReader, path, 0);
+            } catch (javax.xml.stream.XMLStreamException e) {
+                throw new IllegalStateException("Failed to read XML pageable response.", e);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    private List getXmlValues(com.azure.xml.XmlReader reader,
+        java.util.function.Function valueReader, String[] path, int pathIndex)
+        throws javax.xml.stream.XMLStreamException {
+        try {
+            List values = new java.util.ArrayList<>();
+            while (reader.nextElement() != com.azure.xml.XmlToken.END_ELEMENT) {
+                if (!reader.elementNameMatches(path[pathIndex])) {
+                    reader.skipElement();
+                } else if (pathIndex == path.length - 1) {
+                    values.add(valueReader.apply(reader));
+                } else {
+                    values.addAll(getXmlValues(reader, valueReader, path, pathIndex + 1));
+                }
+            }
+            return values;
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    private String getXmlNextLink(BinaryData binaryData, String... path) {
+        try {
+            try (com.azure.xml.XmlReader reader = com.azure.xml.XmlReader.fromStream(binaryData.toStream())) {
+                reader.nextElement();
+                return getXmlNextLink(reader, path, 0);
+            } catch (javax.xml.stream.XMLStreamException e) {
+                throw new IllegalStateException("Failed to read XML pageable response.", e);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int pathIndex)
+        throws javax.xml.stream.XMLStreamException {
+        try {
+            while (reader.nextElement() != com.azure.xml.XmlToken.END_ELEMENT) {
+                if (!reader.elementNameMatches(path[pathIndex])) {
+                    reader.skipElement();
+                } else if (pathIndex == path.length - 1) {
+                    return reader.getStringElement();
+                } else {
+                    return getXmlNextLink(reader, path, pathIndex + 1);
+                }
+            }
+            return null;
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java
index f7a22a0972e3..a40357bdbde3 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java
@@ -27,7 +27,7 @@
 import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.FluxUtil;
-import com.azure.storage.file.share.ShareServiceVersion;
+import com.azure.storage.file.share.FileServiceVersion;
 import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal;
 import com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
@@ -65,7 +65,7 @@ public final class SharesImpl {
      *
      * @return the serviceVersion value.
      */
-    public ShareServiceVersion getServiceVersion() {
+    public FileServiceVersion getServiceVersion() {
         try {
             return client.getServiceVersion();
         } catch (ShareStorageExceptionInternal internalException) {
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/NfsFileType.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/NfsFileType.java
index b5f73bdb3a8e..dc2f39d7b581 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/NfsFileType.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/NfsFileType.java
@@ -32,7 +32,7 @@ public final class NfsFileType extends ExpandableStringEnum {
 
     /**
      * Creates a new instance of NfsFileType value.
-     *
+     * 
      * @deprecated Use the {@link #fromString(String)} factory method.
      */
     @Generated
@@ -42,7 +42,7 @@ public NfsFileType() {
 
     /**
      * Creates or finds a NfsFileType from its string representation.
-     *
+     * 
      * @param name a name to look for.
      * @return the corresponding NfsFileType.
      */
@@ -53,7 +53,7 @@ public static NfsFileType fromString(String name) {
 
     /**
      * Gets known NfsFileType values.
-     *
+     * 
      * @return known NfsFileType values.
      */
     @Generated
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java
index 53e62eb3dacc..0d0443808903 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java
@@ -32,12 +32,6 @@ public final class ShareFileRangeList implements XmlSerializable clearRanges = new ArrayList<>();
 
-    /*
-     * The NextMarker property.
-     */
-    @Generated
-    private String nextMarker;
-
     /**
      * Creates an instance of ShareFileRangeList class.
      */
@@ -89,28 +83,6 @@ public ShareFileRangeList setClearRanges(List clearRanges) {
         return this;
     }
 
-    /**
-     * Get the nextMarker property: The NextMarker property.
-     * 
-     * @return the nextMarker value.
-     */
-    @Generated
-    public String getNextMarker() {
-        return this.nextMarker;
-    }
-
-    /**
-     * Set the nextMarker property: The NextMarker property.
-     * 
-     * @param nextMarker the nextMarker value to set.
-     * @return the ShareFileRangeList object itself.
-     */
-    @Generated
-    public ShareFileRangeList setNextMarker(String nextMarker) {
-        this.nextMarker = nextMarker;
-        return this;
-    }
-
     @Generated
     @Override
     public XmlWriter toXml(XmlWriter xmlWriter) throws XMLStreamException {
@@ -132,7 +104,6 @@ public XmlWriter toXml(XmlWriter xmlWriter, String rootElementName) throws XMLSt
                 xmlWriter.writeXml(element, "ClearRange");
             }
         }
-        xmlWriter.writeStringElement("NextMarker", this.nextMarker);
         return xmlWriter.writeEndElement();
     }
 
@@ -170,8 +141,6 @@ public static ShareFileRangeList fromXml(XmlReader xmlReader, String rootElement
                     deserializedShareFileRangeList.ranges.add(FileRange.fromXml(reader, "Range"));
                 } else if ("ClearRange".equals(elementName.getLocalPart())) {
                     deserializedShareFileRangeList.clearRanges.add(ClearRange.fromXml(reader, "ClearRange"));
-                } else if ("NextMarker".equals(elementName.getLocalPart())) {
-                    deserializedShareFileRangeList.nextMarker = reader.getStringElement();
                 } else {
                     reader.skipElement();
                 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java
index 6a1eb8bc98ea..6b02de8d7607 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java
@@ -14,7 +14,7 @@
 import javax.xml.stream.XMLStreamException;
 
 /**
- * Settings for SMB protocol.
+ * Settings for NFS protocol.
  */
 @Fluent
 public final class ShareNfsSettings implements XmlSerializable {
diff --git a/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json b/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
index 3abfaf07889f..0e919fe66ef0 100644
--- a/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
+++ b/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
@@ -1 +1 @@
-{"flavor":"azure","apiVersions":{"Storage.File":"2026-06-06"},"crossLanguagePackageId":"Storage.File","crossLanguageVersion":"741c448defd6","crossLanguageDefinitions":{"com.azure.storage.file.share.AzureFileStorageBuilder":"Storage.File","com.azure.storage.file.share.DirectoryAsyncClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryAsyncClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryAsyncClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryAsyncClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.FileAsyncClient":"Storage.File.File","com.azure.storage.file.share.FileAsyncClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileAsyncClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient":"Storage.File.File","com.azure.storage.file.share.FileClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.ServiceAsyncClient":"Storage.File.Service","com.azure.storage.file.share.ServiceAsyncClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceAsyncClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceAsyncClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient":"Storage.File.Service","com.azure.storage.file.share.ServiceClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ShareAsyncClient":"Storage.File.Share","com.azure.storage.file.share.ShareAsyncClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareAsyncClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient":"Storage.File.Share","com.azure.storage.file.share.ShareClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType":"Storage.File.DeleteSnapshotsOptionType","com.azure.storage.file.share.implementation.models.DirectoryItem":"Storage.File.DirectoryItem","com.azure.storage.file.share.implementation.models.FileItem":"Storage.File.FileItem","com.azure.storage.file.share.implementation.models.FileProperty":"Storage.File.FileProperty","com.azure.storage.file.share.implementation.models.FilesAndDirectoriesListSegment":"Storage.File.FilesAndDirectoriesListSegment","com.azure.storage.file.share.implementation.models.HandleItem":"Storage.File.HandleItem","com.azure.storage.file.share.implementation.models.KeyInfo":"Storage.File.KeyInfo","com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse":"Storage.File.ListFilesAndDirectoriesSegmentResponse","com.azure.storage.file.share.implementation.models.ListFilesIncludeType":"Storage.File.ListFilesIncludeType","com.azure.storage.file.share.implementation.models.ListSharesIncludeType":"Storage.File.ListSharesIncludeType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteFromUrlType":"Storage.File.FileRangeWriteFromUrlType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType":"Storage.File.FileRangeWriteType","com.azure.storage.file.share.implementation.models.ShareItemInternal":"Storage.File.ShareItemInternal","com.azure.storage.file.share.implementation.models.SharePermission":"Storage.File.SharePermission","com.azure.storage.file.share.implementation.models.SharePropertiesInternal":"Storage.File.SharePropertiesInternal","com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper":"Storage.File.SignedIdentifiers","com.azure.storage.file.share.implementation.models.ShareStats":"Storage.File.ShareStats","com.azure.storage.file.share.implementation.models.StringEncoded":"Storage.File.StringEncoded","com.azure.storage.file.share.models.ClearRange":"Storage.File.ClearRange","com.azure.storage.file.share.models.FileLastWrittenMode":"Storage.File.FileLastWrittenMode","com.azure.storage.file.share.models.FilePermissionFormat":"Storage.File.FilePermissionFormat","com.azure.storage.file.share.models.FilePropertySemantics":"Storage.File.FilePropertySemantics","com.azure.storage.file.share.models.FileRange":"Storage.File.FileRange","com.azure.storage.file.share.models.LeaseDurationType":"Storage.File.LeaseDurationType","com.azure.storage.file.share.models.LeaseStateType":"Storage.File.LeaseStateType","com.azure.storage.file.share.models.LeaseStatusType":"Storage.File.LeaseStatusType","com.azure.storage.file.share.models.ModeCopyMode":"Storage.File.ModeCopyMode","com.azure.storage.file.share.models.NfsFileType":"Storage.File.NfsFileType","com.azure.storage.file.share.models.OwnerCopyMode":"Storage.File.OwnerCopyMode","com.azure.storage.file.share.models.PermissionCopyModeType":"Storage.File.PermissionCopyModeType","com.azure.storage.file.share.models.ShareAccessPolicy":"Storage.File.AccessPolicy","com.azure.storage.file.share.models.ShareAccessTier":"Storage.File.ShareAccessTier","com.azure.storage.file.share.models.ShareCorsRule":"Storage.File.CorsRule","com.azure.storage.file.share.models.ShareFileHandleAccessRights":"Storage.File.AccessRight","com.azure.storage.file.share.models.ShareFileRangeList":"Storage.File.ShareFileRangeList","com.azure.storage.file.share.models.ShareMetrics":"Storage.File.Metrics","com.azure.storage.file.share.models.ShareNfsSettings":"Storage.File.ShareNfsSettings","com.azure.storage.file.share.models.ShareNfsSettingsEncryptionInTransit":"Storage.File.ShareNfsSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareProtocolSettings":"Storage.File.ShareProtocolSettings","com.azure.storage.file.share.models.ShareRetentionPolicy":"Storage.File.RetentionPolicy","com.azure.storage.file.share.models.ShareRootSquash":"Storage.File.ShareRootSquash","com.azure.storage.file.share.models.ShareServiceProperties":"Storage.File.StorageServiceProperties","com.azure.storage.file.share.models.ShareSignedIdentifier":"Storage.File.SignedIdentifier","com.azure.storage.file.share.models.ShareSmbSettings":"Storage.File.ShareSmbSettings","com.azure.storage.file.share.models.ShareSmbSettingsEncryptionInTransit":"Storage.File.ShareSmbSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareTokenIntent":"Storage.File.ShareTokenIntent","com.azure.storage.file.share.models.SmbMultichannel":"Storage.File.SmbMultichannel","com.azure.storage.file.share.models.UserDelegationKey":"Storage.File.UserDelegationKey"},"generatedFiles":["src/main/java/com/azure/storage/file/share/AzureFileStorageBuilder.java","src/main/java/com/azure/storage/file/share/DirectoryAsyncClient.java","src/main/java/com/azure/storage/file/share/DirectoryClient.java","src/main/java/com/azure/storage/file/share/FileAsyncClient.java","src/main/java/com/azure/storage/file/share/FileClient.java","src/main/java/com/azure/storage/file/share/FileServiceVersion.java","src/main/java/com/azure/storage/file/share/ServiceAsyncClient.java","src/main/java/com/azure/storage/file/share/ServiceClient.java","src/main/java/com/azure/storage/file/share/ShareAsyncClient.java","src/main/java/com/azure/storage/file/share/ShareClient.java","src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java","src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java","src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java","src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java","src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java","src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java","src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java","src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java","src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java","src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java","src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java","src/main/java/com/azure/storage/file/share/implementation/models/package-info.java","src/main/java/com/azure/storage/file/share/implementation/package-info.java","src/main/java/com/azure/storage/file/share/models/ClearRange.java","src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java","src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java","src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java","src/main/java/com/azure/storage/file/share/models/FileRange.java","src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java","src/main/java/com/azure/storage/file/share/models/LeaseStateType.java","src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java","src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java","src/main/java/com/azure/storage/file/share/models/NfsFileType.java","src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java","src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java","src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java","src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java","src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java","src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java","src/main/java/com/azure/storage/file/share/models/ShareMetrics.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java","src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java","src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java","src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java","src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java","src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java","src/main/java/com/azure/storage/file/share/models/package-info.java","src/main/java/com/azure/storage/file/share/package-info.java","src/main/java/module-info.java"]}
\ No newline at end of file
+{"flavor":"azure","apiVersions":{"Storage.File":"2026-12-06"},"crossLanguagePackageId":"Storage.File","crossLanguageVersion":"5d929a4c3464","crossLanguageDefinitions":{"com.azure.storage.file.share.AzureFileStorageBuilder":"Storage.File","com.azure.storage.file.share.DirectoryAsyncClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryAsyncClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryAsyncClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryAsyncClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.FileAsyncClient":"Storage.File.File","com.azure.storage.file.share.FileAsyncClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileAsyncClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileAsyncClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient":"Storage.File.File","com.azure.storage.file.share.FileClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.ServiceAsyncClient":"Storage.File.Service","com.azure.storage.file.share.ServiceAsyncClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceAsyncClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceAsyncClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient":"Storage.File.Service","com.azure.storage.file.share.ServiceClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ShareAsyncClient":"Storage.File.Share","com.azure.storage.file.share.ShareAsyncClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareAsyncClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient":"Storage.File.Share","com.azure.storage.file.share.ShareClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType":"Storage.File.DeleteSnapshotsOptionType","com.azure.storage.file.share.implementation.models.DirectoryItem":"Storage.File.DirectoryItem","com.azure.storage.file.share.implementation.models.FileItem":"Storage.File.FileItem","com.azure.storage.file.share.implementation.models.FileProperty":"Storage.File.FileProperty","com.azure.storage.file.share.implementation.models.FilesAndDirectoriesListSegment":"Storage.File.FilesAndDirectoriesListSegment","com.azure.storage.file.share.implementation.models.HandleItem":"Storage.File.HandleItem","com.azure.storage.file.share.implementation.models.KeyInfo":"Storage.File.KeyInfo","com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse":"Storage.File.ListFilesAndDirectoriesSegmentResponse","com.azure.storage.file.share.implementation.models.ListFilesIncludeType":"Storage.File.ListFilesIncludeType","com.azure.storage.file.share.implementation.models.ListSharesIncludeType":"Storage.File.ListSharesIncludeType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteFromUrlType":"Storage.File.FileRangeWriteFromUrlType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType":"Storage.File.FileRangeWriteType","com.azure.storage.file.share.implementation.models.ShareItemInternal":"Storage.File.ShareItemInternal","com.azure.storage.file.share.implementation.models.SharePermission":"Storage.File.SharePermission","com.azure.storage.file.share.implementation.models.SharePropertiesInternal":"Storage.File.SharePropertiesInternal","com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper":"Storage.File.SignedIdentifiers","com.azure.storage.file.share.implementation.models.ShareStats":"Storage.File.ShareStats","com.azure.storage.file.share.implementation.models.StringEncoded":"Storage.File.StringEncoded","com.azure.storage.file.share.models.ClearRange":"Storage.File.ClearRange","com.azure.storage.file.share.models.FileLastWrittenMode":"Storage.File.FileLastWrittenMode","com.azure.storage.file.share.models.FilePermissionFormat":"Storage.File.FilePermissionFormat","com.azure.storage.file.share.models.FilePropertySemantics":"Storage.File.FilePropertySemantics","com.azure.storage.file.share.models.FileRange":"Storage.File.FileRange","com.azure.storage.file.share.models.LeaseDurationType":"Storage.File.LeaseDurationType","com.azure.storage.file.share.models.LeaseStateType":"Storage.File.LeaseStateType","com.azure.storage.file.share.models.LeaseStatusType":"Storage.File.LeaseStatusType","com.azure.storage.file.share.models.ModeCopyMode":"Storage.File.ModeCopyMode","com.azure.storage.file.share.models.NfsFileType":"Storage.File.NfsFileType","com.azure.storage.file.share.models.OwnerCopyMode":"Storage.File.OwnerCopyMode","com.azure.storage.file.share.models.PermissionCopyModeType":"Storage.File.PermissionCopyModeType","com.azure.storage.file.share.models.ShareAccessPolicy":"Storage.File.AccessPolicy","com.azure.storage.file.share.models.ShareAccessTier":"Storage.File.ShareAccessTier","com.azure.storage.file.share.models.ShareCorsRule":"Storage.File.CorsRule","com.azure.storage.file.share.models.ShareFileHandleAccessRights":"Storage.File.AccessRight","com.azure.storage.file.share.models.ShareFileRangeList":"Storage.File.ShareFileRangeList","com.azure.storage.file.share.models.ShareMetrics":"Storage.File.Metrics","com.azure.storage.file.share.models.ShareNfsSettings":"Storage.File.ShareNfsSettings","com.azure.storage.file.share.models.ShareNfsSettingsEncryptionInTransit":"Storage.File.ShareNfsSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareProtocolSettings":"Storage.File.ShareProtocolSettings","com.azure.storage.file.share.models.ShareRetentionPolicy":"Storage.File.RetentionPolicy","com.azure.storage.file.share.models.ShareRootSquash":"Storage.File.ShareRootSquash","com.azure.storage.file.share.models.ShareServiceProperties":"Storage.File.StorageServiceProperties","com.azure.storage.file.share.models.ShareSignedIdentifier":"Storage.File.SignedIdentifier","com.azure.storage.file.share.models.ShareSmbSettings":"Storage.File.ShareSmbSettings","com.azure.storage.file.share.models.ShareSmbSettingsEncryptionInTransit":"Storage.File.ShareSmbSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareTokenIntent":"Storage.File.ShareTokenIntent","com.azure.storage.file.share.models.SmbMultichannel":"Storage.File.SmbMultichannel","com.azure.storage.file.share.models.UserDelegationKey":"Storage.File.UserDelegationKey"},"generatedFiles":["src/main/java/com/azure/storage/file/share/AzureFileStorageBuilder.java","src/main/java/com/azure/storage/file/share/DirectoryAsyncClient.java","src/main/java/com/azure/storage/file/share/DirectoryClient.java","src/main/java/com/azure/storage/file/share/FileAsyncClient.java","src/main/java/com/azure/storage/file/share/FileClient.java","src/main/java/com/azure/storage/file/share/FileServiceVersion.java","src/main/java/com/azure/storage/file/share/ServiceAsyncClient.java","src/main/java/com/azure/storage/file/share/ServiceClient.java","src/main/java/com/azure/storage/file/share/ShareAsyncClient.java","src/main/java/com/azure/storage/file/share/ShareClient.java","src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java","src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java","src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java","src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java","src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java","src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java","src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java","src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java","src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java","src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java","src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java","src/main/java/com/azure/storage/file/share/implementation/models/package-info.java","src/main/java/com/azure/storage/file/share/implementation/package-info.java","src/main/java/com/azure/storage/file/share/models/ClearRange.java","src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java","src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java","src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java","src/main/java/com/azure/storage/file/share/models/FileRange.java","src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java","src/main/java/com/azure/storage/file/share/models/LeaseStateType.java","src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java","src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java","src/main/java/com/azure/storage/file/share/models/NfsFileType.java","src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java","src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java","src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java","src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java","src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java","src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java","src/main/java/com/azure/storage/file/share/models/ShareMetrics.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java","src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java","src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java","src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java","src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java","src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java","src/main/java/com/azure/storage/file/share/models/package-info.java","src/main/java/com/azure/storage/file/share/package-info.java","src/main/java/module-info.java"]}
\ No newline at end of file
diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
index 2fbb5c56e6d5..ff9c8de0532d 100644
--- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
+++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
@@ -56,16 +56,12 @@ public class ShareStorageCustomization extends Customization {
         // removeFile is a no-op when absent.
         "FileClientBuilder",
         "AzureFileStorageClient", "AzureFileStorageAsyncClient", "AzureFileStorageClientBuilder",
-        "AzureFileStorageBuilder");
-    // NOTE: FileServiceVersion is NOT in this list. It is generated (via @clientApiVersions with the full historical
-    // version set), then RENAMED to ShareServiceVersion with the *Impl references retyped, in
-    // renameServiceVersionToShareServiceVersion (which also deletes the generated FileServiceVersion.java).
-
-    // module-info.java and package-info.java are hand-authored: the module descriptor carries the
-    // full requires/exports/opens (incl. transitive com.azure.storage.common and the sas/options/
-    // specialized exports), and the package-info files carry the public API Javadoc. typespec-java
-    // regenerates minimal versions that overwrite them (dropping com.azure.storage.common visibility);
-    // removeFile drops the generated copies during postprocessing so the hand-written files survive.
+        "AzureFileStorageBuilder",
+        // The hand-written ShareServiceVersion is authoritative; the generated enum is discarded and new service
+        // versions are added by hand. To instead generate it, remove this entry and restore the @clientApiVersions
+        // block in client.tsp + the FileServiceVersion->ShareServiceVersion rename customization.
+        "FileServiceVersion");
+
     private static final List GENERATED_DESCRIPTOR_FILES_TO_REMOVE = Arrays.asList(
         "src/main/java/module-info.java",
         "src/main/java/com/azure/storage/file/share/package-info.java",
@@ -76,8 +72,6 @@ public class ShareStorageCustomization extends Customization {
     public void customize(LibraryCustomization customization, Logger logger) {
         removeGeneratedConvenienceClients(customization, logger);
 
-        renameServiceVersionToShareServiceVersion(customization, logger);
-
         restoreFluentModels(customization, logger);
 
         customization.getClass("com.azure.storage.file.share.models", "ShareTokenIntent")
@@ -114,47 +108,6 @@ private static void removeGeneratedConvenienceClients(LibraryCustomization custo
         }
     }
 
-    /**
-     * Renames the generated {@code FileServiceVersion} enum to {@code ShareServiceVersion} and retypes the
-     * {@code *Impl} references accordingly. typespec-java names the service-version enum {@code FileServiceVersion};
-     * the {@code @clientApiVersions} augment in client.tsp populates it with the full historical version set. Its
-     * public shape ({@code implements ServiceVersion}, {@code getVersion()}, {@code getLatest()}, and the version
-     * constants) is identical to the shipped hand-written {@code ShareServiceVersion}, so overwriting
-     * {@code ShareServiceVersion.java} with the renamed generated content is not a breaking change and keeps the
-     * enum generated (single source of truth = client.tsp).
-     *
-     * @param customization The library customization.
-     * @param logger The logger.
-     */
-    private static void renameServiceVersionToShareServiceVersion(LibraryCustomization customization, Logger logger) {
-        Editor editor = customization.getRawEditor();
-
-        // Rename the generated enum: write its (renamed) content over ShareServiceVersion.java, delete the original.
-        String generatedEnumPath = PKG_ROOT + "FileServiceVersion.java";
-        String shareEnumPath = PKG_ROOT + "ShareServiceVersion.java";
-        String enumContent = editor.getFileContent(generatedEnumPath);
-        if (enumContent != null) {
-            editor.replaceFile(shareEnumPath, enumContent.replace("FileServiceVersion", "ShareServiceVersion"));
-            editor.removeFile(generatedEnumPath);
-            logger.info("Renamed generated FileServiceVersion enum to ShareServiceVersion");
-        }
-
-        // Retype the FileServiceVersion references in the *Impl classes to the renamed ShareServiceVersion.
-        for (String impl : Arrays.asList("AzureFileStorageImpl", "DirectoriesImpl", "FilesImpl", "ServicesImpl",
-            "SharesImpl")) {
-            String path = PKG_ROOT + "implementation/" + impl + ".java";
-            String content = editor.getFileContent(path);
-            if (content == null) {
-                continue;
-            }
-            String updated = content.replace("FileServiceVersion", "ShareServiceVersion");
-            if (!updated.equals(content)) {
-                editor.replaceFile(path, updated);
-                logger.info("Retyped FileServiceVersion -> ShareServiceVersion in {}", path);
-            }
-        }
-    }
-
     /**
      * Restores the "fluent" shape of models that shipped as {@code @Fluent} (public no-arg constructor + setters)
      * before the TypeSpec migration. With {@code required-fields-as-ctor-args: true} (which must stay true so new

From 291dea077317634d133865629b8996cbddfbc837 Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Mon, 10 Aug 2026 12:53:42 -0700
Subject: [PATCH 04/13] resolving service version generated file discrepancy,
 test impl with requestoptions convienience ops

---
 .../azure-storage-file-share/README.md        | 605 +-----------------
 .../storage/file/share/ShareAsyncClient.java  |  35 +-
 .../azure/storage/file/share/ShareClient.java |  35 +-
 .../implementation/AzureFileStorageImpl.java  |  12 +-
 .../share/implementation/DirectoriesImpl.java |   4 +-
 .../file/share/implementation/FilesImpl.java  |   4 +-
 .../share/implementation/ServicesImpl.java    |   4 +-
 .../file/share/implementation/SharesImpl.java |  46 +-
 .../models/SharesCreateSnapshotHeaders.java   | 151 ++---
 .../implementation/util/ModelHelper.java      |  82 ++-
 .../azure-storage-file-share_metadata.json    |   2 +-
 .../main/java/ShareStorageCustomization.java  | 130 +---
 12 files changed, 209 insertions(+), 901 deletions(-)

diff --git a/sdk/storage/azure-storage-file-share/README.md b/sdk/storage/azure-storage-file-share/README.md
index f791827a28fd..72c2fa4a2165 100644
--- a/sdk/storage/azure-storage-file-share/README.md
+++ b/sdk/storage/azure-storage-file-share/README.md
@@ -1,604 +1 @@
-# Azure File Share client library for Java
-
-The Server Message Block (SMB) protocol is the preferred file share protocol used on-premises today.
-The Microsoft Azure File Share service enables customers to leverage the availability and scalability of Azure's Cloud Infrastructure as a Service (IaaS) SMB without having to rewrite SMB client applications.
-
-Files stored in Azure File Share service shares are accessible via the SMB protocol, and also via REST APIs.
-The File Share service offers the following four resources: the storage account, shares, directories, and files.
-Shares provide a way to organize sets of files and also can be mounted as an SMB file share that is hosted in the cloud.
-
-[Source code][source_code] | [API reference documentation][reference_docs] | [REST API documentation][rest_api_documentation] | [Product documentation][storage_docs] |
-[Samples][samples]
-
-## Getting started
-
-### Prerequisites
-
-- [Java Development Kit (JDK)][jdk] with version 8 or above
-  - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis).
-- [Azure Subscription][azure_subscription]
-- [Create Storage Account][storage_account]
-
-### Include the package
-
-#### Include the BOM file
-
-Please include the azure-sdk-bom to your project to take dependency on GA version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
-To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).
-
-```xml
-
-    
-        
-            com.azure
-            azure-sdk-bom
-            {bom_version_to_target}
-            pom
-            import
-        
-    
-
-```
-and then include the direct dependency in the dependencies section without the version tag.
-
-```xml
-
-  
-    com.azure
-    azure-storage-file-share
-  
-
-```
-
-#### Include direct dependency
-If you want to take dependency on a particular version of the library that is not present in the BOM,
-add the direct dependency to your project as follows.
-
-
-[//]: # ({x-version-update-start;com.azure:azure-storage-file-share;current})
-```xml
-
-  com.azure
-  azure-storage-file-share
-  12.32.0-beta.1
-
-```
-[//]: # ({x-version-update-end})
-
-### Create a Storage Account
-To create a Storage Account you can use the Azure Portal or [Azure CLI][azure_cli].
-
-```bash
-az storage account create \
-    --resource-group  \
-    --name  \
-    --location 
-```
-
-### Authenticate the client
-
-In order to interact with the Storage service (File Share Service, Share, Directory, MessageId, File) you'll need to create an instance of the Service Client class.
-To make this possible you'll need the Account SAS (shared access signature) string of Storage account. Learn more at [SAS Token][sas_token]
-
-#### Get Credentials
-
-- **SAS Token**
-    * Use the [Azure CLI][azure_cli] snippet below to get the SAS token from the Storage account.
-
-        ```bash
-        az storage file generate-sas
-            --name {account name}
-            --expiry {date/time to expire SAS token}
-            --permission {permission to grant}
-            --connection-string {connection string of the storage account}
-        ```
-
-        ```bash
-        CONNECTION_STRING=
-
-        az storage file generate-sas
-            --name javasdksas
-            --expiry 2019-06-05
-            --permission rpau
-            --connection-string $CONNECTION_STRING
-        ```
-
-    * Alternatively, get the Account SAS Token from the Azure Portal.
-        1. Go to your storage account.
-        1. Click on "Shared access signature".
-        1. Click on "Generate SAS and connection string".
-
-- **Shared Key Credential**
-    * There are two ways to create a shared key credential, the first is using the storage account name and account key. The second is using the storage connection string.
-        1. Use account name and account key.
-            1. The account name is your storage account name.
-            1. Go to your storage account.
-            1. Select "Access keys" tab.
-            1. Copy the "Key" value for either Key 1 or Key 2.
-        1. Use the connection string
-            1. Go to your storage account.
-            1. Select "Access keys" tab.
-            1. Copy the "Connection string" value for either Key 1 or Key 2.
-
-## Key concepts
-
-### URL format
-File Shares are addressable using the following URL format:
-
-```
-https://.file.core.windows.net/
-```
-
-The following URL addresses a queue in the diagram:
-
-```
-https://myaccount.file.core.windows.net/images-to-download
-```
-
-#### Resource URI Syntax
-For the storage account, the base URI for queue operations includes the name of the account only:
-
-```
-https://myaccount.file.core.windows.net
-```
-
-For file, the base URI includes the name of the account and the name of the directory/file:
-
-```
-https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile
-```
-
-### Handling Exceptions
-Uses the `shareServiceClient` generated from [shareServiceClient](#share-services) section below.
-
-```java readme-sample-handleException
-try {
-    shareServiceClient.createShare("myShare");
-} catch (ShareStorageException e) {
-    logger.error("Failed to create a share with error code: " + e.getErrorCode());
-}
-```
-
-### Resource Names
-The URI to reference a share, directory or file must be unique. Within a given storage account, every share must have a unique name. Every file within a given share or directory must also have a unique name within that share or directory.
-
-If you attempt to create a share, directory, or file with a name that violates naming rules, the request will fail with status code 400 (Bad Request).
-
-### Share Names
-The rules for File Share service names are more restrictive than what is prescribed by the SMB protocol for SMB share names, so that the Blob and File services can share similar naming conventions for containers and shares. The naming restrictions for shares are as follows:
-
-1. A share name must be a valid DNS name.
-1. Share names must start with a letter or number, and can contain only letters, numbers, and the dash (-) character.
-1. Every dash (-) character must be immediately preceded and followed by a letter or number; consecutive dashes are not permitted in share names.
-1. All letters in a share name must be lowercase.
-1. Share names must be from 3 through 63 characters long.
-
-### Directory and File Names
-The Azure File Share service naming rules for directory and file names are as follows:
-
-1. Share Directory and file names are case-preserving and case-insensitive.
-1. Share Directory and file component names must be no more than 255 characters in length.
-1. Share Directory names cannot end with the forward slash character (/). If provided, it will be automatically removed.
-1. Share File names must not end with the forward slash character (/).
-1. Reserved URL characters must be properly escaped.
-1. The following characters are not allowed: `" \ / : | < > * ?`
-1. Illegal URL path characters not allowed. Code points like \uE000, while valid in NTFS filenames, are not valid Unicode characters. In addition, some ASCII or Unicode characters, like control characters (0x00 to 0x1F, \u0081, etc.), are also not allowed. For rules governing Unicode strings in HTTP/1.1 see [RFC 2616, Section 2.2: Basic Rules][RFC_URL_1] and [RFC 3987][RFL_URL_2].
-1. The following file names are not allowed: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, dot character (.), and two dot characters (..).
-
-### Metadata Names
-Metadata for a share or file resource is stored as name-value pairs associated with the resource. Directories do not have metadata. Metadata names must adhere to the naming rules for [C# identifiers][csharp_identifiers].
-
-Note that metadata names preserve the case with which they were created, but are case-insensitive when set or read. If two or more metadata headers with the same name are submitted for a resource, the Azure File service returns status code 400 (Bad Request).
-
-### Share Services
-The File Share Service REST API provides operations on accounts and manage file service properties. It allows the operations of listing and deleting shares, getting and setting file service properties.
-Once you have the SASToken, you can construct the `shareServiceClient` with `${accountName}`, `${sasToken}`
-
-```java readme-sample-createShareServiceClient
-String shareServiceURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
-ShareServiceClient shareServiceClient = new ShareServiceClientBuilder().endpoint(shareServiceURL)
-    .sasToken(SAS_TOKEN).buildClient();
-```
-
-### Share
-The share resource includes metadata and properties for that share. It allows the operations of creating, creating snapshot, deleting shares, getting share properties, setting metadata, getting and setting ACL (Access policy). Getting and setting ACL (Access policy) can only be used by ShareClient with ConnectionString. 
-
-#### Share With SASToken
-Once you have the SASToken, you can construct the share client with `${accountName}`, `${shareName}`, `${sasToken}`
-
-```java readme-sample-createShareClient
-String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
-ShareClient shareClient = new ShareClientBuilder().endpoint(shareURL)
-    .sasToken(SAS_TOKEN).shareName(shareName).buildClient();
-```
-
-#### Share With ConnectionString
-Once you have the ConnectionString, you can construct the share client with `${accountName}`, `${shareName}`, `${connectionString}`
-
-```java readme-sample-createShareClientWithConnectionString
-String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
-ShareClient shareClient = new ShareClientBuilder().endpoint(shareURL)
-    .connectionString(CONNECTION_STRING).shareName(shareName).buildClient();
-```
-
-#### Share with `TokenCredential`
-Once you have the TokenCredential, you can construct the share client with `${accountName}`, `${shareName}` and `ShareTokenIntent`. 
-`ShareTokenIntent.BACKUP` specifies requests that are intended for backup/admin type operations, meaning that all
-file/directory ACLs are bypassed and full permissions are granted. User must have required RBAC permission in order to 
-use `ShareTokenIntent.BACKUP`.
-
-```java readme-sample-createShareClientWithTokenCredential
-String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
-
-ShareClient serviceClient = new ShareClientBuilder()
-    .endpoint(shareURL)
-    .credential(tokenCredential)
-    .shareTokenIntent(ShareTokenIntent.BACKUP)
-    .shareName(shareName)
-    .buildClient();
-```
-
-### Directory
- The directory resource includes the properties for that directory. It allows the operations of creating, listing, deleting directories or subdirectories or files, getting properties, setting metadata, listing and force closing the handles.
- Once you have the SASToken, you can construct the file service client with `${accountName}`, `${shareName}`, `${directoryPath}`, `${sasToken}`
-
-```java readme-sample-createDirectoryClient
-String directoryURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
-ShareDirectoryClient directoryClient = new ShareFileClientBuilder().endpoint(directoryURL)
-    .sasToken(SAS_TOKEN).shareName(shareName).resourcePath(directoryPath).buildDirectoryClient();
-```
-
-### File
- The file resource includes the properties for that file. It allows the operations of creating, uploading, copying, downloading, deleting files or range of the files, getting properties, setting metadata, listing and force closing the handles.
- Once you have the SASToken, you can construct the file service client with `${accountName}`, `${shareName}`, `${directoryPath}`, `${fileName}`, `${sasToken}`
-
-```java readme-sample-createFileClient
-String fileURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
-ShareFileClient fileClient = new ShareFileClientBuilder().connectionString(CONNECTION_STRING)
-    .endpoint(fileURL).shareName(shareName).resourcePath(directoryPath + "/" + fileName).buildFileClient();
-```
-
-## Examples
-
-The following sections provide several code snippets covering some of the most common Configuration Service tasks, including:
-- [Create a Share](#create-a-share)
-- [Create a snapshot on Share](#create-a-snapshot-on-share)
-- [Create a Directory](#create-a-directory)
-- [Create a Subdirectory](#create-a-subdirectory)
-- [Create a File](#create-a-file)
-- [List all Shares](#list-all-shares)
-- [List all Subdirectories and Files](#list-all-subdirectories-and-files)
-- [List all ranges on file](#list-all-ranges-on-file)
-- [Delete a Share](#delete-a-share)
-- [Delete a Directory](#delete-a-directory)
-- [Delete a Subdirectory](#delete-a-subdirectory)
-- [Delete a File](#delete-a-file)
-- [Copy a File](#copy-a-file)
-- [Abort copy a File](#abort-copy-a-file)
-- [Upload data to Storage File](#upload-data-to-storage)
-- [Upload data bigger than 4 MB to Storage File](#upload-data-bigger-than-4-mb-to-storage)
-- [Upload file to Storage File](#upload-file-to-storage)
-- [Download data from file range](#download-data-from-file-range)
-- [Download file from Storage File](#download-file-from-storage)
-- [Get a share service properties](#get-a-share-service-properties)
-- [Set a share service properties](#set-a-share-service-properties)
-- [Set a Share metadata](#set-a-share-metadata)
-- [Get a Share access policy](#get-a-share-access-policy)
-- [Set a Share access policy](#set-a-share-access-policy)
-- [Get handles on Directory and File](#get-handles-on-directory-file)
-- [Force close handles on handle id](#force-close-handles-on-handle-id)
-- [Set quota on Share](#set-quota-on-share)
-- [Set file httpHeaders](#set-file-httpheaders)
-
-### Create a share
-Create a share in the Storage Account. Throws StorageException If the share fails to be created.
-Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services).
-
-```java readme-sample-createShare
-String shareName = "testshare";
-shareServiceClient.createShare(shareName);
-```
-
-### Create a snapshot on Share
-Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services).
-
-```java readme-sample-createSnapshotOnShare
-String shareName = "testshare";
-ShareClient shareClient = shareServiceClient.getShareClient(shareName);
-shareClient.createSnapshot();
-```
-
-### Create a directory
-Taking the shareClient initialized above, [`${shareClient}`](#share).
-
-```java readme-sample-createDirectory
-String dirName = "testdir";
-shareClient.createDirectory(dirName);
-```
-
-### Create a subdirectory
-Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory).
-
-```java readme-sample-createSubDirectory
-String subDirName = "testsubdir";
-directoryClient.createSubdirectory(subDirName);
-```
-
-### Create a File
-Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .
-
-```java readme-sample-createFile
-String fileName = "testfile";
-long maxSize = 1024;
-directoryClient.createFile(fileName, maxSize);
-```
-
-### List all Shares
-Taking the shareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services)
-
-```java readme-sample-getShareList
-shareServiceClient.listShares();
-```
-
-### List all subdirectories and files
-Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory)
-
-```java readme-sample-getSubDirectoryAndFileList
-directoryClient.listFilesAndDirectories();
-```
-
-### List all ranges on file
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file)
-
-```java readme-sample-getRangeList
-fileClient.listRanges();
-```
-
-### Delete a share
-Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken)
-
-```java readme-sample-deleteShare
-shareClient.delete();
-```
-
-### Delete a directory
-Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .
-
-```java readme-sample-deleteDirectory
-String dirName = "testdir";
-shareClient.deleteDirectory(dirName);
-```
-
-### Delete a subdirectory
-Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .
-
-```java readme-sample-deleteSubDirectory
-String subDirName = "testsubdir";
-directoryClient.deleteSubdirectory(subDirName);
-```
-
-### Delete a file
-Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .
-
-```java readme-sample-deleteFile
-String fileName = "testfile";
-directoryClient.deleteFile(fileName);
-```
-
-### Copy a file
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with string of source URL.
-
-```java readme-sample-copyFile
-String sourceURL = "https://myaccount.file.core.windows.net/myshare/myfile";
-Duration pollInterval = Duration.ofSeconds(2);
-SyncPoller poller = fileClient.beginCopy(sourceURL, (Map) null, pollInterval);
-```
-
-### Abort copy a file
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with the copy info response returned above `${copyId}=[copyInfoResponse](#copy-a-file)`.
-
-```java readme-sample-abortCopyFile
-fileClient.abortCopy("copyId");
-```
-
-### Upload data to storage
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with data of "default" .
-
-```java readme-sample-uploadDataToStorage
-String uploadText = "default";
-InputStream data = new ByteArrayInputStream(uploadText.getBytes(StandardCharsets.UTF_8));
-fileClient.upload(data, uploadText.length());
-```
-
-### Upload data bigger than 4 MB to storage
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with data of "default" .
-
-```java readme-sample-uploadDataToStorageBiggerThan4MB
-byte[] data = "Hello, data sample!".getBytes(StandardCharsets.UTF_8);
-
-long chunkSize = 4 * 1024 * 1024L;
-if (data.length > chunkSize) {
-    for (int offset = 0; offset < data.length; offset += chunkSize) {
-        try {
-            // the last chunk size is smaller than the others
-            chunkSize = Math.min(data.length - offset, chunkSize);
-
-            // select the chunk in the byte array
-            byte[] subArray = Arrays.copyOfRange(data, offset, (int) (offset + chunkSize));
-
-            // upload the chunk
-            fileClient.uploadWithResponse(new ByteArrayInputStream(subArray), chunkSize, (long) offset, null, Context.NONE);
-        } catch (RuntimeException e) {
-            logger.error("Failed to upload the file", e);
-            if (Boolean.TRUE.equals(fileClient.exists())) {
-                fileClient.delete();
-            }
-            throw e;
-        }
-    }
-} else {
-    fileClient.upload(new ByteArrayInputStream(data), data.length);
-}
-```
-
-### Upload file to storage
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file) .
-
-```java readme-sample-uploadFileToStorage
-String filePath = "${myLocalFilePath}";
-fileClient.uploadFromFile(filePath);
-```
-
-### Download data from file range
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with the range from 1024 to 2048.
-
-```java readme-sample-downloadDataFromFileRange
-ShareFileRange fileRange = new ShareFileRange(0L, 2048L);
-OutputStream stream = new ByteArrayOutputStream();
-fileClient.downloadWithResponse(stream, fileRange, false, null, Context.NONE);
-```
-
-### Download file from storage
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file) and download to the file of filePath.
-
-```java readme-sample-downloadFileFromFileRange
-String filePath = "${myLocalFilePath}";
-fileClient.downloadToFile(filePath);
-```
-
-### Get a share service properties
-Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services) .
-
-```java readme-sample-getShareServiceProperties
-shareServiceClient.getProperties();
-```
-
-### Set a share service properties
-Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services) .
-
-```java readme-sample-setShareServiceProperties
-ShareServiceProperties properties = shareServiceClient.getProperties();
-
-properties.getMinuteMetrics().setEnabled(true).setIncludeApis(true);
-properties.getHourMetrics().setEnabled(true).setIncludeApis(true);
-
-shareServiceClient.setProperties(properties);
-```
-
-### Set a share metadata
-Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .
-
-```java readme-sample-setShareMetadata
-Map metadata = Collections.singletonMap("directory", "metadata");
-shareClient.setMetadata(metadata);
-```
-
-### Get a share access policy
-Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-connectionstring) .
-
-```java readme-sample-getAccessPolicy
-shareClient.getAccessPolicy();
-```
-
-### Set a share access policy
-Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-connectionstring) .
-
-```java readme-sample-setAccessPolicy
-ShareAccessPolicy accessPolicy = new ShareAccessPolicy().setPermissions("r")
-    .setStartsOn(OffsetDateTime.now(ZoneOffset.UTC))
-    .setExpiresOn(OffsetDateTime.now(ZoneOffset.UTC).plusDays(10));
-ShareSignedIdentifier permission = new ShareSignedIdentifier().setId("mypolicy").setAccessPolicy(accessPolicy);
-shareClient.setAccessPolicy(Collections.singletonList(permission));
-```
-
-### Get handles on directory file
-Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory)
-
-```java readme-sample-getHandleList
-PagedIterable handleItems = directoryClient.listHandles(null, true, Duration.ofSeconds(30), Context.NONE);
-```
-
-### Force close handles on handle id
-Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) and the handle id returned above `${handleId}=[handleItems](#get-handles-on-directory-file)`
-
-```java readme-sample-forceCloseHandleWithResponse
-PagedIterable handleItems = directoryClient.listHandles(null, true, Duration.ofSeconds(30), Context.NONE);
-String handleId = handleItems.iterator().next().getHandleId();
-directoryClient.forceCloseHandleWithResponse(handleId, Duration.ofSeconds(30), Context.NONE);
-```
-
-### Set quota on share
-Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .
-
-```java readme-sample-setQuotaOnShare
-int quotaOnGB = 1;
-shareClient.setPropertiesWithResponse(new ShareSetPropertiesOptions().setQuotaInGb(quotaOnGB), null, Context.NONE);
-```
-
-### Set file httpheaders
-Taking the fileClient in KeyConcept, [`${fileClient}`](#file) .
-
-```java readme-sample-setFileHttpHeaders
-ShareFileHttpHeaders httpHeaders = new ShareFileHttpHeaders().setContentType("text/plain");
-fileClient.setProperties(1024, httpHeaders, null, null);
-```
-
-## Troubleshooting
-
-## General
-
-When you interact with file using this Java client library, errors returned by the service correspond to the same HTTP status codes returned for [REST API][storage_file_rest] requests. For example, if you try to retrieve a share that doesn't exist in your Storage Account, a `404` error is returned, indicating `Not Found`.
-
-### Default HTTP Client
-All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure
-the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the
-[HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).
-
-### Default SSL library
-All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL
-operations. The Boring SSL library is an uber jar containing native libraries for Linux / macOS / Windows, and provides
-better performance compared to the default SSL implementation within the JDK. For more information, including how to
-reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.
-
-## Next steps
-
-## Contributing
-This project welcomes contributions and suggestions.  Most contributions require you to agree to a
-Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
-the rights to use your contribution. For details, visit https://cla.microsoft.com.
-
-When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
-a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
-provided by the bot. You will only need to do this once across all repos using our CLA.
-
-This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
-For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
-contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
-
-For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
-
-
-[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-file-share/src/
-[reference_docs]: https://azure.github.io/azure-sdk-for-java/
-[rest_api_documentation]: https://learn.microsoft.com/rest/api/storageservices/file-service-rest-api
-[storage_docs]: https://learn.microsoft.com/azure/storage/files/storage-files-introduction
-[jdk]: https://learn.microsoft.com/java/azure/jdk/
-[maven]: https://maven.apache.org/
-[azure_subscription]: https://azure.microsoft.com/free/
-[storage_account]: https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
-[azure_cli]: https://learn.microsoft.com/cli/azure
-[sas_token]: https://learn.microsoft.com/azure/storage/common/storage-dotnet-shared-access-signature-part-1
-[RFC_URL_1]: https://www.ietf.org/rfc/rfc2616.txt
-[RFL_URL_2]: https://www.ietf.org/rfc/rfc3987.txt
-[csharp_identifiers]: https://learn.microsoft.com/dotnet/csharp/language-reference/
-[storage_file_rest]: https://learn.microsoft.com/rest/api/storageservices/file-service-error-codes
-[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-file-share/src/samples
-[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/blob/main/docs/performance-tuning.md
-
-
+# Azure File Share client library for Java

The Server Message Block (SMB) protocol is the preferred file share protocol used on-premises today.
The Microsoft Azure File Share service enables customers to leverage the availability and scalability of Azure's Cloud Infrastructure as a Service (IaaS) SMB without having to rewrite SMB client applications.

Files stored in Azure File Share service shares are accessible via the SMB protocol, and also via REST APIs.
The File Share service offers the following four resources: the storage account, shares, directories, and files.
Shares provide a way to organize sets of files and also can be mounted as an SMB file share that is hosted in the cloud.

[Source code][source_code] | [API reference documentation][reference_docs] | [REST API documentation][rest_api_documentation] | [Product documentation][storage_docs] |
[Samples][samples]

## Getting started

### Prerequisites

- [Java Development Kit (JDK)][jdk] with version 8 or above
  - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis).
- [Azure Subscription][azure_subscription]
- [Create Storage Account][storage_account]

### Include the package

#### Include the BOM file

Please include the azure-sdk-bom to your project to take dependency on GA version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).

```xml

    
        
            com.azure
            azure-sdk-bom
            {bom_version_to_target}
            pom
            import
        
    

```
and then include the direct dependency in the dependencies section without the version tag.

```xml

  
    com.azure
    azure-storage-file-share
  

```

#### Include direct dependency
If you want to take dependency on a particular version of the library that is not present in the BOM,
add the direct dependency to your project as follows.


[//]: # ({x-version-update-start;com.azure:azure-storage-file-share;current})
```xml

  com.azure
  azure-storage-file-share
  12.32.0-beta.1

```
[//]: # ({x-version-update-end})

### Create a Storage Account
To create a Storage Account you can use the Azure Portal or [Azure CLI][azure_cli].

```bash
az storage account create \
    --resource-group  \
    --name  \
    --location 
```

### Authenticate the client

In order to interact with the Storage service (File Share Service, Share, Directory, MessageId, File) you'll need to create an instance of the Service Client class.
To make this possible you'll need the Account SAS (shared access signature) string of Storage account. Learn more at [SAS Token][sas_token]

#### Get Credentials

- **SAS Token**
    * Use the [Azure CLI][azure_cli] snippet below to get the SAS token from the Storage account.

        ```bash
        az storage file generate-sas
            --name {account name}
            --expiry {date/time to expire SAS token}
            --permission {permission to grant}
            --connection-string {connection string of the storage account}
        ```

        ```bash
        CONNECTION_STRING=

        az storage file generate-sas
            --name javasdksas
            --expiry 2019-06-05
            --permission rpau
            --connection-string $CONNECTION_STRING
        ```

    * Alternatively, get the Account SAS Token from the Azure Portal.
        1. Go to your storage account.
        1. Click on "Shared access signature".
        1. Click on "Generate SAS and connection string".

- **Shared Key Credential**
    * There are two ways to create a shared key credential, the first is using the storage account name and account key. The second is using the storage connection string.
        1. Use account name and account key.
            1. The account name is your storage account name.
            1. Go to your storage account.
            1. Select "Access keys" tab.
            1. Copy the "Key" value for either Key 1 or Key 2.
        1. Use the connection string
            1. Go to your storage account.
            1. Select "Access keys" tab.
            1. Copy the "Connection string" value for either Key 1 or Key 2.

## Key concepts

### URL format
File Shares are addressable using the following URL format:

```
https://.file.core.windows.net/
```

The following URL addresses a queue in the diagram:

```
https://myaccount.file.core.windows.net/images-to-download
```

#### Resource URI Syntax
For the storage account, the base URI for queue operations includes the name of the account only:

```
https://myaccount.file.core.windows.net
```

For file, the base URI includes the name of the account and the name of the directory/file:

```
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile
```

### Handling Exceptions
Uses the `shareServiceClient` generated from [shareServiceClient](#share-services) section below.

```java readme-sample-handleException
try {
    shareServiceClient.createShare("myShare");
} catch (ShareStorageException e) {
    logger.error("Failed to create a share with error code: " + e.getErrorCode());
}
```

### Resource Names
The URI to reference a share, directory or file must be unique. Within a given storage account, every share must have a unique name. Every file within a given share or directory must also have a unique name within that share or directory.

If you attempt to create a share, directory, or file with a name that violates naming rules, the request will fail with status code 400 (Bad Request).

### Share Names
The rules for File Share service names are more restrictive than what is prescribed by the SMB protocol for SMB share names, so that the Blob and File services can share similar naming conventions for containers and shares. The naming restrictions for shares are as follows:

1. A share name must be a valid DNS name.
1. Share names must start with a letter or number, and can contain only letters, numbers, and the dash (-) character.
1. Every dash (-) character must be immediately preceded and followed by a letter or number; consecutive dashes are not permitted in share names.
1. All letters in a share name must be lowercase.
1. Share names must be from 3 through 63 characters long.

### Directory and File Names
The Azure File Share service naming rules for directory and file names are as follows:

1. Share Directory and file names are case-preserving and case-insensitive.
1. Share Directory and file component names must be no more than 255 characters in length.
1. Share Directory names cannot end with the forward slash character (/). If provided, it will be automatically removed.
1. Share File names must not end with the forward slash character (/).
1. Reserved URL characters must be properly escaped.
1. The following characters are not allowed: `" \ / : | < > * ?`
1. Illegal URL path characters not allowed. Code points like \uE000, while valid in NTFS filenames, are not valid Unicode characters. In addition, some ASCII or Unicode characters, like control characters (0x00 to 0x1F, \u0081, etc.), are also not allowed. For rules governing Unicode strings in HTTP/1.1 see [RFC 2616, Section 2.2: Basic Rules][RFC_URL_1] and [RFC 3987][RFL_URL_2].
1. The following file names are not allowed: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, dot character (.), and two dot characters (..).

### Metadata Names
Metadata for a share or file resource is stored as name-value pairs associated with the resource. Directories do not have metadata. Metadata names must adhere to the naming rules for [C# identifiers][csharp_identifiers].

Note that metadata names preserve the case with which they were created, but are case-insensitive when set or read. If two or more metadata headers with the same name are submitted for a resource, the Azure File service returns status code 400 (Bad Request).

### Share Services
The File Share Service REST API provides operations on accounts and manage file service properties. It allows the operations of listing and deleting shares, getting and setting file service properties.
Once you have the SASToken, you can construct the `shareServiceClient` with `${accountName}`, `${sasToken}`

```java readme-sample-createShareServiceClient
String shareServiceURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareServiceClient shareServiceClient = new ShareServiceClientBuilder().endpoint(shareServiceURL)
    .sasToken(SAS_TOKEN).buildClient();
```

### Share
The share resource includes metadata and properties for that share. It allows the operations of creating, creating snapshot, deleting shares, getting share properties, setting metadata, getting and setting ACL (Access policy). Getting and setting ACL (Access policy) can only be used by ShareClient with ConnectionString. 

#### Share With SASToken
Once you have the SASToken, you can construct the share client with `${accountName}`, `${shareName}`, `${sasToken}`

```java readme-sample-createShareClient
String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareClient shareClient = new ShareClientBuilder().endpoint(shareURL)
    .sasToken(SAS_TOKEN).shareName(shareName).buildClient();
```

#### Share With ConnectionString
Once you have the ConnectionString, you can construct the share client with `${accountName}`, `${shareName}`, `${connectionString}`

```java readme-sample-createShareClientWithConnectionString
String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareClient shareClient = new ShareClientBuilder().endpoint(shareURL)
    .connectionString(CONNECTION_STRING).shareName(shareName).buildClient();
```

#### Share with `TokenCredential`
Once you have the TokenCredential, you can construct the share client with `${accountName}`, `${shareName}` and `ShareTokenIntent`. 
`ShareTokenIntent.BACKUP` specifies requests that are intended for backup/admin type operations, meaning that all
file/directory ACLs are bypassed and full permissions are granted. User must have required RBAC permission in order to 
use `ShareTokenIntent.BACKUP`.

```java readme-sample-createShareClientWithTokenCredential
String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);

ShareClient serviceClient = new ShareClientBuilder()
    .endpoint(shareURL)
    .credential(tokenCredential)
    .shareTokenIntent(ShareTokenIntent.BACKUP)
    .shareName(shareName)
    .buildClient();
```

### Directory
 The directory resource includes the properties for that directory. It allows the operations of creating, listing, deleting directories or subdirectories or files, getting properties, setting metadata, listing and force closing the handles.
 Once you have the SASToken, you can construct the file service client with `${accountName}`, `${shareName}`, `${directoryPath}`, `${sasToken}`

```java readme-sample-createDirectoryClient
String directoryURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareDirectoryClient directoryClient = new ShareFileClientBuilder().endpoint(directoryURL)
    .sasToken(SAS_TOKEN).shareName(shareName).resourcePath(directoryPath).buildDirectoryClient();
```

### File
 The file resource includes the properties for that file. It allows the operations of creating, uploading, copying, downloading, deleting files or range of the files, getting properties, setting metadata, listing and force closing the handles.
 Once you have the SASToken, you can construct the file service client with `${accountName}`, `${shareName}`, `${directoryPath}`, `${fileName}`, `${sasToken}`

```java readme-sample-createFileClient
String fileURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareFileClient fileClient = new ShareFileClientBuilder().connectionString(CONNECTION_STRING)
    .endpoint(fileURL).shareName(shareName).resourcePath(directoryPath + "/" + fileName).buildFileClient();
```

## Examples

The following sections provide several code snippets covering some of the most common Configuration Service tasks, including:
- [Create a Share](#create-a-share)
- [Create a snapshot on Share](#create-a-snapshot-on-share)
- [Create a Directory](#create-a-directory)
- [Create a Subdirectory](#create-a-subdirectory)
- [Create a File](#create-a-file)
- [List all Shares](#list-all-shares)
- [List all Subdirectories and Files](#list-all-subdirectories-and-files)
- [List all ranges on file](#list-all-ranges-on-file)
- [Delete a Share](#delete-a-share)
- [Delete a Directory](#delete-a-directory)
- [Delete a Subdirectory](#delete-a-subdirectory)
- [Delete a File](#delete-a-file)
- [Copy a File](#copy-a-file)
- [Abort copy a File](#abort-copy-a-file)
- [Upload data to Storage File](#upload-data-to-storage)
- [Upload data bigger than 4 MB to Storage File](#upload-data-bigger-than-4-mb-to-storage)
- [Upload file to Storage File](#upload-file-to-storage)
- [Download data from file range](#download-data-from-file-range)
- [Download file from Storage File](#download-file-from-storage)
- [Get a share service properties](#get-a-share-service-properties)
- [Set a share service properties](#set-a-share-service-properties)
- [Set a Share metadata](#set-a-share-metadata)
- [Get a Share access policy](#get-a-share-access-policy)
- [Set a Share access policy](#set-a-share-access-policy)
- [Get handles on Directory and File](#get-handles-on-directory-file)
- [Force close handles on handle id](#force-close-handles-on-handle-id)
- [Set quota on Share](#set-quota-on-share)
- [Set file httpHeaders](#set-file-httpheaders)

### Create a share
Create a share in the Storage Account. Throws StorageException If the share fails to be created.
Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services).

```java readme-sample-createShare
String shareName = "testshare";
shareServiceClient.createShare(shareName);
```

### Create a snapshot on Share
Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services).

```java readme-sample-createSnapshotOnShare
String shareName = "testshare";
ShareClient shareClient = shareServiceClient.getShareClient(shareName);
shareClient.createSnapshot();
```

### Create a directory
Taking the shareClient initialized above, [`${shareClient}`](#share).

```java readme-sample-createDirectory
String dirName = "testdir";
shareClient.createDirectory(dirName);
```

### Create a subdirectory
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory).

```java readme-sample-createSubDirectory
String subDirName = "testsubdir";
directoryClient.createSubdirectory(subDirName);
```

### Create a File
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .

```java readme-sample-createFile
String fileName = "testfile";
long maxSize = 1024;
directoryClient.createFile(fileName, maxSize);
```

### List all Shares
Taking the shareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services)

```java readme-sample-getShareList
shareServiceClient.listShares();
```

### List all subdirectories and files
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory)

```java readme-sample-getSubDirectoryAndFileList
directoryClient.listFilesAndDirectories();
```

### List all ranges on file
Taking the fileClient in KeyConcept, [`${fileClient}`](#file)

```java readme-sample-getRangeList
fileClient.listRanges();
```

### Delete a share
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken)

```java readme-sample-deleteShare
shareClient.delete();
```

### Delete a directory
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .

```java readme-sample-deleteDirectory
String dirName = "testdir";
shareClient.deleteDirectory(dirName);
```

### Delete a subdirectory
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .

```java readme-sample-deleteSubDirectory
String subDirName = "testsubdir";
directoryClient.deleteSubdirectory(subDirName);
```

### Delete a file
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .

```java readme-sample-deleteFile
String fileName = "testfile";
directoryClient.deleteFile(fileName);
```

### Copy a file
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with string of source URL.

```java readme-sample-copyFile
String sourceURL = "https://myaccount.file.core.windows.net/myshare/myfile";
Duration pollInterval = Duration.ofSeconds(2);
SyncPoller poller = fileClient.beginCopy(sourceURL, (Map) null, pollInterval);
```

### Abort copy a file
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with the copy info response returned above `${copyId}=[copyInfoResponse](#copy-a-file)`.

```java readme-sample-abortCopyFile
fileClient.abortCopy("copyId");
```

### Upload data to storage
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with data of "default" .

```java readme-sample-uploadDataToStorage
String uploadText = "default";
InputStream data = new ByteArrayInputStream(uploadText.getBytes(StandardCharsets.UTF_8));
fileClient.upload(data, uploadText.length());
```

### Upload data bigger than 4 MB to storage
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with data of "default" .

```java readme-sample-uploadDataToStorageBiggerThan4MB
byte[] data = "Hello, data sample!".getBytes(StandardCharsets.UTF_8);

long chunkSize = 4 * 1024 * 1024L;
if (data.length > chunkSize) {
    for (int offset = 0; offset < data.length; offset += chunkSize) {
        try {
            // the last chunk size is smaller than the others
            chunkSize = Math.min(data.length - offset, chunkSize);

            // select the chunk in the byte array
            byte[] subArray = Arrays.copyOfRange(data, offset, (int) (offset + chunkSize));

            // upload the chunk
            fileClient.uploadWithResponse(new ByteArrayInputStream(subArray), chunkSize, (long) offset, null, Context.NONE);
        } catch (RuntimeException e) {
            logger.error("Failed to upload the file", e);
            if (Boolean.TRUE.equals(fileClient.exists())) {
                fileClient.delete();
            }
            throw e;
        }
    }
} else {
    fileClient.upload(new ByteArrayInputStream(data), data.length);
}
```

### Upload file to storage
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) .

```java readme-sample-uploadFileToStorage
String filePath = "${myLocalFilePath}";
fileClient.uploadFromFile(filePath);
```

### Download data from file range
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with the range from 1024 to 2048.

```java readme-sample-downloadDataFromFileRange
ShareFileRange fileRange = new ShareFileRange(0L, 2048L);
OutputStream stream = new ByteArrayOutputStream();
fileClient.downloadWithResponse(stream, fileRange, false, null, Context.NONE);
```

### Download file from storage
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) and download to the file of filePath.

```java readme-sample-downloadFileFromFileRange
String filePath = "${myLocalFilePath}";
fileClient.downloadToFile(filePath);
```

### Get a share service properties
Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services) .

```java readme-sample-getShareServiceProperties
shareServiceClient.getProperties();
```

### Set a share service properties
Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services) .

```java readme-sample-setShareServiceProperties
ShareServiceProperties properties = shareServiceClient.getProperties();

properties.getMinuteMetrics().setEnabled(true).setIncludeApis(true);
properties.getHourMetrics().setEnabled(true).setIncludeApis(true);

shareServiceClient.setProperties(properties);
```

### Set a share metadata
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .

```java readme-sample-setShareMetadata
Map metadata = Collections.singletonMap("directory", "metadata");
shareClient.setMetadata(metadata);
```

### Get a share access policy
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-connectionstring) .

```java readme-sample-getAccessPolicy
shareClient.getAccessPolicy();
```

### Set a share access policy
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-connectionstring) .

```java readme-sample-setAccessPolicy
ShareAccessPolicy accessPolicy = new ShareAccessPolicy().setPermissions("r")
    .setStartsOn(OffsetDateTime.now(ZoneOffset.UTC))
    .setExpiresOn(OffsetDateTime.now(ZoneOffset.UTC).plusDays(10));
ShareSignedIdentifier permission = new ShareSignedIdentifier().setId("mypolicy").setAccessPolicy(accessPolicy);
shareClient.setAccessPolicy(Collections.singletonList(permission));
```

### Get handles on directory file
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory)

```java readme-sample-getHandleList
PagedIterable handleItems = directoryClient.listHandles(null, true, Duration.ofSeconds(30), Context.NONE);
```

### Force close handles on handle id
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) and the handle id returned above `${handleId}=[handleItems](#get-handles-on-directory-file)`

```java readme-sample-forceCloseHandleWithResponse
PagedIterable handleItems = directoryClient.listHandles(null, true, Duration.ofSeconds(30), Context.NONE);
String handleId = handleItems.iterator().next().getHandleId();
directoryClient.forceCloseHandleWithResponse(handleId, Duration.ofSeconds(30), Context.NONE);
```

### Set quota on share
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .

```java readme-sample-setQuotaOnShare
int quotaOnGB = 1;
shareClient.setPropertiesWithResponse(new ShareSetPropertiesOptions().setQuotaInGb(quotaOnGB), null, Context.NONE);
```

### Set file httpheaders
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) .

```java readme-sample-setFileHttpHeaders
ShareFileHttpHeaders httpHeaders = new ShareFileHttpHeaders().setContentType("text/plain");
fileClient.setProperties(1024, httpHeaders, null, null);
```

## Troubleshooting

## General

When you interact with file using this Java client library, errors returned by the service correspond to the same HTTP status codes returned for [REST API][storage_file_rest] requests. For example, if you try to retrieve a share that doesn't exist in your Storage Account, a `404` error is returned, indicating `Not Found`.

### Default HTTP Client
All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure
the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the
[HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).

### Default SSL library
All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL
operations. The Boring SSL library is an uber jar containing native libraries for Linux / macOS / Windows, and provides
better performance compared to the default SSL implementation within the JDK. For more information, including how to
reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.

## Next steps

## Contributing
This project welcomes contributions and suggestions.  Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request


[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-file-share/src/
[reference_docs]: https://azure.github.io/azure-sdk-for-java/
[rest_api_documentation]: https://learn.microsoft.com/rest/api/storageservices/file-service-rest-api
[storage_docs]: https://learn.microsoft.com/azure/storage/files/storage-files-introduction
[jdk]: https://learn.microsoft.com/java/azure/jdk/
[maven]: https://maven.apache.org/
[azure_subscription]: https://azure.microsoft.com/free/
[storage_account]: https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
[azure_cli]: https://learn.microsoft.com/cli/azure
[sas_token]: https://learn.microsoft.com/azure/storage/common/storage-dotnet-shared-access-signature-part-1
[RFC_URL_1]: https://www.ietf.org/rfc/rfc2616.txt
[RFL_URL_2]: https://www.ietf.org/rfc/rfc3987.txt
[csharp_identifiers]: https://learn.microsoft.com/dotnet/csharp/language-reference/
[storage_file_rest]: https://learn.microsoft.com/rest/api/storageservices/file-service-error-codes
[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-file-share/src/samples
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/blob/main/docs/performance-tuning.md


\ No newline at end of file
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
index 4f9c29bc7d9c..650ad933b7e3 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
@@ -12,6 +12,7 @@
 import com.azure.core.http.rest.PagedFlux;
 import com.azure.core.http.rest.PagedResponse;
 import com.azure.core.http.rest.PagedResponseBase;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.SimpleResponse;
 import com.azure.core.util.Context;
@@ -519,9 +520,10 @@ public Mono> createSnapshotWithResponse(Map> createSnapshotWithResponse(Map metadata, Context context) {
-        context = context == null ? Context.NONE : context;
+        Context finalContext = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = ModelHelper.createSnapshotRequestOptions(shareName, metadata, finalContext);
         return azureFileStorageClient.getShares()
-            .createSnapshotWithResponseAsync(shareName, null, metadata, context)
+            .createSnapshotWithResponseAsync(requestOptions)
             .map(ModelHelper::mapCreateSnapshotResponse);
     }
 
@@ -620,11 +622,13 @@ Mono> deleteWithResponse(ShareDeleteOptions options, Context cont
         options = options == null ? new ShareDeleteOptions() : options;
         ShareRequestConditions requestConditions
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
-        context = context == null ? Context.NONE : context;
-        return azureFileStorageClient.getShares()
-            .deleteNoCustomHeadersWithResponseAsync(shareName, snapshot, null,
-                ModelHelper.toDeleteSnapshotsOptionType(options.getDeleteSnapshotsOptions()),
-                requestConditions.getLeaseId(), context);
+        Context finalContext = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        ModelHelper.addSnapshot(requestOptions, snapshot);
+        ModelHelper.addDeleteSnapshotsHeader(requestOptions, options.getDeleteSnapshotsOptions());
+        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        return azureFileStorageClient.getShares().deleteWithResponseAsync(requestOptions);
     }
 
     /**
@@ -802,9 +806,13 @@ Mono> getPropertiesWithResponse(ShareGetPropertiesOpti
         options = options == null ? new ShareGetPropertiesOptions() : options;
         ShareRequestConditions requestConditions
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
-        context = context == null ? Context.NONE : context;
+        Context finalContext = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        ModelHelper.addSnapshot(requestOptions, snapshot);
+        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares()
-            .getPropertiesWithResponseAsync(shareName, snapshot, null, requestConditions.getLeaseId(), context)
+            .getPropertiesWithResponseAsync(requestOptions)
             .map(ModelHelper::mapGetPropertiesResponse);
     }
 
@@ -1062,10 +1070,13 @@ Mono> setMetadataWithResponse(ShareSetMetadataOptions option
         options = options == null ? new ShareSetMetadataOptions() : options;
         ShareRequestConditions requestConditions
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
-        context = context == null ? Context.NONE : context;
+        Context finalContext = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        ModelHelper.addMetadata(requestOptions, options.getMetadata());
+        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares()
-            .setMetadataNoCustomHeadersWithResponseAsync(shareName, null, options.getMetadata(),
-                requestConditions.getLeaseId(), context)
+            .setMetadataWithResponseAsync(requestOptions)
             .map(ModelHelper::mapToShareInfoResponse);
     }
 
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
index 5eddfa88edf7..03212bc37add 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
@@ -13,6 +13,7 @@
 import com.azure.core.http.rest.PagedIterable;
 import com.azure.core.http.rest.PagedResponse;
 import com.azure.core.http.rest.PagedResponseBase;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
@@ -26,7 +27,6 @@
 import com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper;
 import com.azure.storage.file.share.implementation.models.ShareStats;
 import com.azure.storage.file.share.implementation.models.SharesCreatePermissionHeaders;
-import com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders;
 import com.azure.storage.file.share.implementation.models.SharesGetAccessPolicyHeaders;
 import com.azure.storage.file.share.implementation.models.SharesGetPermissionHeaders;
 import com.azure.storage.file.share.implementation.models.SharesGetPropertiesHeaders;
@@ -505,8 +505,9 @@ public ShareSnapshotInfo createSnapshot() {
     public Response createSnapshotWithResponse(Map metadata, Duration timeout,
         Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        Callable> operation = () -> azureFileStorageClient.getShares()
-            .createSnapshotWithResponse(shareName, null, metadata, finalContext);
+        RequestOptions requestOptions = ModelHelper.createSnapshotRequestOptions(shareName, metadata, finalContext);
+        Callable> operation
+            = () -> azureFileStorageClient.getShares().createSnapshotWithResponse(requestOptions);
 
         return ModelHelper.mapCreateSnapshotResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -599,10 +600,13 @@ public Response deleteWithResponse(ShareDeleteOptions options, Duration ti
             ? new ShareRequestConditions()
             : finalOptions.getRequestConditions();
 
-        Callable> operation = () -> this.azureFileStorageClient.getShares()
-            .deleteNoCustomHeadersWithResponse(shareName, snapshot, null,
-                ModelHelper.toDeleteSnapshotsOptionType(finalOptions.getDeleteSnapshotsOptions()),
-                requestConditions.getLeaseId(), finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        ModelHelper.addSnapshot(requestOptions, snapshot);
+        ModelHelper.addDeleteSnapshotsHeader(requestOptions, finalOptions.getDeleteSnapshotsOptions());
+        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getShares().deleteWithResponse(requestOptions);
 
         return sendRequest(operation, timeout, ShareStorageException.class);
     }
@@ -768,8 +772,12 @@ public Response getPropertiesWithResponse(ShareGetPropertiesOpt
         Context finalContext = context == null ? Context.NONE : context;
         ShareRequestConditions requestConditions
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
-        Callable> operation = () -> azureFileStorageClient.getShares()
-            .getPropertiesWithResponse(shareName, snapshot, null, requestConditions.getLeaseId(), finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        ModelHelper.addSnapshot(requestOptions, snapshot);
+        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        Callable> operation
+            = () -> azureFileStorageClient.getShares().getPropertiesWithResponse(requestOptions);
 
         return ModelHelper.mapGetPropertiesResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -1015,9 +1023,12 @@ public Response setMetadataWithResponse(ShareSetMetadataOptions optio
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
         Context finalContext = context == null ? Context.NONE : context;
 
-        Callable> operation = () -> this.azureFileStorageClient.getShares()
-            .setMetadataNoCustomHeadersWithResponse(shareName, null, options.getMetadata(),
-                requestConditions.getLeaseId(), finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        ModelHelper.addMetadata(requestOptions, options.getMetadata());
+        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getShares().setMetadataWithResponse(requestOptions);
 
         return ModelHelper.mapToShareInfoResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java
index 198e6cdb2e76..076c00869967 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java
@@ -10,7 +10,7 @@
 import com.azure.core.http.policy.UserAgentPolicy;
 import com.azure.core.util.serializer.JacksonAdapter;
 import com.azure.core.util.serializer.SerializerAdapter;
-import com.azure.storage.file.share.FileServiceVersion;
+import com.azure.storage.file.share.ShareServiceVersion;
 import com.azure.storage.file.share.models.ShareTokenIntent;
 
 /**
@@ -76,14 +76,14 @@ public boolean isAllowSourceTrailingDot() {
     /**
      * Service version.
      */
-    private final FileServiceVersion serviceVersion;
+    private final ShareServiceVersion serviceVersion;
 
     /**
      * Gets Service version.
      * 
      * @return the serviceVersion value.
      */
-    public FileServiceVersion getServiceVersion() {
+    public ShareServiceVersion getServiceVersion() {
         return this.serviceVersion;
     }
 
@@ -181,7 +181,7 @@ public SharesImpl getShares() {
      * @param serviceVersion Service version.
      */
     public AzureFileStorageImpl(String url, ShareTokenIntent fileRequestIntent, boolean allowTrailingDot,
-        boolean allowSourceTrailingDot, FileServiceVersion serviceVersion) {
+        boolean allowSourceTrailingDot, ShareServiceVersion serviceVersion) {
         this(new HttpPipelineBuilder().policies(new UserAgentPolicy(), new RetryPolicy()).build(),
             JacksonAdapter.createDefaultSerializerAdapter(), url, fileRequestIntent, allowTrailingDot,
             allowSourceTrailingDot, serviceVersion);
@@ -198,7 +198,7 @@ public AzureFileStorageImpl(String url, ShareTokenIntent fileRequestIntent, bool
      * @param serviceVersion Service version.
      */
     public AzureFileStorageImpl(HttpPipeline httpPipeline, String url, ShareTokenIntent fileRequestIntent,
-        boolean allowTrailingDot, boolean allowSourceTrailingDot, FileServiceVersion serviceVersion) {
+        boolean allowTrailingDot, boolean allowSourceTrailingDot, ShareServiceVersion serviceVersion) {
         this(httpPipeline, JacksonAdapter.createDefaultSerializerAdapter(), url, fileRequestIntent, allowTrailingDot,
             allowSourceTrailingDot, serviceVersion);
     }
@@ -216,7 +216,7 @@ public AzureFileStorageImpl(HttpPipeline httpPipeline, String url, ShareTokenInt
      */
     public AzureFileStorageImpl(HttpPipeline httpPipeline, SerializerAdapter serializerAdapter, String url,
         ShareTokenIntent fileRequestIntent, boolean allowTrailingDot, boolean allowSourceTrailingDot,
-        FileServiceVersion serviceVersion) {
+        ShareServiceVersion serviceVersion) {
         this.httpPipeline = httpPipeline;
         this.serializerAdapter = serializerAdapter;
         this.url = url;
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
index 18dbd16d7103..014554abb528 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
@@ -28,7 +28,7 @@
 import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.FluxUtil;
-import com.azure.storage.file.share.FileServiceVersion;
+import com.azure.storage.file.share.ShareServiceVersion;
 import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
 import com.azure.storage.file.share.models.ShareTokenIntent;
@@ -68,7 +68,7 @@ public final class DirectoriesImpl {
      *
      * @return the serviceVersion value.
      */
-    public FileServiceVersion getServiceVersion() {
+    public ShareServiceVersion getServiceVersion() {
         try {
             return client.getServiceVersion();
         } catch (ShareStorageExceptionInternal internalException) {
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
index 02fede0b8c72..49ce20f242b3 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
@@ -31,7 +31,7 @@
 import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.FluxUtil;
-import com.azure.storage.file.share.FileServiceVersion;
+import com.azure.storage.file.share.ShareServiceVersion;
 import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
 import com.azure.storage.file.share.models.ShareTokenIntent;
@@ -70,7 +70,7 @@ public final class FilesImpl {
      *
      * @return the serviceVersion value.
      */
-    public FileServiceVersion getServiceVersion() {
+    public ShareServiceVersion getServiceVersion() {
         try {
             return client.getServiceVersion();
         } catch (ShareStorageExceptionInternal internalException) {
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
index b3286333cd98..bdde12394a4c 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
@@ -29,7 +29,7 @@
 import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.FluxUtil;
-import com.azure.storage.file.share.FileServiceVersion;
+import com.azure.storage.file.share.ShareServiceVersion;
 import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
 import com.azure.storage.file.share.models.ShareTokenIntent;
@@ -68,7 +68,7 @@ public final class ServicesImpl {
      *
      * @return the serviceVersion value.
      */
-    public FileServiceVersion getServiceVersion() {
+    public ShareServiceVersion getServiceVersion() {
         try {
             return client.getServiceVersion();
         } catch (ShareStorageExceptionInternal internalException) {
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java
index a40357bdbde3..716d79980157 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java
@@ -22,17 +22,14 @@
 import com.azure.core.http.HttpHeaderName;
 import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
-import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.RestProxy;
 import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.FluxUtil;
-import com.azure.storage.file.share.FileServiceVersion;
+import com.azure.storage.file.share.ShareServiceVersion;
 import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal;
-import com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
 import com.azure.storage.file.share.models.ShareTokenIntent;
-import java.util.Map;
 import reactor.core.publisher.Mono;
 
 /**
@@ -65,7 +62,7 @@ public final class SharesImpl {
      *
      * @return the serviceVersion value.
      */
-    public FileServiceVersion getServiceVersion() {
+    public ShareServiceVersion getServiceVersion() {
         try {
             return client.getServiceVersion();
         } catch (ShareStorageExceptionInternal internalException) {
@@ -1910,43 +1907,4 @@ public Response restoreWithResponse(RequestOptions requestOptions) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
     }
-
-    public Mono> createSnapshotWithResponseAsync(String shareName,
-        Integer timeout, Map metadata, Context context) {
-        RequestOptions requestOptions = buildCreateSnapshotRequestOptions(timeout, metadata);
-        String url = this.client.getUrl() + "/" + shareName;
-        return service
-            .createSnapshot(url, this.client.getServiceVersion().getVersion(), this.client.getFileRequestIntent(),
-                requestOptions, context)
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
-            .map(response -> new ResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                response.getValue(), new SharesCreateSnapshotHeaders(response.getHeaders())));
-    }
-
-    public ResponseBase createSnapshotWithResponse(String shareName, Integer timeout,
-        Map metadata, Context context) {
-        RequestOptions requestOptions = buildCreateSnapshotRequestOptions(timeout, metadata);
-        String url = this.client.getUrl() + "/" + shareName;
-        try {
-            Response response = service.createSnapshotSync(url, this.client.getServiceVersion().getVersion(),
-                this.client.getFileRequestIntent(), requestOptions, context);
-            return new ResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                response.getValue(), new SharesCreateSnapshotHeaders(response.getHeaders()));
-        } catch (ShareStorageExceptionInternal internalException) {
-            throw ModelHelper.mapToShareStorageException(internalException);
-        }
-    }
-
-    private static RequestOptions buildCreateSnapshotRequestOptions(Integer timeout, Map metadata) {
-        RequestOptions requestOptions = new RequestOptions();
-        if (timeout != null) {
-            requestOptions.addQueryParam("timeout", String.valueOf(timeout));
-        }
-        if (metadata != null) {
-            for (Map.Entry entry : metadata.entrySet()) {
-                requestOptions.setHeader(HttpHeaderName.fromString("x-ms-meta-" + entry.getKey()), entry.getValue());
-            }
-        }
-        return requestOptions;
-    }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java
index e6708f44d46f..c9aa0345de45 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java
@@ -1,11 +1,11 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
-// Code generated by Microsoft (R) AutoRest Code Generator.
+// Code generated by Microsoft (R) TypeSpec Code Generator.
 
 package com.azure.storage.file.share.implementation.models;
 
-import com.azure.core.annotation.Fluent;
 import com.azure.core.annotation.Generated;
+import com.azure.core.annotation.Immutable;
 import com.azure.core.http.HttpHeaderName;
 import com.azure.core.http.HttpHeaders;
 import com.azure.core.util.DateTimeRfc1123;
@@ -14,43 +14,49 @@
 /**
  * The SharesCreateSnapshotHeaders model.
  */
-@Fluent
+@Immutable
 public final class SharesCreateSnapshotHeaders {
     /*
-     * The x-ms-snapshot property.
+     * The ETag property.
      */
     @Generated
-    private String xMsSnapshot;
+    private final String etag;
 
     /*
-     * The ETag property.
+     * The Last-Modified property.
      */
     @Generated
-    private String eTag;
+    private final DateTimeRfc1123 lastModified;
 
     /*
-     * The Last-Modified property.
+     * The x-ms-snapshot property.
      */
     @Generated
-    private DateTimeRfc1123 lastModified;
+    private final String snapshot;
+
+    /*
+     * The x-ms-version property.
+     */
+    @Generated
+    private final String version;
 
     /*
      * The x-ms-request-id property.
      */
     @Generated
-    private String xMsRequestId;
+    private final String requestId;
 
     /*
-     * The x-ms-version property.
+     * The x-ms-client-request-id property.
      */
     @Generated
-    private String xMsVersion;
+    private final String clientRequestId;
 
     /*
      * The Date property.
      */
     @Generated
-    private DateTimeRfc1123 date;
+    private final DateTimeRfc1123 date;
 
     private static final HttpHeaderName X_MS_SNAPSHOT = HttpHeaderName.fromString("x-ms-snapshot");
 
@@ -63,16 +69,17 @@ public final class SharesCreateSnapshotHeaders {
      * @param rawHeaders The raw HttpHeaders that will be used to create the property values.
      */
     public SharesCreateSnapshotHeaders(HttpHeaders rawHeaders) {
-        this.xMsSnapshot = rawHeaders.getValue(X_MS_SNAPSHOT);
-        this.eTag = rawHeaders.getValue(HttpHeaderName.ETAG);
+        this.etag = rawHeaders.getValue(HttpHeaderName.ETAG);
         String lastModified = rawHeaders.getValue(HttpHeaderName.LAST_MODIFIED);
         if (lastModified != null) {
             this.lastModified = new DateTimeRfc1123(lastModified);
         } else {
             this.lastModified = null;
         }
-        this.xMsRequestId = rawHeaders.getValue(HttpHeaderName.X_MS_REQUEST_ID);
-        this.xMsVersion = rawHeaders.getValue(X_MS_VERSION);
+        this.snapshot = rawHeaders.getValue(X_MS_SNAPSHOT);
+        this.version = rawHeaders.getValue(X_MS_VERSION);
+        this.requestId = rawHeaders.getValue(HttpHeaderName.X_MS_REQUEST_ID);
+        this.clientRequestId = rawHeaders.getValue(HttpHeaderName.X_MS_CLIENT_REQUEST_ID);
         String date = rawHeaders.getValue(HttpHeaderName.DATE);
         if (date != null) {
             this.date = new DateTimeRfc1123(date);
@@ -82,47 +89,13 @@ public SharesCreateSnapshotHeaders(HttpHeaders rawHeaders) {
     }
 
     /**
-     * Get the xMsSnapshot property: The x-ms-snapshot property.
-     * 
-     * @return the xMsSnapshot value.
-     */
-    @Generated
-    public String getXMsSnapshot() {
-        return this.xMsSnapshot;
-    }
-
-    /**
-     * Set the xMsSnapshot property: The x-ms-snapshot property.
-     * 
-     * @param xMsSnapshot the xMsSnapshot value to set.
-     * @return the SharesCreateSnapshotHeaders object itself.
-     */
-    @Generated
-    public SharesCreateSnapshotHeaders setXMsSnapshot(String xMsSnapshot) {
-        this.xMsSnapshot = xMsSnapshot;
-        return this;
-    }
-
-    /**
-     * Get the eTag property: The ETag property.
-     * 
-     * @return the eTag value.
-     */
-    @Generated
-    public String getETag() {
-        return this.eTag;
-    }
-
-    /**
-     * Set the eTag property: The ETag property.
+     * Get the etag property: The ETag property.
      * 
-     * @param eTag the eTag value to set.
-     * @return the SharesCreateSnapshotHeaders object itself.
+     * @return the etag value.
      */
     @Generated
-    public SharesCreateSnapshotHeaders setETag(String eTag) {
-        this.eTag = eTag;
-        return this;
+    public String getEtag() {
+        return this.etag;
     }
 
     /**
@@ -139,63 +112,43 @@ public OffsetDateTime getLastModified() {
     }
 
     /**
-     * Set the lastModified property: The Last-Modified property.
+     * Get the snapshot property: The x-ms-snapshot property.
      * 
-     * @param lastModified the lastModified value to set.
-     * @return the SharesCreateSnapshotHeaders object itself.
+     * @return the snapshot value.
      */
     @Generated
-    public SharesCreateSnapshotHeaders setLastModified(OffsetDateTime lastModified) {
-        if (lastModified == null) {
-            this.lastModified = null;
-        } else {
-            this.lastModified = new DateTimeRfc1123(lastModified);
-        }
-        return this;
+    public String getSnapshot() {
+        return this.snapshot;
     }
 
     /**
-     * Get the xMsRequestId property: The x-ms-request-id property.
+     * Get the version property: The x-ms-version property.
      * 
-     * @return the xMsRequestId value.
+     * @return the version value.
      */
     @Generated
-    public String getXMsRequestId() {
-        return this.xMsRequestId;
+    public String getVersion() {
+        return this.version;
     }
 
     /**
-     * Set the xMsRequestId property: The x-ms-request-id property.
+     * Get the requestId property: The x-ms-request-id property.
      * 
-     * @param xMsRequestId the xMsRequestId value to set.
-     * @return the SharesCreateSnapshotHeaders object itself.
+     * @return the requestId value.
      */
     @Generated
-    public SharesCreateSnapshotHeaders setXMsRequestId(String xMsRequestId) {
-        this.xMsRequestId = xMsRequestId;
-        return this;
+    public String getRequestId() {
+        return this.requestId;
     }
 
     /**
-     * Get the xMsVersion property: The x-ms-version property.
+     * Get the clientRequestId property: The x-ms-client-request-id property.
      * 
-     * @return the xMsVersion value.
+     * @return the clientRequestId value.
      */
     @Generated
-    public String getXMsVersion() {
-        return this.xMsVersion;
-    }
-
-    /**
-     * Set the xMsVersion property: The x-ms-version property.
-     * 
-     * @param xMsVersion the xMsVersion value to set.
-     * @return the SharesCreateSnapshotHeaders object itself.
-     */
-    @Generated
-    public SharesCreateSnapshotHeaders setXMsVersion(String xMsVersion) {
-        this.xMsVersion = xMsVersion;
-        return this;
+    public String getClientRequestId() {
+        return this.clientRequestId;
     }
 
     /**
@@ -210,20 +163,4 @@ public OffsetDateTime getDate() {
         }
         return this.date.getDateTime();
     }
-
-    /**
-     * Set the date property: The Date property.
-     * 
-     * @param date the date value to set.
-     * @return the SharesCreateSnapshotHeaders object itself.
-     */
-    @Generated
-    public SharesCreateSnapshotHeaders setDate(OffsetDateTime date) {
-        if (date == null) {
-            this.date = null;
-        } else {
-            this.date = new DateTimeRfc1123(date);
-        }
-        return this;
-    }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
index a6830e7cb854..05cb1949c328 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
@@ -6,10 +6,13 @@
 import com.azure.core.exception.HttpResponseException;
 import com.azure.core.http.HttpHeaderName;
 import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
+import com.azure.core.util.Context;
 import com.azure.core.util.DateTimeRfc1123;
+import com.azure.core.util.UrlBuilder;
 import com.azure.core.util.logging.ClientLogger;
 import com.azure.core.util.polling.LongRunningOperationStatus;
 import com.azure.storage.common.ParallelTransferOptions;
@@ -48,7 +51,6 @@
 import com.azure.storage.file.share.implementation.models.SharePropertiesInternal;
 import com.azure.storage.file.share.implementation.models.ShareStats;
 import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal;
-import com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders;
 import com.azure.storage.file.share.implementation.models.SharesGetPropertiesHeaders;
 import com.azure.storage.file.share.implementation.models.StringEncoded;
 import com.azure.storage.file.share.models.ClearRange;
@@ -494,9 +496,8 @@ public static Response mapToShareInfoResponse(Response response) {
             new ShareInfo(eTag, lastModified));
     }
 
-    public static Response
-        mapGetPropertiesResponse(ResponseBase response) {
-        SharesGetPropertiesHeaders headers = response.getDeserializedHeaders();
+    public static Response mapGetPropertiesResponse(Response response) {
+        SharesGetPropertiesHeaders headers = new SharesGetPropertiesHeaders(response.getHeaders());
         ShareProperties shareProperties = new ShareProperties().setETag(headers.getETag())
             .setLastModified(headers.getLastModified())
             .setMetadata(headers.getXMsMeta())
@@ -559,11 +560,74 @@ public static Response mapGetStatisticsResponse(Response(response, shareFileUploadRangeFromUrlInfo);
     }
 
-    public static Response
-        mapCreateSnapshotResponse(ResponseBase response) {
-        SharesCreateSnapshotHeaders headers = response.getDeserializedHeaders();
-        ShareSnapshotInfo snapshotInfo
-            = new ShareSnapshotInfo(headers.getXMsSnapshot(), headers.getETag(), headers.getLastModified());
+    private static final HttpHeaderName X_MS_SNAPSHOT = HttpHeaderName.fromString("x-ms-snapshot");
+
+    /**
+     * Builds the {@link RequestOptions} for a share-scoped operation whose only inputs are optional metadata: sets the
+     * x-ms-meta-* headers and re-scopes the account-scoped request URL to the share resource.
+     */
+    public static RequestOptions createSnapshotRequestOptions(String shareName, Map metadata,
+        Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addMetadata(requestOptions, metadata);
+        scopeRequestToResourcePath(requestOptions, shareName);
+        return requestOptions;
+    }
+
+    /**
+     * The generated protocol methods target the account-scoped service URL; this appends the resource path (e.g.
+     * "{shareName}" or "{shareName}/{filePath}") to the request URL while preserving the route's query parameters.
+     */
+    public static void scopeRequestToResourcePath(RequestOptions requestOptions, String resourcePath) {
+        requestOptions.addRequestCallback(request -> {
+            UrlBuilder urlBuilder = UrlBuilder.parse(request.getUrl());
+            urlBuilder.setPath(resourcePath);
+            try {
+                request.setUrl(urlBuilder.toUrl());
+            } catch (java.net.MalformedURLException e) {
+                throw new IllegalStateException(e);
+            }
+        });
+    }
+
+    /** Adds the {@code x-ms-lease-id} header when a lease id is present. */
+    public static void addLeaseId(RequestOptions requestOptions, String leaseId) {
+        if (leaseId != null) {
+            requestOptions.setHeader(HttpHeaderName.fromString("x-ms-lease-id"), leaseId);
+        }
+    }
+
+    /** Adds the {@code sharesnapshot} query parameter when a snapshot is present. */
+    public static void addSnapshot(RequestOptions requestOptions, String snapshot) {
+        if (snapshot != null) {
+            requestOptions.addQueryParam("sharesnapshot", snapshot);
+        }
+    }
+
+    /** Adds the {@code x-ms-meta-*} headers for each metadata entry. */
+    public static void addMetadata(RequestOptions requestOptions, Map metadata) {
+        if (metadata != null) {
+            for (Map.Entry entry : metadata.entrySet()) {
+                requestOptions.setHeader(HttpHeaderName.fromString("x-ms-meta-" + entry.getKey()), entry.getValue());
+            }
+        }
+    }
+
+    /** Adds the {@code x-ms-delete-snapshots} header when a delete-snapshots option is present. */
+    public static void addDeleteSnapshotsHeader(RequestOptions requestOptions, ShareSnapshotsDeleteOptionType option) {
+        DeleteSnapshotsOptionType deleteSnapshots = toDeleteSnapshotsOptionType(option);
+        if (deleteSnapshots != null) {
+            requestOptions.setHeader(HttpHeaderName.fromString("x-ms-delete-snapshots"), deleteSnapshots.toString());
+        }
+    }
+
+    public static Response mapCreateSnapshotResponse(Response response) {
+        HttpHeaders headers = response.getHeaders();
+        String lastModifiedString = headers.getValue(HttpHeaderName.LAST_MODIFIED);
+        OffsetDateTime lastModified
+            = lastModifiedString == null ? null : new DateTimeRfc1123(lastModifiedString).getDateTime();
+        ShareSnapshotInfo snapshotInfo = new ShareSnapshotInfo(headers.getValue(X_MS_SNAPSHOT),
+            headers.getValue(HttpHeaderName.ETAG), lastModified);
 
         return new SimpleResponse<>(response, snapshotInfo);
     }
diff --git a/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json b/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
index 0e919fe66ef0..0ba66f2c3cab 100644
--- a/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
+++ b/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
@@ -1 +1 @@
-{"flavor":"azure","apiVersions":{"Storage.File":"2026-12-06"},"crossLanguagePackageId":"Storage.File","crossLanguageVersion":"5d929a4c3464","crossLanguageDefinitions":{"com.azure.storage.file.share.AzureFileStorageBuilder":"Storage.File","com.azure.storage.file.share.DirectoryAsyncClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryAsyncClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryAsyncClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryAsyncClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.FileAsyncClient":"Storage.File.File","com.azure.storage.file.share.FileAsyncClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileAsyncClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileAsyncClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient":"Storage.File.File","com.azure.storage.file.share.FileClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.ServiceAsyncClient":"Storage.File.Service","com.azure.storage.file.share.ServiceAsyncClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceAsyncClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceAsyncClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient":"Storage.File.Service","com.azure.storage.file.share.ServiceClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ShareAsyncClient":"Storage.File.Share","com.azure.storage.file.share.ShareAsyncClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareAsyncClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient":"Storage.File.Share","com.azure.storage.file.share.ShareClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType":"Storage.File.DeleteSnapshotsOptionType","com.azure.storage.file.share.implementation.models.DirectoryItem":"Storage.File.DirectoryItem","com.azure.storage.file.share.implementation.models.FileItem":"Storage.File.FileItem","com.azure.storage.file.share.implementation.models.FileProperty":"Storage.File.FileProperty","com.azure.storage.file.share.implementation.models.FilesAndDirectoriesListSegment":"Storage.File.FilesAndDirectoriesListSegment","com.azure.storage.file.share.implementation.models.HandleItem":"Storage.File.HandleItem","com.azure.storage.file.share.implementation.models.KeyInfo":"Storage.File.KeyInfo","com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse":"Storage.File.ListFilesAndDirectoriesSegmentResponse","com.azure.storage.file.share.implementation.models.ListFilesIncludeType":"Storage.File.ListFilesIncludeType","com.azure.storage.file.share.implementation.models.ListSharesIncludeType":"Storage.File.ListSharesIncludeType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteFromUrlType":"Storage.File.FileRangeWriteFromUrlType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType":"Storage.File.FileRangeWriteType","com.azure.storage.file.share.implementation.models.ShareItemInternal":"Storage.File.ShareItemInternal","com.azure.storage.file.share.implementation.models.SharePermission":"Storage.File.SharePermission","com.azure.storage.file.share.implementation.models.SharePropertiesInternal":"Storage.File.SharePropertiesInternal","com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper":"Storage.File.SignedIdentifiers","com.azure.storage.file.share.implementation.models.ShareStats":"Storage.File.ShareStats","com.azure.storage.file.share.implementation.models.StringEncoded":"Storage.File.StringEncoded","com.azure.storage.file.share.models.ClearRange":"Storage.File.ClearRange","com.azure.storage.file.share.models.FileLastWrittenMode":"Storage.File.FileLastWrittenMode","com.azure.storage.file.share.models.FilePermissionFormat":"Storage.File.FilePermissionFormat","com.azure.storage.file.share.models.FilePropertySemantics":"Storage.File.FilePropertySemantics","com.azure.storage.file.share.models.FileRange":"Storage.File.FileRange","com.azure.storage.file.share.models.LeaseDurationType":"Storage.File.LeaseDurationType","com.azure.storage.file.share.models.LeaseStateType":"Storage.File.LeaseStateType","com.azure.storage.file.share.models.LeaseStatusType":"Storage.File.LeaseStatusType","com.azure.storage.file.share.models.ModeCopyMode":"Storage.File.ModeCopyMode","com.azure.storage.file.share.models.NfsFileType":"Storage.File.NfsFileType","com.azure.storage.file.share.models.OwnerCopyMode":"Storage.File.OwnerCopyMode","com.azure.storage.file.share.models.PermissionCopyModeType":"Storage.File.PermissionCopyModeType","com.azure.storage.file.share.models.ShareAccessPolicy":"Storage.File.AccessPolicy","com.azure.storage.file.share.models.ShareAccessTier":"Storage.File.ShareAccessTier","com.azure.storage.file.share.models.ShareCorsRule":"Storage.File.CorsRule","com.azure.storage.file.share.models.ShareFileHandleAccessRights":"Storage.File.AccessRight","com.azure.storage.file.share.models.ShareFileRangeList":"Storage.File.ShareFileRangeList","com.azure.storage.file.share.models.ShareMetrics":"Storage.File.Metrics","com.azure.storage.file.share.models.ShareNfsSettings":"Storage.File.ShareNfsSettings","com.azure.storage.file.share.models.ShareNfsSettingsEncryptionInTransit":"Storage.File.ShareNfsSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareProtocolSettings":"Storage.File.ShareProtocolSettings","com.azure.storage.file.share.models.ShareRetentionPolicy":"Storage.File.RetentionPolicy","com.azure.storage.file.share.models.ShareRootSquash":"Storage.File.ShareRootSquash","com.azure.storage.file.share.models.ShareServiceProperties":"Storage.File.StorageServiceProperties","com.azure.storage.file.share.models.ShareSignedIdentifier":"Storage.File.SignedIdentifier","com.azure.storage.file.share.models.ShareSmbSettings":"Storage.File.ShareSmbSettings","com.azure.storage.file.share.models.ShareSmbSettingsEncryptionInTransit":"Storage.File.ShareSmbSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareTokenIntent":"Storage.File.ShareTokenIntent","com.azure.storage.file.share.models.SmbMultichannel":"Storage.File.SmbMultichannel","com.azure.storage.file.share.models.UserDelegationKey":"Storage.File.UserDelegationKey"},"generatedFiles":["src/main/java/com/azure/storage/file/share/AzureFileStorageBuilder.java","src/main/java/com/azure/storage/file/share/DirectoryAsyncClient.java","src/main/java/com/azure/storage/file/share/DirectoryClient.java","src/main/java/com/azure/storage/file/share/FileAsyncClient.java","src/main/java/com/azure/storage/file/share/FileClient.java","src/main/java/com/azure/storage/file/share/FileServiceVersion.java","src/main/java/com/azure/storage/file/share/ServiceAsyncClient.java","src/main/java/com/azure/storage/file/share/ServiceClient.java","src/main/java/com/azure/storage/file/share/ShareAsyncClient.java","src/main/java/com/azure/storage/file/share/ShareClient.java","src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java","src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java","src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java","src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java","src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java","src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java","src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java","src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java","src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java","src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java","src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java","src/main/java/com/azure/storage/file/share/implementation/models/package-info.java","src/main/java/com/azure/storage/file/share/implementation/package-info.java","src/main/java/com/azure/storage/file/share/models/ClearRange.java","src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java","src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java","src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java","src/main/java/com/azure/storage/file/share/models/FileRange.java","src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java","src/main/java/com/azure/storage/file/share/models/LeaseStateType.java","src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java","src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java","src/main/java/com/azure/storage/file/share/models/NfsFileType.java","src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java","src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java","src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java","src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java","src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java","src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java","src/main/java/com/azure/storage/file/share/models/ShareMetrics.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java","src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java","src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java","src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java","src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java","src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java","src/main/java/com/azure/storage/file/share/models/package-info.java","src/main/java/com/azure/storage/file/share/package-info.java","src/main/java/module-info.java"]}
\ No newline at end of file
+{"flavor":"azure","apiVersions":{"Storage.File":"2026-12-06"},"crossLanguagePackageId":"Storage.File","crossLanguageVersion":"08484259fcf5","crossLanguageDefinitions":{"com.azure.storage.file.share.AzureFileStorageBuilder":"Storage.File","com.azure.storage.file.share.DirectoryAsyncClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryAsyncClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryAsyncClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryAsyncClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.FileAsyncClient":"Storage.File.File","com.azure.storage.file.share.FileAsyncClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileAsyncClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileAsyncClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient":"Storage.File.File","com.azure.storage.file.share.FileClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.ServiceAsyncClient":"Storage.File.Service","com.azure.storage.file.share.ServiceAsyncClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceAsyncClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceAsyncClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient":"Storage.File.Service","com.azure.storage.file.share.ServiceClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ShareAsyncClient":"Storage.File.Share","com.azure.storage.file.share.ShareAsyncClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareAsyncClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient":"Storage.File.Share","com.azure.storage.file.share.ShareClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType":"Storage.File.DeleteSnapshotsOptionType","com.azure.storage.file.share.implementation.models.DirectoryItem":"Storage.File.DirectoryItem","com.azure.storage.file.share.implementation.models.FileItem":"Storage.File.FileItem","com.azure.storage.file.share.implementation.models.FileProperty":"Storage.File.FileProperty","com.azure.storage.file.share.implementation.models.FilesAndDirectoriesListSegment":"Storage.File.FilesAndDirectoriesListSegment","com.azure.storage.file.share.implementation.models.HandleItem":"Storage.File.HandleItem","com.azure.storage.file.share.implementation.models.KeyInfo":"Storage.File.KeyInfo","com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse":"Storage.File.ListFilesAndDirectoriesSegmentResponse","com.azure.storage.file.share.implementation.models.ListFilesIncludeType":"Storage.File.ListFilesIncludeType","com.azure.storage.file.share.implementation.models.ListSharesIncludeType":"Storage.File.ListSharesIncludeType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteFromUrlType":"Storage.File.FileRangeWriteFromUrlType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType":"Storage.File.FileRangeWriteType","com.azure.storage.file.share.implementation.models.ShareItemInternal":"Storage.File.ShareItemInternal","com.azure.storage.file.share.implementation.models.SharePermission":"Storage.File.SharePermission","com.azure.storage.file.share.implementation.models.SharePropertiesInternal":"Storage.File.SharePropertiesInternal","com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper":"Storage.File.SignedIdentifiers","com.azure.storage.file.share.implementation.models.ShareStats":"Storage.File.ShareStats","com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders":null,"com.azure.storage.file.share.implementation.models.StringEncoded":"Storage.File.StringEncoded","com.azure.storage.file.share.models.ClearRange":"Storage.File.ClearRange","com.azure.storage.file.share.models.FileLastWrittenMode":"Storage.File.FileLastWrittenMode","com.azure.storage.file.share.models.FilePermissionFormat":"Storage.File.FilePermissionFormat","com.azure.storage.file.share.models.FilePropertySemantics":"Storage.File.FilePropertySemantics","com.azure.storage.file.share.models.FileRange":"Storage.File.FileRange","com.azure.storage.file.share.models.LeaseDurationType":"Storage.File.LeaseDurationType","com.azure.storage.file.share.models.LeaseStateType":"Storage.File.LeaseStateType","com.azure.storage.file.share.models.LeaseStatusType":"Storage.File.LeaseStatusType","com.azure.storage.file.share.models.ModeCopyMode":"Storage.File.ModeCopyMode","com.azure.storage.file.share.models.NfsFileType":"Storage.File.NfsFileType","com.azure.storage.file.share.models.OwnerCopyMode":"Storage.File.OwnerCopyMode","com.azure.storage.file.share.models.PermissionCopyModeType":"Storage.File.PermissionCopyModeType","com.azure.storage.file.share.models.ShareAccessPolicy":"Storage.File.AccessPolicy","com.azure.storage.file.share.models.ShareAccessTier":"Storage.File.ShareAccessTier","com.azure.storage.file.share.models.ShareCorsRule":"Storage.File.CorsRule","com.azure.storage.file.share.models.ShareFileHandleAccessRights":"Storage.File.AccessRight","com.azure.storage.file.share.models.ShareFileRangeList":"Storage.File.ShareFileRangeList","com.azure.storage.file.share.models.ShareMetrics":"Storage.File.Metrics","com.azure.storage.file.share.models.ShareNfsSettings":"Storage.File.ShareNfsSettings","com.azure.storage.file.share.models.ShareNfsSettingsEncryptionInTransit":"Storage.File.ShareNfsSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareProtocolSettings":"Storage.File.ShareProtocolSettings","com.azure.storage.file.share.models.ShareRetentionPolicy":"Storage.File.RetentionPolicy","com.azure.storage.file.share.models.ShareRootSquash":"Storage.File.ShareRootSquash","com.azure.storage.file.share.models.ShareServiceProperties":"Storage.File.StorageServiceProperties","com.azure.storage.file.share.models.ShareSignedIdentifier":"Storage.File.SignedIdentifier","com.azure.storage.file.share.models.ShareSmbSettings":"Storage.File.ShareSmbSettings","com.azure.storage.file.share.models.ShareSmbSettingsEncryptionInTransit":"Storage.File.ShareSmbSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareTokenIntent":"Storage.File.ShareTokenIntent","com.azure.storage.file.share.models.SmbMultichannel":"Storage.File.SmbMultichannel","com.azure.storage.file.share.models.UserDelegationKey":"Storage.File.UserDelegationKey"},"generatedFiles":["src/main/java/com/azure/storage/file/share/AzureFileStorageBuilder.java","src/main/java/com/azure/storage/file/share/DirectoryAsyncClient.java","src/main/java/com/azure/storage/file/share/DirectoryClient.java","src/main/java/com/azure/storage/file/share/FileAsyncClient.java","src/main/java/com/azure/storage/file/share/FileClient.java","src/main/java/com/azure/storage/file/share/FileServiceVersion.java","src/main/java/com/azure/storage/file/share/ServiceAsyncClient.java","src/main/java/com/azure/storage/file/share/ServiceClient.java","src/main/java/com/azure/storage/file/share/ShareAsyncClient.java","src/main/java/com/azure/storage/file/share/ShareClient.java","src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java","src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java","src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java","src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java","src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java","src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java","src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java","src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java","src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java","src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java","src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java","src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java","src/main/java/com/azure/storage/file/share/implementation/models/package-info.java","src/main/java/com/azure/storage/file/share/implementation/package-info.java","src/main/java/com/azure/storage/file/share/models/ClearRange.java","src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java","src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java","src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java","src/main/java/com/azure/storage/file/share/models/FileRange.java","src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java","src/main/java/com/azure/storage/file/share/models/LeaseStateType.java","src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java","src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java","src/main/java/com/azure/storage/file/share/models/NfsFileType.java","src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java","src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java","src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java","src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java","src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java","src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java","src/main/java/com/azure/storage/file/share/models/ShareMetrics.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java","src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java","src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java","src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java","src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java","src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java","src/main/java/com/azure/storage/file/share/models/package-info.java","src/main/java/com/azure/storage/file/share/package-info.java","src/main/java/module-info.java"]}
\ No newline at end of file
diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
index ff9c8de0532d..1160579425f3 100644
--- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
+++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
@@ -68,10 +68,17 @@ public class ShareStorageCustomization extends Customization {
         "src/main/java/com/azure/storage/file/share/models/package-info.java",
         "src/main/java/com/azure/storage/file/share/implementation/package-info.java");
 
+    // Generated implementation classes typed to the generated FileServiceVersion enum, which is deleted (above) in
+    // favor of the hand-written public ShareServiceVersion. These are retyped to ShareServiceVersion after generation.
+    private static final List IMPLS_USING_SERVICE_VERSION
+        = Arrays.asList("AzureFileStorageImpl", "DirectoriesImpl", "FilesImpl", "ServicesImpl", "SharesImpl");
+
     @Override
     public void customize(LibraryCustomization customization, Logger logger) {
         removeGeneratedConvenienceClients(customization, logger);
 
+        retypeServiceVersionToShareServiceVersion(customization, logger);
+
         restoreFluentModels(customization, logger);
 
         customization.getClass("com.azure.storage.file.share.models", "ShareTokenIntent")
@@ -81,10 +88,6 @@ public void customize(LibraryCustomization customization, Logger logger) {
                     + "required RBAC permission.")));
 
         updateImplToMapInternalException(customization.getPackage("com.azure.storage.file.share.implementation"));
-
-        // Must run AFTER updateImplToMapInternalException so the typed wrappers added here are not walked
-        // (and double-wrapped) by that pass. Wrappers embed their own error mapping.
-        addTypedImplWrappers(customization, logger);
     }
 
     /**
@@ -108,6 +111,29 @@ private static void removeGeneratedConvenienceClients(LibraryCustomization custo
         }
     }
 
+    /**
+     * Retypes the generated {@code implementation/*Impl} classes from the generated {@code FileServiceVersion} enum
+     * (deleted by {@link #removeGeneratedConvenienceClients}) to the hand-written public
+     * {@code com.azure.storage.file.share.ShareServiceVersion}. Both enums live in {@code com.azure.storage.file.share}
+     * and share the same shape ({@code implements ServiceVersion}, {@code getVersion()}, {@code getLatest()}), so
+     * replacing the type token is safe; it also aligns the impl constructors with the {@code ShareServiceVersion} the
+     * hand-written builders pass.
+     *
+     * @param customization The library customization.
+     * @param logger The logger.
+     */
+    private static void retypeServiceVersionToShareServiceVersion(LibraryCustomization customization, Logger logger) {
+        Editor editor = customization.getRawEditor();
+        for (String implName : IMPLS_USING_SERVICE_VERSION) {
+            String path = PKG_ROOT + "implementation/" + implName + ".java";
+            String content = editor.getFileContent(path);
+            if (content.contains("FileServiceVersion")) {
+                editor.replaceFile(path, content.replace("FileServiceVersion", "ShareServiceVersion"));
+                logger.info("Retyped FileServiceVersion -> ShareServiceVersion in {}", path);
+            }
+        }
+    }
+
     /**
      * Restores the "fluent" shape of models that shipped as {@code @Fluent} (public no-arg constructor + setters)
      * before the TypeSpec migration. With {@code required-fields-as-ctor-args: true} (which must stay true so new
@@ -229,102 +255,6 @@ private static int indexOfGetter(NodeList> members, String fi
         return -1;
     }
 
-    /**
-     * Adds typed convenience overloads on the generated {@code *Impl} classes that mirror the shape emitted by the
-     * pre-migration swagger {@code generate-client-as-impl} code (typed parameters + {@code ResponseBase}
-     * return type). typespec-java only emits protocol methods
-     * ({@code xxxWithResponse[Async](RequestOptions) -> Response/BinaryData}) which discard typed
-     * response headers and drop the typed request parameters. The shipped hand-written {@code Share*} clients rely on
-     * the swagger-shaped signatures, so this method reinstates them per the TypeSpec team's interim guidance:
-     * "a manual mapping can be added from the implementation layer {@code Response} to
-     * {@code ResponseBase}." Each wrapper builds a {@link RequestOptions} from its
-     * typed parameters, calls the generated {@code service} proxy directly with a share-scoped URL, maps the raw
-     * response into a typed {@code ResponseBase} using the {@code *Headers} constructor that consumes the raw
-     * {@link com.azure.core.http.HttpHeaders}, and applies {@code ShareStorageExceptionInternal} error mapping.
-     * 

-     * The {@code *Headers} classes in {@code implementation/models} are the pre-migration AutoRest-generated files
-     * that typespec-java does not yet emit; they are kept as-is (treated as hand-written) until the emitter grows an
-     * equivalent of the TypeScript emitter's {@code include-headers-in-response} option.
-     *
-     * @param customization The library customization.
-     * @param logger The logger.
-     */
-    private static void addTypedImplWrappers(LibraryCustomization customization, Logger logger) {
-        // createSnapshot (SharesImpl) -- template implementation, extend to the remaining operations.
-        customization.getClass("com.azure.storage.file.share.implementation", "SharesImpl").customizeAst(ast -> {
-            // ResponseBase / SharesCreateSnapshotHeaders / Map are not present in the emitted file; the rest
-            // (RequestOptions, Response, HttpHeaderName, Context, Mono, ShareStorageExceptionInternal, ModelHelper)
-            // are already imported by typespec-java's emit + updateImplToMapInternalException.
-            ast.addImport("com.azure.core.http.rest.ResponseBase");
-            ast.addImport("com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders");
-            ast.addImport("java.util.Map");
-
-            ast.getClassByName("SharesImpl").ifPresent(clazz -> {
-                addBodyDeclaration(clazz,
-                    "public Mono>"
-                        + " createSnapshotWithResponseAsync(String shareName, Integer timeout,"
-                        + " Map metadata, Context context) {\n"
-                        + "    RequestOptions requestOptions = buildCreateSnapshotRequestOptions(timeout, metadata);\n"
-                        + "    String url = this.client.getUrl() + \"/\" + shareName;\n"
-                        + "    return service.createSnapshot(url, this.client.getServiceVersion().getVersion(),\n"
-                        + "            this.client.getFileRequestIntent(), requestOptions, context)\n"
-                        + "        .onErrorMap(ShareStorageExceptionInternal.class,"
-                        + " ModelHelper::mapToShareStorageException)\n"
-                        + "        .map(response -> new ResponseBase<>(response.getRequest(),"
-                        + " response.getStatusCode(),\n"
-                        + "            response.getHeaders(), response.getValue(),\n"
-                        + "            new SharesCreateSnapshotHeaders(response.getHeaders())));\n"
-                        + "}\n");
-
-                addBodyDeclaration(clazz,
-                    "public ResponseBase"
-                        + " createSnapshotWithResponse(String shareName, Integer timeout,"
-                        + " Map metadata, Context context) {\n"
-                        + "    RequestOptions requestOptions = buildCreateSnapshotRequestOptions(timeout, metadata);\n"
-                        + "    String url = this.client.getUrl() + \"/\" + shareName;\n"
-                        + "    try {\n"
-                        + "        Response response = service.createSnapshotSync(url,"
-                        + " this.client.getServiceVersion().getVersion(),\n"
-                        + "            this.client.getFileRequestIntent(), requestOptions, context);\n"
-                        + "        return new ResponseBase<>(response.getRequest(), response.getStatusCode(),\n"
-                        + "            response.getHeaders(), response.getValue(),\n"
-                        + "            new SharesCreateSnapshotHeaders(response.getHeaders()));\n"
-                        + "    } catch (ShareStorageExceptionInternal internalException) {\n"
-                        + "        throw ModelHelper.mapToShareStorageException(internalException);\n"
-                        + "    }\n"
-                        + "}\n");
-
-                // Shared RequestOptions builder for both overloads. Kept private + static so it does not extend the
-                // impl's public surface. timeout -> ?timeout=N query param; metadata -> x-ms-meta- headers.
-                addBodyDeclaration(clazz,
-                    "private static RequestOptions buildCreateSnapshotRequestOptions("
-                        + "Integer timeout, Map metadata) {\n"
-                        + "    RequestOptions requestOptions = new RequestOptions();\n"
-                        + "    if (timeout != null) {\n"
-                        + "        requestOptions.addQueryParam(\"timeout\", String.valueOf(timeout));\n"
-                        + "    }\n"
-                        + "    if (metadata != null) {\n"
-                        + "        for (Map.Entry entry : metadata.entrySet()) {\n"
-                        + "            requestOptions.setHeader("
-                        + "HttpHeaderName.fromString(\"x-ms-meta-\" + entry.getKey()),\n"
-                        + "                entry.getValue());\n"
-                        + "        }\n"
-                        + "    }\n"
-                        + "    return requestOptions;\n"
-                        + "}\n");
-            });
-            logger.info("Added typed createSnapshot wrappers to SharesImpl");
-        });
-    }
-
-    /**
-     * Parses {@code source} as a body declaration (method/constructor/field) and appends it to {@code clazz}.
-     */
-    private static void addBodyDeclaration(com.github.javaparser.ast.body.ClassOrInterfaceDeclaration clazz,
-        String source) {
-        clazz.addMember(StaticJavaParser.parseBodyDeclaration(source));
-    }
-
     /**
      * Customizes the implementation classes that will perform calls to the service. The following logic is used:
      * 


From a4ec9b810909214d3f3683b54d00652e0c156eb1 Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Mon, 10 Aug 2026 16:11:19 -0700
Subject: [PATCH 05/13] checkpoint

---
 .../azure-storage-file-share/README.md        | 605 +++++++++++++++++-
 .../storage/file/share/ShareAsyncClient.java  |  47 +-
 .../azure/storage/file/share/ShareClient.java |  48 +-
 .../implementation/util/ModelHelper.java      |  85 +--
 .../util/RequestOptionsHelper.java            | 153 +++++
 5 files changed, 826 insertions(+), 112 deletions(-)
 create mode 100644 sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java

diff --git a/sdk/storage/azure-storage-file-share/README.md b/sdk/storage/azure-storage-file-share/README.md
index 72c2fa4a2165..f791827a28fd 100644
--- a/sdk/storage/azure-storage-file-share/README.md
+++ b/sdk/storage/azure-storage-file-share/README.md
@@ -1 +1,604 @@
-# Azure File Share client library for Java

The Server Message Block (SMB) protocol is the preferred file share protocol used on-premises today.
The Microsoft Azure File Share service enables customers to leverage the availability and scalability of Azure's Cloud Infrastructure as a Service (IaaS) SMB without having to rewrite SMB client applications.

Files stored in Azure File Share service shares are accessible via the SMB protocol, and also via REST APIs.
The File Share service offers the following four resources: the storage account, shares, directories, and files.
Shares provide a way to organize sets of files and also can be mounted as an SMB file share that is hosted in the cloud.

[Source code][source_code] | [API reference documentation][reference_docs] | [REST API documentation][rest_api_documentation] | [Product documentation][storage_docs] |
[Samples][samples]

## Getting started

### Prerequisites

- [Java Development Kit (JDK)][jdk] with version 8 or above
  - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis).
- [Azure Subscription][azure_subscription]
- [Create Storage Account][storage_account]

### Include the package

#### Include the BOM file

Please include the azure-sdk-bom to your project to take dependency on GA version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).

```xml

    
        
            com.azure
            azure-sdk-bom
            {bom_version_to_target}
            pom
            import
        
    

```
and then include the direct dependency in the dependencies section without the version tag.

```xml

  
    com.azure
    azure-storage-file-share
  

```

#### Include direct dependency
If you want to take dependency on a particular version of the library that is not present in the BOM,
add the direct dependency to your project as follows.


[//]: # ({x-version-update-start;com.azure:azure-storage-file-share;current})
```xml

  com.azure
  azure-storage-file-share
  12.32.0-beta.1

```
[//]: # ({x-version-update-end})

### Create a Storage Account
To create a Storage Account you can use the Azure Portal or [Azure CLI][azure_cli].

```bash
az storage account create \
    --resource-group  \
    --name  \
    --location 
```

### Authenticate the client

In order to interact with the Storage service (File Share Service, Share, Directory, MessageId, File) you'll need to create an instance of the Service Client class.
To make this possible you'll need the Account SAS (shared access signature) string of Storage account. Learn more at [SAS Token][sas_token]

#### Get Credentials

- **SAS Token**
    * Use the [Azure CLI][azure_cli] snippet below to get the SAS token from the Storage account.

        ```bash
        az storage file generate-sas
            --name {account name}
            --expiry {date/time to expire SAS token}
            --permission {permission to grant}
            --connection-string {connection string of the storage account}
        ```

        ```bash
        CONNECTION_STRING=

        az storage file generate-sas
            --name javasdksas
            --expiry 2019-06-05
            --permission rpau
            --connection-string $CONNECTION_STRING
        ```

    * Alternatively, get the Account SAS Token from the Azure Portal.
        1. Go to your storage account.
        1. Click on "Shared access signature".
        1. Click on "Generate SAS and connection string".

- **Shared Key Credential**
    * There are two ways to create a shared key credential, the first is using the storage account name and account key. The second is using the storage connection string.
        1. Use account name and account key.
            1. The account name is your storage account name.
            1. Go to your storage account.
            1. Select "Access keys" tab.
            1. Copy the "Key" value for either Key 1 or Key 2.
        1. Use the connection string
            1. Go to your storage account.
            1. Select "Access keys" tab.
            1. Copy the "Connection string" value for either Key 1 or Key 2.

## Key concepts

### URL format
File Shares are addressable using the following URL format:

```
https://.file.core.windows.net/
```

The following URL addresses a queue in the diagram:

```
https://myaccount.file.core.windows.net/images-to-download
```

#### Resource URI Syntax
For the storage account, the base URI for queue operations includes the name of the account only:

```
https://myaccount.file.core.windows.net
```

For file, the base URI includes the name of the account and the name of the directory/file:

```
https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile
```

### Handling Exceptions
Uses the `shareServiceClient` generated from [shareServiceClient](#share-services) section below.

```java readme-sample-handleException
try {
    shareServiceClient.createShare("myShare");
} catch (ShareStorageException e) {
    logger.error("Failed to create a share with error code: " + e.getErrorCode());
}
```

### Resource Names
The URI to reference a share, directory or file must be unique. Within a given storage account, every share must have a unique name. Every file within a given share or directory must also have a unique name within that share or directory.

If you attempt to create a share, directory, or file with a name that violates naming rules, the request will fail with status code 400 (Bad Request).

### Share Names
The rules for File Share service names are more restrictive than what is prescribed by the SMB protocol for SMB share names, so that the Blob and File services can share similar naming conventions for containers and shares. The naming restrictions for shares are as follows:

1. A share name must be a valid DNS name.
1. Share names must start with a letter or number, and can contain only letters, numbers, and the dash (-) character.
1. Every dash (-) character must be immediately preceded and followed by a letter or number; consecutive dashes are not permitted in share names.
1. All letters in a share name must be lowercase.
1. Share names must be from 3 through 63 characters long.

### Directory and File Names
The Azure File Share service naming rules for directory and file names are as follows:

1. Share Directory and file names are case-preserving and case-insensitive.
1. Share Directory and file component names must be no more than 255 characters in length.
1. Share Directory names cannot end with the forward slash character (/). If provided, it will be automatically removed.
1. Share File names must not end with the forward slash character (/).
1. Reserved URL characters must be properly escaped.
1. The following characters are not allowed: `" \ / : | < > * ?`
1. Illegal URL path characters not allowed. Code points like \uE000, while valid in NTFS filenames, are not valid Unicode characters. In addition, some ASCII or Unicode characters, like control characters (0x00 to 0x1F, \u0081, etc.), are also not allowed. For rules governing Unicode strings in HTTP/1.1 see [RFC 2616, Section 2.2: Basic Rules][RFC_URL_1] and [RFC 3987][RFL_URL_2].
1. The following file names are not allowed: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, dot character (.), and two dot characters (..).

### Metadata Names
Metadata for a share or file resource is stored as name-value pairs associated with the resource. Directories do not have metadata. Metadata names must adhere to the naming rules for [C# identifiers][csharp_identifiers].

Note that metadata names preserve the case with which they were created, but are case-insensitive when set or read. If two or more metadata headers with the same name are submitted for a resource, the Azure File service returns status code 400 (Bad Request).

### Share Services
The File Share Service REST API provides operations on accounts and manage file service properties. It allows the operations of listing and deleting shares, getting and setting file service properties.
Once you have the SASToken, you can construct the `shareServiceClient` with `${accountName}`, `${sasToken}`

```java readme-sample-createShareServiceClient
String shareServiceURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareServiceClient shareServiceClient = new ShareServiceClientBuilder().endpoint(shareServiceURL)
    .sasToken(SAS_TOKEN).buildClient();
```

### Share
The share resource includes metadata and properties for that share. It allows the operations of creating, creating snapshot, deleting shares, getting share properties, setting metadata, getting and setting ACL (Access policy). Getting and setting ACL (Access policy) can only be used by ShareClient with ConnectionString. 

#### Share With SASToken
Once you have the SASToken, you can construct the share client with `${accountName}`, `${shareName}`, `${sasToken}`

```java readme-sample-createShareClient
String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareClient shareClient = new ShareClientBuilder().endpoint(shareURL)
    .sasToken(SAS_TOKEN).shareName(shareName).buildClient();
```

#### Share With ConnectionString
Once you have the ConnectionString, you can construct the share client with `${accountName}`, `${shareName}`, `${connectionString}`

```java readme-sample-createShareClientWithConnectionString
String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareClient shareClient = new ShareClientBuilder().endpoint(shareURL)
    .connectionString(CONNECTION_STRING).shareName(shareName).buildClient();
```

#### Share with `TokenCredential`
Once you have the TokenCredential, you can construct the share client with `${accountName}`, `${shareName}` and `ShareTokenIntent`. 
`ShareTokenIntent.BACKUP` specifies requests that are intended for backup/admin type operations, meaning that all
file/directory ACLs are bypassed and full permissions are granted. User must have required RBAC permission in order to 
use `ShareTokenIntent.BACKUP`.

```java readme-sample-createShareClientWithTokenCredential
String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);

ShareClient serviceClient = new ShareClientBuilder()
    .endpoint(shareURL)
    .credential(tokenCredential)
    .shareTokenIntent(ShareTokenIntent.BACKUP)
    .shareName(shareName)
    .buildClient();
```

### Directory
 The directory resource includes the properties for that directory. It allows the operations of creating, listing, deleting directories or subdirectories or files, getting properties, setting metadata, listing and force closing the handles.
 Once you have the SASToken, you can construct the file service client with `${accountName}`, `${shareName}`, `${directoryPath}`, `${sasToken}`

```java readme-sample-createDirectoryClient
String directoryURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareDirectoryClient directoryClient = new ShareFileClientBuilder().endpoint(directoryURL)
    .sasToken(SAS_TOKEN).shareName(shareName).resourcePath(directoryPath).buildDirectoryClient();
```

### File
 The file resource includes the properties for that file. It allows the operations of creating, uploading, copying, downloading, deleting files or range of the files, getting properties, setting metadata, listing and force closing the handles.
 Once you have the SASToken, you can construct the file service client with `${accountName}`, `${shareName}`, `${directoryPath}`, `${fileName}`, `${sasToken}`

```java readme-sample-createFileClient
String fileURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
ShareFileClient fileClient = new ShareFileClientBuilder().connectionString(CONNECTION_STRING)
    .endpoint(fileURL).shareName(shareName).resourcePath(directoryPath + "/" + fileName).buildFileClient();
```

## Examples

The following sections provide several code snippets covering some of the most common Configuration Service tasks, including:
- [Create a Share](#create-a-share)
- [Create a snapshot on Share](#create-a-snapshot-on-share)
- [Create a Directory](#create-a-directory)
- [Create a Subdirectory](#create-a-subdirectory)
- [Create a File](#create-a-file)
- [List all Shares](#list-all-shares)
- [List all Subdirectories and Files](#list-all-subdirectories-and-files)
- [List all ranges on file](#list-all-ranges-on-file)
- [Delete a Share](#delete-a-share)
- [Delete a Directory](#delete-a-directory)
- [Delete a Subdirectory](#delete-a-subdirectory)
- [Delete a File](#delete-a-file)
- [Copy a File](#copy-a-file)
- [Abort copy a File](#abort-copy-a-file)
- [Upload data to Storage File](#upload-data-to-storage)
- [Upload data bigger than 4 MB to Storage File](#upload-data-bigger-than-4-mb-to-storage)
- [Upload file to Storage File](#upload-file-to-storage)
- [Download data from file range](#download-data-from-file-range)
- [Download file from Storage File](#download-file-from-storage)
- [Get a share service properties](#get-a-share-service-properties)
- [Set a share service properties](#set-a-share-service-properties)
- [Set a Share metadata](#set-a-share-metadata)
- [Get a Share access policy](#get-a-share-access-policy)
- [Set a Share access policy](#set-a-share-access-policy)
- [Get handles on Directory and File](#get-handles-on-directory-file)
- [Force close handles on handle id](#force-close-handles-on-handle-id)
- [Set quota on Share](#set-quota-on-share)
- [Set file httpHeaders](#set-file-httpheaders)

### Create a share
Create a share in the Storage Account. Throws StorageException If the share fails to be created.
Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services).

```java readme-sample-createShare
String shareName = "testshare";
shareServiceClient.createShare(shareName);
```

### Create a snapshot on Share
Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services).

```java readme-sample-createSnapshotOnShare
String shareName = "testshare";
ShareClient shareClient = shareServiceClient.getShareClient(shareName);
shareClient.createSnapshot();
```

### Create a directory
Taking the shareClient initialized above, [`${shareClient}`](#share).

```java readme-sample-createDirectory
String dirName = "testdir";
shareClient.createDirectory(dirName);
```

### Create a subdirectory
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory).

```java readme-sample-createSubDirectory
String subDirName = "testsubdir";
directoryClient.createSubdirectory(subDirName);
```

### Create a File
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .

```java readme-sample-createFile
String fileName = "testfile";
long maxSize = 1024;
directoryClient.createFile(fileName, maxSize);
```

### List all Shares
Taking the shareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services)

```java readme-sample-getShareList
shareServiceClient.listShares();
```

### List all subdirectories and files
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory)

```java readme-sample-getSubDirectoryAndFileList
directoryClient.listFilesAndDirectories();
```

### List all ranges on file
Taking the fileClient in KeyConcept, [`${fileClient}`](#file)

```java readme-sample-getRangeList
fileClient.listRanges();
```

### Delete a share
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken)

```java readme-sample-deleteShare
shareClient.delete();
```

### Delete a directory
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .

```java readme-sample-deleteDirectory
String dirName = "testdir";
shareClient.deleteDirectory(dirName);
```

### Delete a subdirectory
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .

```java readme-sample-deleteSubDirectory
String subDirName = "testsubdir";
directoryClient.deleteSubdirectory(subDirName);
```

### Delete a file
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .

```java readme-sample-deleteFile
String fileName = "testfile";
directoryClient.deleteFile(fileName);
```

### Copy a file
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with string of source URL.

```java readme-sample-copyFile
String sourceURL = "https://myaccount.file.core.windows.net/myshare/myfile";
Duration pollInterval = Duration.ofSeconds(2);
SyncPoller poller = fileClient.beginCopy(sourceURL, (Map) null, pollInterval);
```

### Abort copy a file
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with the copy info response returned above `${copyId}=[copyInfoResponse](#copy-a-file)`.

```java readme-sample-abortCopyFile
fileClient.abortCopy("copyId");
```

### Upload data to storage
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with data of "default" .

```java readme-sample-uploadDataToStorage
String uploadText = "default";
InputStream data = new ByteArrayInputStream(uploadText.getBytes(StandardCharsets.UTF_8));
fileClient.upload(data, uploadText.length());
```

### Upload data bigger than 4 MB to storage
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with data of "default" .

```java readme-sample-uploadDataToStorageBiggerThan4MB
byte[] data = "Hello, data sample!".getBytes(StandardCharsets.UTF_8);

long chunkSize = 4 * 1024 * 1024L;
if (data.length > chunkSize) {
    for (int offset = 0; offset < data.length; offset += chunkSize) {
        try {
            // the last chunk size is smaller than the others
            chunkSize = Math.min(data.length - offset, chunkSize);

            // select the chunk in the byte array
            byte[] subArray = Arrays.copyOfRange(data, offset, (int) (offset + chunkSize));

            // upload the chunk
            fileClient.uploadWithResponse(new ByteArrayInputStream(subArray), chunkSize, (long) offset, null, Context.NONE);
        } catch (RuntimeException e) {
            logger.error("Failed to upload the file", e);
            if (Boolean.TRUE.equals(fileClient.exists())) {
                fileClient.delete();
            }
            throw e;
        }
    }
} else {
    fileClient.upload(new ByteArrayInputStream(data), data.length);
}
```

### Upload file to storage
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) .

```java readme-sample-uploadFileToStorage
String filePath = "${myLocalFilePath}";
fileClient.uploadFromFile(filePath);
```

### Download data from file range
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with the range from 1024 to 2048.

```java readme-sample-downloadDataFromFileRange
ShareFileRange fileRange = new ShareFileRange(0L, 2048L);
OutputStream stream = new ByteArrayOutputStream();
fileClient.downloadWithResponse(stream, fileRange, false, null, Context.NONE);
```

### Download file from storage
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) and download to the file of filePath.

```java readme-sample-downloadFileFromFileRange
String filePath = "${myLocalFilePath}";
fileClient.downloadToFile(filePath);
```

### Get a share service properties
Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services) .

```java readme-sample-getShareServiceProperties
shareServiceClient.getProperties();
```

### Set a share service properties
Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services) .

```java readme-sample-setShareServiceProperties
ShareServiceProperties properties = shareServiceClient.getProperties();

properties.getMinuteMetrics().setEnabled(true).setIncludeApis(true);
properties.getHourMetrics().setEnabled(true).setIncludeApis(true);

shareServiceClient.setProperties(properties);
```

### Set a share metadata
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .

```java readme-sample-setShareMetadata
Map metadata = Collections.singletonMap("directory", "metadata");
shareClient.setMetadata(metadata);
```

### Get a share access policy
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-connectionstring) .

```java readme-sample-getAccessPolicy
shareClient.getAccessPolicy();
```

### Set a share access policy
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-connectionstring) .

```java readme-sample-setAccessPolicy
ShareAccessPolicy accessPolicy = new ShareAccessPolicy().setPermissions("r")
    .setStartsOn(OffsetDateTime.now(ZoneOffset.UTC))
    .setExpiresOn(OffsetDateTime.now(ZoneOffset.UTC).plusDays(10));
ShareSignedIdentifier permission = new ShareSignedIdentifier().setId("mypolicy").setAccessPolicy(accessPolicy);
shareClient.setAccessPolicy(Collections.singletonList(permission));
```

### Get handles on directory file
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory)

```java readme-sample-getHandleList
PagedIterable handleItems = directoryClient.listHandles(null, true, Duration.ofSeconds(30), Context.NONE);
```

### Force close handles on handle id
Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) and the handle id returned above `${handleId}=[handleItems](#get-handles-on-directory-file)`

```java readme-sample-forceCloseHandleWithResponse
PagedIterable handleItems = directoryClient.listHandles(null, true, Duration.ofSeconds(30), Context.NONE);
String handleId = handleItems.iterator().next().getHandleId();
directoryClient.forceCloseHandleWithResponse(handleId, Duration.ofSeconds(30), Context.NONE);
```

### Set quota on share
Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .

```java readme-sample-setQuotaOnShare
int quotaOnGB = 1;
shareClient.setPropertiesWithResponse(new ShareSetPropertiesOptions().setQuotaInGb(quotaOnGB), null, Context.NONE);
```

### Set file httpheaders
Taking the fileClient in KeyConcept, [`${fileClient}`](#file) .

```java readme-sample-setFileHttpHeaders
ShareFileHttpHeaders httpHeaders = new ShareFileHttpHeaders().setContentType("text/plain");
fileClient.setProperties(1024, httpHeaders, null, null);
```

## Troubleshooting

## General

When you interact with file using this Java client library, errors returned by the service correspond to the same HTTP status codes returned for [REST API][storage_file_rest] requests. For example, if you try to retrieve a share that doesn't exist in your Storage Account, a `404` error is returned, indicating `Not Found`.

### Default HTTP Client
All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure
the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the
[HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).

### Default SSL library
All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL
operations. The Boring SSL library is an uber jar containing native libraries for Linux / macOS / Windows, and provides
better performance compared to the default SSL implementation within the JDK. For more information, including how to
reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.

## Next steps

## Contributing
This project welcomes contributions and suggestions.  Most contributions require you to agree to a
Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
the rights to use your contribution. For details, visit https://cla.microsoft.com.

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.

For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).

1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request


[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-file-share/src/
[reference_docs]: https://azure.github.io/azure-sdk-for-java/
[rest_api_documentation]: https://learn.microsoft.com/rest/api/storageservices/file-service-rest-api
[storage_docs]: https://learn.microsoft.com/azure/storage/files/storage-files-introduction
[jdk]: https://learn.microsoft.com/java/azure/jdk/
[maven]: https://maven.apache.org/
[azure_subscription]: https://azure.microsoft.com/free/
[storage_account]: https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
[azure_cli]: https://learn.microsoft.com/cli/azure
[sas_token]: https://learn.microsoft.com/azure/storage/common/storage-dotnet-shared-access-signature-part-1
[RFC_URL_1]: https://www.ietf.org/rfc/rfc2616.txt
[RFL_URL_2]: https://www.ietf.org/rfc/rfc3987.txt
[csharp_identifiers]: https://learn.microsoft.com/dotnet/csharp/language-reference/
[storage_file_rest]: https://learn.microsoft.com/rest/api/storageservices/file-service-error-codes
[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-file-share/src/samples
[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/blob/main/docs/performance-tuning.md


\ No newline at end of file
+# Azure File Share client library for Java
+
+The Server Message Block (SMB) protocol is the preferred file share protocol used on-premises today.
+The Microsoft Azure File Share service enables customers to leverage the availability and scalability of Azure's Cloud Infrastructure as a Service (IaaS) SMB without having to rewrite SMB client applications.
+
+Files stored in Azure File Share service shares are accessible via the SMB protocol, and also via REST APIs.
+The File Share service offers the following four resources: the storage account, shares, directories, and files.
+Shares provide a way to organize sets of files and also can be mounted as an SMB file share that is hosted in the cloud.
+
+[Source code][source_code] | [API reference documentation][reference_docs] | [REST API documentation][rest_api_documentation] | [Product documentation][storage_docs] |
+[Samples][samples]
+
+## Getting started
+
+### Prerequisites
+
+- [Java Development Kit (JDK)][jdk] with version 8 or above
+  - Here are details about [Java 8 client compatibility with Azure Certificate Authority](https://learn.microsoft.com/azure/security/fundamentals/azure-ca-details?tabs=root-and-subordinate-cas-list#client-compatibility-for-public-pkis).
+- [Azure Subscription][azure_subscription]
+- [Create Storage Account][storage_account]
+
+### Include the package
+
+#### Include the BOM file
+
+Please include the azure-sdk-bom to your project to take dependency on GA version of the library. In the following snippet, replace the {bom_version_to_target} placeholder with the version number.
+To learn more about the BOM, see the [AZURE SDK BOM README](https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/boms/azure-sdk-bom/README.md).
+
+```xml
+
+    
+        
+            com.azure
+            azure-sdk-bom
+            {bom_version_to_target}
+            pom
+            import
+        
+    
+
+```
+and then include the direct dependency in the dependencies section without the version tag.
+
+```xml
+
+  
+    com.azure
+    azure-storage-file-share
+  
+
+```
+
+#### Include direct dependency
+If you want to take dependency on a particular version of the library that is not present in the BOM,
+add the direct dependency to your project as follows.
+
+
+[//]: # ({x-version-update-start;com.azure:azure-storage-file-share;current})
+```xml
+
+  com.azure
+  azure-storage-file-share
+  12.32.0-beta.1
+
+```
+[//]: # ({x-version-update-end})
+
+### Create a Storage Account
+To create a Storage Account you can use the Azure Portal or [Azure CLI][azure_cli].
+
+```bash
+az storage account create \
+    --resource-group  \
+    --name  \
+    --location 
+```
+
+### Authenticate the client
+
+In order to interact with the Storage service (File Share Service, Share, Directory, MessageId, File) you'll need to create an instance of the Service Client class.
+To make this possible you'll need the Account SAS (shared access signature) string of Storage account. Learn more at [SAS Token][sas_token]
+
+#### Get Credentials
+
+- **SAS Token**
+    * Use the [Azure CLI][azure_cli] snippet below to get the SAS token from the Storage account.
+
+        ```bash
+        az storage file generate-sas
+            --name {account name}
+            --expiry {date/time to expire SAS token}
+            --permission {permission to grant}
+            --connection-string {connection string of the storage account}
+        ```
+
+        ```bash
+        CONNECTION_STRING=
+
+        az storage file generate-sas
+            --name javasdksas
+            --expiry 2019-06-05
+            --permission rpau
+            --connection-string $CONNECTION_STRING
+        ```
+
+    * Alternatively, get the Account SAS Token from the Azure Portal.
+        1. Go to your storage account.
+        1. Click on "Shared access signature".
+        1. Click on "Generate SAS and connection string".
+
+- **Shared Key Credential**
+    * There are two ways to create a shared key credential, the first is using the storage account name and account key. The second is using the storage connection string.
+        1. Use account name and account key.
+            1. The account name is your storage account name.
+            1. Go to your storage account.
+            1. Select "Access keys" tab.
+            1. Copy the "Key" value for either Key 1 or Key 2.
+        1. Use the connection string
+            1. Go to your storage account.
+            1. Select "Access keys" tab.
+            1. Copy the "Connection string" value for either Key 1 or Key 2.
+
+## Key concepts
+
+### URL format
+File Shares are addressable using the following URL format:
+
+```
+https://.file.core.windows.net/
+```
+
+The following URL addresses a queue in the diagram:
+
+```
+https://myaccount.file.core.windows.net/images-to-download
+```
+
+#### Resource URI Syntax
+For the storage account, the base URI for queue operations includes the name of the account only:
+
+```
+https://myaccount.file.core.windows.net
+```
+
+For file, the base URI includes the name of the account and the name of the directory/file:
+
+```
+https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile
+```
+
+### Handling Exceptions
+Uses the `shareServiceClient` generated from [shareServiceClient](#share-services) section below.
+
+```java readme-sample-handleException
+try {
+    shareServiceClient.createShare("myShare");
+} catch (ShareStorageException e) {
+    logger.error("Failed to create a share with error code: " + e.getErrorCode());
+}
+```
+
+### Resource Names
+The URI to reference a share, directory or file must be unique. Within a given storage account, every share must have a unique name. Every file within a given share or directory must also have a unique name within that share or directory.
+
+If you attempt to create a share, directory, or file with a name that violates naming rules, the request will fail with status code 400 (Bad Request).
+
+### Share Names
+The rules for File Share service names are more restrictive than what is prescribed by the SMB protocol for SMB share names, so that the Blob and File services can share similar naming conventions for containers and shares. The naming restrictions for shares are as follows:
+
+1. A share name must be a valid DNS name.
+1. Share names must start with a letter or number, and can contain only letters, numbers, and the dash (-) character.
+1. Every dash (-) character must be immediately preceded and followed by a letter or number; consecutive dashes are not permitted in share names.
+1. All letters in a share name must be lowercase.
+1. Share names must be from 3 through 63 characters long.
+
+### Directory and File Names
+The Azure File Share service naming rules for directory and file names are as follows:
+
+1. Share Directory and file names are case-preserving and case-insensitive.
+1. Share Directory and file component names must be no more than 255 characters in length.
+1. Share Directory names cannot end with the forward slash character (/). If provided, it will be automatically removed.
+1. Share File names must not end with the forward slash character (/).
+1. Reserved URL characters must be properly escaped.
+1. The following characters are not allowed: `" \ / : | < > * ?`
+1. Illegal URL path characters not allowed. Code points like \uE000, while valid in NTFS filenames, are not valid Unicode characters. In addition, some ASCII or Unicode characters, like control characters (0x00 to 0x1F, \u0081, etc.), are also not allowed. For rules governing Unicode strings in HTTP/1.1 see [RFC 2616, Section 2.2: Basic Rules][RFC_URL_1] and [RFC 3987][RFL_URL_2].
+1. The following file names are not allowed: LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, LPT9, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, PRN, AUX, NUL, CON, CLOCK$, dot character (.), and two dot characters (..).
+
+### Metadata Names
+Metadata for a share or file resource is stored as name-value pairs associated with the resource. Directories do not have metadata. Metadata names must adhere to the naming rules for [C# identifiers][csharp_identifiers].
+
+Note that metadata names preserve the case with which they were created, but are case-insensitive when set or read. If two or more metadata headers with the same name are submitted for a resource, the Azure File service returns status code 400 (Bad Request).
+
+### Share Services
+The File Share Service REST API provides operations on accounts and manage file service properties. It allows the operations of listing and deleting shares, getting and setting file service properties.
+Once you have the SASToken, you can construct the `shareServiceClient` with `${accountName}`, `${sasToken}`
+
+```java readme-sample-createShareServiceClient
+String shareServiceURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
+ShareServiceClient shareServiceClient = new ShareServiceClientBuilder().endpoint(shareServiceURL)
+    .sasToken(SAS_TOKEN).buildClient();
+```
+
+### Share
+The share resource includes metadata and properties for that share. It allows the operations of creating, creating snapshot, deleting shares, getting share properties, setting metadata, getting and setting ACL (Access policy). Getting and setting ACL (Access policy) can only be used by ShareClient with ConnectionString. 
+
+#### Share With SASToken
+Once you have the SASToken, you can construct the share client with `${accountName}`, `${shareName}`, `${sasToken}`
+
+```java readme-sample-createShareClient
+String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
+ShareClient shareClient = new ShareClientBuilder().endpoint(shareURL)
+    .sasToken(SAS_TOKEN).shareName(shareName).buildClient();
+```
+
+#### Share With ConnectionString
+Once you have the ConnectionString, you can construct the share client with `${accountName}`, `${shareName}`, `${connectionString}`
+
+```java readme-sample-createShareClientWithConnectionString
+String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
+ShareClient shareClient = new ShareClientBuilder().endpoint(shareURL)
+    .connectionString(CONNECTION_STRING).shareName(shareName).buildClient();
+```
+
+#### Share with `TokenCredential`
+Once you have the TokenCredential, you can construct the share client with `${accountName}`, `${shareName}` and `ShareTokenIntent`. 
+`ShareTokenIntent.BACKUP` specifies requests that are intended for backup/admin type operations, meaning that all
+file/directory ACLs are bypassed and full permissions are granted. User must have required RBAC permission in order to 
+use `ShareTokenIntent.BACKUP`.
+
+```java readme-sample-createShareClientWithTokenCredential
+String shareURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
+
+ShareClient serviceClient = new ShareClientBuilder()
+    .endpoint(shareURL)
+    .credential(tokenCredential)
+    .shareTokenIntent(ShareTokenIntent.BACKUP)
+    .shareName(shareName)
+    .buildClient();
+```
+
+### Directory
+ The directory resource includes the properties for that directory. It allows the operations of creating, listing, deleting directories or subdirectories or files, getting properties, setting metadata, listing and force closing the handles.
+ Once you have the SASToken, you can construct the file service client with `${accountName}`, `${shareName}`, `${directoryPath}`, `${sasToken}`
+
+```java readme-sample-createDirectoryClient
+String directoryURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
+ShareDirectoryClient directoryClient = new ShareFileClientBuilder().endpoint(directoryURL)
+    .sasToken(SAS_TOKEN).shareName(shareName).resourcePath(directoryPath).buildDirectoryClient();
+```
+
+### File
+ The file resource includes the properties for that file. It allows the operations of creating, uploading, copying, downloading, deleting files or range of the files, getting properties, setting metadata, listing and force closing the handles.
+ Once you have the SASToken, you can construct the file service client with `${accountName}`, `${shareName}`, `${directoryPath}`, `${fileName}`, `${sasToken}`
+
+```java readme-sample-createFileClient
+String fileURL = String.format("https://%s.file.core.windows.net", ACCOUNT_NAME);
+ShareFileClient fileClient = new ShareFileClientBuilder().connectionString(CONNECTION_STRING)
+    .endpoint(fileURL).shareName(shareName).resourcePath(directoryPath + "/" + fileName).buildFileClient();
+```
+
+## Examples
+
+The following sections provide several code snippets covering some of the most common Configuration Service tasks, including:
+- [Create a Share](#create-a-share)
+- [Create a snapshot on Share](#create-a-snapshot-on-share)
+- [Create a Directory](#create-a-directory)
+- [Create a Subdirectory](#create-a-subdirectory)
+- [Create a File](#create-a-file)
+- [List all Shares](#list-all-shares)
+- [List all Subdirectories and Files](#list-all-subdirectories-and-files)
+- [List all ranges on file](#list-all-ranges-on-file)
+- [Delete a Share](#delete-a-share)
+- [Delete a Directory](#delete-a-directory)
+- [Delete a Subdirectory](#delete-a-subdirectory)
+- [Delete a File](#delete-a-file)
+- [Copy a File](#copy-a-file)
+- [Abort copy a File](#abort-copy-a-file)
+- [Upload data to Storage File](#upload-data-to-storage)
+- [Upload data bigger than 4 MB to Storage File](#upload-data-bigger-than-4-mb-to-storage)
+- [Upload file to Storage File](#upload-file-to-storage)
+- [Download data from file range](#download-data-from-file-range)
+- [Download file from Storage File](#download-file-from-storage)
+- [Get a share service properties](#get-a-share-service-properties)
+- [Set a share service properties](#set-a-share-service-properties)
+- [Set a Share metadata](#set-a-share-metadata)
+- [Get a Share access policy](#get-a-share-access-policy)
+- [Set a Share access policy](#set-a-share-access-policy)
+- [Get handles on Directory and File](#get-handles-on-directory-file)
+- [Force close handles on handle id](#force-close-handles-on-handle-id)
+- [Set quota on Share](#set-quota-on-share)
+- [Set file httpHeaders](#set-file-httpheaders)
+
+### Create a share
+Create a share in the Storage Account. Throws StorageException If the share fails to be created.
+Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services).
+
+```java readme-sample-createShare
+String shareName = "testshare";
+shareServiceClient.createShare(shareName);
+```
+
+### Create a snapshot on Share
+Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services).
+
+```java readme-sample-createSnapshotOnShare
+String shareName = "testshare";
+ShareClient shareClient = shareServiceClient.getShareClient(shareName);
+shareClient.createSnapshot();
+```
+
+### Create a directory
+Taking the shareClient initialized above, [`${shareClient}`](#share).
+
+```java readme-sample-createDirectory
+String dirName = "testdir";
+shareClient.createDirectory(dirName);
+```
+
+### Create a subdirectory
+Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory).
+
+```java readme-sample-createSubDirectory
+String subDirName = "testsubdir";
+directoryClient.createSubdirectory(subDirName);
+```
+
+### Create a File
+Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .
+
+```java readme-sample-createFile
+String fileName = "testfile";
+long maxSize = 1024;
+directoryClient.createFile(fileName, maxSize);
+```
+
+### List all Shares
+Taking the shareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services)
+
+```java readme-sample-getShareList
+shareServiceClient.listShares();
+```
+
+### List all subdirectories and files
+Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory)
+
+```java readme-sample-getSubDirectoryAndFileList
+directoryClient.listFilesAndDirectories();
+```
+
+### List all ranges on file
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file)
+
+```java readme-sample-getRangeList
+fileClient.listRanges();
+```
+
+### Delete a share
+Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken)
+
+```java readme-sample-deleteShare
+shareClient.delete();
+```
+
+### Delete a directory
+Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .
+
+```java readme-sample-deleteDirectory
+String dirName = "testdir";
+shareClient.deleteDirectory(dirName);
+```
+
+### Delete a subdirectory
+Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .
+
+```java readme-sample-deleteSubDirectory
+String subDirName = "testsubdir";
+directoryClient.deleteSubdirectory(subDirName);
+```
+
+### Delete a file
+Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) .
+
+```java readme-sample-deleteFile
+String fileName = "testfile";
+directoryClient.deleteFile(fileName);
+```
+
+### Copy a file
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with string of source URL.
+
+```java readme-sample-copyFile
+String sourceURL = "https://myaccount.file.core.windows.net/myshare/myfile";
+Duration pollInterval = Duration.ofSeconds(2);
+SyncPoller poller = fileClient.beginCopy(sourceURL, (Map) null, pollInterval);
+```
+
+### Abort copy a file
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with the copy info response returned above `${copyId}=[copyInfoResponse](#copy-a-file)`.
+
+```java readme-sample-abortCopyFile
+fileClient.abortCopy("copyId");
+```
+
+### Upload data to storage
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with data of "default" .
+
+```java readme-sample-uploadDataToStorage
+String uploadText = "default";
+InputStream data = new ByteArrayInputStream(uploadText.getBytes(StandardCharsets.UTF_8));
+fileClient.upload(data, uploadText.length());
+```
+
+### Upload data bigger than 4 MB to storage
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with data of "default" .
+
+```java readme-sample-uploadDataToStorageBiggerThan4MB
+byte[] data = "Hello, data sample!".getBytes(StandardCharsets.UTF_8);
+
+long chunkSize = 4 * 1024 * 1024L;
+if (data.length > chunkSize) {
+    for (int offset = 0; offset < data.length; offset += chunkSize) {
+        try {
+            // the last chunk size is smaller than the others
+            chunkSize = Math.min(data.length - offset, chunkSize);
+
+            // select the chunk in the byte array
+            byte[] subArray = Arrays.copyOfRange(data, offset, (int) (offset + chunkSize));
+
+            // upload the chunk
+            fileClient.uploadWithResponse(new ByteArrayInputStream(subArray), chunkSize, (long) offset, null, Context.NONE);
+        } catch (RuntimeException e) {
+            logger.error("Failed to upload the file", e);
+            if (Boolean.TRUE.equals(fileClient.exists())) {
+                fileClient.delete();
+            }
+            throw e;
+        }
+    }
+} else {
+    fileClient.upload(new ByteArrayInputStream(data), data.length);
+}
+```
+
+### Upload file to storage
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file) .
+
+```java readme-sample-uploadFileToStorage
+String filePath = "${myLocalFilePath}";
+fileClient.uploadFromFile(filePath);
+```
+
+### Download data from file range
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file) with the range from 1024 to 2048.
+
+```java readme-sample-downloadDataFromFileRange
+ShareFileRange fileRange = new ShareFileRange(0L, 2048L);
+OutputStream stream = new ByteArrayOutputStream();
+fileClient.downloadWithResponse(stream, fileRange, false, null, Context.NONE);
+```
+
+### Download file from storage
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file) and download to the file of filePath.
+
+```java readme-sample-downloadFileFromFileRange
+String filePath = "${myLocalFilePath}";
+fileClient.downloadToFile(filePath);
+```
+
+### Get a share service properties
+Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services) .
+
+```java readme-sample-getShareServiceProperties
+shareServiceClient.getProperties();
+```
+
+### Set a share service properties
+Taking a ShareServiceClient in KeyConcept, [`${shareServiceClient}`](#share-services) .
+
+```java readme-sample-setShareServiceProperties
+ShareServiceProperties properties = shareServiceClient.getProperties();
+
+properties.getMinuteMetrics().setEnabled(true).setIncludeApis(true);
+properties.getHourMetrics().setEnabled(true).setIncludeApis(true);
+
+shareServiceClient.setProperties(properties);
+```
+
+### Set a share metadata
+Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .
+
+```java readme-sample-setShareMetadata
+Map metadata = Collections.singletonMap("directory", "metadata");
+shareClient.setMetadata(metadata);
+```
+
+### Get a share access policy
+Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-connectionstring) .
+
+```java readme-sample-getAccessPolicy
+shareClient.getAccessPolicy();
+```
+
+### Set a share access policy
+Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-connectionstring) .
+
+```java readme-sample-setAccessPolicy
+ShareAccessPolicy accessPolicy = new ShareAccessPolicy().setPermissions("r")
+    .setStartsOn(OffsetDateTime.now(ZoneOffset.UTC))
+    .setExpiresOn(OffsetDateTime.now(ZoneOffset.UTC).plusDays(10));
+ShareSignedIdentifier permission = new ShareSignedIdentifier().setId("mypolicy").setAccessPolicy(accessPolicy);
+shareClient.setAccessPolicy(Collections.singletonList(permission));
+```
+
+### Get handles on directory file
+Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory)
+
+```java readme-sample-getHandleList
+PagedIterable handleItems = directoryClient.listHandles(null, true, Duration.ofSeconds(30), Context.NONE);
+```
+
+### Force close handles on handle id
+Taking the directoryClient in KeyConcept, [`${directoryClient}`](#directory) and the handle id returned above `${handleId}=[handleItems](#get-handles-on-directory-file)`
+
+```java readme-sample-forceCloseHandleWithResponse
+PagedIterable handleItems = directoryClient.listHandles(null, true, Duration.ofSeconds(30), Context.NONE);
+String handleId = handleItems.iterator().next().getHandleId();
+directoryClient.forceCloseHandleWithResponse(handleId, Duration.ofSeconds(30), Context.NONE);
+```
+
+### Set quota on share
+Taking the shareClient in KeyConcept, [`${shareClient}`](#share-with-sastoken) .
+
+```java readme-sample-setQuotaOnShare
+int quotaOnGB = 1;
+shareClient.setPropertiesWithResponse(new ShareSetPropertiesOptions().setQuotaInGb(quotaOnGB), null, Context.NONE);
+```
+
+### Set file httpheaders
+Taking the fileClient in KeyConcept, [`${fileClient}`](#file) .
+
+```java readme-sample-setFileHttpHeaders
+ShareFileHttpHeaders httpHeaders = new ShareFileHttpHeaders().setContentType("text/plain");
+fileClient.setProperties(1024, httpHeaders, null, null);
+```
+
+## Troubleshooting
+
+## General
+
+When you interact with file using this Java client library, errors returned by the service correspond to the same HTTP status codes returned for [REST API][storage_file_rest] requests. For example, if you try to retrieve a share that doesn't exist in your Storage Account, a `404` error is returned, indicating `Not Found`.
+
+### Default HTTP Client
+All client libraries by default use the Netty HTTP client. Adding the above dependency will automatically configure
+the client library to use the Netty HTTP client. Configuring or changing the HTTP client is detailed in the
+[HTTP clients wiki](https://learn.microsoft.com/azure/developer/java/sdk/http-client-pipeline#http-clients).
+
+### Default SSL library
+All client libraries, by default, use the Tomcat-native Boring SSL library to enable native-level performance for SSL
+operations. The Boring SSL library is an uber jar containing native libraries for Linux / macOS / Windows, and provides
+better performance compared to the default SSL implementation within the JDK. For more information, including how to
+reduce the dependency size, refer to the [performance tuning][performance_tuning] section of the wiki.
+
+## Next steps
+
+## Contributing
+This project welcomes contributions and suggestions.  Most contributions require you to agree to a
+Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
+the rights to use your contribution. For details, visit https://cla.microsoft.com.
+
+When you submit a pull request, a CLA-bot will automatically determine whether you need to provide
+a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions
+provided by the bot. You will only need to do this once across all repos using our CLA.
+
+This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
+For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
+contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
+
+For details on contributing to this repository, see the [contributing guide](https://github.com/Azure/azure-sdk-for-java/blob/main/CONTRIBUTING.md).
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+
+[source_code]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-file-share/src/
+[reference_docs]: https://azure.github.io/azure-sdk-for-java/
+[rest_api_documentation]: https://learn.microsoft.com/rest/api/storageservices/file-service-rest-api
+[storage_docs]: https://learn.microsoft.com/azure/storage/files/storage-files-introduction
+[jdk]: https://learn.microsoft.com/java/azure/jdk/
+[maven]: https://maven.apache.org/
+[azure_subscription]: https://azure.microsoft.com/free/
+[storage_account]: https://learn.microsoft.com/azure/storage/common/storage-quickstart-create-account?tabs=azure-portal
+[azure_cli]: https://learn.microsoft.com/cli/azure
+[sas_token]: https://learn.microsoft.com/azure/storage/common/storage-dotnet-shared-access-signature-part-1
+[RFC_URL_1]: https://www.ietf.org/rfc/rfc2616.txt
+[RFL_URL_2]: https://www.ietf.org/rfc/rfc3987.txt
+[csharp_identifiers]: https://learn.microsoft.com/dotnet/csharp/language-reference/
+[storage_file_rest]: https://learn.microsoft.com/rest/api/storageservices/file-service-error-codes
+[samples]: https://github.com/Azure/azure-sdk-for-java/blob/main/sdk/storage/azure-storage-file-share/src/samples
+[performance_tuning]: https://github.com/Azure/azure-sdk-for-java/blob/main/docs/performance-tuning.md
+
+
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
index 650ad933b7e3..b30ca6bee6f4 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
@@ -15,6 +15,7 @@
 import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.SimpleResponse;
+import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.FluxUtil;
 import com.azure.core.util.logging.ClientLogger;
@@ -24,6 +25,7 @@
 import com.azure.storage.file.share.implementation.AzureFileStorageImpl;
 import com.azure.storage.file.share.implementation.models.SharePermission;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.implementation.util.ShareSasImplUtil;
 import com.azure.storage.file.share.models.FilePermissionFormat;
 import com.azure.storage.file.share.models.ShareFileHttpHeaders;
@@ -368,11 +370,8 @@ Mono> createWithResponse(ShareCreateOptions options, Context
         String enabledProtocol = options.getProtocols() == null ? null : options.getProtocols().toString();
         enabledProtocol = "".equals(enabledProtocol) ? null : enabledProtocol;
         return azureFileStorageClient.getShares()
-            .createNoCustomHeadersWithResponseAsync(shareName, null, options.getMetadata(), options.getQuotaInGb(),
-                options.getAccessTier(), enabledProtocol, options.getRootSquash(),
-                options.isSnapshotVirtualDirectoryAccessEnabled(), options.isPaidBurstingEnabled(),
-                options.getPaidBurstingMaxBandwidthMibps(), options.getPaidBurstingMaxIops(),
-                options.getProvisionedMaxIops(), options.getProvisionedMaxBandwidthMibps(), null, context)
+            .createWithResponseAsync(
+                RequestOptionsHelper.createShareRequestOptions(shareName, options, enabledProtocol, context))
             .map(ModelHelper::mapToShareInfoResponse);
     }
 
@@ -521,7 +520,9 @@ public Mono> createSnapshotWithResponse(Map> createSnapshotWithResponse(Map metadata, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        RequestOptions requestOptions = ModelHelper.createSnapshotRequestOptions(shareName, metadata, finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addMetadata(requestOptions, metadata);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares()
             .createSnapshotWithResponseAsync(requestOptions)
             .map(ModelHelper::mapCreateSnapshotResponse);
@@ -624,10 +625,10 @@ Mono> deleteWithResponse(ShareDeleteOptions options, Context cont
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
         Context finalContext = context == null ? Context.NONE : context;
         RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
-        ModelHelper.addSnapshot(requestOptions, snapshot);
-        ModelHelper.addDeleteSnapshotsHeader(requestOptions, options.getDeleteSnapshotsOptions());
-        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
-        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.addDeleteSnapshotsHeader(requestOptions, options.getDeleteSnapshotsOptions());
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares().deleteWithResponseAsync(requestOptions);
     }
 
@@ -808,9 +809,9 @@ Mono> getPropertiesWithResponse(ShareGetPropertiesOpti
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
         Context finalContext = context == null ? Context.NONE : context;
         RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
-        ModelHelper.addSnapshot(requestOptions, snapshot);
-        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
-        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares()
             .getPropertiesWithResponseAsync(requestOptions)
             .map(ModelHelper::mapGetPropertiesResponse);
@@ -944,11 +945,8 @@ Mono> setPropertiesWithResponse(ShareSetPropertiesOptions op
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
         context = context == null ? Context.NONE : context;
         return azureFileStorageClient.getShares()
-            .setPropertiesNoCustomHeadersWithResponseAsync(shareName, null, options.getQuotaInGb(),
-                options.getAccessTier(), requestConditions.getLeaseId(), options.getRootSquash(),
-                options.isSnapshotVirtualDirectoryAccessEnabled(), options.isPaidBurstingEnabled(),
-                options.getPaidBurstingMaxBandwidthMibps(), options.getPaidBurstingMaxIops(),
-                options.getProvisionedMaxIops(), options.getProvisionedMaxBandwidthMibps(), null, context)
+            .setPropertiesWithResponseAsync(RequestOptionsHelper.setSharePropertiesRequestOptions(shareName, options,
+                requestConditions.getLeaseId(), context))
             .map(ModelHelper::mapToShareInfoResponse);
     }
 
@@ -1072,9 +1070,9 @@ Mono> setMetadataWithResponse(ShareSetMetadataOptions option
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
         Context finalContext = context == null ? Context.NONE : context;
         RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
-        ModelHelper.addMetadata(requestOptions, options.getMetadata());
-        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
-        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        RequestOptionsHelper.addMetadata(requestOptions, options.getMetadata());
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares()
             .setMetadataWithResponseAsync(requestOptions)
             .map(ModelHelper::mapToShareInfoResponse);
@@ -1356,9 +1354,12 @@ Mono> getStatisticsWithResponse(ShareGetStatisticsOpti
         options = options == null ? new ShareGetStatisticsOptions() : options;
         ShareRequestConditions requestConditions
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
-        context = context == null ? Context.NONE : context;
+        Context finalContext = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares()
-            .getStatisticsNoCustomHeadersWithResponseAsync(shareName, null, requestConditions.getLeaseId(), context)
+            .getStatisticsWithResponseAsync(requestOptions)
             .map(ModelHelper::mapGetStatisticsResponse);
     }
 
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
index 03212bc37add..bac0837edb7d 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
@@ -17,6 +17,7 @@
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
+import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.logging.ClientLogger;
 import com.azure.storage.common.StorageSharedKeyCredential;
@@ -31,6 +32,7 @@
 import com.azure.storage.file.share.implementation.models.SharesGetPermissionHeaders;
 import com.azure.storage.file.share.implementation.models.SharesGetPropertiesHeaders;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.implementation.util.ShareSasImplUtil;
 import com.azure.storage.file.share.models.FilePermissionFormat;
 import com.azure.storage.file.share.models.ShareDirectoryInfo;
@@ -364,12 +366,8 @@ public Response createWithResponse(ShareCreateOptions options, Durati
         String finalEnabledProtocol = "".equals(enabledProtocol) ? null : enabledProtocol;
 
         Callable> operation = () -> azureFileStorageClient.getShares()
-            .createNoCustomHeadersWithResponse(shareName, null, finalOptions.getMetadata(), finalOptions.getQuotaInGb(),
-                finalOptions.getAccessTier(), finalEnabledProtocol, finalOptions.getRootSquash(),
-                finalOptions.isSnapshotVirtualDirectoryAccessEnabled(), finalOptions.isPaidBurstingEnabled(),
-                finalOptions.getPaidBurstingMaxBandwidthMibps(), finalOptions.getPaidBurstingMaxIops(),
-                finalOptions.getProvisionedMaxIops(), finalOptions.getProvisionedMaxBandwidthMibps(), null,
-                finalContext);
+            .createWithResponse(RequestOptionsHelper.createShareRequestOptions(shareName, finalOptions,
+                finalEnabledProtocol, finalContext));
 
         return ModelHelper.mapToShareInfoResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -505,7 +503,9 @@ public ShareSnapshotInfo createSnapshot() {
     public Response createSnapshotWithResponse(Map metadata, Duration timeout,
         Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        RequestOptions requestOptions = ModelHelper.createSnapshotRequestOptions(shareName, metadata, finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addMetadata(requestOptions, metadata);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         Callable> operation
             = () -> azureFileStorageClient.getShares().createSnapshotWithResponse(requestOptions);
 
@@ -601,10 +601,10 @@ public Response deleteWithResponse(ShareDeleteOptions options, Duration ti
             : finalOptions.getRequestConditions();
 
         RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
-        ModelHelper.addSnapshot(requestOptions, snapshot);
-        ModelHelper.addDeleteSnapshotsHeader(requestOptions, finalOptions.getDeleteSnapshotsOptions());
-        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
-        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.addDeleteSnapshotsHeader(requestOptions, finalOptions.getDeleteSnapshotsOptions());
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         Callable> operation
             = () -> this.azureFileStorageClient.getShares().deleteWithResponse(requestOptions);
 
@@ -773,9 +773,9 @@ public Response getPropertiesWithResponse(ShareGetPropertiesOpt
         ShareRequestConditions requestConditions
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
         RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
-        ModelHelper.addSnapshot(requestOptions, snapshot);
-        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
-        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         Callable> operation
             = () -> azureFileStorageClient.getShares().getPropertiesWithResponse(requestOptions);
 
@@ -903,11 +903,8 @@ public Response setPropertiesWithResponse(ShareSetPropertiesOptions o
         Context finalContext = context == null ? Context.NONE : context;
 
         Callable> operation = () -> this.azureFileStorageClient.getShares()
-            .setPropertiesNoCustomHeadersWithResponse(shareName, null, options.getQuotaInGb(), options.getAccessTier(),
-                requestConditions.getLeaseId(), options.getRootSquash(),
-                options.isSnapshotVirtualDirectoryAccessEnabled(), options.isPaidBurstingEnabled(),
-                options.getPaidBurstingMaxBandwidthMibps(), options.getPaidBurstingMaxIops(),
-                options.getProvisionedMaxIops(), options.getProvisionedMaxBandwidthMibps(), null, finalContext);
+            .setPropertiesWithResponse(RequestOptionsHelper.setSharePropertiesRequestOptions(shareName, options,
+                requestConditions.getLeaseId(), finalContext));
 
         return ModelHelper.mapToShareInfoResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -1024,9 +1021,9 @@ public Response setMetadataWithResponse(ShareSetMetadataOptions optio
         Context finalContext = context == null ? Context.NONE : context;
 
         RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
-        ModelHelper.addMetadata(requestOptions, options.getMetadata());
-        ModelHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
-        ModelHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        RequestOptionsHelper.addMetadata(requestOptions, options.getMetadata());
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         Callable> operation
             = () -> this.azureFileStorageClient.getShares().setMetadataWithResponse(requestOptions);
 
@@ -1318,8 +1315,11 @@ public Response getStatisticsWithResponse(ShareGetStatisticsOpt
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
         Context finalContext = context == null ? Context.NONE : context;
 
-        Callable> operation = () -> this.azureFileStorageClient.getShares()
-            .getStatisticsNoCustomHeadersWithResponse(shareName, null, requestConditions.getLeaseId(), finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getShares().getStatisticsWithResponse(requestOptions);
 
         return ModelHelper.mapGetStatisticsResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
index 05cb1949c328..80cf6a31814a 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
@@ -6,13 +6,11 @@
 import com.azure.core.exception.HttpResponseException;
 import com.azure.core.http.HttpHeaderName;
 import com.azure.core.http.HttpHeaders;
-import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
-import com.azure.core.util.Context;
+import com.azure.core.util.BinaryData;
 import com.azure.core.util.DateTimeRfc1123;
-import com.azure.core.util.UrlBuilder;
 import com.azure.core.util.logging.ClientLogger;
 import com.azure.core.util.polling.LongRunningOperationStatus;
 import com.azure.storage.common.ParallelTransferOptions;
@@ -89,6 +87,7 @@
 import com.azure.storage.file.share.models.ShareStatistics;
 import com.azure.storage.file.share.models.ShareStorageException;
 import com.azure.storage.file.share.options.ShareFileCopyOptions;
+import com.azure.xml.XmlReader;
 
 import java.io.UnsupportedEncodingException;
 import java.net.URLDecoder;
@@ -104,6 +103,8 @@
 import java.util.Set;
 import java.util.TreeSet;
 
+import javax.xml.stream.XMLStreamException;
+
 import static com.azure.core.http.HttpHeaderName.LAST_MODIFIED;
 
 public class ModelHelper {
@@ -528,8 +529,23 @@ public static Response mapGetPropertiesResponse(Response
         return new SimpleResponse<>(response, shareProperties);
     }
 
-    public static Response mapGetStatisticsResponse(Response response) {
-        return new SimpleResponse<>(response, new ShareStatistics(response.getValue().getShareUsageBytes()));
+    public static Response mapGetStatisticsResponse(Response response) {
+        ShareStats shareStats = deserializeXml(response.getValue(), ShareStats::fromXml);
+        return new SimpleResponse<>(response, new ShareStatistics(shareStats.getShareUsageBytes()));
+    }
+
+    /** Deserializes an XML response body via the model's {@code fromXml}. */
+    private static  T deserializeXml(BinaryData body, XmlDeserializer deserializer) {
+        try (XmlReader reader = XmlReader.fromStream(body.toStream())) {
+            return deserializer.read(reader);
+        } catch (XMLStreamException e) {
+            throw LOGGER.logExceptionAsError(new IllegalStateException(e));
+        }
+    }
+
+    @FunctionalInterface
+    private interface XmlDeserializer {
+        T read(XmlReader reader) throws XMLStreamException;
     }
 
     public static Response
@@ -562,65 +578,6 @@ public static Response mapGetStatisticsResponse(Response metadata,
-        Context context) {
-        RequestOptions requestOptions = new RequestOptions().setContext(context);
-        addMetadata(requestOptions, metadata);
-        scopeRequestToResourcePath(requestOptions, shareName);
-        return requestOptions;
-    }
-
-    /**
-     * The generated protocol methods target the account-scoped service URL; this appends the resource path (e.g.
-     * "{shareName}" or "{shareName}/{filePath}") to the request URL while preserving the route's query parameters.
-     */
-    public static void scopeRequestToResourcePath(RequestOptions requestOptions, String resourcePath) {
-        requestOptions.addRequestCallback(request -> {
-            UrlBuilder urlBuilder = UrlBuilder.parse(request.getUrl());
-            urlBuilder.setPath(resourcePath);
-            try {
-                request.setUrl(urlBuilder.toUrl());
-            } catch (java.net.MalformedURLException e) {
-                throw new IllegalStateException(e);
-            }
-        });
-    }
-
-    /** Adds the {@code x-ms-lease-id} header when a lease id is present. */
-    public static void addLeaseId(RequestOptions requestOptions, String leaseId) {
-        if (leaseId != null) {
-            requestOptions.setHeader(HttpHeaderName.fromString("x-ms-lease-id"), leaseId);
-        }
-    }
-
-    /** Adds the {@code sharesnapshot} query parameter when a snapshot is present. */
-    public static void addSnapshot(RequestOptions requestOptions, String snapshot) {
-        if (snapshot != null) {
-            requestOptions.addQueryParam("sharesnapshot", snapshot);
-        }
-    }
-
-    /** Adds the {@code x-ms-meta-*} headers for each metadata entry. */
-    public static void addMetadata(RequestOptions requestOptions, Map metadata) {
-        if (metadata != null) {
-            for (Map.Entry entry : metadata.entrySet()) {
-                requestOptions.setHeader(HttpHeaderName.fromString("x-ms-meta-" + entry.getKey()), entry.getValue());
-            }
-        }
-    }
-
-    /** Adds the {@code x-ms-delete-snapshots} header when a delete-snapshots option is present. */
-    public static void addDeleteSnapshotsHeader(RequestOptions requestOptions, ShareSnapshotsDeleteOptionType option) {
-        DeleteSnapshotsOptionType deleteSnapshots = toDeleteSnapshotsOptionType(option);
-        if (deleteSnapshots != null) {
-            requestOptions.setHeader(HttpHeaderName.fromString("x-ms-delete-snapshots"), deleteSnapshots.toString());
-        }
-    }
-
     public static Response mapCreateSnapshotResponse(Response response) {
         HttpHeaders headers = response.getHeaders();
         String lastModifiedString = headers.getValue(HttpHeaderName.LAST_MODIFIED);
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
new file mode 100644
index 000000000000..cc82b202eade
--- /dev/null
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
@@ -0,0 +1,153 @@
+// Copyright (c) Microsoft Corporation. All rights reserved.
+// Licensed under the MIT License.
+
+package com.azure.storage.file.share.implementation.util;
+
+import com.azure.core.http.HttpHeaderName;
+import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.util.Context;
+import com.azure.core.util.UrlBuilder;
+import com.azure.storage.common.implementation.Constants;
+import com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType;
+import com.azure.storage.file.share.models.ShareSnapshotsDeleteOptionType;
+import com.azure.storage.file.share.options.ShareCreateOptions;
+import com.azure.storage.file.share.options.ShareSetPropertiesOptions;
+
+import java.util.Map;
+
+/**
+ * Builds the {@link RequestOptions} passed to the generated {@code implementation/*Impl} protocol methods.
+ * 

+ * The hand-written {@code Share*} clients call the emitter's protocol {@code xxxWithResponse(RequestOptions)} methods
+ * (which target the account-scoped service URL and take all inputs through {@link RequestOptions}). These helpers
+ * translate the typed client inputs into the storage wire contract -- {@code x-ms-*} headers, query parameters, and the
+ * per-resource URL -- so the migration glue lives here rather than in {@code ModelHelper} (which maps responses).
+ */
+public final class RequestOptionsHelper {
+
+    private static final HttpHeaderName X_MS_LEASE_ID = HttpHeaderName.fromString("x-ms-lease-id");
+    private static final HttpHeaderName X_MS_DELETE_SNAPSHOTS = HttpHeaderName.fromString("x-ms-delete-snapshots");
+    private static final HttpHeaderName X_MS_SHARE_QUOTA = HttpHeaderName.fromString("x-ms-share-quota");
+    private static final HttpHeaderName X_MS_ACCESS_TIER = HttpHeaderName.fromString("x-ms-access-tier");
+    private static final HttpHeaderName X_MS_ENABLED_PROTOCOLS = HttpHeaderName.fromString("x-ms-enabled-protocols");
+    private static final HttpHeaderName X_MS_ROOT_SQUASH = HttpHeaderName.fromString("x-ms-root-squash");
+    private static final HttpHeaderName X_MS_ENABLE_SNAPSHOT_VIRTUAL_DIRECTORY_ACCESS
+        = HttpHeaderName.fromString("x-ms-enable-snapshot-virtual-directory-access");
+    private static final HttpHeaderName X_MS_SHARE_PAID_BURSTING_ENABLED
+        = HttpHeaderName.fromString("x-ms-share-paid-bursting-enabled");
+    private static final HttpHeaderName X_MS_SHARE_PAID_BURSTING_MAX_IOPS
+        = HttpHeaderName.fromString("x-ms-share-paid-bursting-max-iops");
+    private static final HttpHeaderName X_MS_SHARE_PAID_BURSTING_MAX_BANDWIDTH_MIBPS
+        = HttpHeaderName.fromString("x-ms-share-paid-bursting-max-bandwidth-mibps");
+    private static final HttpHeaderName X_MS_SHARE_PROVISIONED_IOPS
+        = HttpHeaderName.fromString("x-ms-share-provisioned-iops");
+    private static final HttpHeaderName X_MS_SHARE_PROVISIONED_BANDWIDTH_MIBPS
+        = HttpHeaderName.fromString("x-ms-share-provisioned-bandwidth-mibps");
+
+    /**
+     * The generated protocol methods target the account-scoped service URL; this appends the resource path (e.g.
+     * {@code "{shareName}"} or {@code "{shareName}/{filePath}"}) to the request URL while preserving the route's query
+     * parameters. Must be added after any {@link #addSnapshot} call so the snapshot query parameter is retained.
+     */
+    public static void scopeRequestToResourcePath(RequestOptions requestOptions, String resourcePath) {
+        requestOptions.addRequestCallback(request -> {
+            UrlBuilder urlBuilder = UrlBuilder.parse(request.getUrl());
+            urlBuilder.setPath(resourcePath);
+            try {
+                request.setUrl(urlBuilder.toUrl());
+            } catch (java.net.MalformedURLException e) {
+                throw new IllegalStateException(e);
+            }
+        });
+    }
+
+    /** Adds the {@code x-ms-lease-id} header when a lease id is present. */
+    public static void addLeaseId(RequestOptions requestOptions, String leaseId) {
+        if (leaseId != null) {
+            requestOptions.setHeader(X_MS_LEASE_ID, leaseId);
+        }
+    }
+
+    /** Adds the {@code sharesnapshot} query parameter when a snapshot is present. */
+    public static void addSnapshot(RequestOptions requestOptions, String snapshot) {
+        if (snapshot != null) {
+            requestOptions.addQueryParam("sharesnapshot", snapshot);
+        }
+    }
+
+    /** Adds the {@code x-ms-meta-*} headers for each metadata entry. */
+    public static void addMetadata(RequestOptions requestOptions, Map metadata) {
+        if (metadata != null) {
+            for (Map.Entry entry : metadata.entrySet()) {
+                requestOptions.setHeader(
+                    HttpHeaderName.fromString(Constants.HeaderConstants.X_MS_META + "-" + entry.getKey()),
+                    entry.getValue());
+            }
+        }
+    }
+
+    /** Adds the {@code x-ms-delete-snapshots} header when a delete-snapshots option is present. */
+    public static void addDeleteSnapshotsHeader(RequestOptions requestOptions, ShareSnapshotsDeleteOptionType option) {
+        DeleteSnapshotsOptionType deleteSnapshots = ModelHelper.toDeleteSnapshotsOptionType(option);
+        if (deleteSnapshots != null) {
+            requestOptions.setHeader(X_MS_DELETE_SNAPSHOTS, deleteSnapshots.toString());
+        }
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code Share.create}: the share-provisioning headers plus optional
+     * metadata, scoped to the share resource. {@code enabledProtocols} is pre-computed by the caller.
+     */
+    public static RequestOptions createShareRequestOptions(String shareName, ShareCreateOptions options,
+        String enabledProtocols, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addMetadata(requestOptions, options.getMetadata());
+        addHeader(requestOptions, X_MS_SHARE_QUOTA, options.getQuotaInGb());
+        addHeader(requestOptions, X_MS_ACCESS_TIER, options.getAccessTier());
+        addHeader(requestOptions, X_MS_ENABLED_PROTOCOLS, enabledProtocols);
+        addHeader(requestOptions, X_MS_ROOT_SQUASH, options.getRootSquash());
+        addHeader(requestOptions, X_MS_ENABLE_SNAPSHOT_VIRTUAL_DIRECTORY_ACCESS,
+            options.isSnapshotVirtualDirectoryAccessEnabled());
+        addHeader(requestOptions, X_MS_SHARE_PAID_BURSTING_ENABLED, options.isPaidBurstingEnabled());
+        addHeader(requestOptions, X_MS_SHARE_PAID_BURSTING_MAX_BANDWIDTH_MIBPS,
+            options.getPaidBurstingMaxBandwidthMibps());
+        addHeader(requestOptions, X_MS_SHARE_PAID_BURSTING_MAX_IOPS, options.getPaidBurstingMaxIops());
+        addHeader(requestOptions, X_MS_SHARE_PROVISIONED_IOPS, options.getProvisionedMaxIops());
+        addHeader(requestOptions, X_MS_SHARE_PROVISIONED_BANDWIDTH_MIBPS, options.getProvisionedMaxBandwidthMibps());
+        scopeRequestToResourcePath(requestOptions, shareName);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code Share.setProperties}: the share-provisioning headers plus the lease
+     * id, scoped to the share resource.
+     */
+    public static RequestOptions setSharePropertiesRequestOptions(String shareName, ShareSetPropertiesOptions options,
+        String leaseId, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_SHARE_QUOTA, options.getQuotaInGb());
+        addHeader(requestOptions, X_MS_ACCESS_TIER, options.getAccessTier());
+        addLeaseId(requestOptions, leaseId);
+        addHeader(requestOptions, X_MS_ROOT_SQUASH, options.getRootSquash());
+        addHeader(requestOptions, X_MS_ENABLE_SNAPSHOT_VIRTUAL_DIRECTORY_ACCESS,
+            options.isSnapshotVirtualDirectoryAccessEnabled());
+        addHeader(requestOptions, X_MS_SHARE_PAID_BURSTING_ENABLED, options.isPaidBurstingEnabled());
+        addHeader(requestOptions, X_MS_SHARE_PAID_BURSTING_MAX_BANDWIDTH_MIBPS,
+            options.getPaidBurstingMaxBandwidthMibps());
+        addHeader(requestOptions, X_MS_SHARE_PAID_BURSTING_MAX_IOPS, options.getPaidBurstingMaxIops());
+        addHeader(requestOptions, X_MS_SHARE_PROVISIONED_IOPS, options.getProvisionedMaxIops());
+        addHeader(requestOptions, X_MS_SHARE_PROVISIONED_BANDWIDTH_MIBPS, options.getProvisionedMaxBandwidthMibps());
+        scopeRequestToResourcePath(requestOptions, shareName);
+        return requestOptions;
+    }
+
+    /** Sets {@code name} to {@code String.valueOf(value)} when {@code value} is non-null. */
+    private static void addHeader(RequestOptions requestOptions, HttpHeaderName name, Object value) {
+        if (value != null) {
+            requestOptions.setHeader(name, String.valueOf(value));
+        }
+    }
+
+    private RequestOptionsHelper() {
+    }
+}

From 211f5bab1ad12984f542c1dcd192f8e8511dc1b3 Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Mon, 10 Aug 2026 16:49:16 -0700
Subject: [PATCH 06/13] share checkpoint

---
 .../storage/file/share/ShareAsyncClient.java  | 30 +++++----
 .../azure/storage/file/share/ShareClient.java | 64 +++++++++----------
 .../implementation/util/ModelHelper.java      | 23 +++++++
 .../util/RequestOptionsHelper.java            | 31 +++++++++
 4 files changed, 103 insertions(+), 45 deletions(-)

diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
index b30ca6bee6f4..119f6293cd42 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java
@@ -1136,11 +1136,13 @@ public PagedFlux getAccessPolicy(ShareGetAccessPolicyOpti
             ? new ShareRequestConditions()
             : finalOptions.getRequestConditions();
         try {
+            RequestOptions requestOptions = new RequestOptions().setContext(Context.NONE);
+            RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+            RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
             Function>> retriever
                 = marker -> this.azureFileStorageClient.getShares()
-                    .getAccessPolicyWithResponseAsync(shareName, null, requestConditions.getLeaseId(), Context.NONE)
-                    .map(response -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(),
-                        response.getHeaders(), response.getValue().items(), null, response.getDeserializedHeaders()));
+                    .getAccessPolicyWithResponseAsync(requestOptions)
+                    .map(ModelHelper::mapGetAccessPolicyResponse);
 
             return new PagedFlux<>(() -> retriever.apply(null), retriever);
         } catch (RuntimeException ex) {
@@ -1263,9 +1265,10 @@ Mono> setAccessPolicyWithResponse(ShareSetAccessPolicyOption
 
         context = context == null ? Context.NONE : context;
 
+        RequestOptions requestOptions = RequestOptionsHelper.setAccessPolicyRequestOptions(shareName, permissions,
+            requestConditions.getLeaseId(), context);
         return azureFileStorageClient.getShares()
-            .setAccessPolicyNoCustomHeadersWithResponseAsync(shareName, null, requestConditions.getLeaseId(),
-                permissions, context)
+            .setAccessPolicyWithResponseAsync(requestOptions)
             .map(ModelHelper::mapToShareInfoResponse);
     }
 
@@ -2147,12 +2150,12 @@ public Mono> createPermissionWithResponse(ShareFilePermission f
     Mono> createPermissionWithResponse(String filePermission,
         FilePermissionFormat filePermissionFormat, Context context) {
         // NOTE: Should we check for null or empty?
-        SharePermission sharePermission
-            = new SharePermission().setPermission(filePermission).setFormat(filePermissionFormat);
+        SharePermission sharePermission = new SharePermission(filePermission).setFormat(filePermissionFormat);
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares()
-            .createPermissionWithResponseAsync(shareName, sharePermission, null, context)
-            .map(response -> new SimpleResponse<>(response,
-                response.getDeserializedHeaders().getXMsFilePermissionKey()));
+            .createPermissionWithResponseAsync(BinaryData.fromObject(sharePermission), requestOptions)
+            .map(ModelHelper::mapCreatePermissionResponse);
     }
 
     /**
@@ -2256,9 +2259,12 @@ public Mono> getPermissionWithResponse(String filePermissionKey
 
     Mono> getPermissionWithResponse(String filePermissionKey,
         FilePermissionFormat filePermissionFormat, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        RequestOptionsHelper.addFilePermissionFormat(requestOptions, filePermissionFormat);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
         return azureFileStorageClient.getShares()
-            .getPermissionWithResponseAsync(shareName, filePermissionKey, filePermissionFormat, null, context)
-            .map(response -> new SimpleResponse<>(response, response.getValue().getPermission()));
+            .getPermissionWithResponseAsync(filePermissionKey, requestOptions)
+            .map(ModelHelper::mapGetPermissionResponse);
     }
 
     /**
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
index bac0837edb7d..e4fa936b5bf2 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareClient.java
@@ -1089,14 +1089,12 @@ public PagedIterable getAccessPolicy(ShareGetAccessPolicy
             ? new ShareRequestConditions()
             : finalOptions.getRequestConditions();
 
-        ResponseBase responseBase
-            = this.azureFileStorageClient.getShares()
-                .getAccessPolicyWithResponse(shareName, null, requestConditions.getLeaseId(), Context.NONE);
+        RequestOptions requestOptions = new RequestOptions().setContext(Context.NONE);
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
 
-        Supplier> response
-            = () -> new PagedResponseBase<>(responseBase.getRequest(), responseBase.getStatusCode(),
-                responseBase.getHeaders(), responseBase.getValue().items(), null,
-                responseBase.getDeserializedHeaders());
+        Supplier> response = () -> ModelHelper.mapGetAccessPolicyResponse(
+            this.azureFileStorageClient.getShares().getAccessPolicyWithResponse(requestOptions));
 
         return new PagedIterable<>(response);
     }
@@ -1221,9 +1219,10 @@ public Response setAccessPolicyWithResponse(ShareSetAccessPolicyOptio
             = ModelHelper.truncateAccessPolicyPermissionsToSeconds(options.getPermissions());
         Context finalContext = context == null ? Context.NONE : context;
 
-        Callable> operation = () -> this.azureFileStorageClient.getShares()
-            .setAccessPolicyNoCustomHeadersWithResponse(shareName, null, requestConditions.getLeaseId(), permissions,
-                finalContext);
+        RequestOptions requestOptions = RequestOptionsHelper.setAccessPolicyRequestOptions(shareName, permissions,
+            requestConditions.getLeaseId(), finalContext);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getShares().setAccessPolicyWithResponse(requestOptions);
 
         return ModelHelper.mapToShareInfoResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -1988,11 +1987,12 @@ public String createPermission(ShareFilePermission filePermission) {
     @ServiceMethod(returns = ReturnType.SINGLE)
     public Response createPermissionWithResponse(String filePermission, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        SharePermission sharePermission = new SharePermission().setPermission(filePermission);
-        ResponseBase response = this.azureFileStorageClient.getShares()
-            .createPermissionWithResponse(shareName, sharePermission, null, finalContext);
+        SharePermission sharePermission = new SharePermission(filePermission);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
 
-        return new SimpleResponse<>(response, response.getDeserializedHeaders().getXMsFilePermissionKey());
+        return ModelHelper.mapCreatePermissionResponse(this.azureFileStorageClient.getShares()
+            .createPermissionWithResponse(BinaryData.fromObject(sharePermission), requestOptions));
     }
 
     /**
@@ -2019,17 +2019,15 @@ public Response createPermissionWithResponse(String filePermission, Cont
     public Response createPermissionWithResponse(ShareFilePermission filePermission, Duration timeout,
         Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        SharePermission sharePermission = new SharePermission().setPermission(filePermission.getPermission())
-            .setFormat(filePermission.getPermissionFormat());
-
-        Callable> operation
-            = () -> this.azureFileStorageClient.getShares()
-                .createPermissionWithResponse(shareName, sharePermission, null, finalContext);
+        SharePermission sharePermission
+            = new SharePermission(filePermission.getPermission()).setFormat(filePermission.getPermissionFormat());
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
 
-        ResponseBase response
-            = sendRequest(operation, timeout, ShareStorageException.class);
+        Callable> operation = () -> this.azureFileStorageClient.getShares()
+            .createPermissionWithResponse(BinaryData.fromObject(sharePermission), requestOptions);
 
-        return new SimpleResponse<>(response, response.getDeserializedHeaders().getXMsFilePermissionKey());
+        return ModelHelper.mapCreatePermissionResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
 
     /**
@@ -2096,10 +2094,11 @@ public String getPermission(String filePermissionKey, FilePermissionFormat fileP
     @ServiceMethod(returns = ReturnType.SINGLE)
     public Response getPermissionWithResponse(String filePermissionKey, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        ResponseBase response = this.azureFileStorageClient.getShares()
-            .getPermissionWithResponse(shareName, filePermissionKey, null, null, finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
 
-        return new SimpleResponse<>(response, response.getValue().getPermission());
+        return ModelHelper.mapGetPermissionResponse(
+            this.azureFileStorageClient.getShares().getPermissionWithResponse(filePermissionKey, requestOptions));
     }
 
     /**
@@ -2129,15 +2128,14 @@ public Response getPermissionWithResponse(String filePermissionKey, Cont
     public Response getPermissionWithResponse(String filePermissionKey,
         FilePermissionFormat filePermissionFormat, Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addFilePermissionFormat(requestOptions, filePermissionFormat);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
 
-        Callable> operation
-            = () -> this.azureFileStorageClient.getShares()
-                .getPermissionWithResponse(shareName, filePermissionKey, filePermissionFormat, null, finalContext);
-
-        ResponseBase response
-            = sendRequest(operation, timeout, ShareStorageException.class);
+        Callable> operation = () -> this.azureFileStorageClient.getShares()
+            .getPermissionWithResponse(filePermissionKey, requestOptions);
 
-        return new SimpleResponse<>(response, response.getValue().getPermission());
+        return ModelHelper.mapGetPermissionResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
 
     /**
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
index 80cf6a31814a..ff13b4b28a59 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
@@ -6,6 +6,8 @@
 import com.azure.core.exception.HttpResponseException;
 import com.azure.core.http.HttpHeaderName;
 import com.azure.core.http.HttpHeaders;
+import com.azure.core.http.rest.PagedResponse;
+import com.azure.core.http.rest.PagedResponseBase;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
@@ -47,8 +49,11 @@
 import com.azure.storage.file.share.implementation.models.ServicesListSharesSegmentHeaders;
 import com.azure.storage.file.share.implementation.models.ShareItemInternal;
 import com.azure.storage.file.share.implementation.models.SharePropertiesInternal;
+import com.azure.storage.file.share.implementation.models.SharePermission;
+import com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper;
 import com.azure.storage.file.share.implementation.models.ShareStats;
 import com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal;
+import com.azure.storage.file.share.implementation.models.SharesGetAccessPolicyHeaders;
 import com.azure.storage.file.share.implementation.models.SharesGetPropertiesHeaders;
 import com.azure.storage.file.share.implementation.models.StringEncoded;
 import com.azure.storage.file.share.models.ClearRange;
@@ -534,6 +539,24 @@ public static Response mapGetStatisticsResponse(Response(response, new ShareStatistics(shareStats.getShareUsageBytes()));
     }
 
+    public static PagedResponse mapGetAccessPolicyResponse(Response response) {
+        ShareSignedIdentifierWrapper wrapper
+            = deserializeXml(response.getValue(), ShareSignedIdentifierWrapper::fromXml);
+        return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
+            wrapper.getItems(), null, new SharesGetAccessPolicyHeaders(response.getHeaders()));
+    }
+
+    private static final HttpHeaderName X_MS_FILE_PERMISSION_KEY
+        = HttpHeaderName.fromString("x-ms-file-permission-key");
+
+    public static Response mapCreatePermissionResponse(Response response) {
+        return new SimpleResponse<>(response, response.getHeaders().getValue(X_MS_FILE_PERMISSION_KEY));
+    }
+
+    public static Response mapGetPermissionResponse(Response response) {
+        return new SimpleResponse<>(response, response.getValue().toObject(SharePermission.class).getPermission());
+    }
+
     /** Deserializes an XML response body via the model's {@code fromXml}. */
     private static  T deserializeXml(BinaryData body, XmlDeserializer deserializer) {
         try (XmlReader reader = XmlReader.fromStream(body.toStream())) {
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
index cc82b202eade..aa48ea2c6769 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
@@ -5,14 +5,21 @@
 
 import com.azure.core.http.HttpHeaderName;
 import com.azure.core.http.rest.RequestOptions;
+import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.UrlBuilder;
+import com.azure.core.util.serializer.ObjectSerializer;
 import com.azure.storage.common.implementation.Constants;
+import com.azure.storage.file.share.implementation.XmlSerializer;
 import com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType;
+import com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper;
+import com.azure.storage.file.share.models.FilePermissionFormat;
+import com.azure.storage.file.share.models.ShareSignedIdentifier;
 import com.azure.storage.file.share.models.ShareSnapshotsDeleteOptionType;
 import com.azure.storage.file.share.options.ShareCreateOptions;
 import com.azure.storage.file.share.options.ShareSetPropertiesOptions;
 
+import java.util.List;
 import java.util.Map;
 
 /**
@@ -27,6 +34,8 @@ public final class RequestOptionsHelper {
 
     private static final HttpHeaderName X_MS_LEASE_ID = HttpHeaderName.fromString("x-ms-lease-id");
     private static final HttpHeaderName X_MS_DELETE_SNAPSHOTS = HttpHeaderName.fromString("x-ms-delete-snapshots");
+    private static final HttpHeaderName X_MS_FILE_PERMISSION_FORMAT
+        = HttpHeaderName.fromString("x-ms-file-permission-format");
     private static final HttpHeaderName X_MS_SHARE_QUOTA = HttpHeaderName.fromString("x-ms-share-quota");
     private static final HttpHeaderName X_MS_ACCESS_TIER = HttpHeaderName.fromString("x-ms-access-tier");
     private static final HttpHeaderName X_MS_ENABLED_PROTOCOLS = HttpHeaderName.fromString("x-ms-enabled-protocols");
@@ -44,6 +53,8 @@ public final class RequestOptionsHelper {
     private static final HttpHeaderName X_MS_SHARE_PROVISIONED_BANDWIDTH_MIBPS
         = HttpHeaderName.fromString("x-ms-share-provisioned-bandwidth-mibps");
 
+    private static final ObjectSerializer XML_SERIALIZER = new XmlSerializer();
+
     /**
      * The generated protocol methods target the account-scoped service URL; this appends the resource path (e.g.
      * {@code "{shareName}"} or {@code "{shareName}/{filePath}"}) to the request URL while preserving the route's query
@@ -68,6 +79,13 @@ public static void addLeaseId(RequestOptions requestOptions, String leaseId) {
         }
     }
 
+    /** Adds the {@code x-ms-file-permission-format} header when a format is present. */
+    public static void addFilePermissionFormat(RequestOptions requestOptions, FilePermissionFormat format) {
+        if (format != null) {
+            requestOptions.setHeader(X_MS_FILE_PERMISSION_FORMAT, format.toString());
+        }
+    }
+
     /** Adds the {@code sharesnapshot} query parameter when a snapshot is present. */
     public static void addSnapshot(RequestOptions requestOptions, String snapshot) {
         if (snapshot != null) {
@@ -141,6 +159,19 @@ public static RequestOptions setSharePropertiesRequestOptions(String shareName,
         return requestOptions;
     }
 
+    /**
+     * Builds the {@link RequestOptions} for {@code Share.setAccessPolicy}: the lease id plus the signed identifiers
+     * serialized as the XML request body, scoped to the share resource.
+     */
+    public static RequestOptions setAccessPolicyRequestOptions(String shareName,
+        List permissions, String leaseId, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addLeaseId(requestOptions, leaseId);
+        requestOptions.setBody(BinaryData.fromObject(new ShareSignedIdentifierWrapper(permissions), XML_SERIALIZER));
+        scopeRequestToResourcePath(requestOptions, shareName);
+        return requestOptions;
+    }
+
     /** Sets {@code name} to {@code String.valueOf(value)} when {@code value} is non-null. */
     private static void addHeader(RequestOptions requestOptions, HttpHeaderName name, Object value) {
         if (value != null) {

From fb5507d5a2374d031ff8aaf4d477d1fd4fee41f5 Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Mon, 10 Aug 2026 17:10:02 -0700
Subject: [PATCH 07/13] service checkpoint

---
 .../file/share/ShareServiceAsyncClient.java   | 48 ++++++------
 .../file/share/ShareServiceClient.java        | 73 ++++++++++---------
 .../share/implementation/ServicesImpl.java    | 19 +++++
 .../implementation/util/ModelHelper.java      | 28 +++++++
 .../util/RequestOptionsHelper.java            | 73 +++++++++++++++++++
 .../main/java/ShareStorageCustomization.java  | 42 +++++++++++
 6 files changed, 227 insertions(+), 56 deletions(-)

diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceAsyncClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceAsyncClient.java
index 5902a63579dc..b6515ad9d460 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceAsyncClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceAsyncClient.java
@@ -12,6 +12,7 @@
 import com.azure.core.http.rest.PagedFlux;
 import com.azure.core.http.rest.PagedResponse;
 import com.azure.core.http.rest.PagedResponseBase;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.SimpleResponse;
 import com.azure.core.util.Context;
@@ -29,6 +30,7 @@
 import com.azure.storage.file.share.implementation.models.KeyInfo;
 import com.azure.storage.file.share.implementation.models.ListSharesIncludeType;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.models.ListSharesOptions;
 import com.azure.storage.file.share.models.ShareCorsRule;
 import com.azure.storage.file.share.models.ShareItem;
@@ -257,17 +259,9 @@ PagedFlux listSharesWithOptionalTimeout(String marker, ListSharesOpti
 
         BiFunction>> retriever = (nextMarker,
             pageSize) -> StorageImplUtils.applyOptionalTimeout(this.azureFileStorageClient.getServices()
-                .listSharesSegmentSinglePageAsync(prefix, nextMarker, pageSize == null ? maxResultsPerPage : pageSize,
-                    include, null, context)
-                .map(response -> {
-                    List value = response.getValue() == null
-                        ? Collections.emptyList()
-                        : response.getValue().stream().map(ModelHelper::populateShareItem).collect(Collectors.toList());
-
-                    return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(),
-                        response.getHeaders(), value, response.getContinuationToken(),
-                        ModelHelper.transformListSharesHeaders(response.getHeaders()));
-                }), timeout);
+                .listSharesSegmentWithResponseAsync(RequestOptionsHelper.listSharesRequestOptions(prefix, nextMarker,
+                    pageSize == null ? maxResultsPerPage : pageSize, include, context))
+                .map(ModelHelper::mapListSharesResponse), timeout);
         return new PagedFlux<>(pageSize -> retriever.apply(marker, pageSize), retriever);
     }
 
@@ -334,9 +328,10 @@ public Mono> getPropertiesWithResponse() {
 
     Mono> getPropertiesWithResponse(Context context) {
         context = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
         return azureFileStorageClient.getServices()
-            .getPropertiesWithResponseAsync(null, context)
-            .map(response -> new SimpleResponse<>(response, response.getValue()));
+            .getPropertiesWithResponseAsync(requestOptions)
+            .map(ModelHelper::mapGetServicePropertiesResponse);
     }
 
     /**
@@ -456,8 +451,9 @@ public Mono> setPropertiesWithResponse(ShareServiceProperties pro
 
     Mono> setPropertiesWithResponse(ShareServiceProperties properties, Context context) {
         context = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
         return azureFileStorageClient.getServices()
-            .setPropertiesNoCustomHeadersWithResponseAsync(properties, null, context);
+            .setPropertiesWithResponseAsync(RequestOptionsHelper.serializeToXml(properties), requestOptions);
     }
 
     /**
@@ -657,8 +653,11 @@ Mono> deleteShareWithResponse(String shareName, String snapshot,
             deleteSnapshots = DeleteSnapshotsOptionType.INCLUDE;
         }
         context = context == null ? Context.NONE : context;
-        return azureFileStorageClient.getShares()
-            .deleteNoCustomHeadersWithResponseAsync(shareName, snapshot, null, deleteSnapshots, null, context);
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.addDeleteSnapshotsHeader(requestOptions, deleteSnapshots);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        return azureFileStorageClient.getShares().deleteWithResponseAsync(requestOptions);
     }
 
     /**
@@ -853,8 +852,11 @@ public Mono> undeleteShareWithResponse(String deleted
 
     Mono> undeleteShareWithResponse(String deletedShareName, String deletedShareVersion,
         Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context == null ? Context.NONE : context);
+        RequestOptionsHelper.addUndeleteShareHeaders(requestOptions, deletedShareName, deletedShareVersion);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, deletedShareName);
         return this.azureFileStorageClient.getShares()
-            .restoreWithResponseAsync(deletedShareName, null, null, deletedShareName, deletedShareVersion, context)
+            .restoreWithResponseAsync(requestOptions)
             .map(response -> new SimpleResponse<>(response, getShareAsyncClient(deletedShareName)));
     }
 
@@ -930,12 +932,12 @@ Mono> getUserDelegationKeyWithResponse(OffsetDateTim
                 new IllegalArgumentException("`start` must be null or a datetime before `expiry`."));
         }
 
+        KeyInfo keyInfo = new KeyInfo(Constants.ISO_8601_UTC_DATE_FORMATTER.format(expiry))
+            .setStart(start == null ? "" : Constants.ISO_8601_UTC_DATE_FORMATTER.format(start))
+            .setDelegatedUserTenantId(delegatedUserTenantId);
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
         return this.azureFileStorageClient.getServices()
-            .getUserDelegationKeyWithResponseAsync(
-                new KeyInfo().setStart(start == null ? "" : Constants.ISO_8601_UTC_DATE_FORMATTER.format(start))
-                    .setExpiry(Constants.ISO_8601_UTC_DATE_FORMATTER.format(expiry))
-                    .setDelegatedUserTenantId(delegatedUserTenantId),
-                null, null, context)
-            .map(rb -> new SimpleResponse<>(rb, rb.getValue()));
+            .getUserDelegationKeyWithResponseAsync(RequestOptionsHelper.serializeToXml(keyInfo), requestOptions)
+            .map(ModelHelper::mapGetUserDelegationKeyResponse);
     }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceClient.java
index 70ac71c922a2..a3ddc9386ad2 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareServiceClient.java
@@ -12,9 +12,11 @@
 import com.azure.core.http.rest.PagedIterable;
 import com.azure.core.http.rest.PagedResponse;
 import com.azure.core.http.rest.PagedResponseBase;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
+import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.CoreUtils;
 import com.azure.core.util.logging.ClientLogger;
@@ -31,6 +33,7 @@
 import com.azure.storage.file.share.implementation.models.ServicesGetUserDelegationKeyHeaders;
 import com.azure.storage.file.share.implementation.models.ShareItemInternal;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.models.ListSharesOptions;
 import com.azure.storage.file.share.models.ShareCorsRule;
 import com.azure.storage.file.share.models.ShareItem;
@@ -226,18 +229,13 @@ public PagedIterable listShares(ListSharesOptions options, Duration t
         }
 
         BiFunction> retriever = (nextMarker, pageSize) -> {
-            Callable> operation = () -> this.azureFileStorageClient.getServices()
-                .listSharesSegmentNoCustomHeadersSinglePage(prefix, nextMarker,
-                    pageSize == null ? maxResultsPerPage : pageSize, include, null, finalContext);
+            RequestOptions requestOptions = RequestOptionsHelper.listSharesRequestOptions(prefix, nextMarker,
+                pageSize == null ? maxResultsPerPage : pageSize, include, finalContext);
+            Callable> operation
+                = () -> this.azureFileStorageClient.getServices().listSharesSegmentWithResponse(requestOptions);
 
-            PagedResponse response = sendRequest(operation, timeout, ShareStorageException.class);
-
-            List value = response.getValue() == null
-                ? Collections.emptyList()
-                : response.getValue().stream().map(ModelHelper::populateShareItem).collect(Collectors.toList());
-
-            return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                value, response.getContinuationToken(), ModelHelper.transformListSharesHeaders(response.getHeaders()));
+            Response response = sendRequest(operation, timeout, ShareStorageException.class);
+            return ModelHelper.mapListSharesResponse(response);
         };
 
         return new PagedIterable<>(pageSize -> retriever.apply(null, pageSize), retriever);
@@ -301,11 +299,12 @@ public ShareServiceProperties getProperties() {
     @ServiceMethod(returns = ReturnType.SINGLE)
     public Response getPropertiesWithResponse(Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        Callable> operation = () -> this.azureFileStorageClient.getServices()
-            .getPropertiesNoCustomHeadersWithResponse(null, finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getServices().getPropertiesWithResponse(requestOptions);
 
-        Response response = sendRequest(operation, timeout, ShareStorageException.class);
-        return new SimpleResponse<>(response, response.getValue());
+        Response response = sendRequest(operation, timeout, ShareStorageException.class);
+        return ModelHelper.mapGetServicePropertiesResponse(response);
     }
 
     /**
@@ -433,8 +432,9 @@ public void setProperties(ShareServiceProperties properties) {
     public Response setPropertiesWithResponse(ShareServiceProperties properties, Duration timeout,
         Context context) {
         Context finalContext = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
         Callable> operation = () -> this.azureFileStorageClient.getServices()
-            .setPropertiesNoCustomHeadersWithResponse(properties, null, finalContext);
+            .setPropertiesWithResponse(RequestOptionsHelper.serializeToXml(properties), requestOptions);
 
         return sendRequest(operation, timeout, ShareStorageException.class);
     }
@@ -601,8 +601,12 @@ public Response deleteShareWithResponse(String shareName, String snapshot,
         Context finalContext = context == null ? Context.NONE : context;
         DeleteSnapshotsOptionType deleteSnapshots
             = CoreUtils.isNullOrEmpty(snapshot) ? DeleteSnapshotsOptionType.INCLUDE : null;
-        Callable> operation = () -> this.azureFileStorageClient.getShares()
-            .deleteNoCustomHeadersWithResponse(shareName, snapshot, null, deleteSnapshots, null, finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.addDeleteSnapshotsHeader(requestOptions, deleteSnapshots);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getShares().deleteWithResponse(requestOptions);
 
         return sendRequest(operation, timeout, ShareStorageException.class);
     }
@@ -793,9 +797,11 @@ public ShareClient undeleteShare(String deletedShareName, String deletedShareVer
     public Response undeleteShareWithResponse(String deletedShareName, String deletedShareVersion,
         Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        Callable> operation = () -> this.azureFileStorageClient.getShares()
-            .restoreNoCustomHeadersWithResponse(deletedShareName, null, null, deletedShareName, deletedShareVersion,
-                finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addUndeleteShareHeaders(requestOptions, deletedShareName, deletedShareVersion);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, deletedShareName);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getShares().restoreWithResponse(requestOptions);
 
         return new SimpleResponse<>(sendRequest(operation, timeout, ShareStorageException.class),
             getShareClient(deletedShareName));
@@ -851,17 +857,18 @@ public Response getUserDelegationKeyWithResponse(ShareGetUser
                 new IllegalArgumentException("`start` must be null or a datetime before `expiry`."));
         }
 
-        Callable> operation
-            = () -> this.azureFileStorageClient.getServices()
-                .getUserDelegationKeyWithResponse(new KeyInfo()
-                    .setStart(options.getStartsOn() == null
-                        ? ""
-                        : Constants.ISO_8601_UTC_DATE_FORMATTER.format(options.getStartsOn()))
-                    .setExpiry(Constants.ISO_8601_UTC_DATE_FORMATTER.format(options.getExpiresOn()))
-                    .setDelegatedUserTenantId(options.getDelegatedUserTenantId()), null, null, finalContext);
-
-        ResponseBase response
-            = sendRequest(operation, timeout, ShareStorageException.class);
-        return new SimpleResponse<>(response, response.getValue());
+        Callable> operation = () -> {
+            KeyInfo keyInfo = new KeyInfo(Constants.ISO_8601_UTC_DATE_FORMATTER.format(options.getExpiresOn()))
+                .setStart(options.getStartsOn() == null
+                    ? ""
+                    : Constants.ISO_8601_UTC_DATE_FORMATTER.format(options.getStartsOn()))
+                .setDelegatedUserTenantId(options.getDelegatedUserTenantId());
+            RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+            return this.azureFileStorageClient.getServices()
+                .getUserDelegationKeyWithResponse(RequestOptionsHelper.serializeToXml(keyInfo), requestOptions);
+        };
+
+        Response response = sendRequest(operation, timeout, ShareStorageException.class);
+        return ModelHelper.mapGetUserDelegationKeyResponse(response);
     }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
index bdde12394a4c..a0c88a402b35 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
@@ -784,6 +784,25 @@ private PagedResponse listSharesSegmentSinglePage(RequestOptions req
      * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
      * @return an enumeration of shares as paginated response with {@link PagedIterable}.
      */
+    public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {
+        final String accept = "application/xml";
+        try {
+            return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    public Mono> listSharesSegmentWithResponseAsync(RequestOptions requestOptions) {
+        final String accept = "application/xml";
+        return FluxUtil
+            .withContext(
+                context -> service.listSharesSegment(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                    this.client.getFileRequestIntent(), accept, requestOptions, context))
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
+    }
+
     @ServiceMethod(returns = ReturnType.COLLECTION)
     public PagedIterable listSharesSegment(RequestOptions requestOptions) {
         return new PagedIterable<>(() -> listSharesSegmentSinglePage(requestOptions));
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
index ff13b4b28a59..320e12557ce0 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
@@ -46,6 +46,7 @@
 import com.azure.storage.file.share.implementation.models.FilesUploadRangeHeaders;
 import com.azure.storage.file.share.implementation.models.InternalShareFileItemProperties;
 import com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse;
+import com.azure.storage.file.share.implementation.models.ListSharesResponse;
 import com.azure.storage.file.share.implementation.models.ServicesListSharesSegmentHeaders;
 import com.azure.storage.file.share.implementation.models.ShareItemInternal;
 import com.azure.storage.file.share.implementation.models.SharePropertiesInternal;
@@ -86,11 +87,13 @@
 import com.azure.storage.file.share.models.ShareItem;
 import com.azure.storage.file.share.models.ShareProperties;
 import com.azure.storage.file.share.models.ShareProtocols;
+import com.azure.storage.file.share.models.ShareServiceProperties;
 import com.azure.storage.file.share.models.ShareSignedIdentifier;
 import com.azure.storage.file.share.models.ShareSnapshotInfo;
 import com.azure.storage.file.share.models.ShareSnapshotsDeleteOptionType;
 import com.azure.storage.file.share.models.ShareStatistics;
 import com.azure.storage.file.share.models.ShareStorageException;
+import com.azure.storage.file.share.models.UserDelegationKey;
 import com.azure.storage.file.share.options.ShareFileCopyOptions;
 import com.azure.xml.XmlReader;
 
@@ -557,6 +560,31 @@ public static Response mapGetPermissionResponse(Response res
         return new SimpleResponse<>(response, response.getValue().toObject(SharePermission.class).getPermission());
     }
 
+    public static Response mapGetServicePropertiesResponse(Response response) {
+        return new SimpleResponse<>(response, deserializeXml(response.getValue(), ShareServiceProperties::fromXml));
+    }
+
+    public static Response mapGetUserDelegationKeyResponse(Response response) {
+        return new SimpleResponse<>(response, deserializeXml(response.getValue(), UserDelegationKey::fromXml));
+    }
+
+    /**
+     * Deserializes a List Shares Segment response envelope into a {@link PagedResponse} of {@link ShareItem}, carrying
+     * the {@code NextMarker} as the continuation token. The protocol paging helpers discard {@code NextMarker}, so the
+     * hand-written {@code ShareServiceClient#listShares} deserializes the full {@code ListSharesResponse} envelope here.
+     */
+    public static PagedResponse mapListSharesResponse(Response response) {
+        ListSharesResponse listSharesResponse = deserializeXml(response.getValue(), ListSharesResponse::fromXml);
+        List value = listSharesResponse.getShareItems() == null
+            ? Collections.emptyList()
+            : listSharesResponse.getShareItems()
+                .stream()
+                .map(ModelHelper::populateShareItem)
+                .collect(java.util.stream.Collectors.toList());
+        return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(), value,
+            listSharesResponse.getNextMarker(), transformListSharesHeaders(response.getHeaders()));
+    }
+
     /** Deserializes an XML response body via the model's {@code fromXml}. */
     private static  T deserializeXml(BinaryData body, XmlDeserializer deserializer) {
         try (XmlReader reader = XmlReader.fromStream(body.toStream())) {
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
index aa48ea2c6769..3142c9578adb 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
@@ -12,6 +12,7 @@
 import com.azure.storage.common.implementation.Constants;
 import com.azure.storage.file.share.implementation.XmlSerializer;
 import com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType;
+import com.azure.storage.file.share.implementation.models.ListSharesIncludeType;
 import com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper;
 import com.azure.storage.file.share.models.FilePermissionFormat;
 import com.azure.storage.file.share.models.ShareSignedIdentifier;
@@ -34,6 +35,9 @@ public final class RequestOptionsHelper {
 
     private static final HttpHeaderName X_MS_LEASE_ID = HttpHeaderName.fromString("x-ms-lease-id");
     private static final HttpHeaderName X_MS_DELETE_SNAPSHOTS = HttpHeaderName.fromString("x-ms-delete-snapshots");
+    private static final HttpHeaderName X_MS_DELETED_SHARE_NAME = HttpHeaderName.fromString("x-ms-deleted-share-name");
+    private static final HttpHeaderName X_MS_DELETED_SHARE_VERSION
+        = HttpHeaderName.fromString("x-ms-deleted-share-version");
     private static final HttpHeaderName X_MS_FILE_PERMISSION_FORMAT
         = HttpHeaderName.fromString("x-ms-file-permission-format");
     private static final HttpHeaderName X_MS_SHARE_QUOTA = HttpHeaderName.fromString("x-ms-share-quota");
@@ -55,6 +59,48 @@ public final class RequestOptionsHelper {
 
     private static final ObjectSerializer XML_SERIALIZER = new XmlSerializer();
 
+    /**
+     * Serializes an XML request body model (e.g. {@link com.azure.storage.file.share.models.ShareServiceProperties} or
+     * {@code KeyInfo}) to {@link BinaryData} for protocol methods that accept the body as an explicit parameter.
+     *
+     * @param xmlSerializable the XML-serializable model to serialize.
+     * @return the serialized request body.
+     */
+    public static BinaryData serializeToXml(Object xmlSerializable) {
+        return BinaryData.fromObject(xmlSerializable, XML_SERIALIZER);
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for the List Shares Segment operation, wiring the {@code prefix},
+     * {@code marker}, {@code maxresults} and {@code include} query parameters onto the account-scoped request.
+     *
+     * @param prefix filters results to share names beginning with this prefix; may be {@code null}.
+     * @param marker continuation token identifying the page to return; may be {@code null}.
+     * @param maxResults maximum number of shares to return per page; may be {@code null}.
+     * @param include datasets to include in the response; may be {@code null} or empty.
+     * @param context the request context.
+     * @return the configured request options.
+     */
+    public static RequestOptions listSharesRequestOptions(String prefix, String marker, Integer maxResults,
+        List include, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        if (prefix != null) {
+            requestOptions.addQueryParam("prefix", prefix, false);
+        }
+        if (marker != null) {
+            requestOptions.addQueryParam("marker", marker, false);
+        }
+        if (maxResults != null) {
+            requestOptions.addQueryParam("maxresults", String.valueOf(maxResults), false);
+        }
+        if (include != null && !include.isEmpty()) {
+            requestOptions.addQueryParam("include",
+                include.stream().map(ListSharesIncludeType::toString).collect(java.util.stream.Collectors.joining(",")),
+                false);
+        }
+        return requestOptions;
+    }
+
     /**
      * The generated protocol methods target the account-scoped service URL; this appends the resource path (e.g.
      * {@code "{shareName}"} or {@code "{shareName}/{filePath}"}) to the request URL while preserving the route's query
@@ -112,6 +158,33 @@ public static void addDeleteSnapshotsHeader(RequestOptions requestOptions, Share
         }
     }
 
+    /**
+     * Sets the {@code x-ms-delete-snapshots} header from the wire {@link DeleteSnapshotsOptionType} used by the
+     * service-level {@code deleteShare} convenience.
+     *
+     * @param requestOptions the request options to mutate.
+     * @param option the delete-snapshots option; a no-op when {@code null}.
+     */
+    public static void addDeleteSnapshotsHeader(RequestOptions requestOptions, DeleteSnapshotsOptionType option) {
+        if (option != null) {
+            requestOptions.setHeader(X_MS_DELETE_SNAPSHOTS, option.toString());
+        }
+    }
+
+    /**
+     * Sets the {@code x-ms-deleted-share-name} and {@code x-ms-deleted-share-version} headers for the
+     * {@code undeleteShare} (restore) operation.
+     *
+     * @param requestOptions the request options to mutate.
+     * @param deletedShareName the name of the previously deleted share to restore.
+     * @param deletedShareVersion the version of the previously deleted share to restore.
+     */
+    public static void addUndeleteShareHeaders(RequestOptions requestOptions, String deletedShareName,
+        String deletedShareVersion) {
+        requestOptions.setHeader(X_MS_DELETED_SHARE_NAME, deletedShareName);
+        requestOptions.setHeader(X_MS_DELETED_SHARE_VERSION, deletedShareVersion);
+    }
+
     /**
      * Builds the {@link RequestOptions} for {@code Share.create}: the share-provisioning headers plus optional
      * metadata, scoped to the share resource. {@code enabledProtocols} is pre-computed by the caller.
diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
index 1160579425f3..16787e38904b 100644
--- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
+++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
@@ -79,6 +79,8 @@ public void customize(LibraryCustomization customization, Logger logger) {
 
         retypeServiceVersionToShareServiceVersion(customization, logger);
 
+        exposeRawListSharesSegment(customization, logger);
+
         restoreFluentModels(customization, logger);
 
         customization.getClass("com.azure.storage.file.share.models", "ShareTokenIntent")
@@ -134,6 +136,46 @@ private static void retypeServiceVersionToShareServiceVersion(LibraryCustomizati
         }
     }
 
+    /**
+     * Exposes raw {@code Response} accessors for the List Shares Segment operation. The generated
+     * {@code listSharesSegmentSinglePage} paging helpers deserialize only the per-item {@code ShareItemInternal}
+     * elements and discard the {@code NextMarker} from the XML envelope, but the hand-written
+     * {@code ShareServiceClient#listShares} manages continuation itself. These methods return the full response body so
+     * the client can deserialize {@code ListSharesResponse} (items + {@code NextMarker}).
+     *
+     * @param customization The library customization.
+     * @param logger The logger.
+     */
+    private static void exposeRawListSharesSegment(LibraryCustomization customization, Logger logger) {
+        Editor editor = customization.getRawEditor();
+        String path = PKG_ROOT + "implementation/ServicesImpl.java";
+        String content = editor.getFileContent(path);
+        String anchor = "    public PagedIterable listSharesSegment(RequestOptions requestOptions) {";
+        if (content.contains("listSharesSegmentWithResponse(") || !content.contains(anchor)) {
+            return;
+        }
+        String rawMethods
+            = "    public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {\n"
+                + "        final String accept = \"application/xml\";\n"
+                + "        try {\n"
+                + "            return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
+                + "                this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);\n"
+                + "        } catch (ShareStorageExceptionInternal internalException) {\n"
+                + "            throw ModelHelper.mapToShareStorageException(internalException);\n"
+                + "        }\n"
+                + "    }\n\n"
+                + "    public Mono> listSharesSegmentWithResponseAsync(RequestOptions requestOptions) {\n"
+                + "        final String accept = \"application/xml\";\n"
+                + "        return FluxUtil\n"
+                + "            .withContext(context -> service.listSharesSegment(this.client.getUrl(),\n"
+                + "                this.client.getServiceVersion().getVersion(), this.client.getFileRequestIntent(), accept,\n"
+                + "                requestOptions, context))\n"
+                + "            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
+                + "    }\n\n";
+        editor.replaceFile(path, content.replace(anchor, rawMethods + anchor));
+        logger.info("Exposed raw listSharesSegmentWithResponse methods in {}", path);
+    }
+
     /**
      * Restores the "fluent" shape of models that shipped as {@code @Fluent} (public no-arg constructor + setters)
      * before the TypeSpec migration. With {@code required-fields-as-ctor-args: true} (which must stay true so new

From 695fc4536de0783e85082ab660fcf0c57e54c34d Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Tue, 11 Aug 2026 10:31:14 -0700
Subject: [PATCH 08/13] directories checkpoint

---
 .../file/share/ShareDirectoryAsyncClient.java | 100 +++++-----
 .../file/share/ShareDirectoryClient.java      | 140 +++++++-------
 .../implementation/util/ModelHelper.java      |  81 +++++---
 .../util/RequestOptionsHelper.java            | 181 ++++++++++++++++++
 .../main/java/ShareStorageCustomization.java  |  41 ++++
 5 files changed, 397 insertions(+), 146 deletions(-)

diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryAsyncClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryAsyncClient.java
index 575d1d9f9b91..99f8115e0c55 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryAsyncClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryAsyncClient.java
@@ -12,8 +12,10 @@
 import com.azure.core.http.rest.PagedFlux;
 import com.azure.core.http.rest.PagedResponse;
 import com.azure.core.http.rest.PagedResponseBase;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.SimpleResponse;
+import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.CoreUtils;
 import com.azure.core.util.FluxUtil;
@@ -28,6 +30,7 @@
 import com.azure.storage.file.share.implementation.models.ListFilesIncludeType;
 import com.azure.storage.file.share.implementation.models.SourceLeaseAccessConditions;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.implementation.util.ShareSasImplUtil;
 import com.azure.storage.file.share.models.CloseHandlesInfo;
 import com.azure.storage.file.share.models.FilePermissionFormat;
@@ -364,11 +367,11 @@ Mono> createWithResponse(FileSmbProperties smbPrope
         ModelHelper.validateFilePermissionAndKey(filePermission, smbProperties.getFilePermissionKey());
 
         return azureFileStorageClient.getDirectories()
-            .createWithResponseAsync(shareName, directoryPath, null, metadata, filePermission, filePermissionFormat,
-                smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
-                smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
-                smbProperties.getFileChangeTimeString(), posixProperties.getOwner(), posixProperties.getGroup(),
-                posixProperties.getFileMode(), filePropertySemantics, context)
+            .createWithResponseAsync(RequestOptionsHelper.createDirectoryRequestOptions(shareName + "/" + directoryPath,
+                metadata, filePermission, filePermissionFormat, smbProperties.getFilePermissionKey(),
+                smbProperties.getNtfsFileAttributesString(), smbProperties.getFileCreationTimeString(),
+                smbProperties.getFileLastWriteTimeString(), smbProperties.getFileChangeTimeString(), posixProperties,
+                filePropertySemantics, context))
             .map(ModelHelper::mapShareDirectoryInfo);
     }
 
@@ -524,8 +527,9 @@ public Mono> deleteWithResponse() {
 
     Mono> deleteWithResponse(Context context) {
         context = context == null ? Context.NONE : context;
-        return azureFileStorageClient.getDirectories()
-            .deleteNoCustomHeadersWithResponseAsync(shareName, directoryPath, null, context);
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + directoryPath);
+        return azureFileStorageClient.getDirectories().deleteWithResponseAsync(requestOptions);
     }
 
     /**
@@ -661,8 +665,11 @@ public Mono> getPropertiesWithResponse() {
 
     Mono> getPropertiesWithResponse(Context context) {
         context = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + directoryPath);
         return azureFileStorageClient.getDirectories()
-            .getPropertiesWithResponseAsync(shareName, directoryPath, snapshot, null, context)
+            .getPropertiesWithResponseAsync(requestOptions)
             .map(ModelHelper::mapShareDirectoryPropertiesResponse);
     }
 
@@ -778,11 +785,11 @@ Mono> setPropertiesWithResponse(FileSmbProperties s
         ModelHelper.validateFilePermissionAndKey(filePermission, smbProperties.getFilePermissionKey());
 
         return azureFileStorageClient.getDirectories()
-            .setPropertiesWithResponseAsync(shareName, directoryPath, null, filePermission, filePermissionFormat,
+            .setPropertiesWithResponseAsync(RequestOptionsHelper.setDirectoryPropertiesRequestOptions(
+                shareName + "/" + directoryPath, filePermission, filePermissionFormat,
                 smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
                 smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
-                smbProperties.getFileChangeTimeString(), posixProperties.getOwner(), posixProperties.getGroup(),
-                posixProperties.getFileMode(), context)
+                smbProperties.getFileChangeTimeString(), posixProperties, context))
             .map(ModelHelper::mapSetPropertiesResponse);
     }
 
@@ -871,8 +878,11 @@ public Mono> setMetadataWithResponse(Map
     Mono> setMetadataWithResponse(Map metadata,
         Context context) {
         context = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        RequestOptionsHelper.addMetadata(requestOptions, metadata);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + directoryPath);
         return azureFileStorageClient.getDirectories()
-            .setMetadataWithResponseAsync(shareName, directoryPath, null, metadata, context)
+            .setMetadataWithResponseAsync(requestOptions)
             .map(ModelHelper::setShareDirectoryMetadataResponse);
     }
 
@@ -997,17 +1007,13 @@ PagedFlux listFilesAndDirectoriesWithOptionalTimeout(ShareListFil
         // these options must be absent from request if empty or false
         final List finalIncludeTypes = includeTypes.isEmpty() ? null : includeTypes;
 
-        BiFunction>> retriever
-            = (marker, pageSize) -> StorageImplUtils
-                .applyOptionalTimeout(this.azureFileStorageClient.getDirectories()
-                    .listFilesAndDirectoriesSegmentNoCustomHeadersWithResponseAsync(shareName, directoryPath,
-                        modifiedOptions.getPrefix(), snapshot, marker,
-                        pageSize == null ? modifiedOptions.getMaxResultsPerPage() : pageSize, null, finalIncludeTypes,
-                        modifiedOptions.includeExtendedInfo(), context),
-                    timeout)
-                .map(response -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(),
-                    response.getHeaders(), ModelHelper.convertResponseAndGetNumOfResults(response),
-                    response.getValue().getNextMarker(), null));
+        BiFunction>> retriever = (marker,
+            pageSize) -> StorageImplUtils.applyOptionalTimeout(this.azureFileStorageClient.getDirectories()
+                .listFilesAndDirectoriesSegmentWithResponseAsync(RequestOptionsHelper
+                    .listFilesAndDirectoriesRequestOptions(shareName + "/" + directoryPath, modifiedOptions.getPrefix(),
+                        snapshot, marker, pageSize == null ? modifiedOptions.getMaxResultsPerPage() : pageSize,
+                        finalIncludeTypes, modifiedOptions.includeExtendedInfo(), context)),
+                timeout).map(ModelHelper::mapListFilesAndDirectoriesResponse);
 
         return new PagedFlux<>(pageSize -> retriever.apply(null, pageSize), retriever);
     }
@@ -1046,14 +1052,14 @@ public PagedFlux listHandles(Integer maxResultPerPage, boolean recur
 
     PagedFlux listHandlesWithOptionalTimeout(Integer maxResultPerPage, boolean recursive, Duration timeout,
         Context context) {
-        Function>> retriever = marker -> StorageImplUtils
-            .applyOptionalTimeout(this.azureFileStorageClient.getDirectories()
-                .listHandlesWithResponseAsync(shareName, directoryPath, marker, maxResultPerPage, null, snapshot,
-                    recursive, context),
-                timeout)
-            .map(response -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(),
-                response.getHeaders(), ModelHelper.transformHandleItems(response.getValue().getHandleList()),
-                response.getValue().getNextMarker(), response.getDeserializedHeaders()));
+        Function>> retriever
+            = marker -> StorageImplUtils
+                .applyOptionalTimeout(
+                    this.azureFileStorageClient.getDirectories()
+                        .listHandlesWithResponseAsync(RequestOptionsHelper.listHandlesRequestOptions(
+                            shareName + "/" + directoryPath, marker, maxResultPerPage, snapshot, recursive, context)),
+                    timeout)
+                .map(ModelHelper::mapDirectoryListHandlesResponse);
 
         return new PagedFlux<>(() -> retriever.apply(null), retriever);
     }
@@ -1119,11 +1125,10 @@ public Mono> forceCloseHandleWithResponse(String hand
 
     Mono> forceCloseHandleWithResponse(String handleId, Context context) {
         return this.azureFileStorageClient.getDirectories()
-            .forceCloseHandlesWithResponseAsync(shareName, directoryPath, handleId, null, null, snapshot, false,
-                context)
-            .map(response -> new SimpleResponse<>(response,
-                new CloseHandlesInfo(response.getDeserializedHeaders().getXMsNumberOfHandlesClosed(),
-                    response.getDeserializedHeaders().getXMsNumberOfHandlesFailed())));
+            .forceCloseHandlesWithResponseAsync(handleId,
+                RequestOptionsHelper.forceCloseHandlesRequestOptions(shareName + "/" + directoryPath, null, snapshot,
+                    false, context))
+            .map(ModelHelper::mapDirectoryForceCloseHandlesResponse);
     }
 
     /**
@@ -1163,15 +1168,11 @@ public Mono forceCloseAllHandles(boolean recursive) {
     PagedFlux forceCloseAllHandlesWithTimeout(boolean recursive, Duration timeout, Context context) {
         Function>> retriever = marker -> StorageImplUtils
             .applyOptionalTimeout(this.azureFileStorageClient.getDirectories()
-                .forceCloseHandlesWithResponseAsync(shareName, directoryPath, "*", null, marker, snapshot, recursive,
-                    context),
+                .forceCloseHandlesWithResponseAsync("*",
+                    RequestOptionsHelper.forceCloseHandlesRequestOptions(shareName + "/" + directoryPath, marker,
+                        snapshot, recursive, context)),
                 timeout)
-            .map(response -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(),
-                response.getHeaders(),
-                Collections
-                    .singletonList(new CloseHandlesInfo(response.getDeserializedHeaders().getXMsNumberOfHandlesClosed(),
-                        response.getDeserializedHeaders().getXMsNumberOfHandlesFailed())),
-                response.getDeserializedHeaders().getXMsMarker(), response.getDeserializedHeaders()));
+            .map(ModelHelper::mapDirectoryForceCloseHandlesPagedResponse);
 
         return new PagedFlux<>(() -> retriever.apply(null), retriever);
     }
@@ -1282,11 +1283,12 @@ Mono> renameWithResponse(ShareFileRenameOpti
         renameSource = this.sasToken != null ? renameSource + "?" + this.sasToken.getSignature() : renameSource;
 
         return destinationDirectoryClient.azureFileStorageClient.getDirectories()
-            .renameWithResponseAsync(destinationDirectoryClient.getShareName(),
-                destinationDirectoryClient.getDirectoryPath(), renameSource, null /* timeout */,
-                options.getReplaceIfExists(), options.isIgnoreReadOnly(), options.getFilePermission(),
-                options.getFilePermissionFormat(), filePermissionKey, options.getMetadata(), sourceConditions,
-                destinationConditions, smbInfo, context)
+            .renameWithResponseAsync(renameSource,
+                RequestOptionsHelper.renameDirectoryRequestOptions(
+                    destinationDirectoryClient.getShareName() + "/" + destinationDirectoryClient.getDirectoryPath(),
+                    options.getReplaceIfExists(), options.isIgnoreReadOnly(), options.getFilePermission(),
+                    options.getFilePermissionFormat(), filePermissionKey, options.getMetadata(), sourceConditions,
+                    destinationConditions, smbInfo, context))
             .map(response -> new SimpleResponse<>(response, destinationDirectoryClient));
     }
 
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryClient.java
index 32c7ceced009..7d5630e90ca6 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryClient.java
@@ -13,9 +13,11 @@
 import com.azure.core.http.rest.PagedIterable;
 import com.azure.core.http.rest.PagedResponse;
 import com.azure.core.http.rest.PagedResponseBase;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
+import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.CoreUtils;
 import com.azure.core.util.logging.ClientLogger;
@@ -36,6 +38,7 @@
 import com.azure.storage.file.share.implementation.models.ListHandlesResponse;
 import com.azure.storage.file.share.implementation.models.SourceLeaseAccessConditions;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.implementation.util.ShareSasImplUtil;
 import com.azure.storage.file.share.models.CloseHandlesInfo;
 import com.azure.storage.file.share.models.FilePosixProperties;
@@ -354,13 +357,14 @@ public Response createWithResponse(ShareDirectoryCreateOptio
         ModelHelper.validateFilePermissionAndKey(finalOptions.getFilePermission(),
             smbProperties.getFilePermissionKey());
 
-        Callable> operation = () -> azureFileStorageClient.getDirectories()
-            .createWithResponse(shareName, directoryPath, null, finalOptions.getMetadata(),
-                finalOptions.getFilePermission(), finalOptions.getFilePermissionFormat(),
-                smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
-                smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
-                smbProperties.getFileChangeTimeString(), fileposixProperties.getOwner(), fileposixProperties.getGroup(),
-                fileposixProperties.getFileMode(), finalOptions.getFilePropertySemantics(), finalContext);
+        RequestOptions requestOptions = RequestOptionsHelper.createDirectoryRequestOptions(
+            shareName + "/" + directoryPath, finalOptions.getMetadata(), finalOptions.getFilePermission(),
+            finalOptions.getFilePermissionFormat(), smbProperties.getFilePermissionKey(),
+            smbProperties.getNtfsFileAttributesString(), smbProperties.getFileCreationTimeString(),
+            smbProperties.getFileLastWriteTimeString(), smbProperties.getFileChangeTimeString(), fileposixProperties,
+            finalOptions.getFilePropertySemantics(), finalContext);
+        Callable> operation
+            = () -> azureFileStorageClient.getDirectories().createWithResponse(requestOptions);
 
         return ModelHelper.mapShareDirectoryInfo(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -495,8 +499,10 @@ public void delete() {
     @ServiceMethod(returns = ReturnType.SINGLE)
     public Response deleteWithResponse(Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        Callable> operation = () -> this.azureFileStorageClient.getDirectories()
-            .deleteNoCustomHeadersWithResponse(shareName, directoryPath, null, finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + directoryPath);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getDirectories().deleteWithResponse(requestOptions);
 
         return sendRequest(operation, timeout, ShareStorageException.class);
     }
@@ -623,9 +629,11 @@ public ShareDirectoryProperties getProperties() {
     @ServiceMethod(returns = ReturnType.SINGLE)
     public Response getPropertiesWithResponse(Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        Callable> operation
-            = () -> this.azureFileStorageClient.getDirectories()
-                .getPropertiesWithResponse(shareName, directoryPath, snapshot, null, finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + directoryPath);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getDirectories().getPropertiesWithResponse(requestOptions);
 
         return ModelHelper
             .mapShareDirectoryPropertiesResponse(sendRequest(operation, timeout, ShareStorageException.class));
@@ -738,14 +746,13 @@ public Response setPropertiesWithResponse(ShareDirectorySetP
         // Checks that file permission and file permission key are valid
         ModelHelper.validateFilePermissionAndKey(filePermission.getPermission(), smbProperties.getFilePermissionKey());
 
-        Callable> operation
-            = () -> this.azureFileStorageClient.getDirectories()
-                .setPropertiesWithResponse(shareName, directoryPath, null, filePermission.getPermission(),
-                    filePermission.getPermissionFormat(), smbProperties.getFilePermissionKey(),
-                    smbProperties.getNtfsFileAttributesString(), smbProperties.getFileCreationTimeString(),
-                    smbProperties.getFileLastWriteTimeString(), smbProperties.getFileChangeTimeString(),
-                    fileposixProperties.getOwner(), fileposixProperties.getGroup(), fileposixProperties.getFileMode(),
-                    finalContext);
+        RequestOptions requestOptions = RequestOptionsHelper.setDirectoryPropertiesRequestOptions(
+            shareName + "/" + directoryPath, filePermission.getPermission(), filePermission.getPermissionFormat(),
+            smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
+            smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
+            smbProperties.getFileChangeTimeString(), fileposixProperties, finalContext);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getDirectories().setPropertiesWithResponse(requestOptions);
 
         return ModelHelper.mapSetPropertiesResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -832,9 +839,11 @@ public ShareDirectorySetMetadataInfo setMetadata(Map metadata) {
     public Response setMetadataWithResponse(Map metadata,
         Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        Callable> operation
-            = () -> this.azureFileStorageClient.getDirectories()
-                .setMetadataWithResponse(shareName, directoryPath, null, metadata, finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addMetadata(requestOptions, metadata);
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + directoryPath);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getDirectories().setMetadataWithResponse(requestOptions);
 
         return ModelHelper
             .setShareDirectoryMetadataResponse(sendRequest(operation, timeout, ShareStorageException.class));
@@ -964,18 +973,15 @@ public PagedIterable listFilesAndDirectories(ShareListFilesAndDir
         final List finalIncludeTypes = includeTypes.isEmpty() ? null : includeTypes;
 
         BiFunction> retriever = (marker, pageSize) -> {
-            Callable> operation
-                = () -> this.azureFileStorageClient.getDirectories()
-                    .listFilesAndDirectoriesSegmentNoCustomHeadersWithResponse(shareName, directoryPath,
-                        modifiedOptions.getPrefix(), snapshot, marker,
-                        pageSize == null ? modifiedOptions.getMaxResultsPerPage() : pageSize, null, finalIncludeTypes,
-                        modifiedOptions.includeExtendedInfo(), finalContext);
-
-            Response response
-                = sendRequest(operation, timeout, ShareStorageException.class);
-
-            return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                ModelHelper.convertResponseAndGetNumOfResults(response), response.getValue().getNextMarker(), null);
+            RequestOptions requestOptions = RequestOptionsHelper.listFilesAndDirectoriesRequestOptions(
+                shareName + "/" + directoryPath, modifiedOptions.getPrefix(), snapshot, marker,
+                pageSize == null ? modifiedOptions.getMaxResultsPerPage() : pageSize, finalIncludeTypes,
+                modifiedOptions.includeExtendedInfo(), finalContext);
+            Callable> operation = () -> this.azureFileStorageClient.getDirectories()
+                .listFilesAndDirectoriesSegmentWithResponse(requestOptions);
+
+            return ModelHelper
+                .mapListFilesAndDirectoriesResponse(sendRequest(operation, timeout, ShareStorageException.class));
         };
 
         return new PagedIterable<>(pageSize -> retriever.apply(null, pageSize), retriever);
@@ -1018,18 +1024,13 @@ PagedIterable listHandlesWithOptionalTimeout(Integer maxResultPerPag
         Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
         Function> retriever = (marker) -> {
-            Callable> operation
-                = () -> this.azureFileStorageClient.getDirectories()
-                    .listHandlesWithResponse(shareName, directoryPath, marker, maxResultPerPage, null, snapshot,
-                        recursive, finalContext);
-
-            ResponseBase response
-                = sendRequest(operation, timeout, ShareStorageException.class);
-
-            return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                ModelHelper.transformHandleItems(response.getValue().getHandleList()),
-                response.getValue().getNextMarker(), response.getDeserializedHeaders());
+            RequestOptions requestOptions = RequestOptionsHelper.listHandlesRequestOptions(
+                shareName + "/" + directoryPath, marker, maxResultPerPage, snapshot, recursive, finalContext);
+            Callable> operation
+                = () -> this.azureFileStorageClient.getDirectories().listHandlesWithResponse(requestOptions);
 
+            return ModelHelper
+                .mapDirectoryListHandlesResponse(sendRequest(operation, timeout, ShareStorageException.class));
         };
         return new PagedIterable<>(() -> retriever.apply(null), retriever);
     }
@@ -1094,17 +1095,13 @@ public CloseHandlesInfo forceCloseHandle(String handleId) {
     public Response forceCloseHandleWithResponse(String handleId, Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
 
-        Callable> operation
-            = () -> this.azureFileStorageClient.getDirectories()
-                .forceCloseHandlesWithResponse(shareName, directoryPath, handleId, null, null, snapshot, false,
-                    finalContext);
-
-        ResponseBase response
-            = sendRequest(operation, timeout, ShareStorageException.class);
+        RequestOptions requestOptions = RequestOptionsHelper
+            .forceCloseHandlesRequestOptions(shareName + "/" + directoryPath, null, snapshot, false, finalContext);
+        Callable> operation = () -> this.azureFileStorageClient.getDirectories()
+            .forceCloseHandlesWithResponse(handleId, requestOptions);
 
-        return new SimpleResponse<>(response,
-            new CloseHandlesInfo(response.getDeserializedHeaders().getXMsNumberOfHandlesClosed(),
-                response.getDeserializedHeaders().getXMsNumberOfHandlesFailed()));
+        return ModelHelper
+            .mapDirectoryForceCloseHandlesResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
 
     /**
@@ -1138,19 +1135,13 @@ public CloseHandlesInfo forceCloseAllHandles(boolean recursive, Duration timeout
         Context finalContext = context == null ? Context.NONE : context;
 
         Function> retriever = (marker) -> {
-            Callable> operation
-                = () -> this.azureFileStorageClient.getDirectories()
-                    .forceCloseHandlesWithResponse(shareName, directoryPath, "*", null, marker, snapshot, recursive,
-                        finalContext);
-
-            ResponseBase response
-                = sendRequest(operation, timeout, ShareStorageException.class);
-
-            return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                Collections
-                    .singletonList(new CloseHandlesInfo(response.getDeserializedHeaders().getXMsNumberOfHandlesClosed(),
-                        response.getDeserializedHeaders().getXMsNumberOfHandlesFailed())),
-                response.getDeserializedHeaders().getXMsMarker(), response.getDeserializedHeaders());
+            RequestOptions requestOptions = RequestOptionsHelper.forceCloseHandlesRequestOptions(
+                shareName + "/" + directoryPath, marker, snapshot, recursive, finalContext);
+            Callable> operation
+                = () -> this.azureFileStorageClient.getDirectories().forceCloseHandlesWithResponse("*", requestOptions);
+
+            return ModelHelper.mapDirectoryForceCloseHandlesPagedResponse(
+                sendRequest(operation, timeout, ShareStorageException.class));
         };
 
         return new PagedIterable<>(() -> retriever.apply(null), retriever).stream()
@@ -1264,11 +1255,12 @@ public Response renameWithResponse(ShareFileRenameOptions
             : this.getDirectoryUrl();
 
         Callable> operation = () -> destinationDirectoryClient.azureFileStorageClient.getDirectories()
-            .renameNoCustomHeadersWithResponse(destinationDirectoryClient.getShareName(),
-                destinationDirectoryClient.getDirectoryPath(), renameSource, null /* timeout */,
-                options.getReplaceIfExists(), options.isIgnoreReadOnly(), options.getFilePermission(),
-                options.getFilePermissionFormat(), filePermissionKey, options.getMetadata(), sourceConditions,
-                destinationConditions, smbInfo, finalContext);
+            .renameWithResponse(renameSource,
+                RequestOptionsHelper.renameDirectoryRequestOptions(
+                    destinationDirectoryClient.getShareName() + "/" + destinationDirectoryClient.getDirectoryPath(),
+                    options.getReplaceIfExists(), options.isIgnoreReadOnly(), options.getFilePermission(),
+                    options.getFilePermissionFormat(), filePermissionKey, options.getMetadata(), sourceConditions,
+                    destinationConditions, smbInfo, finalContext));
 
         return new SimpleResponse<>(sendRequest(operation, timeout, ShareStorageException.class),
             destinationDirectoryClient);
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
index 320e12557ce0..30aa6b7a84be 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
@@ -30,7 +30,9 @@
 import com.azure.storage.file.share.implementation.accesshelpers.ShareFileSymbolicLinkInfoHelper;
 import com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType;
 import com.azure.storage.file.share.implementation.models.DirectoriesCreateHeaders;
+import com.azure.storage.file.share.implementation.models.DirectoriesForceCloseHandlesHeaders;
 import com.azure.storage.file.share.implementation.models.DirectoriesGetPropertiesHeaders;
+import com.azure.storage.file.share.implementation.models.DirectoriesListHandlesHeaders;
 import com.azure.storage.file.share.implementation.models.DirectoriesSetMetadataHeaders;
 import com.azure.storage.file.share.implementation.models.DirectoriesSetPropertiesHeaders;
 import com.azure.storage.file.share.implementation.models.FileProperty;
@@ -46,6 +48,7 @@
 import com.azure.storage.file.share.implementation.models.FilesUploadRangeHeaders;
 import com.azure.storage.file.share.implementation.models.InternalShareFileItemProperties;
 import com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse;
+import com.azure.storage.file.share.implementation.models.ListHandlesResponse;
 import com.azure.storage.file.share.implementation.models.ListSharesResponse;
 import com.azure.storage.file.share.implementation.models.ServicesListSharesSegmentHeaders;
 import com.azure.storage.file.share.implementation.models.ShareItemInternal;
@@ -58,6 +61,7 @@
 import com.azure.storage.file.share.implementation.models.SharesGetPropertiesHeaders;
 import com.azure.storage.file.share.implementation.models.StringEncoded;
 import com.azure.storage.file.share.models.ClearRange;
+import com.azure.storage.file.share.models.CloseHandlesInfo;
 import com.azure.storage.file.share.models.CopyStatusType;
 import com.azure.storage.file.share.models.CopyableFileSmbPropertiesList;
 import com.azure.storage.file.share.models.FilePosixProperties;
@@ -640,10 +644,10 @@ public static Response mapCreateSnapshotResponse(Response(response, snapshotInfo);
     }
 
-    public static Response
-        mapShareDirectoryInfo(final ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        OffsetDateTime lastModified = response.getDeserializedHeaders().getLastModified();
+    public static Response mapShareDirectoryInfo(final Response response) {
+        DirectoriesCreateHeaders headers = new DirectoriesCreateHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        OffsetDateTime lastModified = headers.getLastModified();
         FileSmbProperties smbProperties = FileSmbPropertiesHelper.create(response.getHeaders());
         FilePosixProperties posixProperties = FilePosixPropertiesHelper.create(response.getHeaders());
         ShareDirectoryInfo shareDirectoryInfo
@@ -651,12 +655,12 @@ public static Response mapCreateSnapshotResponse(Response(response, shareDirectoryInfo);
     }
 
-    public static Response
-        mapShareDirectoryPropertiesResponse(ResponseBase response) {
-        Map metadata = response.getDeserializedHeaders().getXMsMeta();
-        String eTag = response.getDeserializedHeaders().getETag();
-        OffsetDateTime offsetDateTime = response.getDeserializedHeaders().getLastModified();
-        boolean isServerEncrypted = response.getDeserializedHeaders().isXMsServerEncrypted();
+    public static Response mapShareDirectoryPropertiesResponse(Response response) {
+        DirectoriesGetPropertiesHeaders headers = new DirectoriesGetPropertiesHeaders(response.getHeaders());
+        Map metadata = headers.getXMsMeta();
+        String eTag = headers.getETag();
+        OffsetDateTime offsetDateTime = headers.getLastModified();
+        boolean isServerEncrypted = headers.isXMsServerEncrypted();
         FileSmbProperties smbProperties = FileSmbPropertiesHelper.create(response.getHeaders());
         FilePosixProperties posixProperties = FilePosixPropertiesHelper.create(response.getHeaders());
         ShareDirectoryProperties shareDirectoryProperties = ShareDirectoryPropertiesHelper.create(metadata, eTag,
@@ -664,10 +668,10 @@ public static Response mapCreateSnapshotResponse(Response(response, shareDirectoryProperties);
     }
 
-    public static Response
-        mapSetPropertiesResponse(final ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        OffsetDateTime lastModified = response.getDeserializedHeaders().getLastModified();
+    public static Response mapSetPropertiesResponse(final Response response) {
+        DirectoriesSetPropertiesHeaders headers = new DirectoriesSetPropertiesHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        OffsetDateTime lastModified = headers.getLastModified();
         FileSmbProperties smbProperties = FileSmbPropertiesHelper.create(response.getHeaders());
         FilePosixProperties posixProperties = FilePosixPropertiesHelper.create(response.getHeaders());
         ShareDirectoryInfo shareDirectoryInfo
@@ -676,21 +680,53 @@ public static Response mapCreateSnapshotResponse(Response
-        setShareDirectoryMetadataResponse(final ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        boolean isServerEncrypted = response.getDeserializedHeaders().isXMsRequestServerEncrypted();
+        setShareDirectoryMetadataResponse(final Response response) {
+        DirectoriesSetMetadataHeaders headers = new DirectoriesSetMetadataHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        boolean isServerEncrypted = headers.isXMsRequestServerEncrypted();
         ShareDirectorySetMetadataInfo shareDirectorySetMetadataInfo
             = new ShareDirectorySetMetadataInfo(eTag, isServerEncrypted);
         return new SimpleResponse<>(response, shareDirectorySetMetadataInfo);
     }
 
+    /** Deserializes a List Files And Directories Segment response into a {@link PagedResponse} of {@link ShareFileItem}. */
+    public static PagedResponse mapListFilesAndDirectoriesResponse(Response response) {
+        ListFilesAndDirectoriesSegmentResponse segment
+            = deserializeXml(response.getValue(), ListFilesAndDirectoriesSegmentResponse::fromXml);
+        return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
+            convertResponseAndGetNumOfResults(segment), segment.getNextMarker(), null);
+    }
+
+    /** Deserializes a directory List Handles response into a {@link PagedResponse} of {@link HandleItem}. */
+    public static PagedResponse mapDirectoryListHandlesResponse(Response response) {
+        ListHandlesResponse listHandlesResponse = deserializeXml(response.getValue(), ListHandlesResponse::fromXml);
+        return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
+            transformHandleItems(listHandlesResponse.getHandleList()), listHandlesResponse.getNextMarker(),
+            new DirectoriesListHandlesHeaders(response.getHeaders()));
+    }
+
+    /** Maps a directory Force Close Handles response into the closed/failed handle counts. */
+    public static Response mapDirectoryForceCloseHandlesResponse(Response response) {
+        DirectoriesForceCloseHandlesHeaders headers = new DirectoriesForceCloseHandlesHeaders(response.getHeaders());
+        return new SimpleResponse<>(response,
+            new CloseHandlesInfo(headers.getXMsNumberOfHandlesClosed(), headers.getXMsNumberOfHandlesFailed()));
+    }
+
+    /** Maps a directory Force Close Handles response into a paged result carrying the continuation marker. */
+    public static PagedResponse mapDirectoryForceCloseHandlesPagedResponse(Response response) {
+        DirectoriesForceCloseHandlesHeaders headers = new DirectoriesForceCloseHandlesHeaders(response.getHeaders());
+        return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
+            Collections.singletonList(
+                new CloseHandlesInfo(headers.getXMsNumberOfHandlesClosed(), headers.getXMsNumberOfHandlesFailed())),
+            headers.getXMsMarker(), headers);
+    }
+
     public static List
-        convertResponseAndGetNumOfResults(Response res) {
+        convertResponseAndGetNumOfResults(ListFilesAndDirectoriesSegmentResponse segmentResponse) {
         Set shareFileItems = new TreeSet<>(Comparator.comparing(ShareFileItem::getName));
-        if (res.getValue().getSegment() != null) {
+        if (segmentResponse.getSegment() != null) {
 
-            res.getValue()
-                .getSegment()
+            segmentResponse.getSegment()
                 .getDirectoryItems()
                 .forEach(directoryItem -> shareFileItems
                     .add(new ShareFileItem(ModelHelper.decodeName(directoryItem.getName()), true,
@@ -698,8 +734,7 @@ public static Response mapCreateSnapshotResponse(Response shareFileItems.add(new ShareFileItem(ModelHelper.decodeName(fileItem.getName()),
                     false, fileItem.getFileId(), ModelHelper.transformFileProperty(fileItem.getProperties()),
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
index 3142c9578adb..c562988dbf5a 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
@@ -12,9 +12,15 @@
 import com.azure.storage.common.implementation.Constants;
 import com.azure.storage.file.share.implementation.XmlSerializer;
 import com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType;
+import com.azure.storage.file.share.implementation.models.CopyFileSmbInfo;
+import com.azure.storage.file.share.implementation.models.DestinationLeaseAccessConditions;
+import com.azure.storage.file.share.implementation.models.ListFilesIncludeType;
 import com.azure.storage.file.share.implementation.models.ListSharesIncludeType;
 import com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper;
+import com.azure.storage.file.share.implementation.models.SourceLeaseAccessConditions;
 import com.azure.storage.file.share.models.FilePermissionFormat;
+import com.azure.storage.file.share.models.FilePosixProperties;
+import com.azure.storage.file.share.models.FilePropertySemantics;
 import com.azure.storage.file.share.models.ShareSignedIdentifier;
 import com.azure.storage.file.share.models.ShareSnapshotsDeleteOptionType;
 import com.azure.storage.file.share.options.ShareCreateOptions;
@@ -40,6 +46,28 @@ public final class RequestOptionsHelper {
         = HttpHeaderName.fromString("x-ms-deleted-share-version");
     private static final HttpHeaderName X_MS_FILE_PERMISSION_FORMAT
         = HttpHeaderName.fromString("x-ms-file-permission-format");
+    private static final HttpHeaderName X_MS_FILE_PERMISSION = HttpHeaderName.fromString("x-ms-file-permission");
+    private static final HttpHeaderName X_MS_FILE_PERMISSION_KEY
+        = HttpHeaderName.fromString("x-ms-file-permission-key");
+    private static final HttpHeaderName X_MS_FILE_ATTRIBUTES = HttpHeaderName.fromString("x-ms-file-attributes");
+    private static final HttpHeaderName X_MS_FILE_CREATION_TIME = HttpHeaderName.fromString("x-ms-file-creation-time");
+    private static final HttpHeaderName X_MS_FILE_LAST_WRITE_TIME
+        = HttpHeaderName.fromString("x-ms-file-last-write-time");
+    private static final HttpHeaderName X_MS_FILE_CHANGE_TIME = HttpHeaderName.fromString("x-ms-file-change-time");
+    private static final HttpHeaderName X_MS_OWNER = HttpHeaderName.fromString("x-ms-owner");
+    private static final HttpHeaderName X_MS_GROUP = HttpHeaderName.fromString("x-ms-group");
+    private static final HttpHeaderName X_MS_MODE = HttpHeaderName.fromString("x-ms-mode");
+    private static final HttpHeaderName X_MS_FILE_PROPERTY_SEMANTICS
+        = HttpHeaderName.fromString("x-ms-file-property-semantics");
+    private static final HttpHeaderName X_MS_RECURSIVE = HttpHeaderName.fromString("x-ms-recursive");
+    private static final HttpHeaderName X_MS_FILE_EXTENDED_INFO = HttpHeaderName.fromString("x-ms-file-extended-info");
+    private static final HttpHeaderName X_MS_FILE_RENAME_REPLACE_IF_EXISTS
+        = HttpHeaderName.fromString("x-ms-file-rename-replace-if-exists");
+    private static final HttpHeaderName X_MS_FILE_RENAME_IGNORE_READONLY
+        = HttpHeaderName.fromString("x-ms-file-rename-ignore-readonly");
+    private static final HttpHeaderName X_MS_SOURCE_LEASE_ID = HttpHeaderName.fromString("x-ms-source-lease-id");
+    private static final HttpHeaderName X_MS_DESTINATION_LEASE_ID
+        = HttpHeaderName.fromString("x-ms-destination-lease-id");
     private static final HttpHeaderName X_MS_SHARE_QUOTA = HttpHeaderName.fromString("x-ms-share-quota");
     private static final HttpHeaderName X_MS_ACCESS_TIER = HttpHeaderName.fromString("x-ms-access-tier");
     private static final HttpHeaderName X_MS_ENABLED_PROTOCOLS = HttpHeaderName.fromString("x-ms-enabled-protocols");
@@ -245,6 +273,159 @@ public static RequestOptions setAccessPolicyRequestOptions(String shareName,
         return requestOptions;
     }
 
+    /** Adds the SMB property headers (permission key, attributes, and the creation/last-write/change times). */
+    public static void addSmbProperties(RequestOptions requestOptions, String filePermissionKey,
+        String ntfsFileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime) {
+        addHeader(requestOptions, X_MS_FILE_PERMISSION_KEY, filePermissionKey);
+        addHeader(requestOptions, X_MS_FILE_ATTRIBUTES, ntfsFileAttributes);
+        addHeader(requestOptions, X_MS_FILE_CREATION_TIME, fileCreationTime);
+        addHeader(requestOptions, X_MS_FILE_LAST_WRITE_TIME, fileLastWriteTime);
+        addHeader(requestOptions, X_MS_FILE_CHANGE_TIME, fileChangeTime);
+    }
+
+    /** Adds the NFS POSIX property headers (owner, group, and file mode). */
+    public static void addPosixProperties(RequestOptions requestOptions, FilePosixProperties posixProperties) {
+        if (posixProperties != null) {
+            addHeader(requestOptions, X_MS_OWNER, posixProperties.getOwner());
+            addHeader(requestOptions, X_MS_GROUP, posixProperties.getGroup());
+            addHeader(requestOptions, X_MS_MODE, posixProperties.getFileMode());
+        }
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code Directory.create}: metadata, file permission, SMB and POSIX
+     * properties, and the file-property semantics, scoped to the directory resource.
+     */
+    public static RequestOptions createDirectoryRequestOptions(String resourcePath, Map metadata,
+        String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey,
+        String ntfsFileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime,
+        FilePosixProperties posixProperties, FilePropertySemantics filePropertySemantics, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addMetadata(requestOptions, metadata);
+        addHeader(requestOptions, X_MS_FILE_PERMISSION, filePermission);
+        addFilePermissionFormat(requestOptions, filePermissionFormat);
+        addSmbProperties(requestOptions, filePermissionKey, ntfsFileAttributes, fileCreationTime, fileLastWriteTime,
+            fileChangeTime);
+        addPosixProperties(requestOptions, posixProperties);
+        addHeader(requestOptions, X_MS_FILE_PROPERTY_SEMANTICS, filePropertySemantics);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code Directory.setProperties}: file permission plus SMB and POSIX
+     * properties, scoped to the directory resource.
+     */
+    public static RequestOptions setDirectoryPropertiesRequestOptions(String resourcePath, String filePermission,
+        FilePermissionFormat filePermissionFormat, String filePermissionKey, String ntfsFileAttributes,
+        String fileCreationTime, String fileLastWriteTime, String fileChangeTime, FilePosixProperties posixProperties,
+        Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_FILE_PERMISSION, filePermission);
+        addFilePermissionFormat(requestOptions, filePermissionFormat);
+        addSmbProperties(requestOptions, filePermissionKey, ntfsFileAttributes, fileCreationTime, fileLastWriteTime,
+            fileChangeTime);
+        addPosixProperties(requestOptions, posixProperties);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code Directory.listFilesAndDirectoriesSegment}: the prefix, snapshot,
+     * marker, maxresults and include query parameters plus the extended-info header, scoped to the directory resource.
+     */
+    public static RequestOptions listFilesAndDirectoriesRequestOptions(String resourcePath, String prefix,
+        String snapshot, String marker, Integer maxResults, List include,
+        boolean includeExtendedInfo, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        if (prefix != null) {
+            requestOptions.addQueryParam("prefix", prefix, false);
+        }
+        addSnapshot(requestOptions, snapshot);
+        if (marker != null) {
+            requestOptions.addQueryParam("marker", marker, false);
+        }
+        if (maxResults != null) {
+            requestOptions.addQueryParam("maxresults", String.valueOf(maxResults), false);
+        }
+        if (include != null && !include.isEmpty()) {
+            requestOptions.addQueryParam("include",
+                include.stream().map(ListFilesIncludeType::toString).collect(java.util.stream.Collectors.joining(",")),
+                false);
+        }
+        addHeader(requestOptions, X_MS_FILE_EXTENDED_INFO, includeExtendedInfo);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code Directory.listHandles}: the marker, maxresults and snapshot query
+     * parameters plus the recursive header, scoped to the directory resource.
+     */
+    public static RequestOptions listHandlesRequestOptions(String resourcePath, String marker, Integer maxResults,
+        String snapshot, boolean recursive, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        if (marker != null) {
+            requestOptions.addQueryParam("marker", marker, false);
+        }
+        if (maxResults != null) {
+            requestOptions.addQueryParam("maxresults", String.valueOf(maxResults), false);
+        }
+        addSnapshot(requestOptions, snapshot);
+        addHeader(requestOptions, X_MS_RECURSIVE, recursive);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code Directory.forceCloseHandles}: the marker and snapshot query
+     * parameters plus the recursive header, scoped to the directory resource. The handle id is passed to the protocol
+     * method as an explicit parameter.
+     */
+    public static RequestOptions forceCloseHandlesRequestOptions(String resourcePath, String marker, String snapshot,
+        boolean recursive, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        if (marker != null) {
+            requestOptions.addQueryParam("marker", marker, false);
+        }
+        addSnapshot(requestOptions, snapshot);
+        addHeader(requestOptions, X_MS_RECURSIVE, recursive);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code Directory.rename}: the rename flags, permission, metadata, source
+     * and destination lease ids, and the copy SMB info headers, scoped to the destination directory resource. The
+     * rename source is passed to the protocol method as an explicit parameter.
+     */
+    public static RequestOptions renameDirectoryRequestOptions(String resourcePath, Boolean replaceIfExists,
+        Boolean ignoreReadOnly, String filePermission, FilePermissionFormat filePermissionFormat,
+        String filePermissionKey, Map metadata, SourceLeaseAccessConditions sourceConditions,
+        DestinationLeaseAccessConditions destinationConditions, CopyFileSmbInfo smbInfo, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_FILE_RENAME_REPLACE_IF_EXISTS, replaceIfExists);
+        addHeader(requestOptions, X_MS_FILE_RENAME_IGNORE_READONLY, ignoreReadOnly);
+        addHeader(requestOptions, X_MS_FILE_PERMISSION, filePermission);
+        addFilePermissionFormat(requestOptions, filePermissionFormat);
+        addHeader(requestOptions, X_MS_FILE_PERMISSION_KEY, filePermissionKey);
+        addMetadata(requestOptions, metadata);
+        if (sourceConditions != null) {
+            addHeader(requestOptions, X_MS_SOURCE_LEASE_ID, sourceConditions.getSourceLeaseId());
+        }
+        if (destinationConditions != null) {
+            addHeader(requestOptions, X_MS_DESTINATION_LEASE_ID, destinationConditions.getDestinationLeaseId());
+        }
+        if (smbInfo != null) {
+            addHeader(requestOptions, X_MS_FILE_ATTRIBUTES, smbInfo.getFileAttributes());
+            addHeader(requestOptions, X_MS_FILE_CREATION_TIME, smbInfo.getFileCreationTime());
+            addHeader(requestOptions, X_MS_FILE_LAST_WRITE_TIME, smbInfo.getFileLastWriteTime());
+            addHeader(requestOptions, X_MS_FILE_CHANGE_TIME, smbInfo.getFileChangeTime());
+        }
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
     /** Sets {@code name} to {@code String.valueOf(value)} when {@code value} is non-null. */
     private static void addHeader(RequestOptions requestOptions, HttpHeaderName name, Object value) {
         if (value != null) {
diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
index 16787e38904b..2607ee5a0049 100644
--- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
+++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
@@ -81,6 +81,8 @@ public void customize(LibraryCustomization customization, Logger logger) {
 
         exposeRawListSharesSegment(customization, logger);
 
+        exposeRawListHandles(customization, logger);
+
         restoreFluentModels(customization, logger);
 
         customization.getClass("com.azure.storage.file.share.models", "ShareTokenIntent")
@@ -176,6 +178,45 @@ private static void exposeRawListSharesSegment(LibraryCustomization customizatio
         logger.info("Exposed raw listSharesSegmentWithResponse methods in {}", path);
     }
 
+    /**
+     * Exposes raw {@code Response} accessors for the Directory List Handles operation. Like
+     * {@code listSharesSegment}, the generated paging helpers discard the {@code NextMarker} from the XML envelope,
+     * but the hand-written {@code ShareDirectoryClient#listHandles} manages continuation itself, so these methods
+     * return the full response body for the client to deserialize {@code ListHandlesResponse}.
+     *
+     * @param customization The library customization.
+     * @param logger The logger.
+     */
+    private static void exposeRawListHandles(LibraryCustomization customization, Logger logger) {
+        Editor editor = customization.getRawEditor();
+        String path = PKG_ROOT + "implementation/DirectoriesImpl.java";
+        String content = editor.getFileContent(path);
+        String anchor = "    public PagedIterable listHandles(RequestOptions requestOptions) {";
+        if (content.contains("listHandlesWithResponse(RequestOptions") || !content.contains(anchor)) {
+            return;
+        }
+        String rawMethods = "    public Response listHandlesWithResponse(RequestOptions requestOptions) {\n"
+            + "        final String accept = \"application/xml\";\n"
+            + "        try {\n"
+            + "            return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
+            + "                this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,\n"
+            + "                Context.NONE);\n"
+            + "        } catch (ShareStorageExceptionInternal internalException) {\n"
+            + "            throw ModelHelper.mapToShareStorageException(internalException);\n"
+            + "        }\n"
+            + "    }\n\n"
+            + "    public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {\n"
+            + "        final String accept = \"application/xml\";\n"
+            + "        return FluxUtil\n"
+            + "            .withContext(context -> service.listHandles(this.client.getUrl(),\n"
+            + "                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),\n"
+            + "                this.client.getFileRequestIntent(), accept, requestOptions, context))\n"
+            + "            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
+            + "    }\n\n";
+        editor.replaceFile(path, content.replace(anchor, rawMethods + anchor));
+        logger.info("Exposed raw listHandlesWithResponse methods in {}", path);
+    }
+
     /**
      * Restores the "fluent" shape of models that shipped as {@code @Fluent} (public no-arg constructor + setters)
      * before the TypeSpec migration. With {@code required-fields-as-ctor-args: true} (which must stay true so new

From 9b6cc7b9482d1e28fb12da1f859c755505bee0c2 Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Tue, 11 Aug 2026 11:25:39 -0700
Subject: [PATCH 09/13] files checkpoint

---
 .../file/share/ShareFileAsyncClient.java      | 173 ++++++-----
 .../storage/file/share/ShareFileClient.java   | 234 +++++++-------
 .../share/implementation/DirectoriesImpl.java |  25 ++
 .../file/share/implementation/FilesImpl.java  |  25 ++
 .../share/implementation/ServicesImpl.java    |  13 +-
 .../models/SharesCreateSnapshotHeaders.java   | 166 ----------
 .../implementation/util/ModelHelper.java      | 104 ++++---
 .../util/RequestOptionsHelper.java            | 289 ++++++++++++++++++
 .../azure-storage-file-share_metadata.json    |   2 +-
 .../main/java/ShareStorageCustomization.java  |  16 +-
 10 files changed, 644 insertions(+), 403 deletions(-)
 delete mode 100644 sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java

diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileAsyncClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileAsyncClient.java
index c6e2bde18e29..e59cf22c8ada 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileAsyncClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileAsyncClient.java
@@ -13,6 +13,7 @@
 import com.azure.core.http.rest.PagedFlux;
 import com.azure.core.http.rest.PagedResponse;
 import com.azure.core.http.rest.PagedResponseBase;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
@@ -43,6 +44,7 @@
 import com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType;
 import com.azure.storage.file.share.implementation.models.SourceLeaseAccessConditions;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.implementation.util.ShareSasImplUtil;
 import com.azure.storage.file.share.models.CloseHandlesInfo;
 import com.azure.storage.file.share.models.CopyStatusType;
@@ -485,13 +487,13 @@ Mono> createWithResponse(long maxSize, ShareFileHttpHead
         }
 
         return contentMD5Mono.flatMap(fluxMD5wrapper -> azureFileStorageClient.getFiles()
-            .createWithResponseAsync(shareName, filePath, maxSize, null, metadata, filePermission, filePermissionFormat,
-                smbPropertiesLocal.getFilePermissionKey(), smbPropertiesLocal.getNtfsFileAttributesString(),
-                smbPropertiesLocal.getFileCreationTimeString(), smbPropertiesLocal.getFileLastWriteTimeString(),
-                smbPropertiesLocal.getFileChangeTimeString(), requestConditionsLocal.getLeaseId(),
-                filePosixPropertiesLocal.getOwner(), filePosixPropertiesLocal.getGroup(),
-                filePosixPropertiesLocal.getFileMode(), filePosixPropertiesLocal.getFileType(), fluxMD5wrapper.getMd5(),
-                filePropertySemantics, contentLength, null, null, fluxMD5wrapper.getData(), httpHeaders, contextLocal)
+            .createWithResponseAsync(maxSize,
+                RequestOptionsHelper.createFileRequestOptions(shareName + "/" + filePath, metadata, filePermission,
+                    filePermissionFormat, smbPropertiesLocal.getFilePermissionKey(),
+                    smbPropertiesLocal.getNtfsFileAttributesString(), smbPropertiesLocal.getFileCreationTimeString(),
+                    smbPropertiesLocal.getFileLastWriteTimeString(), smbPropertiesLocal.getFileChangeTimeString(),
+                    requestConditionsLocal.getLeaseId(), filePosixPropertiesLocal, fluxMD5wrapper.getMd5(),
+                    filePropertySemantics, httpHeaders, binaryData, contextLocal))
             .map(ModelHelper::createFileInfoResponse));
     }
 
@@ -730,19 +732,20 @@ public PollerFlux beginCopy(String sourceUrl, ShareFile
         return new PollerFlux<>(interval, (pollingContext) -> {
             try {
                 return withContext(context -> azureFileStorageClient.getFiles()
-                    .startCopyWithResponseAsync(shareName, filePath, copySource, null, options.getMetadata(),
-                        options.getFilePermission(), options.getFilePermissionFormat(),
-                        tempSmbProperties.getFilePermissionKey(), finalRequestConditions.getLeaseId(),
-                        fileposixProperties.getOwner(), fileposixProperties.getGroup(),
-                        fileposixProperties.getFileMode(), options.getModeCopyMode(), options.getOwnerCopyMode(),
-                        copyFileSmbInfo, context)).map(response -> {
-                            final FilesStartCopyHeaders headers = response.getDeserializedHeaders();
-                            copyId.set(headers.getXMsCopyId());
-
-                            return new ShareFileCopyInfo(sourceUrl, headers.getXMsCopyId(), headers.getXMsCopyStatus(),
-                                headers.getETag(), headers.getLastModified(),
-                                response.getHeaders().getValue("x-ms-error-code"));
-                        });
+                    .startCopyWithResponseAsync(copySource,
+                        RequestOptionsHelper.startCopyRequestOptions(shareName + "/" + filePath, options.getMetadata(),
+                            options.getFilePermission(), options.getFilePermissionFormat(),
+                            tempSmbProperties.getFilePermissionKey(), finalRequestConditions.getLeaseId(),
+                            fileposixProperties.getOwner(), fileposixProperties.getGroup(),
+                            fileposixProperties.getFileMode(), options.getModeCopyMode(), options.getOwnerCopyMode(),
+                            copyFileSmbInfo, context))).map(response -> {
+                                final FilesStartCopyHeaders headers = new FilesStartCopyHeaders(response.getHeaders());
+                                copyId.set(headers.getXMsCopyId());
+
+                                return new ShareFileCopyInfo(sourceUrl, headers.getXMsCopyId(),
+                                    headers.getXMsCopyStatus(), headers.getETag(), headers.getLastModified(),
+                                    response.getHeaders().getValue("x-ms-error-code"));
+                            });
             } catch (RuntimeException ex) {
                 return monoError(LOGGER, ex);
             }
@@ -880,8 +883,8 @@ Mono> abortCopyWithResponse(String copyId, ShareRequestConditions
         Context context) {
         requestConditions = requestConditions == null ? new ShareRequestConditions() : requestConditions;
         return azureFileStorageClient.getFiles()
-            .abortCopyNoCustomHeadersWithResponseAsync(shareName, filePath, copyId, null,
-                requestConditions.getLeaseId(), context);
+            .abortCopyWithResponseAsync(copyId, RequestOptionsHelper
+                .addLeaseIdRequestOptions(shareName + "/" + filePath, requestConditions.getLeaseId(), context));
     }
 
     /**
@@ -1256,8 +1259,10 @@ private Mono>> downloadRange
         Boolean rangeGetContentMD5, ShareRequestConditions requestConditions, Context context) {
         String rangeString = range == null ? null : range.toHeaderValue();
         return azureFileStorageClient.getFiles()
-            .downloadWithResponseAsync(shareName, filePath, null, rangeString, rangeGetContentMD5, null,
-                requestConditions.getLeaseId(), context);
+            .downloadWithResponseAsync(RequestOptionsHelper.downloadRequestOptions(shareName + "/" + filePath,
+                rangeString, rangeGetContentMD5, requestConditions.getLeaseId(), context))
+            .map(response -> new ResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
+                response.getValue().toFluxByteBuffer(), new FilesDownloadHeaders(response.getHeaders())));
     }
 
     /**
@@ -1351,7 +1356,8 @@ public Mono> deleteWithResponse(ShareRequestConditions requestCon
     Mono> deleteWithResponse(ShareRequestConditions requestConditions, Context context) {
         requestConditions = requestConditions == null ? new ShareRequestConditions() : requestConditions;
         return azureFileStorageClient.getFiles()
-            .deleteNoCustomHeadersWithResponseAsync(shareName, filePath, null, requestConditions.getLeaseId(), context);
+            .deleteWithResponseAsync(RequestOptionsHelper.addLeaseIdRequestOptions(shareName + "/" + filePath,
+                requestConditions.getLeaseId(), context));
     }
 
     /**
@@ -1530,9 +1536,12 @@ Mono> getPropertiesWithResponse(ShareRequestCondit
         Context context) {
         requestConditions = requestConditions == null ? new ShareRequestConditions() : requestConditions;
         context = context == null ? Context.NONE : context;
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.addLeaseId(requestOptions, requestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + filePath);
         return azureFileStorageClient.getFiles()
-            .getPropertiesWithResponseAsync(shareName, filePath, snapshot, null, requestConditions.getLeaseId(),
-                context)
+            .getPropertiesWithResponseAsync(requestOptions)
             .map(ModelHelper::getPropertiesResponse);
     }
 
@@ -1788,11 +1797,12 @@ Mono> setPropertiesWithResponse(long newFileSize, ShareF
         ModelHelper.validateFilePermissionAndKey(filePermission, smbProperties.getFilePermissionKey());
 
         return azureFileStorageClient.getFiles()
-            .setHttpHeadersWithResponseAsync(shareName, filePath, null, newFileSize, filePermission,
-                filePermissionFormat, smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
-                smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
-                smbProperties.getFileChangeTimeString(), requestConditions.getLeaseId(), fileposixProperties.getOwner(),
-                fileposixProperties.getGroup(), fileposixProperties.getFileMode(), httpHeaders, context)
+            .setHttpHeadersWithResponseAsync(
+                RequestOptionsHelper.setFileHttpHeadersRequestOptions(shareName + "/" + filePath, newFileSize,
+                    filePermission, filePermissionFormat, smbProperties.getFilePermissionKey(),
+                    smbProperties.getNtfsFileAttributesString(), smbProperties.getFileCreationTimeString(),
+                    smbProperties.getFileLastWriteTimeString(), smbProperties.getFileChangeTimeString(),
+                    requestConditions.getLeaseId(), fileposixProperties, httpHeaders, context))
             .map(ModelHelper::setPropertiesResponse);
     }
 
@@ -1925,9 +1935,12 @@ Mono> setMetadataWithResponse(Map> uploadRangeWithResponse(ShareFileUploadRange
                 (int) ModelHelper.FILE_DEFAULT_BLOCK_SIZE, true)
             : options.getDataFlux();
 
-        return azureFileStorageClient.getFiles()
-            .uploadRangeWithResponseAsync(shareName, filePath, range.toString(), ShareFileRangeWriteType.UPDATE,
-                options.getLength(), null, null, requestConditions.getLeaseId(), options.getLastWrittenMode(), null,
-                null, data, context)
+        final Context finalContext = context;
+        return BinaryData.fromFlux(data, options.getLength(), false)
+            .flatMap(binaryData -> azureFileStorageClient.getFiles()
+                .uploadRangeWithResponseAsync(range.toString(), ShareFileRangeWriteType.UPDATE.toString(),
+                    options.getLength(),
+                    RequestOptionsHelper.uploadRangeRequestOptions(shareName + "/" + filePath,
+                        requestConditions.getLeaseId(), options.getLastWrittenMode(), null, binaryData, finalContext)))
             .map(ModelHelper::uploadRangeHeadersToShareFileInfo);
     }
 
@@ -2480,9 +2496,10 @@ public Mono> uploadRangeFromUrlWithRes
         final String copySource = Utility.encodeUrlPath(options.getSourceUrl());
 
         return azureFileStorageClient.getFiles()
-            .uploadRangeFromURLWithResponseAsync(shareName, filePath, destinationRange.toString(), copySource, 0, null,
-                sourceRange.toString(), null, modifiedRequestConditions.getLeaseId(), sourceAuth,
-                options.getLastWrittenMode(), null, context)
+            .uploadRangeFromUrlWithResponseAsync(destinationRange.toString(), copySource, "update", 0L,
+                RequestOptionsHelper.uploadRangeFromUrlRequestOptions(shareName + "/" + filePath,
+                    sourceRange.toString(), modifiedRequestConditions.getLeaseId(), sourceAuth,
+                    options.getLastWrittenMode(), context))
             .map(ModelHelper::mapUploadRangeFromUrlResponse);
     }
 
@@ -2592,8 +2609,9 @@ Mono> clearRangeWithResponse(long length, long off
         ShareFileRange range = new ShareFileRange(offset, offset + length - 1);
         context = context == null ? Context.NONE : context;
         return azureFileStorageClient.getFiles()
-            .uploadRangeWithResponseAsync(shareName, filePath, range.toString(), ShareFileRangeWriteType.CLEAR, 0L,
-                null, null, requestConditions.getLeaseId(), null, null, null, (Flux) null, context)
+            .uploadRangeWithResponseAsync(range.toString(), ShareFileRangeWriteType.CLEAR.toString(), 0L,
+                RequestOptionsHelper.addLeaseIdRequestOptions(shareName + "/" + filePath,
+                    requestConditions.getLeaseId(), context))
             .map(ModelHelper::transformUploadResponse);
     }
 
@@ -2946,8 +2964,8 @@ PagedFlux listAllRangesInternal(ShareFileRange range, ShareR
                 .applyOptionalTimeout(this.listRangesWithResponse(range, requestConditions, previousSnapshot,
                     supportRename, marker, pageSize, Context.NONE), timeout)
                 .map(response -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(),
-                    response.getHeaders(), toShareFileRangeItems(response.getValue(), includeClearRanges),
-                    response.getValue().getNextMarker(), response.getHeaders()));
+                    response.getHeaders(), toShareFileRangeItems(response.getValue(), includeClearRanges), null,
+                    response.getHeaders()));
 
         Function>> firstPageRetriever
             = pageSize -> nextPageRetriever.apply(null, pageSize);
@@ -2965,9 +2983,9 @@ Mono> listRangesWithResponse(ShareFileRange range,
         context = context == null ? Context.NONE : context;
 
         return this.azureFileStorageClient.getFiles()
-            .getRangeListWithResponseAsync(shareName, filePath, snapshot, previousSnapshot, null, rangeString,
-                finalRequestConditions.getLeaseId(), supportRename, marker, maxResultsPerPage, context)
-            .map(response -> new SimpleResponse<>(response, response.getValue()));
+            .getRangeListWithResponseAsync(RequestOptionsHelper.getRangeListRequestOptions(shareName + "/" + filePath,
+                snapshot, previousSnapshot, rangeString, finalRequestConditions.getLeaseId(), supportRename, context))
+            .map(ModelHelper::mapGetRangeListResponse);
     }
 
     /**
@@ -3026,11 +3044,10 @@ public PagedFlux listHandles(Integer maxResultsPerPage) {
     PagedFlux listHandlesWithOptionalTimeout(Integer maxResultsPerPage, Duration timeout, Context context) {
         Function>> retriever = marker -> StorageImplUtils
             .applyOptionalTimeout(this.azureFileStorageClient.getFiles()
-                .listHandlesWithResponseAsync(shareName, filePath, marker, maxResultsPerPage, null, snapshot, context),
+                .listHandlesWithResponseAsync(RequestOptionsHelper.listFileHandlesRequestOptions(
+                    shareName + "/" + filePath, marker, maxResultsPerPage, snapshot, context)),
                 timeout)
-            .map(response -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(),
-                response.getHeaders(), ModelHelper.transformHandleItems(response.getValue().getHandleList()),
-                response.getValue().getNextMarker(), response.getDeserializedHeaders()));
+            .map(ModelHelper::mapFileListHandlesResponse);
 
         return new PagedFlux<>(() -> retriever.apply(null), retriever);
     }
@@ -3097,10 +3114,10 @@ public Mono> forceCloseHandleWithResponse(String hand
     Mono> forceCloseHandleWithResponse(String handleId, Context context) {
         context = context == null ? Context.NONE : context;
         return azureFileStorageClient.getFiles()
-            .forceCloseHandlesWithResponseAsync(shareName, filePath, handleId, null, null, snapshot, context)
-            .map(response -> new SimpleResponse<>(response,
-                new CloseHandlesInfo(response.getDeserializedHeaders().getXMsNumberOfHandlesClosed(),
-                    response.getDeserializedHeaders().getXMsNumberOfHandlesFailed())));
+            .forceCloseHandlesWithResponseAsync(handleId,
+                RequestOptionsHelper.forceCloseFileHandlesRequestOptions(shareName + "/" + filePath, null, snapshot,
+                    context))
+            .map(ModelHelper::mapFileForceCloseHandlesResponse);
     }
 
     /**
@@ -3136,17 +3153,15 @@ public Mono forceCloseAllHandles() {
     }
 
     PagedFlux forceCloseAllHandlesWithOptionalTimeout(Duration timeout, Context context) {
-        Function>> retriever = marker -> StorageImplUtils
-            .applyOptionalTimeout(
-                this.azureFileStorageClient.getFiles()
-                    .forceCloseHandlesWithResponseAsync(shareName, filePath, "*", null, marker, snapshot, context),
-                timeout)
-            .map(response -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(),
-                response.getHeaders(),
-                Collections
-                    .singletonList(new CloseHandlesInfo(response.getDeserializedHeaders().getXMsNumberOfHandlesClosed(),
-                        response.getDeserializedHeaders().getXMsNumberOfHandlesFailed())),
-                response.getDeserializedHeaders().getXMsMarker(), response.getDeserializedHeaders()));
+        Function>> retriever
+            = marker -> StorageImplUtils
+                .applyOptionalTimeout(
+                    this.azureFileStorageClient.getFiles()
+                        .forceCloseHandlesWithResponseAsync("*",
+                            RequestOptionsHelper.forceCloseFileHandlesRequestOptions(shareName + "/" + filePath, marker,
+                                snapshot, context)),
+                    timeout)
+                .map(ModelHelper::mapFileForceCloseHandlesPagedResponse);
 
         return new PagedFlux<>(() -> retriever.apply(null), retriever);
     }
@@ -3265,10 +3280,12 @@ Mono> renameWithResponse(ShareFileRenameOptions o
         renameSource = this.sasToken != null ? renameSource + "?" + this.sasToken.getSignature() : renameSource;
 
         return destinationFileClient.azureFileStorageClient.getFiles()
-            .renameWithResponseAsync(destinationFileClient.getShareName(), destinationFileClient.getFilePath(),
-                renameSource, null /* timeout */, options.getReplaceIfExists(), options.isIgnoreReadOnly(),
-                options.getFilePermission(), options.getFilePermissionFormat(), filePermissionKey,
-                options.getMetadata(), sourceConditions, destinationConditions, smbInfo, headers, context)
+            .renameWithResponseAsync(renameSource,
+                RequestOptionsHelper.renameFileRequestOptions(
+                    destinationFileClient.getShareName() + "/" + destinationFileClient.getFilePath(),
+                    options.getReplaceIfExists(), options.isIgnoreReadOnly(), options.getFilePermission(),
+                    options.getFilePermissionFormat(), filePermissionKey, options.getMetadata(), sourceConditions,
+                    destinationConditions, smbInfo, headers, context))
             .map(response -> new SimpleResponse<>(response, destinationFileClient));
     }
 
@@ -3493,8 +3510,9 @@ Mono> createHardLinkWithResponse(String targetFile,
         context = context == null ? Context.NONE : context;
         requestConditions = requestConditions == null ? new ShareRequestConditions() : requestConditions;
         return this.azureFileStorageClient.getFiles()
-            .createHardLinkWithResponseAsync(shareName, filePath, targetFile, null, null,
-                requestConditions.getLeaseId(), context)
+            .createHardLinkWithResponseAsync(targetFile,
+                RequestOptionsHelper.addLeaseIdRequestOptions(shareName + "/" + filePath,
+                    requestConditions.getLeaseId(), context))
             .map(ModelHelper::createHardLinkResponse);
     }
 
@@ -3550,8 +3568,10 @@ Mono> createSymbolicLinkWithResponse(String linkText, Ma
         String fileCreationTimeString = FileSmbProperties.parseFileSMBDate(fileCreationTime);
         String fileLastWriteTimeString = FileSmbProperties.parseFileSMBDate(fileLastWriteTime);
         return this.azureFileStorageClient.getFiles()
-            .createSymbolicLinkWithResponseAsync(shareName, filePath, linkText, null, metadata, fileCreationTimeString,
-                fileLastWriteTimeString, null, requestConditions.getLeaseId(), owner, group, context)
+            .createSymbolicLinkWithResponseAsync(linkText,
+                RequestOptionsHelper.createSymbolicLinkRequestOptions(shareName + "/" + filePath, metadata,
+                    fileCreationTimeString, fileLastWriteTimeString, requestConditions.getLeaseId(), owner, group,
+                    context))
             .map(ModelHelper::createSymbolicLinkResponse);
     }
 
@@ -3598,7 +3618,8 @@ public Mono> getSymbolicLinkWithResponse() {
     Mono> getSymbolicLinkWithResponse(Context context) {
         context = context == null ? Context.NONE : context;
         return this.azureFileStorageClient.getFiles()
-            .getSymbolicLinkWithResponseAsync(shareName, filePath, null, snapshot, null, context)
+            .getSymbolicLinkWithResponseAsync(
+                RequestOptionsHelper.snapshotRequestOptions(shareName + "/" + filePath, snapshot, context))
             .map(ModelHelper::getSymbolicLinkResponse);
     }
 
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileClient.java
index 81febcdf9130..93ed51f60f07 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareFileClient.java
@@ -13,9 +13,11 @@
 import com.azure.core.http.rest.PagedIterable;
 import com.azure.core.http.rest.PagedResponse;
 import com.azure.core.http.rest.PagedResponseBase;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.ResponseBase;
 import com.azure.core.http.rest.SimpleResponse;
+import com.azure.core.util.BinaryData;
 import com.azure.core.util.Context;
 import com.azure.core.util.CoreUtils;
 import com.azure.core.util.FluxUtil;
@@ -52,6 +54,7 @@
 import com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType;
 import com.azure.storage.file.share.implementation.models.SourceLeaseAccessConditions;
 import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.implementation.util.ShareSasImplUtil;
 import com.azure.storage.file.share.models.CloseHandlesInfo;
 import com.azure.storage.file.share.models.CopyStatusType;
@@ -554,15 +557,15 @@ public Response createWithResponse(ShareFileCreateOptions options
             contentMD5 = null;
         }
 
-        Callable> operation = () -> this.azureFileStorageClient.getFiles()
-            .createWithResponse(shareName, filePath, options.getSize(), null, options.getMetadata(),
-                options.getFilePermission(), options.getFilePermissionFormat(), smbProperties.getFilePermissionKey(),
-                smbProperties.getNtfsFileAttributesString(), smbProperties.getFileCreationTimeString(),
-                smbProperties.getFileLastWriteTimeString(), smbProperties.getFileChangeTimeString(),
-                requestConditions.getLeaseId(), fileposixProperties.getOwner(), fileposixProperties.getGroup(),
-                fileposixProperties.getFileMode(), fileposixProperties.getFileType(), contentMD5,
-                options.getFilePropertySemantics(), contentLength, null, null, options.getData(),
-                options.getShareFileHttpHeaders(), finalContext);
+        Callable> operation = () -> this.azureFileStorageClient.getFiles()
+            .createWithResponse(options.getSize(),
+                RequestOptionsHelper.createFileRequestOptions(shareName + "/" + filePath, options.getMetadata(),
+                    options.getFilePermission(), options.getFilePermissionFormat(),
+                    smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
+                    smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
+                    smbProperties.getFileChangeTimeString(), requestConditions.getLeaseId(), fileposixProperties,
+                    contentMD5, options.getFilePropertySemantics(), options.getShareFileHttpHeaders(),
+                    options.getData(), finalContext));
 
         return ModelHelper.createFileInfoResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -785,15 +788,16 @@ public SyncPoller beginCopy(String sourceUrl, ShareFile
 
         Function, PollResponse> syncActivationOperation
             = (pollingContext) -> {
-                ResponseBase response = azureFileStorageClient.getFiles()
-                    .startCopyWithResponse(shareName, filePath, copySource, null, options.getMetadata(),
-                        options.getFilePermission(), options.getFilePermissionFormat(),
-                        tempSmbProperties.getFilePermissionKey(), finalRequestConditions.getLeaseId(),
-                        fileposixProperties.getOwner(), fileposixProperties.getGroup(),
-                        fileposixProperties.getFileMode(), options.getModeCopyMode(), options.getOwnerCopyMode(),
-                        copyFileSmbInfo, null);
-
-                FilesStartCopyHeaders headers = response.getDeserializedHeaders();
+                Response response = azureFileStorageClient.getFiles()
+                    .startCopyWithResponse(copySource,
+                        RequestOptionsHelper.startCopyRequestOptions(shareName + "/" + filePath, options.getMetadata(),
+                            options.getFilePermission(), options.getFilePermissionFormat(),
+                            tempSmbProperties.getFilePermissionKey(), finalRequestConditions.getLeaseId(),
+                            fileposixProperties.getOwner(), fileposixProperties.getGroup(),
+                            fileposixProperties.getFileMode(), options.getModeCopyMode(), options.getOwnerCopyMode(),
+                            copyFileSmbInfo, Context.NONE));
+
+                FilesStartCopyHeaders headers = new FilesStartCopyHeaders(response.getHeaders());
                 copyId.set(headers.getXMsCopyId());
 
                 return new PollResponse<>(LongRunningOperationStatus.IN_PROGRESS,
@@ -939,9 +943,11 @@ public Response abortCopyWithResponse(String copyId, ShareRequestCondition
         Context finalContext = context == null ? Context.NONE : context;
         ShareRequestConditions finalRequestConditions
             = requestConditions == null ? new ShareRequestConditions() : requestConditions;
-        Callable> operation = () -> this.azureFileStorageClient.getFiles()
-            .abortCopyNoCustomHeadersWithResponse(shareName, filePath, copyId, null,
-                finalRequestConditions.getLeaseId(), finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addLeaseId(requestOptions, finalRequestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + filePath);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getFiles().abortCopyWithResponse(copyId, requestOptions);
 
         return sendRequest(operation, timeout, ShareStorageException.class);
     }
@@ -1313,9 +1319,11 @@ public Response deleteWithResponse(ShareRequestConditions requestCondition
         Context finalContext = context == null ? Context.NONE : context;
         ShareRequestConditions finalRequestConditions
             = requestConditions == null ? new ShareRequestConditions() : requestConditions;
-        Callable> operation = () -> this.azureFileStorageClient.getFiles()
-            .deleteNoCustomHeadersWithResponse(shareName, filePath, null, finalRequestConditions.getLeaseId(),
-                finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addLeaseId(requestOptions, finalRequestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + filePath);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getFiles().deleteWithResponse(requestOptions);
 
         return sendRequest(operation, timeout, ShareStorageException.class);
     }
@@ -1480,9 +1488,12 @@ public Response getPropertiesWithResponse(ShareRequestCondi
         Context finalContext = context == null ? Context.NONE : context;
         ShareRequestConditions finalRequestConditions
             = requestConditions == null ? new ShareRequestConditions() : requestConditions;
-        Callable> operation = () -> this.azureFileStorageClient.getFiles()
-            .getPropertiesWithResponse(shareName, filePath, snapshot, null, finalRequestConditions.getLeaseId(),
-                finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addSnapshot(requestOptions, snapshot);
+        RequestOptionsHelper.addLeaseId(requestOptions, finalRequestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + filePath);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getFiles().getPropertiesWithResponse(requestOptions);
 
         return ModelHelper.getPropertiesResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -1731,14 +1742,13 @@ public Response setPropertiesWithResponse(ShareFileSetPropertiesO
         // Checks that file permission and file permission key are valid
         ModelHelper.validateFilePermissionAndKey(filePermission.getPermission(), smbProperties.getFilePermissionKey());
 
-        Callable> operation = () -> azureFileStorageClient.getFiles()
-            .setHttpHeadersWithResponse(shareName, filePath, null, options.getSizeInBytes(),
-                filePermission.getPermission(), filePermission.getPermissionFormat(),
-                smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
-                smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
-                smbProperties.getFileChangeTimeString(), finalRequestConditions.getLeaseId(),
-                fileposixProperties.getOwner(), fileposixProperties.getGroup(), fileposixProperties.getFileMode(),
-                options.getHttpHeaders(), finalContext);
+        Callable> operation = () -> azureFileStorageClient.getFiles()
+            .setHttpHeadersWithResponse(RequestOptionsHelper.setFileHttpHeadersRequestOptions(
+                shareName + "/" + filePath, options.getSizeInBytes(), filePermission.getPermission(),
+                filePermission.getPermissionFormat(), smbProperties.getFilePermissionKey(),
+                smbProperties.getNtfsFileAttributesString(), smbProperties.getFileCreationTimeString(),
+                smbProperties.getFileLastWriteTimeString(), smbProperties.getFileChangeTimeString(),
+                finalRequestConditions.getLeaseId(), fileposixProperties, options.getHttpHeaders(), finalContext));
 
         return ModelHelper.setPropertiesResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -1872,9 +1882,12 @@ public Response setMetadataWithResponse(Map> operation = () -> this.azureFileStorageClient.getFiles()
-            .setMetadataWithResponse(shareName, filePath, null, metadata, finalRequestConditions.getLeaseId(),
-                finalContext);
+        RequestOptions requestOptions = new RequestOptions().setContext(finalContext);
+        RequestOptionsHelper.addMetadata(requestOptions, metadata);
+        RequestOptionsHelper.addLeaseId(requestOptions, finalRequestConditions.getLeaseId());
+        RequestOptionsHelper.scopeRequestToResourcePath(requestOptions, shareName + "/" + filePath);
+        Callable> operation
+            = () -> this.azureFileStorageClient.getFiles().setMetadataWithResponse(requestOptions);
 
         return ModelHelper.setMetadataResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -2289,10 +2302,11 @@ public Response uploadRangeFromUrlWithResponse(
             = options.getSourceAuthorization() == null ? null : options.getSourceAuthorization().toString();
         String copySource = Utility.encodeUrlPath(options.getSourceUrl());
 
-        Callable> operation = () -> azureFileStorageClient.getFiles()
-            .uploadRangeFromURLWithResponse(shareName, filePath, destinationRange.toString(), copySource, 0, null,
-                sourceRange.toString(), null, finalRequestConditions.getLeaseId(), sourceAuth,
-                options.getLastWrittenMode(), null, finalContext);
+        Callable> operation = () -> azureFileStorageClient.getFiles()
+            .uploadRangeFromUrlWithResponse(destinationRange.toString(), copySource, "update", 0L,
+                RequestOptionsHelper.uploadRangeFromUrlRequestOptions(shareName + "/" + filePath,
+                    sourceRange.toString(), finalRequestConditions.getLeaseId(), sourceAuth,
+                    options.getLastWrittenMode(), finalContext));
 
         return ModelHelper.mapUploadRangeFromUrlResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -2394,9 +2408,10 @@ public Response clearRangeWithResponse(long length, long of
             = requestConditions == null ? new ShareRequestConditions() : requestConditions;
         ShareFileRange range = new ShareFileRange(offset, offset + length - 1);
         Context finalContext = context == null ? Context.NONE : context;
-        Callable> operation = () -> this.azureFileStorageClient.getFiles()
-            .uploadRangeWithResponse(shareName, filePath, range.toString(), ShareFileRangeWriteType.CLEAR, 0L, null,
-                null, finalRequestConditions.getLeaseId(), null, null, null, null, finalContext);
+        Callable> operation = () -> this.azureFileStorageClient.getFiles()
+            .uploadRangeWithResponse(range.toString(), ShareFileRangeWriteType.CLEAR.toString(), 0L,
+                RequestOptionsHelper.addLeaseIdRequestOptions(shareName + "/" + filePath,
+                    finalRequestConditions.getLeaseId(), finalContext));
 
         return ModelHelper.transformUploadResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -2551,13 +2566,13 @@ public PagedIterable listRanges(ShareFileRange range, ShareReque
             = requestConditions == null ? new ShareRequestConditions() : requestConditions;
         String rangeString = range == null ? null : range.toString();
         try {
-            Callable> operation
-                = () -> this.azureFileStorageClient.getFiles()
-                    .getRangeListWithResponse(shareName, filePath, snapshot, null, null, rangeString,
-                        finalRequestConditions.getLeaseId(), null, null, null, finalContext);
+            Callable> operation
+                = () -> ModelHelper.mapGetRangeListResponse(this.azureFileStorageClient.getFiles()
+                    .getRangeListWithResponse(
+                        RequestOptionsHelper.getRangeListRequestOptions(shareName + "/" + filePath, snapshot, null,
+                            rangeString, finalRequestConditions.getLeaseId(), null, finalContext)));
 
-            ResponseBase response
-                = sendRequest(operation, timeout, ShareStorageException.class);
+            Response response = sendRequest(operation, timeout, ShareStorageException.class);
 
             List shareFileRangeList = response.getValue()
                 .getRanges()
@@ -2568,7 +2583,7 @@ public PagedIterable listRanges(ShareFileRange range, ShareReque
 
             Supplier> finalResponse
                 = () -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                    shareFileRangeList, null, response.getDeserializedHeaders());
+                    shareFileRangeList, null, new FilesGetRangeListHeaders(response.getHeaders()));
 
             return new PagedIterable<>(finalResponse);
 
@@ -2654,12 +2669,12 @@ private PagedIterable listAllRangesInternal(ShareFileRange r
             = requestConditions == null ? new ShareRequestConditions() : requestConditions;
 
         BiFunction> nextPageRetriever = (marker, pageSize) -> {
-            ResponseBase response = listRangesWithResponse(range,
-                finalRequestConditions, previousSnapshot, supportRename, marker, pageSize, timeout, finalContext);
+            Response response = listRangesWithResponse(range, finalRequestConditions,
+                previousSnapshot, supportRename, marker, pageSize, timeout, finalContext);
 
             return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                toShareFileRangeItems(response.getValue(), includeClearRanges), response.getValue().getNextMarker(),
-                response.getDeserializedHeaders());
+                toShareFileRangeItems(response.getValue(), includeClearRanges), null,
+                new FilesGetRangeListHeaders(response.getHeaders()));
         };
         Function> firstPageRetriever
             = pageSize -> nextPageRetriever.apply(null, pageSize);
@@ -2739,9 +2754,11 @@ public Response listRangesDiffWithResponse(ShareFileListRang
         ShareRequestConditions requestConditions
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
         String rangeString = options.getRange() == null ? null : options.getRange().toString();
-        Callable> operation = () -> this.azureFileStorageClient.getFiles()
-            .getRangeListNoCustomHeadersWithResponse(shareName, filePath, snapshot, options.getPreviousSnapshot(), null,
-                rangeString, requestConditions.getLeaseId(), options.isRenameIncluded(), null, null, finalContext);
+        Callable> operation
+            = () -> ModelHelper.mapGetRangeListResponse(this.azureFileStorageClient.getFiles()
+                .getRangeListWithResponse(RequestOptionsHelper.getRangeListRequestOptions(shareName + "/" + filePath,
+                    snapshot, options.getPreviousSnapshot(), rangeString, requestConditions.getLeaseId(),
+                    options.isRenameIncluded(), finalContext)));
 
         return sendRequest(operation, timeout, ShareStorageException.class);
     }
@@ -2800,18 +2817,15 @@ public PagedIterable listHandles() {
     public PagedIterable listHandles(Integer maxResultsPerPage, Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
         try {
-            Callable> operation
-                = () -> this.azureFileStorageClient.getFiles()
-                    .listHandlesWithResponse(shareName, filePath, null, maxResultsPerPage, null, snapshot,
-                        finalContext);
+            RequestOptions requestOptions = RequestOptionsHelper.listFileHandlesRequestOptions(
+                shareName + "/" + filePath, null, maxResultsPerPage, snapshot, finalContext);
+            Callable> operation
+                = () -> this.azureFileStorageClient.getFiles().listHandlesWithResponse(requestOptions);
 
-            ResponseBase response
-                = sendRequest(operation, timeout, ShareStorageException.class);
+            PagedResponse response
+                = ModelHelper.mapFileListHandlesResponse(sendRequest(operation, timeout, ShareStorageException.class));
 
-            Supplier> finalResponse
-                = () -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                    ModelHelper.transformHandleItems(response.getValue().getHandleList()), null,
-                    response.getDeserializedHeaders());
+            Supplier> finalResponse = () -> response;
 
             return new PagedIterable<>(finalResponse);
 
@@ -2877,15 +2891,13 @@ public CloseHandlesInfo forceCloseHandle(String handleId) {
     @ServiceMethod(returns = ReturnType.SINGLE)
     public Response forceCloseHandleWithResponse(String handleId, Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
-        Callable> operation = () -> azureFileStorageClient.getFiles()
-            .forceCloseHandlesWithResponse(shareName, filePath, handleId, null, null, snapshot, finalContext);
-
-        ResponseBase response
-            = sendRequest(operation, timeout, ShareStorageException.class);
+        RequestOptions requestOptions = RequestOptionsHelper
+            .forceCloseFileHandlesRequestOptions(shareName + "/" + filePath, null, snapshot, finalContext);
+        Callable> operation
+            = () -> azureFileStorageClient.getFiles().forceCloseHandlesWithResponse(handleId, requestOptions);
 
-        return new SimpleResponse<>(response,
-            new CloseHandlesInfo(response.getDeserializedHeaders().getXMsNumberOfHandlesClosed(),
-                response.getDeserializedHeaders().getXMsNumberOfHandlesFailed()));
+        return ModelHelper
+            .mapFileForceCloseHandlesResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
 
     /**
@@ -2915,19 +2927,15 @@ public Response forceCloseHandleWithResponse(String handleId,
     public CloseHandlesInfo forceCloseAllHandles(Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
         try {
-            Callable> operation
-                = () -> this.azureFileStorageClient.getFiles()
-                    .forceCloseHandlesWithResponse(shareName, filePath, "*", null, null, snapshot, finalContext);
+            RequestOptions requestOptions = RequestOptionsHelper
+                .forceCloseFileHandlesRequestOptions(shareName + "/" + filePath, null, snapshot, finalContext);
+            Callable> operation
+                = () -> this.azureFileStorageClient.getFiles().forceCloseHandlesWithResponse("*", requestOptions);
 
-            ResponseBase response
-                = sendRequest(operation, timeout, ShareStorageException.class);
+            PagedResponse response = ModelHelper
+                .mapFileForceCloseHandlesPagedResponse(sendRequest(operation, timeout, ShareStorageException.class));
 
-            Supplier> finalResponse
-                = () -> new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
-                    Collections.singletonList(
-                        new CloseHandlesInfo(response.getDeserializedHeaders().getXMsNumberOfHandlesClosed(),
-                            response.getDeserializedHeaders().getXMsNumberOfHandlesFailed())),
-                    response.getDeserializedHeaders().getXMsMarker(), response.getDeserializedHeaders());
+            Supplier> finalResponse = () -> response;
 
             return new PagedIterable<>(finalResponse).stream()
                 .reduce(new CloseHandlesInfo(0, 0),
@@ -3047,11 +3055,12 @@ public Response renameWithResponse(ShareFileRenameOptions optio
             = this.sasToken != null ? renameSource + "?" + this.sasToken.getSignature() : renameSource;
 
         Callable> operation = () -> destinationFileClient.azureFileStorageClient.getFiles()
-            .renameNoCustomHeadersWithResponse(destinationFileClient.getShareName(),
-                destinationFileClient.getFilePath(), finalRenameSource, null, options.getReplaceIfExists(),
-                options.isIgnoreReadOnly(), options.getFilePermission(), options.getFilePermissionFormat(),
-                finalFilePermissionKey, options.getMetadata(), sourceConditions, destinationConditions, finalSmbInfo,
-                headers, finalContext);
+            .renameWithResponse(finalRenameSource,
+                RequestOptionsHelper.renameFileRequestOptions(
+                    destinationFileClient.getShareName() + "/" + destinationFileClient.getFilePath(),
+                    options.getReplaceIfExists(), options.isIgnoreReadOnly(), options.getFilePermission(),
+                    options.getFilePermissionFormat(), finalFilePermissionKey, options.getMetadata(), sourceConditions,
+                    destinationConditions, finalSmbInfo, headers, finalContext));
 
         return new SimpleResponse<>(sendRequest(operation, timeout, ShareStorageException.class),
             destinationFileClient);
@@ -3272,10 +3281,9 @@ public Response createHardLinkWithResponse(ShareFileCreateHardLin
         ShareRequestConditions requestConditions
             = options.getRequestConditions() == null ? new ShareRequestConditions() : options.getRequestConditions();
 
-        Callable> operation
-            = () -> this.azureFileStorageClient.getFiles()
-                .createHardLinkWithResponse(shareName, filePath, options.getTargetFile(), null, null,
-                    requestConditions.getLeaseId(), finalContext);
+        Callable> operation = () -> this.azureFileStorageClient.getFiles()
+            .createHardLinkWithResponse(options.getTargetFile(), RequestOptionsHelper
+                .addLeaseIdRequestOptions(shareName + "/" + filePath, requestConditions.getLeaseId(), finalContext));
 
         return ModelHelper.createHardLinkResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -3325,11 +3333,11 @@ public Response createSymbolicLinkWithResponse(ShareFileCreateSym
 
         String fileCreationTimeString = FileSmbProperties.parseFileSMBDate(options.getFileCreationTime());
         String fileLastWriteTimeString = FileSmbProperties.parseFileSMBDate(options.getFileLastWriteTime());
-        Callable> operation
-            = () -> this.azureFileStorageClient.getFiles()
-                .createSymbolicLinkWithResponse(shareName, filePath, options.getLinkText(), null, options.getMetadata(),
-                    fileCreationTimeString, fileLastWriteTimeString, null, requestConditions.getLeaseId(),
-                    options.getOwner(), options.getGroup(), finalContext);
+        Callable> operation = () -> this.azureFileStorageClient.getFiles()
+            .createSymbolicLinkWithResponse(options.getLinkText(),
+                RequestOptionsHelper.createSymbolicLinkRequestOptions(shareName + "/" + filePath, options.getMetadata(),
+                    fileCreationTimeString, fileLastWriteTimeString, requestConditions.getLeaseId(), options.getOwner(),
+                    options.getGroup(), finalContext));
 
         return ModelHelper.createSymbolicLinkResponse(sendRequest(operation, timeout, ShareStorageException.class));
 
@@ -3370,9 +3378,9 @@ public ShareFileSymbolicLinkInfo getSymbolicLink() {
     public Response getSymbolicLinkWithResponse(Duration timeout, Context context) {
         Context finalContext = context == null ? Context.NONE : context;
 
-        Callable> operation
-            = () -> this.azureFileStorageClient.getFiles()
-                .getSymbolicLinkWithResponse(shareName, filePath, null, snapshot, null, finalContext);
+        Callable> operation = () -> this.azureFileStorageClient.getFiles()
+            .getSymbolicLinkWithResponse(
+                RequestOptionsHelper.snapshotRequestOptions(shareName + "/" + filePath, snapshot, finalContext));
 
         return ModelHelper.getSymbolicLinkResponse(sendRequest(operation, timeout, ShareStorageException.class));
     }
@@ -3409,17 +3417,19 @@ public String generateUserDelegationSas(ShareServiceSasSignatureValues shareServ
             .generateUserDelegationSas(userDelegationKey, accountName, stringToSignHandler, context);
     }
 
-    ResponseBase listRangesWithResponse(ShareFileRange range,
-        ShareRequestConditions requestConditions, String previousSnapshot, Boolean supportRename, String marker,
-        Integer maxResultsPerPage, Duration timeout, Context context) {
+    Response listRangesWithResponse(ShareFileRange range, ShareRequestConditions requestConditions,
+        String previousSnapshot, Boolean supportRename, String marker, Integer maxResultsPerPage, Duration timeout,
+        Context context) {
         ShareRequestConditions finalRequestConditions
             = requestConditions == null ? new ShareRequestConditions() : requestConditions;
         String rangeString = range == null ? null : range.toString();
 
-        Callable> operation
-            = () -> this.azureFileStorageClient.getFiles()
-                .getRangeListWithResponse(shareName, filePath, snapshot, previousSnapshot, null, rangeString,
-                    finalRequestConditions.getLeaseId(), supportRename, marker, maxResultsPerPage, context);
+        Callable> operation
+            = () -> ModelHelper
+                .mapGetRangeListResponse(this.azureFileStorageClient.getFiles()
+                    .getRangeListWithResponse(RequestOptionsHelper.getRangeListRequestOptions(
+                        shareName + "/" + filePath, snapshot, previousSnapshot, rangeString,
+                        finalRequestConditions.getLeaseId(), supportRename, context)));
 
         return sendRequest(operation, timeout, ShareStorageException.class);
     }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
index 014554abb528..94c4a3da2bcc 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
@@ -1155,6 +1155,31 @@ private PagedResponse listHandlesSinglePage(RequestOptions requestOp
      * @return an enumeration of handles as paginated response with {@link PagedIterable}.
      */
     @ServiceMethod(returns = ReturnType.COLLECTION)
+    public Response listHandlesWithResponse(RequestOptions requestOptions) {
+        try {
+            final String accept = "application/xml";
+            try {
+                return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                    this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
+                    Context.NONE);
+            } catch (ShareStorageExceptionInternal internalException) {
+                throw ModelHelper.mapToShareStorageException(internalException);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {
+        final String accept = "application/xml";
+        return FluxUtil
+            .withContext(context -> service.listHandles(this.client.getUrl(),
+                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
+                this.client.getFileRequestIntent(), accept, requestOptions, context))
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
+    }
+
     public PagedIterable listHandles(RequestOptions requestOptions) {
         return new PagedIterable<>(() -> listHandlesSinglePage(requestOptions));
     }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
index 49ce20f242b3..ccbf2af7c9b9 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
@@ -2592,6 +2592,31 @@ private PagedResponse listHandlesSinglePage(RequestOptions requestOp
      * @return an enumeration of handles as paginated response with {@link PagedIterable}.
      */
     @ServiceMethod(returns = ReturnType.COLLECTION)
+    public Response listHandlesWithResponse(RequestOptions requestOptions) {
+        try {
+            final String accept = "application/xml";
+            try {
+                return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                    this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
+                    Context.NONE);
+            } catch (ShareStorageExceptionInternal internalException) {
+                throw ModelHelper.mapToShareStorageException(internalException);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {
+        final String accept = "application/xml";
+        return FluxUtil
+            .withContext(context -> service.listHandles(this.client.getUrl(),
+                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
+                this.client.getFileRequestIntent(), accept, requestOptions, context))
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
+    }
+
     public PagedIterable listHandles(RequestOptions requestOptions) {
         return new PagedIterable<>(() -> listHandlesSinglePage(requestOptions));
     }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
index a0c88a402b35..7a81cae0d632 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
@@ -784,11 +784,16 @@ private PagedResponse listSharesSegmentSinglePage(RequestOptions req
      * @throws ResourceModifiedException thrown if the request is rejected by server on status code 409.
      * @return an enumeration of shares as paginated response with {@link PagedIterable}.
      */
+    @ServiceMethod(returns = ReturnType.COLLECTION)
     public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {
-        final String accept = "application/xml";
         try {
-            return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
-                this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
+            final String accept = "application/xml";
+            try {
+                return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                    this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
+            } catch (ShareStorageExceptionInternal internalException) {
+                throw ModelHelper.mapToShareStorageException(internalException);
+            }
         } catch (ShareStorageExceptionInternal internalException) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
@@ -800,10 +805,10 @@ public Mono> listSharesSegmentWithResponseAsync(RequestOpti
             .withContext(
                 context -> service.listSharesSegment(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
                     this.client.getFileRequestIntent(), accept, requestOptions, context))
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
             .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
     }
 
-    @ServiceMethod(returns = ReturnType.COLLECTION)
     public PagedIterable listSharesSegment(RequestOptions requestOptions) {
         return new PagedIterable<>(() -> listSharesSegmentSinglePage(requestOptions));
     }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java
deleted file mode 100644
index c9aa0345de45..000000000000
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java
+++ /dev/null
@@ -1,166 +0,0 @@
-// Copyright (c) Microsoft Corporation. All rights reserved.
-// Licensed under the MIT License.
-// Code generated by Microsoft (R) TypeSpec Code Generator.
-
-package com.azure.storage.file.share.implementation.models;
-
-import com.azure.core.annotation.Generated;
-import com.azure.core.annotation.Immutable;
-import com.azure.core.http.HttpHeaderName;
-import com.azure.core.http.HttpHeaders;
-import com.azure.core.util.DateTimeRfc1123;
-import java.time.OffsetDateTime;
-
-/**
- * The SharesCreateSnapshotHeaders model.
- */
-@Immutable
-public final class SharesCreateSnapshotHeaders {
-    /*
-     * The ETag property.
-     */
-    @Generated
-    private final String etag;
-
-    /*
-     * The Last-Modified property.
-     */
-    @Generated
-    private final DateTimeRfc1123 lastModified;
-
-    /*
-     * The x-ms-snapshot property.
-     */
-    @Generated
-    private final String snapshot;
-
-    /*
-     * The x-ms-version property.
-     */
-    @Generated
-    private final String version;
-
-    /*
-     * The x-ms-request-id property.
-     */
-    @Generated
-    private final String requestId;
-
-    /*
-     * The x-ms-client-request-id property.
-     */
-    @Generated
-    private final String clientRequestId;
-
-    /*
-     * The Date property.
-     */
-    @Generated
-    private final DateTimeRfc1123 date;
-
-    private static final HttpHeaderName X_MS_SNAPSHOT = HttpHeaderName.fromString("x-ms-snapshot");
-
-    private static final HttpHeaderName X_MS_VERSION = HttpHeaderName.fromString("x-ms-version");
-
-    // HttpHeaders containing the raw property values.
-    /**
-     * Creates an instance of SharesCreateSnapshotHeaders class.
-     * 
-     * @param rawHeaders The raw HttpHeaders that will be used to create the property values.
-     */
-    public SharesCreateSnapshotHeaders(HttpHeaders rawHeaders) {
-        this.etag = rawHeaders.getValue(HttpHeaderName.ETAG);
-        String lastModified = rawHeaders.getValue(HttpHeaderName.LAST_MODIFIED);
-        if (lastModified != null) {
-            this.lastModified = new DateTimeRfc1123(lastModified);
-        } else {
-            this.lastModified = null;
-        }
-        this.snapshot = rawHeaders.getValue(X_MS_SNAPSHOT);
-        this.version = rawHeaders.getValue(X_MS_VERSION);
-        this.requestId = rawHeaders.getValue(HttpHeaderName.X_MS_REQUEST_ID);
-        this.clientRequestId = rawHeaders.getValue(HttpHeaderName.X_MS_CLIENT_REQUEST_ID);
-        String date = rawHeaders.getValue(HttpHeaderName.DATE);
-        if (date != null) {
-            this.date = new DateTimeRfc1123(date);
-        } else {
-            this.date = null;
-        }
-    }
-
-    /**
-     * Get the etag property: The ETag property.
-     * 
-     * @return the etag value.
-     */
-    @Generated
-    public String getEtag() {
-        return this.etag;
-    }
-
-    /**
-     * Get the lastModified property: The Last-Modified property.
-     * 
-     * @return the lastModified value.
-     */
-    @Generated
-    public OffsetDateTime getLastModified() {
-        if (this.lastModified == null) {
-            return null;
-        }
-        return this.lastModified.getDateTime();
-    }
-
-    /**
-     * Get the snapshot property: The x-ms-snapshot property.
-     * 
-     * @return the snapshot value.
-     */
-    @Generated
-    public String getSnapshot() {
-        return this.snapshot;
-    }
-
-    /**
-     * Get the version property: The x-ms-version property.
-     * 
-     * @return the version value.
-     */
-    @Generated
-    public String getVersion() {
-        return this.version;
-    }
-
-    /**
-     * Get the requestId property: The x-ms-request-id property.
-     * 
-     * @return the requestId value.
-     */
-    @Generated
-    public String getRequestId() {
-        return this.requestId;
-    }
-
-    /**
-     * Get the clientRequestId property: The x-ms-client-request-id property.
-     * 
-     * @return the clientRequestId value.
-     */
-    @Generated
-    public String getClientRequestId() {
-        return this.clientRequestId;
-    }
-
-    /**
-     * Get the date property: The Date property.
-     * 
-     * @return the date value.
-     */
-    @Generated
-    public OffsetDateTime getDate() {
-        if (this.date == null) {
-            return null;
-        }
-        return this.date.getDateTime();
-    }
-}
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
index 30aa6b7a84be..329df5e10f2f 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
@@ -40,8 +40,10 @@
 import com.azure.storage.file.share.implementation.models.FilesCreateHeaders;
 import com.azure.storage.file.share.implementation.models.FilesCreateSymbolicLinkHeaders;
 import com.azure.storage.file.share.implementation.models.FilesDownloadHeaders;
+import com.azure.storage.file.share.implementation.models.FilesForceCloseHandlesHeaders;
 import com.azure.storage.file.share.implementation.models.FilesGetPropertiesHeaders;
 import com.azure.storage.file.share.implementation.models.FilesGetSymbolicLinkHeaders;
+import com.azure.storage.file.share.implementation.models.FilesListHandlesHeaders;
 import com.azure.storage.file.share.implementation.models.FilesSetHttpHeadersHeaders;
 import com.azure.storage.file.share.implementation.models.FilesSetMetadataHeaders;
 import com.azure.storage.file.share.implementation.models.FilesUploadRangeFromURLHeaders;
@@ -393,10 +395,11 @@ public static boolean checkDoesNotExistStatusCode(Throwable t) {
         }
     }
 
-    public static Response createFileInfoResponse(ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        OffsetDateTime lastModified = response.getDeserializedHeaders().getLastModified();
-        boolean isServerEncrypted = response.getDeserializedHeaders().isXMsRequestServerEncrypted();
+    public static Response createFileInfoResponse(Response response) {
+        FilesCreateHeaders headers = new FilesCreateHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        OffsetDateTime lastModified = headers.getLastModified();
+        boolean isServerEncrypted = headers.isXMsRequestServerEncrypted();
         FileSmbProperties smbProperties = FileSmbPropertiesHelper.create(response.getHeaders());
         FilePosixProperties posixProperties = FilePosixPropertiesHelper.create(response.getHeaders());
         ShareFileInfo shareFileInfo
@@ -404,9 +407,8 @@ public static Response createFileInfoResponse(ResponseBase(response, shareFileInfo);
     }
 
-    public static Response
-        getPropertiesResponse(final ResponseBase response) {
-        FilesGetPropertiesHeaders headers = response.getDeserializedHeaders();
+    public static Response getPropertiesResponse(final Response response) {
+        FilesGetPropertiesHeaders headers = new FilesGetPropertiesHeaders(response.getHeaders());
         String eTag = headers.getETag();
         OffsetDateTime lastModified = headers.getLastModified();
         Map metadata = headers.getXMsMeta();
@@ -441,11 +443,11 @@ public static Response createFileInfoResponse(ResponseBase(response, shareFileProperties);
     }
 
-    public static Response
-        setPropertiesResponse(final ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        OffsetDateTime lastModified = response.getDeserializedHeaders().getLastModified();
-        boolean isServerEncrypted = response.getDeserializedHeaders().isXMsRequestServerEncrypted();
+    public static Response setPropertiesResponse(final Response response) {
+        FilesSetHttpHeadersHeaders headers = new FilesSetHttpHeadersHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        OffsetDateTime lastModified = headers.getLastModified();
+        boolean isServerEncrypted = headers.isXMsRequestServerEncrypted();
         FileSmbProperties smbProperties = FileSmbPropertiesHelper.create(response.getHeaders());
         FilePosixProperties posixProperties = FilePosixPropertiesHelper.create(response.getHeaders());
         ShareFileInfo shareFileInfo
@@ -453,10 +455,10 @@ public static Response createFileInfoResponse(ResponseBase(response, shareFileInfo);
     }
 
-    public static Response
-        setMetadataResponse(final ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        Boolean isServerEncrypted = response.getDeserializedHeaders().isXMsRequestServerEncrypted();
+    public static Response setMetadataResponse(final Response response) {
+        FilesSetMetadataHeaders headers = new FilesSetMetadataHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        Boolean isServerEncrypted = headers.isXMsRequestServerEncrypted();
         ShareFileMetadataInfo shareFileMetadataInfo = new ShareFileMetadataInfo(eTag, isServerEncrypted);
         return new SimpleResponse<>(response, shareFileMetadataInfo);
     }
@@ -485,9 +487,8 @@ public static void validateCopyFlagAndSmbProperties(ShareFileCopyOptions options
         }
     }
 
-    public static Response
-        transformUploadResponse(ResponseBase response) {
-        FilesUploadRangeHeaders headers = response.getDeserializedHeaders();
+    public static Response transformUploadResponse(Response response) {
+        FilesUploadRangeHeaders headers = new FilesUploadRangeHeaders(response.getHeaders());
         String eTag = headers.getETag();
         OffsetDateTime lastModified = headers.getLastModified();
         byte[] contentMD5 = headers.getContentMD5();
@@ -603,9 +604,8 @@ private interface XmlDeserializer {
         T read(XmlReader reader) throws XMLStreamException;
     }
 
-    public static Response
-        uploadRangeHeadersToShareFileInfo(ResponseBase response) {
-        FilesUploadRangeHeaders headers = response.getDeserializedHeaders();
+    public static Response uploadRangeHeadersToShareFileInfo(Response response) {
+        FilesUploadRangeHeaders headers = new FilesUploadRangeHeaders(response.getHeaders());
         String eTag = headers.getETag();
         OffsetDateTime lastModified = headers.getLastModified();
         byte[] contentMD5 = headers.getContentMD5();
@@ -621,8 +621,8 @@ private interface XmlDeserializer {
     }
 
     public static Response
-        mapUploadRangeFromUrlResponse(final ResponseBase response) {
-        FilesUploadRangeFromURLHeaders headers = response.getDeserializedHeaders();
+        mapUploadRangeFromUrlResponse(final Response response) {
+        FilesUploadRangeFromURLHeaders headers = new FilesUploadRangeFromURLHeaders(response.getHeaders());
         String eTag = headers.getETag();
         OffsetDateTime lastModified = headers.getLastModified();
         Boolean isServerEncrypted = headers.isXMsRequestServerEncrypted();
@@ -721,6 +721,36 @@ public static PagedResponse mapDirectoryForceCloseHandlesPaged
             headers.getXMsMarker(), headers);
     }
 
+    /** Deserializes a file List Handles response into a {@link PagedResponse} of {@link HandleItem}. */
+    public static PagedResponse mapFileListHandlesResponse(Response response) {
+        ListHandlesResponse listHandlesResponse = deserializeXml(response.getValue(), ListHandlesResponse::fromXml);
+        return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
+            transformHandleItems(listHandlesResponse.getHandleList()), listHandlesResponse.getNextMarker(),
+            new FilesListHandlesHeaders(response.getHeaders()));
+    }
+
+    /** Deserializes a Get Range List response body into a {@link ShareFileRangeList}. */
+    public static Response mapGetRangeListResponse(Response response) {
+        ShareFileRangeList rangeList = deserializeXml(response.getValue(), ShareFileRangeList::fromXml);
+        return new SimpleResponse<>(response, rangeList);
+    }
+
+    /** Maps a file Force Close Handles response into the closed/failed handle counts. */
+    public static Response mapFileForceCloseHandlesResponse(Response response) {
+        FilesForceCloseHandlesHeaders headers = new FilesForceCloseHandlesHeaders(response.getHeaders());
+        return new SimpleResponse<>(response,
+            new CloseHandlesInfo(headers.getXMsNumberOfHandlesClosed(), headers.getXMsNumberOfHandlesFailed()));
+    }
+
+    /** Maps a file Force Close Handles response into a paged result carrying the continuation marker. */
+    public static PagedResponse mapFileForceCloseHandlesPagedResponse(Response response) {
+        FilesForceCloseHandlesHeaders headers = new FilesForceCloseHandlesHeaders(response.getHeaders());
+        return new PagedResponseBase<>(response.getRequest(), response.getStatusCode(), response.getHeaders(),
+            Collections.singletonList(
+                new CloseHandlesInfo(headers.getXMsNumberOfHandlesClosed(), headers.getXMsNumberOfHandlesFailed())),
+            headers.getXMsMarker(), headers);
+    }
+
     public static List
         convertResponseAndGetNumOfResults(ListFilesAndDirectoriesSegmentResponse segmentResponse) {
         Set shareFileItems = new TreeSet<>(Comparator.comparing(ShareFileItem::getName));
@@ -745,10 +775,10 @@ public static PagedResponse mapDirectoryForceCloseHandlesPaged
         return new ArrayList<>(shareFileItems);
     }
 
-    public static Response
-        createHardLinkResponse(final ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        OffsetDateTime lastModified = response.getDeserializedHeaders().getLastModified();
+    public static Response createHardLinkResponse(final Response response) {
+        FilesCreateHardLinkHeaders headers = new FilesCreateHardLinkHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        OffsetDateTime lastModified = headers.getLastModified();
         FileSmbProperties smbProperties = FileSmbPropertiesHelper.create(response.getHeaders());
         FilePosixProperties posixProperties = FilePosixPropertiesHelper.create(response.getHeaders());
         ShareFileInfo shareFileInfo
@@ -756,10 +786,10 @@ public static PagedResponse mapDirectoryForceCloseHandlesPaged
         return new SimpleResponse<>(response, shareFileInfo);
     }
 
-    public static Response
-        createSymbolicLinkResponse(final ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        OffsetDateTime lastModified = response.getDeserializedHeaders().getLastModified();
+    public static Response createSymbolicLinkResponse(final Response response) {
+        FilesCreateSymbolicLinkHeaders headers = new FilesCreateSymbolicLinkHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        OffsetDateTime lastModified = headers.getLastModified();
         FileSmbProperties smbProperties = FileSmbPropertiesHelper.create(response.getHeaders());
         FilePosixProperties posixProperties = FilePosixPropertiesHelper.create(response.getHeaders());
         ShareFileInfo shareFileInfo
@@ -767,11 +797,11 @@ public static PagedResponse mapDirectoryForceCloseHandlesPaged
         return new SimpleResponse<>(response, shareFileInfo);
     }
 
-    public static Response
-        getSymbolicLinkResponse(final ResponseBase response) {
-        String eTag = response.getDeserializedHeaders().getETag();
-        OffsetDateTime lastModified = response.getDeserializedHeaders().getLastModified();
-        String linkText = response.getDeserializedHeaders().getXMsLinkText();
+    public static Response getSymbolicLinkResponse(final Response response) {
+        FilesGetSymbolicLinkHeaders headers = new FilesGetSymbolicLinkHeaders(response.getHeaders());
+        String eTag = headers.getETag();
+        OffsetDateTime lastModified = headers.getLastModified();
+        String linkText = headers.getXMsLinkText();
         ShareFileSymbolicLinkInfo shareFileSymbolicLinkInfo
             = ShareFileSymbolicLinkInfoHelper.create(eTag, lastModified, linkText);
         return new SimpleResponse<>(response, shareFileSymbolicLinkInfo);
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
index c562988dbf5a..4dfcb5d7ead6 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
@@ -19,14 +19,17 @@
 import com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper;
 import com.azure.storage.file.share.implementation.models.SourceLeaseAccessConditions;
 import com.azure.storage.file.share.models.FilePermissionFormat;
+import com.azure.storage.file.share.models.FileLastWrittenMode;
 import com.azure.storage.file.share.models.FilePosixProperties;
 import com.azure.storage.file.share.models.FilePropertySemantics;
+import com.azure.storage.file.share.models.ShareFileHttpHeaders;
 import com.azure.storage.file.share.models.ShareSignedIdentifier;
 import com.azure.storage.file.share.models.ShareSnapshotsDeleteOptionType;
 import com.azure.storage.file.share.options.ShareCreateOptions;
 import com.azure.storage.file.share.options.ShareSetPropertiesOptions;
 
 import java.util.List;
+import java.util.Base64;
 import java.util.Map;
 
 /**
@@ -57,6 +60,35 @@ public final class RequestOptionsHelper {
     private static final HttpHeaderName X_MS_OWNER = HttpHeaderName.fromString("x-ms-owner");
     private static final HttpHeaderName X_MS_GROUP = HttpHeaderName.fromString("x-ms-group");
     private static final HttpHeaderName X_MS_MODE = HttpHeaderName.fromString("x-ms-mode");
+    private static final HttpHeaderName X_MS_CONTENT_LENGTH = HttpHeaderName.fromString("x-ms-content-length");
+    private static final HttpHeaderName X_MS_CONTENT_TYPE = HttpHeaderName.fromString("x-ms-content-type");
+    private static final HttpHeaderName X_MS_CONTENT_ENCODING = HttpHeaderName.fromString("x-ms-content-encoding");
+    private static final HttpHeaderName X_MS_CONTENT_LANGUAGE = HttpHeaderName.fromString("x-ms-content-language");
+    private static final HttpHeaderName X_MS_CACHE_CONTROL = HttpHeaderName.fromString("x-ms-cache-control");
+    private static final HttpHeaderName X_MS_CONTENT_MD5 = HttpHeaderName.fromString("x-ms-content-md5");
+    private static final HttpHeaderName X_MS_CONTENT_DISPOSITION
+        = HttpHeaderName.fromString("x-ms-content-disposition");
+    private static final HttpHeaderName X_MS_FILE_FILE_TYPE = HttpHeaderName.fromString("x-ms-file-file-type");
+    private static final HttpHeaderName X_MS_FILE_SUPPORT_RENAME
+        = HttpHeaderName.fromString("x-ms-file-support-rename");
+    private static final HttpHeaderName X_MS_SOURCE_RANGE = HttpHeaderName.fromString("x-ms-source-range");
+    private static final HttpHeaderName X_MS_SOURCE_CONTENT_CRC64
+        = HttpHeaderName.fromString("x-ms-source-content-crc64");
+    private static final HttpHeaderName X_MS_COPY_SOURCE_AUTHORIZATION
+        = HttpHeaderName.fromString("x-ms-copy-source-authorization");
+    private static final HttpHeaderName X_MS_FILE_PERMISSION_COPY_MODE
+        = HttpHeaderName.fromString("x-ms-file-permission-copy-mode");
+    private static final HttpHeaderName X_MS_FILE_COPY_IGNORE_READONLY
+        = HttpHeaderName.fromString("x-ms-file-copy-ignore-readonly");
+    private static final HttpHeaderName X_MS_FILE_COPY_SET_ARCHIVE
+        = HttpHeaderName.fromString("x-ms-file-copy-set-archive");
+    private static final HttpHeaderName X_MS_FILE_MODE_COPY_MODE
+        = HttpHeaderName.fromString("x-ms-file-mode-copy-mode");
+    private static final HttpHeaderName X_MS_FILE_OWNER_COPY_MODE
+        = HttpHeaderName.fromString("x-ms-file-owner-copy-mode");
+    private static final HttpHeaderName X_MS_RANGE = HttpHeaderName.fromString("x-ms-range");
+    private static final HttpHeaderName X_MS_RANGE_GET_CONTENT_MD5
+        = HttpHeaderName.fromString("x-ms-range-get-content-md5");
     private static final HttpHeaderName X_MS_FILE_PROPERTY_SEMANTICS
         = HttpHeaderName.fromString("x-ms-file-property-semantics");
     private static final HttpHeaderName X_MS_RECURSIVE = HttpHeaderName.fromString("x-ms-recursive");
@@ -377,6 +409,39 @@ public static RequestOptions listHandlesRequestOptions(String resourcePath, Stri
         return requestOptions;
     }
 
+    /**
+     * Builds the {@link RequestOptions} for {@code File.listHandles}: the marker, maxresults and snapshot query
+     * parameters, scoped to the file resource. File handle operations have no recursive header.
+     */
+    public static RequestOptions listFileHandlesRequestOptions(String resourcePath, String marker, Integer maxResults,
+        String snapshot, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        if (marker != null) {
+            requestOptions.addQueryParam("marker", marker, false);
+        }
+        if (maxResults != null) {
+            requestOptions.addQueryParam("maxresults", String.valueOf(maxResults), false);
+        }
+        addSnapshot(requestOptions, snapshot);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.forceCloseHandles}: the marker and snapshot query parameters,
+     * scoped to the file resource. The handle id is passed to the protocol method as an explicit parameter.
+     */
+    public static RequestOptions forceCloseFileHandlesRequestOptions(String resourcePath, String marker,
+        String snapshot, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        if (marker != null) {
+            requestOptions.addQueryParam("marker", marker, false);
+        }
+        addSnapshot(requestOptions, snapshot);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
     /**
      * Builds the {@link RequestOptions} for {@code Directory.forceCloseHandles}: the marker and snapshot query
      * parameters plus the recursive header, scoped to the directory resource. The handle id is passed to the protocol
@@ -426,6 +491,230 @@ public static RequestOptions renameDirectoryRequestOptions(String resourcePath,
         return requestOptions;
     }
 
+    /** Builds a {@link RequestOptions} with only the lease id header, scoped to the resource. */
+    public static RequestOptions addLeaseIdRequestOptions(String resourcePath, String leaseId, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addLeaseId(requestOptions, leaseId);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /** Builds a {@link RequestOptions} with only the sharesnapshot query parameter, scoped to the resource. */
+    public static RequestOptions snapshotRequestOptions(String resourcePath, String snapshot, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addSnapshot(requestOptions, snapshot);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /** Adds the file HTTP content headers ({@code x-ms-content-*}, {@code x-ms-cache-control}). */
+    public static void addFileHttpHeaders(RequestOptions requestOptions, ShareFileHttpHeaders httpHeaders) {
+        if (httpHeaders != null) {
+            addHeader(requestOptions, X_MS_CONTENT_TYPE, httpHeaders.getContentType());
+            addHeader(requestOptions, X_MS_CONTENT_ENCODING, httpHeaders.getContentEncoding());
+            addHeader(requestOptions, X_MS_CONTENT_LANGUAGE, httpHeaders.getContentLanguage());
+            addHeader(requestOptions, X_MS_CACHE_CONTROL, httpHeaders.getCacheControl());
+            if (httpHeaders.getContentMd5() != null) {
+                addHeader(requestOptions, X_MS_CONTENT_MD5,
+                    Base64.getEncoder().encodeToString(httpHeaders.getContentMd5()));
+            }
+            addHeader(requestOptions, X_MS_CONTENT_DISPOSITION, httpHeaders.getContentDisposition());
+        }
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.setHttpHeaders}: content-length, HTTP content headers, file
+     * permission, SMB and POSIX properties plus lease, scoped to the file resource.
+     */
+    public static RequestOptions setFileHttpHeadersRequestOptions(String resourcePath, Long fileContentLength,
+        String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey,
+        String ntfsFileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime,
+        String leaseId, FilePosixProperties posixProperties, ShareFileHttpHeaders httpHeaders, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_CONTENT_LENGTH, fileContentLength);
+        addFileHttpHeaders(requestOptions, httpHeaders);
+        addHeader(requestOptions, X_MS_FILE_PERMISSION, filePermission);
+        addFilePermissionFormat(requestOptions, filePermissionFormat);
+        addSmbProperties(requestOptions, filePermissionKey, ntfsFileAttributes, fileCreationTime, fileLastWriteTime,
+            fileChangeTime);
+        addLeaseId(requestOptions, leaseId);
+        addPosixProperties(requestOptions, posixProperties);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.createSymbolicLink}: metadata, creation/last-write times,
+     * lease and NFS owner/group, scoped to the file resource. The link text is passed to the protocol method as an
+     * explicit parameter.
+     */
+    public static RequestOptions createSymbolicLinkRequestOptions(String resourcePath, Map metadata,
+        String fileCreationTime, String fileLastWriteTime, String leaseId, String owner, String group,
+        Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addMetadata(requestOptions, metadata);
+        addHeader(requestOptions, X_MS_FILE_CREATION_TIME, fileCreationTime);
+        addHeader(requestOptions, X_MS_FILE_LAST_WRITE_TIME, fileLastWriteTime);
+        addLeaseId(requestOptions, leaseId);
+        addHeader(requestOptions, X_MS_OWNER, owner);
+        addHeader(requestOptions, X_MS_GROUP, group);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.rename}: the directory rename headers plus the file HTTP
+     * content headers, scoped to the destination file resource.
+     */
+    public static RequestOptions renameFileRequestOptions(String resourcePath, Boolean replaceIfExists,
+        Boolean ignoreReadOnly, String filePermission, FilePermissionFormat filePermissionFormat,
+        String filePermissionKey, Map metadata, SourceLeaseAccessConditions sourceConditions,
+        DestinationLeaseAccessConditions destinationConditions, CopyFileSmbInfo smbInfo,
+        ShareFileHttpHeaders httpHeaders, Context context) {
+        RequestOptions requestOptions = renameDirectoryRequestOptions(resourcePath, replaceIfExists, ignoreReadOnly,
+            filePermission, filePermissionFormat, filePermissionKey, metadata, sourceConditions, destinationConditions,
+            smbInfo, context);
+        addFileHttpHeaders(requestOptions, httpHeaders);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.getRangeList}: the snapshot/previous-snapshot query parameters,
+     * the range and support-rename headers plus lease, scoped to the file resource.
+     */
+    public static RequestOptions getRangeListRequestOptions(String resourcePath, String snapshot,
+        String previousSnapshot, String range, String leaseId, Boolean supportRename, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addSnapshot(requestOptions, snapshot);
+        if (previousSnapshot != null) {
+            requestOptions.addQueryParam("prevsharesnapshot", previousSnapshot, false);
+        }
+        if (range != null) {
+            requestOptions.setHeader(HttpHeaderName.RANGE, range);
+        }
+        addLeaseId(requestOptions, leaseId);
+        addHeader(requestOptions, X_MS_FILE_SUPPORT_RENAME, supportRename);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.uploadRangeFromUrl}: the source range, lease, copy-source
+     * authorization and last-written mode headers, scoped to the file resource. The destination range, copy source,
+     * write mode and content length are passed to the protocol method as explicit parameters.
+     */
+    public static RequestOptions uploadRangeFromUrlRequestOptions(String resourcePath, String sourceRange,
+        String leaseId, String sourceAuthorization, FileLastWrittenMode lastWrittenMode, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_SOURCE_RANGE, sourceRange);
+        addLeaseId(requestOptions, leaseId);
+        addHeader(requestOptions, X_MS_COPY_SOURCE_AUTHORIZATION, sourceAuthorization);
+        addHeader(requestOptions, X_MS_FILE_LAST_WRITE_TIME, lastWrittenMode);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.create}: content headers, metadata, file permission, SMB and
+     * POSIX properties, content MD5, file-property semantics and the optional request body, scoped to the file
+     * resource. The target file content length is passed to the protocol method as an explicit parameter.
+     */
+    public static RequestOptions createFileRequestOptions(String resourcePath, Map metadata,
+        String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey,
+        String ntfsFileAttributes, String fileCreationTime, String fileLastWriteTime, String fileChangeTime,
+        String leaseId, FilePosixProperties posixProperties, byte[] contentMd5,
+        FilePropertySemantics filePropertySemantics, ShareFileHttpHeaders httpHeaders, BinaryData data,
+        Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addMetadata(requestOptions, metadata);
+        addFileHttpHeaders(requestOptions, httpHeaders);
+        addHeader(requestOptions, X_MS_FILE_PERMISSION, filePermission);
+        addFilePermissionFormat(requestOptions, filePermissionFormat);
+        addSmbProperties(requestOptions, filePermissionKey, ntfsFileAttributes, fileCreationTime, fileLastWriteTime,
+            fileChangeTime);
+        addLeaseId(requestOptions, leaseId);
+        addPosixProperties(requestOptions, posixProperties);
+        if (posixProperties != null) {
+            addHeader(requestOptions, X_MS_FILE_FILE_TYPE, posixProperties.getFileType());
+        }
+        if (contentMd5 != null) {
+            requestOptions.setHeader(HttpHeaderName.CONTENT_MD5, Base64.getEncoder().encodeToString(contentMd5));
+        }
+        addHeader(requestOptions, X_MS_FILE_PROPERTY_SEMANTICS, filePropertySemantics);
+        if (data != null) {
+            requestOptions.setBody(data);
+        }
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.startCopy}: metadata, permission, lease, POSIX properties, the
+     * mode/owner copy modes and the copy SMB info headers, scoped to the file resource. The copy source is passed to
+     * the protocol method as an explicit parameter.
+     */
+    public static RequestOptions startCopyRequestOptions(String resourcePath, Map metadata,
+        String filePermission, FilePermissionFormat filePermissionFormat, String filePermissionKey, String leaseId,
+        String owner, String group, Object fileMode, Object modeCopyMode, Object ownerCopyMode,
+        CopyFileSmbInfo copyFileSmbInfo, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addMetadata(requestOptions, metadata);
+        addHeader(requestOptions, X_MS_FILE_PERMISSION, filePermission);
+        addFilePermissionFormat(requestOptions, filePermissionFormat);
+        addHeader(requestOptions, X_MS_FILE_PERMISSION_KEY, filePermissionKey);
+        addLeaseId(requestOptions, leaseId);
+        addHeader(requestOptions, X_MS_OWNER, owner);
+        addHeader(requestOptions, X_MS_GROUP, group);
+        addHeader(requestOptions, X_MS_MODE, fileMode);
+        addHeader(requestOptions, X_MS_FILE_MODE_COPY_MODE, modeCopyMode);
+        addHeader(requestOptions, X_MS_FILE_OWNER_COPY_MODE, ownerCopyMode);
+        if (copyFileSmbInfo != null) {
+            addHeader(requestOptions, X_MS_FILE_PERMISSION_COPY_MODE, copyFileSmbInfo.getFilePermissionCopyMode());
+            addHeader(requestOptions, X_MS_FILE_ATTRIBUTES, copyFileSmbInfo.getFileAttributes());
+            addHeader(requestOptions, X_MS_FILE_CREATION_TIME, copyFileSmbInfo.getFileCreationTime());
+            addHeader(requestOptions, X_MS_FILE_LAST_WRITE_TIME, copyFileSmbInfo.getFileLastWriteTime());
+            addHeader(requestOptions, X_MS_FILE_CHANGE_TIME, copyFileSmbInfo.getFileChangeTime());
+            addHeader(requestOptions, X_MS_FILE_COPY_IGNORE_READONLY, copyFileSmbInfo.isIgnoreReadOnly());
+            addHeader(requestOptions, X_MS_FILE_COPY_SET_ARCHIVE, copyFileSmbInfo.isSetArchiveAttribute());
+        }
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.uploadRange}: the lease, last-written mode and optional content
+     * MD5 headers plus the request body, scoped to the file resource. The range, write mode and content length are
+     * passed to the protocol method as explicit parameters.
+     */
+    public static RequestOptions uploadRangeRequestOptions(String resourcePath, String leaseId,
+        FileLastWrittenMode lastWrittenMode, byte[] contentMd5, BinaryData data, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addLeaseId(requestOptions, leaseId);
+        addHeader(requestOptions, X_MS_FILE_LAST_WRITE_TIME, lastWrittenMode);
+        if (contentMd5 != null) {
+            requestOptions.setHeader(HttpHeaderName.CONTENT_MD5, Base64.getEncoder().encodeToString(contentMd5));
+        }
+        if (data != null) {
+            requestOptions.setBody(data);
+        }
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code File.download}: the range, range-get-content-md5 and lease headers,
+     * scoped to the file resource.
+     */
+    public static RequestOptions downloadRequestOptions(String resourcePath, String range, Boolean rangeGetContentMd5,
+        String leaseId, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_RANGE, range);
+        addHeader(requestOptions, X_MS_RANGE_GET_CONTENT_MD5, rangeGetContentMd5);
+        addLeaseId(requestOptions, leaseId);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
     /** Sets {@code name} to {@code String.valueOf(value)} when {@code value} is non-null. */
     private static void addHeader(RequestOptions requestOptions, HttpHeaderName name, Object value) {
         if (value != null) {
diff --git a/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json b/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
index 0ba66f2c3cab..0e919fe66ef0 100644
--- a/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
+++ b/sdk/storage/azure-storage-file-share/src/main/resources/META-INF/azure-storage-file-share_metadata.json
@@ -1 +1 @@
-{"flavor":"azure","apiVersions":{"Storage.File":"2026-12-06"},"crossLanguagePackageId":"Storage.File","crossLanguageVersion":"08484259fcf5","crossLanguageDefinitions":{"com.azure.storage.file.share.AzureFileStorageBuilder":"Storage.File","com.azure.storage.file.share.DirectoryAsyncClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryAsyncClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryAsyncClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryAsyncClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.FileAsyncClient":"Storage.File.File","com.azure.storage.file.share.FileAsyncClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileAsyncClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileAsyncClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient":"Storage.File.File","com.azure.storage.file.share.FileClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.ServiceAsyncClient":"Storage.File.Service","com.azure.storage.file.share.ServiceAsyncClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceAsyncClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceAsyncClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient":"Storage.File.Service","com.azure.storage.file.share.ServiceClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ShareAsyncClient":"Storage.File.Share","com.azure.storage.file.share.ShareAsyncClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareAsyncClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient":"Storage.File.Share","com.azure.storage.file.share.ShareClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType":"Storage.File.DeleteSnapshotsOptionType","com.azure.storage.file.share.implementation.models.DirectoryItem":"Storage.File.DirectoryItem","com.azure.storage.file.share.implementation.models.FileItem":"Storage.File.FileItem","com.azure.storage.file.share.implementation.models.FileProperty":"Storage.File.FileProperty","com.azure.storage.file.share.implementation.models.FilesAndDirectoriesListSegment":"Storage.File.FilesAndDirectoriesListSegment","com.azure.storage.file.share.implementation.models.HandleItem":"Storage.File.HandleItem","com.azure.storage.file.share.implementation.models.KeyInfo":"Storage.File.KeyInfo","com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse":"Storage.File.ListFilesAndDirectoriesSegmentResponse","com.azure.storage.file.share.implementation.models.ListFilesIncludeType":"Storage.File.ListFilesIncludeType","com.azure.storage.file.share.implementation.models.ListSharesIncludeType":"Storage.File.ListSharesIncludeType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteFromUrlType":"Storage.File.FileRangeWriteFromUrlType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType":"Storage.File.FileRangeWriteType","com.azure.storage.file.share.implementation.models.ShareItemInternal":"Storage.File.ShareItemInternal","com.azure.storage.file.share.implementation.models.SharePermission":"Storage.File.SharePermission","com.azure.storage.file.share.implementation.models.SharePropertiesInternal":"Storage.File.SharePropertiesInternal","com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper":"Storage.File.SignedIdentifiers","com.azure.storage.file.share.implementation.models.ShareStats":"Storage.File.ShareStats","com.azure.storage.file.share.implementation.models.SharesCreateSnapshotHeaders":null,"com.azure.storage.file.share.implementation.models.StringEncoded":"Storage.File.StringEncoded","com.azure.storage.file.share.models.ClearRange":"Storage.File.ClearRange","com.azure.storage.file.share.models.FileLastWrittenMode":"Storage.File.FileLastWrittenMode","com.azure.storage.file.share.models.FilePermissionFormat":"Storage.File.FilePermissionFormat","com.azure.storage.file.share.models.FilePropertySemantics":"Storage.File.FilePropertySemantics","com.azure.storage.file.share.models.FileRange":"Storage.File.FileRange","com.azure.storage.file.share.models.LeaseDurationType":"Storage.File.LeaseDurationType","com.azure.storage.file.share.models.LeaseStateType":"Storage.File.LeaseStateType","com.azure.storage.file.share.models.LeaseStatusType":"Storage.File.LeaseStatusType","com.azure.storage.file.share.models.ModeCopyMode":"Storage.File.ModeCopyMode","com.azure.storage.file.share.models.NfsFileType":"Storage.File.NfsFileType","com.azure.storage.file.share.models.OwnerCopyMode":"Storage.File.OwnerCopyMode","com.azure.storage.file.share.models.PermissionCopyModeType":"Storage.File.PermissionCopyModeType","com.azure.storage.file.share.models.ShareAccessPolicy":"Storage.File.AccessPolicy","com.azure.storage.file.share.models.ShareAccessTier":"Storage.File.ShareAccessTier","com.azure.storage.file.share.models.ShareCorsRule":"Storage.File.CorsRule","com.azure.storage.file.share.models.ShareFileHandleAccessRights":"Storage.File.AccessRight","com.azure.storage.file.share.models.ShareFileRangeList":"Storage.File.ShareFileRangeList","com.azure.storage.file.share.models.ShareMetrics":"Storage.File.Metrics","com.azure.storage.file.share.models.ShareNfsSettings":"Storage.File.ShareNfsSettings","com.azure.storage.file.share.models.ShareNfsSettingsEncryptionInTransit":"Storage.File.ShareNfsSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareProtocolSettings":"Storage.File.ShareProtocolSettings","com.azure.storage.file.share.models.ShareRetentionPolicy":"Storage.File.RetentionPolicy","com.azure.storage.file.share.models.ShareRootSquash":"Storage.File.ShareRootSquash","com.azure.storage.file.share.models.ShareServiceProperties":"Storage.File.StorageServiceProperties","com.azure.storage.file.share.models.ShareSignedIdentifier":"Storage.File.SignedIdentifier","com.azure.storage.file.share.models.ShareSmbSettings":"Storage.File.ShareSmbSettings","com.azure.storage.file.share.models.ShareSmbSettingsEncryptionInTransit":"Storage.File.ShareSmbSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareTokenIntent":"Storage.File.ShareTokenIntent","com.azure.storage.file.share.models.SmbMultichannel":"Storage.File.SmbMultichannel","com.azure.storage.file.share.models.UserDelegationKey":"Storage.File.UserDelegationKey"},"generatedFiles":["src/main/java/com/azure/storage/file/share/AzureFileStorageBuilder.java","src/main/java/com/azure/storage/file/share/DirectoryAsyncClient.java","src/main/java/com/azure/storage/file/share/DirectoryClient.java","src/main/java/com/azure/storage/file/share/FileAsyncClient.java","src/main/java/com/azure/storage/file/share/FileClient.java","src/main/java/com/azure/storage/file/share/FileServiceVersion.java","src/main/java/com/azure/storage/file/share/ServiceAsyncClient.java","src/main/java/com/azure/storage/file/share/ServiceClient.java","src/main/java/com/azure/storage/file/share/ShareAsyncClient.java","src/main/java/com/azure/storage/file/share/ShareClient.java","src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java","src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java","src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java","src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java","src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java","src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java","src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java","src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java","src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java","src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java","src/main/java/com/azure/storage/file/share/implementation/models/SharesCreateSnapshotHeaders.java","src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java","src/main/java/com/azure/storage/file/share/implementation/models/package-info.java","src/main/java/com/azure/storage/file/share/implementation/package-info.java","src/main/java/com/azure/storage/file/share/models/ClearRange.java","src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java","src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java","src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java","src/main/java/com/azure/storage/file/share/models/FileRange.java","src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java","src/main/java/com/azure/storage/file/share/models/LeaseStateType.java","src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java","src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java","src/main/java/com/azure/storage/file/share/models/NfsFileType.java","src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java","src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java","src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java","src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java","src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java","src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java","src/main/java/com/azure/storage/file/share/models/ShareMetrics.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java","src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java","src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java","src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java","src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java","src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java","src/main/java/com/azure/storage/file/share/models/package-info.java","src/main/java/com/azure/storage/file/share/package-info.java","src/main/java/module-info.java"]}
\ No newline at end of file
+{"flavor":"azure","apiVersions":{"Storage.File":"2026-12-06"},"crossLanguagePackageId":"Storage.File","crossLanguageVersion":"5d929a4c3464","crossLanguageDefinitions":{"com.azure.storage.file.share.AzureFileStorageBuilder":"Storage.File","com.azure.storage.file.share.DirectoryAsyncClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryAsyncClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryAsyncClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryAsyncClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryAsyncClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryAsyncClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryAsyncClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryAsyncClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryAsyncClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient":"Storage.File.Directory","com.azure.storage.file.share.DirectoryClient.create":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.createWithResponse":"Storage.File.Directory.create","com.azure.storage.file.share.DirectoryClient.delete":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.deleteWithResponse":"Storage.File.Directory.delete","com.azure.storage.file.share.DirectoryClient.forceCloseHandles":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.forceCloseHandlesWithResponse":"Storage.File.Directory.forceCloseHandles","com.azure.storage.file.share.DirectoryClient.getProperties":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.getPropertiesWithResponse":"Storage.File.Directory.getProperties","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegment":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listFilesAndDirectoriesSegmentWithResponse":"Storage.File.Directory.listFilesAndDirectoriesSegment","com.azure.storage.file.share.DirectoryClient.listHandles":"Storage.File.Directory.listHandles","com.azure.storage.file.share.DirectoryClient.rename":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.renameWithResponse":"Storage.File.Directory.rename","com.azure.storage.file.share.DirectoryClient.setMetadata":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setMetadataWithResponse":"Storage.File.Directory.setMetadata","com.azure.storage.file.share.DirectoryClient.setProperties":"Storage.File.Directory.setProperties","com.azure.storage.file.share.DirectoryClient.setPropertiesWithResponse":"Storage.File.Directory.setProperties","com.azure.storage.file.share.FileAsyncClient":"Storage.File.File","com.azure.storage.file.share.FileAsyncClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileAsyncClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileAsyncClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileAsyncClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileAsyncClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileAsyncClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileAsyncClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileAsyncClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileAsyncClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileAsyncClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileAsyncClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileAsyncClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileAsyncClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileAsyncClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileAsyncClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileAsyncClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileAsyncClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileAsyncClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileAsyncClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileAsyncClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileAsyncClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient":"Storage.File.File","com.azure.storage.file.share.FileClient.abortCopy":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.abortCopyWithResponse":"Storage.File.File.abortCopy","com.azure.storage.file.share.FileClient.acquireLease":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.acquireLeaseWithResponse":"Storage.File.File.acquireLease","com.azure.storage.file.share.FileClient.breakLease":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.breakLeaseWithResponse":"Storage.File.File.breakLease","com.azure.storage.file.share.FileClient.changeLease":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.changeLeaseWithResponse":"Storage.File.File.changeLease","com.azure.storage.file.share.FileClient.create":"Storage.File.File.create","com.azure.storage.file.share.FileClient.createHardLink":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createHardLinkWithResponse":"Storage.File.File.createHardLink","com.azure.storage.file.share.FileClient.createSymbolicLink":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createSymbolicLinkWithResponse":"Storage.File.File.createSymbolicLink","com.azure.storage.file.share.FileClient.createWithResponse":"Storage.File.File.create","com.azure.storage.file.share.FileClient.delete":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.deleteWithResponse":"Storage.File.File.delete","com.azure.storage.file.share.FileClient.download":"Storage.File.File.download","com.azure.storage.file.share.FileClient.downloadWithResponse":"Storage.File.File.download","com.azure.storage.file.share.FileClient.forceCloseHandles":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.forceCloseHandlesWithResponse":"Storage.File.File.forceCloseHandles","com.azure.storage.file.share.FileClient.getProperties":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getPropertiesWithResponse":"Storage.File.File.getProperties","com.azure.storage.file.share.FileClient.getRangeList":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getRangeListWithResponse":"Storage.File.File.getRangeList","com.azure.storage.file.share.FileClient.getSymbolicLink":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.getSymbolicLinkWithResponse":"Storage.File.File.getSymbolicLink","com.azure.storage.file.share.FileClient.listAllRanges":"Storage.File.File.listAllRanges","com.azure.storage.file.share.FileClient.listHandles":"Storage.File.File.listHandles","com.azure.storage.file.share.FileClient.releaseLease":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.releaseLeaseWithResponse":"Storage.File.File.releaseLease","com.azure.storage.file.share.FileClient.rename":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.renameWithResponse":"Storage.File.File.rename","com.azure.storage.file.share.FileClient.setHttpHeaders":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setHttpHeadersWithResponse":"Storage.File.File.setHttpHeaders","com.azure.storage.file.share.FileClient.setMetadata":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.setMetadataWithResponse":"Storage.File.File.setMetadata","com.azure.storage.file.share.FileClient.startCopy":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.startCopyWithResponse":"Storage.File.File.startCopy","com.azure.storage.file.share.FileClient.uploadRange":"Storage.File.File.uploadRange","com.azure.storage.file.share.FileClient.uploadRangeFromUrl":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeFromUrlWithResponse":"Storage.File.File.uploadRangeFromUrl","com.azure.storage.file.share.FileClient.uploadRangeWithResponse":"Storage.File.File.uploadRange","com.azure.storage.file.share.ServiceAsyncClient":"Storage.File.Service","com.azure.storage.file.share.ServiceAsyncClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceAsyncClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceAsyncClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceAsyncClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient":"Storage.File.Service","com.azure.storage.file.share.ServiceClient.getProperties":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getPropertiesWithResponse":"Storage.File.Service.getProperties","com.azure.storage.file.share.ServiceClient.getUserDelegationKey":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.getUserDelegationKeyWithResponse":"Storage.File.Service.getUserDelegationKey","com.azure.storage.file.share.ServiceClient.listSharesSegment":"Storage.File.Service.listSharesSegment","com.azure.storage.file.share.ServiceClient.setProperties":"Storage.File.Service.setProperties","com.azure.storage.file.share.ServiceClient.setPropertiesWithResponse":"Storage.File.Service.setProperties","com.azure.storage.file.share.ShareAsyncClient":"Storage.File.Share","com.azure.storage.file.share.ShareAsyncClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareAsyncClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareAsyncClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareAsyncClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareAsyncClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareAsyncClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareAsyncClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareAsyncClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareAsyncClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareAsyncClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareAsyncClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareAsyncClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareAsyncClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareAsyncClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareAsyncClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient":"Storage.File.Share","com.azure.storage.file.share.ShareClient.acquireLease":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.acquireLeaseWithResponse":"Storage.File.Share.acquireLease","com.azure.storage.file.share.ShareClient.breakLease":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.breakLeaseWithResponse":"Storage.File.Share.breakLease","com.azure.storage.file.share.ShareClient.changeLease":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.changeLeaseWithResponse":"Storage.File.Share.changeLease","com.azure.storage.file.share.ShareClient.create":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.createPermission":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createPermissionWithResponse":"Storage.File.Share.createPermission","com.azure.storage.file.share.ShareClient.createSnapshot":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createSnapshotWithResponse":"Storage.File.Share.createSnapshot","com.azure.storage.file.share.ShareClient.createWithResponse":"Storage.File.Share.create","com.azure.storage.file.share.ShareClient.delete":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.deleteWithResponse":"Storage.File.Share.delete","com.azure.storage.file.share.ShareClient.getAccessPolicy":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getAccessPolicyWithResponse":"Storage.File.Share.getAccessPolicy","com.azure.storage.file.share.ShareClient.getPermission":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getPermissionWithResponse":"Storage.File.Share.getPermission","com.azure.storage.file.share.ShareClient.getProperties":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getPropertiesWithResponse":"Storage.File.Share.getProperties","com.azure.storage.file.share.ShareClient.getStatistics":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.getStatisticsWithResponse":"Storage.File.Share.getStatistics","com.azure.storage.file.share.ShareClient.releaseLease":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.releaseLeaseWithResponse":"Storage.File.Share.releaseLease","com.azure.storage.file.share.ShareClient.renewLease":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.renewLeaseWithResponse":"Storage.File.Share.renewLease","com.azure.storage.file.share.ShareClient.restore":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.restoreWithResponse":"Storage.File.Share.restore","com.azure.storage.file.share.ShareClient.setAccessPolicy":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setAccessPolicyWithResponse":"Storage.File.Share.setAccessPolicy","com.azure.storage.file.share.ShareClient.setMetadata":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setMetadataWithResponse":"Storage.File.Share.setMetadata","com.azure.storage.file.share.ShareClient.setProperties":"Storage.File.Share.setProperties","com.azure.storage.file.share.ShareClient.setPropertiesWithResponse":"Storage.File.Share.setProperties","com.azure.storage.file.share.implementation.models.DeleteSnapshotsOptionType":"Storage.File.DeleteSnapshotsOptionType","com.azure.storage.file.share.implementation.models.DirectoryItem":"Storage.File.DirectoryItem","com.azure.storage.file.share.implementation.models.FileItem":"Storage.File.FileItem","com.azure.storage.file.share.implementation.models.FileProperty":"Storage.File.FileProperty","com.azure.storage.file.share.implementation.models.FilesAndDirectoriesListSegment":"Storage.File.FilesAndDirectoriesListSegment","com.azure.storage.file.share.implementation.models.HandleItem":"Storage.File.HandleItem","com.azure.storage.file.share.implementation.models.KeyInfo":"Storage.File.KeyInfo","com.azure.storage.file.share.implementation.models.ListFilesAndDirectoriesSegmentResponse":"Storage.File.ListFilesAndDirectoriesSegmentResponse","com.azure.storage.file.share.implementation.models.ListFilesIncludeType":"Storage.File.ListFilesIncludeType","com.azure.storage.file.share.implementation.models.ListSharesIncludeType":"Storage.File.ListSharesIncludeType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteFromUrlType":"Storage.File.FileRangeWriteFromUrlType","com.azure.storage.file.share.implementation.models.ShareFileRangeWriteType":"Storage.File.FileRangeWriteType","com.azure.storage.file.share.implementation.models.ShareItemInternal":"Storage.File.ShareItemInternal","com.azure.storage.file.share.implementation.models.SharePermission":"Storage.File.SharePermission","com.azure.storage.file.share.implementation.models.SharePropertiesInternal":"Storage.File.SharePropertiesInternal","com.azure.storage.file.share.implementation.models.ShareSignedIdentifierWrapper":"Storage.File.SignedIdentifiers","com.azure.storage.file.share.implementation.models.ShareStats":"Storage.File.ShareStats","com.azure.storage.file.share.implementation.models.StringEncoded":"Storage.File.StringEncoded","com.azure.storage.file.share.models.ClearRange":"Storage.File.ClearRange","com.azure.storage.file.share.models.FileLastWrittenMode":"Storage.File.FileLastWrittenMode","com.azure.storage.file.share.models.FilePermissionFormat":"Storage.File.FilePermissionFormat","com.azure.storage.file.share.models.FilePropertySemantics":"Storage.File.FilePropertySemantics","com.azure.storage.file.share.models.FileRange":"Storage.File.FileRange","com.azure.storage.file.share.models.LeaseDurationType":"Storage.File.LeaseDurationType","com.azure.storage.file.share.models.LeaseStateType":"Storage.File.LeaseStateType","com.azure.storage.file.share.models.LeaseStatusType":"Storage.File.LeaseStatusType","com.azure.storage.file.share.models.ModeCopyMode":"Storage.File.ModeCopyMode","com.azure.storage.file.share.models.NfsFileType":"Storage.File.NfsFileType","com.azure.storage.file.share.models.OwnerCopyMode":"Storage.File.OwnerCopyMode","com.azure.storage.file.share.models.PermissionCopyModeType":"Storage.File.PermissionCopyModeType","com.azure.storage.file.share.models.ShareAccessPolicy":"Storage.File.AccessPolicy","com.azure.storage.file.share.models.ShareAccessTier":"Storage.File.ShareAccessTier","com.azure.storage.file.share.models.ShareCorsRule":"Storage.File.CorsRule","com.azure.storage.file.share.models.ShareFileHandleAccessRights":"Storage.File.AccessRight","com.azure.storage.file.share.models.ShareFileRangeList":"Storage.File.ShareFileRangeList","com.azure.storage.file.share.models.ShareMetrics":"Storage.File.Metrics","com.azure.storage.file.share.models.ShareNfsSettings":"Storage.File.ShareNfsSettings","com.azure.storage.file.share.models.ShareNfsSettingsEncryptionInTransit":"Storage.File.ShareNfsSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareProtocolSettings":"Storage.File.ShareProtocolSettings","com.azure.storage.file.share.models.ShareRetentionPolicy":"Storage.File.RetentionPolicy","com.azure.storage.file.share.models.ShareRootSquash":"Storage.File.ShareRootSquash","com.azure.storage.file.share.models.ShareServiceProperties":"Storage.File.StorageServiceProperties","com.azure.storage.file.share.models.ShareSignedIdentifier":"Storage.File.SignedIdentifier","com.azure.storage.file.share.models.ShareSmbSettings":"Storage.File.ShareSmbSettings","com.azure.storage.file.share.models.ShareSmbSettingsEncryptionInTransit":"Storage.File.ShareSmbSettingsEncryptionInTransit","com.azure.storage.file.share.models.ShareTokenIntent":"Storage.File.ShareTokenIntent","com.azure.storage.file.share.models.SmbMultichannel":"Storage.File.SmbMultichannel","com.azure.storage.file.share.models.UserDelegationKey":"Storage.File.UserDelegationKey"},"generatedFiles":["src/main/java/com/azure/storage/file/share/AzureFileStorageBuilder.java","src/main/java/com/azure/storage/file/share/DirectoryAsyncClient.java","src/main/java/com/azure/storage/file/share/DirectoryClient.java","src/main/java/com/azure/storage/file/share/FileAsyncClient.java","src/main/java/com/azure/storage/file/share/FileClient.java","src/main/java/com/azure/storage/file/share/FileServiceVersion.java","src/main/java/com/azure/storage/file/share/ServiceAsyncClient.java","src/main/java/com/azure/storage/file/share/ServiceClient.java","src/main/java/com/azure/storage/file/share/ShareAsyncClient.java","src/main/java/com/azure/storage/file/share/ShareClient.java","src/main/java/com/azure/storage/file/share/implementation/AzureFileStorageImpl.java","src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java","src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java","src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java","src/main/java/com/azure/storage/file/share/implementation/SharesImpl.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java","src/main/java/com/azure/storage/file/share/implementation/XmlSerializerProviders.java","src/main/java/com/azure/storage/file/share/implementation/models/DeleteSnapshotsOptionType.java","src/main/java/com/azure/storage/file/share/implementation/models/DirectoryItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileItem.java","src/main/java/com/azure/storage/file/share/implementation/models/FileProperty.java","src/main/java/com/azure/storage/file/share/implementation/models/FilesAndDirectoriesListSegment.java","src/main/java/com/azure/storage/file/share/implementation/models/HandleItem.java","src/main/java/com/azure/storage/file/share/implementation/models/KeyInfo.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesAndDirectoriesSegmentResponse.java","src/main/java/com/azure/storage/file/share/implementation/models/ListFilesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ListSharesIncludeType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteFromUrlType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareFileRangeWriteType.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareItemInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePermission.java","src/main/java/com/azure/storage/file/share/implementation/models/SharePropertiesInternal.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareSignedIdentifierWrapper.java","src/main/java/com/azure/storage/file/share/implementation/models/ShareStats.java","src/main/java/com/azure/storage/file/share/implementation/models/StringEncoded.java","src/main/java/com/azure/storage/file/share/implementation/models/package-info.java","src/main/java/com/azure/storage/file/share/implementation/package-info.java","src/main/java/com/azure/storage/file/share/models/ClearRange.java","src/main/java/com/azure/storage/file/share/models/FileLastWrittenMode.java","src/main/java/com/azure/storage/file/share/models/FilePermissionFormat.java","src/main/java/com/azure/storage/file/share/models/FilePropertySemantics.java","src/main/java/com/azure/storage/file/share/models/FileRange.java","src/main/java/com/azure/storage/file/share/models/LeaseDurationType.java","src/main/java/com/azure/storage/file/share/models/LeaseStateType.java","src/main/java/com/azure/storage/file/share/models/LeaseStatusType.java","src/main/java/com/azure/storage/file/share/models/ModeCopyMode.java","src/main/java/com/azure/storage/file/share/models/NfsFileType.java","src/main/java/com/azure/storage/file/share/models/OwnerCopyMode.java","src/main/java/com/azure/storage/file/share/models/PermissionCopyModeType.java","src/main/java/com/azure/storage/file/share/models/ShareAccessPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareAccessTier.java","src/main/java/com/azure/storage/file/share/models/ShareCorsRule.java","src/main/java/com/azure/storage/file/share/models/ShareFileHandleAccessRights.java","src/main/java/com/azure/storage/file/share/models/ShareFileRangeList.java","src/main/java/com/azure/storage/file/share/models/ShareMetrics.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettings.java","src/main/java/com/azure/storage/file/share/models/ShareNfsSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareProtocolSettings.java","src/main/java/com/azure/storage/file/share/models/ShareRetentionPolicy.java","src/main/java/com/azure/storage/file/share/models/ShareRootSquash.java","src/main/java/com/azure/storage/file/share/models/ShareServiceProperties.java","src/main/java/com/azure/storage/file/share/models/ShareSignedIdentifier.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettings.java","src/main/java/com/azure/storage/file/share/models/ShareSmbSettingsEncryptionInTransit.java","src/main/java/com/azure/storage/file/share/models/ShareTokenIntent.java","src/main/java/com/azure/storage/file/share/models/SmbMultichannel.java","src/main/java/com/azure/storage/file/share/models/UserDelegationKey.java","src/main/java/com/azure/storage/file/share/models/package-info.java","src/main/java/com/azure/storage/file/share/package-info.java","src/main/java/module-info.java"]}
\ No newline at end of file
diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
index 2607ee5a0049..3c530fa8b914 100644
--- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
+++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
@@ -189,12 +189,7 @@ private static void exposeRawListSharesSegment(LibraryCustomization customizatio
      */
     private static void exposeRawListHandles(LibraryCustomization customization, Logger logger) {
         Editor editor = customization.getRawEditor();
-        String path = PKG_ROOT + "implementation/DirectoriesImpl.java";
-        String content = editor.getFileContent(path);
         String anchor = "    public PagedIterable listHandles(RequestOptions requestOptions) {";
-        if (content.contains("listHandlesWithResponse(RequestOptions") || !content.contains(anchor)) {
-            return;
-        }
         String rawMethods = "    public Response listHandlesWithResponse(RequestOptions requestOptions) {\n"
             + "        final String accept = \"application/xml\";\n"
             + "        try {\n"
@@ -213,8 +208,15 @@ private static void exposeRawListHandles(LibraryCustomization customization, Log
             + "                this.client.getFileRequestIntent(), accept, requestOptions, context))\n"
             + "            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
             + "    }\n\n";
-        editor.replaceFile(path, content.replace(anchor, rawMethods + anchor));
-        logger.info("Exposed raw listHandlesWithResponse methods in {}", path);
+        for (String implName : Arrays.asList("DirectoriesImpl", "FilesImpl")) {
+            String path = PKG_ROOT + "implementation/" + implName + ".java";
+            String content = editor.getFileContent(path);
+            if (content.contains("listHandlesWithResponse(RequestOptions") || !content.contains(anchor)) {
+                continue;
+            }
+            editor.replaceFile(path, content.replace(anchor, rawMethods + anchor));
+            logger.info("Exposed raw listHandlesWithResponse methods in {}", path);
+        }
     }
 
     /**

From aacd64e1a3618a238f369b25098353f8a7ec8544 Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Tue, 11 Aug 2026 11:42:29 -0700
Subject: [PATCH 10/13] lease and errors

---
 .../share/implementation/XmlSerializer.java   |  2 +-
 .../implementation/util/ModelHelper.java      | 17 ++++--
 .../util/RequestOptionsHelper.java            | 44 +++++++++++++++
 .../specialized/ShareLeaseAsyncClient.java    | 56 +++++++++++--------
 .../specialized/ShareLeaseClientBuilder.java  |  2 +-
 .../main/java/ShareStorageCustomization.java  | 22 ++++++++
 6 files changed, 114 insertions(+), 29 deletions(-)

diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java
index 15a0ab771cf7..bc61c55e3ef3 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java
@@ -33,7 +33,7 @@ public final class XmlSerializer implements ObjectSerializer {
     @Override
     @SuppressWarnings("unchecked")
     public  T deserialize(InputStream stream, TypeReference typeReference) {
-        Class clazz = (Class) typeReference.getJavaClass();
+        Class clazz = typeReference.getJavaClass();
         Method fromXml = FROM_XML_CACHE.computeIfAbsent(clazz, c -> {
             try {
                 return c.getDeclaredMethod("fromXml", XmlReader.class);
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
index 329df5e10f2f..077ab2636850 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/ModelHelper.java
@@ -217,7 +217,7 @@ public static ShareItem populateShareItem(ShareItemInternal shareItemInternal) {
         item.setSnapshot(shareItemInternal.getSnapshot());
         item.setDeleted(shareItemInternal.isDeleted());
         item.setVersion(shareItemInternal.getVersion());
-        item.setProperties(populateShareProperties(shareItemInternal.getProperties()));
+        item.setProperties(populateShareProperties(shareItemInternal.getProperties(), shareItemInternal.getMetadata()));
         item.setMetadata(shareItemInternal.getMetadata());
         return item;
     }
@@ -226,9 +226,11 @@ public static ShareItem populateShareItem(ShareItemInternal shareItemInternal) {
      * Transforms {@link SharePropertiesInternal} into a public {@link ShareProperties}.
      *
      * @param sharePropertiesInternal {@link SharePropertiesInternal}
+     * @param metadata the share metadata (carried on the parent {@code ShareItemInternal}).
      * @return {@link ShareProperties}
      */
-    public static ShareProperties populateShareProperties(SharePropertiesInternal sharePropertiesInternal) {
+    public static ShareProperties populateShareProperties(SharePropertiesInternal sharePropertiesInternal,
+        Map metadata) {
         ShareProperties properties = new ShareProperties();
         properties.setLastModified(sharePropertiesInternal.getLastModified());
         properties.setETag(sharePropertiesInternal.getETag());
@@ -247,7 +249,7 @@ public static ShareProperties populateShareProperties(SharePropertiesInternal sh
         properties.setLeaseDuration(sharePropertiesInternal.getLeaseDuration());
         properties.setProtocols(parseShareProtocols(sharePropertiesInternal.getEnabledProtocols()));
         properties.setRootSquash(sharePropertiesInternal.getRootSquash());
-        properties.setMetadata(sharePropertiesInternal.getMetadata());
+        properties.setMetadata(metadata);
         properties.setProvisionedBandwidthMiBps(sharePropertiesInternal.getProvisionedBandwidthMiBps());
         properties
             .setSnapshotVirtualDirectoryAccessEnabled(sharePropertiesInternal.isEnableSnapshotVirtualDirectoryAccess());
@@ -320,7 +322,7 @@ public static ShareFileItemProperties transformFileProperty(FileProperty propert
             return null;
         }
         return new InternalShareFileItemProperties(property.getCreationTime(), property.getLastAccessTime(),
-            property.getLastWriteTime(), property.getChangeTime(), property.getLastModified(), property.getEtag());
+            property.getLastWriteTime(), property.getChangeTime(), property.getLastModified(), property.getETag());
     }
 
     public static HandleItem
@@ -735,6 +737,13 @@ public static Response mapGetRangeListResponse(Response(response, rangeList);
     }
 
+    private static final HttpHeaderName X_MS_LEASE_ID = HttpHeaderName.fromString("x-ms-lease-id");
+
+    /** Maps a lease response into the {@code x-ms-lease-id} header value. */
+    public static Response mapLeaseIdResponse(Response response) {
+        return new SimpleResponse<>(response, response.getHeaders().getValue(X_MS_LEASE_ID));
+    }
+
     /** Maps a file Force Close Handles response into the closed/failed handle counts. */
     public static Response mapFileForceCloseHandlesResponse(Response response) {
         FilesForceCloseHandlesHeaders headers = new FilesForceCloseHandlesHeaders(response.getHeaders());
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
index 4dfcb5d7ead6..383076436fb6 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/util/RequestOptionsHelper.java
@@ -43,6 +43,9 @@
 public final class RequestOptionsHelper {
 
     private static final HttpHeaderName X_MS_LEASE_ID = HttpHeaderName.fromString("x-ms-lease-id");
+    private static final HttpHeaderName X_MS_LEASE_DURATION = HttpHeaderName.fromString("x-ms-lease-duration");
+    private static final HttpHeaderName X_MS_PROPOSED_LEASE_ID = HttpHeaderName.fromString("x-ms-proposed-lease-id");
+    private static final HttpHeaderName X_MS_LEASE_BREAK_PERIOD = HttpHeaderName.fromString("x-ms-lease-break-period");
     private static final HttpHeaderName X_MS_DELETE_SNAPSHOTS = HttpHeaderName.fromString("x-ms-delete-snapshots");
     private static final HttpHeaderName X_MS_DELETED_SHARE_NAME = HttpHeaderName.fromString("x-ms-deleted-share-name");
     private static final HttpHeaderName X_MS_DELETED_SHARE_VERSION
@@ -507,6 +510,47 @@ public static RequestOptions snapshotRequestOptions(String resourcePath, String
         return requestOptions;
     }
 
+    /**
+     * Builds the {@link RequestOptions} for {@code acquireLease}: the lease-duration and proposed-lease-id headers plus
+     * the optional snapshot query parameter, scoped to the resource.
+     */
+    public static RequestOptions acquireLeaseRequestOptions(String resourcePath, Integer duration,
+        String proposedLeaseId, String snapshot, Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_LEASE_DURATION, duration);
+        addHeader(requestOptions, X_MS_PROPOSED_LEASE_ID, proposedLeaseId);
+        addSnapshot(requestOptions, snapshot);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code changeLease}: the proposed-lease-id header plus the optional snapshot
+     * query parameter, scoped to the resource. The current lease id is passed to the protocol method as an explicit
+     * parameter.
+     */
+    public static RequestOptions changeLeaseRequestOptions(String resourcePath, String proposedLeaseId, String snapshot,
+        Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_PROPOSED_LEASE_ID, proposedLeaseId);
+        addSnapshot(requestOptions, snapshot);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
+    /**
+     * Builds the {@link RequestOptions} for {@code breakLease}: the lease-break-period header plus the optional snapshot
+     * query parameter, scoped to the resource.
+     */
+    public static RequestOptions breakLeaseRequestOptions(String resourcePath, Integer breakPeriod, String snapshot,
+        Context context) {
+        RequestOptions requestOptions = new RequestOptions().setContext(context);
+        addHeader(requestOptions, X_MS_LEASE_BREAK_PERIOD, breakPeriod);
+        addSnapshot(requestOptions, snapshot);
+        scopeRequestToResourcePath(requestOptions, resourcePath);
+        return requestOptions;
+    }
+
     /** Adds the file HTTP content headers ({@code x-ms-content-*}, {@code x-ms-cache-control}). */
     public static void addFileHttpHeaders(RequestOptions requestOptions, ShareFileHttpHeaders httpHeaders) {
         if (httpHeaders != null) {
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/specialized/ShareLeaseAsyncClient.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/specialized/ShareLeaseAsyncClient.java
index a0b0e8cbeee5..2ed740cb5c2f 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/specialized/ShareLeaseAsyncClient.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/specialized/ShareLeaseAsyncClient.java
@@ -7,13 +7,17 @@
 import com.azure.core.annotation.ServiceClient;
 import com.azure.core.annotation.ServiceMethod;
 import com.azure.core.http.HttpPipeline;
+import com.azure.core.http.rest.RequestOptions;
 import com.azure.core.http.rest.Response;
 import com.azure.core.http.rest.SimpleResponse;
 import com.azure.core.util.Context;
 import com.azure.core.util.FluxUtil;
 import com.azure.core.util.logging.ClientLogger;
 import com.azure.storage.file.share.ShareFileAsyncClient;
+import com.azure.storage.file.share.ShareServiceVersion;
 import com.azure.storage.file.share.implementation.AzureFileStorageImpl;
+import com.azure.storage.file.share.implementation.util.ModelHelper;
+import com.azure.storage.file.share.implementation.util.RequestOptionsHelper;
 import com.azure.storage.file.share.models.ShareTokenIntent;
 import com.azure.storage.file.share.options.ShareAcquireLeaseOptions;
 import com.azure.storage.file.share.options.ShareBreakLeaseOptions;
@@ -59,12 +63,13 @@ public final class ShareLeaseAsyncClient {
     private volatile String leaseId;
 
     ShareLeaseAsyncClient(HttpPipeline pipeline, String url, String shareName, String shareSnapshot,
-        String resourcePath, String leaseId, boolean isShareFile, String accountName, String serviceVersion,
-        boolean allowTrailingDot, boolean allowSourceTrailingDot, ShareTokenIntent shareTokenIntent) {
+        String resourcePath, String leaseId, boolean isShareFile, String accountName,
+        ShareServiceVersion serviceVersion, boolean allowTrailingDot, boolean allowSourceTrailingDot,
+        ShareTokenIntent shareTokenIntent) {
         this.isShareFile = isShareFile;
         this.leaseId = leaseId;
-        this.client = new AzureFileStorageImpl(pipeline, serviceVersion, shareTokenIntent, url, allowTrailingDot,
-            allowSourceTrailingDot);
+        this.client = new AzureFileStorageImpl(pipeline, url, shareTokenIntent, allowTrailingDot,
+            allowSourceTrailingDot, serviceVersion);
         this.accountName = accountName;
         this.shareName = shareName;
         this.shareSnapshot = shareSnapshot;
@@ -177,14 +182,14 @@ Mono> acquireLeaseWithResponse(ShareAcquireLeaseOptions options
         Mono> response;
         if (this.isShareFile) {
             response = this.client.getFiles()
-                .acquireLeaseWithResponseAsync(shareName, resourcePath, null, options.getDuration(), this.leaseId, null,
-                    context)
-                .map(rb -> new SimpleResponse<>(rb, rb.getDeserializedHeaders().getXMsLeaseId()));
+                .acquireLeaseWithResponseAsync(RequestOptionsHelper.acquireLeaseRequestOptions(
+                    shareName + "/" + resourcePath, options.getDuration(), this.leaseId, null, context))
+                .map(ModelHelper::mapLeaseIdResponse);
         } else {
             response = this.client.getShares()
-                .acquireLeaseWithResponseAsync(shareName, null, options.getDuration(), this.leaseId, shareSnapshot,
-                    null, context)
-                .map(rb -> new SimpleResponse<>(rb, rb.getDeserializedHeaders().getXMsLeaseId()));
+                .acquireLeaseWithResponseAsync(RequestOptionsHelper.acquireLeaseRequestOptions(shareName,
+                    options.getDuration(), this.leaseId, shareSnapshot, context))
+                .map(ModelHelper::mapLeaseIdResponse);
         }
 
         response = response.doOnSuccess(r -> this.leaseId = r.getValue());
@@ -236,12 +241,12 @@ Mono> releaseLeaseWithResponse(Context context) {
         context = context == null ? Context.NONE : context;
         if (this.isShareFile) {
             return this.client.getFiles()
-                .releaseLeaseNoCustomHeadersWithResponseAsync(shareName, resourcePath, this.leaseId, null, null,
-                    context);
+                .releaseLeaseWithResponseAsync(this.leaseId,
+                    RequestOptionsHelper.snapshotRequestOptions(shareName + "/" + resourcePath, null, context));
         } else {
             return this.client.getShares()
-                .releaseLeaseNoCustomHeadersWithResponseAsync(shareName, this.leaseId, null, shareSnapshot, null,
-                    context);
+                .releaseLeaseWithResponseAsync(this.leaseId,
+                    RequestOptionsHelper.snapshotRequestOptions(shareName, shareSnapshot, context));
         }
     }
 
@@ -318,11 +323,12 @@ Mono> breakLeaseWithResponse(ShareBreakLeaseOptions options, Cont
             = options.getBreakPeriod() == null ? null : Math.toIntExact(options.getBreakPeriod().getSeconds());
         if (this.isShareFile) {
             return this.client.getFiles()
-                .breakLeaseNoCustomHeadersWithResponseAsync(shareName, resourcePath, null, null, null, context);
+                .breakLeaseWithResponseAsync(
+                    RequestOptionsHelper.breakLeaseRequestOptions(shareName + "/" + resourcePath, null, null, context));
         } else {
             return this.client.getShares()
-                .breakLeaseNoCustomHeadersWithResponseAsync(shareName, null, breakPeriod, null, null, shareSnapshot,
-                    context);
+                .breakLeaseWithResponseAsync(
+                    RequestOptionsHelper.breakLeaseRequestOptions(shareName, breakPeriod, shareSnapshot, context));
         }
     }
 
@@ -375,12 +381,15 @@ Mono> changeLeaseWithResponse(String proposedId, Context contex
         Mono> response;
         if (this.isShareFile) {
             response = this.client.getFiles()
-                .changeLeaseWithResponseAsync(shareName, resourcePath, this.leaseId, null, proposedId, null, context)
-                .map(rb -> new SimpleResponse<>(rb, rb.getDeserializedHeaders().getXMsLeaseId()));
+                .changeLeaseWithResponseAsync(this.leaseId,
+                    RequestOptionsHelper.changeLeaseRequestOptions(shareName + "/" + resourcePath, proposedId, null,
+                        context))
+                .map(ModelHelper::mapLeaseIdResponse);
         } else {
             response = this.client.getShares()
-                .changeLeaseWithResponseAsync(shareName, this.leaseId, null, proposedId, shareSnapshot, null, context)
-                .map(rb -> new SimpleResponse<>(rb, rb.getDeserializedHeaders().getXMsLeaseId()));
+                .changeLeaseWithResponseAsync(this.leaseId,
+                    RequestOptionsHelper.changeLeaseRequestOptions(shareName, proposedId, shareSnapshot, context))
+                .map(ModelHelper::mapLeaseIdResponse);
         }
 
         response = response.doOnSuccess(r -> this.leaseId = r.getValue());
@@ -437,8 +446,9 @@ Mono> renewLeaseWithResponse(Context context) {
                 .logExceptionAsError(new UnsupportedOperationException("Cannot renew a lease on a share file."));
         } else {
             response = this.client.getShares()
-                .renewLeaseWithResponseAsync(shareName, this.leaseId, null, shareSnapshot, null, context)
-                .map(rb -> new SimpleResponse<>(rb, rb.getDeserializedHeaders().getXMsLeaseId()));
+                .renewLeaseWithResponseAsync(this.leaseId,
+                    RequestOptionsHelper.snapshotRequestOptions(shareName, shareSnapshot, context))
+                .map(ModelHelper::mapLeaseIdResponse);
         }
 
         response = response.doOnSuccess(r -> this.leaseId = r.getValue());
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/specialized/ShareLeaseClientBuilder.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/specialized/ShareLeaseClientBuilder.java
index 7d7d79930360..1c6e781bc95b 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/specialized/ShareLeaseClientBuilder.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/specialized/ShareLeaseClientBuilder.java
@@ -109,7 +109,7 @@ public ShareLeaseClient buildClient() {
     public ShareLeaseAsyncClient buildAsyncClient() {
         ShareServiceVersion version = (serviceVersion == null) ? ShareServiceVersion.getLatest() : serviceVersion;
         return new ShareLeaseAsyncClient(pipeline, url, shareName, shareSnapshot, resourcePath, getLeaseId(),
-            isShareFile, accountName, version.getVersion(), allowTrailingDot, allowSourceTrailingDot, shareTokenIntent);
+            isShareFile, accountName, version, allowTrailingDot, allowSourceTrailingDot, shareTokenIntent);
     }
 
     /**
diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
index 3c530fa8b914..39d8338431ac 100644
--- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
+++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
@@ -83,6 +83,8 @@ public void customize(LibraryCustomization customization, Logger logger) {
 
         exposeRawListHandles(customization, logger);
 
+        fixXmlSerializerRedundantCast(customization, logger);
+
         restoreFluentModels(customization, logger);
 
         customization.getClass("com.azure.storage.file.share.models", "ShareTokenIntent")
@@ -138,6 +140,26 @@ private static void retypeServiceVersionToShareServiceVersion(LibraryCustomizati
         }
     }
 
+    /**
+     * Removes the redundant {@code (Class)} cast the emitter generates in {@code XmlSerializer.deserialize}. The
+     * current azure-core {@code TypeReference#getJavaClass()} already returns {@code Class}, so the cast triggers a
+     * javac "redundant cast" warning which fails the {@code -Werror} build.
+     *
+     * @param customization The library customization.
+     * @param logger The logger.
+     */
+    private static void fixXmlSerializerRedundantCast(LibraryCustomization customization, Logger logger) {
+        Editor editor = customization.getRawEditor();
+        String path = PKG_ROOT + "implementation/XmlSerializer.java";
+        String content = editor.getFileContent(path);
+        String redundant = "Class clazz = (Class) typeReference.getJavaClass();";
+        if (!content.contains(redundant)) {
+            return;
+        }
+        editor.replaceFile(path, content.replace(redundant, "Class clazz = typeReference.getJavaClass();"));
+        logger.info("Removed redundant Class cast in {}", path);
+    }
+
     /**
      * Exposes raw {@code Response} accessors for the List Shares Segment operation. The generated
      * {@code listSharesSegmentSinglePage} paging helpers deserialize only the per-item {@code ShareItemInternal}

From 356e1f51657e36af12348cd3705978d7ab72a8ea Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Tue, 11 Aug 2026 12:15:17 -0700
Subject: [PATCH 11/13] swapping string replacement for ast customization where
 applicable

---
 .../main/java/ShareStorageCustomization.java  | 139 +++++++++---------
 1 file changed, 73 insertions(+), 66 deletions(-)

diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
index 39d8338431ac..693832f47ccc 100644
--- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
+++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
@@ -14,6 +14,8 @@
 import com.github.javaparser.ast.body.MethodDeclaration;
 import com.github.javaparser.ast.body.Parameter;
 import com.github.javaparser.ast.body.VariableDeclarator;
+import com.github.javaparser.ast.expr.ArrayInitializerExpr;
+import com.github.javaparser.ast.expr.StringLiteralExpr;
 import com.github.javaparser.ast.stmt.BlockStmt;
 import com.github.javaparser.ast.stmt.CatchClause;
 import com.github.javaparser.ast.stmt.Statement;
@@ -141,23 +143,25 @@ private static void retypeServiceVersionToShareServiceVersion(LibraryCustomizati
     }
 
     /**
-     * Removes the redundant {@code (Class)} cast the emitter generates in {@code XmlSerializer.deserialize}. The
-     * current azure-core {@code TypeReference#getJavaClass()} already returns {@code Class}, so the cast triggers a
-     * javac "redundant cast" warning which fails the {@code -Werror} build.
+     * Relaxes the javac "redundant cast" lint for the single {@code (Class)} cast the emitter generates in
+     * {@code XmlSerializer.deserialize}. The current azure-core {@code TypeReference#getJavaClass()} already returns
+     * {@code Class}, so the cast is redundant and fails the {@code -Werror} build; this adds {@code "cast"} to the
+     * method's existing {@code @SuppressWarnings}.
      *
      * @param customization The library customization.
      * @param logger The logger.
      */
     private static void fixXmlSerializerRedundantCast(LibraryCustomization customization, Logger logger) {
-        Editor editor = customization.getRawEditor();
-        String path = PKG_ROOT + "implementation/XmlSerializer.java";
-        String content = editor.getFileContent(path);
-        String redundant = "Class clazz = (Class) typeReference.getJavaClass();";
-        if (!content.contains(redundant)) {
-            return;
-        }
-        editor.replaceFile(path, content.replace(redundant, "Class clazz = typeReference.getJavaClass();"));
-        logger.info("Removed redundant Class cast in {}", path);
+        customization.getClass("com.azure.storage.file.share.implementation", "XmlSerializer")
+            .customizeAst(ast -> ast.getClassByName("XmlSerializer").ifPresent(clazz -> {
+                clazz.getMethodsByName("deserialize")
+                    .forEach(method -> method.getAnnotationByName("SuppressWarnings")
+                        .filter(annotation -> annotation.isSingleMemberAnnotationExpr())
+                        .ifPresent(annotation -> annotation.asSingleMemberAnnotationExpr()
+                            .setMemberValue(new ArrayInitializerExpr(new NodeList<>(
+                                new StringLiteralExpr("unchecked"), new StringLiteralExpr("cast"))))));
+                logger.info("Suppressed redundant-cast warning on XmlSerializer.deserialize");
+            }));
     }
 
     /**
@@ -171,33 +175,34 @@ private static void fixXmlSerializerRedundantCast(LibraryCustomization customiza
      * @param logger The logger.
      */
     private static void exposeRawListSharesSegment(LibraryCustomization customization, Logger logger) {
-        Editor editor = customization.getRawEditor();
-        String path = PKG_ROOT + "implementation/ServicesImpl.java";
-        String content = editor.getFileContent(path);
-        String anchor = "    public PagedIterable listSharesSegment(RequestOptions requestOptions) {";
-        if (content.contains("listSharesSegmentWithResponse(") || !content.contains(anchor)) {
-            return;
-        }
-        String rawMethods
-            = "    public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {\n"
-                + "        final String accept = \"application/xml\";\n"
-                + "        try {\n"
-                + "            return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
-                + "                this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);\n"
-                + "        } catch (ShareStorageExceptionInternal internalException) {\n"
-                + "            throw ModelHelper.mapToShareStorageException(internalException);\n"
-                + "        }\n"
-                + "    }\n\n"
-                + "    public Mono> listSharesSegmentWithResponseAsync(RequestOptions requestOptions) {\n"
-                + "        final String accept = \"application/xml\";\n"
-                + "        return FluxUtil\n"
-                + "            .withContext(context -> service.listSharesSegment(this.client.getUrl(),\n"
-                + "                this.client.getServiceVersion().getVersion(), this.client.getFileRequestIntent(), accept,\n"
-                + "                requestOptions, context))\n"
-                + "            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
-                + "    }\n\n";
-        editor.replaceFile(path, content.replace(anchor, rawMethods + anchor));
-        logger.info("Exposed raw listSharesSegmentWithResponse methods in {}", path);
+        customization.getClass("com.azure.storage.file.share.implementation", "ServicesImpl")
+            .customizeAst(ast -> ast.getClassByName("ServicesImpl").ifPresent(clazz -> {
+                if (!clazz.getMethodsByName("listSharesSegmentWithResponse").isEmpty()) {
+                    return;
+                }
+                ast.addImport("com.azure.storage.file.share.implementation.util.ModelHelper");
+                ast.addImport("com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal");
+                clazz.addMember(StaticJavaParser.parseMethodDeclaration(
+                    "public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {\n"
+                        + "    final String accept = \"application/xml\";\n"
+                        + "    try {\n"
+                        + "        return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
+                        + "            this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);\n"
+                        + "    } catch (ShareStorageExceptionInternal internalException) {\n"
+                        + "        throw ModelHelper.mapToShareStorageException(internalException);\n"
+                        + "    }\n"
+                        + "}"));
+                clazz.addMember(StaticJavaParser.parseMethodDeclaration(
+                    "public Mono> listSharesSegmentWithResponseAsync(RequestOptions requestOptions) {\n"
+                        + "    final String accept = \"application/xml\";\n"
+                        + "    return FluxUtil\n"
+                        + "        .withContext(context -> service.listSharesSegment(this.client.getUrl(),\n"
+                        + "            this.client.getServiceVersion().getVersion(), this.client.getFileRequestIntent(), accept,\n"
+                        + "            requestOptions, context))\n"
+                        + "        .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
+                        + "}"));
+                logger.info("Exposed raw listSharesSegmentWithResponse methods in ServicesImpl");
+            }));
     }
 
     /**
@@ -210,34 +215,36 @@ private static void exposeRawListSharesSegment(LibraryCustomization customizatio
      * @param logger The logger.
      */
     private static void exposeRawListHandles(LibraryCustomization customization, Logger logger) {
-        Editor editor = customization.getRawEditor();
-        String anchor = "    public PagedIterable listHandles(RequestOptions requestOptions) {";
-        String rawMethods = "    public Response listHandlesWithResponse(RequestOptions requestOptions) {\n"
-            + "        final String accept = \"application/xml\";\n"
-            + "        try {\n"
-            + "            return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
-            + "                this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,\n"
-            + "                Context.NONE);\n"
-            + "        } catch (ShareStorageExceptionInternal internalException) {\n"
-            + "            throw ModelHelper.mapToShareStorageException(internalException);\n"
-            + "        }\n"
-            + "    }\n\n"
-            + "    public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {\n"
-            + "        final String accept = \"application/xml\";\n"
-            + "        return FluxUtil\n"
-            + "            .withContext(context -> service.listHandles(this.client.getUrl(),\n"
-            + "                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),\n"
-            + "                this.client.getFileRequestIntent(), accept, requestOptions, context))\n"
-            + "            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
-            + "    }\n\n";
         for (String implName : Arrays.asList("DirectoriesImpl", "FilesImpl")) {
-            String path = PKG_ROOT + "implementation/" + implName + ".java";
-            String content = editor.getFileContent(path);
-            if (content.contains("listHandlesWithResponse(RequestOptions") || !content.contains(anchor)) {
-                continue;
-            }
-            editor.replaceFile(path, content.replace(anchor, rawMethods + anchor));
-            logger.info("Exposed raw listHandlesWithResponse methods in {}", path);
+            customization.getClass("com.azure.storage.file.share.implementation", implName)
+                .customizeAst(ast -> ast.getClassByName(implName).ifPresent(clazz -> {
+                    if (!clazz.getMethodsByName("listHandlesWithResponse").isEmpty()) {
+                        return;
+                    }
+                    ast.addImport("com.azure.storage.file.share.implementation.util.ModelHelper");
+                    ast.addImport("com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal");
+                    clazz.addMember(StaticJavaParser.parseMethodDeclaration(
+                        "public Response listHandlesWithResponse(RequestOptions requestOptions) {\n"
+                            + "    final String accept = \"application/xml\";\n"
+                            + "    try {\n"
+                            + "        return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
+                            + "            this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,\n"
+                            + "            Context.NONE);\n"
+                            + "    } catch (ShareStorageExceptionInternal internalException) {\n"
+                            + "        throw ModelHelper.mapToShareStorageException(internalException);\n"
+                            + "    }\n"
+                            + "}"));
+                    clazz.addMember(StaticJavaParser.parseMethodDeclaration(
+                        "public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {\n"
+                            + "    final String accept = \"application/xml\";\n"
+                            + "    return FluxUtil\n"
+                            + "        .withContext(context -> service.listHandles(this.client.getUrl(),\n"
+                            + "            this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),\n"
+                            + "            this.client.getFileRequestIntent(), accept, requestOptions, context))\n"
+                            + "        .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
+                            + "}"));
+                    logger.info("Exposed raw listHandlesWithResponse methods in {}", implName);
+                }));
         }
     }
 

From 0e6d82a9a94aad81e3e009f11a4505a56da8dfe2 Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Tue, 11 Aug 2026 12:26:03 -0700
Subject: [PATCH 12/13] simplifying customizations

---
 .../share/implementation/DirectoriesImpl.java | 50 +++++++++----------
 .../file/share/implementation/FilesImpl.java  | 50 +++++++++----------
 .../share/implementation/ServicesImpl.java    | 48 +++++++++---------
 .../share/implementation/XmlSerializer.java   |  6 +--
 .../main/java/ShareStorageCustomization.java  | 42 ++++++----------
 5 files changed, 91 insertions(+), 105 deletions(-)

diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
index 94c4a3da2bcc..1f85cdc92689 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
@@ -1155,31 +1155,6 @@ private PagedResponse listHandlesSinglePage(RequestOptions requestOp
      * @return an enumeration of handles as paginated response with {@link PagedIterable}.
      */
     @ServiceMethod(returns = ReturnType.COLLECTION)
-    public Response listHandlesWithResponse(RequestOptions requestOptions) {
-        try {
-            final String accept = "application/xml";
-            try {
-                return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
-                    this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
-                    Context.NONE);
-            } catch (ShareStorageExceptionInternal internalException) {
-                throw ModelHelper.mapToShareStorageException(internalException);
-            }
-        } catch (ShareStorageExceptionInternal internalException) {
-            throw ModelHelper.mapToShareStorageException(internalException);
-        }
-    }
-
-    public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {
-        final String accept = "application/xml";
-        return FluxUtil
-            .withContext(context -> service.listHandles(this.client.getUrl(),
-                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
-                this.client.getFileRequestIntent(), accept, requestOptions, context))
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
-    }
-
     public PagedIterable listHandles(RequestOptions requestOptions) {
         return new PagedIterable<>(() -> listHandlesSinglePage(requestOptions));
     }
@@ -1474,4 +1449,29 @@ private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int
             throw ModelHelper.mapToShareStorageException(internalException);
         }
     }
+
+    public Response listHandlesWithResponse(RequestOptions requestOptions) {
+        try {
+            final String accept = "application/xml";
+            try {
+                return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                    this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
+                    Context.NONE);
+            } catch (ShareStorageExceptionInternal internalException) {
+                throw ModelHelper.mapToShareStorageException(internalException);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {
+        final String accept = "application/xml";
+        return FluxUtil
+            .withContext(context -> service.listHandles(this.client.getUrl(),
+                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
+                this.client.getFileRequestIntent(), accept, requestOptions, context))
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
+    }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
index ccbf2af7c9b9..062b8b51db3b 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
@@ -2592,31 +2592,6 @@ private PagedResponse listHandlesSinglePage(RequestOptions requestOp
      * @return an enumeration of handles as paginated response with {@link PagedIterable}.
      */
     @ServiceMethod(returns = ReturnType.COLLECTION)
-    public Response listHandlesWithResponse(RequestOptions requestOptions) {
-        try {
-            final String accept = "application/xml";
-            try {
-                return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
-                    this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
-                    Context.NONE);
-            } catch (ShareStorageExceptionInternal internalException) {
-                throw ModelHelper.mapToShareStorageException(internalException);
-            }
-        } catch (ShareStorageExceptionInternal internalException) {
-            throw ModelHelper.mapToShareStorageException(internalException);
-        }
-    }
-
-    public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {
-        final String accept = "application/xml";
-        return FluxUtil
-            .withContext(context -> service.listHandles(this.client.getUrl(),
-                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
-                this.client.getFileRequestIntent(), accept, requestOptions, context))
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
-    }
-
     public PagedIterable listHandles(RequestOptions requestOptions) {
         return new PagedIterable<>(() -> listHandlesSinglePage(requestOptions));
     }
@@ -3114,4 +3089,29 @@ private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int
             throw ModelHelper.mapToShareStorageException(internalException);
         }
     }
+
+    public Response listHandlesWithResponse(RequestOptions requestOptions) {
+        try {
+            final String accept = "application/xml";
+            try {
+                return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                    this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
+                    Context.NONE);
+            } catch (ShareStorageExceptionInternal internalException) {
+                throw ModelHelper.mapToShareStorageException(internalException);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {
+        final String accept = "application/xml";
+        return FluxUtil
+            .withContext(context -> service.listHandles(this.client.getUrl(),
+                this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
+                this.client.getFileRequestIntent(), accept, requestOptions, context))
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
+    }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
index 7a81cae0d632..83eae38eddc5 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
@@ -785,30 +785,6 @@ private PagedResponse listSharesSegmentSinglePage(RequestOptions req
      * @return an enumeration of shares as paginated response with {@link PagedIterable}.
      */
     @ServiceMethod(returns = ReturnType.COLLECTION)
-    public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {
-        try {
-            final String accept = "application/xml";
-            try {
-                return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
-                    this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
-            } catch (ShareStorageExceptionInternal internalException) {
-                throw ModelHelper.mapToShareStorageException(internalException);
-            }
-        } catch (ShareStorageExceptionInternal internalException) {
-            throw ModelHelper.mapToShareStorageException(internalException);
-        }
-    }
-
-    public Mono> listSharesSegmentWithResponseAsync(RequestOptions requestOptions) {
-        final String accept = "application/xml";
-        return FluxUtil
-            .withContext(
-                context -> service.listSharesSegment(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
-                    this.client.getFileRequestIntent(), accept, requestOptions, context))
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
-    }
-
     public PagedIterable listSharesSegment(RequestOptions requestOptions) {
         return new PagedIterable<>(() -> listSharesSegmentSinglePage(requestOptions));
     }
@@ -1028,4 +1004,28 @@ private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int
             throw ModelHelper.mapToShareStorageException(internalException);
         }
     }
+
+    public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {
+        try {
+            final String accept = "application/xml";
+            try {
+                return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                    this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
+            } catch (ShareStorageExceptionInternal internalException) {
+                throw ModelHelper.mapToShareStorageException(internalException);
+            }
+        } catch (ShareStorageExceptionInternal internalException) {
+            throw ModelHelper.mapToShareStorageException(internalException);
+        }
+    }
+
+    public Mono> listSharesSegmentWithResponseAsync(RequestOptions requestOptions) {
+        final String accept = "application/xml";
+        return FluxUtil
+            .withContext(
+                context -> service.listSharesSegment(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                    this.client.getFileRequestIntent(), accept, requestOptions, context))
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
+            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
+    }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java
index bc61c55e3ef3..c2f52e003815 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/XmlSerializer.java
@@ -1,7 +1,6 @@
 // Copyright (c) Microsoft Corporation. All rights reserved.
 // Licensed under the MIT License.
 // Code generated by Microsoft (R) TypeSpec Code Generator.
-
 package com.azure.storage.file.share.implementation;
 
 import com.azure.core.util.serializer.ObjectSerializer;
@@ -20,7 +19,6 @@
 import reactor.core.publisher.Mono;
 
 // DO NOT modify this helper class
-
 /**
  * An {@link ObjectSerializer} implementation that serializes and deserializes {@link XmlSerializable} types using
  * {@code azure-xml}. Deserialization relies on the generated static {@code fromXml(XmlReader)} factory method on the
@@ -31,9 +29,9 @@ public final class XmlSerializer implements ObjectSerializer {
     private static final ConcurrentHashMap, Method> FROM_XML_CACHE = new ConcurrentHashMap<>();
 
     @Override
-    @SuppressWarnings("unchecked")
+    @SuppressWarnings({ "unchecked", "cast" })
     public  T deserialize(InputStream stream, TypeReference typeReference) {
-        Class clazz = typeReference.getJavaClass();
+        Class clazz = (Class) typeReference.getJavaClass();
         Method fromXml = FROM_XML_CACHE.computeIfAbsent(clazz, c -> {
             try {
                 return c.getDeclaredMethod("fromXml", XmlReader.class);
diff --git a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
index 693832f47ccc..aabc36d41185 100644
--- a/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
+++ b/sdk/storage/azure-storage-file-share/swagger/src/main/java/ShareStorageCustomization.java
@@ -180,26 +180,20 @@ private static void exposeRawListSharesSegment(LibraryCustomization customizatio
                 if (!clazz.getMethodsByName("listSharesSegmentWithResponse").isEmpty()) {
                     return;
                 }
-                ast.addImport("com.azure.storage.file.share.implementation.util.ModelHelper");
-                ast.addImport("com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal");
+                // Bodies are intentionally left without ShareStorageExceptionInternal mapping;
+                // updateImplToMapInternalException (run later) wraps every class-returning method exactly once.
                 clazz.addMember(StaticJavaParser.parseMethodDeclaration(
                     "public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {\n"
                         + "    final String accept = \"application/xml\";\n"
-                        + "    try {\n"
-                        + "        return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
-                        + "            this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);\n"
-                        + "    } catch (ShareStorageExceptionInternal internalException) {\n"
-                        + "        throw ModelHelper.mapToShareStorageException(internalException);\n"
-                        + "    }\n"
+                        + "    return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
+                        + "        this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);\n"
                         + "}"));
                 clazz.addMember(StaticJavaParser.parseMethodDeclaration(
                     "public Mono> listSharesSegmentWithResponseAsync(RequestOptions requestOptions) {\n"
                         + "    final String accept = \"application/xml\";\n"
-                        + "    return FluxUtil\n"
-                        + "        .withContext(context -> service.listSharesSegment(this.client.getUrl(),\n"
-                        + "            this.client.getServiceVersion().getVersion(), this.client.getFileRequestIntent(), accept,\n"
-                        + "            requestOptions, context))\n"
-                        + "        .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
+                        + "    return FluxUtil.withContext(context -> service.listSharesSegment(this.client.getUrl(),\n"
+                        + "        this.client.getServiceVersion().getVersion(), this.client.getFileRequestIntent(), accept,\n"
+                        + "        requestOptions, context));\n"
                         + "}"));
                 logger.info("Exposed raw listSharesSegmentWithResponse methods in ServicesImpl");
             }));
@@ -221,27 +215,21 @@ private static void exposeRawListHandles(LibraryCustomization customization, Log
                     if (!clazz.getMethodsByName("listHandlesWithResponse").isEmpty()) {
                         return;
                     }
-                    ast.addImport("com.azure.storage.file.share.implementation.util.ModelHelper");
-                    ast.addImport("com.azure.storage.file.share.implementation.models.ShareStorageExceptionInternal");
+                    // Bodies are intentionally left without ShareStorageExceptionInternal mapping;
+                    // updateImplToMapInternalException (run later) wraps every class-returning method exactly once.
                     clazz.addMember(StaticJavaParser.parseMethodDeclaration(
                         "public Response listHandlesWithResponse(RequestOptions requestOptions) {\n"
                             + "    final String accept = \"application/xml\";\n"
-                            + "    try {\n"
-                            + "        return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
-                            + "            this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,\n"
-                            + "            Context.NONE);\n"
-                            + "    } catch (ShareStorageExceptionInternal internalException) {\n"
-                            + "        throw ModelHelper.mapToShareStorageException(internalException);\n"
-                            + "    }\n"
+                            + "    return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),\n"
+                            + "        this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,\n"
+                            + "        Context.NONE);\n"
                             + "}"));
                     clazz.addMember(StaticJavaParser.parseMethodDeclaration(
                         "public Mono> listHandlesWithResponseAsync(RequestOptions requestOptions) {\n"
                             + "    final String accept = \"application/xml\";\n"
-                            + "    return FluxUtil\n"
-                            + "        .withContext(context -> service.listHandles(this.client.getUrl(),\n"
-                            + "            this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),\n"
-                            + "            this.client.getFileRequestIntent(), accept, requestOptions, context))\n"
-                            + "        .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);\n"
+                            + "    return FluxUtil.withContext(context -> service.listHandles(this.client.getUrl(),\n"
+                            + "        this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),\n"
+                            + "        this.client.getFileRequestIntent(), accept, requestOptions, context));\n"
                             + "}"));
                     logger.info("Exposed raw listHandlesWithResponse methods in {}", implName);
                 }));

From 9095898e8ed67fdec612312b17deb0e26e2ffce7 Mon Sep 17 00:00:00 2001
From: Isabelle 
Date: Tue, 11 Aug 2026 12:39:26 -0700
Subject: [PATCH 13/13] fixing test error and regen

---
 .../file/share/implementation/DirectoriesImpl.java    | 11 +++--------
 .../storage/file/share/implementation/FilesImpl.java  | 11 +++--------
 .../file/share/implementation/ServicesImpl.java       |  9 ++-------
 ...SeekableByteChannelShareFileReadBehaviorTests.java |  2 +-
 ...eekableByteChannelShareFileWriteBehaviorTests.java |  8 ++++----
 5 files changed, 13 insertions(+), 28 deletions(-)

diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
index 1f85cdc92689..f5d9f6707815 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/DirectoriesImpl.java
@@ -1453,13 +1453,9 @@ private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int
     public Response listHandlesWithResponse(RequestOptions requestOptions) {
         try {
             final String accept = "application/xml";
-            try {
-                return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
-                    this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
-                    Context.NONE);
-            } catch (ShareStorageExceptionInternal internalException) {
-                throw ModelHelper.mapToShareStorageException(internalException);
-            }
+            return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
+                Context.NONE);
         } catch (ShareStorageExceptionInternal internalException) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
@@ -1471,7 +1467,6 @@ public Mono> listHandlesWithResponseAsync(RequestOptions re
             .withContext(context -> service.listHandles(this.client.getUrl(),
                 this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
                 this.client.getFileRequestIntent(), accept, requestOptions, context))
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
             .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
     }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
index 062b8b51db3b..98e6e42204b0 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/FilesImpl.java
@@ -3093,13 +3093,9 @@ private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int
     public Response listHandlesWithResponse(RequestOptions requestOptions) {
         try {
             final String accept = "application/xml";
-            try {
-                return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
-                    this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
-                    Context.NONE);
-            } catch (ShareStorageExceptionInternal internalException) {
-                throw ModelHelper.mapToShareStorageException(internalException);
-            }
+            return service.listHandlesSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                this.client.isAllowTrailingDot(), this.client.getFileRequestIntent(), accept, requestOptions,
+                Context.NONE);
         } catch (ShareStorageExceptionInternal internalException) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
@@ -3111,7 +3107,6 @@ public Mono> listHandlesWithResponseAsync(RequestOptions re
             .withContext(context -> service.listHandles(this.client.getUrl(),
                 this.client.getServiceVersion().getVersion(), this.client.isAllowTrailingDot(),
                 this.client.getFileRequestIntent(), accept, requestOptions, context))
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
             .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
     }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
index 83eae38eddc5..a1ec20e360a8 100644
--- a/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
+++ b/sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/implementation/ServicesImpl.java
@@ -1008,12 +1008,8 @@ private String getXmlNextLink(com.azure.xml.XmlReader reader, String[] path, int
     public Response listSharesSegmentWithResponse(RequestOptions requestOptions) {
         try {
             final String accept = "application/xml";
-            try {
-                return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
-                    this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
-            } catch (ShareStorageExceptionInternal internalException) {
-                throw ModelHelper.mapToShareStorageException(internalException);
-            }
+            return service.listSharesSegmentSync(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
+                this.client.getFileRequestIntent(), accept, requestOptions, Context.NONE);
         } catch (ShareStorageExceptionInternal internalException) {
             throw ModelHelper.mapToShareStorageException(internalException);
         }
@@ -1025,7 +1021,6 @@ public Mono> listSharesSegmentWithResponseAsync(RequestOpti
             .withContext(
                 context -> service.listSharesSegment(this.client.getUrl(), this.client.getServiceVersion().getVersion(),
                     this.client.getFileRequestIntent(), accept, requestOptions, context))
-            .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException)
             .onErrorMap(ShareStorageExceptionInternal.class, ModelHelper::mapToShareStorageException);
     }
 }
diff --git a/sdk/storage/azure-storage-file-share/src/test/java/com/azure/storage/file/share/StorageSeekableByteChannelShareFileReadBehaviorTests.java b/sdk/storage/azure-storage-file-share/src/test/java/com/azure/storage/file/share/StorageSeekableByteChannelShareFileReadBehaviorTests.java
index d7438c0d4b94..43b91d1b949e 100644
--- a/sdk/storage/azure-storage-file-share/src/test/java/com/azure/storage/file/share/StorageSeekableByteChannelShareFileReadBehaviorTests.java
+++ b/sdk/storage/azure-storage-file-share/src/test/java/com/azure/storage/file/share/StorageSeekableByteChannelShareFileReadBehaviorTests.java
@@ -72,7 +72,7 @@ public void readCallsToClientCorrectly(int offset, ShareRequestConditions condit
         ByteBuffer buffer = ByteBuffer.allocate(Constants.KB);
         AtomicInteger downloadCallCount = new AtomicInteger(0);
         ShareFileClient client
-            = new ShareFileClient(null, new AzureFileStorageImpl(null, null, "fakeurl", false, false), "testshare",
+            = new ShareFileClient(null, new AzureFileStorageImpl(null, "fakeurl", null, false, false, null), "testshare",
                 "testpath", null, null, null, null) {
                 @Override
                 public ShareFileDownloadResponse downloadWithResponse(OutputStream stream,
diff --git a/sdk/storage/azure-storage-file-share/src/test/java/com/azure/storage/file/share/StorageSeekableByteChannelShareFileWriteBehaviorTests.java b/sdk/storage/azure-storage-file-share/src/test/java/com/azure/storage/file/share/StorageSeekableByteChannelShareFileWriteBehaviorTests.java
index c72817383bf2..7c3aa36b90de 100644
--- a/sdk/storage/azure-storage-file-share/src/test/java/com/azure/storage/file/share/StorageSeekableByteChannelShareFileWriteBehaviorTests.java
+++ b/sdk/storage/azure-storage-file-share/src/test/java/com/azure/storage/file/share/StorageSeekableByteChannelShareFileWriteBehaviorTests.java
@@ -46,7 +46,7 @@ public void writeBehaviorWriteCallsToClientCorrectly(int offset, ShareRequestCon
 
         AtomicInteger uploadRangeCallCount = new AtomicInteger(0);
         ShareFileClient client
-            = new ShareFileClient(null, new AzureFileStorageImpl(null, null, "fakeurl", false, false), "testshare",
+            = new ShareFileClient(null, new AzureFileStorageImpl(null, "fakeurl", null, false, false, null), "testshare",
                 "testpath", null, null, null, null) {
                 @Override
                 public Response uploadRangeWithResponse(ShareFileUploadRangeOptions options,
@@ -96,7 +96,7 @@ private static Stream writeBehaviorWriteCallsToClientCorrectlySupplie
     public void writeBehaviorCanSeekAnywhereInFileRange(long fileSize, int position) {
         AtomicInteger getPropertiesCallCount = new AtomicInteger(0);
         ShareFileClient client
-            = new ShareFileClient(null, new AzureFileStorageImpl(null, null, "fakeurl", false, false), "testshare",
+            = new ShareFileClient(null, new AzureFileStorageImpl(null, "fakeurl", null, false, false, null), "testshare",
                 "testpath", null, null, null, null) {
                 @Override
                 public ShareFileProperties getProperties() {
@@ -122,7 +122,7 @@ private static Stream writeBehaviorCanSeekAnywhereInFileRangeSupplier
     public void writeBehaviorThrowsWhenSeekingBeyondRange(long fileSize, int position) {
         AtomicInteger getPropertiesCallCount = new AtomicInteger(0);
         ShareFileClient client
-            = new ShareFileClient(null, new AzureFileStorageImpl(null, null, "fakeurl", false, false), "testshare",
+            = new ShareFileClient(null, new AzureFileStorageImpl(null, "fakeurl", null, false, false, null), "testshare",
                 "testpath", null, null, null, null) {
                 @Override
                 public ShareFileProperties getProperties() {
@@ -146,7 +146,7 @@ private static Stream writeBehaviorThrowsWhenSeekingBeyondRangeSuppli
     @Test
     public void writeBehaviorTruncateUnsupported() {
         ShareFileClient client
-            = new ShareFileClient(null, new AzureFileStorageImpl(null, null, "fakeurl", false, false), "testshare",
+            = new ShareFileClient(null, new AzureFileStorageImpl(null, "fakeurl", null, false, false, null), "testshare",
                 "testpath", null, null, null, null);
         StorageSeekableByteChannelShareFileWriteBehavior behavior
             = new StorageSeekableByteChannelShareFileWriteBehavior(client, null, null);