Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Colaboración con espacios compartidos
Un espacio compartido de Amazon SageMaker Studio Classic consta de una JupyterServer aplicación compartida y un directorio compartido. Un espacio JupyterLab compartido consta de una JupyterLab aplicación compartida y un directorio compartido dentro de Amazon SageMaker Studio. Todos los perfiles de usuario de un dominio tienen acceso a todos los espacios compartidos del dominio. Amazon SageMaker AI delimita automáticamente los recursos de un espacio compartido dentro del contexto de la aplicación Amazon SageMaker Studio Classic que se lance en ese espacio compartido. Los recursos de un espacio compartido incluyen cuadernos, archivos, experimentos y modelos. Utilice los espacios compartidos para colaborar con otros usuarios en tiempo real mediante características como el etiquetado automático, la coedición de cuadernos en tiempo real y la personalización.
Los espacios compartidos están disponibles en:
+ Amazon SageMaker Studio Clásico
+ JupyterLab
Un espacio compartido de Studio Classic solo es compatible con Studio Classic y sus KernelGateway aplicaciones. Un espacio compartido solo admite el uso de un Amazon Resource Name (ARN) de JupyterLab 3 imágenes. Para obtener más información, consulte [JupyterLab Control de versiones en Amazon SageMaker Studio Classic](studio-jl.md).
Amazon SageMaker AI etiqueta automáticamente todos los recursos de SageMaker IA que cree en el ámbito de un espacio compartido. Puede utilizar estas etiquetas para supervisar los costos y planificar los presupuestos mediante herramientas como AWS Budgets.
Un espacio compartido usa la misma configuración de VPC que el dominio en el que se creó.
**nota**
Los espacios compartidos no admiten el uso de clústeres entre cuentas de Amazon SageMaker Data Wrangler o Amazon EMR.
**Etiquetado automático**
Todos los recursos creados en un espacio compartido se etiquetan automáticamente con una etiqueta de ARN de dominio y una etiqueta de ARN de espacio compartido. La etiqueta de ARN del dominio se basa en el ID del dominio, mientras que la etiqueta de ARN del espacio compartido se basa en el nombre del espacio compartido.
Puede utilizar estas etiquetas para supervisar el uso. AWS CloudTrail Para obtener más información, consulta [Registrar llamadas a la SageMaker API de Amazon con AWS CloudTrail](https://docs.aws.amazon.com//sagemaker/latest/dg/logging-using-cloudtrail.html).
También puedes usar estas etiquetas para monitorear los costos Administración de facturación y costos de AWS. Para obtener más información, consulte [Uso de etiquetas de asignación de AWS costes](https://docs.aws.amazon.com//awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).
**Edición conjunta de cuadernos en tiempo real**
Una ventaja clave de un espacio compartido es que facilita la colaboración entre los miembros del espacio compartido en tiempo real. Los usuarios que colaboran en un espacio de trabajo obtienen acceso a una aplicación de Studio Classic compartida en la que pueden acceder a sus cuadernos, leerlos y editarlos en tiempo real. La colaboración en tiempo real solo se admite para JupyterServer aplicaciones dentro de un espacio compartido.
Los usuarios con acceso a un espacio compartido pueden abrir, ver, editar y ejecutar simultáneamente las libretas de Jupyter en el Studio Classic o en la JupyterLab aplicación compartida de ese espacio.
El cuaderno indica a cada usuario coeditor con un cursor diferente que muestra el nombre del perfil del usuario. Si bien varios usuarios pueden ver el mismo cuaderno, la edición conjunta es más adecuada para grupos pequeños de dos a cinco usuarios.
Para realizar un seguimiento de los cambios realizados por varios usuarios, se recomienda encarecidamente utilizar el control de versiones basado en Git integrado en Studio Classic.
**JupyterServer 2**
Para utilizar espacios compartidos en Studio Classic se requiere la versión 2 de Jupyter Server. Determinadas JupyterLab extensiones y paquetes pueden forzar la degradación de Jupyter Server a la versión 1. Esto impide el uso del espacio compartido. Ejecute lo siguiente desde la línea de comandos para cambiar el número de versión y seguir utilizando los espacios compartidos.
```
conda activate studio
pip install jupyter-server==2.0.0rc3
```
**Personalización de un espacio compartido**
Para asociar una configuración de ciclo de vida o una imagen personalizada a un espacio compartido, debe usar la AWS CLI. Para obtener más información acerca de la creación y asociación de configuraciones de ciclo de vida, consulte [Creación y asociación de una configuración de ciclo de vida con Amazon SageMaker Studio Classic](studio-lcc-create.md). Para obtener más información acerca de la creación y asociación de imágenes personalizadas, consulte [Imágenes personalizadas en Amazon SageMaker Studio Classic](studio-byoi.md).
# Creación de un espacio compartido
**importante**
Las políticas de IAM personalizadas que permiten a Amazon SageMaker Studio o Amazon SageMaker Studio Classic crear SageMaker recursos de Amazon también deben conceder permisos para añadir etiquetas a esos recursos. El permiso para añadir etiquetas a los recursos es necesario porque Studio y Studio Classic etiquetan automáticamente todos los recursos que crean. Si una política de IAM permite a Studio y Studio Classic crear recursos, pero no permite el etiquetado, se pueden producir errores de tipo AccessDenied «» al intentar crear recursos. Para obtener más información, consulte [Proporcione permisos para etiquetar los recursos de SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS políticas gestionadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que otorgan permisos para crear SageMaker recursos ya incluyen permisos para añadir etiquetas al crear esos recursos.
En el siguiente tema se muestra cómo crear un espacio compartido en un dominio de Amazon SageMaker AI existente. Si creó su dominio sin compatibilidad con espacios compartidos, debe agregar compatibilidad para espacios compartidos a su dominio existente antes de poder crear un espacio compartido.
**Topics**
+ [Adición de compatibilidad para espacios compartidos a un dominio existente](#domain-space-add)
+ [Creación de un espacio compartido](#domain-space-create-app)
## Adición de compatibilidad para espacios compartidos a un dominio existente
Puede utilizar la consola de SageMaker IA o la AWS CLI para añadir soporte para espacios compartidos a un dominio existente. Si el dominio utiliza acceso a la red `VPC only`, solo puede añadir soporte para espacios compartidos mediante la AWS CLI.
### Consola
Realice el siguiente procedimiento para añadir la compatibilidad con los espacios compartidos de Studio Classic a un dominio existente desde la consola de SageMaker IA.
1. Abre la consola Amazon SageMaker AI en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. En el panel de navegación izquierdo, seleccione **Configuraciones de administración**.
1. En **Configuraciones de administración**, elija **Dominios**.
1. En la lista de dominios, seleccione el dominio para el que quiera abrir la página **Configuración del dominio**.
1. En la página **Detalles del dominio**, elija la pestaña **Configuración del dominio**.
1. Elija **Edit (Edición de)**.
1. En **Rol de ejecución predeterminado del espacio**, defina un rol de IAM que se utilice de forma predeterminada para todos los espacios compartidos creados en el dominio.
1. Elija **Siguiente**.
1. Elija **Siguiente**.
1. Elija **Siguiente**.
1. Seleccione **Enviar**.
### AWS CLI
------
#### [ Studio Classic ]
Ejecute el siguiente comando desde el terminal de su equipo local para agregar la configuración de espacio compartido predeterminada a un dominio desde la AWS CLI. Si va a agregar la configuración de espacio compartido predeterminada a un dominio de una Amazon VPC, también debe incluir una lista de grupos de seguridad. Los espacios compartidos de Studio Classic solo admiten el uso de JupyterLab 3 imágenes ARNs. Para obtener más información, consulte [JupyterLab Control de versiones en Amazon SageMaker Studio Classic](studio-jl.md).
```
# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"
# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn,JupyterServerAppSettings={DefaultResourceSpec={InstanceType=system,SageMakerImageArn=sagemaker-image-arn}},SecurityGroups=[security-groups]"
```
Utilice el comando siguiente para comprobar que se haya actualizado la configuración de espacio compartido predeterminada.
```
aws --region region \
sagemaker describe-domain \
--domain-id domain-id
```
------
#### [ JupyterLab ]
Ejecute el siguiente comando desde el terminal de su equipo local para agregar la configuración de espacio compartido predeterminada a un dominio desde la AWS CLI. Si va a agregar la configuración de espacio compartido predeterminada a un dominio de una Amazon VPC, también debe incluir una lista de grupos de seguridad. Los espacios compartidos de Studio Classic solo admiten el uso de JupyterLab 4 imágenes ARNs. Para obtener más información, consulte [JupyterLab Control de versiones en Amazon SageMaker Studio Classic](studio-jl.md).
```
# Public Internet domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn", JupyterLabAppSettings={DefaultResourceSpec={InstanceType=example-instance-type,SageMakerImageArn=sagemaker-image-arn}}"
# VPCOnly domain
aws --region region \
sagemaker update-domain \
--domain-id domain-id \
--default-space-settings "ExecutionRole=execution-role-arn, SecurityGroups=[security-groups]"
```
Utilice el comando siguiente para comprobar que se haya actualizado la configuración de espacio compartido predeterminada.
```
aws --region region \
sagemaker describe-domain \
--domain-id domain-id
```
------
## Creación de un espacio compartido
En las siguientes secciones se muestra cómo crear un espacio compartido desde la consola Amazon SageMaker AI, Amazon SageMaker Studio o el AWS CLI.
### Creación desde Studio
Utilice los siguientes procedimientos para crear un espacio compartido en un dominio desde Studio.
------
#### [ Studio Classic ]
1. Vaya a Studio siguiendo los pasos que se indican en [Inicie Amazon SageMaker Studio](studio-updated-launch.md).
1. En la IU de Studio, busque el panel de aplicaciones en la parte izquierda.
1. En el panel de aplicaciones, seleccione **Studio Classic**.
1. Elija **Crear espacio de Studio Classic**
1. En la ventana emergente, escriba un nombre para el espacio.
1. Elija **Crear espacio**.
------
#### [ JupyterLab ]
1. Vaya a Studio siguiendo los pasos que se indican en [Inicie Amazon SageMaker Studio](studio-updated-launch.md).
1. En la IU de Studio, busque el panel de aplicaciones en la parte izquierda.
1. En el panel de aplicaciones, selecciona **JupyterLab**.
1. Elija **Crear JupyterLab espacio**
1. En la ventana emergente, escriba un nombre para el espacio.
1. Elija **Crear espacio**.
------
### Creación desde la consola
Realice el siguiente procedimiento para crear un espacio compartido en un dominio desde la consola de SageMaker IA.
1. Abre la consola Amazon SageMaker AI en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. En el panel de navegación izquierdo, seleccione **Configuraciones de administración**.
1. En **Configuraciones de administración**, elija **Dominios**.
1. En la lista de dominios, seleccione el dominio para el que desea crear un espacio compartido.
1. En la página **Detalles del dominio**, elija la pestaña **Administración del espacio**.
1. Seleccione **Crear**.
1. Ingrese un nombre para el espacio compartido. Los nombres de los espacios compartidos de un dominio deben ser únicos. El rol de ejecución del espacio compartido se establece en el rol de ejecución de IAM del dominio.
### Crea desde AWS CLI
En esta sección se muestra cómo crear un espacio compartido desde la AWS CLI.
No se puede establecer el rol de ejecución de un espacio compartido al crearlo o actualizarlo. Solo se `DefaultDomainExecRole` puede configurar al crear o actualizar el dominio. Los espacios compartidos solo admiten el uso de JupyterLab 3 imágenes ARNs. Para obtener más información, consulte [JupyterLab Control de versiones en Amazon SageMaker Studio Classic](studio-jl.md).
Para crear un espacio compartido desde AWS CLI, ejecute uno de los siguientes comandos desde la terminal de su máquina local.
------
#### [ Studio Classic ]
```
aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--space-settings '{
"JupyterServerAppSettings": {
"DefaultResourceSpec": {
"SageMakerImageArn": "sagemaker-image-arn",
"InstanceType": "system"
}
}
}'
```
------
#### [ JupyterLab ]
```
aws --region region \
sagemaker create-space \
--domain-id domain-id \
--space-name space-name \
--ownership-settings "{\"OwnerUserProfileName\": \"user-profile-name\"}" \
--space-sharing-settings "{\"SharingType\": \"Shared\"}" \
--space-settings "{\"AppType\": \"JupyterLab\"}"
```
------
# Obtención de información sobre espacios compartidos
**importante**
A partir del 30 de noviembre de 2023, la experiencia anterior de Amazon SageMaker Studio pasa a denominarse Amazon SageMaker Studio Classic. La siguiente sección es específica del uso de la aplicación de Studio Classic. Para obtener información sobre el uso de la experiencia de Studio actualizada, consulte [Amazon SageMaker Studio](studio-updated.md).
Studio Classic se sigue manteniendo para las cargas de trabajo existentes, pero ya no está disponible para su incorporación. Solo puede detener o eliminar las aplicaciones de Studio Classic existentes y no puede crear aplicaciones nuevas. Te recomendamos que [migres tu carga de trabajo a la nueva experiencia de Studio](studio-updated-migrate.md).
En esta guía se muestra cómo acceder a una lista de espacios compartidos en un dominio de Amazon SageMaker AI con la consola Amazon AI, Amazon SageMaker Studio o el AWS CLI. SageMaker También muestra cómo ver los detalles de un espacio compartido desde la AWS CLI.
**Topics**
+ [Enumerar los espacios compartidos](#domain-space-list-spaces)
+ [Ver los detalles del espacio compartido](#domain-space-describe)
## Enumerar los espacios compartidos
En el siguiente tema se describe cómo ver una lista de espacios compartidos dentro de un dominio desde la consola SageMaker AI o desde la AWS CLI.
### Lista de espacios compartidos desde Studio
Complete el siguiente procedimiento para ver una lista de espacios compartidos en un dominio desde Studio.
1. Vaya a Studio siguiendo los pasos que se indican en [Inicie Amazon SageMaker Studio](studio-updated-launch.md).
1. En la IU de Studio, busque el panel de aplicaciones en la parte izquierda.
1. En el panel de aplicaciones, selecciona **Studio Classic** o **JupyterLab**. Puede ver los espacios que se utilizan para ejecutar el tipo de aplicación.
### Enumerar los espacios compartidos desde la consola
Complete el siguiente procedimiento para ver una lista de los espacios compartidos de un dominio desde la consola de SageMaker IA.
1. Abre la consola Amazon SageMaker AI en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. En el panel de navegación izquierdo, seleccione **Configuraciones de administración**.
1. En **Configuraciones de administración**, elija **Dominios**.
1. En la lista de dominios, seleccione el dominio del que desea ver la lista de espacios compartidos.
1. En la página **Detalles del dominio**, elija la pestaña **Administración del espacio**.
### Enumere los espacios compartidos desde AWS CLI
Para enumerar los espacios compartidos de un dominio desde el AWS CLI, ejecute el siguiente comando desde la terminal de su máquina local.
```
aws --region region \
sagemaker list-spaces \
--domain-id domain-id
```
## Ver los detalles del espacio compartido
En la siguiente sección se describe cómo ver los detalles de los espacios compartidos desde la consola SageMaker AI, Studio o el AWS CLI.
### Visualización de detalles de espacio compartido desde Studio
Complete el siguiente procedimiento para ver los detalles de un espacio compartido en un dominio desde Studio.
1. Vaya a Studio siguiendo los pasos que se indican en [Inicie Amazon SageMaker Studio](studio-updated-launch.md).
1. En la IU de Studio, busque el panel de aplicaciones en la parte izquierda.
1. En el panel de aplicaciones, selecciona **Studio Classic** o **JupyterLab**. Puede ver los espacios que están ejecutando la aplicación.
1. Seleccione el nombre del espacio del que quiera ver más detalles.
### Ver los detalles del espacio compartido desde la consola
Puede ver los detalles de un espacio compartido desde la consola de SageMaker IA mediante el siguiente procedimiento.
1. Abre la consola Amazon SageMaker AI en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. En el panel de navegación izquierdo, seleccione **Configuraciones de administración**.
1. En **Configuraciones de administración**, elija **Dominios**.
1. En la lista de dominios, seleccione el dominio del que desea ver la lista de espacios compartidos.
1. En la página **Detalles del dominio**, elija la pestaña **Administración del espacio**.
1. Seleccione el nombre del espacio para abrir una nueva página con información sobre el espacio compartido.
### Vea los detalles del espacio compartido desde el AWS CLI
Para ver los detalles de un espacio compartido desde el AWS CLI, ejecute el siguiente comando desde la terminal de su máquina local.
```
aws --region region \
sagemaker describe-space \
--domain-id domain-id \
--space-name space-name
```
# Edición de un espacio compartido
Solo puedes editar los detalles de un Amazon SageMaker Studio Classic o un espacio JupyterLab compartido mediante AWS CLI. No puedes editar los detalles de un espacio compartido desde la consola Amazon SageMaker AI. Solo puede actualizar los atributos del espacio de trabajo cuando no haya aplicaciones en ejecución en el espacio compartido.
------
#### [ Studio Classic ]
Para editar los detalles de un espacio compartido de Studio Classic desde el AWS CLI, ejecute uno de los siguientes comandos desde el terminal de su máquina local. Los espacios compartidos solo admiten el uso de JupyterLab 3 imágenes. ARNs Para obtener más información, consulte [JupyterLab Control de versiones en Amazon SageMaker Studio Classic](studio-jl.md).
```
aws --region region \
sagemaker update-space \
--domain-id domain-id \
--space-name space-name \
--query SpaceArn --output text \
--space-settings '{
"JupyterServerAppSettings": {
"DefaultResourceSpec": {
"SageMakerImageArn": "sagemaker-image-arn",
"InstanceType": "system"
}
}
}'
```
------
#### [ JupyterLab ]
Para editar los detalles de un espacio JupyterLab compartido desde el AWS CLI, ejecute uno de los siguientes comandos desde el terminal de su máquina local. Los espacios compartidos solo admiten el uso de 4 imágenes. JupyterLab ARNs Para obtener más información, consulte [SageMaker JupyterLab](studio-updated-jl.md).
```
aws --region region \
sagemaker update-space \
--domain-id domain-id \
--space-name space-name \
--space-settings "{
"SpaceStorageSettings": {
"EbsStorageSettings": {
"EbsVolumeSizeInGb":100
}
}
}
}"
```
------
# Eliminación de un espacio compartido
**importante**
A partir del 30 de noviembre de 2023, la experiencia anterior de Amazon SageMaker Studio pasa a denominarse Amazon SageMaker Studio Classic. La siguiente sección es específica del uso de la aplicación de Studio Classic. Para obtener información sobre el uso de la experiencia de Studio actualizada, consulte [Amazon SageMaker Studio](studio-updated.md).
Studio Classic se sigue manteniendo para las cargas de trabajo existentes, pero ya no está disponible para su incorporación. Solo puede detener o eliminar las aplicaciones de Studio Classic existentes y no puede crear aplicaciones nuevas. Te recomendamos que [migres tu carga de trabajo a la nueva experiencia de Studio](studio-updated-migrate.md).
En el siguiente tema se muestra cómo eliminar un espacio compartido de Amazon SageMaker Studio Classic de la consola Amazon SageMaker AI o AWS CLI. Solo es posible eliminar un espacio compartido si no tiene aplicaciones en ejecución.
**Topics**
+ [Consola](#domain-space-delete-console)
+ [AWS CLI](#domain-space-delete-cli)
## Consola
Complete el siguiente procedimiento para eliminar un espacio compartido en el dominio Amazon SageMaker AI de la consola SageMaker AI.
1. Abre la consola Amazon SageMaker AI en [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. En el panel de navegación izquierdo, seleccione **Configuraciones de administración**.
1. En **Configuraciones de administración**, elija **Dominios**.
1. En la lista de dominios, seleccione el dominio para el que desea crear un espacio compartido.
1. En la página **Detalles del dominio**, elija la pestaña **Administración del espacio**.
1. Seleccione el espacio compartido que desea eliminar. El espacio compartido no debe contener ninguna aplicación que no haya presentado errores.
1. Elija **Eliminar**. Se abre una nueva ventana.
1. Elija **Sí, eliminar espacio**.
1. Escribe *delete* en el campo.
1. Elija **Eliminar espacio**.
## AWS CLI
Para eliminar un espacio compartido de AWS CLI, ejecute el siguiente comando desde la terminal de su máquina local.
```
aws --region region \
sagemaker delete-space \
--domain-id domain-id \
--space-name space-name
```