在AWS SageMaker ModelPackageGroup中更新带评估指标的模型时如何保留版本号

问题背景 #

使用AWS SageMaker Model Registry时，训练流水线在指定ModelPackageGroupName下创建并注册模型包，后续通过独立评估流水线生成评估指标。当前做法是删除现有模型包版本后重建以整合指标，但SageMaker自动递增的版本号不会复用已删除的版本（如删除版本2后，新创建的模型包会直接用版本3）。希望了解是否能复用版本号、无需新建版本更新指标的方法，以及版本精确管理的最佳实践。

一、复用已删除版本号的可行性 #

SageMaker Model Registry的版本号是全局递增且不可复用的，这是服务的默认设计，没有办法强制系统复用已删除的版本号。无论是否删除旧版本，新创建的模型包都会基于该ModelPackageGroupName下的历史最高版本号加1生成新版本号。

二、无需新建版本更新评估指标的方案 #

直接使用UpdateModelPackage API更新已存在模型包的评估指标，无需删除重建：

• 通过目标模型包的ARN调用该API，更新ModelMetrics字段，将评估流水线生成的指标直接写入原模型包。
• AWS CLI示例命令：

  aws sagemaker update-model-package \
      --model-package-arn "arn:aws:sagemaker:region:account-id:model-package/group-name/version-number" \
      --model-metrics '{"ModelQuality": {"Statistics": {"ContentType": "application/json", "S3Uri": "s3://your-bucket/model-quality-stats.json"}, "Constraints": {"ContentType": "application/json", "S3Uri": "s3://your-bucket/model-quality-constraints.json"}}}'
  

• 该方式既能保留原版本号，又能完成指标更新，完全规避删除重建的操作。

三、模型包版本精确管理的最佳实践 #

• 优先用API更新指标：这是最直接的方案，既保留SageMaker的自动版本控制逻辑，又能灵活补充后续生成的评估数据，无需改动版本号。
• 添加自定义语义版本标签：若需创建新版本（如模型本身迭代），可在模型包的Description或MetadataProperties中添加自定义语义版本（如v1.0.1、v1.0.2），配合系统自动分配的版本号使用，方便业务侧识别版本含义，同时保留系统的版本递增逻辑。
• 归档而非删除旧版本：除非是临时测试版本，否则尽量保留历史版本以追踪迭代轨迹；若需标记版本废弃，可通过UpdateModelPackage将其状态设置为Archived，而非直接删除，避免版本号断层。

内容的提问来源于stack exchange，提问作者Martak39