Microsoft.MachineLearningServices workspaces/jobs 2022-05-01

Artykuł
12/16/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@2022-05-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    computeId: 'string'
    description: 'string'
    displayName: 'string'
    experimentName: 'string'
    identity: {
      identityType: 'string'
      // For remaining properties, see IdentityConfiguration objects
    }
    isArchived: bool
    properties: {
      {customized property}: 'string'
    }
    services: {
      {customized property}: {
        endpoint: 'string'
        jobServiceType: 'string'
        port: int
        properties: {
          {customized property}: 'string'
        }
      }
    }
    tags: {
      {customized property}: 'string'
    }
    jobType: 'string'
    // For remaining properties, see JobBaseProperties objects
  }
}

Obiekty JobOutput

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

W przypadku custom_modelużyj:

{
  jobOutputType: 'custom_model'
  mode: 'string'
  uri: 'string'
}

W przypadku mlflow_modelużyj:

{
  jobOutputType: 'mlflow_model'
  mode: 'string'
  uri: 'string'
}

W przypadku mltableużyj:

{
  jobOutputType: 'mltable'
  mode: 'string'
  uri: 'string'
}

W przypadku triton_modelużyj:

{
  jobOutputType: 'triton_model'
  mode: 'string'
  uri: 'string'
}

W przypadku uri_fileużyj polecenia:

{
  jobOutputType: 'uri_file'
  mode: 'string'
  uri: 'string'
}

W przypadku uri_folderużyj:

{
  jobOutputType: 'uri_folder'
  mode: 'string'
  uri: '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'
  processCountPerInstance: int
}

W przypadku TensorFlow użyj:

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

Próbkowanie ObiektówAlgorithm

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

W przypadku Bayesian użyj:

{
  samplingAlgorithmType: 'Bayesian'
}

W przypadku usługi Gridużyj:

{
  samplingAlgorithmType: 'Grid'
}

W przypadku losowychużyj:

{
  rule: 'string'
  samplingAlgorithmType: 'Random'
  seed: 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'
}

W przypadku userIdentityużyj:

{
  identityType: 'UserIdentity'
}

Obiekty JobInput

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

W przypadku custom_modelużyj:

{
  jobInputType: 'custom_model'
  mode: 'string'
  uri: 'string'
}

W przypadku literałuużyj:

{
  jobInputType: 'literal'
  value: 'string'
}

W przypadku mlflow_modelużyj:

{
  jobInputType: 'mlflow_model'
  mode: 'string'
  uri: 'string'
}

W przypadku mltableużyj:

{
  jobInputType: 'mltable'
  mode: 'string'
  uri: 'string'
}

W przypadku triton_modelużyj:

{
  jobInputType: 'triton_model'
  mode: 'string'
  uri: 'string'
}

W przypadku uri_fileużyj polecenia:

{
  jobInputType: 'uri_file'
  mode: 'string'
  uri: 'string'
}

W przypadku uri_folderużyj:

{
  jobInputType: 'uri_folder'
  mode: 'string'
  uri: 'string'
}

Obiekty JobBaseProperties

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

W przypadkupolecenia użyj:

