As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Migrar a interface do usuário do Studio Classic para o Studio
A primeira fase para migrar um domínio existente envolve a migração da interface do usuário do Amazon SageMaker Studio Classic para o Amazon SageMaker Studio. Essa fase não inclui a migração de dados. Os usuários podem continuar trabalhando com seus dados da mesma forma que faziam antes da migração. Para obter informações sobre a migração de dados, consulte [(Opcional) Migrar dados do Studio Classic para o Studio](studio-updated-migrate-data.md).
A fase 1 consiste nas seguintes etapas:
1. Atualizar as permissões de criação de aplicações para novas aplicações disponíveis no Studio.
1. Atualizar a configuração da VPC para o domínio.
1. Atualizar o domínio para usar a interface do Studio.
## Pré-requisitos
Para configurar esses pré-requisitos, conclua as etapas em [Pré-requisitos completos para migrar a experiência do Studio](studio-updated-migrate-prereq.md).
## Etapa 1: atualizar as permissões de criação de aplicações
Antes de migrar o domínio, atualize a função de execução do domínio para conceder aos usuários permissões para criar aplicações.
1. Crie uma AWS Identity and Access Management política com um dos conteúdos a seguir seguindo as etapas em [Criação de políticas do IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_create.html):
+ Use a política a seguir para conceder permissões para todos os tipos e espaços de aplicações.
**nota**
Se o domínio usar a política `SageMakerFullAccess`, não será necessário executar essa ação. `SageMakerFullAccess` concede permissões para criar todas as aplicações.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "SMStudioUserProfileAppPermissionsCreateAndDelete",
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/*",
"Condition": {
"Null": {
"sagemaker:OwnerUserProfileArn": "true"
}
}
},
{
"Sid": "SMStudioCreatePresignedDomainUrlForUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreatePresignedDomainUrl"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/${sagemaker:DomainId}/${sagemaker:UserProfileName}"
},
{
"Sid": "SMStudioAppPermissionsListAndDescribe",
"Effect": "Allow",
"Action": [
"sagemaker:ListApps",
"sagemaker:ListDomains",
"sagemaker:ListUserProfiles",
"sagemaker:ListSpaces",
"sagemaker:DescribeApp",
"sagemaker:DescribeDomain",
"sagemaker:DescribeUserProfile",
"sagemaker:DescribeSpace"
],
"Resource": "*"
},
{
"Sid": "SMStudioAppPermissionsTagOnCreate",
"Effect": "Allow",
"Action": [
"sagemaker:AddTags"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:*/*",
"Condition": {
"Null": {
"sagemaker:TaggingAction": "false"
}
}
},
{
"Sid": "SMStudioRestrictSharedSpacesWithoutOwners",
"Effect": "Allow",
"Action": [
"sagemaker:CreateSpace",
"sagemaker:UpdateSpace",
"sagemaker:DeleteSpace"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:space/${sagemaker:DomainId}/*",
"Condition": {
"Null": {
"sagemaker:OwnerUserProfileArn": "true"
}
}
},
{
"Sid": "SMStudioRestrictSpacesToOwnerUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreateSpace",
"sagemaker:UpdateSpace",
"sagemaker:DeleteSpace"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:space/${sagemaker:DomainId}/*",
"Condition": {
"ArnLike": {
"sagemaker:OwnerUserProfileArn": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/${sagemaker:DomainId}/${sagemaker:UserProfileName}"
},
"StringEquals": {
"sagemaker:SpaceSharingType": [
"Private",
"Shared"
]
}
}
},
{
"Sid": "SMStudioRestrictCreatePrivateSpaceAppsToOwnerUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/${sagemaker:DomainId}/*",
"Condition": {
"ArnLike": {
"sagemaker:OwnerUserProfileArn": "arn:aws:sagemaker:us-east-1:111122223333:user-profile/${sagemaker:DomainId}/${sagemaker:UserProfileName}"
},
"StringEquals": {
"sagemaker:SpaceSharingType": [
"Private"
]
}
}
},
{
"Sid": "AllowAppActionsForSharedSpaces",
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:*:*:app/${sagemaker:DomainId}/*/*/*",
"Condition": {
"StringEquals": {
"sagemaker:SpaceSharingType": [
"Shared"
]
}
}
}
]
}
```
------
+ Como o Studio mostra um conjunto expandido de aplicações, os usuários podem ter acesso a aplicações que não foram exibidos antes. Os administradores podem limitar o acesso a esses aplicativos padrão criando uma política AWS Identity and Access Management (IAM) que concede permissões negadas para alguns aplicativos a usuários específicos.
**nota**
O tipo de aplicação pode ser `jupyterlab` ou `codeeditor`.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DenySageMakerCreateAppForSpecificAppTypes",
"Effect": "Deny",
"Action": "sagemaker:CreateApp",
"Resource": "arn:aws:sagemaker:us-east-1:111122223333:app/domain-id/*/app-type/*"
}
]
}
```
------
1. Anexar a política ao perfil de execução do domínio. Para obter instruções, siga as etapas em [Adicionar permissões de identidade do IAM (console)](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies_manage-attach-detach.html#add-policies-console).
## Etapa 2: atualizar a configuração da VPC
Se você usa seu domínio no modo `VPC-Only`, certifique-se de que sua configuração da VPC atenda aos requisitos para usar o Studio no modo `VPC-Only`. Para obter mais informações, consulte [Conecte o Amazon SageMaker Studio em uma VPC a recursos externos](studio-updated-and-internet-access.md).
## Etapa 3: atualizar para a interface de usuário do Studio
Antes de migrar seu domínio existente do Studio Classic para o Studio, recomendamos criar um domínio de teste usando o Studio com as mesmas configurações do seu domínio existente.
### (Opcional) Criar um domínio de teste
Use esse domínio de teste para interagir com o Studio, testar configurações de rede e iniciar aplicações antes de migrar o domínio existente.
1. Obtenha o ID de domínio do seu domínio existente.
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador** e selecione **Domínios**.
1. Escolha o domínio existente.
1. Na página **Detalhes do Domínio**, escolha a guia **Configurações do Domínio**.
1. Copie o **ID do domínio**.
1. Adicione o ID de domínio do seu domínio existente.
```
export REF_DOMAIN_ID="domain-id"
export SM_REGION="region"
```
1. Use `describe-domain` para obter informações importantes sobre o domínio existente.
```
export REF_EXECROLE=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.DefaultUserSettings.ExecutionRole')
export REF_VPC=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.VpcId')
export REF_SIDS=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.SubnetIds | join(",")')
export REF_SGS=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.DefaultUserSettings.SecurityGroups | join(",")')
export AUTHMODE=$(aws sagemaker describe-domain --region=$SM_REGION --domain-id=$REF_DOMAIN_ID | jq -r '.AuthMode')
```
1. Valide os parâmetros.
```
echo "Execution Role: $REF_EXECROLE || VPCID: $REF_VPC || SubnetIDs: $REF_SIDS || Security GroupIDs: $REF_SGS || AuthMode: $AUTHMODE"
```
1. Crie um domínio de teste usando as configurações do domínio existente.
```
IFS=',' read -r -a subnet_ids <<< "$REF_SIDS"
IFS=',' read -r -a security_groups <<< "$REF_SGS"
security_groups_json=$(printf '%s\n' "${security_groups[@]}" | jq -R . | jq -s .)
aws sagemaker create-domain \
--domain-name "TestV2Config" \
--vpc-id $REF_VPC \
--auth-mode $AUTHMODE \
--subnet-ids "${subnet_ids[@]}" \
--app-network-access-type VpcOnly \
--default-user-settings "
{
\"ExecutionRole\": \"$REF_EXECROLE\",
\"StudioWebPortal\": \"ENABLED\",
\"DefaultLandingUri\": \"studio::\",
\"SecurityGroups\": $security_groups_json
}
"
```
1. Depois que o domínio de teste for `In Service`, use o ID do domínio de teste para criar um perfil de usuário. Esse perfil de usuário é usado para iniciar e testar aplicações.
```
aws sagemaker create-user-profile \
--region="$SM_REGION" --domain-id=test-domain-id \
--user-profile-name test-network-user
```
#### Testar funcionalidade do Studio
Inicie o domínio de teste usando o perfil do usuário `test-network-user`. Sugerimos que você teste minuciosamente a interface do usuário do Studio e crie aplicações para testar a funcionalidade do Studio no modo `VPCOnly`. Teste os seguintes fluxos de trabalho:
+ Crie um novo JupyterLab espaço, teste o ambiente e a conectividade.
+ Criar um novo editor de código, baseado em Code-OSS, Visual Studio Code - Open Source Space, ambiente de teste e conectividade.
+ Inicie um nova aplicação Studio Classic, teste o ambiente e a conectividade.
+ Testar a conectividade do Amazon Simple Storage Service com ações de teste de leitura e gravação.
Se esses testes forem bem-sucedidos, atualize o domínio existente. Se você encontrar alguma falha, recomendamos corrigir seus problemas de ambiente e conectividade antes de atualizar o domínio existente.
#### Limpar os recursos do domínio de teste
Depois de migrar o domínio existente, limpe os recursos do domínio de teste.
1. Adicione o ID do domínio de teste.
```
export TEST_DOMAIN="test-domain-id"
export SM_REGION="region"
```
1. Liste todos as aplicações no domínio que estão em execução.
```
active_apps_json=$(aws sagemaker list-apps --region=$SM_REGION --domain-id=$TEST_DOMAIN)
echo $active_apps_json
```
1. Analise a lista JSON de aplicações em execução e exclua-os. Se os usuários tentarem criar uma aplicação para o qual não têm permissões, pode haver espaços que não foram capturados no script a seguir. Será necessário excluir esses espaços manualmente.
```
echo "$active_apps_json" | jq -c '.Apps[]' | while read -r app;
do
if echo "$app" | jq -e '. | has("SpaceName")' > /dev/null;
then
app_type=$(echo "$app" | jq -r '.AppType')
app_name=$(echo "$app" | jq -r '.AppName')
domain_id=$(echo "$app" | jq -r '.DomainId')
space_name=$(echo "$app" | jq -r '.SpaceName')
echo "Deleting App - AppType: $app_type || AppName: $app_name || DomainId: $domain_id || SpaceName: $space_name"
aws sagemaker delete-app --region=$SM_REGION --domain-id=$domain_id \
--app-type $app_type --app-name $app_name --space-name $space_name
echo "Deleting Space - AppType: $app_type || AppName: $app_name || DomainId: $domain_id || SpaceName: $space_name"
aws sagemaker delete-space --region=$SM_REGION --domain-id=$domain_id \
--space-name $space_name
else
app_type=$(echo "$app" | jq -r '.AppType')
app_name=$(echo "$app" | jq -r '.AppName')
domain_id=$(echo "$app" | jq -r '.DomainId')
user_profile_name=$(echo "$app" | jq -r '.UserProfileName')
echo "Deleting Studio Classic - AppType: $app_type || AppName: $app_name || DomainId: $domain_id || UserProfileName: $user_profile_name"
aws sagemaker delete-app --region=$SM_REGION --domain-id=$domain_id \
--app-type $app_type --app-name $app_name --user-profile-name $user_profile_name
fi
done
```
1. Exclua o perfil de usuário de teste.
```
aws sagemaker delete-user-profile \
--region=$SM_REGION --domain-id=$TEST_DOMAIN \
--user-profile-name "test-network-user"
```
1. Exclua o domínio de teste.
```
aws sagemaker delete-domain \
--region=$SM_REGION --domain-id=$TEST_DOMAIN
```
Depois de testar a funcionalidade do Studio com as configurações em seu domínio de teste, migre o domínio existente. Quando o Studio é a experiência padrão para um domínio, o Studio é a experiência padrão para todos os usuários no domínio. No entanto, as configurações do usuário têm precedência sobre as configurações do domínio. Portanto, se um usuário tiver sua experiência padrão definida como Studio Classic em suas configurações de usuário, esse usuário terá o Studio Classic como experiência padrão.
Você pode migrar o domínio existente atualizando-o no console de SageMaker IA AWS CLI, no ou AWS CloudFormation. Escolha uma das guias a seguir para visualizar as instruções relevantes.
### Defina o Studio como a experiência padrão para o domínio existente usando o console SageMaker AI
Você pode definir o Studio como a experiência padrão para o domínio existente usando o console de SageMaker IA.
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador** e selecione **Domínios**.
1. Escolha o domínio existente para o qual você quer habilitar o Studio como a experiência padrão.
1. Na página de **Detalhes do domínio**, abra **Ativar o novo Studio**.
1. (Opcional) Para ver os detalhes sobre as etapas envolvidas na ativação do Studio como sua experiência padrão, escolha **Exibir detalhes**. A página mostra o seguinte:
+ Na seção **Visão geral do SageMaker Studio**, você pode ver os aplicativos incluídos ou disponíveis na interface web do Studio.
+ Na seção **Processo de capacitação**, você pode ver as descrições das tarefas do fluxo de trabalho para habilitar o Studio.
**nota**
Você precisará migrar seus dados manualmente. Para obter instruções sobre como migrar seus dados, consulte [(Opcional) Migrar dados do Studio Classic para o Studio](studio-updated-migrate-data.md).
+ Na seção **Reverter para a experiência do Studio Classic**, você pode ver como voltar para o Studio Classic depois de ativar o Studio como sua experiência padrão.
1. Para iniciar o processo de habilitar o Studio como sua experiência padrão, escolha **Habilitar o novo Studio**.
1. Na seção **Especificar e configurar a função**, você pode visualizar as aplicações padrão que são incluídos automaticamente no Studio.
Para impedir que os usuários executem esses aplicações, escolha o perfil do AWS Identity and Access Management (IAM) que tem uma política do IAM que nega o acesso. Para obter informações sobre como criar uma política para limitar o acesso, consulte [Etapa 1: atualizar as permissões de criação de aplicações](#studio-updated-migrate-limit-apps).
1. Na seção **Escolha o bucket padrão do S3 para anexar a política do CORS**, você pode dar ao Studio acesso aos buckets do Amazon S3. O bucket padrão do Amazon S3, nesse caso, é o bucket padrão do Amazon S3 para o Studio Classic. Nesta etapa, você pode fazer o seguinte:
+ Verifique o bucket Amazon S3 padrão do domínio ao qual anexar a política do CORS. Se o seu domínio não tiver um bucket padrão do Amazon S3, a SageMaker AI cria um bucket do Amazon S3 com a política de CORS correta anexada.
+ Você pode incluir 10 buckets adicionais do Amazon S3 aos quais anexar a política do CORS.
Se quiser incluir mais de 10 buckets, você pode adicioná-los manualmente. Para obter mais informações sobre como anexar manualmente a política CORS aos buckets do Amazon S3, consulte [(Opcional) Atualizar a política CORS para acessar os buckets do Amazon S3](#studio-updated-migrate-cors).
Para continuar, marque a caixa de seleção ao lado de **Você concorda em substituir alguma política de CORS existente nos buckets do Amazon S3 escolhidos?**.
1. A seção **Migrar dados** contém informações sobre os diferentes volumes de armazenamento de dados do Studio Classic e do Studio. Seus dados não serão migrados automaticamente por meio desse processo. Para obter instruções sobre como migrar seus dados, configurações de ciclo de vida e JupyterLab extensões, consulte. [(Opcional) Migrar dados do Studio Classic para o Studio](studio-updated-migrate-data.md)
1. Depois de concluir as tarefas na página e verificar sua configuração, escolha **Habilitar o novo Studio**.
### Defina o Studio como a experiência padrão para o domínio existente usando o AWS CLI
Para definir o Studio como a experiência padrão para o domínio existente usando a AWS CLI, use a chamada [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html). Você deve definir `ENABLED` como o valor para `StudioWebPortal` e definir `studio::` como o valor para `DefaultLandingUri` como parte do parâmetro `default-user-settings`.
`StudioWebPortal` indica se a experiência do Studio é a experiência padrão e `DefaultLandingUri` indica a experiência padrão para a qual o usuário é direcionado ao acessar o domínio. Neste exemplo, definir esses valores em um nível de domínio (no `default-user-settings`) torna o Studio a experiência padrão para usuários dentro do domínio.
Se um usuário dentro do domínio tiver seu `StudioWebPortal` definido como `DISABLED` e `DefaultLandingUri` definido como `app:JupyterServer:` em um nível de usuário (no `UserSettings`), isso terá precedência sobre as configurações do domínio. Em outras palavras, esse usuário terá o Studio Classic como sua experiência padrão, independentemente das configurações do domínio.
O seguinte exemplo de código mostra como definir o Studio como a experiência padrão para usuários no domínio:
```
aws sagemaker update-domain \
--domain-id existing-domain-id \
--region Região da AWS \
--default-user-settings '
{
"StudioWebPortal": "ENABLED",
"DefaultLandingUri": "studio::"
}
'
```
+ Para obter o `existing-domain-id`, use as seguintes instruções:
**Para obter o `existing-domain-id`**
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador** e selecione **Domínios**.
1. Escolha o domínio existente.
1. Na página **Detalhes do Domínio**, escolha a guia **Configurações do Domínio**.
1. Copie o **ID do domínio**.
+ Para garantir que você esteja usando o correto Região da AWS para seu domínio, use as seguintes instruções:
**Para obter o `Região da AWS`**
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador** e selecione **Domínios**.
1. Escolha o domínio existente.
1. Na página **Detalhes do domínio**, verifique se esse é o domínio existente.
1. Expanda a lista Região da AWS suspensa no canto superior direito do console de SageMaker IA e use o Região da AWS ID correspondente à direita do seu Região da AWS nome. Por exemplo, .`us-west-1`
Depois de migrar sua experiência padrão para o Studio, você pode dar ao Studio acesso aos buckets do Amazon S3. Por exemplo, você pode incluir acesso ao seu bucket Amazon S3 padrão do Studio Classic e buckets adicionais do Amazon S3. Para fazer isso, você deve anexar manualmente uma configuração de [Compartilhamento de recursos de origem cruzada](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) (CORS) aos buckets do Amazon S3. Para obter mais informações sobre como anexar manualmente a política do CORS aos buckets do Amazon S3, consulte [(Opcional) Atualizar a política CORS para acessar os buckets do Amazon S3](#studio-updated-migrate-cors).
Da mesma forma, você pode definir o Studio como a experiência padrão ao criar um domínio AWS CLI usando a chamada [create-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/create-domain.html).
### Defina o Studio como a experiência padrão para o domínio existente usando o AWS CloudFormation
Você pode definir a experiência padrão ao criar um domínio usando o AWS CloudFormation. Para obter um modelo de CloudFormation migração, consulte [Modelos de IaC do SageMaker Studio Administrator](https://github.com/aws-samples/sagemaker-studio-admin-iac-templates/tree/main?tab=readme-ov-file#phase-1-migration). Para obter mais informações sobre como criar um domínio usando CloudFormation, consulte [Criação de domínio Amazon SageMaker AI usando CloudFormation](https://github.com/aws-samples/cloudformation-studio-domain?tab=readme-ov-file#creating-sagemaker-studio-domains-using-cloudformation).
Para obter informações sobre o recurso de domínio suportado pelo AWS CloudFormation, consulte [AWS:: SageMaker AI: :Domain](https://docs.aws.amazon.com//AWSCloudFormation/latest/UserGuide/aws-resource-sagemaker-domain.html#cfn-sagemaker-domain-defaultusersettings).
Depois de migrar sua experiência padrão para o Studio, você pode dar ao Studio acesso aos buckets do Amazon S3. Por exemplo, você pode incluir acesso ao seu bucket Amazon S3 padrão do Studio Classic e buckets adicionais do Amazon S3. Para fazer isso, você deve anexar manualmente uma configuração de [Compartilhamento de recursos de origem cruzada](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) (CORS) aos buckets do Amazon S3. Para obter informações sobre como anexar manualmente a política do CORS aos seus buckets do Amazon S3, consulte [(Opcional) Atualizar a política CORS para acessar os buckets do Amazon S3](#studio-updated-migrate-cors).
### (Opcional) Atualizar a política CORS para acessar os buckets do Amazon S3
No Studio Classic, os usuários podem criar, listar e carregar arquivos para buckets do Amazon Simple Storage Service (Amazon S3). Para oferecer apoio à mesma experiência no Studio, os administradores devem anexar uma configuração de [Compartilhamento de recursos de origem cruzada](https://developer.mozilla.org/en-US/docs/Web/HTTP/CORS) (CORS) aos buckets do Amazon S3. Isso é necessário porque o Studio faz chamadas para o Amazon S3 a partir do navegador da Internet. O navegador invoca o CORS em nome dos usuários. Como resultado, todas as solicitações para os buckets do Amazon S3 falham, a menos que a política do CORS esteja anexada aos buckets do Amazon S3.
Talvez seja necessário anexar manualmente a política do CORS aos buckets do Amazon S3 pelos seguintes motivos:
+ Se já houver um bucket padrão do Amazon S3 que não tenha a política CORS correta anexada quando você migra a experiência padrão do domínio existente para o Studio.
+ Se você estiver usando o AWS CLI para migrar a experiência padrão do domínio existente para o Studio. Para obter informações sobre como usar o AWS CLI para migrar, consulte[Defina o Studio como a experiência padrão para o domínio existente usando o AWS CLI](#studio-updated-migrate-set-studio-updated-cli).
+ Se você quiser anexar a política do CORS a buckets adicionais do Amazon S3.
**nota**
Se você planeja usar o console de SageMaker IA para habilitar o Studio como sua experiência padrão, os buckets do Amazon S3 aos quais você anexa a política de CORS terão suas políticas de CORS existentes substituídas durante a migração. Por isso, você pode ignorar as instruções do manual a seguir.
No entanto, se você já usou o console de SageMaker IA para migrar e deseja incluir mais buckets do Amazon S3 aos quais anexar a política do CORS, continue com as instruções manuais a seguir.
O procedimento a seguir mostra como adicionar manualmente a configuração de CORS a um bucket do Amazon S3.
**Adicionar uma configuração CORS a um bucket do Amazon S3**
1. Verifique se há um bucket do Amazon S3 no mesmo domínio existente com o Região da AWS seguinte nome. Para obter instruções, consulte [Visualizar as propriedades de um bucket do Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/view-bucket-properties.html).
```
sagemaker-region-account-id
```
1. Adicione uma configuração CORS com o conteúdo a seguir ao bucket padrão do Amazon S3. Para obter instruções, consulte [Configurar o compartilhamento de recursos de origem cruzada (CORS)](https://docs.aws.amazon.com//AmazonS3/latest/userguide/enabling-cors-examples.html).
```
[
{
"AllowedHeaders": [
"*"
],
"AllowedMethods": [
"POST",
"PUT",
"GET",
"HEAD",
"DELETE"
],
"AllowedOrigins": [
"https://*.sagemaker.aws"
],
"ExposeHeaders": [
"ETag",
"x-amz-delete-marker",
"x-amz-id-2",
"x-amz-request-id",
"x-amz-server-side-encryption",
"x-amz-version-id"
]
}
]
```
### (Opcional) Migrar do Data Wrangler no Studio Classic para o Canvas SageMaker
O Amazon SageMaker Data Wrangler existe como seu próprio recurso na experiência do Studio Classic. Ao habilitar o Studio como sua experiência padrão, use o aplicativo [Amazon SageMaker Canvas](https://docs.aws.amazon.com/sagemaker/latest/dg/canvas.html) para acessar a funcionalidade do Data Wrangler. SageMaker O Canvas é um aplicativo no qual você pode treinar e implantar modelos de aprendizado de máquina sem escrever nenhum código, e o Canvas fornece recursos de preparação de dados baseados no Data Wrangler.
A nova experiência do Studio não é compatível com a interface clássica do Data Wrangler, e você deve criar uma aplicação Canvas se quiser continuar usando o Data Wrangler. No entanto, você deve ter as permissões necessárias para criar e usar aplicações do Canvas.
Conclua as etapas a seguir para anexar as políticas de permissões necessárias à função do AWS IAM do seu domínio de SageMaker IA ou usuário.
**Conceder permissões para a funcionalidade do Data Wrangler dentro do Canvas**
1. Anexe a política AWS gerenciada [AmazonSageMakerFullAccess](https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonSageMakerFullAccess)à função do IAM do seu usuário. Para um procedimento que mostra como anexar políticas do IAM a um perfil, consulte [Adicionar permissões de identidade do IAM (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#add-policies-console) no *Guia do usuário do AWS IAM*.
Se essa política de permissões for muito permissiva para seu caso de uso, você poderá criar políticas com escopo reduzido que incluam pelo menos as seguintes permissões:
```
{
"Sid": "AllowStudioActions",
"Effect": "Allow",
"Action": [
"sagemaker:CreatePresignedDomainUrl",
"sagemaker:DescribeDomain",
"sagemaker:ListDomains",
"sagemaker:DescribeUserProfile",
"sagemaker:ListUserProfiles",
"sagemaker:DescribeSpace",
"sagemaker:ListSpaces",
"sagemaker:DescribeApp",
"sagemaker:ListApps"
],
"Resource": "*"
},
{
"Sid": "AllowAppActionsForUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:region:account-id:app/domain-id/user-profile-name/canvas/*",
"Condition": {
"Null": {
"sagemaker:OwnerUserProfileArn": "true"
}
}
}
```
1. Anexe a política AWS gerenciada [AmazonSageMakerCanvasDataPrepFullAccess](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AmazonSageMakerCanvasDataPrepFullAccess.html)à função do IAM do seu usuário.
Depois de anexar as permissões necessárias, você pode criar uma aplicação Canvas e fazer login. Para obter mais informações, consulte [Começando a usar o Amazon SageMaker Canvas](canvas-getting-started.md).
Depois de fazer login no Canvas, você pode acessar diretamente o Data Wrangler e começar a criar fluxos de dados. Para obter mais informações, consulte [preparação de dados](canvas-data-prep.md) na documentação do Canvas.
### (Opcional) Migrar do piloto automático no Studio Classic para o Canvas SageMaker
[O Amazon SageMaker Autopilot](https://docs.aws.amazon.com/sagemaker/AWSIronmanApiDoc/integ/npepin-studio-migration-autopilot-to-canvas/latest/dg/autopilot-automate-model-development.html) existe como seu próprio recurso na experiência do Studio Classic. Ao migrar para a experiência atualizada do Studio, use o aplicativo [Amazon SageMaker Canvas](https://docs.aws.amazon.com/sagemaker/latest/dg/canvas.html) para continuar usando os mesmos recursos de aprendizado de máquina automatizado (AutoML) por meio de uma interface de usuário (UI). SageMaker O Canvas é um aplicativo no qual você pode treinar e implantar modelos de aprendizado de máquina sem escrever nenhum código, e o Canvas fornece uma interface de usuário para executar suas tarefas do AutoML.
A nova experiência do Studio não é compatível com a interface clássica do Autopilot. Você deve criar uma aplicação Canvas se quiser continuar usando os atributos AutoML do Autopilot por meio de uma interface de usuário.
No entanto, você deve ter as permissões necessárias para criar e usar aplicações do Canvas.
+ Se você estiver acessando o SageMaker Canvas a partir do Studio, adicione essas permissões à função de execução do seu domínio de SageMaker IA ou perfil de usuário.
+ Se você estiver acessando o SageMaker Canvas a partir do console, adicione essas permissões à função do AWS IAM do seu usuário.
+ Se você estiver acessando o SageMaker Canvas por meio de uma [URL pré-assinada](https://docs.aws.amazon.com/sagemaker/latest/dg/setting-up-canvas-sso.html#canvas-optional-access), adicione essas permissões à função do IAM que você está usando para acessar o Okta SSO.
Para habilitar os recursos do AutoML no Canvas, adicione as seguintes políticas à sua função de execução ou função de usuário do IAM:
+ AWS política gerenciada: [`CanvasFullAccess`.](https://docs.aws.amazon.com/sagemaker/latest/dg/security-iam-awsmanpol-canvas.html#security-iam-awsmanpol-AmazonSageMakerCanvasFullAccess)
+ Política em linha:
```
{
"Sid": "AllowAppActionsForUserProfile",
"Effect": "Allow",
"Action": [
"sagemaker:CreateApp",
"sagemaker:DeleteApp"
],
"Resource": "arn:aws:sagemaker:region:account-id:app/domain-id/user-profile-name/canvas/*",
"Condition": {
"Null": {
"sagemaker:OwnerUserProfileArn": "true"
}
}
}
```
**Anexar políticas do IAM a um perfil de execução**
1.
**Encontre a função de execução associada ao seu perfil de usuário de SageMaker IA**
1. No console de SageMaker IA[https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/), navegue até **Domínios** e escolha seu domínio de SageMaker IA.
1. O ARN do perfil de execução está listado em *Perfil de execução* na página **Detalhes do usuário** do seu perfil de usuário. Observe o nome do perfil de execução no ARN.
1. No console do IAM [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/), escolha **Roles**.
1. Procure sua função por nome no campo de pesquisa.
1. Selecione a função.
1. Adicionar políticas ao perfil
1. No console do IAM [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/), escolha **Roles**.
1. Procure sua função por nome no campo de pesquisa.
1. Selecione a função.
1. Na guia **Permissões**, navegue até o menu suspenso **Adicionar permissões**.
1.
+ Para políticas gerenciadas: selecione **Anexar políticas**, pesquise o nome da política de gerenciamento que você deseja anexar.
Selecione a política e escolha **Adicionar permissões**.
+ Para políticas em linha: selecione **Criar política em linha**, cole sua política na guia JSON, escolha Avançar, nomeie sua política e escolha **Criar**.
Para um procedimento que mostra como anexar políticas do IAM a um perfil, consulte [Adicionar permissões de identidade do IAM (console)](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html#add-policies-console) no *Guia do usuário do AWS IAM*.
Depois de anexar as permissões necessárias, você pode criar uma aplicação Canvas e fazer login. Para obter mais informações, consulte [Começando a usar o Amazon SageMaker Canvas](canvas-getting-started.md).
## Definir o Studio Classic como a experiência padrão
Os administradores podem reverter para o Studio Classic como a experiência padrão para um domínio existente. Isso pode ser feito por meio da AWS CLI.
**nota**
Quando o Studio Classic é definido como a experiência padrão para um domínio, o Studio Classic é a experiência padrão para todos os usuários no domínio. No entanto, as configurações em nível de usuário têm precedência sobre as configurações em nível de domínio. Portanto, se um usuário tiver sua experiência padrão definida como Studio, esse usuário terá o Studio como experiência padrão.
Para reverter para o Studio Classic como a experiência padrão para o domínio existente usando o AWS CLI, use a chamada [update-domain](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/sagemaker/update-domain.html). Como parte do campo `default-user-settings`, você deve definir:
+ O valor do `StudioWebPortal` como `DISABLED`.
+ O valor do `DefaultLandingUri` como `app:JupyterServer:`.
`StudioWebPortal` indica se a experiência do Studio é a experiência padrão e `DefaultLandingUri` indica a experiência padrão para a qual o usuário é direcionado ao acessar o domínio. Neste exemplo, definir esses valores em um nível de domínio (no `default-user-settings`) torna o Studio Classic a experiência padrão para usuários dentro do domínio.
Se um usuário dentro do domínio tiver seu `StudioWebPortal` definido como `ENABLED` e `DefaultLandingUri` definido como `studio::` em nível de usuário (em `UserSettings`), isso terá precedência sobre as configurações do domínio. Em outras palavras, esse usuário terá o Studio como sua experiência padrão, independentemente das configurações em nível de domínio.
O seguinte exemplo de código mostra como definir o Studio Classic como a experiência padrão para usuários no domínio:
```
aws sagemaker update-domain \
--domain-id existing-domain-id \
--region Região da AWS \
--default-user-settings '
{
"StudioWebPortal": "DISABLED",
"DefaultLandingUri": "app:JupyterServer:"
}
'
```
Use as instruções a seguir para obter seu `existing-domain-id`.
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador** e selecione **Domínios**.
1. Escolha o domínio existente.
1. Na página **Detalhes do Domínio**, escolha a guia **Configurações do Domínio**.
1. Copie o **ID do domínio**.
Para obter o seu`Região da AWS`, use as instruções a seguir para garantir que você esteja usando o correto Região da AWS para o seu domínio.
1. Abra o console do Amazon SageMaker AI em [https://console.aws.amazon.com/sagemaker/](https://console.aws.amazon.com/sagemaker/).
1. No painel de navegação à esquerda, escolha **Configurações do administrador** e selecione **Domínios**.
1. Escolha o domínio existente.
1. Na página **Detalhes do domínio**, verifique se esse é o domínio existente.
1. Expanda a lista Região da AWS suspensa no canto superior direito do console de SageMaker IA e use o Região da AWS ID correspondente à direita do seu Região da AWS nome. Por exemplo, .`us-west-1`