Merge pull request microsoft#270 from microsoft/users/tedchamb/51cc

regen 5.1 apis, fix casing of some 5.1 properties.

Author: tedchamb

azure-devops/azure/devops/released/notification/notification_client.py

@@ -27,11 +27,11 @@ def __init__(self, base_url=None, creds=None):
 
     def list_logs(self, source, entry_id=None, start_time=None, end_time=None):
         """ListLogs.
-        List diagnostic logs this service.
-        :param str source:
-        :param str entry_id:
-        :param datetime start_time:
-        :param datetime end_time:
+        Get a list of diagnostic logs for this service.
+        :param str source: ID specifying which type of logs to check diagnostics for.
+        :param str entry_id: The ID of the specific log to query for.
+        :param datetime start_time: Start time for the time range to query in.
+        :param datetime end_time: End time for the time range to query in.
         :rtype: [INotificationDiagnosticLog]
         """
         route_values = {}
@@ -53,7 +53,8 @@ def list_logs(self, source, entry_id=None, start_time=None, end_time=None):
 
     def get_subscription_diagnostics(self, subscription_id):
         """GetSubscriptionDiagnostics.
-        :param str subscription_id:
+        Get the diagnostics settings for a subscription.
+        :param str subscription_id: The id of the notifications subscription.
         :rtype: :class:`<SubscriptionDiagnostics> <azure.devops.v5_1.notification.models.SubscriptionDiagnostics>`
         """
         route_values = {}
@@ -67,8 +68,9 @@ def get_subscription_diagnostics(self, subscription_id):
 
     def update_subscription_diagnostics(self, update_parameters, subscription_id):
         """UpdateSubscriptionDiagnostics.
+        Update the diagnostics settings for a subscription.
         :param :class:`<UpdateSubscripitonDiagnosticsParameters> <azure.devops.v5_1.notification.models.UpdateSubscripitonDiagnosticsParameters>` update_parameters:
-        :param str subscription_id:
+        :param str subscription_id: The id of the notifications subscription.
         :rtype: :class:`<SubscriptionDiagnostics> <azure.devops.v5_1.notification.models.SubscriptionDiagnostics>`
         """
         route_values = {}
@@ -85,7 +87,7 @@ def update_subscription_diagnostics(self, update_parameters, subscription_id):
     def get_event_type(self, event_type):
         """GetEventType.
         Get a specific event type.
-        :param str event_type:
+        :param str event_type: The ID of the event type.
         :rtype: :class:`<NotificationEventType> <azure.devops.v5_1.notification.models.NotificationEventType>`
         """
         route_values = {}
@@ -135,7 +137,8 @@ def update_settings(self, update_parameters):
 
     def get_subscriber(self, subscriber_id):
         """GetSubscriber.
-        :param str subscriber_id:
+        Get delivery preferences of a notifications subscriber.
+        :param str subscriber_id: ID of the user or group.
         :rtype: :class:`<NotificationSubscriber> <azure.devops.v5_1.notification.models.NotificationSubscriber>`
         """
         route_values = {}
@@ -149,8 +152,9 @@ def get_subscriber(self, subscriber_id):
 
     def update_subscriber(self, update_parameters, subscriber_id):
         """UpdateSubscriber.
+        Update delivery preferences of a notifications subscriber.
         :param :class:`<NotificationSubscriberUpdateParameters> <azure.devops.v5_1.notification.models.NotificationSubscriberUpdateParameters>` update_parameters:
-        :param str subscriber_id:
+        :param str subscriber_id: ID of the user or group.
         :rtype: :class:`<NotificationSubscriber> <azure.devops.v5_1.notification.models.NotificationSubscriber>`
         """
         route_values = {}

azure-devops/azure/devops/v5_1/audit/models.py

@@ -27,8 +27,8 @@ class AuditLogEntry(Model):
     :type data: dict
     :param id: EventId, should be unique
     :type id: str
-    :param iPAddress: IP Address where the event was originated
-    :type iPAddress: str
+    :param ip_address: IP Address where the event was originated
+    :type ip_address: str
     :param scope_id: The org, collection or project Id
     :type scope_id: str
     :param scope_type: The type of the scope, Enterprise, Organization or Project
