[AutoPR deploymentmanager/resource-manager] DeploymentManager: Fix property name and enhance descriptions

azure-mgmt-deploymentmanager/MANIFEST.in

@@ -1,2 +1 @@
 include *.rst
-include azure_bdist_wheel.py

azure-mgmt-deploymentmanager/azure/__init__.py

@@ -1 +1 @@
-__import__('pkg_resources').declare_namespace(__name__)
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)

azure-mgmt-deploymentmanager/azure/mgmt/__init__.py

@@ -1 +1 @@
-__import__('pkg_resources').declare_namespace(__name__)
+__path__ = __import__('pkgutil').extend_path(__path__, __name__)

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/artifact_source.py

@@ -13,7 +13,7 @@
 
 
 class ArtifactSource(TrackedResource):
-    """The resource that define the source location where the artifacts are
+    """The resource that defines the source location where the artifacts are
     located.
 
     Variables are only populated by the server, and will be ignored when
@@ -35,8 +35,13 @@ class ArtifactSource(TrackedResource):
     :type location: str
     :param source_type: Required. The type of artifact source used.
     :type source_type: str
-    :param artifact_root: The root folder under which all artifacts for all
-     environments are expected to be organized.
+    :param artifact_root: The path from the location that the 'authentication'
+     property [say, a SAS URI to the blob container] refers to, to the location
+     of the artifacts. This can be used to differentiate different versions of
+     the artifacts. Or, different types of artifacts like binaries or
+     templates. The location referenced by the authentication property
+     concatenated with this optional artifactRoot path forms the artifact
+     source location where the artifacts are expected to be found.
     :type artifact_root: str
     :param authentication: Required. The authentication method to use to
      access the artifact source.

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/artifact_source_properties_model.py

@@ -20,8 +20,13 @@ class ArtifactSourcePropertiesModel(Model):
 
     :param source_type: Required. The type of artifact source used.
     :type source_type: str
-    :param artifact_root: The root folder under which all artifacts for all
-     environments are expected to be organized.
+    :param artifact_root: The path from the location that the 'authentication'
+     property [say, a SAS URI to the blob container] refers to, to the location
+     of the artifacts. This can be used to differentiate different versions of
+     the artifacts. Or, different types of artifacts like binaries or
+     templates. The location referenced by the authentication property
+     concatenated with this optional artifactRoot path forms the artifact
+     source location where the artifacts are expected to be found.
     :type artifact_root: str
     :param authentication: Required. The authentication method to use to
      access the artifact source.

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/artifact_source_properties_model_py3.py

@@ -20,8 +20,13 @@ class ArtifactSourcePropertiesModel(Model):
 
     :param source_type: Required. The type of artifact source used.
     :type source_type: str
-    :param artifact_root: The root folder under which all artifacts for all
-     environments are expected to be organized.
+    :param artifact_root: The path from the location that the 'authentication'
+     property [say, a SAS URI to the blob container] refers to, to the location
+     of the artifacts. This can be used to differentiate different versions of
+     the artifacts. Or, different types of artifacts like binaries or
+     templates. The location referenced by the authentication property
+     concatenated with this optional artifactRoot path forms the artifact
+     source location where the artifacts are expected to be found.
     :type artifact_root: str
     :param authentication: Required. The authentication method to use to
      access the artifact source.

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/artifact_source_py3.py

@@ -13,7 +13,7 @@
 
 
 class ArtifactSource(TrackedResource):
-    """The resource that define the source location where the artifacts are
+    """The resource that defines the source location where the artifacts are
     located.
 
     Variables are only populated by the server, and will be ignored when
@@ -35,8 +35,13 @@ class ArtifactSource(TrackedResource):
     :type location: str
     :param source_type: Required. The type of artifact source used.
     :type source_type: str
-    :param artifact_root: The root folder under which all artifacts for all
-     environments are expected to be organized.
+    :param artifact_root: The path from the location that the 'authentication'
+     property [say, a SAS URI to the blob container] refers to, to the location
+     of the artifacts. This can be used to differentiate different versions of
+     the artifacts. Or, different types of artifacts like binaries or
+     templates. The location referenced by the authentication property
+     concatenated with this optional artifactRoot path forms the artifact
+     source location where the artifacts are expected to be found.
     :type artifact_root: str
     :param authentication: Required. The authentication method to use to
      access the artifact source.

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/pre_post_step.py