{
  codeId: 'string'
  command: 'string'
  distribution: {
    distributionType: 'string'
    // For remaining properties, see DistributionConfiguration objects
  }
  environmentId: 'string'
  environmentVariables: {
    {customized property}: 'string'
  }
  inputs: {
    {customized property}: {
      description: 'string'
      jobInputType: 'string'
      // For remaining properties, see JobInput objects
    }
  }
  jobType: 'Command'
  limits: {
    jobLimitsType: 'string'
    timeout: 'string'
  }
  outputs: {
    {customized property}: {
      description: 'string'
      jobOutputType: 'string'
      // For remaining properties, see JobOutput objects
    }
  }
  resources: {
    instanceCount: int
    instanceType: 'string'
    properties: {
      {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
    }
  }
}

W przypadkupotoku użyj:

{
  inputs: {
    {customized property}: {
      description: 'string'
      jobInputType: 'string'
      // For remaining properties, see JobInput objects
    }
  }
  jobs: {
    {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
  }
  jobType: 'Pipeline'
  outputs: {
    {customized property}: {
      description: 'string'
      jobOutputType: 'string'
      // For remaining properties, see JobOutput objects
    }
  }
  settings: any(Azure.Bicep.Types.Concrete.AnyType)
}

W przypadkusweep użyj:

{
  earlyTermination: {
    delayEvaluation: int
    evaluationInterval: int
    policyType: 'string'
    // For remaining properties, see EarlyTerminationPolicy objects
  }
  inputs: {
    {customized property}: {
      description: 'string'
      jobInputType: 'string'
      // For remaining properties, see JobInput objects
    }
  }
  jobType: 'Sweep'
  limits: {
    jobLimitsType: 'string'
    maxConcurrentTrials: int
    maxTotalTrials: int
    timeout: 'string'
    trialTimeout: 'string'
  }
  objective: {
    goal: 'string'
    primaryMetric: 'string'
  }
  outputs: {
    {customized property}: {
      description: 'string'
      jobOutputType: 'string'
      // For remaining properties, see JobOutput objects
    }
  }
  samplingAlgorithm: {
    samplingAlgorithmType: 'string'
    // For remaining properties, see SamplingAlgorithm objects
  }
  searchSpace: any(Azure.Bicep.Types.Concrete.AnyType)
  trial: {
    codeId: 'string'
    command: 'string'
    distribution: {
      distributionType: 'string'
      // For remaining properties, see DistributionConfiguration objects
    }
    environmentId: 'string'
    environmentVariables: {
      {customized property}: 'string'
    }
    resources: {
      instanceCount: int
      instanceType: 'string'
      properties: {
        {customized property}: any(Azure.Bicep.Types.Concrete.AnyType)
      }
    }
  }
}

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
}

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

BayesianSamplingAlgorithm

Nazwa	Opis	Wartość
samplingAlgorithmType	[Wymagane] Algorytm używany do generowania wartości hiperparametrów wraz z właściwościami konfiguracji	"Bayesian" (wymagane)

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)
dystrybucja	Konfiguracja dystrybucji zadania. W przypadku ustawienia powinna to być jedna z wartości Mpi, Tensorflow, PyTorch lub null.	DistributionConfiguration
environmentId	[Wymagane] Identyfikator zasobu usługi ARM specyfikacji środowiska dla zadania.	struna Ograniczenia: Wzorzec = `[a-zA-Z0-9_]` (wymagane)
environmentVariables	Zmienne środowiskowe uwzględnione w zadaniu.	CommandJobEnvironmentVariables
Wejścia	Mapowanie powiązań danych wejściowych używanych w zadaniu.	CommandJobInputs
jobType	[Wymagane] Określa typ zadania.	"Polecenie" (wymagane)
Limity	Limit zadań poleceń.	CommandJobLimits
Wyjść	Mapowanie powiązań danych wyjściowych używanych w zadaniu.	CommandJobOutputs
zasoby	Konfiguracja zasobów obliczeniowych dla zadania.	ResourceConfiguration

CommandJobEnvironmentVariables

Nazwa	Opis	Wartość

CommandJobInputs

Nazwa	Opis	Wartość

CommandJobLimits

Nazwa	Opis	Wartość
jobLimitsType	[Wymagane] Typ JobLimit.	"Polecenie" "Zamiatanie" (wymagane)
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

CommandJobOutputs

Nazwa	Opis	Wartość

CustomModelJobInput

Nazwa	Opis	Wartość
jobInputType	[Wymagane] Określa typ zadania.	"custom_model" (wymagane)
tryb	Tryb dostarczania zasobów wejściowych.	"Bezpośredni" "Pobierz" "EvalDownload" "EvalMount" "ReadOnlyMount" "ReadWriteMount"
Uri	[Wymagane] Identyfikator URI zasobu wejściowego.	struna Ograniczenia: Wzorzec = `[a-zA-Z0-9_]` (wymagane)

