Merge pull request #146 from Microsoft/users/tedchamb/dev

regen security client

Author: tedchamb

vsts/vsts/security/v4_1/security_client.py

@@ -1,4 +1,4 @@
-# --------------------------------------------------------------------------------------------
+# --------------------------------------------------------------------------------------------
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # Licensed under the MIT License. See License.txt in the project root for license information.
 # --------------------------------------------------------------------------------------------
@@ -27,7 +27,7 @@ def __init__(self, base_url=None, creds=None):
 
     def remove_access_control_entries(self, security_namespace_id, token=None, descriptors=None):
         """RemoveAccessControlEntries.
-        [Preview API] Remove the specified ACEs from the ACL belonging to the specified token.
+        Remove the specified ACEs from the ACL belonging to the specified token.
         :param str security_namespace_id:
         :param str token:
         :param str descriptors:
@@ -43,14 +43,14 @@ def remove_access_control_entries(self, security_namespace_id, token=None, descr
             query_parameters['descriptors'] = self._serialize.query('descriptors', descriptors, 'str')
         response = self._send(http_method='DELETE',
                               location_id='ac08c8ff-4323-4b08-af90-bcd018d380ce',
-                              version='4.1-preview.1',
+                              version='4.1',
                               route_values=route_values,
                               query_parameters=query_parameters)
         return self._deserialize('bool', response)
 
     def set_access_control_entries(self, container, security_namespace_id):
         """SetAccessControlEntries.
-        [Preview API] Add or update ACEs in the ACL for the provided token. In the case of a collision (by identity descriptor) with an existing ACE in the ACL, the "merge" parameter determines the behavior. If set, the existing ACE has its allow and deny merged with the incoming ACE's allow and deny. If unset, the existing ACE is displaced.
+        Add or update ACEs in the ACL for the provided token. In the case of a collision (by identity descriptor) with an existing ACE in the ACL, the "merge" parameter determines the behavior. If set, the existing ACE has its allow and deny merged with the incoming ACE's allow and deny. If unset, the existing ACE is displaced.
         :param :class:`<object> <security.v4_1.models.object>` container:
         :param str security_namespace_id:
         :rtype: [AccessControlEntry]
@@ -61,15 +61,15 @@ def set_access_control_entries(self, container, security_namespace_id):
         content = self._serialize.body(container, 'object')
         response = self._send(http_method='POST',
                               location_id='ac08c8ff-4323-4b08-af90-bcd018d380ce',
-                              version='4.1-preview.1',
+                              version='4.1',
                               route_values=route_values,
                               content=content,
                               returns_collection=True)
         return self._deserialize('[AccessControlEntry]', response)
 
     def query_access_control_lists(self, security_namespace_id, token=None, descriptors=None, include_extended_info=None, recurse=None):
         """QueryAccessControlLists.
-        [Preview API] Return a list of access control lists for the specified security namespace and token.
+        Return a list of access control lists for the specified security namespace and token.
         :param str security_namespace_id: Security namespace identifier.
         :param str token: Security token
         :param str descriptors:
@@ -91,15 +91,15 @@ def query_access_control_lists(self, security_namespace_id, token=None, descript
             query_parameters['recurse'] = self._serialize.query('recurse', recurse, 'bool')
         response = self._send(http_method='GET',
                               location_id='18a2ad18-7571-46ae-bec7-0c7da1495885',
-                              version='4.1-preview.1',
+                              version='4.1',
                               route_values=route_values,
                               query_parameters=query_parameters,
                               returns_collection=True)
         return self._deserialize('[AccessControlList]', response)
 
     def remove_access_control_lists(self, security_namespace_id, tokens=None, recurse=None):
         """RemoveAccessControlLists.
-        [Preview API] Remove access control lists under the specfied security namespace.
+        Remove access control lists under the specfied security namespace.
         :param str security_namespace_id: Security namespace identifier.
         :param str tokens: One or more comma-separated security tokens
         :param bool recurse: If true and this is a hierarchical namespace, also remove child ACLs of the specified tokens.
