Compartilhar via

AmlComputeProvisioningConfiguration Classe

Representa parâmetros de configuração para provisionar destinos AmlCompute.

Use o provisioning_configuration método da AmlCompute classe para especificar parâmetros de configuração.

Crie um objeto de configuração para provisionar um destino AmlCompute.

Construtor

AmlComputeProvisioningConfiguration(vm_size='', vm_priority='dedicated', min_nodes=0, max_nodes=None, idle_seconds_before_scaledown=1800, admin_username=None, admin_user_password=None, admin_user_ssh_key=None, vnet_resourcegroup_name=None, vnet_name=None, subnet_name=None, tags=None, description=None, remote_login_port_public_access='NotSpecified', identity_type=None, identity_id=None, compute_location=None, enable_node_public_ip=True)

Parâmetros

Nome Description
vm_size
Obrigatório
str

O tamanho das VMs do agente. Mais detalhes podem ser encontrados aqui: https://aka.ms/azureml-vm-details. Observe que nem todos os tamanhos estão disponíveis em todas as regiões, conforme detalhado no link anterior. Se não for especificado, o padrão será Standard_NC6.
vm_priority
str

A prioridade da VM, VMs "dedicadas" ou "lowpriority". Se não for especificado, o padrão será "dedicado".

Valor padrão: dedicated
min_nodes
int

O número mínimo de nós a serem usados no cluster. Se não for especificado, o padrão será 0.

Valor padrão: 0
max_nodes
int

O número máximo de nós a serem usados no cluster. O valor padrão é 4.

Valor padrão: None
idle_seconds_before_scaledown
int

O tempo ocioso do nó em segundos antes de reduzir o cluster. Se não for especificado, o padrão será 1800.

Valor padrão: 1800
admin_username
str

O nome da conta de usuário do administrador que pode ser usada para SSH em nós.

Valor padrão: None
admin_user_password
str

A senha da conta do usuário administrador.

Valor padrão: None
admin_user_ssh_key
str

A chave pública SSH da conta do usuário administrador.

Valor padrão: None
vnet_resourcegroup_name
str

O nome do grupo de recursos em que a rede virtual está localizada.

Valor padrão: None
vnet_name
str

O nome da rede virtual.

Valor padrão: None
subnet_name
str

O nome da sub-rede dentro da VNet.

Valor padrão: None
tags
dict[str, str]

Um dicionário de marcas de valor de chave a serem fornecidas ao objeto de computação.

Valor padrão: None
description
str

Uma descrição a ser fornecida ao objeto de computação.

Valor padrão: None
remote_login_port_public_access
str

O estado da porta SSH pública. Os valores possíveis são:

  • Desabilitado – indica que a porta ssh pública está fechada em todos os nós do cluster.

  • Habilitado – indica que a porta ssh pública está aberta em todos os nós do cluster.

  • NotSpecified - Indica que a porta ssh pública está fechada em todos os nós do cluster se a VNet for definida, caso contrário, todos os nós públicos serão abertos. Pode ser esse valor padrão somente durante o tempo de criação do cluster. Após a criação, ele será habilitado ou desabilitado.

Valor padrão: NotSpecified
identity_type
string

Os valores possíveis são:

  • SystemAssigned – Identidade atribuída pelo sistema

  • UserAssigned – Identidade atribuída pelo usuário. Requer que a ID de identidade seja definida.

Valor padrão: None
identity_id
list[str]

Lista de IDs de recurso para a identidade atribuída pelo usuário. Eg. ['/subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity /userAssignedIdentities/<id>']

Valor padrão: None
vm_size
Obrigatório
str

O tamanho das VMs do agente. Mais detalhes podem ser encontrados aqui: https://aka.ms/azureml-vm-details. Observe que nem todos os tamanhos estão disponíveis em todas as regiões, conforme detalhado no link anterior. Se não for especificado, o padrão será Standard_NC6.
vm_priority
Obrigatório
str

A prioridade da VM, VMs "dedicadas" ou "lowpriority". Se não for especificado, o padrão será "dedicado".
min_nodes
Obrigatório
int

O número mínimo de nós a serem usados no cluster. Se não for especificado, o padrão será 0.
max_nodes
Obrigatório
int

O número máximo de nós a serem usados no cluster. O valor padrão é 4.
idle_seconds_before_scaledown
Obrigatório
int

O tempo ocioso do nó em segundos antes de reduzir o cluster. Se não for especificado, o padrão será 1800.
admin_username
Obrigatório
str

O nome da conta de usuário do administrador que pode ser usada para SSH em nós.
admin_user_password
Obrigatório
str

A senha da conta do usuário administrador.
admin_user_ssh_key
Obrigatório
str

A chave pública SSH da conta do usuário administrador.
vnet_resourcegroup_name
Obrigatório
str

O nome do grupo de recursos em que a rede virtual está localizada.
vnet_name
Obrigatório
str

O nome da rede virtual.
subnet_name
Obrigatório
str

O nome da sub-rede dentro da VNet.
tags
Obrigatório
dict[str, str]

Um dicionário de marcas de valor de chave a serem fornecidas ao objeto de computação.
description
Obrigatório
str

Uma descrição a ser fornecida ao objeto de computação.
remote_login_port_public_access
Obrigatório
str

O estado da porta SSH pública. Os valores possíveis são:

  • Desabilitado – indica que a porta ssh pública está fechada em todos os nós do cluster.

  • Habilitado – indica que a porta ssh pública está aberta em todos os nós do cluster.

  • NotSpecified - Indica que a porta ssh pública está fechada em todos os nós do cluster se a VNet for definida, caso contrário, todos os nós públicos serão abertos. Esse é o valor padrão. O estado pode estar nesse valor padrão somente durante o tempo de criação do cluster. Após a criação, ele será habilitado ou desabilitado.
identity_type
Obrigatório
string

Os valores possíveis são:

  • SystemAssigned – Identidade atribuída pelo sistema

  • UserAssigned – Identidade atribuída pelo usuário. Requer que a ID de identidade seja definida.
identity_id
Obrigatório
list[str]

Lista de IDs de recurso para a identidade atribuída pelo usuário. Eg. ['/subscriptions/<subid>/resourceGroups/<rg>/providers/Microsoft.ManagedIdentity /userAssignedIdentities/<id>']
compute_location
str

Local no qual provisionar o cluster.

Valor padrão: None
enable_node_public_ip
bool

Habilite o IP público do nó. Os valores possíveis são:

  • True – Habilitar o IP público do nó.

  • False – Desabilitar o IP público do nó.

  • NotSpecified – Habilitar IP público do nó.

Valor padrão: True

Métodos

validate_configuration

Verifique se os valores de configuração especificados são válidos.

Gera um ComputeTargetException caso de falha na validação.

validate_configuration

Verifique se os valores de configuração especificados são válidos.

Gera um ComputeTargetException caso de falha na validação.

validate_configuration()

Exceções

Tipo Description
ComputeTargetException