Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Aggiunta del supporto per RStudio a un dominio esistente
**Importante**
Le politiche IAM personalizzate che consentono ad Amazon SageMaker Studio o Amazon SageMaker Studio Classic di creare SageMaker risorse Amazon devono inoltre concedere le autorizzazioni per aggiungere tag a tali risorse. L’autorizzazione per aggiungere tag alle risorse è necessaria perché Studio e Studio Classic applicano automaticamente tag a tutte le risorse che creano. Se una policy IAM consente a Studio e Studio Classic di creare risorse ma non consente il tagging, possono verificarsi errori durante il tentativo di creare risorse. AccessDenied Per ulteriori informazioni, consulta [Fornisci le autorizzazioni per etichettare SageMaker le risorse AI](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS politiche gestite per Amazon AI SageMaker](security-iam-awsmanpol.md)che forniscono le autorizzazioni per creare SageMaker risorse includono già le autorizzazioni per aggiungere tag durante la creazione di tali risorse.
Se hai aggiunto una licenza RStudio tramite AWS License Manager, puoi creare un nuovo dominio Amazon SageMaker AI con supporto per RStudio on AI. SageMaker Se un dominio esistente non supporta RStudio, puoi aggiungere il supporto per RStudio senza dover eliminare e ricreare il dominio.
L'argomento seguente descrive come aggiungere questo supporto.
## Prerequisiti
È necessario completare i passaggi seguenti prima di aggiornare il dominio corrente per aggiungere il supporto per RStudio on AI. SageMaker
+ Installazione e configurazione [AWS CLI versione 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Configurazione di [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) con credenziali IAM
+ Crea un ruolo di esecuzione del dominio seguendo i passaggi in [ Crea un dominio SageMaker AI con RStudio utilizzando il. AWS CLI](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-create-cli.html#rstudio-create-cli-domainexecution) Questo ruolo IAM a livello di dominio è richiesto dall'app. RStudioServerPro Il ruolo richiede l'accesso a AWS License Manager per verificare una licenza Posit Workbench valida e ad Amazon CloudWatch Logs per la pubblicazione dei log del server.
+ Porta la tua licenza RStudio a AWS License Manager seguire i passaggi della licenza RStudio. [https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html)
+ (Facoltativo) Se desideri utilizzare RStudio in `VPCOnly` modalità, completa i passaggi in RStudio in[. VPC-Only ](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-network.html)
+ Assicurati che i gruppi di sicurezza che hai configurato per ciascuno del tuo dominio soddisfino le quote [ UserProfile ](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html) a livello di account. Quando configuri il profilo utente predefinito durante la creazione del dominio, puoi utilizzare il `DefaultUserSettings` parametro dell'[CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)API da aggiungere`SecurityGroups`, ereditato da tutti i profili utente creati nel dominio. Puoi anche fornire gruppi di sicurezza aggiuntivi per un utente specifico come parte del `UserSettings` parametro dell'[CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)API. Se hai aggiunto gruppi di sicurezza in questo modo, devi assicurarti che il numero totale di gruppi di sicurezza per profilo utente non superi la quota massima di 2 in modalità `VPCOnly` e 4 in modalità `PublicInternetOnly`. Se il numero totale di gruppi di sicurezza risultante per ogni profilo utente supera la quota, puoi combinare le regole di più gruppi di sicurezza in un unico gruppo di sicurezza.
## Aggiunta del supporto per RStudio a un dominio esistente
Dopo aver completato i prerequisiti, puoi aggiungere il supporto per RStudio al tuo dominio esistente. Nelle fasi seguenti viene descritto come aggiornare il dominio esistente per aggiungere il supporto per RStudio.
### Fase 1. Elimina tutte le app nel dominio
Per aggiungere il supporto per RStudio nel tuo dominio, l' SageMaker IA deve aggiornare i gruppi di sicurezza sottostanti per tutti i profili utente esistenti. Per completare questa operazione, devi eliminare tutte le app esistenti nel dominio e crearle di nuovo. Di seguito viene mostrato come eliminare tutte le app.
1. Elenca tutte le app del dominio.
```
aws sagemaker \
list-apps \
--domain-id-equals {{}}
```
1. Elimina tutte le app per ogni profilo utente nel 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 {{}}
```
### Fase 2: aggiornare tutti i profili utente con il nuovo elenco di gruppi di sicurezza
Questa è un’azione una tantum che devi completare per tutti i profili utente esistenti nel tuo dominio dopo aver rifattorizzato i gruppi di sicurezza esistenti. Ciò impedisce di raggiungere la quota per il numero massimo di gruppi di sicurezza. La chiamata `UpdateUserProfile` API ha esito negativo se l'utente dispone di app in [ InService ](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeApp.html#sagemaker-DescribeApp-response-Status) stato. Elimina tutte le app, quindi chiama l'API `UpdateUserProfile` per aggiornare i gruppi di sicurezza.
**Nota**
Il seguente requisito per la `VPCOnly` modalità delineato in [ Connect Amazon SageMaker Studio Classic Notebooks in a VPC to External Resources non ](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-notebooks-and-internet-access.html#studio-notebooks-and-internet-access-vpc-only) è più necessario quando si aggiunge il supporto RStudio perché `AppSecurityGroupManagement` è gestito dal servizio AI: SageMaker
“[Traffico TCP all'interno del gruppo di sicurezza](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-other-instances). Questo è necessario per la connettività tra l'app e le app. JupyterServer KernelGateway È necessario consentire l'accesso ad almeno le porte dell'intervallo `8192-65535`.”
```
aws sagemaker \
update-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
### Passaggio 3: attiva RStudio chiamando l'API UpdateDomain
1. Chiama l'[UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API per aggiungere il supporto per RStudio on SageMaker AI. Il parametro `defaultusersettings` è necessario solo se hai rifattorizzato i gruppi di sicurezza predefiniti per i tuoi profili utente.
+ Per la modalità `VPCOnly`:
```
aws sagemaker \
update-domain \
--domain-id {{}} \
--app-security-group-management Service \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn={{}}} \
--default-user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
+ Per la modalità `PublicInternetOnly`:
```
aws sagemaker \
update-domain \
--domain-id {{}} \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn={{}}} \
--default-user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
1. Verifica che lo stato del dominio sia `InService`. Dopo lo stato del dominio`InService`, viene aggiunto il supporto per RStudio on SageMaker AI.
```
aws sagemaker \
describe-domain \
--domain-id {{}}
```
1. Verifica che lo stato dell' RStudioServerPro app stia `InService` utilizzando il seguente comando.
```
aws sagemaker list-apps --user-profile-name domain-shared
```
### Fase 4: aggiungere l'accesso a RStudio per gli utenti esistenti
Come parte dell'aggiornamento nella Fase 3, SageMaker AI contrassegna RStudio [ AccessStatus ](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RStudioServerProAppSettings.html#sagemaker-Type-RStudioServerProAppSettings-AccessStatus) di tutti i profili utente esistenti nel dominio come `DISABLED` predefinito. Ciò impedisce il superamento del numero di utenti consentito dalla licenza corrente. Per aggiungere l'accesso per gli utenti esistenti, è disponibile una sola fase di attivazione. Esegui l'opt-in chiamando l'[UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html)API con quanto segue: [ RStudioServerProAppSettings ](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UserSettings.html#sagemaker-Type-UserSettings-RStudioServerProAppSettings)
+ `AccessStatus` = `ENABLED`
+ *Facoltativo* - `UserGroup` = `R_STUDIO_USER` o `R_STUDIO_ADMIN`
```
aws sagemaker \
update-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
```
**Nota**
Per impostazione predefinita, il numero di utenti che possono accedere a RStudio è 60.
### Fase 5: disattivare l'accesso a RStudio per i nuovi utenti
Salvo diversa indicazione al momento della chiamata`UpdateDomain`, il supporto RStudio viene aggiunto per impostazione predefinita per tutti i nuovi profili utente creati dopo aver aggiunto il supporto per RStudio on AI. SageMaker Per disattivare l'accesso per un nuovo profilo utente, è necessario impostare esplicitamente il parametro `AccessStatus` su `DISABLED` come parte della chiamata API `CreateUserProfile`. Se il parametro `AccessStatus` non è specificato come parte dell'API `CreateUserProfile`, lo stato di accesso predefinito è `ENABLED`.
```
aws sagemaker \
create-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
```