

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á.

# Perfis de usuário do domínio
<a name="domain-user-profile"></a>

Um perfil de usuário representa um único usuário dentro de um domínio da Amazon SageMaker AI. O perfil de usuário é a principal maneira de referenciar um usuário para fins de compartilhamento, relatórios e outros atributos orientados para o usuário. Essa entidade é criada quando um usuário se integra ao domínio Amazon SageMaker AI. Um perfil de usuário pode ter (no máximo) um único JupyterServer aplicativo fora do contexto de um espaço compartilhado. A aplicação Studio Classic do perfil do usuário está diretamente associado ao perfil do usuário e tem um diretório isolado do Amazon EFS, um perfil de execução associado ao perfil do usuário e aplicações de Kernel Gateway. Um perfil de usuário também pode criar outros aplicativos a partir do console ou do Amazon SageMaker Studio.

**Topics**
+ [

# Adicionar perfis de usuário
](domain-user-profile-add.md)
+ [

# Remover perfis de usuário
](domain-user-profile-remove.md)
+ [

# Visualizar perfis de usuário em um domínio
](domain-user-profile-view.md)
+ [

# Visualizar detalhes do perfil do usuário
](domain-user-profile-describe.md)

# Adicionar perfis de usuário
<a name="domain-user-profile-add"></a>

A seção a seguir mostra como adicionar perfis de usuário a um domínio usando o console SageMaker AI ou AWS CLI o.

Depois de adicionar um perfil de usuário ao domínio, os usuários podem fazer login usando um URL. Se o domínio usar Centro de Identidade do AWS IAM para autenticação, os usuários receberão um e-mail contendo a URL para entrar no domínio. Se o domínio usar AWS Identity and Access Management, você poderá criar uma URL para um perfil de usuário usando [CreatePresignedDomainUrl](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_CreatePresignedDomainUrl.html)

## Adicionar perfis de usuário a partir do console
<a name="domain-user-profile-add-console"></a>

Você pode adicionar perfis de usuário a um domínio a partir do console do SageMaker AI seguindo este procedimento.

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**.

1. Em **Configurações do administrador**, escolha **Domínios**.

1. Na lista de domínios, selecione o domínio ao qual deseja adicionar um perfil de usuário.

1. Na página **Detalhes do domínio**, escolha a aba **Perfis de usuário**.

1. Escolha **Adicionar usuário**. Essa ação abre uma nova página.

1. Use o nome padrão para seu perfil de usuário ou adicione um nome personalizado.

