Updates for Azure Batch to support API version 2019-08-01.

sdk/batch/azure-batch/HISTORY.rst

@@ -3,6 +3,16 @@
 Release History
 ===============
 
+8.0.0 (2019-8-5)
+++++++++++++++++++
+
+- Using REST API version 2019-08-01.10.0.
+    * Added ability to specify a collection of public IPs on `NetworkConfiguration` via the new `public_ips` property. This guarantees nodes in the Pool will have an IP from the list user provided IPs.
+    * Added ability to mount remote file-systems on each node of a pool via the `mount_configuration` property on `CloudPool`.
+    * Shared Image Gallery images can now be specified on the `virtual_machine_image_id` property of `ImageReference` by referencing the image via its ARM ID.
+    * **Breaking** When not specified, the default value for `wait_for_success` on `StartTask` is now `True` (was `False`).
+    * **Breaking** When not specified, the default value for `scope` on `AutoUserSpecification` is now always `Pool` (was `Task` on Windows nodes, `Pool` on Linux nodes).
+
 7.0.0 (2019-6-11)
 ++++++++++++++++++
 

sdk/batch/azure-batch/azure/batch/_batch_service_client.py

@@ -65,7 +65,7 @@ def __init__(
         super(BatchServiceClient, self).__init__(self.config.credentials, self.config)
 
         client_models = {k: v for k, v in models.__dict__.items() if isinstance(v, type)}
-        self.api_version = '2019-06-01.9.0'
+        self.api_version = '2019-08-01.10.0'
         self._serialize = Serializer(client_models)
         self._deserialize = Deserializer(client_models)
 

sdk/batch/azure-batch/azure/batch/models/__init__.py

@@ -22,6 +22,8 @@
     from ._models_py3 import AutoScaleRun
     from ._models_py3 import AutoScaleRunError
     from ._models_py3 import AutoUserSpecification
+    from ._models_py3 import AzureBlobFileSystemConfiguration
+    from ._models_py3 import AzureFileShareConfiguration
     from ._models_py3 import BatchError, BatchErrorException
     from ._models_py3 import BatchErrorDetail
     from ._models_py3 import Certificate
@@ -32,6 +34,7 @@
     from ._models_py3 import CertificateGetOptions
     from ._models_py3 import CertificateListOptions
     from ._models_py3 import CertificateReference
+    from ._models_py3 import CIFSMountConfiguration
     from ._models_py3 import CloudJob
     from ._models_py3 import CloudJobSchedule
     from ._models_py3 import CloudPool
@@ -126,10 +129,12 @@
     from ._models_py3 import JobUpdateParameter
     from ._models_py3 import LinuxUserConfiguration
     from ._models_py3 import MetadataItem
+    from ._models_py3 import MountConfiguration
     from ._models_py3 import MultiInstanceSettings
     from ._models_py3 import NameValuePair
     from ._models_py3 import NetworkConfiguration
     from ._models_py3 import NetworkSecurityGroupRule
+    from ._models_py3 import NFSMountConfiguration
     from ._models_py3 import NodeAgentInformation
     from ._models_py3 import NodeCounts
     from ._models_py3 import NodeDisableSchedulingParameter
@@ -223,6 +228,8 @@
     from ._models import AutoScaleRun
     from ._models import AutoScaleRunError
     from ._models import AutoUserSpecification
+    from ._models import AzureBlobFileSystemConfiguration
+    from ._models import AzureFileShareConfiguration
     from ._models import BatchError, BatchErrorException
     from ._models import BatchErrorDetail
     from ._models import Certificate
@@ -233,6 +240,7 @@
     from ._models import CertificateGetOptions
     from ._models import CertificateListOptions
     from ._models import CertificateReference
+    from ._models import CIFSMountConfiguration
     from ._models import CloudJob
     from ._models import CloudJobSchedule
     from ._models import CloudPool
@@ -327,10 +335,12 @@
     from ._models import JobUpdateParameter
     from ._models import LinuxUserConfiguration
     from ._models import MetadataItem
+    from ._models import MountConfiguration
     from ._models import MultiInstanceSettings
     from ._models import NameValuePair
     from ._models import NetworkConfiguration
     from ._models import NetworkSecurityGroupRule
+    from ._models import NFSMountConfiguration
     from ._models import NodeAgentInformation
     from ._models import NodeCounts
     from ._models import NodeDisableSchedulingParameter
@@ -481,6 +491,8 @@
     'AutoScaleRun',
     'AutoScaleRunError',
     'AutoUserSpecification',
+    'AzureBlobFileSystemConfiguration',
+    'AzureFileShareConfiguration',
     'BatchError', 'BatchErrorException',
     'BatchErrorDetail',
     'Certificate',
@@ -491,6 +503,7 @@
     'CertificateGetOptions',
     'CertificateListOptions',
     'CertificateReference',
+    'CIFSMountConfiguration',
     'CloudJob',
     'CloudJobSchedule',
     'CloudPool',
@@ -585,10 +598,12 @@
     'JobUpdateParameter',
     'LinuxUserConfiguration',
     'MetadataItem',
+    'MountConfiguration',
     'MultiInstanceSettings',
     'NameValuePair',
     'NetworkConfiguration',
     'NetworkSecurityGroupRule',
+    'NFSMountConfiguration',
     'NodeAgentInformation',
     'NodeCounts',
     'NodeDisableSchedulingParameter',

sdk/batch/azure-batch/azure/batch/models/_batch_service_client_enums.py

@@ -57,8 +57,8 @@ class JobAction(str, Enum):
 
 class DependencyAction(str, Enum):
 
-    satisfy = "satisfy"  #: Satisfy the Task's dependencies.
-    block = "block"  #: Block the Task's dependencies.
+    satisfy = "satisfy"  #: Satisfy tasks waiting on this task; once all dependencies are satisfied, the task will be scheduled to run.
+    block = "block"  #: Blocks tasks waiting on this task, preventing them from being scheduled.
 
 
 class AutoUserScope(str, Enum):
@@ -100,9 +100,9 @@ class CertificateStoreLocation(str, Enum):
 
 class CertificateVisibility(str, Enum):
 
-    start_task = "starttask"  #: The Certificate should be visible to the user Account under which the start Task is run.
-    task = "task"  #: The Certificate should be visible to the user Accounts under which Job Tasks are run.
-    remote_user = "remoteuser"  #: The Certificate should be visible to the user Accounts under which users remotely access the Compute Node.
+    start_task = "starttask"  #: The Certificate should be visible to the user account under which the StartTask is run. Note that if AutoUser Scope is Pool for both the StartTask and a Task, this certificate will be visible to the Task as well.
+    task = "task"  #: The Certificate should be visible to the user accounts under which Job Tasks are run.
+    remote_user = "remoteuser"  #: The Certificate should be visible to the user accounts under which users remotely access the Compute Node.
 
 
 class CachingType(str, Enum):
@@ -235,21 +235,21 @@ class SubtaskState(str, Enum):
 
 class StartTaskState(str, Enum):
 
-    running = "running"  #: The start Task is currently running.
-    completed = "completed"  #: The start Task has exited with exit code 0, or the start Task has failed and the retry limit has reached, or the start Task process did not run due to Task preparation errors (such as resource file download failures).
+    running = "running"  #: The StartTask is currently running.
+    completed = "completed"  #: The StartTask has exited with exit code 0, or the StartTask has failed and the retry limit has reached, or the StartTask process did not run due to Task preparation errors (such as resource file download failures).
 
 
 class ComputeNodeState(str, Enum):
 
     idle = "idle"  #: The Compute Node is not currently running a Task.
     rebooting = "rebooting"  #: The Compute Node is rebooting.
     reimaging = "reimaging"  #: The Compute Node is reimaging.
-    running = "running"  #: The Compute Node is running one or more Tasks (other than a start task).
+    running = "running"  #: The Compute Node is running one or more Tasks (other than a StartTask).
     unusable = "unusable"  #: The Compute Node cannot be used for Task execution due to errors.
     creating = "creating"  #: The Batch service has obtained the underlying virtual machine from Azure Compute, but it has not yet started to join the Pool.
     starting = "starting"  #: The Batch service is starting on the underlying virtual machine.
-    waiting_for_start_task = "waitingforstarttask"  #: The start Task has started running on the Compute Node, but waitForSuccess is set and the start Task has not yet completed.
-    start_task_failed = "starttaskfailed"  #: The start Task has failed on the Compute Node (and exhausted all retries), and waitForSuccess is set. The Compute Node is not usable for running Tasks.
+    waiting_for_start_task = "waitingforstarttask"  #: The StartTask has started running on the Compute Node, but waitForSuccess is set and the StartTask has not yet completed.
+    start_task_failed = "starttaskfailed"  #: The StartTask has failed on the Compute Node (and exhausted all retries), and waitForSuccess is set. The Compute Node is not usable for running Tasks.
     unknown = "unknown"  #: The Batch service has lost contact with the Compute Node, and does not know its true state.
     leaving_pool = "leavingpool"  #: The Compute Node is leaving the Pool, either because the user explicitly removed it or because the Pool is resizing or autoscaling down.
     offline = "offline"  #: The Compute Node is not currently running a Task, and scheduling of new Tasks to the Compute Node is disabled.