[Azure API Center - API Center] API Review

[azure-sdk]

New API Review meeting has been requested.

Service Name: Azure API Center - API Center Review Created By: Alexander Zaslonov Review Date: 12/14/2023 04:00 PM PT Onboarding Record: https://dev.azure.com/azure-sdk/Release/_workitems/edit/17838 PR: Hero Scenarios Link: here Core Concepts Doc Link: Not Provided

Description: Requesting this review of Data plane API of Azure API Center - a new Azure service for organizations that have a large number of APIs. It allows them to inventory these APIs, provide documentation, code samples, SDKs, place certain policies to the shape of these APIs, etc.. All this to help the developers/partners to discover APIs that exist in the organization, onboard, connect with owners, and get support.

Detailed meeting information and documents provided can be accessed here For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[azure-sdk]

Meeting updated by Alexander Zaslonov

Service Name: Azure API Center - API Center Review Created By: Alexander Zaslonov Review Date: 12/14/2023 04:00 PM PT Onboarding Record: https://dev.azure.com/azure-sdk/Release/_workitems/edit/17838 PR: https://github.com/Azure/azure-rest-api-specs/pull/27052 Hero Scenarios Link: here Core Concepts Doc Link: Not Provided

Description: Requesting this review of Data plane API of Azure API Center - a new Azure service for organizations that have a large number of APIs. It allows them to inventory these APIs, provide documentation, code samples, SDKs, place certain policies to the shape of these APIs, etc.. All this to help the developers/partners to discover APIs that exist in the organization, onboard, connect with owners, and get support.

Detailed meeting information and documents provided can be accessed here For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[mikekistler]

Notes from REST API Review, 12/14/23

• Need to update the API to be preview rather than GA
• Data plane authentication -- currently says API Key auth, need to change it to AADAuth
  • User impersonation -- fine; single audience -- also okay
  • Client id validation ? Need to find an SME
• Combine the "Resource" and child class to simplify things
• Maybe turn of support for conditional requests in the traits
• format for export specification should indicate allowed values and the behavior for each
• Do you really want to support "select" query parameter? Problematic!

This looks good for preview.

[azaslonov]

@mikekistler, we finally ready to merge. Could you please have a look once more and, if all good, get it approved for merge?

cc: @Bruce-Moe.