@@ -17,7 +17,7 @@ class PrePostStep(Model):
 
     All required parameters must be populated in order to send to Azure.
 
-    :param step_id: Required. The reference to the ARM resource Id of a step.
+    :param step_id: Required. The resource Id of the step to be run.
     :type step_id: str
     """
 

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/pre_post_step_py3.py

@@ -17,7 +17,7 @@ class PrePostStep(Model):
 
     All required parameters must be populated in order to send to Azure.
 
-    :param step_id: Required. The reference to the ARM resource Id of a step.
+    :param step_id: Required. The resource Id of the step to be run.
     :type step_id: str
     """
 

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout.py

@@ -13,7 +13,7 @@
 
 
 class Rollout(TrackedResource):
-    """Defines the rollout resource.
+    """Defines the rollout.
 
     Variables are only populated by the server, and will be ignored when
     sending a request.
@@ -36,13 +36,14 @@ class Rollout(TrackedResource):
     :type identity: ~azure.mgmt.deploymentmanager.models.Identity
     :param build_version: Required. The version of the build being deployed.
     :type build_version: str
-    :param artifact_source_id: The reference to the ARM resource Id where the
-     payload is located.
+    :param artifact_source_id: The reference to the artifact source resource
+     Id where the payload is located.
     :type artifact_source_id: str
-    :param target_service_topology_id: Required. The reference to the resource
-     Id of the service topology from which services are chosen to be deployed.
+    :param target_service_topology_id: Required. The resource Id of the
+     service topology from which service units are being referenced in step
+     groups to be deployed.
     :type target_service_topology_id: str
-    :param step_groups: Required. The list of steps that define the
+    :param step_groups: Required. The list of step groups that define the
      orchestration.
     :type step_groups: list[~azure.mgmt.deploymentmanager.models.Step]
     :ivar status: The current status of the rollout.
@@ -53,8 +54,7 @@ class Rollout(TrackedResource):
     :ivar operation_info: Operational information of the rollout.
     :vartype operation_info:
      ~azure.mgmt.deploymentmanager.models.RolloutOperationInfo
-    :ivar services: Set of detailed step result information on target resource
-     groups.
+    :ivar services: The detailed information on the services being deployed.
     :vartype services: list[~azure.mgmt.deploymentmanager.models.Service]
     """
 

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_operation_info.py

@@ -18,11 +18,13 @@ class RolloutOperationInfo(Model):
     Variables are only populated by the server, and will be ignored when
     sending a request.
 
-    :ivar retry_attempt: The ordinal count of retry attempt. 0 if no retries
-     of the rollout have been performed.
+    :ivar retry_attempt: The ordinal count of the number of retry attempts on
+     a rollout. 0 if no retries of the rollout have been performed. If the
+     rollout is updated with a PUT, this count is reset to 0.
     :vartype retry_attempt: int
-    :ivar skip_succeeded_on_retry: True if skipping all successful steps in
-     the given retry attempt was chosen. False otherwise.
+    :ivar skip_succeeded_on_retry: True, if all steps that succeeded on the
+     previous run/attempt were chosen to be skipped in this retry attempt.
+     False, otherwise.
     :vartype skip_succeeded_on_retry: bool
     :ivar start_time: The start time of the rollout in UTC.
     :vartype start_time: datetime

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_operation_info_py3.py

@@ -18,11 +18,13 @@ class RolloutOperationInfo(Model):
     Variables are only populated by the server, and will be ignored when
     sending a request.
 
-    :ivar retry_attempt: The ordinal count of retry attempt. 0 if no retries
-     of the rollout have been performed.
+    :ivar retry_attempt: The ordinal count of the number of retry attempts on
+     a rollout. 0 if no retries of the rollout have been performed. If the
+     rollout is updated with a PUT, this count is reset to 0.
     :vartype retry_attempt: int
-    :ivar skip_succeeded_on_retry: True if skipping all successful steps in
-     the given retry attempt was chosen. False otherwise.
+    :ivar skip_succeeded_on_retry: True, if all steps that succeeded on the
+     previous run/attempt were chosen to be skipped in this retry attempt.
+     False, otherwise.
     :vartype skip_succeeded_on_retry: bool
     :ivar start_time: The start time of the rollout in UTC.
     :vartype start_time: datetime

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_properties_model.py

@@ -26,8 +26,7 @@ class RolloutPropertiesModel(Model):
     :ivar operation_info: Operational information of the rollout.
     :vartype operation_info:
      ~azure.mgmt.deploymentmanager.models.RolloutOperationInfo
-    :ivar services: Set of detailed step result information on target resource
-     groups.
+    :ivar services: The detailed information on the services being deployed.
     :vartype services: list[~azure.mgmt.deploymentmanager.models.Service]
     """
 

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_properties_model_py3.py

