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.
# Agrega RStudio soporte a un dominio existente
**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.
Si has añadido una RStudio licencia mediante AWS License Manager, puedes crear un nuevo dominio de Amazon SageMaker AI compatible con SageMaker IA. RStudio Si ya tienes un dominio que no es compatible RStudio, puedes añadir RStudio soporte a ese dominio sin tener que eliminarlo ni volver a crearlo.
En el siguiente tema se explica cómo añadir esta compatibilidad.
## Requisitos previos
Debes completar los siguientes pasos antes de actualizar tu dominio actual para añadir compatibilidad con SageMaker IA. RStudio
+ Instalar y configurar [AWS CLI versión 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Configurar [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) con las credenciales de IAM
+ Cree una función de ejecución de dominio siguiendo los pasos de [Crear un dominio de SageMaker IA RStudio con el AWS CLI](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-create-cli.html#rstudio-create-cli-domainexecution). La aplicación requiere este rol de IAM a nivel de dominio. RStudio ServerPro El rol requiere acceso a AWS License Manager para verificar una licencia válida de Posit Workbench y a Amazon CloudWatch Logs para publicar los registros del servidor.
+ [Utilice su RStudio licencia para AWS License Manager seguir los pasos que se indican en la licencia. RStudio](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html)
+ (Opcional) Si quieres usarlo RStudio en `VPCOnly` modo, completa los pasos que se indican solo [RStudio en VPC](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-network.html).
+ Asegúrese de que los grupos de seguridad que ha configurado para cada uno [UserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)de sus dominios cumplan con las cuotas a nivel de cuenta. Al configurar el perfil de usuario predeterminado durante la creación del dominio, puede utilizar el `DefaultUserSettings` parámetro de la [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)API para añadir los `SecurityGroups` que hereden todos los perfiles de usuario creados en el dominio. También puede proporcionar grupos de seguridad adicionales para un usuario específico como parte del `UserSettings` parámetro de la [CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)API. Si ha añadido grupos de seguridad de esta manera, debe asegurarse de que el número total de grupos de seguridad por perfil de usuario no supera la cuota máxima de 2 en modo `VPCOnly` y 4 en modo `PublicInternetOnly`. Si el número total resultante de grupos de seguridad para cualquier perfil de usuario supera la cuota, puede combinar las reglas de varios grupos de seguridad en un solo grupo de seguridad.
## Agregue RStudio soporte a un dominio existente
Una vez que hayas completado los requisitos previos, puedes añadir RStudio soporte a tu dominio actual. En los siguientes pasos se describe cómo actualizar tu dominio existente para añadirlo a él. RStudio
### Paso 1: eliminar todas las aplicaciones del dominio
Para añadir compatibilidad a tu dominio, SageMaker AI debe actualizar los grupos de seguridad subyacentes de todos los perfiles de usuario existentes. RStudio Para ello, tendrá que eliminar y volver a crear todas las aplicaciones existentes en el dominio. El siguiente procedimiento muestra cómo eliminar todas las aplicaciones.
1. Enumere todas las aplicaciones del dominio.
```
aws sagemaker \
list-apps \
--domain-id-equals
```
1. Elimine todas las aplicaciones de todos los perfiles de usuario del dominio.
```
// JupyterServer apps
aws sagemaker \
delete-app \
--domain-id \
--user-profile-name \
--app-type JupyterServer \
--app-name
// KernelGateway apps
aws sagemaker \
delete-app \
--domain-id \
--user-profile-name \
--app-type KernelGateway \
--app-name
```
### Paso 2: Actualice todos los perfiles de usuario con la nueva lista de grupos de seguridad
Se trata de una acción única que debe realizar para todos los perfiles de usuario existentes en el dominio una vez que se hayan refactorizado los grupos de seguridad existentes. Esto evita llegar a la cuota del número máximo de grupos de seguridad. La llamada a la `UpdateUserProfile` API falla si el usuario tiene alguna aplicación en [InService](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeApp.html#sagemaker-DescribeApp-response-Status)estado. Elimine todas las aplicaciones y, a continuación, llame a la API `UpdateUserProfile` para actualizar los grupos de seguridad.
**nota**
El siguiente requisito para el `VPCOnly` modo descrito en [Connect Amazon SageMaker Studio Classic Notebooks in a VPC to External](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-notebooks-and-internet-access.html#studio-notebooks-and-internet-access-vpc-only) Resources ya no es necesario al RStudio añadir soporte`AppSecurityGroupManagement`, ya que lo gestiona SageMaker el servicio de IA:
"[Tráfico TCP en el grupo de seguridad](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-other-instances). Esto es necesario para la conectividad entre la JupyterServer aplicación y las KernelGateway aplicaciones. Debe permitir el acceso al menos a los puertos del rango `8192-65535`”.
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
### Paso 3: Actívala RStudio llamando a la UpdateDomain API
1. Llama a la [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API para añadir compatibilidad RStudio con la SageMaker IA. El parámetro `defaultusersettings` solo es necesario si han refactorizado los grupos de seguridad predeterminados para los perfiles de usuario.
+ Para el modo `VPCOnly`:
```
aws sagemaker \
update-domain \
--domain-id \
--app-security-group-management Service \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
+ Para el modo `PublicInternetOnly`:
```
aws sagemaker \
update-domain \
--domain-id \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn=} \
--default-user-settings "{\"SecurityGroups\": [\"\", \"\"]}"
```
1. Compruebe que el estado del dominio sea `InService`. Cuando el estado del dominio sea`InService`, se añadirá RStudio la compatibilidad con SageMaker IA.
```
aws sagemaker \
describe-domain \
--domain-id
```
1. Comprueba que el estado de la RStudio ServerPro aplicación esté `InService` utilizando el siguiente comando.
```
aws sagemaker list-apps --user-profile-name domain-shared
```
### Paso 4: Añadir RStudio acceso para los usuarios existentes
Como parte de la actualización del paso 3, la SageMaker IA marca todos los perfiles RStudio [AccessStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RStudioServerProAppSettings.html#sagemaker-Type-RStudioServerProAppSettings-AccessStatus)de usuario existentes en el dominio como `DISABLED` predeterminados. Esto evita superar el número de usuarios que permite su licencia actual. Para añadir acceso a usuarios existentes deberá seguir un paso de suscripción único. Para realizar la suscripción, llama a la [UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html)API con lo siguiente: [RStudioServerProAppSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UserSettings.html#sagemaker-Type-UserSettings-RStudioServerProAppSettings)
+ `AccessStatus` = `ENABLED`
+ *Opcional* - `UserGroup` = `R_STUDIO_USER` o `R_STUDIO_ADMIN`
```
aws sagemaker \
update-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
```
**nota**
De forma predeterminada, el número de usuarios a los que se puede acceder RStudio es de 60.
### Paso 5: Desactivar el RStudio acceso para los nuevos usuarios
A menos que se especifique lo contrario al llamar`UpdateDomain`, la RStudio asistencia se añade de forma predeterminada a todos los nuevos perfiles de usuario que se creen después de añadir la compatibilidad RStudio con SageMaker IA. Para desactivar el acceso en un perfil de usuario nuevo debe establecer explícitamente el parámetro `AccessStatus` en `DISABLED` como parte de la llamada a la API `CreateUserProfile`. Si no se especifica el parámetro `AccessStatus` como parte de la API `CreateUserProfile`, el estado de acceso predeterminado es `ENABLED`.
```
aws sagemaker \
create-user-profile \
--domain-id \
--user-profile-name \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
```