Was ist das Azure API-Center (Vorschauversion)?

Das API-Center ermöglicht die Nachverfolgung von APIs an einem zentralen Ort für Ermittlung, Wiederverwendung und Governance. Verwenden Sie das API-Center, um einen strukturierten und organisierten Bestand der APIs Ihrer Organisation zu entwickeln und zu pflegen – unabhängig von Typ, Lebenszyklusphase oder Bereitstellungsstandort – zusammen mit zugehörigen Informationen wie Versionsdetails, API-Definitionsdateien und allgemeinen Metadaten.

Mit dem API-Center können Projektbeteiligte in Ihrer Organisation, einschließlich API-Programmmanagern, IT Administratoren, Anwendungsentwicklern und API-Entwicklern, APIs ermitteln, verwalten und wiederverwenden.

Wichtig

  • Das API-Center befindet sich in der Vorschauphase. Diese Vorschauversion wird ohne Dienstebenenvereinbarung bereitgestellt, und während der Vorschauphase ist mit gelegentlichen Breaking Changes zu rechnen. Änderungen am API Center-Vorschaudatenmodell können zu Datenverlusten führen. Weitere Informationen finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen.
  • Fordern Sie während der Vorschauphase Features an, berichten Sie Fehler oder geben Sie in diesem GitHub-Repository anderes Feedback an.

Hinweis

API Center ist eine Lösung für Organisationen zum Katalogisieren und Verwalten ihres API-Inventars. Azure bietet auch den API-Verwaltungsdienst, eine Lösung zum Verwalten, Sichern und Veröffentlichen der API-Back-Ends Ihrer Organisation über ein API-Gateway. Erfahren Sie mehr über den Unterschied.

Vorteile

  • Erstellen und Verwalten eines Organisationsbestands: Organisationen können einen vollständiges Inventar an APIs erstellen, die in ihrer Organisation verfügbar sind. Fördern Sie Kommunikation und lassen Sie API-Programmmanager und -Entwickler für eine höhere Wiederverwendung, Qualität, Sicherheit, Compliance und Entwicklerproduktivität der APIs zusammenarbeiten.

  • Steuern Ihrer Unternehmens-APIs – Mit einem umfassenderen Einblick in die APIs, die innerhalb eines Unternehmens erstellt und verwendet werden, können API-Programmmanager und IT-Admins dieses Inventar steuern, um sicherzustellen, dass es den Unternehmensstandards entspricht. Dazu definieren Sie benutzerdefinierte Metadaten und analysieren API-Definitionen, um die Konformität mit API-Stilrichtlinien durchzusetzen.

  • Einfache API-Ermittlung: Organisationen möchten die API-Wiederverwendung fördern, um die Produktivität der Entwickler zu maximieren und sicherzustellen, dass Entwickler die richtigen APIs verwenden. API Center hilft Programmmanagern und Entwicklern, API-Bestand und -Filter mithilfe integrierter und benutzerdefinierter Metadateneigenschaften zu ermitteln. ​

  • Beschleunigen Sie den API-Nutzung: Maximieren Sie die Produktivität der Entwickler bei der Nutzung von APIs, und stellen Sie sicher, dass sie auf sichere Weise genutzt werden, die den Organisationsstandards entspricht.

Wichtige Funktionen

Erstellen und verwenden Sie in der Vorschauversion ein API-Center im Azure-Portal für Folgendes:

  • API-Bestandsverwaltung: Registrieren Sie alle APIs Ihrer Organisation für die Aufnahme in einen zentralisierten Bestand.

  • Reale API-Darstellung: Fügen Sie reale Informationen zu jeder API hinzu, einschließlich Versionen und Definitionen wie OpenAPI-Definitionen. Listen Sie API-Bereitstellungen auf, und ordnen Sie sie Laufzeitumgebungen zu, z. B. Azure API Management oder andere API-Verwaltungslösungen.

  • API-Governance – Organisieren und filtern Sie APIs und zugehörige Ressourcen mithilfe integrierter und benutzerdefinierter Metadateneigenschaften, um die API-Verwaltung und die Suche durch API-Consumern zu erleichtern. Richten Sie Linting und Analysen ein, um die API-Definitionsqualität zu erzwingen.

  • API-Ermittlung und -Wiederverwendung – Ermöglichen Sie es Entwicklerinnen und Entwicklern sowie API-Programm-Managern, APIs über das Azure-Portal, ein API-Center-Portal und Entwickler-Tools zu entdecken, einschließlich einer Visual Studio Code-Erweiterung, die mit GitHub Copilot integriert ist..

