Update swagger directory-Generate from official swagger specs (Azure#…

…14311)
AzureSDKAutomation · Aug 18, 2020 · 1bf4bd0 · 1bf4bd0
1 parent 92af16c
commit 1bf4bd0
Show file tree

Hide file tree

Showing 37 changed files with 19 additions and 6 deletions.
diff --git a/sdk/digitaltwins/Azure.DigitalTwins.Core/src/autorest.md b/sdk/digitaltwins/Azure.DigitalTwins.Core/src/autorest.md
@@ -1,16 +1,29 @@
 # Azure.DigitalTwins.Core
 
+## Azure DigitalTwins swagger
+
+## Local copy of the swagger document
+
+A local copy of the official swagger documents are stored in this directory for convenience and testing purposes. Please make sure that you do not use these swagger documents for official code generation purposes.
+
+## Official swagger document
+
+The official swagger specification for Azure DigitalTwins can be found [here](https://raw.githubusercontent.com/Azure/azure-rest-api-specs/97db8d1015c2780c2704fe0f55537ff1f4740140/specification/digitaltwins/data-plane/Microsoft.DigitalTwins/preview/2020-05-31-preview/digitaltwins.json).
+
+## Code generation
+
 Run `generate.ps1` in this directory to generate the code.
 
-### AutoRest Configuration
-> see https://aka.ms/autorest
+## AutoRest Configuration
+
+> see <https://aka.ms/autorest>
 
 ``` yaml
-#when generating from local changes:
-input-file: $(this-folder)/swagger/digitaltwins.json
+#when generating from official source - The raw link must have a commit hash for C# generator
+input-file: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/97db8d1015c2780c2704fe0f55537ff1f4740140/specification/digitaltwins/data-plane/Microsoft.DigitalTwins/preview/2020-05-31-preview/digitaltwins.json
 
-#when generating from official source
-#require: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/c3dd5df2863101b56eef256b810927cdcc4e44d2/specification/digitaltwins/data-plane/readme.md
+#if you want to generate using local changes:
+#input-file: $(this-folder)/swagger/2020-05-31-preview/digitaltwins.json
 
 #azure-arm: true
 #license-header: MICROSOFT_MIT_NO_VERSION

diff --git a/...lTwins.Core/src/swagger/digitaltwins.json → ...gger/2020-05-31-preview/digitaltwins.json b/...lTwins.Core/src/swagger/digitaltwins.json → ...gger/2020-05-31-preview/digitaltwins.json
diff --git a/...es/CreateRelationshipAdvancedExample.json → ...es/CreateRelationshipAdvancedExample.json b/...es/CreateRelationshipAdvancedExample.json → ...es/CreateRelationshipAdvancedExample.json
diff --git a/...mples/CreateRelationshipBasicExample.json → ...mples/CreateRelationshipBasicExample.json b/...mples/CreateRelationshipBasicExample.json → ...mples/CreateRelationshipBasicExample.json
diff --git a/...ore/src/swagger/examples/DeleteModel.json → ...0-05-31-preview/examples/DeleteModel.json b/...ore/src/swagger/examples/DeleteModel.json → ...0-05-31-preview/examples/DeleteModel.json
diff --git a/.../swagger/examples/DeleteRelationship.json → ...-preview/examples/DeleteRelationship.json b/.../swagger/examples/DeleteRelationship.json → ...-preview/examples/DeleteRelationship.json
diff --git a/...Core/src/swagger/examples/DeleteTwin.json → ...20-05-31-preview/examples/DeleteTwin.json b/...Core/src/swagger/examples/DeleteTwin.json → ...20-05-31-preview/examples/DeleteTwin.json
diff --git a/...rc/swagger/examples/EventRouteDelete.json → ...31-preview/examples/EventRouteDelete.json b/...rc/swagger/examples/EventRouteDelete.json → ...31-preview/examples/EventRouteDelete.json
diff --git a/...e/src/swagger/examples/EventRouteGet.json → ...05-31-preview/examples/EventRouteGet.json b/...e/src/swagger/examples/EventRouteGet.json → ...05-31-preview/examples/EventRouteGet.json
diff --git a/...e/src/swagger/examples/EventRoutePut.json → ...05-31-preview/examples/EventRoutePut.json b/...e/src/swagger/examples/EventRoutePut.json → ...05-31-preview/examples/EventRoutePut.json
diff --git a/...ger/examples/EventRoutePutWithFilter.json → ...iew/examples/EventRoutePutWithFilter.json b/...ger/examples/EventRoutePutWithFilter.json → ...iew/examples/EventRoutePutWithFilter.json
diff --git a/...src/swagger/examples/EventRoutesList.json → ...-31-preview/examples/EventRoutesList.json b/...src/swagger/examples/EventRoutesList.json → ...-31-preview/examples/EventRoutesList.json
diff --git a/...re/src/swagger/examples/GetComponent.json → ...-05-31-preview/examples/GetComponent.json b/...re/src/swagger/examples/GetComponent.json → ...-05-31-preview/examples/GetComponent.json
diff --git a/...ger/examples/GetIncomingRelationship.json → ...iew/examples/GetIncomingRelationship.json b/...ger/examples/GetIncomingRelationship.json → ...iew/examples/GetIncomingRelationship.json
diff --git a/...src/swagger/examples/GetRelationship.json → ...-31-preview/examples/GetRelationship.json b/...src/swagger/examples/GetRelationship.json → ...-31-preview/examples/GetRelationship.json
diff --git a/...swagger/examples/GetRelationshipById.json → ...preview/examples/GetRelationshipById.json b/...swagger/examples/GetRelationshipById.json → ...preview/examples/GetRelationshipById.json
diff --git a/...es/GetRelationshipByRelationshipName.json → ...es/GetRelationshipByRelationshipName.json b/...es/GetRelationshipByRelationshipName.json → ...es/GetRelationshipByRelationshipName.json
diff --git a/...ns.Core/src/swagger/examples/GetTwin.json → .../2020-05-31-preview/examples/GetTwin.json b/...ns.Core/src/swagger/examples/GetTwin.json → .../2020-05-31-preview/examples/GetTwin.json
diff --git a/...s.Core/src/swagger/examples/ModelAdd.json → ...2020-05-31-preview/examples/ModelAdd.json b/...s.Core/src/swagger/examples/ModelAdd.json → ...2020-05-31-preview/examples/ModelAdd.json
diff --git a/...re/src/swagger/examples/ModelGetById.json → ...-05-31-preview/examples/ModelGetById.json b/...re/src/swagger/examples/ModelGetById.json → ...-05-31-preview/examples/ModelGetById.json
diff --git a/...delGetByIdWithIncludeModelDefinition.json → ...delGetByIdWithIncludeModelDefinition.json b/...delGetByIdWithIncludeModelDefinition.json → ...delGetByIdWithIncludeModelDefinition.json
diff --git a/...r/examples/ModelUpdateDecommissioned.json → ...w/examples/ModelUpdateDecommissioned.json b/...r/examples/ModelUpdateDecommissioned.json → ...w/examples/ModelUpdateDecommissioned.json
diff --git a/....Core/src/swagger/examples/ModelsGet.json → ...020-05-31-preview/examples/ModelsGet.json b/....Core/src/swagger/examples/ModelsGet.json → ...020-05-31-preview/examples/ModelsGet.json
diff --git a/...ependenciesAndIncludeModelDefinition.json → ...ependenciesAndIncludeModelDefinition.json b/...ependenciesAndIncludeModelDefinition.json → ...ependenciesAndIncludeModelDefinition.json
diff --git a/...amples/PatchComponentAdvancedExample.json → ...amples/PatchComponentAdvancedExample.json b/...amples/PatchComponentAdvancedExample.json → ...amples/PatchComponentAdvancedExample.json
diff --git a/.../examples/PatchComponentBasicExample.json → .../examples/PatchComponentBasicExample.json b/.../examples/PatchComponentBasicExample.json → .../examples/PatchComponentBasicExample.json
diff --git a/...les/PatchRelationshipAdvancedExample.json → ...les/PatchRelationshipAdvancedExample.json b/...les/PatchRelationshipAdvancedExample.json → ...les/PatchRelationshipAdvancedExample.json
diff --git a/...amples/PatchRelationshipBasicExample.json → ...amples/PatchRelationshipBasicExample.json b/...amples/PatchRelationshipBasicExample.json → ...amples/PatchRelationshipBasicExample.json
diff --git a/...er/examples/PatchTwinAdvancedExample.json → ...ew/examples/PatchTwinAdvancedExample.json b/...er/examples/PatchTwinAdvancedExample.json → ...ew/examples/PatchTwinAdvancedExample.json
diff --git a/...agger/examples/PatchTwinBasicExample.json → ...eview/examples/PatchTwinBasicExample.json b/...agger/examples/PatchTwinBasicExample.json → ...eview/examples/PatchTwinBasicExample.json
diff --git a/...gger/examples/PutTwinAdvancedExample.json → ...view/examples/PutTwinAdvancedExample.json b/...gger/examples/PutTwinAdvancedExample.json → ...view/examples/PutTwinAdvancedExample.json
diff --git a/...swagger/examples/PutTwinBasicExample.json → ...preview/examples/PutTwinBasicExample.json b/...swagger/examples/PutTwinBasicExample.json → ...preview/examples/PutTwinBasicExample.json
diff --git a/.../src/swagger/examples/QueryFirstPage.json → ...5-31-preview/examples/QueryFirstPage.json b/.../src/swagger/examples/QueryFirstPage.json → ...5-31-preview/examples/QueryFirstPage.json
diff --git a/....Core/src/swagger/examples/QueryJoin.json → ...020-05-31-preview/examples/QueryJoin.json b/....Core/src/swagger/examples/QueryJoin.json → ...020-05-31-preview/examples/QueryJoin.json
diff --git a/...e/src/swagger/examples/QueryNextPage.json → ...05-31-preview/examples/QueryNextPage.json b/...e/src/swagger/examples/QueryNextPage.json → ...05-31-preview/examples/QueryNextPage.json
diff --git a/...e/src/swagger/examples/SendTelemetry.json → ...05-31-preview/examples/SendTelemetry.json b/...e/src/swagger/examples/SendTelemetry.json → ...05-31-preview/examples/SendTelemetry.json
diff --git a/.../examples/SendTelemetryFromComponent.json → .../examples/SendTelemetryFromComponent.json b/.../examples/SendTelemetryFromComponent.json → .../examples/SendTelemetryFromComponent.json