azure_mgmt_api_management 0.18.4 → 0.19.0

data/lib/{2018-01-01-preview/generated/azure_mgmt_api_management/tag_description.rb → 2019-12-01/generated/azure_mgmt_api_management/api_tag_description.rb}

@@ -3,15 +3,15 @@
 # Changes may cause incorrect behavior and will be lost if the code is
 # regenerated.
 
-module Azure::ApiManagement::Mgmt::V2018_01_01_preview
+module Azure::ApiManagement::Mgmt::V2019_12_01
   #
   # ApiManagement Client
   #
-  class TagDescription
+  class ApiTagDescription
     include MsRestAzure
 
     #
-    # Creates and initializes a new instance of the TagDescription class.
+    # Creates and initializes a new instance of the ApiTagDescription class.
     # @param client service class for accessing basic functionality.
     #
     def initialize(client)
@@ -31,13 +31,12 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param filter [String] | Field       | Supported operators    | Supported
-    # functions                         |
-    # |-------------|------------------------|---------------------------------------------|
-    # | id          | ge, le, eq, ne, gt, lt | substringof, contains, startswith,
-    # endswith |
-    # | name        | ge, le, eq, ne, gt, lt | substringof, contains, startswith,
-    # endswith |
+    # @param filter [String] |   Field     |     Usage     |     Supported
+    # operators     |     Supported functions
+    # |</br>|-------------|-------------|-------------|-------------|</br>|
+    # displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains,
+    # startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt |
+    # substringof, contains, startswith, endswith | </br>
     # @param top [Integer] Number of records to return.
     # @param skip [Integer] Number of records to skip.
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
@@ -45,8 +44,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [Array<TagDescriptionContract>] operation results.
     #
-    def list_by_api(resource_group_name, service_name, api_id, filter:nil, top:nil, skip:nil, custom_headers:nil)
-      first_page = list_by_api_as_lazy(resource_group_name, service_name, api_id, filter:filter, top:top, skip:skip, custom_headers:custom_headers)
+    def list_by_service(resource_group_name, service_name, api_id, filter:nil, top:nil, skip:nil, custom_headers:nil)
+      first_page = list_by_service_as_lazy(resource_group_name, service_name, api_id, filter:filter, top:top, skip:skip, custom_headers:custom_headers)
       first_page.get_all_items
     end
 
@@ -60,13 +59,12 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param filter [String] | Field       | Supported operators    | Supported
-    # functions                         |
-    # |-------------|------------------------|---------------------------------------------|
-    # | id          | ge, le, eq, ne, gt, lt | substringof, contains, startswith,
-    # endswith |
-    # | name        | ge, le, eq, ne, gt, lt | substringof, contains, startswith,
-    # endswith |
+    # @param filter [String] |   Field     |     Usage     |     Supported
+    # operators     |     Supported functions
+    # |</br>|-------------|-------------|-------------|-------------|</br>|
+    # displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains,
+    # startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt |
+    # substringof, contains, startswith, endswith | </br>
     # @param top [Integer] Number of records to return.
     # @param skip [Integer] Number of records to skip.
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
@@ -74,8 +72,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def list_by_api_with_http_info(resource_group_name, service_name, api_id, filter:nil, top:nil, skip:nil, custom_headers:nil)
-      list_by_api_async(resource_group_name, service_name, api_id, filter:filter, top:top, skip:skip, custom_headers:custom_headers).value!
+    def list_by_service_with_http_info(resource_group_name, service_name, api_id, filter:nil, top:nil, skip:nil, custom_headers:nil)
+      list_by_service_async(resource_group_name, service_name, api_id, filter:filter, top:top, skip:skip, custom_headers:custom_headers).value!
     end
 
     #
