Compartilhar via

AmlComputeProvisioningConfiguration Classe

  • Referência

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

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

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

Herança
ComputeTargetProvisioningConfiguration
AmlComputeProvisioningConfiguration

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 "dedicated" ou "lowpriority". Se não for especificado, o padrão será "dedicated".

Valor padrão: dedicated
min_nodes
int

O número mínimo de nós a ser usado 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 ser usado 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 verticalmente 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 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 no qual 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 chave-valor para fornecer 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:

  • Disabled: indica que a porta do SSH pública está fechada em todos os nós do cluster.

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

  • NotSpecified: indica que a porta do SSH pública estará fechada em todos os nós do cluster, se a VNet estiver definida, caso contrário, todos os nós públicos serão abertos. Pode ser esse valor padrão apenas 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 recursos para a identidade atribuída pelo usuário. ex. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']

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 "dedicated" ou "lowpriority". Se não for especificado, o padrão será "dedicated".
min_nodes
Obrigatório
int

O número mínimo de nós a ser usado 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 ser usado no cluster. O valor padrão é 4.
idle_seconds_before_scaledown
Obrigatório
int

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

O nome da conta de usuário 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 no qual 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 chave-valor para fornecer 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:

  • Disabled: indica que a porta do SSH pública está fechada em todos os nós do cluster.

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

  • NotSpecified: indica que a porta do SSH pública estará fechada em todos os nós do cluster, se a VNet estiver 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 recursos para a identidade atribuída pelo usuário. ex. ['/subscriptions//resourceGroups//providers/Microsoft.ManagedIdentity /userAssignedIdentities/']
compute_location
str

Local para provisionar o cluster.

Valor padrão: None
enable_node_public_ip
bool

Habilita o IP do nó. Os valores possíveis são:

  • True: habilita o IP do nó.

  • False: desabilita o IP do nó.

  • NotSpecified: habilita o IP do nó.

Valor padrão: True

Métodos

validate_configuration

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

Gera uma ComputeTargetException se a validação falha.

validate_configuration

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

Gera uma ComputeTargetException se a validação falha.

validate_configuration()

Exceções

Tipo Description
ComputeTargetException