mgmt, update resources policy to 2023-04-01 (Azure#44686)

Author: weidongxu-microsoft

sdk/resourcemanager/api-specs.json

@@ -194,7 +194,7 @@
     "dir": "azure-resourcemanager-resources",
     "source": "specification/resources/resource-manager/readme.md",
     "package": "com.azure.resourcemanager.resources",
-    "args": "--tag=package-policy-2022-06-java --graalvm-config-suffix=policy --rename-model=UserAssignedIdentitiesValue:IdentityUserAssignedIdentitiesValue",
+    "args": "--tag=package-policy-2023-04-java --graalvm-config-suffix=policy --rename-model=UserAssignedIdentitiesValue:IdentityUserAssignedIdentitiesValue",
     "note": "Remove policyVariables.json and policyVariableValues.json from tag, as they are still in preview."
   },
   "policy-hybrid": {

sdk/resourcemanager/azure-resourcemanager-resources/CHANGELOG.md

@@ -6,10 +6,14 @@
 
 ### Breaking Changes
 
+- `managementGroupId` is moved to the 1st parameter in APIs in `PolicyDefinitionsClient`.
+
 ### Bugs Fixed
 
 ### Other Changes
 
+- Updated `api-version` of policy to `2023-04-01`.
+
 ## 2.48.0 (2025-02-28)
 
 ### Other Changes

sdk/resourcemanager/azure-resourcemanager-resources/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "java",
   "TagPrefix": "java/resourcemanager/azure-resourcemanager-resources",
-  "Tag": "java/resourcemanager/azure-resourcemanager-resources_f8b2a080f4"
+  "Tag": "java/resourcemanager/azure-resourcemanager-resources_953c74acc9"
 }

sdk/resourcemanager/azure-resourcemanager-resources/src/main/java/com/azure/resourcemanager/resources/fluent/PolicyAssignmentsClient.java

