Partilhar via

ComputeInstance Classe

  • Referência

Recurso da Instância de Computação.

Herança
azure.ai.ml.entities._compute.compute.Compute
ComputeInstance

Construtor

ComputeInstance(*, name: str, description: str | None = None, size: str | None = None, tags: dict | None = None, ssh_public_access_enabled: bool | None = None, create_on_behalf_of: AssignedUserConfiguration | None = None, network_settings: NetworkSettings | None = None, ssh_settings: ComputeInstanceSshSettings | None = None, schedules: ComputeSchedules | None = None, identity: IdentityConfiguration | None = None, idle_time_before_shutdown: str | None = None, idle_time_before_shutdown_minutes: int | None = None, setup_scripts: SetupScripts | None = None, enable_node_public_ip: bool = True, custom_applications: List[CustomApplications] | None = None, **kwargs)

Parâmetros

name
str
Necessário

Nome da computação.

location
Optional[str]
Necessário

A localização do recurso.

description
Optional[str]
Necessário

Descrição do recurso.

size
Optional[str]
Necessário

Tamanho da computação.

tags
Optional[dict[str, str]]
Necessário

Um conjunto de etiquetas. Contém etiquetas de recursos definidas como pares chave/valor.

create_on_behalf_of
Optional[AssignedUserConfiguration]
Necessário

Configuração para criar recurso em nome de outro utilizador. Predefinições para Nenhum.

network_settings
Optional[NetworkSettings]
Necessário

Definições de rede para a instância de computação.

ssh_settings
Optional[ComputeInstanceSshSettings]
Necessário

Definições de SSH para a instância de computação.

ssh_public_access_enabled
Optional[bool]
Necessário

Estado da porta SSH pública. Predefinições para Nenhum. Os valores possíveis são:

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

  • True - Indica que a porta ssh pública está aberta em todos os nós do cluster.

  • Nenhum - Indica que a porta ssh pública está fechada em todos os nós do cluster se a VNet estiver definida,

    else está aberto todos os nós públicos. Só pode ser predefinido durante o tempo de criação do cluster, após a criação será Verdadeiro ou Falso.

schedules
Optional[ComputeSchedules]
Necessário

Agendamentos de instâncias de computação. Predefinições para Nenhum.

identity
IdentityConfiguration
Necessário

As identidades associadas ao cluster de computação.

idle_time_before_shutdown
Optional[str]
Necessário

Preterido. Em alternativa , utilize o parâmetro idle_time_before_shutdown_minutes. Para a instância de computação após o período de inatividade definido pelo utilizador. O tempo é definido no formato ISO8601. O mínimo é de 15 minutos, o máximo é de 3 dias.

idle_time_before_shutdown_minutes
Optional[int]
Necessário

Para a instância de computação após um período de inatividade definido pelo utilizador em minutos. O mínimo é de 15 minutos, o máximo é de 3 dias.

enable_node_public_ip
Optional[bool]
Necessário

Ativar ou desativar o aprovisionamento de endereços IP públicos do nó. Predefinições para Verdadeiro. Os valores possíveis são:

  • True - Indica que os nós de computação terão IPs públicos aprovisionados.

  • Falso – indica que os nós de computação terão um ponto final privado e nenhum IPs público.

setup_scripts
Optional[SetupScripts]
Necessário

Detalhes dos scripts personalizados a executar para configurar o cluster.

custom_applications
Optional[List[CustomApplications]]
Necessário

Lista de aplicações personalizadas e respetivos pontos finais para a instância de computação.

Keyword-Only Parameters

name
Necessário
description
Necessário
size
Necessário
tags
Necessário
ssh_public_access_enabled
Necessário
create_on_behalf_of
Necessário
network_settings
Necessário
ssh_settings
Necessário
schedules
Necessário
identity
Necessário
idle_time_before_shutdown
Necessário
idle_time_before_shutdown_minutes
Necessário
setup_scripts
Necessário
enable_node_public_ip
valor predefinido: True
custom_applications
Necessário

Exemplos

Criar um objeto ComputeInstance.


   from azure.ai.ml.entities import ComputeInstance

   ci = ComputeInstance(
       name=ci_name,
       size="Standard_DS2_v2",
   )
   ml_client.compute.begin_create_or_update(ci)

Variáveis

state

Estado do recurso.

last_operation

A última operação.

applications

Aplicações associadas à instância de computação.

Métodos

dump

Despeja o conteúdo de computação num ficheiro no formato yaml.

dump

Despeja o conteúdo de computação num ficheiro no formato yaml.

dump(dest: str | PathLike | IO, **kwargs) -> None

Parâmetros

dest
Union[<xref:PathLike>, str, IO[AnyStr]]
Necessário

O destino para receber o conteúdo desta computação. Tem de ser um caminho para um ficheiro local ou um fluxo de ficheiros já aberto. Se dest for um caminho de ficheiro, será criado um novo ficheiro e será gerada uma exceção se o ficheiro existir. Se dest for um ficheiro aberto, o ficheiro será escrito diretamente e será levantada uma exceção se o ficheiro não for gravável.".

Atributos

base_path

O caminho base do recurso.

Devoluções

O caminho base do recurso.

Tipo de retorno

str

created_on

O carimbo de data/hora de criação de recursos de computação.

Devoluções

O carimbo de data/hora de criação de recursos de computação.

Tipo de retorno

Optional[str]

creation_context

O contexto de criação do recurso.

Devoluções

Os metadados de criação do recurso.

Tipo de retorno

Optional[SystemData]

id

O ID do recurso.

Devoluções

O ID global do recurso, um ID do Azure Resource Manager (ARM).

Tipo de retorno

Optional[str]

last_operation

A última operação.

Devoluções

A última operação.

Tipo de retorno

str

os_image_metadata

Metadados sobre a imagem do sistema operativo para esta instância de computação.

Devoluções

Metadados de imagem do sistema operativo.

Tipo de retorno

ImageMetadata

provisioning_errors

Os erros de aprovisionamento de recursos de computação.

Devoluções

Os erros de aprovisionamento de recursos de computação.

Tipo de retorno

Optional[str]

provisioning_state

O estado de aprovisionamento do recurso de computação.

Devoluções

O estado de aprovisionamento do recurso de computação.

Tipo de retorno

Optional[str]

services

Os serviços da instância de computação.

Devoluções

Os serviços da instância de computação.

Tipo de retorno

List[Dict[str, str]]

state

O estado da computação.

Devoluções

O estado da computação.

Tipo de retorno

str

type

O tipo de computação.

Devoluções

O tipo de computação.

Tipo de retorno

Optional[str]