@@ -115,14 +115,14 @@ def remove_access_control_lists(self, security_namespace_id, tokens=None, recurs
             query_parameters['recurse'] = self._serialize.query('recurse', recurse, 'bool')
         response = self._send(http_method='DELETE',
                               location_id='18a2ad18-7571-46ae-bec7-0c7da1495885',
-                              version='4.1-preview.1',
+                              version='4.1',
                               route_values=route_values,
                               query_parameters=query_parameters)
         return self._deserialize('bool', response)
 
     def set_access_control_lists(self, access_control_lists, security_namespace_id):
         """SetAccessControlLists.
-        [Preview API] Create one or more access control lists.
+        Create one or more access control lists.
         :param :class:`<VssJsonCollectionWrapper> <security.v4_1.models.VssJsonCollectionWrapper>` access_control_lists:
         :param str security_namespace_id: Security namespace identifier.
         """
@@ -132,26 +132,26 @@ def set_access_control_lists(self, access_control_lists, security_namespace_id):
         content = self._serialize.body(access_control_lists, 'VssJsonCollectionWrapper')
         self._send(http_method='POST',
                    location_id='18a2ad18-7571-46ae-bec7-0c7da1495885',
-                   version='4.1-preview.1',
+                   version='4.1',
                    route_values=route_values,
                    content=content)
 
     def has_permissions_batch(self, eval_batch):
         """HasPermissionsBatch.
-        [Preview API] Evaluates multiple permissions for the callign user.  Note: This methods does not aggregate the results nor does it short-circut if one of the permissions evaluates to false.
-        :param :class:`<PermissionEvaluationBatch> <security.v4_1.models.PermissionEvaluationBatch>` eval_batch: The set of permissions to check.
+        Evaluates multiple permissions for the calling user.  Note: This method does not aggregate the results, nor does it short-circuit if one of the permissions evaluates to false.
+        :param :class:`<PermissionEvaluationBatch> <security.v4_1.models.PermissionEvaluationBatch>` eval_batch: The set of evaluation requests.
         :rtype: :class:`<PermissionEvaluationBatch> <security.v4_1.models.PermissionEvaluationBatch>`
         """
         content = self._serialize.body(eval_batch, 'PermissionEvaluationBatch')
         response = self._send(http_method='POST',
                               location_id='cf1faa59-1b63-4448-bf04-13d981a46f5d',
-                              version='4.1-preview.1',
+                              version='4.1',
                               content=content)
         return self._deserialize('PermissionEvaluationBatch', response)
 
     def has_permissions(self, security_namespace_id, permissions=None, tokens=None, always_allow_administrators=None, delimiter=None):
         """HasPermissions.
-        [Preview API] Evaluates whether the caller has the specified permissions on the specified set of security tokens.
+        Evaluates whether the caller has the specified permissions on the specified set of security tokens.
         :param str security_namespace_id: Security namespace identifier.
         :param int permissions: Permissions to evaluate.
         :param str tokens: One or more security tokens to evaluate.
@@ -173,15 +173,15 @@ def has_permissions(self, security_namespace_id, permissions=None, tokens=None,
             query_parameters['delimiter'] = self._serialize.query('delimiter', delimiter, 'str')
         response = self._send(http_method='GET',
                               location_id='dd3b8bd6-c7fc-4cbd-929a-933d9c011c9d',
-                              version='4.1-preview.2',
+                              version='4.1',
                               route_values=route_values,
                               query_parameters=query_parameters,
                               returns_collection=True)
         return self._deserialize('[bool]', response)
 
     def remove_permission(self, security_namespace_id, permissions=None, token=None, descriptor=None):
         """RemovePermission.
-        [Preview API] Removes the specified permissions from the caller or specified user or group.
+        Removes the specified permissions from the caller or specified user or group.
         :param str security_namespace_id: Security namespace identifier.
         :param int permissions: Permissions to remove.
         :param str token: Security token to remove permissions for.
@@ -200,14 +200,13 @@ def remove_permission(self, security_namespace_id, permissions=None, token=None,
             query_parameters['descriptor'] = self._serialize.query('descriptor', descriptor, 'str')
         response = self._send(http_method='DELETE',
                               location_id='dd3b8bd6-c7fc-4cbd-929a-933d9c011c9d',
-                              version='4.1-preview.2',
+                              version='4.1',
                               route_values=route_values,
                               query_parameters=query_parameters)
         return self._deserialize('AccessControlEntry', response)
 
     def query_security_namespaces(self, security_namespace_id, local_only=None):
         """QuerySecurityNamespaces.
-        [Preview API]
         :param str security_namespace_id:
         :param bool local_only:
         :rtype: [SecurityNamespaceDescription]
@@ -220,7 +219,7 @@ def query_security_namespaces(self, security_namespace_id, local_only=None):
             query_parameters['localOnly'] = self._serialize.query('local_only', local_only, 'bool')
         response = self._send(http_method='GET',
                               location_id='ce7b9f95-fde9-4be8-a86d-83b366f0b87a',
-                              version='4.1-preview.1',
+                              version='4.1',
                               route_values=route_values,
                               query_parameters=query_parameters,
                               returns_collection=True)