@@ -26,8 +26,7 @@ class RolloutPropertiesModel(Model):
     :ivar operation_info: Operational information of the rollout.
     :vartype operation_info:
      ~azure.mgmt.deploymentmanager.models.RolloutOperationInfo
-    :ivar services: Set of detailed step result information on target resource
-     groups.
+    :ivar services: The detailed information on the services being deployed.
     :vartype services: list[~azure.mgmt.deploymentmanager.models.Service]
     """
 

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_py3.py

@@ -13,7 +13,7 @@
 
 
 class Rollout(TrackedResource):
-    """Defines the rollout resource.
+    """Defines the rollout.
 
     Variables are only populated by the server, and will be ignored when
     sending a request.
@@ -36,13 +36,14 @@ class Rollout(TrackedResource):
     :type identity: ~azure.mgmt.deploymentmanager.models.Identity
     :param build_version: Required. The version of the build being deployed.
     :type build_version: str
-    :param artifact_source_id: The reference to the ARM resource Id where the
-     payload is located.
+    :param artifact_source_id: The reference to the artifact source resource
+     Id where the payload is located.
     :type artifact_source_id: str
-    :param target_service_topology_id: Required. The reference to the resource
-     Id of the service topology from which services are chosen to be deployed.
+    :param target_service_topology_id: Required. The resource Id of the
+     service topology from which service units are being referenced in step
+     groups to be deployed.
     :type target_service_topology_id: str
-    :param step_groups: Required. The list of steps that define the
+    :param step_groups: Required. The list of step groups that define the
      orchestration.
     :type step_groups: list[~azure.mgmt.deploymentmanager.models.Step]
     :ivar status: The current status of the rollout.
@@ -53,8 +54,7 @@ class Rollout(TrackedResource):
     :ivar operation_info: Operational information of the rollout.
     :vartype operation_info:
      ~azure.mgmt.deploymentmanager.models.RolloutOperationInfo
-    :ivar services: Set of detailed step result information on target resource
-     groups.
+    :ivar services: The detailed information on the services being deployed.
     :vartype services: list[~azure.mgmt.deploymentmanager.models.Service]
     """
 

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_request.py

@@ -13,7 +13,7 @@
 
 
 class RolloutRequest(TrackedResource):
-    """Defines the resource format for creating a rollout.
+    """Defines the PUT rollout request body.
 
     Variables are only populated by the server, and will be ignored when
     sending a request.
@@ -36,13 +36,14 @@ class RolloutRequest(TrackedResource):
     :type identity: ~azure.mgmt.deploymentmanager.models.Identity
     :param build_version: Required. The version of the build being deployed.
     :type build_version: str
-    :param artifact_source_id: The reference to the ARM resource Id where the
-     payload is located.
+    :param artifact_source_id: The reference to the artifact source resource
+     Id where the payload is located.
     :type artifact_source_id: str
-    :param target_service_topology_id: Required. The reference to the resource
-     Id of the service topology from which services are chosen to be deployed.
+    :param target_service_topology_id: Required. The resource Id of the
+     service topology from which service units are being referenced in step
+     groups to be deployed.
     :type target_service_topology_id: str