@@ -88,13 +86,12 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param filter [String] | Field       | Supported operators    | Supported
-    # functions                         |
-    # |-------------|------------------------|---------------------------------------------|
-    # | id          | ge, le, eq, ne, gt, lt | substringof, contains, startswith,
-    # endswith |
-    # | name        | ge, le, eq, ne, gt, lt | substringof, contains, startswith,
-    # endswith |
+    # @param filter [String] |   Field     |     Usage     |     Supported
+    # operators     |     Supported functions
+    # |</br>|-------------|-------------|-------------|-------------|</br>|
+    # displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains,
+    # startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt |
+    # substringof, contains, startswith, endswith | </br>
     # @param top [Integer] Number of records to return.
     # @param skip [Integer] Number of records to skip.
     # @param [Hash{String => String}] A hash of custom headers that will be added
@@ -102,7 +99,7 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def list_by_api_async(resource_group_name, service_name, api_id, filter:nil, top:nil, skip:nil, custom_headers:nil)
+    def list_by_service_async(resource_group_name, service_name, api_id, filter:nil, top:nil, skip:nil, custom_headers:nil)
       fail ArgumentError, 'resource_group_name is nil' if resource_group_name.nil?
       fail ArgumentError, 'service_name is nil' if service_name.nil?
       fail ArgumentError, "'service_name' should satisfy the constraint - 'MaxLength': '50'" if !service_name.nil? && service_name.length > 50
@@ -147,11 +144,13 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
             parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
-            result_mapper = Azure::ApiManagement::Mgmt::V2018_01_01_preview::Models::TagDescriptionCollection.mapper()
+            result_mapper = Azure::ApiManagement::Mgmt::V2019_12_01::Models::TagDescriptionCollection.mapper()
             result.body = @client.deserialize(result_mapper, parsed_response)
           rescue Exception => e
             fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
@@ -172,14 +171,14 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     #
-    def get_entity_state(resource_group_name, service_name, api_id, tag_id, custom_headers:nil)
-      response = get_entity_state_async(resource_group_name, service_name, api_id, tag_id, custom_headers:custom_headers).value!
+    def get_entity_tag(resource_group_name, service_name, api_id, tag_description_id, custom_headers:nil)
+      response = get_entity_tag_async(resource_group_name, service_name, api_id, tag_description_id, custom_headers:custom_headers).value!
       nil
     end
 
@@ -191,15 +190,15 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def get_entity_state_with_http_info(resource_group_name, service_name, api_id, tag_id, custom_headers:nil)
-      get_entity_state_async(resource_group_name, service_name, api_id, tag_id, custom_headers:custom_headers).value!
+    def get_entity_tag_with_http_info(resource_group_name, service_name, api_id, tag_description_id, custom_headers:nil)
+      get_entity_tag_async(resource_group_name, service_name, api_id, tag_description_id, custom_headers:custom_headers).value!
     end
 
     #
@@ -210,14 +209,14 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param [Hash{String => String}] A hash of custom headers that will be added
     # to the HTTP request.
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def get_entity_state_async(resource_group_name, service_name, api_id, tag_id, custom_headers:nil)
+    def get_entity_tag_async(resource_group_name, service_name, api_id, tag_description_id, custom_headers:nil)
       fail ArgumentError, 'resource_group_name is nil' if resource_group_name.nil?
       fail ArgumentError, 'service_name is nil' if service_name.nil?
       fail ArgumentError, "'service_name' should satisfy the constraint - 'MaxLength': '50'" if !service_name.nil? && service_name.length > 50
@@ -227,10 +226,10 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
       fail ArgumentError, "'api_id' should satisfy the constraint - 'MaxLength': '256'" if !api_id.nil? && api_id.length > 256
       fail ArgumentError, "'api_id' should satisfy the constraint - 'MinLength': '1'" if !api_id.nil? && api_id.length < 1
       fail ArgumentError, "'api_id' should satisfy the constraint - 'Pattern': '^[^*#&+:<>?]+$'" if !api_id.nil? && api_id.match(Regexp.new('^^[^*#&+:<>?]+$$')).nil?
