Azure-rest-api-specs: Missing Swagger for Stream Analytics API `2017-04-01-preview`

[tombuildsstuff]

:wave:

At this time the Stream Analytics Swagger only has support for API Version 2016-03-01 - however to make use of a compatibilityLevel of 1.2 API version 2017-04-01-preview must be used.

Attempting to provision compatibilityLevel of 1.2 using the older API with the following HTTP Request:

:authority: management.azure.com
:method: PUT
:path: /subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/tom-devstreama/providers/Microsoft.StreamAnalytics/streamingjobs/tomdev-sa99?api-version=2016-03-01
:scheme: https
content-type: application/json; charset=utf-8
user-agent: Go/go1.11.5 (amd64-darwin) go-autorest/v11.7.0 Azure-SDK-For-Go/v26.7.0 streamanalytics/2016-03-01 Terraform/0.11.14 terraform-provider-azurerm/dev
authorization: Bearer XXXXXXXXXX
content-length: 432
accept-encoding: gzip

{
    "location": "westeurope",
    "name": "tomdev-sa99",
    "properties": {
        "sku": {
            "name": "Standard"
        },
        "eventsOutOfOrderPolicy": "Adjust",
        "outputErrorPolicy": "Drop",
        "eventsOutOfOrderMaxDelayInSeconds": 50,
        "eventsLateArrivalMaxDelayInSeconds": 60,
        "dataLocale": "en-GB",
        "compatibilityLevel": "1.2",
        "transformation": {
            "name": "Transformation",
            "properties": {
                "streamingUnits": 3,
                "query": "    SELECT *\n    INTO [YourOutputAlias]\n    FROM [YourInputAlias]\n"
            }
        }
    }
}

returns the response:

cache-control: no-store, no-cache
pragma: no-cache
content-length: 447
content-type: application/json; charset=utf-8
expires: -1
x-aspnetmvc-version: 5.0
x-ms-request-id: 96015f4c-87a3-4ee8-9926-be994b702481
x-ms-ratelimit-remaining-subscription-writes: 1199
server: Microsoft-IIS/8.5
x-powered-by: ASP.NET
x-ms-correlation-request-id: 61a3efb9-631c-4f48-89d8-8a15aa3808d2
x-ms-routing-request-id: UKSOUTH:20190410T094111Z:61a3efb9-631c-4f48-89d8-8a15aa3808d2
strict-transport-security: max-age=31536000; includeSubDomains
x-content-type-options: nosniff
date: Wed, 10 Apr 2019 09:41:11 GMT

{
    "code": "422",
    "message": "Feature compatibilityLevel with value 1.2 is not supported in API version 2016-03-01.1.10. Please use API version 2017-04-01-preview.1.12.",
    "details": {
        "code": "422",
        "message": "Feature compatibilityLevel with value 1.2 is not supported in API version 2016-03-01.1.10. Please use API version 2017-04-01-preview.1.12.",
        "correlationId": "61a3efb9-631c-4f48-89d8-8a15aa3808d2",
        "requestId": "96015f4c-87a3-4ee8-9926-be994b702481"
    }
}

So that we can fully support this feature, would it be possible to add the Swagger for the new API version?

Thanks!

[sidramadoss]

@tombuildsstuff - sorry for the late reply. And apologies for Swagger not being available for the new API version. We ack this and will be working on adding it over the coming months. Thanks for the feedback.

[sidramadoss]

@tombuildsstuff - just to be clear. we are working on updating the swagger spec for the GA API version and not the preview API. Given the preview API version can change/less stable than GA, we are not planning to publish a swagger spec for it.

[veronicagg]

Closing the issue per @sidramadoss response, feel free to reopen if you disagree. Thanks!

[tombuildsstuff]

@sidramadoss sounds good 👍

[mcalnd70]

@sidramadoss @tombuildsstuff I came here because this is linked from the following Terraform page...

https://www.terraform.io/docs/providers/azurerm/r/stream_analytics_job.html#compatibility_level

...but find that this has been closed

As its 8 months later, are there any updates?

Thanks

[neil-yechenwei]

@sidramadoss , @veronicagg , seems GA API version hasn't supported Compatibility Level 1.2 yet. May I know is there any ETA for this request?
https://github.com/Azure/azure-rest-api-specs/blob/9bd8781377f51d576aca18d1f32f8c49c2247184/specification/streamanalytics/resource-manager/Microsoft.StreamAnalytics/stable/2016-03-01/streamingjobs.json#L734

[danielrbradley]

It appears that the documentation is no longer describing version 1.2 as "preview" any more - just as "Newest behavior" and also recommends using 1.2 by default.

Has this change been reflected in the APIs yet? Or can anyone share if there's an expected date for this to be completed?

[an-emma]

@danielrbradley To answer your question, compatibility Level 1.2 is only available from preview API version.

[andregodin]

@helpful_developers,

Since it's now the default value when we create a StreamAnalytics manually on the portal, can you please make the CompatibilityLevel 1.2 "Globally Available"?

It would really helps us!

Thanks ;)

[stawii]

Insert "two years later" meme..

[dtzar]

Are there any plans to add this functionality to any version of the API so it can be added into Terraform provider?

[sidramadoss]

Sorry for the slow progress from our side. We are currently working on making a latest GA API version and also update swagger, SDKs, AzureCLI, Powershell and TF. Will roll out incrementally in the coming months.