Microsoft.MachineLearningServices workspaces/jobs 2021-03-01-preview

Artykuł
11/21/2024

Definicja zasobu Bicep

Typ zasobu obszarów roboczych/zadań można wdrożyć przy użyciu operacji docelowych:

grupy zasobów — zobacz polecenia wdrażania grupy zasobów

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.MachineLearningServices/workspaces/jobs, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.MachineLearningServices/workspaces/jobs@2021-03-01-preview' = {
  name: 'string'
  properties: {
    description: 'string'
    properties: {
      {customized property}: 'string'
    }
    tags: {
      {customized property}: 'string'
    }
    jobType: 'string'
    // For remaining properties, see JobBase objects
  }
}

Obiekty EarlyTerminationPolicy

Ustaw właściwość policyType, aby określić typ obiektu.

W przypadku Banditużyj:

{
  policyType: 'Bandit'
  slackAmount: int
  slackFactor: int
}

W przypadku MedianStopping użyj:

{
  policyType: 'MedianStopping'
}

W przypadku TruncationSelectionużyj:

{
  policyType: 'TruncationSelection'
  truncationPercentage: int
}

Obiekty IdentityConfiguration

Ustaw właściwość identityType, aby określić typ obiektu.

W przypadkuAMLToken użyj:

{
  identityType: 'AMLToken'
}

W przypadku zarządzanychużyj:

{
  clientId: 'string'
  identityType: 'Managed'
  objectId: 'string'
  resourceId: 'string'
}

Obiekty DistributionConfiguration

Ustaw właściwość distributionType, aby określić typ obiektu.

W przypadku Mpi użyj:

{
  distributionType: 'Mpi'
  processCountPerInstance: int
}

W przypadku PyTorch użyj:

{
  distributionType: 'PyTorch'
  processCount: int
}

W przypadku TensorFlow użyj:

{
  distributionType: 'TensorFlow'
  parameterServerCount: int
  workerCount: int
}

Obiekty JobBase

Ustaw właściwość jobType, aby określić typ obiektu.

W przypadkupolecenia użyj:

{
  codeId: 'string'
  command: 'string'
  compute: {
    instanceCount: int
    instanceType: 'string'
    isLocal: bool
    location: 'string'
    properties: {
      {customized property}: 'string'
    }
    target: 'string'
  }
  distribution: {
    distributionType: 'string'
    // For remaining properties, see DistributionConfiguration objects
  }
  environmentId: 'string'
  environmentVariables: {
    {customized property}: 'string'
  }
  experimentName: 'string'
  identity: {
    identityType: 'string'
    // For remaining properties, see IdentityConfiguration objects
  }
  inputDataBindings: {
    {customized property}: {
      dataId: 'string'
      mode: 'string'
      pathOnCompute: 'string'
    }
  }
  jobType: 'Command'
  outputDataBindings: {
    {customized property}: {
      datastoreId: 'string'
      mode: 'string'
      pathOnCompute: 'string'
      pathOnDatastore: 'string'
    }
  }
  priority: int
  timeout: 'string'
}

W przypadkusweep użyj:

