Merge branch 'master' into onPremiseSensor-dev-security-Microsoft.Security-2020-08-06-preview

Author: Liran Chen

CODEOWNERS

@@ -1,4 +1,5 @@
 /specification/analysisservices/ @taiwu
+/specification/alertsmanagement/ @ofirmanor @olalavi @erangon @orieldar @ilaizi @shakednai1 @khaboasb @orenhor
 /specification/apimanagement/ @promoisha @solankisamir
 /specification/applicationinsights/ @alexeldeib
 /specification/asazure/ @athipp

azure-rest-api-specs

@@ -0,0 +1 @@
+Subproject commit 545a9ad7563fe2858d08aba9ee5b8444375d47a9

cSpell.json

@@ -713,6 +713,13 @@
                 "networkrulesets",
                 "Setget"
             ]
+        },
+        {
+            "filename": "**/specification/machinelearningservices/resource-manager/Microsoft.MachineLearningServices/preview/2020-05-01-preview/machineLearningServices.json",
+            "words": [
+                "mysqldb",
+                "psqldb"
+            ]
         }
     ]
 }

custom-words.txt

@@ -305,6 +305,7 @@ closedlist
 closedlists
 Cloudamize
 cloudapp
+cloudevents
 cloudproperties
 cloudsimple
 clustermonitoring
@@ -394,6 +395,7 @@ Databricks
 datacatalog
 Datacenter
 datacenters
+datacontenttype
 datadisk
 datafactory
 datafactoryv
@@ -408,6 +410,7 @@ datamigration
 datapoint
 Dataset
 datasets
+dataschema
 datasource
 Datasources
 datastore
@@ -477,6 +480,7 @@ discoverbackup
 diskmigrationjobs
 diskoperations
 Distcp
+Distro
 DMTS
 Dnat
 dnsname
@@ -486,6 +490,8 @@ Domainful
 domainname
 domainservices
 DOTALL
+dras
+DRAs
 DRMs
 dsmax
 DTDL
@@ -1473,6 +1479,7 @@ southindia
 sparkconf
 sparql
 SPDX
+specversion
 SQLAG
 sqldatabase
 SQLDB
@@ -1633,6 +1640,7 @@ Turbonomic
 Txns
 Typeless
 typeperf
+UEFI
 UEBA
 Uint
 uksouth

documentation/code-gen/configure-python-sdk.md

@@ -86,7 +86,8 @@ This is not used by Autorest itself.
 
 ``` yaml $(swagger-to-sdk)
 swagger-to-sdk:
-  - repo: azure-sdk-for-python
+  - repo: azure-sdk-for-python                          // for track1 SDK
+  - repo: azure-sdk-for-python-track2                   // for track2 SDK
   - ...
 
 
@@ -226,12 +227,13 @@ After configure all the readme files, autorest can be used to generate SDK.
 Track1 SDK is based on AutoRest version V2 that's going to be replaced by version V3.
 
 ~~~
-autorest --keep-version-file --multiapi --no-async --python --python-mode=update --python-sdks-folder=C:\ZZ\projects\codegen\azure-sdk-for-python\sdk [email protected]/autorest.python@~4.0.71 --version=V2 ..\azure-rest-api-specs\specification\appconfiguration\resource-manager\readme.md
+> autorest --keep-version-file --multiapi --no-async --python --python-mode=update --python-sdks-folder=C:\ZZ\projects\codegen\azure-sdk-for-python\sdk [email protected]/autorest.python@~4.0.71 --version=V2 ..\azure-rest-api-specs\specification\appconfiguration\resource-manager\readme.md
 ~~~
 
 ### Track2 (for latest Autorest)
 Track 2 is based on the latest AutoRest code generator
 
 ~~~
-autorest --python --track2 --use=@autorest/[email protected] --python-sdks-folder=..\azure-sdk-for-python\sdk --multiapi --python-mode=update  ..\azure-rest-api-specs\specification\appconfiguration\resource-manager\readme.md
+> autorest --reset
+> autorest --python --track2 --use=@autorest/[email protected] --python-sdks-folder=..\azure-sdk-for-python\sdk --multiapi --python-mode=update  ..\azure-rest-api-specs\specification\appconfiguration\resource-manager\readme.md
 ~~~

documentation/openapi-authoring-automated-guidelines.md

@@ -140,6 +140,7 @@ We request OpenAPI(Swagger) spec authoring be assigned to engineers who have an
 | [R2007](#r2007) | [LongRunningOperationsWithLongRunningExtension](#r2007) | ARM OpenAPI(swagger) specs |
 | [R2029](#r2029) | [PageableOperation](#r2029) | ARM and Data plane OpenAPI(swagger) specs |
 | [R4006](#r4006) | [DeprecatedXmsCodeGenerationSetting](#r4006) | ARM and Data plane OpenAPI(swagger) specs |
+| [R4024](#r4024) | [PreviewVersionOverOneYear](#r4024) | ARM OpenAPI(swagger) specs |
 
 
 ### RPaaS Violations
@@ -1432,7 +1433,7 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 
 **Applies to** : ARM OpenAPI(swagger) specs
 
-**Output Message**: Top level properties should be one of name, type, id, location, properties, tags, plan, sku, etag, managedBy, identity, systemData. Model definition '{0}' has extra properties ['{1}'].
+**Output Message**: Top level properties should be one of name, type, id, location, properties, tags, plan, sku, etag, managedBy, identity, systemData, extendedlocation. Model definition '{0}' has extra properties ['{1}'].
 
 **Description**: Per [ARM guidelines](https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md), top level properties of a resource should be only ones from the allowed set.
 
@@ -1690,7 +1691,7 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 **Output Message**: Properties of a PATCH request body must not be {0}. PATCH operation: '{1}' Model Definition: '{2}' Property: '{3}'
 
 **Description**: A request parameter of the Patch Operation must not have a required/default value.
-But it's allowed when all required properties are marked as discriminator, because the discriminator must be required.
+But it's allowed when the only required properties is marked as discriminator, because the discriminator must be required.
 
 **CreatedAt** : N/A
 
@@ -1994,7 +1995,7 @@ Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rul
 
 ### <a name="r3021" ></a>R3021 PathResourceTypeNameCamelCase
 
-**Category** : ARM Warning
+**Category** : ARM Error
 
 **Applies to** : ARM and Data Plane OpenAPI(swagger) specs
 
@@ -2948,4 +2949,24 @@ The following would be valid:
   }
 ...
 ```
-Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
+Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
+
+### <a name="r4024" ></a>R4024 PreviewVersionOverOneYear
+
+**Category** : SDK Warning
+
+**Applies to** : ARM OpenAPI(swagger) specs
+
+**Output Message** : The API version:{api-version} having been in a preview state over one year , please move to GA or retire.
+
+**Description** : Per [Retirement-of-Previews](https://dev.azure.com/msazure/AzureWiki/_wiki/wikis/AzureWiki.wiki/37683/Retirement-of-Previews), service, feature, API, and SKU in preview for over one year need to move to GA or retire.
+
+**CreatedAt**: Sep 8, 2020
+
+**LastModifiedAt**: Sep 8, 2020
+
+**How to fix the violation**: 
+   Consider retiring or moving to GA. 
+   
+Links: [Index](#index) | [Error vs. Warning](#error-vs-warning) | [Automated Rules](#automated-rules) | [ARM](#arm-violations): [Errors](#arm-errors) or [Warnings](#arm-warnings) | [SDK](#sdk-violations): [Errors](#sdk-errors) or [Warnings](#sdk-warnings)
+