Estos contenidos se han traducido de forma automática para su comodidad, pero Huawei Cloud no garantiza la exactitud de estos. Para consultar los contenidos originales, acceda a la versión en inglés.

Centro de ayuda/ ModelArts/ Referencia de la API/ DevEnviron (Recomendado)/ Gestión de instancias de DevEnviron/ Actualización de una instancia de Notebook

Actualización más reciente 2022-11-14 GMT+08:00

Ver PDF

Actualización de una instancia de Notebook

Función

Esta API se utiliza para actualizar la configuración de una instancia de notebook, como su nombre, descripción, variante, imagen, especificaciones de almacenamiento o acceso remoto a SSH.

Restricciones

No hay

URI

PUT /v1/{project_id}/notebooks/{id}

**Tabla 1** Parámetros de ruta
Parámetro	Obligatorio	Tipo	Descripción
id	Sí	String	ID de instancia del notebook.
project_id	Sí	String	ID del proyecto. Para obtener más información, consulte Obtención de un ID de proyecto.

Parámetros de solicitud

**Tabla 2** Parámetros del cuerpo de solicitud
Parámetro	Obligatorio	Tipo	Descripción
description	No	String	Descripción de la instancia. El valor puede contener un máximo de 512 caracteres y no puede contener los siguientes caracteres especiales: &<>"/.
endpoints	No	Array of EndpointsReq objects	IDE local (como PyCharm y vsCode) o cliente SSH para acceder remotamente a una instancia de notebook a través de SSH.
flavor	No	String	Variante de la instancia. Para obtener más información, véase Consulta de variantes disponibles para una instancia de Notebook.
image_id	No	String	Identificación de la imagen. Para obtener más información, véase Consulta de imágenes admitidas.
name	No	String	Nombre de instancia, que contiene un máximo de 64 caracteres y puede contener letras, dígitos, guiones (-) y guiones bajos (_).
storage_new_size	No	Integer	Capacidad de instancia de EVS que se puede ampliar, en GB. El valor máximo es de 4,096 GB.

**Tabla 3** EndpointsReq
Parámetro	Obligatorio	Tipo	Descripción
allowed_access_ips	No	Array of strings	Direcciones IP públicas que pueden acceder de forma remota a la instancia de notebook. Se admite un máximo de cinco direcciones IP públicas.
dev_service	No	String	Servicios soportados. Opciones: NOTEBOOK: Puede acceder a la instancia del notebook mediante HTTPS. SSH: Puede acceder remotamente a la instancia del notebook a través de SSH.
ssh_keys	No	Array of strings	Nombre del par de claves SSH, que se puede crear y ver en la página Key Pair de la consola de Elastic Cloud Server (ECS).

Parámetros de respuesta

Código de estado: 200

**Tabla 4** Parámetros del cuerpo de respuesta
Parámetro	Tipo	Descripción
action_progress	Array of JobProgress objects	Progreso de inicialización de instancia.
description	String	Descripción de la instancia
endpoints	Array of EndpointsRes objects	IDE local (como PyCharm y vsCode) o cliente SSH para acceder remotamente a una instancia de notebook a través de SSH.
fail_reason	String	Causa de error de instancia
feature	String	Tipo de instancia. Opciones: DEFAULT: instancia CodeLab gratuita. Solo puede crear uno. NOTEBOOK: instancia facturada.
flavor	String	Variante de la instancia
id	String	ID de la instancia
image	Image object	Imagen de instancia
lease	Lease object	Cuenta atrás para detener la instancia automática.
name	String	Nombre de la instancia
pool	Pool object	Información básica sobre el grupo dedicado, que es devuelto por la instancia creada en el grupo dedicado.
status	String	Opciones de estado de instancia: INIT: Se está inicializando la instancia. CREATING: Se está creando la instancia. STARTING: La instancia se está iniciando. STOPPING: La instancia se está deteniendo. DELETING: se está eliminando la instancia. RUNNING: La instancia se está ejecutando. STOPPED: La instancia se detiene. SNAPSHOTTING: Se está tomando una instantánea para la instancia (estado cuando se guarda la imagen). CREATE_FAILED: Error al crear la instancia. START_FAILED: Error al iniciar la instancia. DELETE_FAILED: Error al eliminar la instancia. ERROR: Se ha producido un error. DELETED: Se ha eliminado la instancia. FROZEN: La instancia está congelada.
token	String	Token utilizado para la autenticación del notebook
url	String	URL para acceder a la instancia del notebook
volume	VolumeRes object	Volumen de almacenamiento
workspace_id	String	ID del espacio de trabajo. Si no hay espacios de trabajo disponibles, el valor predeterminado es 0.

**Tabla 5** JobProgress
Parámetro	Tipo	Descripción
notebook_id	String	ID de la instancia
status	String	Estado del trabajo en un paso especificado. Opciones: WAITING: El trabajo está esperando para comenzar. PROCESSING: El trabajo se está procesando. FAILED: El trabajo falló. COMPLETED: La tarea está completa.
step	Integer	Paso de trabajo. Opciones: 1: Preparación de almacenamiento. 2: Preparación de recursos informáticos. 3: Configuraciones de red. 4: Inicialización de instancia.
step_description	String	Descripción de un paso en un trabajo.

