Importar todas as APIs de uma instância de Gerenciamento de API

Este artigo mostra como integrar uma instância de Gerenciamento de API para que as APIs das instâncias sejam continuamente mantidas atualizadas no inventário do centro de API .

Tip

Este artigo explica como integrar uma instância de Gerenciamento de API do centro de API. Como alternativa, configure rapidamente a integração diretamente de uma instância de Gerenciamento de API. No menu à esquerda da instância, em APIs, selecione o Centro de API e selecione um centro de API de destino em sua assinatura para sincronizar APIs.

Sobre a integração de uma instância do Gerenciamento de API

Embora você possa usar a CLI do Azure para importar APIs sob demanda do Gerenciamento de API do Azure para o Centro de API do Azure, a integração (vinculação) de uma instância de Gerenciamento de API permite a sincronização contínua para que o inventário de API permaneça atualizado. O Centro de APIs do Azure também pode sincronizar APIs de fontes como o Amazon API Gateway.

Quando você integra uma instância do Gerenciamento de API como uma fonte de API, ocorre o seguinte:

Todas as APIs e, opcionalmente, as definições de API (especificações), da instância de Gerenciamento de API, são adicionadas ao inventário do centro de API. Os servidores MCP no Gerenciamento de API são incluídos nas APIs adicionadas ao inventário.
Você configura um ambiente do tipo Gerenciamento de API do Azure no centro de API.
Uma implantação associada é criada para cada definição de API sincronizada do Gerenciamento de API.

As APIs de Gerenciamento de API são sincronizadas automaticamente com o centro de API sempre que as configurações das APIs existentes forem alteradas (por exemplo, novas versões são adicionadas), novas APIs são criadas ou APIs são excluídas. Essa sincronização é unidirecional do Gerenciamento de API para o centro de API do Azure, o que significa que as atualizações de API no centro de API não são sincronizadas novamente com a instância de Gerenciamento de API.

Note

Há limites para o número de instâncias integradas de Gerenciamento de API (fontes de API).
Uma instância de Gerenciamento de API integrada pode ser configurada em uma rede virtual.
As atualizações de API no Gerenciamento de API normalmente são sincronizadas com o centro de API em poucos minutos, mas a sincronização pode levar até 24 horas.
As definições das APIs também serão sincronizadas com o Centro de APIs se você selecionar a opção de incluí-las durante a integração.

Entidades sincronizadas do Gerenciamento de API

Você pode adicionar ou atualizar propriedades de metadados e documentação nas APIs sincronizadas no seu Centro de APIs, facilitando que os stakeholders descubram, compreendam e utilizem essas APIs. Saiba mais sobre as propriedades de metadados internas e personalizadas do Centro de API do Azure.

A tabela a seguir apresenta as propriedades da entidade que podem ser modificadas no Centro de APIs do Azure, bem como aquelas definidas com base nos valores provenientes da fonte de API integrada.

Entity	Propriedades configuráveis no Centro de API	Propriedades determinadas na fonte de API integrada
API	resumo lifecycleStage termsOfService licença externalDocumentation customProperties	title description kind
Versão da API	lifecycleStage	title definições (se sincronizadas)
Environment	title description tipo server.managementPortalUri integração customProperties	server.type
Deployment	title description servidor estado customProperties	server.runtimeUri

Note

IDs de recursos e do sistema para entidades sincronizadas com o Centro de APIs do Azure são geradas automaticamente e não podem ser alteradas.

Prerequisites

Um centro de API na sua assinatura do Azure. Se você não criou um, consulte Início Rápido: criar seu centro de API.
Uma instância de Gerenciamento de API do Azure, na mesma assinatura ou em uma assinatura diferente. A instância deve estar no mesmo diretório.
Para a CLI do Azure:
- Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
- Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para saber mais, confira Como executar a CLI do Azure em um contêiner do Docker.
  - Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
  - Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.
  - Execute o comando az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute az upgrade.