Weitere Informationen über die Entitäten, die Sie verwalten können, sowie die Funktionen im API-Center finden Sie unter Wichtige Konzepte.

Verfügbare Regionen

API-Center ist derzeit in den folgenden Azure-Regionen verfügbar:

  • Australien (Osten)
  • Indien, Mitte
  • East US
  • UK, Süden
  • Europa, Westen

API-Center und das API-Ökosystem

API-Center kann eine Schlüsselrolle im API-Ökosystem einer Organisation übernehmen. Betrachten Sie die hypothetische Contoso-Organisation, die eine API-First-Strategie eingeführt hat und die Bedeutung von APIs in ihrer Softwareentwicklung und -integration betont.

Die API-Entwickler, App-Entwickler, API-Programmmanager und API-Manager von Contoso arbeiten über das Azure API-Center zusammen, um das API-Inventar der Organisation zu entwickeln und zu verwenden. Sehen Sie sich das folgende Diagramm und die Erläuterung an.

Diagram showing API Center in an example API ecosystem.

Das API-Ökosystem von Contoso umfasst Folgendes:

  • API-Entwicklung: Die Entwickler von Contoso erstellen regelmäßig ASP.NET Web-APIs. Sie erstellen auch Azure Functions mit HTTP-Triggern.

  • API-Bereitstellungsumgebungen: Contoso stellt einen Teil ihrer APIs für Azure App Service bereit. Eine weitere Teilmenge ihrer APIs wird in einer Azure Function-App bereitgestellt.

  • API-Verwaltung: Contoso verwendet Azure API Management, um ihre APIs zu verwalten, zu veröffentlichen und zu schützen. Sie verwenden separate Instanzen für Entwicklung, Test und Produktion, jeweils mit einem eindeutigen Namen: APIM-DEV, APIM-TEST und APIM-PROD.

  • API Center: Contoso hat das Azure API-Center als zentralen Hub für die API-Ermittlung, -Governance und -Nutzung übernommen. Das API-Center dient als strukturierter und organisierter API-Hub, der umfassende Informationen zu allen Organisations-APIs bereitstellt, die verwandte Informationen verwalten, einschließlich Versionen und zugehörige Bereitstellungen.

Häufig gestellte Fragen

F: Was ist der Unterschied zwischen Azure API Management und Azure API-Center?

A: Azure API Management ist ein vollständig verwalteter Azure-Dienst, der Organisationen hilft, ihre APIs sicher für externe und interne Kunden verfügbar zu machen. Es bietet eine Reihe von Tools und Diensten zum Erstellen, Veröffentlichen und Verwalten von APIs sowie zum Erzwingen von Sicherheit, Skalierung und Überwachung der API-Nutzung.

Andererseits hilft Azure API-Center Organisationen beim Erstellen eines Katalogs von APIs, die in der Organisation verfügbar sind. Azure API-Center bietet grundlegende Informationen zu den APIs, z. B. Name, Beschreibung und Version, aber es können diesen APIs auch zusätzliche Informationen mithilfe von benutzerdefinierten Metadaten hinzugefügt werden. Azure API-Center hilft verschiedenen Projektbeteiligten wie API-Managern oder API-Entwicklern, vorhandene APIs innerhalb der Organisation zu ermitteln und wiederzuverwenden.

Während beide Dienste Tools für die Steuerung von APIs bereitstellen, dienen sie unterschiedlichen Zwecken. Azure API Management ist eine Plattform zum Erstellen, Veröffentlichen und Verwalten von APIs, während API-Center einen zentralen Ort zum Ermitteln und Wiederverwenden vorhandener APIs innerhalb einer Organisation bietet.

F: Wie verwende ich API-Center mit meiner API-Verwaltungslösung?

A: Das API-Center ist ein eigenständiger Azure-Dienst, der die Azure API Management- und API-Verwaltungsdienste anderer Anbieter ergänzt. Das API-Center bietet einen einheitlichen API-Bestand für alle APIs in der Organisation, einschließlich APIs, die nicht in API-Gateways ausgeführt werden (z. B. solche, die sich noch im Entwurf befinden) und APIs, die mit verschiedenen API-Verwaltungslösungen verwaltet werden.

Für APIs, die mithilfe einer API-Verwaltungslösung verwaltet werden, kann API-Center Metadaten wie die Laufzeitumgebung und Bereitstellungsdetails speichern.

F: Werden meine Daten im API-Center verschlüsselt?

A: Ja, alle Daten im API-Center sind im Ruhezustand verschlüsselt.

Nächste Schritte