Todos los productos
Search
Centro de documentos

DataWorks:CreateServerIdeInstance

Última actualización: Sep 03, 2026

Crea una instancia de entorno de desarrollo personal.

Descripción de la operación

Crea una instancia de entorno de desarrollo personal (ServerIDE). Después de especificar el espacio de trabajo de DataWorks, el grupo de recursos, la imagen y las especificaciones, se crea la instancia y se devuelve el ID de la instancia.

Pruébelo ahora

Pruebe esta API en OpenAPI Explorer sin necesidad de firma manual. Las llamadas exitosas generan automáticamente código SDK acorde a sus parámetros. Descárguelo con seguridad de credenciales integrada para uso local.

Test

Autorización de RAM

No se requiere autorización para esta operación. Si experimenta problemas al ejecutarla, póngase en contacto con el soporte técnico.

Parámetros de la solicitud

Parámetro

Tipo

Obligatorio

Descripción

Ejemplo

ProjectId

integer

Sí

El ID del espacio de trabajo de DataWorks.

10000

ResourceGroupId

string

Sí

El identificador del grupo de recursos de DataWorks. Puede especificar el ID numérico del grupo de recursos o el identificador completo en el formato Serverless_res_group_{tenantId}_{resgId}.

Serverless_res_group_123456789012345_9876543210****

Cu

integer

No

El número de CU utilizadas por la instancia.

10

Owner

string

No

El ID de la cuenta de Alibaba Cloud del usuario propietario de la instancia. Si no se especifica este parámetro, se utiliza el llamador actual de forma predeterminada.

20933221576142****

ImageId

string

No

El ID de la imagen. Puede llamar a ListServerIdeImages para obtener el ID de la imagen.

System_serveride_notebook_20240822

ImageUrl

string

No

La URL de la imagen. Este parámetro es obligatorio cuando se utiliza una imagen de DataWorks no oficial.

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

InstanceName

string

Sí

El nombre de la instancia de entorno de desarrollo personal.

notebook_dev

UserVpc

object

No

La configuración de Virtual Private Cloud (VPC) utilizada por la instancia.

SecurityGroupId

string

No

El ID del security group.

sg-bp1****

VSwitchId

string

No

El ID del vSwitch.

vsw-bp1****

VpcId

string

No

El ID de la VPC.

vpc-bp1****

ForwardInfos

array<object>

No

La lista de configuraciones de reenvío de puertos.

object

No

La configuración de reenvío de puertos.

AccessType

array

No

La lista de tipos de acceso.

string

No

El tipo de acceso. Valores válidos:

  • intranet: red interna.

  • internet: red pública.

intranet

ContainerName

string

No

El nombre del contenedor de destino.

dsw-notebook

Enable

boolean

No

Especifica si se debe habilitar esta configuración de reenvío de puertos.

true

ForwardPort

string

No

El puerto de destino en el contenedor de la instancia.

22

Name

string

No

El nombre de la configuración de reenvío de puertos.

ssh

NatGatewayId

string

No

El ID de la puerta de enlace NAT.

ngw-bp1****

SSHPublicKey

string

No

La clave pública utilizada para el acceso SSH.

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQ****

EipAllocationId

string

No

El ID de instancia de la dirección IP elástica (EIP) pública.

eip-bp1****

ExternalPort

string

No

El puerto público asignado.

1024

Datasets

array<object>

No

La lista de conjuntos de datos montados en la instancia.

object

No

La configuración de montaje del conjunto de datos.

Identifier

string

No

El identificador del conjunto de datos.

d-vsqjvs****rp5l206u

Version

integer

No

El número de versión del conjunto de datos.

1

MountPath

string

No

La ruta de montaje del conjunto de datos en la instancia.

/mnt/data

ReadOnly

boolean

No

Especifica si se debe montar el conjunto de datos en modo de solo lectura.

false

ExtOptions

string

No

Las propiedades de montaje personalizadas del conjunto de datos. El contenido se pasa como opciones de montaje.

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

Uri

string

No

La URI del directorio del servicio de almacenamiento para el montaje directo.

oss://example-bucket/data/

CredentialConfig

object

No

La configuración de inyección de credenciales para la instancia. Una vez habilitada esta función, puede utilizar la cadena de roles RAM predeterminada o especificar un rol RAM personalizado.

Enable

boolean

No

Especifica si se debe habilitar la inyección de credenciales.

True

AliyunEnvRoleKey

string

No

La clave de rol de variable de entorno.

0

Configs

array<object>

No

La lista de configuraciones de credenciales.

array<object>

No

La configuración de credenciales.

Key

string

No

La clave identificadora de la configuración de credenciales.

0

Type

string

No

El tipo de configuración de credenciales. Valores válidos:

  • Role: asunción de rol único.

  • RoleChain: asunción de cadena de roles.

RoleChain

Roles

array<object>

No

La lista de roles en la configuración de credenciales.

array<object>

No

La configuración de asunción de roles.

AssumeRoleFor

string

No

El ID de la cuenta de Alibaba Cloud de la entidad propietaria del rol que se va a asumir.

123456789012****

Policy

string

No

La política utilizada para restringir aún más los permisos del rol.

{}

RoleArn

string

No

El nombre de recurso de Alibaba Cloud (ARN) del rol RAM.

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

RoleType

string

No

El tipo de asunción de rol. Valores válidos:

  • service: asumido por un servicio.

  • user: asumido por un usuario.

service

UserInfo

object

No

La información sobre el usuario representado.

Id

string

No

El ID de cuenta del usuario representado.

20933221576142****

Type

string

No

El tipo de usuario. Valores válidos:

  • customer: cuenta de Alibaba Cloud.

  • sub: usuario RAM.

  • AssumedRoleUser: rol RAM.

sub

UserCommand

object

No

La configuración del comando de usuario que se ejecutará cuando se inicie la instancia.

OnStart

object

No

La configuración del comando que se ejecutará después de que se inicie la instancia.

Content

string

No

El contenido del comando que se ejecutará después de que se inicie la instancia. La longitud máxima es de 1024 caracteres.

echo "serveride ready"

Elementos de la respuesta

Elemento

Tipo

Descripción

Ejemplo

object

La respuesta.

RequestId

string

El ID de la solicitud.

E7D55162-4489-1619-AAF5-3F97D5FCA948

InstanceId

string

El ID de la instancia del entorno de desarrollo personal.

699573

Ejemplos

Respuesta exitosa

JSON Formato

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

Códigos de error

Consulte Códigos de error para ver la lista completa.

Notas de la versión

Consulte Notas de la versión para ver la lista completa.