{
  algorithm: 'string'
  compute: {
    instanceCount: int
    instanceType: 'string'
    isLocal: bool
    location: 'string'
    properties: {
      {customized property}: 'string'
    }
    target: 'string'
  }
  earlyTermination: {
    delayEvaluation: int
    evaluationInterval: int
    policyType: 'string'
    // For remaining properties, see EarlyTerminationPolicy objects
  }
  experimentName: 'string'
  identity: {
    identityType: 'string'
    // For remaining properties, see IdentityConfiguration objects
  }
  jobType: 'Sweep'
  maxConcurrentTrials: int
  maxTotalTrials: int
  objective: {
    goal: 'string'
    primaryMetric: 'string'
  }
  priority: int
  searchSpace: {
    {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
  }
  timeout: 'string'
  trial: {
    codeId: 'string'
    command: 'string'
    distribution: {
      distributionType: 'string'
      // For remaining properties, see DistributionConfiguration objects
    }
    environmentId: 'string'
    environmentVariables: {
      {customized property}: 'string'
    }
    inputDataBindings: {
      {customized property}: {
        dataId: 'string'
        mode: 'string'
        pathOnCompute: 'string'
      }
    }
    outputDataBindings: {
      {customized property}: {
        datastoreId: 'string'
        mode: 'string'
        pathOnCompute: 'string'
        pathOnDatastore: 'string'
      }
    }
    timeout: 'string'
  }
}

Wartości właściwości

AmlToken

Nazwa	Opis	Wartość
identityType	[Wymagane] Określa typ struktury tożsamości.	"AMLToken" (wymagane)

BanditPolicy

Nazwa	Opis	Wartość
policyType	[Wymagane] Nazwa konfiguracji zasad	"Bandit" (wymagany)
slackAmount	Bezwzględna odległość dozwolona od najlepiej działającego przebiegu.	Int
slackFactor	Współczynnik dozwolonej odległości od najlepszego przebiegu.	Int

CommandJob

Nazwa	Opis	Wartość
codeId	Identyfikator zasobu usługi ARM zasobu kodu.	struna
polecenie	[Wymagane] Polecenie do wykonania podczas uruchamiania zadania. Np. "python train.py"	struna Ograniczenia: Minimalna długość = 1 Wzorzec = `[a-zA-Z0-9_]` (wymagane)
liczyć	[Wymagane] Powiązanie obliczeniowe dla zadania.	ComputeConfiguration (wymagane)
dystrybucja	Konfiguracja dystrybucji zadania. W przypadku ustawienia powinna to być jedna z wartości Mpi, Tensorflow, PyTorch lub null.	DistributionConfiguration
environmentId	Identyfikator zasobu usługi ARM specyfikacji środowiska dla zadania.	struna
environmentVariables	Zmienne środowiskowe uwzględnione w zadaniu.	CommandJobEnvironmentVariables
experimentName	Nazwa eksperymentu, do którego należy zadanie. Jeśli nie zostanie ustawione, zadanie zostanie umieszczone w eksperymencie "Domyślny".	struna
tożsamość	Konfiguracja tożsamości. W przypadku ustawienia powinna to być jedna z wartości AmlToken, ManagedIdentity lub null. Wartość domyślna to AmlToken, jeśli ma wartość null.	IdentityConfiguration
inputDataBindings	Mapowanie powiązań danych wejściowych używanych w zadaniu.	CommandJobInputDataBindings
jobType	[Wymagane] Określa typ zadania.	"Polecenie" (wymagane)
outputDataBindings	Mapowanie powiązań danych wyjściowych używanych w zadaniu.	CommandJobOutputDataBindings
priorytet	Priorytet zadania dla zasad planowania. Dotyczy tylko usługi AMLCompute. Prywatna funkcja w wersji zapoznawczej i dostępna tylko dla użytkowników na liście dozwolonych.	Int
Limit czasu	Maksymalny czas trwania przebiegu w formacie ISO 8601, po którym zadanie zostanie anulowane. Obsługuje tylko czas trwania z dokładnością do sekund.	struna

CommandJobEnvironmentVariables

Nazwa	Opis	Wartość

CommandJobInputDataBindings

Nazwa	Opis	Wartość

CommandJobOutputDataBindings

Nazwa	Opis	Wartość

Konfiguracja obliczeniowa

Nazwa	Opis	Wartość
instanceCount	Liczba wystąpień lub węzłów.	Int
instanceType	Typ jednostki SKU do uruchomienia.	struna
isLocal	Ustaw wartość true dla zadań uruchomionych w środowisku obliczeniowym lokalnym.	Bool
lokalizacja	Lokalizacja uruchomienia klastra wirtualnego.	struna
Właściwości	Dodatkowe właściwości.	ComputeConfigurationProperties
cel	Identyfikator zasobu usługi ARM docelowego obiektu obliczeniowego. Jeśli nie zostanie podany, zasób zostanie wdrożony jako zarządzany.	struna

ComputeConfigurationProperties

Nazwa	Opis	Wartość

Rozkładkonfiguracja

Nazwa	Opis	Wartość
distributionType	Ustaw wartość "Mpi" dla typu Mpi. Ustaw wartość "PyTorch" dla typu PyTorch. Ustaw wartość "TensorFlow" dla typu TensorFlow.	"Mpi" "PyTorch" "TensorFlow" (wymagany)

EarlyTerminationPolicy

Nazwa	Opis	Wartość
delayEvaluation	Liczba interwałów, według których należy opóźnić pierwszą ocenę.	Int
evaluationInterval	Interwał (liczba przebiegów) między ocenami zasad.	Int
policyType	Ustaw wartość "Bandit" dla typu BanditPolicy. Ustaw wartość "MedianStopping" dla typu MedianStoppingPolicy. Ustaw wartość "TruncationSelection" dla typu TruncationSelectionPolicy.	"Bandit" "MedianStopping" "Obcięcie wyboru" (wymagane)

IdentityConfiguration

Nazwa	Opis	Wartość
identityType	Ustaw wartość "AMLToken" dla typu AmlToken. Ustaw wartość "Managed" dla typu ManagedIdentity.	"AMLToken" "Zarządzane" (wymagane)

InputDataBinding

Nazwa	Opis	Wartość
dataId	Identyfikator zasobu usługi ARM zarejestrowanego elementu dataVersion.	struna
tryb	Mechanizm uzyskiwania dostępu do artefaktu danych.	"Bezpośredni" "Pobierz" "EvalDownload" "EvalMount" "Instalowanie" "ReadOnlyMount" "ReadWriteMount" "Przekaż"
pathOnCompute	Lokalizacja danych wewnątrz procesu kontenera.	struna

Baza zadań

Nazwa	Opis	Wartość
opis	Tekst opisu zasobu.	struna
jobType	Ustaw wartość "Command" dla typu CommandJob. Ustaw wartość "Zamiatanie" dla typu SweepJob.	"Polecenie" "Zamiatanie" (wymagane)
Właściwości	Słownik właściwości elementu zawartości.	JobBaseProperties
Tagi	Słownik tagów. Tagi można dodawać, usuwać i aktualizować.	JobBaseTags

Właściwości elementu JobBase

Nazwa	Opis	Wartość

JobBaseTags

Nazwa	Opis	Wartość

Identyfikator zarządzany

Nazwa	Opis	Wartość
clientId	Określa tożsamość przypisaną przez użytkownika według identyfikatora klienta. W przypadku przypisanego przez system pola nie należy ustawiać tego pola.	struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
identityType	[Wymagane] Określa typ struktury tożsamości.	"Zarządzane" (wymagane)
objectId	Określa tożsamość przypisaną przez użytkownika według identyfikatora obiektu. W przypadku przypisanego przez system pola nie należy ustawiać tego pola.	struna Ograniczenia: Minimalna długość = 36 Maksymalna długość = 36 Wzorzec = `^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$`
resourceId	Określa tożsamość przypisaną przez użytkownika według identyfikatora zasobu usługi ARM. W przypadku przypisanego przez system pola nie należy ustawiać tego pola.	struna

MedianStoppingPolicy

Nazwa	Opis	Wartość
policyType	[Wymagane] Nazwa konfiguracji zasad	"MedianStopping" (wymagane)