-    :param step_groups: Required. The list of steps that define the
+    :param step_groups: Required. The list of step groups that define the
      orchestration.
     :type step_groups: list[~azure.mgmt.deploymentmanager.models.Step]
     """

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_request_py3.py

@@ -13,7 +13,7 @@
 
 
 class RolloutRequest(TrackedResource):
-    """Defines the resource format for creating a rollout.
+    """Defines the PUT rollout request body.
 
     Variables are only populated by the server, and will be ignored when
     sending a request.
@@ -36,13 +36,14 @@ class RolloutRequest(TrackedResource):
     :type identity: ~azure.mgmt.deploymentmanager.models.Identity
     :param build_version: Required. The version of the build being deployed.
     :type build_version: str
-    :param artifact_source_id: The reference to the ARM resource Id where the
-     payload is located.
+    :param artifact_source_id: The reference to the artifact source resource
+     Id where the payload is located.
     :type artifact_source_id: str
-    :param target_service_topology_id: Required. The reference to the resource
-     Id of the service topology from which services are chosen to be deployed.
+    :param target_service_topology_id: Required. The resource Id of the
+     service topology from which service units are being referenced in step
+     groups to be deployed.
     :type target_service_topology_id: str
-    :param step_groups: Required. The list of steps that define the
+    :param step_groups: Required. The list of step groups that define the
      orchestration.
     :type step_groups: list[~azure.mgmt.deploymentmanager.models.Step]
     """

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_step.py

@@ -20,8 +20,7 @@ class RolloutStep(Model):
 
     All required parameters must be populated in order to send to Azure.
 
-    :param name: Required. Name of the step as specified in the rollout
-     specification input artifact.
+    :param name: Required. Name of the step.
     :type name: str
     :ivar status: Current state of the step.
     :vartype status: str
@@ -30,8 +29,8 @@ class RolloutStep(Model):
     :ivar operation_info: Detailed information of specific action execution.
     :vartype operation_info:
      ~azure.mgmt.deploymentmanager.models.StepOperationInfo
-    :ivar resource_operations: Set of resource operations that were performed
-     on the Azure resource that the action acted upon.
+    :ivar resource_operations: Set of resource operations that were performed,
+     if any, on an Azure resource.
     :vartype resource_operations:
      list[~azure.mgmt.deploymentmanager.models.ResourceOperation]
     :ivar messages: Supplementary informative messages during rollout.

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/rollout_step_py3.py

@@ -20,8 +20,7 @@ class RolloutStep(Model):
 
     All required parameters must be populated in order to send to Azure.
 
-    :param name: Required. Name of the step as specified in the rollout
-     specification input artifact.
+    :param name: Required. Name of the step.
     :type name: str
     :ivar status: Current state of the step.
     :vartype status: str
@@ -30,8 +29,8 @@ class RolloutStep(Model):
     :ivar operation_info: Detailed information of specific action execution.
     :vartype operation_info:
      ~azure.mgmt.deploymentmanager.models.StepOperationInfo
-    :ivar resource_operations: Set of resource operations that were performed
-     on the Azure resource that the action acted upon.
+    :ivar resource_operations: Set of resource operations that were performed,
+     if any, on an Azure resource.
     :vartype resource_operations:
      list[~azure.mgmt.deploymentmanager.models.ResourceOperation]
     :ivar messages: Supplementary informative messages during rollout.

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/sas_authentication.py

@@ -13,15 +13,16 @@
 
 
 class SasAuthentication(Authentication):
-    """Defines the authentication properties to access the artifacts using Azure
-    Storage SAS URI.
+    """Defines the properties to access the artifacts using an Azure Storage SAS
+    URI.
 
     All required parameters must be populated in order to send to Azure.
 
     :param type: Required. Constant filled by server.
     :type type: str
-    :param sas_uri: Required. The complete SAS URI to the location of the
-     artifacts.
+    :param sas_uri: Required. The SAS URI to the Azure Storage blob container.
+     Any offset from the root of the container to where the artifacts are
+     located can be defined in the artifactRoot.
     :type sas_uri: str
     """
 

azure-mgmt-deploymentmanager/azure/mgmt/deploymentmanager/models/sas_authentication_py3.py

@@ -13,15 +13,16 @@
 
 
 class SasAuthentication(Authentication):
-    """Defines the authentication properties to access the artifacts using Azure
-    Storage SAS URI.
+    """Defines the properties to access the artifacts using an Azure Storage SAS
+    URI.
 
     All required parameters must be populated in order to send to Azure.
 
     :param type: Required. Constant filled by server.
     :type type: str
-    :param sas_uri: Required. The complete SAS URI to the location of the
-     artifacts.
+    :param sas_uri: Required. The SAS URI to the Azure Storage blob container.
+     Any offset from the root of the container to where the artifacts are
+     located can be defined in the artifactRoot.
     :type sas_uri: str
     """