Todos os produtos
Search
Central de documentação

DataWorks:CreateServerIdeInstance

Última atualização: Sep 03, 2026

Cria uma instância de ambiente de desenvolvimento pessoal.

Descrição da operação

Cria uma instância de ambiente de desenvolvimento pessoal (ServerIDE). Após você especificar o workspace do DataWorks, o grupo de recursos, a imagem e as especificações, a instância é criada e o ID da instância é retornado.

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

ProjectId

integer

Sim

O ID do workspace do DataWorks.

10000

ResourceGroupId

string

Sim

O identificador do grupo de recursos do DataWorks. Você pode especificar o ID numérico do grupo de recursos ou o identificador completo no formato Serverless_res_group_{tenantId}_{resgId}.

Serverless_res_group_123456789012345_9876543210****

Cu

integer

Não

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

10

Owner

string

Não

O ID da conta Alibaba Cloud do usuário proprietário da instância. Se este parâmetro não for especificado, o chamador atual será usado por padrão.

20933221576142****

ImageId

string

Não

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

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

Sim

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

notebook_dev

UserVpc

object

Não

A configuração de Virtual Private Cloud (VPC) utilizada 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 esta 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 Elastic IP Address (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.

false

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. Após a ativação deste recurso, você pode usar a cadeia de funções RAM padrão ou especificar uma função RAM personalizada.

Enable

boolean

Não

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

True

AliyunEnvRoleKey

string

Não

A chave de 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 do principal proprietário da 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 Alibaba Cloud Resource Name (ARN) da função 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 sobre o usuário representado.

Id

string

Não

O ID da conta do usuário representado.

20933221576142****

Type

string

Não

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

  • customer: conta Alibaba Cloud.

  • sub: usuário RAM.

  • AssumedRoleUser: função RAM.

sub

UserCommand

object

Não

A configuração de comando do usuário a ser executada quando a instância for iniciada.

OnStart

object

Não

A configuração de comando a ser executada após o início da instância.

Content

string

Não

O conteúdo do comando a ser executado após o início da instância. O comprimento máximo é de 1024 caracteres.

echo "serveride ready"

Elementos de resposta

Elemento

Tipo

Descrição

Exemplo

object

A resposta.

RequestId

string

O ID da solicitação.

E7D55162-4489-1619-AAF5-3F97D5FCA948

InstanceId

string

O ID da instância de 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.