Environment Versions - Create Or Update

Erstellt oder aktualisiert eine 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

URI-Parameter

Name In Required Type Description
name
path True
  • string

Name von EnvironmentVersion. Hierbei muss die Groß-/Kleinschreibung beachtet werden.

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

resourceGroupName
path True
  • string

Der Name der Ressourcengruppe. Für den Namen wird die Groß-/Kleinschreibung nicht beachtet.

subscriptionId
path True
  • string

Hierbei handelt es sich um die ID des Zielabonnements.

version
path True
  • string

Version von EnvironmentVersion.

workspaceName
path True
  • string

Name des Azure Machine Learning-Arbeitsbereichs.

api-version
query True
  • string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Anforderungstext

Name Required Type Description
properties True

[Erforderlich] Zusätzliche Attribute der Entität.

Antworten

Name Type Description
200 OK

Erfolg

201 Created

Erstellt

Other Status Codes

Fehler

Beispiele

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

Definitionen

BuildContext

Konfigurationseinstellungen für Docker-Buildkontext

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

EnvironmentType

Der Umgebungstyp wird entweder vom Azure ML-Dienst erstellt oder kuratiert.

EnvironmentVersion

Details zur Umgebungsversion.

EnvironmentVersionResource

Azure Resource Manager Ressourcenumschlag.

ErrorAdditionalInfo

Der Fehler beim Ressourcenverwaltungsfehler.

ErrorDetail

Die Fehlerdetails.

ErrorResponse

Fehlerantwort

InferenceContainerProperties
OperatingSystemType

Die Art des Betriebssystems.

Route
systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

BuildContext

Konfigurationseinstellungen für Docker-Buildkontext

Name Type Default Value Description
contextUri
  • string

[Erforderlich] URI des Docker-Buildkontexts, der zum Erstellen des Images verwendet wird. Unterstützt Blob-URIs für die Umgebungserstellung und kann Blob- oder Git-URIs zurückgeben.

dockerfilePath
  • string
Dockerfile

Pfad zum Dockerfile im Buildkontext.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

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

EnvironmentType

Der Umgebungstyp wird entweder vom Azure ML-Dienst erstellt oder kuratiert.

Name Type Description
Curated
  • string
UserCreated
  • string

EnvironmentVersion

Details zur Umgebungsversion.

Name Type Default Value Description
build

Konfigurationseinstellungen für Docker-Buildkontext.

condaFile
  • string

Standardkonfigurationsdatei, die von Conda verwendet wird, mit der Sie alle Arten von Paketen installieren können, einschließlich Python, R und C++-Pakete.

description
  • string

Der Text der Ressourcenbeschreibung.

environmentType

Der Umgebungstyp wird entweder vom Azure ML-Dienst verwaltet oder kuratiert.

image
  • string

Name des Bilds, das für die Umgebung verwendet wird.

inferenceConfig

Definiert die konfigurationsspezifisch für die Inference.

isAnonymous
  • boolean
False

Wenn die Nameversion system generiert wird (anonyme Registrierung).

isArchived
  • boolean
False

Ist die Ressource archiviert?

osType Linux

Der Betriebssystemtyp der Umgebung.

properties
  • object

Das Objekteigenschaftsverzeichnis.

tags
  • object

Tagwörterbuch. Tags können hinzugefügt, entfernt und aktualisiert werden.

EnvironmentVersionResource

Azure Resource Manager Ressourcenumschlag.

Name Type Description
id
  • string

Vollqualifizierte Ressourcen-ID für die Ressource. Ex - /abonnements/{subscriptionId}/resourceGroups/{resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

name
  • string

Der Name der Ressource

properties

[Erforderlich] Zusätzliche Attribute der Entität.

systemData

Azure Resource Manager-Metadaten mit createdBy- und modifiedBy-Informationen.

type
  • string

Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ErrorAdditionalInfo

Der Fehler beim Ressourcenverwaltungsfehler.

Name Type Description
info
  • object

Die zusätzlichen Informationen.

type
  • string

Der zusätzliche Infotyp.

ErrorDetail

Die Fehlerdetails.

Name Type Description
additionalInfo

Der Fehler, der zusätzliche Informationen enthält.

code
  • string

Der Fehlercode.

details

Die Fehlerdetails.

message
  • string

Die Fehlermeldung.

target
  • string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Type Description
error

Das Fehlerobjekt.

InferenceContainerProperties

Name Type Description
livenessRoute

Die Route, um die Liveität des Servercontainers zu überprüfen.

readinessRoute

Die Route, um die Bereitschaft des Inference-Servercontainers zu überprüfen.

scoringRoute

Der Port, um die Bewertungsanforderungen innerhalb des Servercontainers zu senden.

OperatingSystemType

Die Art des Betriebssystems.

Name Type Description
Linux
  • string
Windows
  • string

Route

Name Type Description
path
  • string

[Erforderlich] Der Pfad für die Route.

port
  • integer

[Erforderlich] Der Port für die Route.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Type Description
createdAt
  • string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy
  • string

Die Identität, die die Ressource erstellt hat.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt
  • string

Zeitstempel der letzten Änderung der Ressource (UTC)

lastModifiedBy
  • string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.