Environment Versions - Create Or Update

Crea o aggiorna un ambienteVersion.

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

Parametri dell'URI

Name In Required Type Description
name
path True
  • string

Nome di EnvironmentVersion. Questo valore fa distinzione tra maiuscole e minuscole.

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

resourceGroupName
path True
  • string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.

subscriptionId
path True
  • string

ID della sottoscrizione di destinazione.

version
path True
  • string

Versione di EnvironmentVersion.

workspaceName
path True
  • string

Nome dell'area di lavoro di Azure Machine Learning.

api-version
query True
  • string

Versione dell'API da usare per questa operazione.

Corpo della richiesta

Name Required Type Description
properties True

[Obbligatorio] Attributi aggiuntivi dell'entità.

Risposte

Name Type Description
200 OK

Operazione riuscita

201 Created

Data di creazione

Other Status Codes

Errore

Esempio

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"
  }
}

Definizioni

BuildContext

Impostazioni di configurazione per il contesto di compilazione Docker

createdByType

Tipo di identità che ha creato la risorsa.

EnvironmentType

Il tipo di ambiente è creato o curato dal servizio Azure ML

EnvironmentVersion

Dettagli della versione dell'ambiente.

EnvironmentVersionResource

Busta di risorse di Azure Resource Manager.

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

InferenceContainerProperties
OperatingSystemType

Tipo di sistema operativo.

Route
systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

BuildContext

Impostazioni di configurazione per il contesto di compilazione Docker

Name Type Default Value Description
contextUri
  • string

[Obbligatorio] URI del contesto di compilazione Docker usato per compilare l'immagine. Supporta gli URI BLOB nella creazione dell'ambiente e può restituire BLOB o URI Git.

dockerfilePath
  • string
Dockerfile

Percorso del Dockerfile nel contesto di compilazione.

createdByType

Tipo di identità che ha creato la risorsa.

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

EnvironmentType

Il tipo di ambiente è creato o curato dal servizio Azure ML

Name Type Description
Curated
  • string
UserCreated
  • string

EnvironmentVersion

Dettagli della versione dell'ambiente.

Name Type Default Value Description
build

Impostazioni di configurazione per il contesto di compilazione Docker.

condaFile
  • string

File di configurazione standard usato da Conda che consente di installare qualsiasi tipo di pacchetto, inclusi pacchetti Python, R e C++.

description
  • string

Testo della descrizione dell'asset.

environmentType

Il tipo di ambiente è gestito dall'utente o curato dal servizio Azure ML

image
  • string

Nome dell'immagine che verrà usata per l'ambiente.

inferenceConfig

Definisce la configurazione specifica per l'inferenza.

isAnonymous
  • boolean
False

Se la versione del nome viene generata dal sistema (registrazione anonima).

isArchived
  • boolean
False

L'asset è archiviato?

osType Linux

Tipo di sistema operativo dell'ambiente.

properties
  • object

Dizionario delle proprietà asset.

tags
  • object

Dizionario tag. I tag possono essere aggiunti, rimossi e aggiornati.

EnvironmentVersionResource

Busta di risorse di Azure Resource Manager.

Name Type Description
id
  • string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

nome della risorsa.

properties

[Obbligatorio] Attributi aggiuntivi dell'entità.

systemData

Metadati di Azure Resource Manager contenenti le informazioni createBy e modificateBy.

type
  • string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Name Type Description
info
  • object

Informazioni aggiuntive.

type
  • string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Name Type Description
additionalInfo

Informazioni aggiuntive sull'errore.

code
  • string

Codice di errore.

details

Dettagli dell'errore.

message
  • string

Messaggio di errore.

target
  • string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Name Type Description
error

Oggetto error.

InferenceContainerProperties

Name Type Description
livenessRoute

Route per controllare la livezza del contenitore del server di inferenza.

readinessRoute

Route per verificare la conformità del contenitore del server di inferenza.

scoringRoute

Porta a cui inviare le richieste di assegnazione dei punteggi all'interno del contenitore del server di inferenza.

OperatingSystemType

Tipo di sistema operativo.

Name Type Description
Linux
  • string
Windows
  • string

Route

Name Type Description
path
  • string

[Obbligatorio] Percorso della route.

port
  • integer

[Obbligatorio] Porta per la route.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Name Type Description
createdAt
  • string

Timestamp della creazione di risorse (UTC).

createdBy
  • string

Identità che ha creato la risorsa.

createdByType

Tipo di identità che ha creato la risorsa.

lastModifiedAt
  • string

Timestamp dell'ultima modifica della risorsa (UTC)

lastModifiedBy
  • string

Identità che ha modificato l'ultima risorsa.

lastModifiedByType

Tipo di identità che ha modificato l'ultima risorsa.