Share via

Configurar um workspace

  • Artigo

APLICA-SE A: Premium

Configure um workspace (versão prévia) para habilitar uma equipe de desenvolvimento de API descentralizada para gerenciar e produzir suas próprias APIs, enquanto uma equipe central de plataforma de API mantém a infraestrutura de Gerenciamento de API. Depois de criar um espaço de trabalho e atribuir permissões, os colaboradores do workspace poderão criar e gerenciar suas próprias APIs, produtos, assinaturas e recursos relacionados.

Observação

  • Workspaces são uma versão prévia do recurso de Gerenciamento de API e sujeitos a determinadas limitações.
  • Os workspaces são compatíveis com a API REST de Gerenciamento de API versão 2022-09-01-preview ou posterior.
  • Para obter considerações de preço, veja Preço do Gerenciamento de API.

Pré-requisitos

  • Uma instância de Gerenciamento de API. Se você precisar, crie um.

Criar um workspace - portal

  1. Entre no portal do Azure e navegue até a sua instância do Gerenciamento de API.

  2. No menu à esquerda, selecione Workspaces (versão prévia) >+ Adicionar. Captura de tela da criação de um workspace do Gerenciamento de API no portal.

  3. Na janela Criar workspace, insira um Nome descritivo, uma ID do recurso e uma Descrição opcional para o workspace. Selecione Salvar.

O novo workspace aparece na lista na página Workspaces. Selecione o workspace para gerenciar suas configurações e recursos.

Atribuir usuários ao workspace - portal

Depois de criar um workspace, atribua permissões aos usuários para gerenciar os recursos do workspace. Cada usuário do espaço de trabalho deve receber uma função RBAC de espaço de trabalho com escopo de serviço e uma função RBAC com escopo de espaço de trabalho ou conceder permissões equivalentes usando funções personalizadas.

Observação

Para facilitar o gerenciamento, configure grupos do Microsoft Entra para atribuir permissões de workspace a vários usuários.

Atribuir uma função com escopo de serviço

  1. Entre no portal do Azure e navegue até a sua instância do Gerenciamento de API.

  2. No menu à esquerda, selecione Controle de acesso (IAM)>+ Adicionar.

  3. Atribuir uma das seguintes funções com escopo de serviço a cada membro do espaço de trabalho:

    • Desenvolvedor de API do Espaço de Trabalho de Serviço de Gerenciamento de API
    • Gerente de Produtos da API do Workspace do Serviço de Gerenciamento de API

Atribuir uma função no escopo do espaço de trabalho

  1. No menu da instância do Gerenciamento de API, selecione Workspaces (versão prévia)> e o nome do workspace que você criou.

  2. Na janela Workspace, selecione Controle de acesso (IAM)>+ Adicionar.

  3. Atribua uma das seguintes funções com escopo do espaço de trabalho aos membros do espaço de trabalho para gerenciar APIs de espaço de trabalho e outros recursos.

    • Leitor do Workspace do Gerenciamento de API
    • Colaborador do Workspace do Gerenciamento de API
    • Desenvolvedor de API do Workspace de Gerenciamento de API
    • Gerente de Produtos da API do Workspace do Gerenciamento de API

Migrar recursos para um workspace

A ferramenta de código aberto de migração de workspaces do Gerenciamento de API do Azure pode ajudar você a fazer a configuração inicial dos recursos no workspace. Use a ferramenta para pegar as APIs de nível de serviço selecionadas com suas dependências e migrá-las de uma instância de Gerenciamento de API do Azure para um workspace.

Próximas etapas