Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Explore os principais conceitos do Centro de API do Azure, que permite rastrear APIs em um local centralizado para descoberta, reutilização e governança.
Modelo de dados
As principais entidades em uma configuração do Centro de API do Azure incluem suas APIs e suas versões, definições e implantações. Os possíveis ambientes de runtime para cada API e metadados descritivos complementam a configuração.
O diagrama a seguir mostra as entidades principais e como elas se relacionam entre si.
API
Uma entidade lógica de nível superior no Centro de API do Azure, uma API representa qualquer API real que você deseja acompanhar. No Centro de API, você pode incluir APIs de qualquer tipo, incluindo REST, GraphQL, gRPC, SOAP, WebSocket e webhook.
Você pode gerenciar uma API no inventário por qualquer solução de gerenciamento de API. Por exemplo, use o Gerenciamento de API do Azure, o Gerenciamento de API do Apigee, o Kong Konnect, o Gerenciamento de API MuleSoft ou outra plataforma. Uma API representada no Centro de API do Azure também pode não ser gerenciada.
Os gerentes de programas de API ou administradores de TI podem criar e gerenciar o inventário de API no Centro de API do Azure. O Centro de API do Azure também inclui recursos para que os desenvolvedores de API registrem definições de API diretamente de seus ambientes de desenvolvimento, como Visual Studio Code ou pipelines de CI/CD.
Versão da API
O controle de versão da API é a prática de gerenciar alterações em uma API e garantir que as alterações sejam feitas sem interromper os clientes. Uma API pode ter várias versões em estágios de ciclo de vida diferentes, cada uma alinhada com alterações de API específicas. Algumas versões podem introduzir alterações importantes ou significativas, enquanto outras adicionam pequenas melhorias. Uma versão da API pode estar em qualquer estágio do ciclo de vida, desde o design até a visualização, em produção ou obsoleta.
Definição de API
Deve haver pelo menos uma definição para cada versão da API, como uma definição de OpenAPI para uma API REST. O Centro de API do Azure permite qualquer arquivo de definição de API formatado como texto (YAML, JSON, Markdown etc.). Você pode carregar definições OpenAPI, gRPC, GraphQL, AsyncAPI, WSDL e WADL, entre outras.
Para ajudar na governança da API, o Centro de API do Azure fornece recursos de linting para analisar as definições de API quanto à qualidade e conformidade com os padrões organizacionais.
Ambiente
Um ambiente representa um local em que um runtime de API é implantável, como um serviço de Gerenciamento de API do Azure ou um serviço de Gerenciamento de API do Apigee. Você também pode implantar em um serviço de computação, como um cluster do Kubernetes, aplicativo Web ou aplicativo do Azure Functions. Cada ambiente é alinhado com uma fase do ciclo de vida, como desenvolvimento, teste, preparo ou produção. Um ambiente também pode incluir informações sobre o portal do desenvolvedor ou interfaces de gerenciamento.
Observação
Use o Centro de API do Azure para acompanhar qualquer um dos ambientes de runtime da API, independentemente de eles estarem hospedados na infraestrutura do Azure. Esses ambientes não são os mesmos que os Ambientes de Implantação do Azure.
Implantação
Uma implantação é um local (um endereço) em que os usuários podem acessar uma API. Uma API pode ter várias implantações, como diferentes ambientes de preparo ou regiões. Por exemplo, uma API pode ter uma implantação em um ambiente de preparo interno e uma segunda em um ambiente de produção. Cada implantação está associada a uma definição de API específica.
Metadados
No Centro de API do Azure, organize suas APIs, implantações e outras entidades definindo valores de metadados. Os metadados são úteis para pesquisar e filtrar e impor padrões de governança. Um centro de API fornece várias propriedades comuns de metadados internos, como API type e lifecycle stage. Um proprietário do centro de API pode aumentar as propriedades internas definindo propriedades personalizadas em um esquema de metadados para organizar as respectivas APIs, implantações e ambientes. Por exemplo, crie uma API approver propriedade de metadados para identificar o indivíduo responsável por aprovar uma API para uso.
O Centro de API do Azure dá suporte a metadados personalizados do tipo matriz, booliano, número, objeto, opções predefinidas e cadeia de caracteres.
O esquema de metadados do Centro de API do Azure é compatível com as especificações de esquema JSON e YAML, a fim de permitir a validação de esquema em ferramentas de desenvolvedor e pipelines automatizados.