Todos os produtos
Search
Central de documentação

DataWorks:UpdateServerIdeInstance

Última atualização: Sep 29, 2026

Atualiza a configuração de uma instância de ambiente de desenvolvimento pessoal especificada.

Descrição da operação

Atualiza a configuração de uma instância de ambiente de desenvolvimento pessoal (ServerIDE) especificada. Você pode modificar as configurações de CU, imagem, nome da instância, VPC, conjunto de dados e credenciais. Se os parâmetros de CU e imagem não forem especificados, as configurações existentes da instância serão mantidas.

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

Nenhuma autorização necessária para esta operação. Se você encontrar problemas com esta operação, entre em contato com o suporte técnico.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Descrição

Exemplo

InstanceId

string

Sim

O ID da instância do ambiente de desenvolvimento pessoal. Você pode chamar ListServerIdeInstances para obter o ID.

699573

ProjectId

integer

Não

O ID do espaço de trabalho do DataWorks.

10000

Cu

integer

Não

O número de CUs usados pela instância.

10

ImageId

string

Não

O ID da imagem. Você pode chamar ListServerIdeImages para obter o ID.

System_serveride_notebook_20240822

ImageUrl

string

Não

A URL da imagem. Este parâmetro é obrigatório quando você usa uma imagem não oficial do DataWorks.

registry.cn-hangzhou.aliyuncs.com/example/serveride:latest

InstanceName

string

Não

O nome da instância do ambiente de desenvolvimento pessoal.

notebook_dev

UserVpc

object

Não

A configuração de VPC usada pela instância.

SecurityGroupId

string

Não

O ID do grupo de segurança.

sg-bp1****

VSwitchId

string

Não

O ID do vSwitch.

vsw-bp1****

VpcId

string

Não

O ID da VPC.

vpc-bp1****

ForwardInfos

array<object>

Não

A lista de configurações de encaminhamento de porta.

object

Não

A configuração de encaminhamento de porta.

AccessType

array

Não

A lista de tipos de acesso.

string

Não

O tipo de acesso. Valores válidos:

  • intranet: rede interna.

  • internet: rede pública.

intranet

ContainerName

string

Não

O nome do contêiner de destino.

dsw-notebook

Enable

boolean

Não

Especifica se a configuração de encaminhamento de porta deve ser ativada.

true

ForwardPort

string

Não

A porta de destino no contêiner da instância.

22

Name

string

Não

O nome da configuração de encaminhamento de porta.

ssh

NatGatewayId

string

Não

O ID do gateway NAT.

ngw-bp1****

SSHPublicKey

string

Não

A chave pública usada para acesso SSH.

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ****

EipAllocationId

string

Não

O ID da instância do EIP público.

eip-bp1****

ExternalPort

string

Não

A porta pública mapeada.

1024

Datasets

array<object>

Não

A lista de conjuntos de dados montados na instância.

object

Não

A configuração de montagem do conjunto de dados.

Identifier

string

Não

O identificador do conjunto de dados.

d-vsqjvs****rp5l206u

Version

integer

Não

O número da versão do conjunto de dados.

1

MountPath

string

Não

O caminho de montagem do conjunto de dados na instância.

/mnt/data

ReadOnly

boolean

Não

Especifica se o conjunto de dados deve ser montado no modo somente leitura.

ExtOptions

string

Não

As propriedades de montagem personalizadas do conjunto de dados. O conteúdo é passado como opções de montagem.

{"fs.oss.download.thread.concurrency":"10"}

Uri

string

Não

O URI do diretório do serviço de armazenamento para montagem direta.

oss://example-bucket/data/

CredentialConfig

object

Não

A configuração de injeção de credenciais para a instância. Depois que esse recurso é ativado, você pode usar a cadeia de funções do RAM padrão ou especificar uma função do RAM personalizada.

Enable

boolean

Não

Especifica se a injeção de credenciais deve ser ativada.

AliyunEnvRoleKey

string

Não

A chave da função da variável de ambiente.

0

Configs

array<object>

Não

A lista de configurações de credenciais.

array<object>

Não

A configuração de credenciais.

Key

string

Não

A chave identificadora da configuração de credenciais.

0

Type

string

Não

O tipo de configuração de credenciais. Valores válidos:

  • Role: assunção de função única.

  • RoleChain: assunção de cadeia de funções.

RoleChain

Roles

array<object>

Não

A lista de funções na configuração de credenciais.

array<object>

Não

A configuração de assunção de função.

AssumeRoleFor

string

Não

O ID da conta Alibaba Cloud da entidade principal que possui a função a ser assumida.

123456789012****

Policy

string

Não

A política usada para restringir ainda mais as permissões da função.

{}

RoleArn

string

Não

O ARN da função do RAM.

acs:ram::123456789012****:role/DataWorksRole

RoleType

string

Não

O tipo de assunção de função. Valores válidos:

  • service: assumida por um serviço.

  • user: assumida por um usuário.

service

UserInfo

object

Não

As informações do usuário delegado.

Id

string

Não

O ID da conta do usuário delegado.

20933221576142****

Type

string

Não

O tipo de usuário. Valores válidos:

  • customer: conta Alibaba Cloud.

  • sub: usuário do RAM.

  • AssumedRoleUser: função do RAM.

sub

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

Os parâmetros de resposta.

RequestId

string

O ID da solicitação.

E7D55162-4489-1619-AAF5-3F97D5FCA948

InstanceId

string

O ID da instância do ambiente de desenvolvimento pessoal.

699573

Exemplos

Resposta de sucesso

JSON formato

{
  "RequestId": "E7D55162-4489-1619-AAF5-3F97D5FCA948",
  "InstanceId": "699573"
}

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.