Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Hinzufügen der RStudio-Unterstützung zu einer vorhandenen Domain
**Wichtig**
Benutzerdefinierte IAM-Richtlinien, die es Amazon SageMaker Studio oder Amazon SageMaker Studio Classic ermöglichen, SageMaker Amazon-Ressourcen zu erstellen, müssen auch Berechtigungen zum Hinzufügen von Tags zu diesen Ressourcen gewähren. Die Berechtigung zum Hinzufügen von Tags zu Ressourcen ist erforderlich, da Studio und Studio Classic automatisch alle von ihnen erstellten Ressourcen taggen. Wenn eine IAM-Richtlinie Studio und Studio Classic das Erstellen von Ressourcen, aber kein Tagging erlaubt, können "AccessDenied" Fehler beim Versuch, Ressourcen zu erstellen, auftreten. Weitere Informationen finden Sie unter [Erteilen Sie Berechtigungen für das Taggen von SageMaker KI-Ressourcen](security_iam_id-based-policy-examples.md#grant-tagging-permissions).
[AWS verwaltete Richtlinien für Amazon SageMaker AI](security-iam-awsmanpol.md)die Berechtigungen zum Erstellen von SageMaker Ressourcen gewähren, beinhalten bereits Berechtigungen zum Hinzufügen von Tags beim Erstellen dieser Ressourcen.
Wenn Sie eine RStudio-Lizenz hinzugefügt haben AWS License Manager, können Sie eine neue Amazon SageMaker AI-Domain mit Unterstützung für RStudio on SageMaker AI erstellen. Wenn Sie über eine bestehende Domain verfügen, die RStudio nicht unterstützt, können Sie dieser Domain RStudio-Unterstützung hinzufügen, ohne die Domain löschen und neu erstellen zu müssen.
Im folgenden Thema wird beschrieben, wie Sie diese Unterstützung hinzufügen können.
## Voraussetzungen
Sie müssen die folgenden Schritte ausführen, bevor Sie Ihre aktuelle Domain aktualisieren, um Unterstützung für RStudio on AI hinzuzufügen. SageMaker
+ Installieren und Konfigurieren von [AWS CLI Version 2](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)
+ Konfigurieren Sie das [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) mit IAM-Anmeldeinformationen
+ Erstellen Sie eine Domain-Ausführungsrolle gemäß den Schritten unter [Erstellen einer SageMaker AI-Domäne mit RStudio mithilfe von](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-create-cli.html#rstudio-create-cli-domainexecution). AWS CLI Diese IAM-Rolle auf Domänenebene ist für die App erforderlich. RStudioServerPro Die Rolle erfordert Zugriff auf AWS License Manager zur Überprüfung einer gültigen Posit Workbench-Lizenz und Amazon CloudWatch Logs zur Veröffentlichung von Serverprotokollen.
+ [Bringen Sie Ihre RStudio-Lizenz dazu, den Schritten in der RStudio-Lizenz zu AWS License Manager folgen.](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-license.html)
+ [(Optional) Wenn Sie RStudio im `VPCOnly` Modus verwenden möchten, führen Sie die Schritte in RStudio in aus. VPC-Only](https://docs.aws.amazon.com/sagemaker/latest/dg/rstudio-network.html)
+ Stellen Sie sicher, dass die Sicherheitsgruppen, die Sie für jede Sicherheitsgruppe [UserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)in Ihrer Domain konfiguriert haben, die Kontingente auf Kontoebene erfüllen. Wenn Sie das Standardbenutzerprofil bei der Domainerstellung konfigurieren, können Sie mithilfe der `DefaultUserSettings` [CreateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateDomain.html)API-Parameter die Werte hinzufügen`SecurityGroups`, die von allen in der Domäne erstellten Benutzerprofilen übernommen werden. Sie können auch zusätzliche Sicherheitsgruppen für einen bestimmten Benutzer als Teil des `UserSettings` [CreateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreateUserProfile.html)API-Parameters angeben. Wenn Sie Sicherheitsgruppen auf diese Weise hinzugefügt haben, müssen Sie sicherstellen, dass die Gesamtzahl der Sicherheitsgruppen pro Benutzerprofil das maximale Kontingent von 2 im `VPCOnly` Modus und 4 im `PublicInternetOnly` Modus nicht überschreitet. Wenn die resultierende Gesamtzahl der Sicherheitsgruppen für ein Benutzerprofil das Kontingent überschreitet, können Sie die Regeln mehrerer Sicherheitsgruppen zu einer Sicherheitsgruppe zusammenfassen.
## Hinzufügen der RStudio-Unterstützung zu einer vorhandenen Domain
Nachdem Sie die Voraussetzungen erfüllt haben, können Sie Ihrer vorhandenen Domain RStudio-Unterstützung hinzufügen. In den folgenden Schritten wird beschrieben, wie Sie Ihre bestehende Domain aktualisieren, um Unterstützung für RStudio hinzuzufügen.
### Schritt 1: Löschen aller Apps in der Domain
Um Unterstützung für RStudio in Ihrer Domain hinzuzufügen, muss SageMaker AI die zugrunde liegenden Sicherheitsgruppen für alle vorhandenen Benutzerprofile aktualisieren. Um dies abzuschließen, müssen Sie alle vorhandenen Apps in der Domain löschen und erneut erstellen. Die folgenden Schritte zeigen, wie Sie alle Apps löschen.
1. Listen Sie alle Apps in der Domain auf.
```
aws sagemaker \
list-apps \
--domain-id-equals {{}}
```
1. Löschen Sie jede App für jedes Benutzerprofil in der Domain.
```
// 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 {{}}
```
### Schritt 2 – Aktualisieren Sie alle Benutzerprofile mit der neuen Liste von Sicherheitsgruppen
Dies ist eine einmalige Aktion, die Sie für alle vorhandenen Benutzerprofile in Ihrer Domain ausführen müssen, wenn Sie Ihre vorhandenen Sicherheitsgruppen überarbeitet haben. Dadurch wird verhindert, dass Sie das Kontingent für die maximale Anzahl von Sicherheitsgruppen erreichen. Der `UpdateUserProfile` API-Aufruf schlägt fehl, wenn der Benutzer Apps hat, die sich im [InService](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_DescribeApp.html#sagemaker-DescribeApp-response-Status)Status befinden. Löschen Sie alle Apps und rufen Sie dann die `UpdateUserProfile` API auf, um die Sicherheitsgruppen zu aktualisieren.
**Anmerkung**
Die folgende Anforderung für den `VPCOnly` Modus, die unter [Amazon SageMaker Studio Classic-Notebooks in einer VPC mit externen Ressourcen Connect](https://docs.aws.amazon.com/sagemaker/latest/dg/studio-notebooks-and-internet-access.html#studio-notebooks-and-internet-access-vpc-only) beschrieben ist, ist beim Hinzufügen von RStudio-Unterstützung nicht mehr erforderlich, da sie vom SageMaker AI-Service verwaltet `AppSecurityGroupManagement` wird:
[TCP-Verkehr innerhalb der Sicherheitsgruppe](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/security-group-rules-reference.html#sg-rules-other-instances). Dies ist für die Konnektivität zwischen der JupyterServer App und den KernelGateway Apps erforderlich. Sie müssen den Zugriff auf mindestens Ports im Bereich `8192-65535`“ zulassen.
```
aws sagemaker \
update-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
### Schritt 3 — Aktivieren Sie RStudio, indem Sie die UpdateDomain API aufrufen
1. Rufen Sie die [UpdateDomain](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateDomain.html)API auf, um Unterstützung für RStudio on SageMaker AI hinzuzufügen. Der `defaultusersettings` Parameter wird nur benötigt, wenn Sie die Standardsicherheitsgruppen für Ihre Benutzerprofile überarbeitet haben.
+ Für `VPCOnly`-Modus:
```
aws sagemaker \
update-domain \
--domain-id {{}} \
--app-security-group-management Service \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn={{}}} \
--default-user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
+ Für `PublicInternetOnly`-Modus:
```
aws sagemaker \
update-domain \
--domain-id {{}} \
--domain-settings-for-update RStudioServerProDomainSettingsForUpdate={DomainExecutionRoleArn={{}}} \
--default-user-settings "{\"SecurityGroups\": [\"{{}}\", \"{{}}\"]}"
```
1. Überprüfen Sie, ob der Domainstatus `InService` lautet. Sobald der Domainstatus lautet`InService`, wird Unterstützung für RStudio on SageMaker AI hinzugefügt.
```
aws sagemaker \
describe-domain \
--domain-id {{}}
```
1. Stellen Sie `InService` mithilfe des folgenden Befehls sicher, dass der Status der RStudioServerPro App lautet.
```
aws sagemaker list-apps --user-profile-name domain-shared
```
### Schritt 4 – RStudio-Zugriff für bestehende Benutzer hinzufügen
Im Rahmen des Updates in Schritt 3 markiert SageMaker AI das RStudio [AccessStatus](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_RStudioServerProAppSettings.html#sagemaker-Type-RStudioServerProAppSettings-AccessStatus)aller vorhandenen Benutzerprofile in der Domain als `DISABLED` Standard. Dadurch wird verhindert, dass die in Ihrer aktuellen Lizenz zulässige Anzahl von Benutzern überschritten wird. Um den Zugriff für bestehende Benutzer hinzuzufügen, gibt es einen einmaligen Anmeldeschritt. Führen Sie das Opt-In durch, indem Sie die [UpdateUserProfile](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UpdateUserProfile.html)API wie folgt aufrufen: [RStudioServerProAppSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_UserSettings.html#sagemaker-Type-UserSettings-RStudioServerProAppSettings)
+ `AccessStatus` = `ENABLED`
+ *Optional* – `UserGroup` = `R_STUDIO_USER` oder `R_STUDIO_ADMIN`
```
aws sagemaker \
update-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"ENABLED\"}}"
```
**Anmerkung**
Standardmäßig beträgt die Anzahl der Benutzer, die Zugriff auf RStudio haben können, 60.
### Schritt 5 – Deaktivieren Sie den RStudio-Zugriff für neue Benutzer
Sofern beim Aufrufen nicht anders angegeben`UpdateDomain`, wird RStudio-Unterstützung standardmäßig für alle neuen Benutzerprofile hinzugefügt, die erstellt wurden, nachdem Sie Unterstützung für RStudio on AI hinzugefügt haben. SageMaker Um den Zugriff für ein neues Benutzerprofil zu deaktivieren, müssen Sie den Parameter `AccessStatus` im Rahmen des API-Aufrufs `DISABLED` ausdrücklich auf `CreateUserProfile` setzen. Wenn der `AccessStatus` Parameter nicht als Teil der `CreateUserProfile` API angegeben ist, lautet der Standardzugriffsstatus `ENABLED`.
```
aws sagemaker \
create-user-profile \
--domain-id {{}}\
--user-profile-name {{}} \
--user-settings "{\"RStudioServerProAppSettings\": {\"AccessStatus\": \"DISABLED\"}}"
```