purview structure change (#3545)

specification/purview/data-plane/administration/readme.md

@@ -0,0 +1,97 @@
+# Purview
+
+> see https://aka.ms/autorest
+
+This is the AutoRest configuration file for Purview Administrator.
+
+---
+
+## Getting Started
+
+To build the SDK for Purview, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run:
+
+> `autorest`
+
+To see additional help and options, run:
+
+> `autorest --help`
+
+---
+
+## Configuration
+
+### Basic Information
+
+These are the global settings for the Azure Purview Catalog API.
+
+``` yaml
+openapi-type: data-plane
+tag: package-composite-1
+security: AADToken
+security-scopes:  https://purview.azure.net/.default
+modelerfour:
+  lenient-model-deduplication: true
+```
+
+```yaml $(purview-account)
+title: PurviewAccountClient
+purview-account-tag: package-preview-2019-11-01
+```
+
+```yaml $(purview-metadata)
+title: PurviewMetadataClient
+purview-metadata-tag: package-preview-2021-07-01
+```
+
+### Tag: package-composite-1
+
+These settings apply only when `--tag=package-composite-1` is specified on the command line.
+
+```yaml $(tag) == 'package-composite-1'
+input-file:
+  - Azure.Analytics.Purview.Account/preview/2019-11-01-preview/account.json
+  - Azure.Analytics.Purview.MetadataPolicies/preview/2021-07-01-preview/purviewMetadataPolicy.json
+```
+
+### Tag: package-preview-2019-11-01
+
+These settings apply only when `--purview-account-tag=package-preview-2019-11-01` is specified on the command line.
+
+```yaml $(purview-account-tag) == 'package-preview-2019-11-01'
+input-file:
+  - Azure.Analytics.Purview.Account/preview/2019-11-01-preview/account.json
+```
+
+### Tag: package-preview-2021-07-01
+
+These settings apply only when `--purview-metadata-tag=package-preview-2021-07-01` is specified on the command line.
+
+```yaml $(purview-metadata-tag) == 'package-preview-2021-07-01'
+input-file:
+  - Azure.Analytics.Purview.MetadataPolicies/preview/2021-07-01-preview/purviewMetadataPolicy.json
+```
+
+## Suppression
+
+``` yaml
+directive:
+  - suppress: D5001
+where:
+  - $.paths["/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/xxx.get
+reason: It doesn't support file annotation in example file.
+```
+
+# Code Generation
+
+## Swagger to SDK
+
+This section describes what SDK should be generated by the automatic system.
+This is not used by Autorest itself.
+
+``` yaml $(swagger-to-sdk)
+swagger-to-sdk:
+  - repo: azure-sdk-for-js
+  - repo: azure-sdk-for-python
+  - repo: azure-sdk-for-java
+  - repo: azure-sdk-for-net-track2
+```