CustomModelJobOutput

Nazwa	Opis	Wartość
jobOutputType	[Wymagane] Określa typ zadania.	"custom_model" (wymagane)
tryb	Tryb dostarczania zasobów wyjściowych.	"ReadWriteMount" "Przekaż"
Uri	Identyfikator URI elementu zawartości wyjściowej.	struna

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)

GridSamplingAlgorithm

Nazwa	Opis	Wartość
samplingAlgorithmType	[Wymagane] Algorytm używany do generowania wartości hiperparametrów wraz z właściwościami konfiguracji	"Siatka" (wymagana)

IdentityConfiguration

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

Właściwości elementu JobBase

Nazwa	Opis	Wartość
computeId	Identyfikator zasobu usługi ARM zasobu obliczeniowego.	struna
opis	Tekst opisu zasobu.	struna
displayName	Nazwa wyświetlana zadania.	struna
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, UserIdentity lub null. Wartość domyślna to AmlToken, jeśli ma wartość null.	IdentityConfiguration
isArchived	Czy zasób jest archiwizowany?	Bool
jobType	Ustaw wartość "Command" dla typu CommandJob. Ustaw wartość "Pipeline" dla typu PipelineJob. Ustaw wartość "Zamiatanie" dla typu SweepJob.	"Polecenie" "Potok" "Zamiatanie" (wymagane)
Właściwości	Słownik właściwości elementu zawartości.	ResourceBaseProperties
usługi	Lista punktów zadań. W przypadku zadań lokalnych punkt końcowy zadania będzie miał wartość punktu końcowego FileStreamObject.	JobBaseServices
Tagi	Słownik tagów. Tagi można dodawać, usuwać i aktualizować.	ResourceBaseTags

JobBaseServices

Nazwa	Opis	Wartość

JobInput

Nazwa	Opis	Wartość
opis	Opis danych wejściowych.	struna
jobInputType	Ustaw wartość "custom_model" dla typu CustomModelJobInput. Ustaw wartość "literał" dla typu LiteralJobInput. Ustaw wartość "mlflow_model" dla typu MLFlowModelJobInput. Ustaw wartość "mltable" dla typu MLTableJobInput. Ustaw wartość "triton_model" dla typu TritonModelJobInput. Ustaw wartość "uri_file" dla typu UriFileJobInput. Ustaw wartość "uri_folder" dla typu UriFolderJobInput.	"custom_model" "literał" "mlflow_model" "mltable" "triton_model" "uri_file" "uri_folder" (wymagane)

JobOutput

Nazwa	Opis	Wartość
opis	Opis danych wyjściowych.	struna
jobOutputType	Ustaw wartość "custom_model" dla typu CustomModelJobOutput. Ustaw wartość "mlflow_model" dla typu MLFlowModelJobOutput. Ustaw wartość "mltable" dla typu MLTableJobOutput. Ustaw wartość "triton_model" dla typu TritonModelJobOutput. Ustaw wartość "uri_file" dla typu UriFileJobOutput. Ustaw wartość "uri_folder" dla typu UriFolderJobOutput.	"custom_model" "mlflow_model" "mltable" "triton_model" "uri_file" "uri_folder" (wymagane)

JobService

Nazwa	Opis	Wartość
punkt końcowy	Adres URL punktu końcowego.	struna
jobServiceType	Typ punktu końcowego.	struna
port	Port dla punktu końcowego.	Int
Właściwości	Dodatkowe właściwości do ustawienia w punkcie końcowym.	JobServiceProperties

Właściwości usługi zadań

Nazwa	Opis	Wartość

LiterałJobInput

Nazwa	Opis	Wartość
jobInputType	[Wymagane] Określa typ zadania.	"literał" (wymagany)
wartość	[Wymagane] Wartość literału dla danych wejściowych.	struna Ograniczenia: Wzorzec = `[a-zA-Z0-9_]` (wymagane)

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)