@@ -48,14 +48,14 @@ class AuditLogEntry(Model):
         'correlation_id': {'key': 'correlationId', 'type': 'str'},
         'data': {'key': 'data', 'type': '{object}'},
         'id': {'key': 'id', 'type': 'str'},
-        'iPAddress': {'key': 'ipAddress', 'type': 'str'},
+        'ip_address': {'key': 'ipAddress', 'type': 'str'},
         'scope_id': {'key': 'scopeId', 'type': 'str'},
         'scope_type': {'key': 'scopeType', 'type': 'object'},
         'timestamp': {'key': 'timestamp', 'type': 'iso-8601'},
         'user_agent': {'key': 'userAgent', 'type': 'str'}
     }
 
-    def __init__(self, action_id=None, activity_id=None, actor_cUID=None, actor_user_id=None, authentication_mechanism=None, correlation_id=None, data=None, id=None, iPAddress=None, scope_id=None, scope_type=None, timestamp=None, user_agent=None):
+    def __init__(self, action_id=None, activity_id=None, actor_cUID=None, actor_user_id=None, authentication_mechanism=None, correlation_id=None, data=None, id=None, ip_address=None, scope_id=None, scope_type=None, timestamp=None, user_agent=None):
         super(AuditLogEntry, self).__init__()
         self.action_id = action_id
         self.activity_id = activity_id
