

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

# Criar um espaço compartilhado
<a name="domain-space-create"></a>

**Importante**  
Políticas personalizadas do IAM que permitem que o Amazon SageMaker SageMaker Studio ou o Amazon Studio Classic criem SageMaker recursos da Amazon também devem conceder permissões para adicionar tags a esses recursos. A permissão para adicionar tags aos recursos é necessária porque o Studio e o Studio Classic marcam automaticamente todos os recursos que eles criam. Se uma política do IAM permitir que o Studio e o Studio Classic criem recursos, mas não permitisse a marcação, erros AccessDenied "" podem ocorrer ao tentar criar recursos. Para obter mais informações, consulte [Forneça permissões para marcar recursos de SageMaker IA](security_iam_id-based-policy-examples.md#grant-tagging-permissions).  
[AWS políticas gerenciadas para Amazon SageMaker AI](security-iam-awsmanpol.md)que dão permissões para criar SageMaker recursos já incluem permissões para adicionar tags ao criar esses recursos.

 O tópico a seguir demonstra como criar um espaço compartilhado em um domínio existente da Amazon SageMaker AI. Se você criou seu domínio sem suporte para espaços compartilhados, você deve adicionar compatibilidade com espaços compartilhados ao seu domínio existente antes de criar um espaço compartilhado. 

**Topics**
+ [Adicionar compatibilidade de espaço compartilhado a um domínio existente](#domain-space-add)
+ [Criar um espaço compartilhado](#domain-space-create-app)

## Adicionar compatibilidade de espaço compartilhado a um domínio existente
<a name="domain-space-add"></a>

 Você pode usar o console de SageMaker IA ou o AWS CLI para adicionar suporte para espaços compartilhados a um domínio existente. Se o domínio estiver usando acesso à rede `VPC only`, você só poderá adicionar compatibilidade com o espaço compartilhado usando a AWS CLI.

### Console
<a name="domain-space-add-console"></a>

 Conclua o procedimento a seguir para adicionar suporte aos espaços compartilhados do Studio Classic a um domínio existente 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 para o qual você deseja abrir a página de **Configurações de domínio**. 

1.  Na página **Detalhes do Domínio**, escolha a guia **Configurações do Domínio**. 

1.  Escolha **Editar**. 

1.  Em **Perfil de execução padrão do espaço**, defina um perfil do IAM que seja usado por padrão para todos os espaços compartilhados criados no domínio. 

1.  Escolha **Próximo**. 

1.  Escolha **Próximo**. 

1.  Escolha **Próximo**. 

1.  Selecione **Enviar**. 

### AWS CLI
<a name="domain-space-add-cli"></a>

------
#### [ Studio Classic ]

Execute o comando a seguir no terminal da sua máquina local para adicionar configurações padrão de espaço compartilhado a um domínio a partir da AWS CLI. Se você estiver adicionando configurações padrão de espaço compartilhado a um domínio dentro de um Amazon VPC, você também deve incluir uma lista de grupos de segurança. Os espaços compartilhados do Studio Classic suportam apenas o uso de JupyterLab 3 ARNs de imagem. Para obter mais informações, consulte [JupyterLab Controle de versão no Amazon Studio Classic SageMaker](studio-jl.md).

```
# Public Internet domain
aws --region {{region}} \
sagemaker update-domain \
--domain-id {{domain-id}} \
--default-space-settings "ExecutionRole={{execution-role-arn}},JupyterServerAppSettings={DefaultResourceSpec={InstanceType={{example-instance-type}},SageMakerImageArn={{sagemaker-image-arn}}}}"

# VPCOnly domain
aws --region {{region}} \
sagemaker update-domain \
--domain-id {{domain-id}} \
--default-space-settings "ExecutionRole={{execution-role-arn}},JupyterServerAppSettings={DefaultResourceSpec={InstanceType=system,SageMakerImageArn={{sagemaker-image-arn}}}},SecurityGroups=[{{security-groups}}]"
```

Use o comando a seguir para verificar se as configurações padrão de espaço compartilhado foram atualizadas. 

```
aws --region {{region}} \
sagemaker describe-domain \
--domain-id {{domain-id}}
```

------
#### [ JupyterLab ]

Execute o comando a seguir no terminal da sua máquina local para adicionar configurações padrão de espaço compartilhado a um domínio a partir da AWS CLI. Se você estiver adicionando configurações padrão de espaço compartilhado a um domínio dentro de um Amazon VPC, você também deve incluir uma lista de grupos de segurança. Os espaços compartilhados do Studio Classic suportam apenas o uso de JupyterLab 4 ARNs de imagem. Para obter mais informações, consulte [JupyterLab Controle de versão no Amazon Studio Classic SageMaker](studio-jl.md).

```
# Public Internet domain
aws --region {{region}} \
sagemaker update-domain \
--domain-id {{domain-id}} \
--default-space-settings "ExecutionRole={{execution-role-arn}}", JupyterLabAppSettings={DefaultResourceSpec={InstanceType={{example-instance-type}},SageMakerImageArn={{sagemaker-image-arn}}}}"

# VPCOnly domain
aws --region {{region}} \
sagemaker update-domain \
--domain-id {{domain-id}} \
--default-space-settings "ExecutionRole={{execution-role-arn}}, SecurityGroups=[{{security-groups}}]"
```

Use o comando a seguir para verificar se as configurações padrão de espaço compartilhado foram atualizadas. 

```
aws --region {{region}} \
sagemaker describe-domain \
--domain-id {{domain-id}}
```

------

## Criar um espaço compartilhado
<a name="domain-space-create-app"></a>

As seções a seguir demonstram como criar um espaço compartilhado a partir do console Amazon SageMaker AI, do Amazon SageMaker Studio ou do AWS CLI.

### Criar a partir do Studio
<a name="domain-space-create-updated"></a>

Use os processos a seguir para criar um espaço compartilhado em um domínio a partir do Studio.

------
#### [ Studio Classic ]

1. Navegue até o Studio seguindo as etapas em[Inicie o Amazon SageMaker Studio](studio-updated-launch.md).

1. Na interface do usuário do Studio, encontre o painel de aplicações no lado esquerdo.

1. No painel de aplicações, selecione **Studio Classic**.

1. Selecione **Criar espaço no Studio Classic**

1. Na janela pop-up, insira um nome para o espaço.

1. Selecione **Criar espaço**.

------
#### [ JupyterLab ]

1. Navegue até o Studio seguindo as etapas em[Inicie o Amazon SageMaker Studio](studio-updated-launch.md).

1. Na interface do usuário do Studio, encontre o painel de aplicações no lado esquerdo.

1. No painel de aplicativos, selecione **JupyterLab**.

1. Escolha **Criar JupyterLab espaço**

1. Na janela pop-up, insira um nome para o espaço.

1. Selecione **Criar espaço**.

------

### Criar a partir do console
<a name="domain-space-create-console"></a>

 Conclua o procedimento a seguir para criar um espaço compartilhado em um 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 para o qual você quer criar um espaço compartilhado. 

1.  Na página de **Detalhes do domínio**, escolha a aba **Gerenciamento de espaço**. 

1.  Escolha **Criar**. 

1.  Insira um nome para seu espaço compartilhado. Os nomes de espaços compartilhados em um domínio devem ser exclusivos. O perfil de execução do espaço compartilhado é definida como o perfil de execução do IAM do domínio. 

### Crie a partir de AWS CLI
<a name="domain-space-create-cli"></a>

Esta seção mostra como criar um espaço compartilhado a partir da AWS CLI. 

Você não pode definir a função de execução de um espaço compartilhado ao criá-lo ou atualizá-lo. Só `DefaultDomainExecRole` pode ser definido ao criar ou atualizar o domínio. Os espaços compartilhados suportam apenas o uso de JupyterLab 3 ARNs de imagem. Para obter mais informações, consulte [JupyterLab Controle de versão no Amazon Studio Classic SageMaker](studio-jl.md).

Para criar um espaço compartilhado a partir do AWS CLI, execute um dos comandos a seguir no terminal da sua máquina local.

------
#### [ Studio Classic ]

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

------
#### [ JupyterLab ]

```
aws --region {{region}} \
sagemaker create-space \
--domain-id {{domain-id}} \
--space-name {{space-name}} \
--ownership-settings "{\"OwnerUserProfileName\": \"{{user-profile-name}}\"}" \
--space-sharing-settings "{\"SharingType\": \"Shared\"}" \
--space-settings "{\"AppType\": \"JupyterLab\"}"
```

------