Note

Os comandos az apic exigem a extensão da CLI do Azure apic-extension. Se você não tiver usado comandos az apic, a extensão poderá ser instalada dinamicamente quando você executar seu primeiro comando az apic ou instalar a extensão manualmente. Saiba mais sobre as extensões da CLI do Azure.

Consulte as notas sobre a versão para ver as últimas alterações e atualizações no apic-extension. Alguns recursos podem exigir uma versão prévia ou específica da extensão.

Note

Os exemplos de comando da CLI do Azure incluídos neste artigo podem ser executados no PowerShell ou em um shell do Bash. Sempre que necessário, devido às diferentes sintaxes variáveis, são fornecidos exemplos de comando separados para os dois shells.

Habilitar uma identidade gerenciada em seu Centro de APIs

Para esse cenário, o Centro de APIs usa uma identidade gerenciada para acessar os recursos do Azure. Dependendo das suas necessidades, habilite uma identidade gerenciada atribuída pelo sistema ou uma ou mais identidades gerenciadas atribuídas pelo usuário.

Os exemplos a seguir mostram como habilitar uma identidade gerenciada atribuída pelo sistema usando o portal do Azure ou a CLI do Azure. A um nível elevado, os passos de configuração são semelhantes para uma identidade gerida atribuída pelo utilizador.

Portal
Azure CLI

No portal, navegue até seu centro de API.
No menu à esquerda, em Segurança, selecione Identidades Gerenciadas.
Selecione Sistema atribuído e defina o status como Ativado.
Clique em Salvar.

Defina a identidade atribuída pelo sistema no centro de API usando o seguinte comando az apic update. Substitua os nomes do centro de API e do grupo de recursos:

az apic update --name <api-center-name> --resource-group <resource-group-name> --identity '{"type": "SystemAssigned"}'

Atribuir a identidade gerenciada à função Leitor do Serviço de Gerenciamento de API

Para permitir a importação de APIs, atribua a identidade gerenciada do centro de API a função Leitor do Serviço de Gerenciamento de API em sua instância de Gerenciamento de API. É possível usar o portal ou a CLI do Azure.

Portal
Azure CLI

No portal do Azure, navegue até a instância do Gerenciamento de API.
No menu à esquerda, selecione Controle de acesso (IAM).
Escolha Adicionar atribuição de função.
Na página Adicionar atribuição de função, defina os valores da seguinte maneira:
1. Na guia Função, selecione Leitor do Serviço de Gerenciamento de API.
2. Na guia Membros, em Atribuir acesso a – Selecione Identidade Gerenciada > + Selecionar membros.
3. Na página Selecionar identidades gerenciadas, selecione a identidade gerenciada atribuída pelo sistema ao Centro de APIs que você adicionou na seção anterior. Clique em Selecionar.
4. Selecione Revisar + atribuir.

Obtenha a ID da entidade de segurança da identidade. Para uma identidade atribuída pelo sistema, use o comando az apic show.

#! /bin/bash
apicObjID=$(az apic show --name <api-center-name> \
    --resource-group <resource-group-name> \
    --query "identity.principalId" --output tsv)

# Formatted for PowerShell
$apicObjID=$(az apic show --name <api-center-name> `
    --resource-group <resource-group-name> `
    --query "identity.principalId" --output tsv)

Obtenha a ID do recurso da instância de Gerenciamento de API usando o comando az apim show.

#! /bin/bash
apimID=$(az apim show --name <apim-name> --resource-group <resource-group-name> --query "id" --output tsv)

# Formatted for PowerShell
$apimID=$(az apim show --name <apim-name> --resource-group <resource-group-name> --query "id" --output tsv)

Atribua a identidade gerenciada à função Leitor do Serviço de Gerenciamento de API em sua instância de Gerenciamento de API usando o comando az role assignment create.

#! /bin/bash
scope="${apimID:1}"