@@ -12,7 +12,7 @@
  */
 public interface PolicyClient {
     /**
-     * Gets The ID of the target subscription.
+     * Gets The ID of the target subscription. The value must be an UUID.
      * 
      * @return the subscriptionId value.
      */
@@ -53,13 +53,27 @@ public interface PolicyClient {
      */
     PolicyDefinitionsClient getPolicyDefinitions();
 
+    /**
+     * Gets the PolicyDefinitionVersionsClient object to access its operations.
+     * 
+     * @return the PolicyDefinitionVersionsClient object.
+     */
+    PolicyDefinitionVersionsClient getPolicyDefinitionVersions();
+
     /**
      * Gets the PolicySetDefinitionsClient object to access its operations.
      * 
      * @return the PolicySetDefinitionsClient object.
      */
     PolicySetDefinitionsClient getPolicySetDefinitions();
 
+    /**
+     * Gets the PolicySetDefinitionVersionsClient object to access its operations.
+     * 
+     * @return the PolicySetDefinitionVersionsClient object.
+     */
+    PolicySetDefinitionVersionsClient getPolicySetDefinitionVersions();
+
     /**
      * Gets the PolicyAssignmentsClient object to access its operations.
      * 

sdk/resourcemanager/azure-resourcemanager-resources/src/main/java/com/azure/resourcemanager/resources/fluent/PolicyClient.java

@@ -255,42 +255,42 @@ Response<PolicyDefinitionInner> createOrUpdateWithResponse(String policyDefiniti
      * 
      * This operation creates or updates a policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to create.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to create.
      * @param parameters The policy definition properties.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
      * @return the policy definition along with {@link Response} on successful completion of {@link Mono}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Mono<Response<PolicyDefinitionInner>> createOrUpdateAtManagementGroupWithResponseAsync(String policyDefinitionName,
-        String managementGroupId, PolicyDefinitionInner parameters);
+    Mono<Response<PolicyDefinitionInner>> createOrUpdateAtManagementGroupWithResponseAsync(String managementGroupId,
+        String policyDefinitionName, PolicyDefinitionInner parameters);
 
     /**
      * Creates or updates a policy definition in a management group.
      * 
      * This operation creates or updates a policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to create.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to create.
      * @param parameters The policy definition properties.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
      * @return the policy definition on successful completion of {@link Mono}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Mono<PolicyDefinitionInner> createOrUpdateAtManagementGroupAsync(String policyDefinitionName,
-        String managementGroupId, PolicyDefinitionInner parameters);
+    Mono<PolicyDefinitionInner> createOrUpdateAtManagementGroupAsync(String managementGroupId,
+        String policyDefinitionName, PolicyDefinitionInner parameters);
 
     /**
      * Creates or updates a policy definition in a management group.
      * 
      * This operation creates or updates a policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to create.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to create.
      * @param parameters The policy definition properties.
      * @param context The context to associate with this operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
@@ -299,150 +299,150 @@ Mono<PolicyDefinitionInner> createOrUpdateAtManagementGroupAsync(String policyDe
      * @return the policy definition along with {@link Response}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Response<PolicyDefinitionInner> createOrUpdateAtManagementGroupWithResponse(String policyDefinitionName,
-        String managementGroupId, PolicyDefinitionInner parameters, Context context);
+    Response<PolicyDefinitionInner> createOrUpdateAtManagementGroupWithResponse(String managementGroupId,
+        String policyDefinitionName, PolicyDefinitionInner parameters, Context context);
 
     /**
      * Creates or updates a policy definition in a management group.
      * 
      * This operation creates or updates a policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to create.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to create.
      * @param parameters The policy definition properties.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
      * @return the policy definition.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    PolicyDefinitionInner createOrUpdateAtManagementGroup(String policyDefinitionName, String managementGroupId,
+    PolicyDefinitionInner createOrUpdateAtManagementGroup(String managementGroupId, String policyDefinitionName,
         PolicyDefinitionInner parameters);
 
     /**
      * Deletes a policy definition in a management group.
      * 
      * This operation deletes the policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to delete.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to delete.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException 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)
-    Mono<Response<Void>> deleteAtManagementGroupWithResponseAsync(String policyDefinitionName,
-        String managementGroupId);
+    Mono<Response<Void>> deleteAtManagementGroupWithResponseAsync(String managementGroupId,
+        String policyDefinitionName);
 
     /**
      * Deletes a policy definition in a management group.
      * 
      * This operation deletes the policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to delete.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to delete.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException 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)
-    Mono<Void> deleteAtManagementGroupAsync(String policyDefinitionName, String managementGroupId);
+    Mono<Void> deleteAtManagementGroupAsync(String managementGroupId, String policyDefinitionName);
 
     /**
      * Deletes a policy definition in a management group.
      * 
      * This operation deletes the policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to delete.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to delete.
      * @param context The context to associate with this operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException 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)
-    Response<Void> deleteAtManagementGroupWithResponse(String policyDefinitionName, String managementGroupId,
+    Response<Void> deleteAtManagementGroupWithResponse(String managementGroupId, String policyDefinitionName,
         Context context);
 
     /**
      * Deletes a policy definition in a management group.
      * 
      * This operation deletes the policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to delete.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to delete.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException 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)
-    void deleteAtManagementGroup(String policyDefinitionName, String managementGroupId);
+    void deleteAtManagementGroup(String managementGroupId, String policyDefinitionName);
 
     /**
      * Retrieve a policy definition in a management group.
      * 
      * This operation retrieves the policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to get.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to get.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
      * @return the policy definition along with {@link Response} on successful completion of {@link Mono}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Mono<Response<PolicyDefinitionInner>> getAtManagementGroupWithResponseAsync(String policyDefinitionName,
-        String managementGroupId);
+    Mono<Response<PolicyDefinitionInner>> getAtManagementGroupWithResponseAsync(String managementGroupId,
+        String policyDefinitionName);
 
     /**
      * Retrieve a policy definition in a management group.
      * 
      * This operation retrieves the policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to get.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to get.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
      * @return the policy definition on successful completion of {@link Mono}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Mono<PolicyDefinitionInner> getAtManagementGroupAsync(String policyDefinitionName, String managementGroupId);
+    Mono<PolicyDefinitionInner> getAtManagementGroupAsync(String managementGroupId, String policyDefinitionName);
 
     /**
      * Retrieve a policy definition in a management group.
      * 
      * This operation retrieves the policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to get.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to get.
      * @param context The context to associate with this operation.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
      * @return the policy definition along with {@link Response}.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    Response<PolicyDefinitionInner> getAtManagementGroupWithResponse(String policyDefinitionName,
-        String managementGroupId, Context context);
+    Response<PolicyDefinitionInner> getAtManagementGroupWithResponse(String managementGroupId,
+        String policyDefinitionName, Context context);
 
     /**
      * Retrieve a policy definition in a management group.
      * 
      * This operation retrieves the policy definition in the given management group with the given name.
      * 
-     * @param policyDefinitionName The name of the policy definition to get.
      * @param managementGroupId The ID of the management group.
+     * @param policyDefinitionName The name of the policy definition to get.
      * @throws IllegalArgumentException thrown if parameters fail the validation.
      * @throws com.azure.core.management.exception.ManagementException thrown if the request is rejected by server.
      * @throws RuntimeException all other wrapped checked exceptions if the request fails to be sent.
      * @return the policy definition.
      */
     @ServiceMethod(returns = ReturnType.SINGLE)
-    PolicyDefinitionInner getAtManagementGroup(String policyDefinitionName, String managementGroupId);
+    PolicyDefinitionInner getAtManagementGroup(String managementGroupId, String policyDefinitionName);
 
     /**
      * Retrieves policy definitions in a subscription