Merge pull request #44171 from keerthiadu/patch-1

 update inference config schema; add reference to environment.

Author: ktoliver

includes/machine-learning-service-inference-config.md

@@ -1,5 +1,5 @@
 ---
-author: larryfr
+author: Blackmist
 ms.service: machine-learning
 ms.topic: include
 ms.date: 11/06/2019
@@ -11,15 +11,16 @@ The entries in the `inferenceconfig.json` document map to the parameters for the
 | JSON entity | Method parameter | Description |
 | ----- | ----- | ----- |
 | `entryScript` | `entry_script` | Path to a local file that contains the code to run for the image. |
-| `runtime` | `runtime` | Which runtime to use for the image. Current supported runtimes are `spark-py` and `python`. |
-| `condaFile` | `conda_file` | Optional. Path to a local file that contains a Conda environment definition to use for the image. |
-| `extraDockerFileSteps` | `extra_docker_file_steps` | Optional. Path to a local file that contains additional Docker steps to run when setting up the image. |
+| `runtime` | `runtime` | Optional. Which runtime to use for the image. Current supported runtimes are `spark-py` and `python`. If `environment` is set, this gets ignored. |
+| `condaFile` | `conda_file` | Optional. Path to a local file that contains a Conda environment definition to use for the image.  If `environment` is set, this gets ignored. |
+| `extraDockerFileSteps` | `extra_docker_file_steps` | Optional. Path to a local file that contains additional Docker steps to run when setting up the image.  If `environment` is set, this gets ignored.|
 | `sourceDirectory` | `source_directory` | Optional. Path to folders that contain all files to create the image. |
-| `enableGpu` | `enable_gpu` | Optional. Whether to enable GPU support in the image. The GPU image must be used on an Azure service, like Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines, and Azure Kubernetes Service. The default is False. |
-| `baseImage` | `base_image` | Optional. Custom image to be used as a base image. If no base image is provided, the image will be based on the provided runtime parameter. |
-| `baseImageRegistry` | `base_image_registry` | Optional. Image registry that contains the base image. |
-| `cudaVersion` | `cuda_version` | Optional. Version of CUDA to install for images that need GPU support. The GPU image must be used on an Azure service, like Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines, and Azure Kubernetes Service. Supported versions are 9.0, 9.1, and 10.0. If `enable_gpu` is set, the default is 9.1. |
-| `description` | `description` | A description for the image. |
+| `enableGpu` | `enable_gpu` | Optional. Whether to enable GPU support in the image. The GPU image must be used on an Azure service, like Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines, and Azure Kubernetes Service. The default is False. If `environment` is set, this gets ignored.|
+| `baseImage` | `base_image` | Optional. Custom image to be used as a base image. If no base image is provided, the image will be based on the provided runtime parameter. If `environment` is set, this gets ignored. |
+| `baseImageRegistry` | `base_image_registry` | Optional. Image registry that contains the base image. If `environment` is set, this gets ignored.|
+| `cudaVersion` | `cuda_version` | Optional. Version of CUDA to install for images that need GPU support. The GPU image must be used on an Azure service, like Azure Container Instances, Azure Machine Learning Compute, Azure Virtual Machines, and Azure Kubernetes Service. Supported versions are 9.0, 9.1, and 10.0. If `enable_gpu` is set, the default is 9.1. If `environment` is set, this gets ignored. |
+| `description` | `description` | A description for the image. If `environment` is set, this gets ignored.  |
+| `environment` | `environment` | Optional.  Azure Machine Learning [environment](https://docs.microsoft.com/python/api/azureml-core/azureml.core.environment.environment?view=azure-ml-py).|
 
 The following JSON is an example inference configuration for use with the CLI:
 
@@ -34,4 +35,32 @@ The following JSON is an example inference configuration for use with the CLI:
     "baseImage": null,
     "baseImageRegistry": null
 }
-```
+```
+
+The following JSON is an example inference configuration that uses an existing Azure Machine Learning [environment](https://docs.microsoft.com/python/api/azureml-core/azureml.core.environment.environment?view=azure-ml-py) with a specific version for use with the CLI:
+
+```json
+{
+    "entryScript": "score.py",
+    "environment":{
+        "name": "myenv",
+        "version": "1"
+    },
+    "condaFile": "myenv.yml",
+    "sourceDirectory": null
+}
+```
+
+The following JSON is an example inference configuration that uses an existing Azure Machine Learning [environment](https://docs.microsoft.com/python/api/azureml-core/azureml.core.environment.environment?view=azure-ml-py) with latest version for use with the CLI:
+
+```json
+{
+    "entryScript": "score.py",
+    "environment":{
+        "name": "myenv",
+        "version": null
+    },
+    "condaFile": "myenv.yml",
+    "sourceDirectory": null
+}
+```