Microsoft Azure Software Plan RP

What authentication does the Software Plan API use?

It uses Azure AD OAuth 2.0 with the implicit flow against https://login.microsoftonline.com/common/oauth2/authorize and the user_impersonation scope. When called through Jentic, your AAD service principal credentials live in your Jentic One instance and the agent receives only a short-lived bearer token.

Can I create a Hybrid Use Benefit plan with this API?

Yes. PUT /{scope}/providers/Microsoft.SoftwarePlan/hybridUseBenefits/{planId} with the SKU (for example SQL_Server_Perpetual) and the resource scope. Make sure the Microsoft.SoftwarePlan provider is registered on the subscription first by POSTing /subscriptions/{subscriptionId}/providers/Microsoft.SoftwarePlan/register.

How do I see the revision history of a plan?

GET /{scope}/providers/Microsoft.SoftwarePlan/hybridUseBenefits/{planId}/revisions returns each revision in chronological order with the values that changed. Use this for compliance trails when license assignments change.

What are the rate limits for this API?

Azure Resource Manager throttles around 12,000 reads and 1,200 writes per hour per principal at subscription scope, surfaced via x-ms-ratelimit-remaining-subscription-reads and x-ms-ratelimit-remaining-subscription-writes response headers. The Software Plan surface is small and write traffic is rare, so quota is rarely a concern.

How do I audit Hybrid Use Benefit coverage through Jentic?

Search Jentic for list azure hybrid use benefit plans, load the schema for GET /{scope}/providers/Microsoft.SoftwarePlan/hybridUseBenefits, and execute it across each subscription scope. The Jentic Python SDK ships the search, load, execute pattern after pip install jentic.

Does this API show me the license cost savings?

No - it manages the plan assignment, not the dollar impact. Pair it with the Cost Management API to compare billed compute cost before and after applying a Hybrid Use Benefit plan; the Consumption API exposes the per-meter charges that AHB reduces.

Can I limit what my agent is allowed to do with the Software Plan API?

Yes. Because Jentic One is self-hosted, the rules you set in your own instance decide which Microsoft.SoftwarePlan operations and which Azure AD service principal credential the agent may use. Since the resource scope and plan id sit in the URL path (/{scope}/providers/Microsoft.SoftwarePlan/hybridUseBenefits/{planId}), you can pin the agent to reading Hybrid Use Benefit plans and their revisions at a given scope. Creating or overwriting a plan with PUT is excluded unless you explicitly add it to the operations you allow.