# Docker Registry Paths and Example Code
<a name="sagemaker-algo-docker-registry-paths"></a>

The following topics list the Docker registry path and other parameters for each of the Amazon SageMaker AI provided algorithms and Deep Learning Containers (DLC). For more information, see [Use Pre-built SageMaker Docker images](https://docs.amazonaws.cn/sagemaker/latest/dg/docker-containers-prebuilt.html).

Use the path as follows:
+ To create a training job ([create\_training\_job](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_training_job)), specify the Docker registry path (`TrainingImage`) and the training input mode (`TrainingInputMode`) for the training image. You create a training job to train a model using a specific dataset.
+ To create a model ([create\_model](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/sagemaker.html#SageMaker.Client.create_model)), specify the Docker registry path (`Image`) for the inference image (`PrimaryContainer Image`). SageMaker AI launches machine learning compute instances that are based on the endpoint configuration and deploys the model, which includes the artifacts (the result of model training).
+ To create a model monitor, select the Amazon Region, then select **Model Monitor (algorithm)**. For more information, see [Amazon SageMaker AI Model Monitor prebuilt container](https://docs.amazonaws.cn/sagemaker/latest/dg/model-monitor-pre-built-container.html).

**Note**  
Pre-built container images are owned by SageMaker AI, and in some cases include proprietary code. Capabilities such as training and processing jobs, batch transform, and real-time inference use service-owned credentials to pull and run images on managed SageMaker AI instances. Because customer credentials aren't used, any Amazon IAM policies (including service control policies and resource control policies) that deny Amazon ECR permissions don't prevent the use of pre-built images.

**Note**  
For the registry path, use the `:1` version tag to ensure that you are using a stable version of the algorithm/DLC. You can reliably host a model trained using an image with the `:1` tag on an inference image that has the `:1` tag. Using the `:latest` tag in the registry path provides you with the most up-to-date version of the algorithm/DLC, but might cause problems with backward compatibility. Avoid using the `:latest` tag for production purposes.

**Important**  
When you retrieve the SageMaker AI XGBoost image URI, do not use `:latest` or `:1` for the image URI tag. You must specify one of the [Supported versions](https://docs.amazonaws.cn/sagemaker/latest/dg/xgboost.html#xgboost-supported-versions) to choose the SageMaker AI-managed XGBoost container with the native XGBoost package version that you want to use. To find the package version migrated into the SageMaker AI XGBoost containers, choose your Amazon Web Services Region then navigate to the **XGBoost (algorithm)** section.

To find the registry path, choose the Amazon Region, then choose the algorithm or DLC.

**Topics**
+ [US East (N. Virginia)](ecr-us-east-1.md)
+ [US East (Ohio)](ecr-us-east-2.md)
+ [US West (N. California)](ecr-us-west-1.md)
+ [US West (Oregon)](ecr-us-west-2.md)
+ [Africa (Cape Town)](ecr-af-south-1.md)
+ [Asia Pacific (Hong Kong)](ecr-ap-east-1.md)
+ [Docker Registry Paths and Example Code for (ap-east-2)](ecr-ap-east-2.md)
+ [Asia Pacific (Hyderabad)](ecr-ap-south-2.md)
+ [Asia Pacific (Jakarta)](ecr-ap-southeast-3.md)
+ [Asia Pacific (Malaysia)](ecr-ap-southeast-5.md)
+ [Asia Pacific (Melbourne)](ecr-ap-southeast-4.md)
+ [Asia Pacific (Mumbai)](ecr-ap-south-1.md)
+ [Asia Pacific (Osaka)](ecr-ap-northeast-3.md)
+ [Asia Pacific (Seoul)](ecr-ap-northeast-2.md)
+ [Asia Pacific (Singapore)](ecr-ap-southeast-1.md)
+ [Asia Pacific (Sydney)](ecr-ap-southeast-2.md)
+ [Asia Pacific (Thailand)](ecr-ap-southeast-7.md)
+ [Asia Pacific (Tokyo)](ecr-ap-northeast-1.md)
+ [Canada (Central)](ecr-ca-central-1.md)
+ [Canada West (Calgary)](ecr-ca-west-1.md)
+ [China (Beijing)](ecr-cn-north-1.md)
+ [China (Ningxia)](ecr-cn-northwest-1.md)
+ [Europe (Frankfurt)](ecr-eu-central-1.md)
+ [Europe (Ireland)](ecr-eu-west-1.md)
+ [Europe (London)](ecr-eu-west-2.md)
+ [Europe (Milan)](ecr-eu-south-1.md)
+ [Europe (Paris)](ecr-eu-west-3.md)
+ [Europe (Spain)](ecr-eu-south-2.md)
+ [Europe (Stockholm)](ecr-eu-north-1.md)
+ [Europe (Zurich)](ecr-eu-central-2.md)
+ [Israel (Tel Aviv)](ecr-il-central-1.md)
+ [Mexico (Central)](ecr-mx-central-1.md)
+ [Middle East (Bahrain)](ecr-me-south-1.md)
+ [Middle East (UAE)](ecr-me-central-1.md)
+ [South America (São Paulo)](ecr-sa-east-1.md)
+ [Amazon GovCloud (US-East)](ecr-us-gov-east-1.md)
+ [Amazon GovCloud (US-West)](ecr-us-gov-west-1.md)