Merge pull request #862 from AutorestCI/RestAPI-PR704

Automatic PR from RestAPI-PR704

azure-mgmt-authorization/azure/mgmt/authorization/authorization_management_client.py

@@ -29,11 +29,9 @@ class AuthorizationManagementClientConfiguration(AzureConfiguration):
     :param credentials: Credentials needed for the client to connect to Azure.
     :type credentials: :mod:`A msrestazure Credentials
      object<msrestazure.azure_active_directory>`
-    :param subscription_id: Gets subscription credentials which uniquely
-     identify Microsoft Azure subscription. The subscription ID forms part of
-     the URI for every service call.
+    :param subscription_id: The ID of the target subscription.
     :type subscription_id: str
-    :param api_version: Client Api Version.
+    :param api_version: The API version to use for this operation.
     :type api_version: str
     :param accept_language: Gets or sets the preferred language for the
      response.
@@ -79,7 +77,7 @@ def __init__(
 
 
 class AuthorizationManagementClient(object):
-    """AuthorizationManagementClient
+    """Role based access control provides you a way to apply granular level policy administration down to individual resources or resource groups. These operations enable you to manage role definitions and role assignments. A role definition describes the set of actions that can be performed on resources. A role assignment grants access to Azure Active Directory users.
 
     :ivar config: Configuration for client.
     :vartype config: AuthorizationManagementClientConfiguration
@@ -98,11 +96,9 @@ class AuthorizationManagementClient(object):
     :param credentials: Credentials needed for the client to connect to Azure.
     :type credentials: :mod:`A msrestazure Credentials
      object<msrestazure.azure_active_directory>`
-    :param subscription_id: Gets subscription credentials which uniquely
-     identify Microsoft Azure subscription. The subscription ID forms part of
-     the URI for every service call.
+    :param subscription_id: The ID of the target subscription.
     :type subscription_id: str
-    :param api_version: Client Api Version.
+    :param api_version: The API version to use for this operation.
     :type api_version: str
     :param accept_language: Gets or sets the preferred language for the
      response.

azure-mgmt-authorization/azure/mgmt/authorization/models/classic_administrator.py

@@ -15,13 +15,13 @@
 class ClassicAdministrator(Model):
     """Classic Administrators.
 
-    :param id: Gets or sets the classic administrator id.
+    :param id: The ID of the administrator.
     :type id: str
-    :param name: Gets or sets the classic administrator name.
+    :param name: The name of the administrator.
     :type name: str
-    :param type: Gets or sets the classic administrator type.
+    :param type: The type of the administrator.
     :type type: str
-    :param properties: Gets or sets the classic administrator properties.
+    :param properties: Properties for the classic administrator.
     :type properties: :class:`ClassicAdministratorProperties
      <azure.mgmt.authorization.models.ClassicAdministratorProperties>`
     """ 

azure-mgmt-authorization/azure/mgmt/authorization/models/classic_administrator_properties.py

@@ -15,9 +15,9 @@
 class ClassicAdministratorProperties(Model):
     """Classic Administrator properties.
 
-    :param email_address: Gets or sets the email address
+    :param email_address: The email address of the administrator.
     :type email_address: str
-    :param role: Gets or sets the role
+    :param role: The role of the administrator.
     :type role: str
     """ 
 

azure-mgmt-authorization/azure/mgmt/authorization/models/permission.py

@@ -15,9 +15,9 @@
 class Permission(Model):
     """Role definition permissions.
 
-    :param actions: Role definition allowed actions.
+    :param actions: Allowed actions.
     :type actions: list of str
-    :param not_actions: Role definition denied actions.
+    :param not_actions: Denied actions.
     :type not_actions: list of str
     """ 
 

azure-mgmt-authorization/azure/mgmt/authorization/models/provider_operation.py

@@ -15,15 +15,15 @@
 class ProviderOperation(Model):
     """Operation.
 
-    :param name: Gets or sets the operation name
+    :param name: The operation name.
     :type name: str
-    :param display_name: Gets or sets the operation display name
+    :param display_name: The operation display name.
     :type display_name: str
-    :param description: Gets or sets the operation description
+    :param description: The operation description.
     :type description: str
-    :param origin: Gets or sets the operation origin
+    :param origin: The operation origin.
     :type origin: str
-    :param properties: Gets or sets the operation properties
+    :param properties: The operation properties.
     :type properties: object
     """ 
 

azure-mgmt-authorization/azure/mgmt/authorization/models/provider_operations_metadata.py

@@ -15,18 +15,18 @@
 class ProviderOperationsMetadata(Model):
     """Provider Operations metadata.
 
-    :param id: Gets or sets the provider id.
+    :param id: The provider id.
     :type id: str
-    :param name: Gets or sets the provider name
+    :param name: The provider name.
     :type name: str
-    :param type: Gets or sets the provider type
+    :param type: The provider type.
     :type type: str
-    :param display_name: Gets or sets the provider display name
+    :param display_name: The provider display name.
     :type display_name: str
-    :param resource_types: Gets or sets the provider resource types
+    :param resource_types: The provider resource types
     :type resource_types: list of :class:`ResourceType
      <azure.mgmt.authorization.models.ResourceType>`
-    :param operations: Gets or sets the provider operations
+    :param operations: The provider operations.
     :type operations: list of :class:`ProviderOperation
      <azure.mgmt.authorization.models.ProviderOperation>`
     """ 

azure-mgmt-authorization/azure/mgmt/authorization/models/resource_type.py

@@ -15,11 +15,11 @@
 class ResourceType(Model):
     """Resource Type.
 
-    :param name: Gets or sets the resource type name
+    :param name: The resource type name.
     :type name: str
-    :param display_name: Gets or sets the resource type display name
+    :param display_name: The resource type display name.
     :type display_name: str
-    :param operations: Gets or sets the resource type operations
+    :param operations: The resource type operations.
     :type operations: list of :class:`ProviderOperation
      <azure.mgmt.authorization.models.ProviderOperation>`
     """ 

azure-mgmt-authorization/azure/mgmt/authorization/models/role_assignment.py

@@ -15,13 +15,13 @@
 class RoleAssignment(Model):
     """Role Assignments.
 
-    :param id: Gets or sets role assignment id.
+    :param id: The role assignment ID.
     :type id: str
-    :param name: Gets or sets role assignment name.
+    :param name: The role assignment name.
     :type name: str
-    :param type: Gets or sets role assignment type.
+    :param type: The role assignment type.
     :type type: str
-    :param properties: Gets or sets role assignment properties.
+    :param properties: Role assignment properties.
     :type properties: :class:`RoleAssignmentPropertiesWithScope
      <azure.mgmt.authorization.models.RoleAssignmentPropertiesWithScope>`
     """ 

azure-mgmt-authorization/azure/mgmt/authorization/models/role_assignment_create_parameters.py

@@ -15,7 +15,7 @@
 class RoleAssignmentCreateParameters(Model):
     """Role assignment create parameters.
 
-    :param properties: Gets or sets role assignment properties.
+    :param properties: Role assignment properties.
     :type properties: :class:`RoleAssignmentProperties
      <azure.mgmt.authorization.models.RoleAssignmentProperties>`
     """ 

azure-mgmt-authorization/azure/mgmt/authorization/models/role_assignment_properties.py

@@ -15,9 +15,12 @@
 class RoleAssignmentProperties(Model):
     """Role assignment properties.
 
-    :param role_definition_id: Gets or sets role definition id.
+    :param role_definition_id: The role definition ID used in the role
+     assignment.
     :type role_definition_id: str
-    :param principal_id: Gets or sets principal Id.
+    :param principal_id: The principal ID assigned to the role. This maps to
+     the ID inside the Active Directory. It can point to a user, service
+     principal, or security group.
     :type principal_id: str
     """ 
 

azure-mgmt-authorization/azure/mgmt/authorization/models/role_assignment_properties_with_scope.py

@@ -15,11 +15,11 @@
 class RoleAssignmentPropertiesWithScope(Model):
     """Role assignment properties with scope.
 
-    :param scope: Gets or sets role assignment scope.
+    :param scope: The role assignment scope.
     :type scope: str
-    :param role_definition_id: Gets or sets role definition id.
+    :param role_definition_id: The role definition ID.
     :type role_definition_id: str
-    :param principal_id: Gets or sets principal Id.
+    :param principal_id: The principal ID.
     :type principal_id: str
     """ 
 

azure-mgmt-authorization/azure/mgmt/authorization/models/role_definition.py

@@ -15,13 +15,13 @@
 class RoleDefinition(Model):
     """Role definition.
 
-    :param id: Gets or sets role definition id.
+    :param id: The role definition ID.
     :type id: str
-    :param name: Gets or sets role definition name.
+    :param name: The role definition name.
     :type name: str
-    :param type: Gets or sets role definition type.
+    :param type: The role definition type.
     :type type: str
-    :param properties: Gets or sets role definition properties.
+    :param properties: Role definition properties.
     :type properties: :class:`RoleDefinitionProperties
      <azure.mgmt.authorization.models.RoleDefinitionProperties>`
     """ 

azure-mgmt-authorization/azure/mgmt/authorization/models/role_definition_properties.py

@@ -15,16 +15,16 @@
 class RoleDefinitionProperties(Model):
     """Role definition properties.
 
-    :param role_name: Gets or sets role name.
+    :param role_name: The role name.
     :type role_name: str
-    :param description: Gets or sets role definition description.
+    :param description: The role definition description.
     :type description: str
-    :param type: Gets or sets role type.
+    :param type: The role type.
     :type type: str
-    :param permissions: Gets or sets role definition permissions.
+    :param permissions: Role definition permissions.
     :type permissions: list of :class:`Permission
      <azure.mgmt.authorization.models.Permission>`
-    :param assignable_scopes: Gets or sets role definition assignable scopes.
+    :param assignable_scopes: Role definition assignable scopes.
     :type assignable_scopes: list of str
     """ 
 

azure-mgmt-authorization/azure/mgmt/authorization/operations/classic_administrators_operations.py

@@ -35,9 +35,10 @@ def __init__(self, client, config, serializer, deserializer):
 
     def list(
             self, api_version, custom_headers=None, raw=False, **operation_config):
-        """Gets a list of classic administrators for the subscription.
+        """Gets service administrator, account administrator, and
+        co-administrators for the subscription.
 
-        :param api_version:
+        :param api_version: The API version to use for this operation.
         :type api_version: str
         :param dict custom_headers: headers that will be added to the request
         :param bool raw: returns the direct response alongside the
@@ -46,6 +47,7 @@ def list(
          overrides<msrest:optionsforoperations>`.
         :rtype: :class:`ClassicAdministratorPaged
          <azure.mgmt.authorization.models.ClassicAdministratorPaged>`
+        :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
         """
         def internal_paging(next_link=None, raw=False):
 

azure-mgmt-authorization/azure/mgmt/authorization/operations/permissions_operations.py

@@ -35,10 +35,10 @@ def __init__(self, client, config, serializer, deserializer):
 
     def list_for_resource_group(
             self, resource_group_name, custom_headers=None, raw=False, **operation_config):
-        """Gets a resource group permissions.
+        """Gets all permissions the caller has for a resource group.
 
-        :param resource_group_name: Name of the resource group to get the
-         permissions for.The name is case insensitive.
+        :param resource_group_name: The name of the resource group to get the
+         permissions for. The name is case insensitive.
         :type resource_group_name: str
         :param dict custom_headers: headers that will be added to the request
         :param bool raw: returns the direct response alongside the
@@ -47,6 +47,7 @@ def list_for_resource_group(
          overrides<msrest:optionsforoperations>`.
         :rtype: :class:`PermissionPaged
          <azure.mgmt.authorization.models.PermissionPaged>`
+        :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
         """
         def internal_paging(next_link=None, raw=False):
 
@@ -101,18 +102,20 @@ def internal_paging(next_link=None, raw=False):
 
     def list_for_resource(
             self, resource_group_name, resource_provider_namespace, parent_resource_path, resource_type, resource_name, custom_headers=None, raw=False, **operation_config):
-        """Gets a resource permissions.
+        """Gets all permissions the caller has for a resource.
 
-        :param resource_group_name: The name of the resource group. The name
-         is case insensitive.
+        :param resource_group_name: The name of the resource group containing
+         the resource. The name is case insensitive.
         :type resource_group_name: str
-        :param resource_provider_namespace: Resource
+        :param resource_provider_namespace: The namespace of the resource
+         provider.
         :type resource_provider_namespace: str
-        :param parent_resource_path: Resource
+        :param parent_resource_path: The parent resource identity.
         :type parent_resource_path: str
-        :param resource_type: Resource
+        :param resource_type: The resource type of the resource.
         :type resource_type: str
-        :param resource_name: Resource
+        :param resource_name: The name of the resource to get the permissions
+         for.
         :type resource_name: str
         :param dict custom_headers: headers that will be added to the request
         :param bool raw: returns the direct response alongside the
@@ -121,6 +124,7 @@ def list_for_resource(
          overrides<msrest:optionsforoperations>`.
         :rtype: :class:`PermissionPaged
          <azure.mgmt.authorization.models.PermissionPaged>`
+        :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
         """
         def internal_paging(next_link=None, raw=False):
 

azure-mgmt-authorization/azure/mgmt/authorization/operations/provider_operations_metadata_operations.py

@@ -35,14 +35,14 @@ def __init__(self, client, config, serializer, deserializer):
 
     def get(
             self, resource_provider_namespace, api_version, expand="resourceTypes", custom_headers=None, raw=False, **operation_config):
-        """Gets provider operations metadata.
+        """Gets provider operations metadata for the specified resource provider.
 
-        :param resource_provider_namespace: Namespace of the resource
+        :param resource_provider_namespace: The namespace of the resource
          provider.
         :type resource_provider_namespace: str
-        :param api_version:
+        :param api_version: The API version to use for the operation.
         :type api_version: str
-        :param expand:
+        :param expand: Specifies whether to expand the values.
         :type expand: str
         :param dict custom_headers: headers that will be added to the request
         :param bool raw: returns the direct response alongside the
@@ -53,6 +53,7 @@ def get(
          <azure.mgmt.authorization.models.ProviderOperationsMetadata>`
         :rtype: :class:`ClientRawResponse<msrest.pipeline.ClientRawResponse>`
          if raw=true
+        :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
         """
         # Construct URL
         url = '/providers/Microsoft.Authorization/providerOperations/{resourceProviderNamespace}'
@@ -99,11 +100,11 @@ def get(
 
     def list(
             self, api_version, expand="resourceTypes", custom_headers=None, raw=False, **operation_config):
-        """Gets provider operations metadata list.
+        """Gets provider operations metadata for all resource providers.
 
-        :param api_version:
+        :param api_version: The API version to use for this operation.
         :type api_version: str
-        :param expand:
+        :param expand: Specifies whether to expand the values.
         :type expand: str
         :param dict custom_headers: headers that will be added to the request
         :param bool raw: returns the direct response alongside the
@@ -112,6 +113,7 @@ def list(
          overrides<msrest:optionsforoperations>`.
         :rtype: :class:`ProviderOperationsMetadataPaged
          <azure.mgmt.authorization.models.ProviderOperationsMetadataPaged>`
+        :raises: :class:`CloudError<msrestazure.azure_exceptions.CloudError>`
         """
         def internal_paging(next_link=None, raw=False):