az role assignment create \
    --role "API Management Service Reader Role" \
    --assignee-object-id $apicObjID \
    --assignee-principal-type ServicePrincipal \
    --scope $scope

# Formatted for PowerShell
$scope=$apimID.substring(1)

az role assignment create `
    --role "API Management Service Reader Role" `
    --assignee-object-id $apicObjID `
    --assignee-principal-type ServicePrincipal `
    --scope $scope

Integrar uma instância do Gerenciamento de API

Você pode integrar uma instância do Gerenciamento de API usando o portal ou a CLI do Azure.

Portal
Azure CLI

No portal, navegue até seu centro de API.
Em Plataformas, selecione Integrações.
Selecione + Nova integração>do Gerenciamento de API do Azure.
Na página Integrar seu Serviço de Gerenciamento de API do Azure:
1. Selecione se deve sincronizar todas as APIs da instância de Gerenciamento de API ou apenas APIs que estão em um workspace de Gerenciamento de API.
2. Selecione a assinatura, o grupo de recursos e o serviço de Gerenciamento de API do Azure que você deseja integrar. Se você quiser sincronizar apenas APIs de um workspace, faça uma seleção em Escolher um workspace.
3. Nos detalhes da integração, insira um identificador. Se você ainda não tiver configurado uma identidade gerenciada com acesso à instância de Gerenciamento de API, habilite Configurar automaticamente a identidade gerenciada e atribuir permissões. Essa seleção atribui automaticamente à identidade gerenciada atribuída pelo sistema do centro de API as permissões necessárias para sincronizar APIs da instância de Gerenciamento de API.
4. Nos detalhes do Ambiente, insira um título de ambiente (nome), tipo de ambiente e descrição opcional.
5. Em detalhes da API:
  1. Selecione um ciclo de vida para as APIs sincronizadas. (Você pode atualizar esse valor para suas APIs após serem adicionadas ao Centro de APIs.)
  2. Como opção, selecione se deseja incluir definições de API com as APIs sincronizadas.
Selecione Criar.

Captura de tela da integração de um serviço de Gerenciamento de API do Azure no portal.

Execute o comando az apic integration create apim para integrar uma instância do Gerenciamento de API ao seu Centro de APIs.

Forneça os nomes do grupo de recursos, do Centro de APIs e da integração.
Se a instância do Gerenciamento de API e o Centro de APIs estiverem no mesmo grupo de recursos, forneça o nome da instância do Gerenciamento de API como o valor de azure-apim; caso contrário, forneça a ID do recurso do Azure.

az apic integration create apim \
    --resource-group <resource-group-name> \
    --service-name <api-center-name> \
    --integration-name <apim-integration-name> \
    --azure-apim <apim-instance-name>

A instância de Gerenciamento de API é integrada como um ambiente no centro de API. As APIs de Gerenciamento de API são sincronizadas com o inventário do centro de API.

Excluir uma integração

Enquanto uma fonte de API estiver integrada, você não poderá excluir APIs sincronizadas a partir do seu Centro de APIs. Se você precisar, poderá excluir a integração. Ao excluir uma integração:

As APIs sincronizadas no inventário do Centro de APIs são excluídas
O ambiente e as implantações associadas à fonte de API são excluídos

Você pode excluir uma integração usando o portal ou a CLI do Azure.

Portal
Azure CLI

No portal, navegue até seu centro de API.
Em Ativos, selecione Integrações de Ambientes>(versão prévia).
Selecione a integração e, em seguida, selecione Excluir (ícone de lixeira).

Execute o comando az apic integration delete (versão prévia) para excluir uma integração. Forneça os nomes do grupo de recursos, do Centro de APIs e da integração.

az apic integration delete \
    --resource-group <resource-group-name> \
    --service-name <api-center-name> \
    --integration-name <integration-name> \

Comentários

Esta página foi útil?

Last updated on 2025-10-15