Update Javadoc of premium SDK for azure-resourcemanager-storage

sdk/resourcemanager/azure-resourcemanager-storage/pom.xml

@@ -49,7 +49,6 @@
       --add-opens com.azure.resourcemanager.msi/com.azure.resourcemanager.msi=ALL-UNNAMED
       --add-opens com.azure.core/com.azure.core.implementation.util=ALL-UNNAMED
     </javaModulesSurefireArgLine>
-    <doclintMissingInclusion>-</doclintMissingInclusion>
   </properties>
 
   <developers>

sdk/resourcemanager/azure-resourcemanager-storage/src/main/java/com/azure/resourcemanager/storage/StorageManager.java

@@ -39,7 +39,11 @@ public final class StorageManager extends Manager<StorageManagementClient> {
     private ManagementPolicies managementPolicies;
     private final AuthorizationManager authorizationManager;
 
-    /** @return the authorization manager */
+    /**
+     * Gets the authorization manager.
+     *
+     * @return the authorization manager
+     */
     public AuthorizationManager authorizationManager() {
         return authorizationManager;
     }
@@ -107,47 +111,71 @@ private StorageManager(HttpPipeline httpPipeline, AzureProfile profile) {
         authorizationManager = AuthorizationManager.authenticate(httpPipeline, profile);
     }
 
-    /** @return the storage account management API entry point */
+    /**
+     * Gets the API entry point of the storage account.
+     *
+     * @return the storage account management API entry point
+     */
     public StorageAccounts storageAccounts() {
         if (storageAccounts == null) {
             storageAccounts = new StorageAccountsImpl(this, this.authorizationManager);
         }
         return storageAccounts;
     }
 
-    /** @return the storage service usage management API entry point */
+    /**
+     * Gets the API entry point of the storage service usage.
+     *
+     * @return the storage service usage management API entry point
+     */
     public Usages usages() {
         if (storageUsages == null) {
             storageUsages = new UsagesImpl(this);
         }
         return storageUsages;
     }
 
-    /** @return the storage service SKU management API entry point */
+    /**
+     * Gets the API entry point of the storage service SKU.
+     *
+     * @return the storage service SKU management API entry point
+     */
     public StorageSkus storageSkus() {
         if (storageSkus == null) {
             storageSkus = new StorageSkusImpl(this);
         }
         return storageSkus;
     }
 
-    /** @return the blob container management API entry point */
+    /**
+     * Gets the API entry point of the blob container.
+     *
+     * @return the blob container management API entry point
+     */
     public BlobContainers blobContainers() {
         if (blobContainers == null) {
             blobContainers = new BlobContainersImpl(this);
         }
         return blobContainers;
     }
 
-    /** @return the blob service management API entry point */
+    /**
+     * Gets the API entry point of the blob service.
+     *
+     * @return the blob service management API entry point
+     */
     public BlobServices blobServices() {
         if (blobServices == null) {
             blobServices = new BlobServicesImpl(this);
         }
         return blobServices;
     }
 
-    /** @return the management policy management API entry point */
+    /**
+     * Gets the API entry point of the management policy.
+     *
+     * @return the management policy API entry point
+     */
     public ManagementPolicies managementPolicies() {
         if (managementPolicies == null) {
             managementPolicies = new ManagementPoliciesImpl(this);

sdk/resourcemanager/azure-resourcemanager-storage/src/main/java/com/azure/resourcemanager/storage/models/AccountStatuses.java

@@ -20,13 +20,17 @@ public AccountStatuses(AccountStatus primary, AccountStatus secondary) {
     }
 
     /**
+     * Gets the status indicating whether the primary location of the storage account is available or unavailable.
+     *
      * @return the status indicating whether the primary location of the storage account is available or unavailable.
      */
     public AccountStatus primary() {
         return primary;
     }
 
     /**
+     * Gets the status indicating whether the secondary location of the storage account is available or unavailable.
+     *
      * @return the status indicating whether the secondary location of the storage account is available or unavailable.
      *     Only available if the accountType is StandardGRS or StandardRAGRS.
      */

sdk/resourcemanager/azure-resourcemanager-storage/src/main/java/com/azure/resourcemanager/storage/models/BlobContainer.java

@@ -19,46 +19,102 @@
 @Fluent
 public interface BlobContainer
     extends HasInnerModel<BlobContainerInner>, Indexable, Updatable<BlobContainer.Update>, HasManager<StorageManager> {
-    /** @return the etag value. */
+    /**
+     * Gets the etag value.
+     *
+     * @return the etag value.
+     */
     String etag();
 
-    /** @return the hasImmutabilityPolicy value. */
+    /**
+     * Checks whether the container has immutability policy.
+     *
+     * @return the hasImmutabilityPolicy value.
+     */
     Boolean hasImmutabilityPolicy();
 
-    /** @return the hasLegalHold value. */
+    /**
+     * Checks whether the container has legal hold.
+     *
+     * @return the hasLegalHold value.
+     */
     Boolean hasLegalHold();
 
-    /** @return the id value. */
+    /**
+     * Gets container resource ID.
+     *
+     * @return the id value.
+     */
     String id();
 
-    /** @return the immutabilityPolicy value. */
+    /**
+     * Gets the properties of the immutability policy.
+     *
+     * @return the immutabilityPolicy value.
+     */
     ImmutabilityPolicyProperties immutabilityPolicy();
 
-    /** @return the lastModifiedTime value. */
+    /**
+     * Gets the last modified time.
+     *
+     * @return the lastModifiedTime value.
+     */
     OffsetDateTime lastModifiedTime();
 
-    /** @return the leaseDuration value. */
+    /**
+     * Gets the lease duration.
+     *
+     * @return the leaseDuration value.
+     */
     LeaseDuration leaseDuration();
 
-    /** @return the leaseState value. */
+    /**
+     * Gets the lease state.
+     *
+     * @return the leaseState value.
+     */
     LeaseState leaseState();
 
-    /** @return the leaseStatus value. */
+    /**
+     * gets the lease status.
+     *
+     * @return the leaseStatus value.
+     */
     LeaseStatus leaseStatus();
 
-    /** @return the legalHold value. */
+    /**
+     * Gets the legal hold.
+     *
+     * @return the legalHold value.
+     */
     LegalHoldProperties legalHold();
 
-    /** @return the metadata value. */
+    /**
+     * Gets the metadata.
+     *
+     * @return the metadata value.
+     */
     Map<String, String> metadata();
 
-    /** @return the name value. */
+    /**
+     * Gets the name of the blob container.
+     *
+     * @return the name value.
+     */
     String name();
 
-    /** @return the publicAccess value. */
+    /**
+     * Gets the public access.
+     *
+     * @return the publicAccess value.
+     */
     PublicAccess publicAccess();
 
-    /** @return the type value. */
+    /**
+     * Gets the type of the blob container.
+     *
+     * @return the type value.
+     */
     String type();
 
     /** The entirety of the BlobContainer definition. */

sdk/resourcemanager/azure-resourcemanager-storage/src/main/java/com/azure/resourcemanager/storage/models/BlobServiceProperties.java

@@ -19,34 +19,74 @@
 @Fluent
 public interface BlobServiceProperties extends HasInnerModel<BlobServicePropertiesInner>, Indexable,
     Refreshable<BlobServiceProperties>, Updatable<BlobServiceProperties.Update>, HasManager<StorageManager> {
-    /** @return the cors value. */
+    /**
+     * Gets cors rules.
+     *
+     * @return the cors value.
+     */
     CorsRules cors();
 
-    /** @return the defaultServiceVersion value. */
+    /**
+     * Gets the default service version.
+     *
+     * @return the defaultServiceVersion value.
+     */
     String defaultServiceVersion();
 
-    /** @return blob soft delete policy used to restore a blob, snapshot, or version that has been deleted. */
+    /**
+     * Gets blob soft delete policy.
+     *
+     * @return blob soft delete policy used to restore a blob, snapshot, or version that has been deleted.
+     */
     DeleteRetentionPolicy deleteRetentionPolicy();
 
-    /** @return container soft delete policy used to restore a container that has been deleted. */
+    /**
+     * Gets container soft delete policy.
+     *
+     * @return container soft delete policy used to restore a container that has been deleted.
+     */
     DeleteRetentionPolicy containerDeleteRetentionPolicy();
 
-    /** @return the id value. */
+    /**
+     * Gets the resource ID.
+     *
+     * @return the id value.
+     */
     String id();
 
-    /** @return the name value. */
+    /**
+     * Gets the name.
+     *
+     * @return the name value.
+     */
     String name();
 
-    /** @return the type value. */
+    /**
+     * Gets the type.
+     *
+     * @return the type value.
+     */
     String type();
 
-    /** @return whether blob versioning is enabled */
+    /**
+     * Checks whether blob versioning is enabled.
+     *
+     * @return whether blob versioning is enabled
+     */
     Boolean isBlobVersioningEnabled();
 
-    /** @return whether last access time tracking policy is enabled */
+    /**
+     * Checks whether last access time tracking policy is enabled.
+     *
+     * @return whether last access time tracking policy is enabled
+     */
     boolean isLastAccessTimeTrackingPolicyEnabled();
 
-    /** @return the last access time tracking policy */
+    /**
+     * Gets the last access time tracking policy.
+     *
+     * @return the last access time tracking policy
+     */
     LastAccessTimeTrackingPolicy lastAccessTimeTrackingPolicy();
 
     /** The entirety of the BlobServiceProperties definition. */

sdk/resourcemanager/azure-resourcemanager-storage/src/main/java/com/azure/resourcemanager/storage/models/BlobTypes.java

@@ -14,6 +14,15 @@ public final class BlobTypes extends ExpandableStringEnum<BlobTypes> {
     /** Static value snapshot for BlobTypes. */
     public static final BlobTypes SNAPSHOT = fromString("snapshot");
 
+    /**
+     * Creates a new instance of BlobTypes value.
+     *
+     * @deprecated Use the {@link #fromString(String)} factory method.
+     */
+    @Deprecated
+    public BlobTypes() {
+    }
+
     /**
      * Creates or finds a BlobType from its string representation.
      *
@@ -24,7 +33,11 @@ public static BlobTypes fromString(String name) {
         return fromString(name, BlobTypes.class);
     }
 
-    /** @return known BlobType values */
+    /**
+     * Gets known BlobType values.
+     *
+     * @return known BlobType values
+     */
     public static Collection<BlobTypes> values() {
         return values(BlobTypes.class);
     }

sdk/resourcemanager/azure-resourcemanager-storage/src/main/java/com/azure/resourcemanager/storage/models/CheckNameAvailabilityResult.java

@@ -19,6 +19,8 @@ public CheckNameAvailabilityResult(CheckNameAvailabilityResultInner inner) {
     }
 
     /**
+     * Checks whether the name is available for you to use.
+     *
      * @return a boolean value that indicates whether the name is available for you to use. If true, the name is
      *     available. If false, the name has already been taken or invalid and cannot be used.
      */
@@ -27,14 +29,20 @@ public boolean isAvailable() {
     }
 
     /**
+     * Gets the reason that a storage account name could not be used.
+     *
      * @return the reason that a storage account name could not be used. The Reason element is only returned if
      *     NameAvailable is false. Possible values include: 'AccountNameInvalid', 'AlreadyExists'.
      */
     public Reason reason() {
         return inner.reason();
     }
 
-    /** @return an error message explaining the Reason value in more detail */
+    /**
+     * Gets an error message explaining the Reason value in more detail.
+     *
+     * @return an error message explaining the Reason value in more detail
+     */
     public String message() {
         return inner.message();
     }