@@ -65,7 +65,7 @@ def __init__(self, action_id=None, activity_id=None, actor_cUID=None, actor_user
         self.correlation_id = correlation_id
         self.data = data
         self.id = id
-        self.iPAddress = iPAddress
+        self.ip_address = ip_address
         self.scope_id = scope_id
         self.scope_type = scope_type
         self.timestamp = timestamp

azure-devops/azure/devops/v5_1/cloud_load_test/models.py

@@ -1503,8 +1503,8 @@ class WebApiUserLoadTestMachineInput(WebApiLoadTestMachineInput):
     :type tenant_id: str
     :param user_load_agent_resources_uri:
     :type user_load_agent_resources_uri: str
-    :param vSTSAccount_uri:
-    :type vSTSAccount_uri: str
+    :param vsts_account_uri:
+    :type vsts_account_uri: str
     """
 
     _attribute_map = {
@@ -1515,15 +1515,15 @@ class WebApiUserLoadTestMachineInput(WebApiLoadTestMachineInput):
         'agent_group_name': {'key': 'agentGroupName', 'type': 'str'},
         'tenant_id': {'key': 'tenantId', 'type': 'str'},
         'user_load_agent_resources_uri': {'key': 'userLoadAgentResourcesUri', 'type': 'str'},
-        'vSTSAccount_uri': {'key': 'vstsAccountUri', 'type': 'str'}
+        'vsts_account_uri': {'key': 'vstsAccountUri', 'type': 'str'}
     }
 
-    def __init__(self, machine_group_id=None, machine_type=None, setup_configuration=None, supported_run_types=None, agent_group_name=None, tenant_id=None, user_load_agent_resources_uri=None, vSTSAccount_uri=None):
+    def __init__(self, machine_group_id=None, machine_type=None, setup_configuration=None, supported_run_types=None, agent_group_name=None, tenant_id=None, user_load_agent_resources_uri=None, vsts_account_uri=None):
         super(WebApiUserLoadTestMachineInput, self).__init__(machine_group_id=machine_group_id, machine_type=machine_type, setup_configuration=setup_configuration, supported_run_types=supported_run_types)
         self.agent_group_name = agent_group_name
         self.tenant_id = tenant_id
         self.user_load_agent_resources_uri = user_load_agent_resources_uri
-        self.vSTSAccount_uri = vSTSAccount_uri
+        self.vsts_account_uri = vsts_account_uri
 
 
 class WebInstanceSummaryData(Model):

azure-devops/azure/devops/v5_1/gallery/models.py

@@ -63,21 +63,21 @@ def __init__(self, default_operation=None, item_id=None, operations=None, target
 
 class Answers(Model):
     """
-    :param vSMarketplace_extension_name: Gets or sets the vs marketplace extension name
-    :type vSMarketplace_extension_name: str
-    :param vSMarketplace_publisher_name: Gets or sets the vs marketplace publisher name
-    :type vSMarketplace_publisher_name: str
+    :param vs_marketplace_extension_name: Gets or sets the vs marketplace extension name
+    :type vs_marketplace_extension_name: str
+    :param vs_marketplace_publisher_name: Gets or sets the vs marketplace publisher name
+    :type vs_marketplace_publisher_name: str
     """
 
     _attribute_map = {
-        'vSMarketplace_extension_name': {'key': 'vsMarketplaceExtensionName', 'type': 'str'},
-        'vSMarketplace_publisher_name': {'key': 'vsMarketplacePublisherName', 'type': 'str'}
+        'vs_marketplace_extension_name': {'key': 'vsMarketplaceExtensionName', 'type': 'str'},
+        'vs_marketplace_publisher_name': {'key': 'vsMarketplacePublisherName', 'type': 'str'}
     }
 
-    def __init__(self, vSMarketplace_extension_name=None, vSMarketplace_publisher_name=None):
+    def __init__(self, vs_marketplace_extension_name=None, vs_marketplace_publisher_name=None):
         super(Answers, self).__init__()
-        self.vSMarketplace_extension_name = vSMarketplace_extension_name
-        self.vSMarketplace_publisher_name = vSMarketplace_publisher_name
+        self.vs_marketplace_extension_name = vs_marketplace_extension_name
+        self.vs_marketplace_publisher_name = vs_marketplace_publisher_name
 
 
 class AssetDetails(Model):

azure-devops/azure/devops/v5_1/notification/models.py

@@ -335,23 +335,23 @@ class INotificationDiagnosticLog(Model):
     """
     Abstraction interface for the diagnostic log.  Primarily for deserialization.
 
-    :param activity_id:
+    :param activity_id: Identifier used for correlating to other diagnostics that may have been recorded elsewhere.
     :type activity_id: str
-    :param description:
+    :param description: Description of what subscription or notification job is being logged.
     :type description: str
-    :param end_time:
+    :param end_time: Time the log ended.
     :type end_time: datetime
-    :param id:
+    :param id: Unique instance identifier.
     :type id: str
-    :param log_type:
+    :param log_type: Type of information being logged.
     :type log_type: str
-    :param messages:
+    :param messages: List of log messages.
     :type messages: list of :class:`NotificationDiagnosticLogMessage <azure.devops.v5_1.notification.models.NotificationDiagnosticLogMessage>`
-    :param properties:
+    :param properties: Dictionary of log properties and settings for the job.
     :type properties: dict
-    :param source:
+    :param source: This identifier depends on the logType.  For notification jobs, this will be the job Id. For subscription tracing, this will be a special root Guid with the subscription Id encoded.
     :type source: str
-    :param start_time:
+    :param start_time: Time the log started.
     :type start_time: datetime
     """
 
@@ -1260,11 +1260,13 @@ def __init__(self, address=None, type=None, use_custom_address=None):
 
 class SubscriptionDiagnostics(Model):
     """
-    :param delivery_results:
+    Contains all the diagonstics settings for a subscription.
+
+    :param delivery_results: Diagnostics settings for retaining delivery results.  Used for Service Hooks subscriptions.
     :type delivery_results: :class:`SubscriptionTracing <azure.devops.v5_1.notification.models.SubscriptionTracing>`
-    :param delivery_tracing:
+    :param delivery_tracing: Diagnostics settings for troubleshooting notification delivery.
     :type delivery_tracing: :class:`SubscriptionTracing <azure.devops.v5_1.notification.models.SubscriptionTracing>`
-    :param evaluation_tracing:
+    :param evaluation_tracing: Diagnostics settings for troubleshooting event matching.
     :type evaluation_tracing: :class:`SubscriptionTracing <azure.devops.v5_1.notification.models.SubscriptionTracing>`
     """
 
@@ -1459,7 +1461,9 @@ def __init__(self, id=None, name=None, type=None):
 
 class SubscriptionTracing(Model):
     """
-    :param enabled:
+    Data controlling a single diagnostic setting for a subscription.
+
+    :param enabled: Indicates whether the diagnostic tracing is enabled or not.
     :type enabled: bool
     :param end_date: Trace until the specified end date.
     :type end_date: datetime
@@ -1507,11 +1511,13 @@ def __init__(self, opted_out=None):
 
 class UpdateSubscripitonDiagnosticsParameters(Model):
     """
-    :param delivery_results:
+    Parameters to update diagnostics settings for a subscription.
+
+    :param delivery_results: Diagnostics settings for retaining delivery results.  Used for Service Hooks subscriptions.
     :type delivery_results: :class:`UpdateSubscripitonTracingParameters <azure.devops.v5_1.notification.models.UpdateSubscripitonTracingParameters>`
-    :param delivery_tracing:
+    :param delivery_tracing: Diagnostics settings for troubleshooting notification delivery.
     :type delivery_tracing: :class:`UpdateSubscripitonTracingParameters <azure.devops.v5_1.notification.models.UpdateSubscripitonTracingParameters>`
-    :param evaluation_tracing:
+    :param evaluation_tracing: Diagnostics settings for troubleshooting event matching.
     :type evaluation_tracing: :class:`UpdateSubscripitonTracingParameters <azure.devops.v5_1.notification.models.UpdateSubscripitonTracingParameters>`
     """
 
@@ -1530,7 +1536,9 @@ def __init__(self, delivery_results=None, delivery_tracing=None, evaluation_trac
 
 class UpdateSubscripitonTracingParameters(Model):
     """
-    :param enabled:
+    Parameters to update a specific diagnostic setting.
+
+    :param enabled: Indicates whether to enable to disable the diagnostic tracing.
     :type enabled: bool
     """
 

azure-devops/azure/devops/v5_1/notification/notification_client.py

@@ -27,11 +27,11 @@ def __init__(self, base_url=None, creds=None):
 
     def list_logs(self, source, entry_id=None, start_time=None, end_time=None):
         """ListLogs.
-        List diagnostic logs this service.
-        :param str source:
-        :param str entry_id:
-        :param datetime start_time:
-        :param datetime end_time:
+        Get a list of diagnostic logs for this service.
+        :param str source: ID specifying which type of logs to check diagnostics for.
+        :param str entry_id: The ID of the specific log to query for.
+        :param datetime start_time: Start time for the time range to query in.
+        :param datetime end_time: End time for the time range to query in.
         :rtype: [INotificationDiagnosticLog]
         """
         route_values = {}
@@ -53,7 +53,8 @@ def list_logs(self, source, entry_id=None, start_time=None, end_time=None):
 
     def get_subscription_diagnostics(self, subscription_id):
         """GetSubscriptionDiagnostics.
-        :param str subscription_id:
+        Get the diagnostics settings for a subscription.
+        :param str subscription_id: The id of the notifications subscription.
         :rtype: :class:`<SubscriptionDiagnostics> <azure.devops.v5_1.notification.models.SubscriptionDiagnostics>`
         """
         route_values = {}
@@ -67,8 +68,9 @@ def get_subscription_diagnostics(self, subscription_id):
 
     def update_subscription_diagnostics(self, update_parameters, subscription_id):
         """UpdateSubscriptionDiagnostics.
+        Update the diagnostics settings for a subscription.
         :param :class:`<UpdateSubscripitonDiagnosticsParameters> <azure.devops.v5_1.notification.models.UpdateSubscripitonDiagnosticsParameters>` update_parameters:
-        :param str subscription_id:
+        :param str subscription_id: The id of the notifications subscription.
         :rtype: :class:`<SubscriptionDiagnostics> <azure.devops.v5_1.notification.models.SubscriptionDiagnostics>`
         """
         route_values = {}
@@ -85,7 +87,7 @@ def update_subscription_diagnostics(self, update_parameters, subscription_id):
     def get_event_type(self, event_type):
         """GetEventType.
         Get a specific event type.
-        :param str event_type:
+        :param str event_type: The ID of the event type.
         :rtype: :class:`<NotificationEventType> <azure.devops.v5_1.notification.models.NotificationEventType>`
         """
         route_values = {}
@@ -135,7 +137,8 @@ def update_settings(self, update_parameters):
 
     def get_subscriber(self, subscriber_id):
         """GetSubscriber.
-        :param str subscriber_id:
+        Get delivery preferences of a notifications subscriber.
+        :param str subscriber_id: ID of the user or group.
         :rtype: :class:`<NotificationSubscriber> <azure.devops.v5_1.notification.models.NotificationSubscriber>`
         """
         route_values = {}
@@ -149,8 +152,9 @@ def get_subscriber(self, subscriber_id):
 
     def update_subscriber(self, update_parameters, subscriber_id):
         """UpdateSubscriber.
+        Update delivery preferences of a notifications subscriber.
         :param :class:`<NotificationSubscriberUpdateParameters> <azure.devops.v5_1.notification.models.NotificationSubscriberUpdateParameters>` update_parameters:
-        :param str subscriber_id:
+        :param str subscriber_id: ID of the user or group.
         :rtype: :class:`<NotificationSubscriber> <azure.devops.v5_1.notification.models.NotificationSubscriber>`
         """
         route_values = {}

azure-devops/azure/devops/v5_1/profile/models.py

@@ -84,8 +84,8 @@ def __init__(self, is_auto_generated=None, size=None, time_stamp=None, value=Non
 
 class CreateProfileContext(Model):
     """
-    :param cIData:
-    :type cIData: dict
+    :param ci_data:
+    :type ci_data: dict
     :param contact_with_offers:
     :type contact_with_offers: bool
     :param country_name:
@@ -105,7 +105,7 @@ class CreateProfileContext(Model):
     """
 
     _attribute_map = {
-        'cIData': {'key': 'ciData', 'type': '{object}'},
+        'ci_data': {'key': 'ciData', 'type': '{object}'},
         'contact_with_offers': {'key': 'contactWithOffers', 'type': 'bool'},
         'country_name': {'key': 'countryName', 'type': 'str'},
         'display_name': {'key': 'displayName', 'type': 'str'},
@@ -116,9 +116,9 @@ class CreateProfileContext(Model):
         'profile_state': {'key': 'profileState', 'type': 'object'}
     }
 
-    def __init__(self, cIData=None, contact_with_offers=None, country_name=None, display_name=None, email_address=None, has_account=None, language=None, phone_number=None, profile_state=None):
+    def __init__(self, ci_data=None, contact_with_offers=None, country_name=None, display_name=None, email_address=None, has_account=None, language=None, phone_number=None, profile_state=None):
         super(CreateProfileContext, self).__init__()
-        self.cIData = cIData
+        self.ci_data = ci_data
         self.contact_with_offers = contact_with_offers
         self.country_name = country_name
         self.display_name = display_name

azure-devops/azure/devops/v5_1/release/models.py

@@ -1431,8 +1431,8 @@ class MailMessage(Model):
     """
     :param body: Body of mail.
     :type body: str
-    :param cC: Mail CC recipients.
-    :type cC: :class:`EmailRecipients <azure.devops.v5_1.release.models.EmailRecipients>`
+    :param cc: Mail CC recipients.
+    :type cc: :class:`EmailRecipients <azure.devops.v5_1.release.models.EmailRecipients>`
     :param in_reply_to: Reply to.
     :type in_reply_to: str
     :param message_id: Message ID of the mail.
@@ -1453,7 +1453,7 @@ class MailMessage(Model):
 
     _attribute_map = {
         'body': {'key': 'body', 'type': 'str'},
-        'cC': {'key': 'cc', 'type': 'EmailRecipients'},
+        'cc': {'key': 'cc', 'type': 'EmailRecipients'},
         'in_reply_to': {'key': 'inReplyTo', 'type': 'str'},
         'message_id': {'key': 'messageId', 'type': 'str'},
         'reply_by': {'key': 'replyBy', 'type': 'iso-8601'},
@@ -1464,10 +1464,10 @@ class MailMessage(Model):
         'to': {'key': 'to', 'type': 'EmailRecipients'}
     }
 
-    def __init__(self, body=None, cC=None, in_reply_to=None, message_id=None, reply_by=None, reply_to=None, sections=None, sender_type=None, subject=None, to=None):
+    def __init__(self, body=None, cc=None, in_reply_to=None, message_id=None, reply_by=None, reply_to=None, sections=None, sender_type=None, subject=None, to=None):
         super(MailMessage, self).__init__()
         self.body = body
-        self.cC = cC
+        self.cc = cc
         self.in_reply_to = in_reply_to
         self.message_id = message_id
         self.reply_by = reply_by