Environment Versions - Create Or Update

Crea o actualiza environmentVersion.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.MachineLearningServices/workspaces/{workspaceName}/environments/{name}/versions/{version}?api-version=2022-06-01-preview

Parámetros de identificador URI

Name In Required Type Description
name
path True
  • string

Nombre de EnvironmentVersion. Distingue mayúsculas de minúsculas.

Regex pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,254}$

resourceGroupName
path True
  • string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True
  • string

Identificador de la suscripción de destino.

version
path True
  • string

Versión de EnvironmentVersion.

workspaceName
path True
  • string

Nombre del área de trabajo de Azure Machine Learning.

api-version
query True
  • string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Name Required Type Description
properties True

[Obligatorio] Atributos adicionales de la entidad.

Respuestas

Name Type Description
200 OK

Correcto

201 Created

Creado

Other Status Codes

Error

Ejemplos

CreateOrUpdate Environment Version.

Sample Request

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/test-rg/providers/Microsoft.MachineLearningServices/workspaces/my-aml-workspace/environments/string/versions/string?api-version=2022-06-01-preview

{
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isAnonymous": false,
    "image": "docker.io/tensorflow/serving:latest",
    "condaFile": "string",
    "build": {
      "contextUri": "https://storage-account.blob.core.windows.net/azureml/DockerBuildContext/95ddede6b9b8c4e90472db3acd0a8d28/",
      "dockerfilePath": "prod/Dockerfile"
    },
    "inferenceConfig": {
      "livenessRoute": {
        "path": "string",
        "port": 1
      },
      "readinessRoute": {
        "path": "string",
        "port": 1
      },
      "scoringRoute": {
        "path": "string",
        "port": 1
      }
    }
  }
}

Sample Response

{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isAnonymous": false,
    "environmentType": "Curated",
    "image": "docker.io/tensorflow/serving:latest",
    "condaFile": "string",
    "build": {
      "contextUri": "https://storage-account.blob.core.windows.net/azureml/DockerBuildContext/95ddede6b9b8c4e90472db3acd0a8d28/",
      "dockerfilePath": "prod/Dockerfile"
    },
    "inferenceConfig": {
      "livenessRoute": {
        "path": "string",
        "port": 1
      },
      "readinessRoute": {
        "path": "string",
        "port": 1
      },
      "scoringRoute": {
        "path": "string",
        "port": 1
      }
    }
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}
{
  "id": "string",
  "name": "string",
  "type": "string",
  "properties": {
    "description": "string",
    "tags": {
      "string": "string"
    },
    "properties": {
      "string": "string"
    },
    "isAnonymous": false,
    "environmentType": "Curated",
    "image": "docker.io/tensorflow/serving:latest",
    "condaFile": "string",
    "build": {
      "contextUri": "https://storage-account.blob.core.windows.net/azureml/DockerBuildContext/95ddede6b9b8c4e90472db3acd0a8d28/",
      "dockerfilePath": "prod/Dockerfile"
    },
    "inferenceConfig": {
      "livenessRoute": {
        "path": "string",
        "port": 1
      },
      "readinessRoute": {
        "path": "string",
        "port": 1
      },
      "scoringRoute": {
        "path": "string",
        "port": 1
      }
    }
  },
  "systemData": {
    "createdAt": "2020-01-01T12:34:56.999Z",
    "createdBy": "string",
    "createdByType": "User",
    "lastModifiedAt": "2020-01-01T12:34:56.999Z",
    "lastModifiedBy": "string",
    "lastModifiedByType": "User"
  }
}

Definiciones

BuildContext

Opciones de configuración para el contexto de compilación de Docker

createdByType

Tipo de identidad que creó el recurso.

EnvironmentType

El tipo de entorno es creado por el usuario o mantenido por el servicio Azure ML.

EnvironmentVersion

Detalles de la versión del entorno.

EnvironmentVersionResource

Sobre de recursos de Azure Resource Manager.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

InferenceContainerProperties
OperatingSystemType

El tipo de sistema operativo.

Route
systemData

Metadatos relacionados con la creación y la última modificación del recurso.

BuildContext

Opciones de configuración para el contexto de compilación de Docker

Name Type Default Value Description
contextUri
  • string

[Obligatorio] URI del contexto de compilación de Docker usado para compilar la imagen. Admite URI de blob en la creación del entorno y puede devolver URI de blob o Git.

dockerfilePath
  • string
Dockerfile

Ruta de acceso al Dockerfile en el contexto de compilación.

createdByType

Tipo de identidad que creó el recurso.

Name Type Description
Application
  • string
Key
  • string
ManagedIdentity
  • string
User
  • string

EnvironmentType

El tipo de entorno es creado por el usuario o mantenido por el servicio Azure ML.

Name Type Description
Curated
  • string
UserCreated
  • string

EnvironmentVersion

Detalles de la versión del entorno.

Name Type Default Value Description
build

Opciones de configuración para el contexto de compilación de Docker.

condaFile
  • string

Archivo de configuración estándar usado por Conda que permite instalar cualquier tipo de paquete, incluidos los paquetes de Python, R y C/C++.

description
  • string

Texto de descripción del recurso.

environmentType

El tipo de entorno es administrado por el usuario o mantenido por el servicio Azure ML.

image
  • string

Nombre de la imagen que se usará para el entorno.

inferenceConfig

Define la configuración específica de la inferencia.

isAnonymous
  • boolean
False

Si la versión del nombre se genera por el sistema (registro anónimo).

isArchived
  • boolean
False

¿Se archiva el recurso?

osType Linux

Tipo de sistema operativo del entorno.

properties
  • object

Diccionario de propiedades de recurso.

tags
  • object

Diccionario de etiquetas. Las etiquetas se pueden agregar, quitar y actualizar.

EnvironmentVersionResource

Sobre de recursos de Azure Resource Manager.

Name Type Description
id
  • string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Nombre del recurso.

properties

[Obligatorio] Atributos adicionales de la entidad.

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

type
  • string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Name Type Description
info
  • object

Información adicional.

type
  • string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Name Type Description
additionalInfo

Información adicional del error.

code
  • string

Código de error.

details

Los detalles del error.

message
  • string

El mensaje de error.

target
  • string

Destino del error.

ErrorResponse

Respuesta de error

Name Type Description
error

Objeto de error.

InferenceContainerProperties

Name Type Description
livenessRoute

Ruta para comprobar la ejecución del contenedor del servidor de inferencia.

readinessRoute

Ruta para comprobar la preparación del contenedor del servidor de inferencia.

scoringRoute

Puerto al que se envían las solicitudes de puntuación, dentro del contenedor del servidor de inferencia.

OperatingSystemType

El tipo de sistema operativo.

Name Type Description
Linux
  • string
Windows
  • string

Route

Name Type Description
path
  • string

[Obligatorio] Ruta de acceso de la ruta.

port
  • integer

[Obligatorio] Puerto de la ruta.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Name Type Description
createdAt
  • string

Marca de tiempo de creación de recursos (UTC).

createdBy
  • string

Identidad que creó el recurso.

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt
  • string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy
  • string

Identidad que modificó por última vez el recurso.

lastModifiedByType

Tipo de identidad que modificó por última vez el recurso.