1. Em **Função de execução**, escolha uma opção no seletor de função. Se você escolher **Inserir um ARN de função do IAM personalizado**, a função deverá ter, no mínimo, uma política de confiança anexada que conceda permissão à SageMaker IA para assumir a função. Para obter mais informações, consulte [Funções de SageMaker IA](https://docs.aws.amazon.com//sagemaker/latest/dg/sagemaker-roles.html).

   Se você escolher **Criar uma nova função**, a caixa de diálogo **Criar um perfil do IAM** será aberta:

   1. Em **Buckets do S3 especificados por você**, especifique buckets adicionais do Amazon S3 que os usuários de seus cadernos podem acessar. Se não quiser adicionar acesso a mais buckets, escolha **Nenhum**.

   1. Escolha **Criar função**. SageMaker A IA cria uma nova função do IAM`AmazonSageMaker-ExecutionPolicy`, com a [AmazonSageMakerFullAccess](https://console.aws.amazon.com//iam/home?#/policies/arn:aws:iam::aws:policy/AmazonSageMakerFullAccess)política anexada.

1. (Opcional) Adicione tags ao perfil do usuário. Todos os recursos criados pelo perfil de usuário terão uma tag ARN de domínio e uma tag ARN de perfil de usuário. A tag ARN do domínio é baseada no ID do domínio, enquanto a tag ARN do perfil do usuário é baseada no nome do perfil do usuário.

1. Escolha **Próximo**.

1. Na seção **SageMaker Studio**, você tem a opção de escolher entre a versão mais recente e a clássica do Studio como sua experiência padrão.
   + Se você escolher o **SageMaker Studio** (recomendado) como sua experiência padrão, o IDE Studio Classic terá as configurações padrão. Para obter mais informações sobre as configurações padrão, consulte [Configurações padrão](onboard-quick-start.md#onboard-quick-start-defaults).

     Para obter informações sobre o Studio, consulte [SageMaker Estúdio Amazon](studio-updated.md).
   + Se você escolher o **Studio Classic** como sua experiência padrão, poderá optar por ativar ou desativar o compartilhamento de recursos do caderno. Os recursos do caderno incluem artefatos como saída de células e repositórios Git. Para obter mais informações sobre recursos do caderno, consulte [Compartilhe e use um notebook Amazon SageMaker Studio Classic](notebooks-sharing.md).

1. Em **SageMaker Canvas**, você pode definir suas configurações do SageMaker Canvas. Para obter instruções e detalhes de configuração para integração, consulte [Começando a usar o Amazon SageMaker Canvas](canvas-getting-started.md).

   1. Para a **configuração de permissões básicas do Canvas**, selecione se deseja estabelecer as permissões mínimas necessárias para usar o aplicativo SageMaker Canvas.

1. Em **RStudio**, se for RStudio licença, selecione se você deseja criar o usuário com uma das seguintes autorizações:
   + Não autorizado
   + RStudio Administrador
   + RStudio Usuário

1. Escolha **Próximo**.

1. Na página **Personalizar a interface do usuário do Studio**, você pode personalizar as aplicações visíveis e as ferramentas de machine learning (ML) exibidas no Studio. Essa personalização oculta apenas as aplicações e as ferramentas de ML no painel de navegação à esquerda do Studio. Para obter informações sobre a interface do Studio, consulte [Visão geral da interface do usuário do Amazon SageMaker Studio](studio-updated-ui.md).

   Para obter informações sobre as aplicações, consulte [Aplicativos compatíveis com o Amazon SageMaker Studio](studio-updated-apps.md).

   O atributo de personalização da interface de usuário do Studio não está disponível no Studio Classic. Se você quiser definir o Studio como sua experiência padrão, escolha **Anterior** e retorne à etapa anterior.

1. Escolha **Próximo**.

1. Depois de revisar suas alterações, escolha **Criar perfil de usuário**.

## Crie perfis de usuário a partir do AWS CLI
<a name="domain-user-profile-add-cli"></a>

Para criar um perfil de usuário em um domínio a partir do AWS CLI, execute o seguinte comando no terminal da sua máquina local. Para obter informações sobre a JupyterLab versão disponível ARNs, consulte[Definindo uma JupyterLab versão padrão](studio-jl.md#studio-jl-set).

```
aws --region region \
sagemaker create-user-profile \
--domain-id domain-id \
--user-profile-name user-name \
--user-settings '{
  "JupyterServerAppSettings": {
    "DefaultResourceSpec": {
      "SageMakerImageArn": "sagemaker-image-arn",
      "InstanceType": "system"
    }
  }
}'
```

Você pode usar o AWS CLI para personalizar os aplicativos e as ferramentas de ML exibidos no Studio para o usuário, usando [StudioWebPortalSettings](https://docs.aws.amazon.com/sagemaker/latest/APIReference/API_StudioWebPortalSettings.html). Use `HiddenAppTypes` para ocultar aplicações e `HiddenMlTools` para ocultar ferramentas de ML. Para obter mais informações sobre como personalizar a navegação à esquerda da interface de usuário do Studio, consulte [Oculte ferramentas e aplicativos de aprendizado de máquina na interface do usuário do Amazon SageMaker Studio](studio-updated-ui-customize-tools-apps.md). Esse atributo não está disponível para o Studio Classic.

# Remover perfis de usuário
<a name="domain-user-profile-remove"></a>

Todos as aplicações iniciadas por um perfil de usuário devem ser excluídas para excluir o perfil de usuário. A seção a seguir mostra como remover perfis de usuário de um domínio usando o console SageMaker AI ou AWS CLI.

## Remover perfis de usuário a partir do console
<a name="domain-user-profile-remove-console"></a>

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**.

1. Em **Configurações do administrador**, escolha **Domínios**.

1. Na lista de domínios, selecione o domínio do qual você deseja remover um perfil de usuário.

1. Na página **Detalhes do domínio**, escolha a aba **Perfis de usuário**.

1. Selecione o perfil de usuário que você deseja excluir.

1. Na página **Detalhes do usuário**, para cada aplicação sem falha na lista **Aplicações**, selecione **Ação**.

1. Na lista suspensa, escolha **Excluir**.

1. Na caixa de diálogo **Excluir aplicação**, selecione **Sim, excluir aplicação**. Em seguida, insira *Excluir* no campo de confirmação e escolha **Excluir**.

1. Quando o **status** for exibido como **Excluído** para todas as aplicações, volte para a página de **Detalhes do domínio** e escolha a guia **Gerenciamento de espaço**.

1. Exclua todos os espaços pertencentes ao perfil do usuário. Para cada espaço em que o perfil do usuário é o proprietário, selecione o espaço e escolha **Excluir**. Para consultar as etapas detalhadas, acesse [Excluir um espaço do Studio](studio-updated-running-stop.md#studio-updated-running-stop-space).

1. Volte para a guia **Perfis de usuário** e escolha **Editar**.

1. Na página **Editar usuário**, selecione **Excluir usuário**.

1. Na tela pop-up **Excluir usuário**, selecione **Sim, excluir usuário**.

1. Insira a palavra *Excluir* no campo para confirmar a exclusão.

1. Escolha **Excluir**.

## Remover perfis de usuário do AWS CLI
<a name="domain-user-profile-remove-cli"></a>

Para excluir um perfil de usuário do AWS CLI, primeiro exclua todos os espaços pertencentes ao perfil do usuário e, em seguida, exclua o perfil do usuário. Execute os comandos a seguir no terminal da sua máquina local.

```
# Delete spaces owned by the user profile
aws sagemaker delete-space \
--region region \
--domain-id domain-id \
--space-name space-name

# Delete the user profile
aws sagemaker delete-user-profile \
--region region \
--domain-id domain-id \
--user-profile-name user-name
```

# Visualizar perfis de usuário em um domínio
<a name="domain-user-profile-view"></a>

 A seção a seguir descreve como visualizar uma lista de perfis de usuário em um domínio a partir do console SageMaker AI ou do AWS CLI. 

## Visualizar perfis de usuário a partir do console
<a name="domain-user-profile-view-console"></a>

 Conclua o procedimento a seguir para ver uma lista de perfis de usuário no domínio a partir do 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**.

1. Em **Configurações do administrador**, escolha **Domínios**. 

1. Na lista de domínios, selecione o domínio cuja lista de perfis de usuário você deseja visualizar. 

1. Na página **Detalhes do Domínio**, escolha a aba **Perfis de usuário**. 

## Visualize perfis de usuário do AWS CLI
<a name="domain-user-profile-view-cli"></a>

Para visualizar os perfis de usuário em um domínio a partir do AWS CLI, execute o seguinte comando no terminal da sua máquina local.

```
aws sagemaker list-user-profiles \
--region region \
--domain-id domain-id
```

# Visualizar detalhes do perfil do usuário
<a name="domain-user-profile-describe"></a>

A seção a seguir descreve como visualizar os detalhes de um perfil de usuário no console de SageMaker IA ou no AWS CLI. 

## Visualizar detalhes do perfil de usuário a partir do console
<a name="domain-user-profile-describe-console"></a>

 Conclua o procedimento a seguir para visualizar os detalhes de um perfil de usuário no console do SageMaker AI. 

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**.

1. Em **Configurações do administrador**, escolha **Domínios**. 

1.  Na lista de domínios, selecione o domínio cuja lista de perfis de usuário você deseja visualizar. 

1. Na página **Detalhes do domínio**, escolha a aba **Perfis de usuário**. 

1.  Selecione o perfil de usuário cujos detalhes você deseja visualizar. 

## Exibir detalhes do perfil do usuário no AWS CLI
<a name="domain-user-profile-describe-cli"></a>

Para descrever um perfil de usuário a partir do AWS CLI, execute o comando a seguir no terminal da sua máquina local.

```
aws sagemaker describe-user-profile \
--region region \
--domain-id domain-id \
--user-profile-name user-name
```