**Tabla 6** EndpointsRes
Parámetro	Tipo	Descripción
allowed_access_ips	Array of strings	Lista blanca de direcciones IP públicas a las que se les permite acceder a la instancia del cuaderno a través de SSH. De forma predeterminada, todas las direcciones IP públicas pueden acceder a la instancia de notebook. Si se especifica este parámetro, sólo los clientes con las direcciones IP especificadas pueden acceder a la instancia del notebook.
dev_service	String	Servicios soportados. Opciones: NOTEBOOK: Puede acceder a la instancia del notebook mediante HTTPS. SSH: Puede acceder remotamente a la instancia del notebook a través de SSH.
ssh_keys	Array of strings	Lista de pares de claves SSH. Puede establecer varios pares de claves para acceder a una instancia SSH al mismo tiempo.

**Tabla 7** Image
Parámetro	Tipo	Descripción
id	String	ID de imagen
name	String	Nombre de la imagen.
swr_path	String	Dirección de imagen SWR
type	String	Tipo de imagen. Opciones: BUILD_IN: imagen integrada del sistema DEDICATED: imagen guardada por el usuario

**Tabla 8** Lease
Parámetro	Tipo	Descripción
create_at	Long	Hora (UTC) en la que se crea la instancia, con una precisión de milisegundos.
duration	Long	Duración de ejecución de la instancia, que se calcula en función del tiempo de creación de la instancia. Si el tiempo de creación de la instancia más la duración es mayor que el tiempo actual, el sistema detiene automáticamente la instancia.
enable	Boolean	Si se activa la detención automática de la instancia.
update_at	Long	Tiempo (UTC) cuando la instancia se actualiza por última vez (excluyendo el tiempo de latido del corazón de keepalive), exacto a milisegundos.

**Tabla 9** Pool
Parámetro	Tipo	Descripción
id	String	ID de un fondo de recursos dedicado
name	String	Nombre de un fondo de recursos dedicado

**Tabla 10** VolumeRes
Parámetro	Tipo	Descripción
capacity	Integer	Capacidad de almacenamiento. El valor predeterminado es 5 GB para EVS y 50 GB para EFS. El valor máximo es de 4,096 GB.
category	String	Tipo de almacenamiento. Se admite el almacenamiento EVS.
mount_path	String	Directorio de la instancia de notebook en la que está montado el almacenamiento OBS. Actualmente, el directorio es /home/ma-user/work/.
ownership	String	Propietario al que pertenece el recurso. Opciones: MANAGED: Los recursos son gestionados por servicios. DEDICATED: Los recursos son administrados por la cuenta de usuario. Este modo sólo se admite cuando la categoría de instancia es EFS.
status	String	Estado de expansión de la capacidad del disco EVS, que es RESIZING durante la expansión de la capacidad y no afecta a la instancia.

Ejemplo de las solicitudes

{
  "image_id" : "e1a07296-22a8-4f05-8bc8-e936c8e54097",
  "description" : "test",
  "flavor" : "modelarts.vm.cpu.8u",
  "name" : "notebook-1111",
  "storage_new_size" : "15",
  "endpoints" : [ {
    "key_pair_names" : [ "KeyPair-3x" ],
    "allowed_access_ips" : [ "1.1.1.1" ],
    "service" : "SSH"
  } ]
}

Ejemplo de las respuestas

Código de estado: 200

{
  "create_at" : 1638841805440,
  "data_volumes" : [ ],
  "description" : "update",
  "endpoints" : [ {
    "service" : "NOTEBOOK",
    "uri" : "https://authoring-modelarts-cnnorth7.ulanqab.huawei.com/f9937afa-ca78-45b6-bc12-7ecf42553c48/lab"
  } ],
  "feature" : "DEFAULT",
  "flavor" : "modelarts.vm.cpu.free",
  "id" : "f9937afa-ca78-45b6-bc12-7ecf42553c48",
  "image" : {
    "description" : "description",
    "id" : "e1a07296-22a8-4f05-8bc8-e936c8e54090",
    "name" : "notebook2.0-mul-kernel-cpu-cp36",
    "swr_path" : "swr.cn-north-7.myhuaweicloud.com/atelier/notebook2.0-mul-kernel-cpu-cp36:3.3.2-release_v1",
    "tag" : "3.3.2-release_v1",
    "type" : "BUILD_IN"
  },
  "lease" : {
    "create_at" : 1638841805439,
    "duration" : 3600000,
    "enable" : true,
    "update_at" : 1638841805439
  },
  "name" : "notebook_5ee4bf0e",
  "status" : "STOPPED",
  "token" : "58ba50c6-e8ff-245c-4840-49e51aa70737",
  "update_at" : 1638842445117,
  "url" : "https://authoring-modelarts-cnnorth7.ulanqab.huawei.com/f9937afa-ca78-45b6-bc12-7ecf42553c48/lab",
  "volume" : {
    "category" : "EVS",
    "ownership" : "MANAGED",
    "mount_path" : "/home/ma-user/work/",
    "capacity" : 50,
    "usage" : -1
  },
  "workspace_id" : "0"
}