GUIDELINES

The value of Cadl in designing APIs

December 13, 2022 Dec 13, 2022 12/13/22

Mike Kistler, Mark W.

This blog post describes the new Cadl API design language and its benefits for API authoring.

Guidance for multi-tenant applications using the Azure Identity libraries

September 20, 2022 Sep 20, 2022 09/20/22

Scott Schaab

Guidelines for multi-tenant applications to validate tenant ownership of user-provided URIs for Azure resources.

Guidance for applications using the Key Vault libraries

September 20, 2022 Sep 20, 2022 09/20/22

Heath Stewart

Guidelines for applications to validate user-provided URIs for Azure Key Vault or Managed HSM to avoid a potential risk of leaking authentication information.

It just takes time. Updated guidance on Azure long-running operations.

June 28, 2022 Jun 28, 2022 06/28/22

Mark W., Mike Kistler

Developers hate waiting, but sometimes it's necessary. When we know something is going to take time in Azure, it's modeled as a long-running operation (LRO). We've recently updated our guidance on LROs in our REST API guidelines.

Azure REST API Guidelines Update

October 5, 2021 Oct 5, 2021 10/5/21

Mark W., Mike Kistler

Providing APIs that are easy to use, fit to purpose, scalable, maintainable, and consistent make the difference between success and failure for your software. The guidelines help Microsoft engineering teams, and others building REST services, create APIs that are approachable, sustainable, and consistent.

Azure SDK Blog

GUIDELINES - Azure SDK Blog

The value of Cadl in designing APIs

Guidance for multi-tenant applications using the Azure Identity libraries

Guidance for applications using the Key Vault libraries

It just takes time. Updated guidance on Azure long-running operations.

Azure REST API Guidelines Update