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á.
# Colaboração com espaços compartilhados
Um espaço compartilhado do Amazon SageMaker Studio Classic consiste em um JupyterServer aplicativo e um diretório compartilhados. Um espaço JupyterLab compartilhado consiste em um JupyterLab aplicativo compartilhado e um diretório compartilhado no Amazon SageMaker Studio. Todos os perfis de usuário em um domínio têm acesso a todos os espaços compartilhados no domínio. O Amazon SageMaker AI define automaticamente o escopo dos recursos em um espaço compartilhado dentro do contexto do aplicativo Amazon SageMaker Studio Classic que você executa nesse espaço compartilhado. Os recursos em um espaço compartilhado incluem cadernos, arquivos, experimentos e modelos. Use espaços compartilhados para colaborar com outros usuários em tempo real pelos atributos, como marcação automática, coedição de cadernos em tempo real e personalização.
Os espaços compartilhados estão disponíveis em:
+ Amazon SageMaker Studio clássico
+ JupyterLab
Um espaço compartilhado do Studio Classic só é compatível com o Studio Classic e KernelGateway os aplicativos. Um espaço compartilhado só suporta o uso de um Amazon Resource Name (ARN) de JupyterLab 3 imagens. Para obter mais informações, consulte [JupyterLab Controle de versão no Amazon Studio Classic SageMaker](studio-jl.md).
O Amazon SageMaker AI marca automaticamente todos os recursos de SageMaker IA que você cria dentro do escopo de um espaço compartilhado. Você pode usar essas tags para monitorar custos e planejar orçamentos usando ferramentas como AWS Budgets.
Um espaço compartilhado usa as mesmas configurações de VPC do domínio em que foi criado.
**nota**
Espaços compartilhados não suportam o uso de clusters entre contas do Amazon SageMaker Data Wrangler ou do Amazon EMR.
**Marcação automática**
Todos os recursos criados em um espaço compartilhado são automaticamente marcados com uma tag ARN de domínio e uma tag ARN de espaço compartilhado. A tag ARN do domínio é baseada na ID do domínio, enquanto a tag ARN do espaço compartilhado é baseada no nome do espaço compartilhado.
Você pode usar essas tags para monitorar o AWS CloudTrail uso. Para obter mais informações, consulte [Registrar chamadas de SageMaker API da Amazon com AWS CloudTrail](https://docs.aws.amazon.com//sagemaker/latest/dg/logging-using-cloudtrail.html).
Você também pode usar essas tags para monitorar custos com Gerenciamento de Faturamento e Custos da AWS. Para obter mais informações, consulte [Uso de tags de alocação de AWS custos](https://docs.aws.amazon.com//awsaccountbilling/latest/aboutv2/cost-alloc-tags.html).
**Coedição de cadernos em tempo real**
Um dos principais benefícios de um espaço compartilhado é que ele facilita a colaboração entre os membros do espaço compartilhado em tempo real. Os usuários que colaboram em um espaço de trabalho têm acesso a uma aplicação compartilhada do Studio Classic, onde podem acessar, ler e editar seus cadernos em tempo real. A colaboração em tempo real só é suportada para JupyterServer aplicativos dentro de um espaço compartilhado.
Usuários com acesso a um espaço compartilhado podem simultaneamente abrir, visualizar, editar e executar cadernos Jupyter no Studio Classic compartilhado ou no JupyterLab aplicativo compartilhado nesse espaço.
O caderno indica cada usuário de coedição com um cursor diferente que mostra o nome do perfil do usuário. Embora vários usuários possam ver o mesmo caderno, a coedição é mais adequada para pequenos grupos de dois a cinco usuários.
Para monitorar as alterações feitas por vários usuários, recomendamos usar o controle de versão integrado baseado em Git do Studio Classic.
**JupyterServer 2**
Para usar espaços compartilhados no Studio Classic, é obrigatório o Jupyter Server versão 2. Certas JupyterLab extensões e pacotes podem fazer o downgrade forçado do Jupyter Server para a versão 1. Isso impede o uso do espaço compartilhado. Execute o seguinte no prompt de comando para alterar o número da versão e continuar usando espaços compartilhados:
```
conda activate studio
pip install jupyter-server==2.0.0rc3
```
**Personalize um espaço compartilhado**
Para anexar uma configuração de ciclo de vida ou imagem personalizada a um espaço compartilhado, você deve usar a AWS CLI. Para obter mais informações sobre como criar e anexar configurações de ciclo de vida, consulte [Crie e associe uma configuração de ciclo de vida ao Amazon Studio Classic SageMaker](studio-lcc-create.md). Para obter mais informações sobre como criar e anexar imagens personalizadas, consulte [Imagens personalizadas no Amazon SageMaker Studio Classic](studio-byoi.md).
# Criar um espaço compartilhado
**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
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
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
------
#### [ 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 imagens ARNs. 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 imagens ARNs. 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
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
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
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
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. O só `DefaultDomainExecRole` pode ser definido ao criar ou atualizar o domínio. Os espaços compartilhados suportam apenas o uso de JupyterLab 3 imagens. ARNs 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\"}"
```
------
# Obter informações sobre espaços compartilhados
**Importante**
Em 30 de novembro de 2023, a experiência anterior do Amazon SageMaker Studio agora se chama Amazon SageMaker Studio Classic. A seção a seguir é específica ao uso da aplicação Studio Classic. Para obter informações sobre como usar a experiência atualizada do Studio, consulte [SageMaker Estúdio Amazon](studio-updated.md).
O Studio Classic ainda é mantido para cargas de trabalho existentes, mas não está mais disponível para integração. Você só pode parar ou excluir aplicativos do Studio Classic existentes e não pode criar novos. Recomendamos que você [migre sua carga de trabalho para a nova experiência do Studio](studio-updated-migrate.md).
Este guia mostra como acessar uma lista de espaços compartilhados em um domínio do Amazon SageMaker AI com o console Amazon SageMaker AI, o Amazon SageMaker Studio ou AWS CLI o. Também mostra como visualizar detalhes de um espaço compartilhado a partir da AWS CLI.
**Topics**
+ [Listar espaços compartilhados](#domain-space-list-spaces)
+ [Visualizar detalhes do espaço compartilhado](#domain-space-describe)
## Listar espaços compartilhados
O tópico a seguir descreve como visualizar uma lista de espaços compartilhados em um domínio a partir do console SageMaker AI ou do AWS CLI.
### Listar espaços compartilhados a partir do Studio
Conclua o procedimento a seguir para visualizar uma lista de espaços compartilhados em um domínio a partir do Studio.
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 **Studio Classic** ou **JupyterLab**. Você pode visualizar os espaços que estão sendo usados para executar o tipo de aplicação.
### Listar espaços compartilhados a partir do console
Conclua o procedimento a seguir para ver uma lista dos espaços compartilhados em um domínio 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 espaços compartilhados você deseja visualizar.
1. Na página de **Detalhes do domínio**, escolha a aba **Gerenciamento de espaço**.
### Listar espaços compartilhados do AWS CLI
Para listar os espaços compartilhados em um domínio a partir do AWS CLI, execute o seguinte comando no terminal da sua máquina local.
```
aws --region region \
sagemaker list-spaces \
--domain-id domain-id
```
## Visualizar detalhes do espaço compartilhado
A seção a seguir descreve como visualizar os detalhes do espaço compartilhado no console SageMaker AI, no Studio ou no AWS CLI.
### Visualizar detalhes de espaços compartilhados a partir do Studio
Conclua o procedimento a seguir para visualizar os detalhes de espaços compartilhados em um domínio a partir do Studio.
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 **Studio Classic** ou **JupyterLab**. Você pode visualizar os espaços que estão executando a aplicação.
1. Selecione o nome do espaço deseja visualizar.
### Visualizar detalhes do espaço compartilhado a partir do console
Você pode ver os detalhes de um espaço compartilhado no console do SageMaker AI usando o procedimento a seguir.
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 espaços compartilhados você deseja visualizar.
1. Na página de **Detalhes do domínio**, escolha a aba **Gerenciamento de espaço**.
1. Selecione o nome do espaço para abrir uma nova página que lista os detalhes sobre o espaço compartilhado.
### Veja os detalhes do espaço compartilhado no AWS CLI
Para ver os detalhes de um espaço compartilhado no AWS CLI, execute o seguinte comando no terminal da sua máquina local.
```
aws --region region \
sagemaker describe-space \
--domain-id domain-id \
--space-name space-name
```
# Editar um espaço compartilhado
Você só pode editar os detalhes de um Amazon SageMaker Studio Classic ou espaço JupyterLab compartilhado usando AWS CLI o. Você não pode editar os detalhes de um espaço compartilhado no console Amazon SageMaker AI. Você só pode atualizar os atributos do espaço de trabalho quando não há aplicações em execução no espaço compartilhado.
------
#### [ Studio Classic ]
Para editar os detalhes de um espaço compartilhado do Studio Classic a partir do AWS CLI, execute o comando a seguir no terminal da sua máquina local. Os espaços compartilhados suportam apenas o uso de JupyterLab 3 imagens. ARNs Para obter mais informações, consulte [JupyterLab Controle de versão no Amazon Studio Classic SageMaker](studio-jl.md).
```
aws --region region \
sagemaker update-space \
--domain-id domain-id \
--space-name space-name \
--query SpaceArn --output text \
--space-settings '{
"JupyterServerAppSettings": {
"DefaultResourceSpec": {
"SageMakerImageArn": "sagemaker-image-arn",
"InstanceType": "system"
}
}
}'
```
------
#### [ JupyterLab ]
Para editar os detalhes de um espaço JupyterLab compartilhado a partir do AWS CLI, execute o comando a seguir no terminal da sua máquina local. Os espaços compartilhados suportam apenas o uso de JupyterLab 4 imagens. ARNs Para obter mais informações, consulte [SageMaker JupyterLab](studio-updated-jl.md).
```
aws --region region \
sagemaker update-space \
--domain-id domain-id \
--space-name space-name \
--space-settings "{
"SpaceStorageSettings": {
"EbsStorageSettings": {
"EbsVolumeSizeInGb":100
}
}
}
}"
```
------
# Excluir um espaço compartilhado
**Importante**
Em 30 de novembro de 2023, a experiência anterior do Amazon SageMaker Studio agora se chama Amazon SageMaker Studio Classic. A seção a seguir é específica ao uso da aplicação Studio Classic. Para obter informações sobre como usar a experiência atualizada do Studio, consulte [SageMaker Estúdio Amazon](studio-updated.md).
O Studio Classic ainda é mantido para cargas de trabalho existentes, mas não está mais disponível para integração. Você só pode parar ou excluir aplicativos do Studio Classic existentes e não pode criar novos. Recomendamos que você [migre sua carga de trabalho para a nova experiência do Studio](studio-updated-migrate.md).
O tópico a seguir mostra como excluir um espaço compartilhado do Amazon SageMaker Studio Classic do console Amazon SageMaker AI ou AWS CLI. Um espaço compartilhado só pode ser excluído se não tiver aplicações em execução.
**Topics**
+ [Console](#domain-space-delete-console)
+ [AWS CLI](#domain-space-delete-cli)
## Console
Conclua o procedimento a seguir para excluir um espaço compartilhado no domínio Amazon SageMaker SageMaker AI do console de 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. Selecione o espaço compartilhado que você deseja excluir. O espaço compartilhado não deve conter nenhuma aplicação que não tenha falhado.
1. Escolha **Excluir**. Essa ação abre uma nova janela.
1. Escolha **Sim, excluir espaço**.
1. Digite *Excluir* no campo.
1. Escolha **Excluir espaço**.
## AWS CLI
Para excluir um espaço compartilhado do AWS CLI, execute o seguinte comando no terminal da sua máquina local.
```
aws --region region \
sagemaker delete-space \
--domain-id domain-id \
--space-name space-name
```