-      fail ArgumentError, 'tag_id is nil' if tag_id.nil?
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'MaxLength': '80'" if !tag_id.nil? && tag_id.length > 80
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'MinLength': '1'" if !tag_id.nil? && tag_id.length < 1
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'Pattern': '(^[\w]+$)|(^[\w][\w\-]+[\w]$)'" if !tag_id.nil? && tag_id.match(Regexp.new('^(^[\w]+$)|(^[\w][\w\-]+[\w]$)$')).nil?
+      fail ArgumentError, 'tag_description_id is nil' if tag_description_id.nil?
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'MaxLength': '80'" if !tag_description_id.nil? && tag_description_id.length > 80
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'MinLength': '1'" if !tag_description_id.nil? && tag_description_id.length < 1
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'Pattern': '^[^*#&+:<>?]+$'" if !tag_description_id.nil? && tag_description_id.match(Regexp.new('^^[^*#&+:<>?]+$$')).nil?
       fail ArgumentError, '@client.api_version is nil' if @client.api_version.nil?
       fail ArgumentError, '@client.subscription_id is nil' if @client.subscription_id.nil?
 
@@ -241,13 +240,13 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
       # Set Headers
       request_headers['x-ms-client-request-id'] = SecureRandom.uuid
       request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
-      path_template = 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}'
+      path_template = 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagDescriptionId}'
 
       request_url = @base_url || @client.base_url
 
       options = {
           middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
-          path_params: {'resourceGroupName' => resource_group_name,'serviceName' => service_name,'apiId' => api_id,'tagId' => tag_id,'subscriptionId' => @client.subscription_id},
+          path_params: {'resourceGroupName' => resource_group_name,'serviceName' => service_name,'apiId' => api_id,'tagDescriptionId' => tag_description_id,'subscriptionId' => @client.subscription_id},
           query_params: {'api-version' => @client.api_version},
           headers: request_headers.merge(custom_headers || {}),
           base_url: request_url
@@ -264,6 +263,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -272,60 +273,60 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     end
 
     #
-    # Get tag associated with the API.
+    # Get Tag description in scope of API
     #
     # @param resource_group_name [String] The name of the resource group.
     # @param service_name [String] The name of the API Management service.
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [TagDescriptionContract] operation results.
     #
-    def get(resource_group_name, service_name, api_id, tag_id, custom_headers:nil)
-      response = get_async(resource_group_name, service_name, api_id, tag_id, custom_headers:custom_headers).value!
+    def get(resource_group_name, service_name, api_id, tag_description_id, custom_headers:nil)
+      response = get_async(resource_group_name, service_name, api_id, tag_description_id, custom_headers:custom_headers).value!
       response.body unless response.nil?
     end
 
     #
-    # Get tag associated with the API.
+    # Get Tag description in scope of API
     #
     # @param resource_group_name [String] The name of the resource group.
     # @param service_name [String] The name of the API Management service.
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
     # will be added to the HTTP request.
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def get_with_http_info(resource_group_name, service_name, api_id, tag_id, custom_headers:nil)
-      get_async(resource_group_name, service_name, api_id, tag_id, custom_headers:custom_headers).value!
+    def get_with_http_info(resource_group_name, service_name, api_id, tag_description_id, custom_headers:nil)
+      get_async(resource_group_name, service_name, api_id, tag_description_id, custom_headers:custom_headers).value!
     end
 
     #
-    # Get tag associated with the API.
+    # Get Tag description in scope of API
     #
     # @param resource_group_name [String] The name of the resource group.
     # @param service_name [String] The name of the API Management service.
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param [Hash{String => String}] A hash of custom headers that will be added
     # to the HTTP request.
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def get_async(resource_group_name, service_name, api_id, tag_id, custom_headers:nil)
+    def get_async(resource_group_name, service_name, api_id, tag_description_id, custom_headers:nil)
       fail ArgumentError, 'resource_group_name is nil' if resource_group_name.nil?
       fail ArgumentError, 'service_name is nil' if service_name.nil?
       fail ArgumentError, "'service_name' should satisfy the constraint - 'MaxLength': '50'" if !service_name.nil? && service_name.length > 50
@@ -335,10 +336,10 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
       fail ArgumentError, "'api_id' should satisfy the constraint - 'MaxLength': '256'" if !api_id.nil? && api_id.length > 256
       fail ArgumentError, "'api_id' should satisfy the constraint - 'MinLength': '1'" if !api_id.nil? && api_id.length < 1
       fail ArgumentError, "'api_id' should satisfy the constraint - 'Pattern': '^[^*#&+:<>?]+$'" if !api_id.nil? && api_id.match(Regexp.new('^^[^*#&+:<>?]+$$')).nil?
-      fail ArgumentError, 'tag_id is nil' if tag_id.nil?
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'MaxLength': '80'" if !tag_id.nil? && tag_id.length > 80
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'MinLength': '1'" if !tag_id.nil? && tag_id.length < 1
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'Pattern': '(^[\w]+$)|(^[\w][\w\-]+[\w]$)'" if !tag_id.nil? && tag_id.match(Regexp.new('^(^[\w]+$)|(^[\w][\w\-]+[\w]$)$')).nil?
+      fail ArgumentError, 'tag_description_id is nil' if tag_description_id.nil?
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'MaxLength': '80'" if !tag_description_id.nil? && tag_description_id.length > 80
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'MinLength': '1'" if !tag_description_id.nil? && tag_description_id.length < 1
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'Pattern': '^[^*#&+:<>?]+$'" if !tag_description_id.nil? && tag_description_id.match(Regexp.new('^^[^*#&+:<>?]+$$')).nil?
       fail ArgumentError, '@client.api_version is nil' if @client.api_version.nil?
       fail ArgumentError, '@client.subscription_id is nil' if @client.subscription_id.nil?
 
@@ -349,13 +350,13 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
       # Set Headers
       request_headers['x-ms-client-request-id'] = SecureRandom.uuid
       request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
-      path_template = 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}'
+      path_template = 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagDescriptionId}'
 
       request_url = @base_url || @client.base_url
 
       options = {
           middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
-          path_params: {'resourceGroupName' => resource_group_name,'serviceName' => service_name,'apiId' => api_id,'tagId' => tag_id,'subscriptionId' => @client.subscription_id},
+          path_params: {'resourceGroupName' => resource_group_name,'serviceName' => service_name,'apiId' => api_id,'tagDescriptionId' => tag_description_id,'subscriptionId' => @client.subscription_id},
           query_params: {'api-version' => @client.api_version},
           headers: request_headers.merge(custom_headers || {}),
           base_url: request_url
@@ -372,11 +373,13 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
             parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
-            result_mapper = Azure::ApiManagement::Mgmt::V2018_01_01_preview::Models::TagDescriptionContract.mapper()
+            result_mapper = Azure::ApiManagement::Mgmt::V2019_12_01::Models::TagDescriptionContract.mapper()
             result.body = @client.deserialize(result_mapper, parsed_response)
           rescue Exception => e
             fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
@@ -390,15 +393,15 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     end
 
     #
-    # Create/Update tag fescription in scope of the Api.
+    # Create/Update tag description in scope of the Api.
     #
     # @param resource_group_name [String] The name of the resource group.
     # @param service_name [String] The name of the API Management service.
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param parameters [TagDescriptionCreateParameters] Create parameters.
     # @param if_match [String] ETag of the Entity. Not required when creating an
     # entity, but required when updating an entity.
@@ -407,21 +410,21 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [TagDescriptionContract] operation results.
     #
-    def create_or_update(resource_group_name, service_name, api_id, tag_id, parameters, if_match:nil, custom_headers:nil)
-      response = create_or_update_async(resource_group_name, service_name, api_id, tag_id, parameters, if_match:if_match, custom_headers:custom_headers).value!
+    def create_or_update(resource_group_name, service_name, api_id, tag_description_id, parameters, if_match:nil, custom_headers:nil)
+      response = create_or_update_async(resource_group_name, service_name, api_id, tag_description_id, parameters, if_match:if_match, custom_headers:custom_headers).value!
       response.body unless response.nil?
     end
 
     #
-    # Create/Update tag fescription in scope of the Api.
+    # Create/Update tag description in scope of the Api.
     #
     # @param resource_group_name [String] The name of the resource group.
     # @param service_name [String] The name of the API Management service.
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param parameters [TagDescriptionCreateParameters] Create parameters.
     # @param if_match [String] ETag of the Entity. Not required when creating an
     # entity, but required when updating an entity.
@@ -430,20 +433,20 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def create_or_update_with_http_info(resource_group_name, service_name, api_id, tag_id, parameters, if_match:nil, custom_headers:nil)
-      create_or_update_async(resource_group_name, service_name, api_id, tag_id, parameters, if_match:if_match, custom_headers:custom_headers).value!
+    def create_or_update_with_http_info(resource_group_name, service_name, api_id, tag_description_id, parameters, if_match:nil, custom_headers:nil)
+      create_or_update_async(resource_group_name, service_name, api_id, tag_description_id, parameters, if_match:if_match, custom_headers:custom_headers).value!
     end
 
     #
-    # Create/Update tag fescription in scope of the Api.
+    # Create/Update tag description in scope of the Api.
     #
     # @param resource_group_name [String] The name of the resource group.
     # @param service_name [String] The name of the API Management service.
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param parameters [TagDescriptionCreateParameters] Create parameters.
     # @param if_match [String] ETag of the Entity. Not required when creating an
     # entity, but required when updating an entity.
@@ -452,7 +455,7 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def create_or_update_async(resource_group_name, service_name, api_id, tag_id, parameters, if_match:nil, custom_headers:nil)
+    def create_or_update_async(resource_group_name, service_name, api_id, tag_description_id, parameters, if_match:nil, custom_headers:nil)
       fail ArgumentError, 'resource_group_name is nil' if resource_group_name.nil?
       fail ArgumentError, 'service_name is nil' if service_name.nil?
       fail ArgumentError, "'service_name' should satisfy the constraint - 'MaxLength': '50'" if !service_name.nil? && service_name.length > 50
@@ -462,10 +465,10 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
       fail ArgumentError, "'api_id' should satisfy the constraint - 'MaxLength': '256'" if !api_id.nil? && api_id.length > 256
       fail ArgumentError, "'api_id' should satisfy the constraint - 'MinLength': '1'" if !api_id.nil? && api_id.length < 1
       fail ArgumentError, "'api_id' should satisfy the constraint - 'Pattern': '^[^*#&+:<>?]+$'" if !api_id.nil? && api_id.match(Regexp.new('^^[^*#&+:<>?]+$$')).nil?
-      fail ArgumentError, 'tag_id is nil' if tag_id.nil?
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'MaxLength': '80'" if !tag_id.nil? && tag_id.length > 80
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'MinLength': '1'" if !tag_id.nil? && tag_id.length < 1
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'Pattern': '(^[\w]+$)|(^[\w][\w\-]+[\w]$)'" if !tag_id.nil? && tag_id.match(Regexp.new('^(^[\w]+$)|(^[\w][\w\-]+[\w]$)$')).nil?
+      fail ArgumentError, 'tag_description_id is nil' if tag_description_id.nil?
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'MaxLength': '80'" if !tag_description_id.nil? && tag_description_id.length > 80
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'MinLength': '1'" if !tag_description_id.nil? && tag_description_id.length < 1
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'Pattern': '^[^*#&+:<>?]+$'" if !tag_description_id.nil? && tag_description_id.match(Regexp.new('^^[^*#&+:<>?]+$$')).nil?
       fail ArgumentError, 'parameters is nil' if parameters.nil?
       fail ArgumentError, '@client.api_version is nil' if @client.api_version.nil?
       fail ArgumentError, '@client.subscription_id is nil' if @client.subscription_id.nil?
@@ -480,17 +483,17 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
       request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
 
       # Serialize Request
-      request_mapper = Azure::ApiManagement::Mgmt::V2018_01_01_preview::Models::TagDescriptionCreateParameters.mapper()
+      request_mapper = Azure::ApiManagement::Mgmt::V2019_12_01::Models::TagDescriptionCreateParameters.mapper()
       request_content = @client.serialize(request_mapper,  parameters)
       request_content = request_content != nil ? JSON.generate(request_content, quirks_mode: true) : nil
 
-      path_template = 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}'
+      path_template = 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagDescriptionId}'
 
       request_url = @base_url || @client.base_url
 
       options = {
           middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
-          path_params: {'resourceGroupName' => resource_group_name,'serviceName' => service_name,'apiId' => api_id,'tagId' => tag_id,'subscriptionId' => @client.subscription_id},
+          path_params: {'resourceGroupName' => resource_group_name,'serviceName' => service_name,'apiId' => api_id,'tagDescriptionId' => tag_description_id,'subscriptionId' => @client.subscription_id},
           query_params: {'api-version' => @client.api_version},
           body: request_content,
           headers: request_headers.merge(custom_headers || {}),
@@ -508,11 +511,13 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 201
           begin
             parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
-            result_mapper = Azure::ApiManagement::Mgmt::V2018_01_01_preview::Models::TagDescriptionContract.mapper()
+            result_mapper = Azure::ApiManagement::Mgmt::V2019_12_01::Models::TagDescriptionContract.mapper()
             result.body = @client.deserialize(result_mapper, parsed_response)
           rescue Exception => e
             fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
@@ -522,7 +527,7 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
         if status_code == 200
           begin
             parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
-            result_mapper = Azure::ApiManagement::Mgmt::V2018_01_01_preview::Models::TagDescriptionContract.mapper()
+            result_mapper = Azure::ApiManagement::Mgmt::V2019_12_01::Models::TagDescriptionContract.mapper()
             result.body = @client.deserialize(result_mapper, parsed_response)
           rescue Exception => e
             fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
@@ -543,8 +548,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param if_match [String] ETag of the Entity. ETag should match the current
     # entity state from the header response of the GET request or it should be *
     # for unconditional update.
@@ -552,8 +557,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # will be added to the HTTP request.
     #
     #
-    def delete(resource_group_name, service_name, api_id, tag_id, if_match, custom_headers:nil)
-      response = delete_async(resource_group_name, service_name, api_id, tag_id, if_match, custom_headers:custom_headers).value!
+    def delete(resource_group_name, service_name, api_id, tag_description_id, if_match, custom_headers:nil)
+      response = delete_async(resource_group_name, service_name, api_id, tag_description_id, if_match, custom_headers:custom_headers).value!
       nil
     end
 
@@ -565,8 +570,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param if_match [String] ETag of the Entity. ETag should match the current
     # entity state from the header response of the GET request or it should be *
     # for unconditional update.
@@ -575,8 +580,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def delete_with_http_info(resource_group_name, service_name, api_id, tag_id, if_match, custom_headers:nil)
-      delete_async(resource_group_name, service_name, api_id, tag_id, if_match, custom_headers:custom_headers).value!
+    def delete_with_http_info(resource_group_name, service_name, api_id, tag_description_id, if_match, custom_headers:nil)
+      delete_async(resource_group_name, service_name, api_id, tag_description_id, if_match, custom_headers:custom_headers).value!
     end
 
     #
@@ -587,8 +592,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param tag_id [String] Tag identifier. Must be unique in the current API
-    # Management service instance.
+    # @param tag_description_id [String] Tag description identifier. Used when
+    # creating tagDescription for API/Tag association. Based on API and Tag names.
     # @param if_match [String] ETag of the Entity. ETag should match the current
     # entity state from the header response of the GET request or it should be *
     # for unconditional update.
@@ -597,7 +602,7 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def delete_async(resource_group_name, service_name, api_id, tag_id, if_match, custom_headers:nil)
+    def delete_async(resource_group_name, service_name, api_id, tag_description_id, if_match, custom_headers:nil)
       fail ArgumentError, 'resource_group_name is nil' if resource_group_name.nil?
       fail ArgumentError, 'service_name is nil' if service_name.nil?
       fail ArgumentError, "'service_name' should satisfy the constraint - 'MaxLength': '50'" if !service_name.nil? && service_name.length > 50
@@ -607,10 +612,10 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
       fail ArgumentError, "'api_id' should satisfy the constraint - 'MaxLength': '256'" if !api_id.nil? && api_id.length > 256
       fail ArgumentError, "'api_id' should satisfy the constraint - 'MinLength': '1'" if !api_id.nil? && api_id.length < 1
       fail ArgumentError, "'api_id' should satisfy the constraint - 'Pattern': '^[^*#&+:<>?]+$'" if !api_id.nil? && api_id.match(Regexp.new('^^[^*#&+:<>?]+$$')).nil?
-      fail ArgumentError, 'tag_id is nil' if tag_id.nil?
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'MaxLength': '80'" if !tag_id.nil? && tag_id.length > 80
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'MinLength': '1'" if !tag_id.nil? && tag_id.length < 1
-      fail ArgumentError, "'tag_id' should satisfy the constraint - 'Pattern': '(^[\w]+$)|(^[\w][\w\-]+[\w]$)'" if !tag_id.nil? && tag_id.match(Regexp.new('^(^[\w]+$)|(^[\w][\w\-]+[\w]$)$')).nil?
+      fail ArgumentError, 'tag_description_id is nil' if tag_description_id.nil?
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'MaxLength': '80'" if !tag_description_id.nil? && tag_description_id.length > 80
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'MinLength': '1'" if !tag_description_id.nil? && tag_description_id.length < 1
+      fail ArgumentError, "'tag_description_id' should satisfy the constraint - 'Pattern': '^[^*#&+:<>?]+$'" if !tag_description_id.nil? && tag_description_id.match(Regexp.new('^^[^*#&+:<>?]+$$')).nil?
       fail ArgumentError, 'if_match is nil' if if_match.nil?
       fail ArgumentError, '@client.api_version is nil' if @client.api_version.nil?
       fail ArgumentError, '@client.subscription_id is nil' if @client.subscription_id.nil?
@@ -623,13 +628,13 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
       request_headers['x-ms-client-request-id'] = SecureRandom.uuid
       request_headers['If-Match'] = if_match unless if_match.nil?
       request_headers['accept-language'] = @client.accept_language unless @client.accept_language.nil?
-      path_template = 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagId}'
+      path_template = 'subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/tagDescriptions/{tagDescriptionId}'
 
       request_url = @base_url || @client.base_url
 
       options = {
           middlewares: [[MsRest::RetryPolicyMiddleware, times: 3, retry: 0.02], [:cookie_jar]],
-          path_params: {'resourceGroupName' => resource_group_name,'serviceName' => service_name,'apiId' => api_id,'tagId' => tag_id,'subscriptionId' => @client.subscription_id},
+          path_params: {'resourceGroupName' => resource_group_name,'serviceName' => service_name,'apiId' => api_id,'tagDescriptionId' => tag_description_id,'subscriptionId' => @client.subscription_id},
           query_params: {'api-version' => @client.api_version},
           headers: request_headers.merge(custom_headers || {}),
           base_url: request_url
@@ -646,6 +651,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
 
         result
       end
@@ -665,8 +672,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [TagDescriptionCollection] operation results.
     #
-    def list_by_api_next(next_page_link, custom_headers:nil)
-      response = list_by_api_next_async(next_page_link, custom_headers:custom_headers).value!
+    def list_by_service_next(next_page_link, custom_headers:nil)
+      response = list_by_service_next_async(next_page_link, custom_headers:custom_headers).value!
       response.body unless response.nil?
     end
 
@@ -682,8 +689,8 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [MsRestAzure::AzureOperationResponse] HTTP response information.
     #
-    def list_by_api_next_with_http_info(next_page_link, custom_headers:nil)
-      list_by_api_next_async(next_page_link, custom_headers:custom_headers).value!
+    def list_by_service_next_with_http_info(next_page_link, custom_headers:nil)
+      list_by_service_next_async(next_page_link, custom_headers:custom_headers).value!
     end
 
     #
@@ -698,7 +705,7 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     #
     # @return [Concurrent::Promise] Promise object which holds the HTTP response.
     #
-    def list_by_api_next_async(next_page_link, custom_headers:nil)
+    def list_by_service_next_async(next_page_link, custom_headers:nil)
       fail ArgumentError, 'next_page_link is nil' if next_page_link.nil?
 
 
@@ -730,11 +737,13 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
         end
 
         result.request_id = http_response['x-ms-request-id'] unless http_response['x-ms-request-id'].nil?
+        result.correlation_request_id = http_response['x-ms-correlation-request-id'] unless http_response['x-ms-correlation-request-id'].nil?
+        result.client_request_id = http_response['x-ms-client-request-id'] unless http_response['x-ms-client-request-id'].nil?
         # Deserialize Response
         if status_code == 200
           begin
             parsed_response = response_content.to_s.empty? ? nil : JSON.load(response_content)
-            result_mapper = Azure::ApiManagement::Mgmt::V2018_01_01_preview::Models::TagDescriptionCollection.mapper()
+            result_mapper = Azure::ApiManagement::Mgmt::V2019_12_01::Models::TagDescriptionCollection.mapper()
             result.body = @client.deserialize(result_mapper, parsed_response)
           rescue Exception => e
             fail MsRest::DeserializationError.new('Error occurred in deserializing the response', e.message, e.backtrace, result)
@@ -757,13 +766,12 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @param api_id [String] API revision identifier. Must be unique in the current
     # API Management service instance. Non-current revision has ;rev=n as a suffix
     # where n is the revision number.
-    # @param filter [String] | Field       | Supported operators    | Supported
-    # functions                         |
-    # |-------------|------------------------|---------------------------------------------|
-    # | id          | ge, le, eq, ne, gt, lt | substringof, contains, startswith,
-    # endswith |
-    # | name        | ge, le, eq, ne, gt, lt | substringof, contains, startswith,
-    # endswith |
+    # @param filter [String] |   Field     |     Usage     |     Supported
+    # operators     |     Supported functions
+    # |</br>|-------------|-------------|-------------|-------------|</br>|
+    # displayName | filter | ge, le, eq, ne, gt, lt | substringof, contains,
+    # startswith, endswith | </br>| name | filter | ge, le, eq, ne, gt, lt |
+    # substringof, contains, startswith, endswith | </br>
     # @param top [Integer] Number of records to return.
     # @param skip [Integer] Number of records to skip.
     # @param custom_headers [Hash{String => String}] A hash of custom headers that
@@ -772,12 +780,12 @@ module Azure::ApiManagement::Mgmt::V2018_01_01_preview
     # @return [TagDescriptionCollection] which provide lazy access to pages of the
     # response.
     #
-    def list_by_api_as_lazy(resource_group_name, service_name, api_id, filter:nil, top:nil, skip:nil, custom_headers:nil)
-      response = list_by_api_async(resource_group_name, service_name, api_id, filter:filter, top:top, skip:skip, custom_headers:custom_headers).value!
+    def list_by_service_as_lazy(resource_group_name, service_name, api_id, filter:nil, top:nil, skip:nil, custom_headers:nil)
+      response = list_by_service_async(resource_group_name, service_name, api_id, filter:filter, top:top, skip:skip, custom_headers:custom_headers).value!
       unless response.nil?
         page = response.body
         page.next_method = Proc.new do |next_page_link|
-          list_by_api_next_async(next_page_link, custom_headers:custom_headers)
+          list_by_service_next_async(next_page_link, custom_headers:custom_headers)
         end
         page
       end