Azure-docs: Reference document is not updated.

Created on 31 Aug 2018  Â·  10Comments  Â·  Source: MicrosoftDocs/azure-docs

Microsoft.OperationalInsights/workspaces template reference is the old API version (2015-11-01-preview).
Please update.
https://docs.microsoft.com/en-us/azure/templates/microsoft.operationalinsights/workspaces


Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

assigned-to-author doc-enhancement log-analyticsvc triaged

All 10 comments

@takekazuomi Thanks for the feedback! I have assigned the issue to the content author to evaluate and update as appropriate.

@vasivara-MSFT - the reference content is not something I manage. Looping in @tfitzmac who manages the ARM content for an update.

I am not seeing a swagger file for a new version. The ones I see are at https://github.com/Azure/azure-rest-api-specs/tree/master/specification/operationalinsights/resource-manager/Microsoft.OperationalInsights

Does anyone know where the new version is located? It looks like the REST API docs are also pointing to 2015-11-01-preview.

I could not find a newer API version either. My customer is looking for a way to set the "daily cap" using ARM.

@MGoedtel - can you find out from this team if new swagger files are missing? Perhaps, they have changed the location of the files. I don't see any versions beyond 2015-11-01-preview in the azure-rest-api-specs repo.

@tfitzmac - Yes, I'll ping them now and get back to you.

@takekazuomi and @tfitzmac - I've confirmed that 2015-03-20 listed in the GitHub repo for the API is the most recent version of the API for Log Analytics. I'll bug the documentation to update the templates to reference that version.

@MGoedtel Thank you.
In the API Document, it is as follows.

Types Versions
workspaces 2015-11-01-preview
workspaces / dataSources 2015-11-01-preview
workspaces / linkedServices 2015-11-01-preview
workspaces / savedSearches 2015-03-20
workspaces / storageInsightConfigs 2015-03-20

https://docs.microsoft.com/en-us/azure/templates/microsoft.operationalinsights/allversions

This API document has no description of solutions resources.
However, the following document describes how to add solutions resources.
https://docs.microsoft.com/en-us/azure/azure-monitor/platform/template-workspace-configuration#configure-a-log-analytics-workspace

Is this a mistake in "docs.microsoft.com"?

@takekazuomi - if you are referring to Microsoft.OperationsManagment/solutions, I have added it.

@takekazuomi & @tfitzmac - I've reviewed all the LA articles that include reference to the API and templates for performing these tasks via CLI/PowerShell and corrected any inaccuracies regarding versioning. The change will go live later today. Thank you for your help! #please-close

Was this page helpful?
0 / 5 - 0 ratings

Related issues

ianpowell2017 picture ianpowell2017  Â·  3Comments

varma31 picture varma31  Â·  3Comments

JeffLoo-ong picture JeffLoo-ong  Â·  3Comments

spottedmahn picture spottedmahn  Â·  3Comments

JamesDLD picture JamesDLD  Â·  3Comments