diff --git a/run b/run deleted file mode 100644 index e69de29bb2d1..000000000000 diff --git a/specification/advisor/resource-manager/readme.go.md b/specification/advisor/resource-manager/readme.go.md new file mode 100644 index 000000000000..66a3806db5ad --- /dev/null +++ b/specification/advisor/resource-manager/readme.go.md @@ -0,0 +1,46 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: advisor + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2017-04 + - tag: package-2017-03 + - tag: package-2016-07-preview +``` + +### Tag: package-2017-04 and go + +These settings apply only when `--tag=package-2017-04 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-04' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-04-19/$(namespace) +``` + +### Tag: package-2017-03 and go + +These settings apply only when `--tag=package-2017-03 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-03' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-03-31/$(namespace) +``` + +### Tag: package-2016-07-preview and go + +These settings apply only when `--tag=package-2016-07-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2016-07-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2016-07-12-preview/$(namespace) +``` \ No newline at end of file diff --git a/specification/advisor/resource-manager/readme.md b/specification/advisor/resource-manager/readme.md index 63eeaa356fa3..8657eed41d99 100644 --- a/specification/advisor/resource-manager/readme.md +++ b/specification/advisor/resource-manager/readme.md @@ -72,6 +72,7 @@ swagger-to-sdk: - repo: azure-sdk-for-python - repo: azure-sdk-for-java - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node ``` @@ -104,6 +105,9 @@ python: output-folder: $(python-sdks-folder)/azure-mgmt-advisor ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) ## C# @@ -120,55 +124,6 @@ csharp: clear-output-folder: true ``` - -## Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: advisor - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2017-04 - - tag: package-2017-03 - - tag: package-2016-07-preview -``` - -### Tag: package-2017-04 and go - -These settings apply only when `--tag=package-2017-04 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-04' && $(go) -output-folder: $(go-sdk-folder)/services/advisor/mgmt/2017-04-19/advisor -``` - -### Tag: package-2017-03 and go - -These settings apply only when `--tag=package-2017-03 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-03' && $(go) -output-folder: $(go-sdk-folder)/services/advisor/mgmt/2017-03-31/advisor -``` - -### Tag: package-2016-07-preview and go - -These settings apply only when `--tag=package-2016-07-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2016-07-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/advisor/mgmt/2016-07-12-preview/advisor -``` - - ## Java These settings apply only when `--java` is specified on the command line. diff --git a/specification/advisor/resource-manager/readme.typescript.md b/specification/advisor/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..4347edfa5ebb --- /dev/null +++ b/specification/advisor/resource-manager/readme.typescript.md @@ -0,0 +1,12 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-advisor" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-advisor" + generate-metadata: true +``` diff --git a/specification/alertsmanagement/resource-manager/readme.go.md b/specification/alertsmanagement/resource-manager/readme.go.md new file mode 100644 index 000000000000..4341e8cb6d5a --- /dev/null +++ b/specification/alertsmanagement/resource-manager/readme.go.md @@ -0,0 +1,25 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: alertsmanagement + clear-output-folder: true +``` + +### Go multi-api +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2018-05-preview +``` + +### Tag: package-2018-05-preview and go + +These settings apply only when `--tag=package-2018-05-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2018-05-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-05-05-preview/$(namespace) +``` \ No newline at end of file diff --git a/specification/alertsmanagement/resource-manager/readme.md b/specification/alertsmanagement/resource-manager/readme.md index 35e9e8fbd821..dcc1aebce0dd 100644 --- a/specification/alertsmanagement/resource-manager/readme.md +++ b/specification/alertsmanagement/resource-manager/readme.md @@ -1,12 +1,12 @@ # AlertsManagement - + > see https://aka.ms/autorest This is the AutoRest configuration file for AlerManagement. --- -## Getting Started +## Getting Started To build the SDK for AlertManagement, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run: > `autorest` @@ -19,7 +19,7 @@ To see additional help and options, run: ## Configuration -### Basic Information +### Basic Information These are the global settings for the AlertManagement API. ``` yaml @@ -62,7 +62,7 @@ swagger-to-sdk: - repo: azure-sdk-for-go ``` -## C# +## C# These settings apply only when `--csharp` is specified on the command line. Please also specify `--csharp-sdks-folder=`. @@ -103,32 +103,9 @@ python: output-folder: $(python-sdks-folder)/azure-mgmt-alertsmanagement ``` - ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: alertsmanagement - clear-output-folder: true -``` - -### Go multi-api -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2018-05-preview -``` - -### Tag: package-2018-05-preview and go - -These settings apply only when `--tag=package-2018-05-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2018-05-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-05-05-preview/$(namespace) -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/analysisservices/resource-manager/readme.go.md b/specification/analysisservices/resource-manager/readme.go.md new file mode 100644 index 000000000000..aedfd776f799 --- /dev/null +++ b/specification/analysisservices/resource-manager/readme.go.md @@ -0,0 +1,46 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: analysisservices + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2017-08 + - tag: package-2017-07 + - tag: package-2016-05 +``` + +### Tag: package-2017-08 and go + +These settings apply only when `--tag=package-2017-08 --go` is specifined on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-08' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-08-01/$(namespace) +``` + +### Tag: package-2017-07 and go + +These settings apply only when `--tag=package-2017-07 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-07' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-07-14/$(namespace) +``` + +### Tag: package-2016-05 and go + +These settings apply only when `--tag=package-2016-05 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2016-05' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2016-05-16/$(namespace) +``` diff --git a/specification/analysisservices/resource-manager/readme.md b/specification/analysisservices/resource-manager/readme.md index 5e96e69f552b..236ceadc1aa3 100644 --- a/specification/analysisservices/resource-manager/readme.md +++ b/specification/analysisservices/resource-manager/readme.md @@ -78,6 +78,7 @@ This is not used by Autorest itself. ``` yaml $(swagger-to-sdk) swagger-to-sdk: - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node - repo: azure-sdk-for-ruby after_scripts: @@ -99,139 +100,84 @@ csharp: clear-output-folder: true ``` - ## Go -These settings apply only when `--go` is specified on the command line. +See configuration in [readme.go.md](./readme.go.md) -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: analysisservices - clear-output-folder: true +## Java + +These settings apply only when `--java` is specified on the command line. +Please also specify `--azure-libraries-for-java-folder=`. + +``` yaml $(java) +azure-arm: true +fluent: true +namespace: com.microsoft.azure.management.analysisservices +license-header: MICROSOFT_MIT_NO_CODEGEN +payload-flattening-threshold: 1 +output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-analysisservices ``` -### Go multi-api +### Java multi-api -``` yaml $(go) && $(multiapi) +``` yaml $(java) && $(multiapi) batch: + - tag: package-2016-05 + - tag: package-2017-07 - tag: package-2017-08 - tag: package-2017-08-beta - - tag: package-2017-07 - - tag: package-2016-05 ``` -### Tag: package-2017-08 and go +### Tag: package-2016-05 and java -These settings apply only when `--tag=package-2017-08 --go` is specifined on the command line. -Please also specify `--go-sdk-folder=`. +These settings apply only when `--tag=package-2016-05 --java` is specified on the command line. +Please also specify `--azure-libraries-for-java=`. -``` yaml $(tag) == 'package-2017-08' && $(go) -output-folder: $(go-sdk-folder)/services/analysisservices/mgmt/2017-08-01/analysisservices +``` yaml $(tag) == 'package-2016-05' && $(java) && $(multiapi) +java: + namespace: com.microsoft.azure.management.analysisservices.v2016_05_16 + output-folder: $(azure-libraries-for-java-folder)/analysisservices/resource-manager/v2016_05_16 +regenerate-manager: true +generate-interface: true ``` -### Tag: package-2017-08-beta and go +### Tag: package-2017-07 and java -These settings apply only when `--tag=package-2017-08-beta --go` is specifined on the command line. -Please also specify `--go-sdk-folder=`. +These settings apply only when `--tag=package-2017-07 --java` is specified on the command line. +Please also specify `--azure-libraries-for-java=`. -``` yaml $(tag) == 'package-2017-08-beta' && $(go) -output-folder: $(go-sdk-folder)/services/preview/analysisservices/preview/mgmt/2017-08-01-beta/analysisservices +``` yaml $(tag) == 'package-2017-07' && $(java) && $(multiapi) +java: + namespace: com.microsoft.azure.management.analysisservices.v2017_07_14 + output-folder: $(azure-libraries-for-java-folder)/analysisservices/resource-manager/v2017_07_14 +regenerate-manager: true +generate-interface: true ``` -### Tag: package-2017-07 and go +### Tag: package-2017-08 and java -These settings apply only when `--tag=package-2017-07 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. +These settings apply only when `--tag=package-2017-08 --java` is specified on the command line. +Please also specify `--azure-libraries-for-java=`. -``` yaml $(tag) == 'package-2017-07' && $(go) -output-folder: $(go-sdk-folder)/services/analysisservices/mgmt/2017-07-14/analysisservices +``` yaml $(tag) == 'package-2017-08' && $(java) && $(multiapi) +java: + namespace: com.microsoft.azure.management.analysisservices.v2017_08_01 + output-folder: $(azure-libraries-for-java-folder)/analysisservices/resource-manager/v2017_08_01 +regenerate-manager: true +generate-interface: true ``` -### Tag: package-2016-05 and go +### Tag: package-2017-08-beta and java -These settings apply only when `--tag=package-2016-05 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. +These settings apply only when `--tag=package-2017-08-beta --java` is specified on the command line. +Please also specify `--azure-libraries-for-java=`. -``` yaml $(tag) == 'package-2016-05' && $(go) -output-folder: $(go-sdk-folder)/services/analysisservices/mgmt/2016-05-16/analysisservices +``` yaml $(tag) == 'package-2017-08-beta' && $(java) && $(multiapi) +java: + namespace: com.microsoft.azure.management.analysisservices.v2017_08_01_beta + output-folder: $(azure-libraries-for-java-folder)/analysisservices/resource-manager/v2017_08_01_beta +regenerate-manager: true +generate-interface: true ``` -## Java - -These settings apply only when `--java` is specified on the command line. -Please also specify `--azure-libraries-for-java-folder=`. - -``` yaml $(java) -azure-arm: true -fluent: true -namespace: com.microsoft.azure.management.analysisservices -license-header: MICROSOFT_MIT_NO_CODEGEN -payload-flattening-threshold: 1 -output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-analysisservices -``` - -### Java multi-api - -``` yaml $(java) && $(multiapi) -batch: - - tag: package-2016-05 - - tag: package-2017-07 - - tag: package-2017-08 - - tag: package-2017-08-beta -``` - -### Tag: package-2016-05 and java - -These settings apply only when `--tag=package-2016-05 --java` is specified on the command line. -Please also specify `--azure-libraries-for-java=`. - -``` yaml $(tag) == 'package-2016-05' && $(java) && $(multiapi) -java: - namespace: com.microsoft.azure.management.analysisservices.v2016_05_16 - output-folder: $(azure-libraries-for-java-folder)/analysisservices/resource-manager/v2016_05_16 -regenerate-manager: true -generate-interface: true -``` - -### Tag: package-2017-07 and java - -These settings apply only when `--tag=package-2017-07 --java` is specified on the command line. -Please also specify `--azure-libraries-for-java=`. - -``` yaml $(tag) == 'package-2017-07' && $(java) && $(multiapi) -java: - namespace: com.microsoft.azure.management.analysisservices.v2017_07_14 - output-folder: $(azure-libraries-for-java-folder)/analysisservices/resource-manager/v2017_07_14 -regenerate-manager: true -generate-interface: true -``` - -### Tag: package-2017-08 and java - -These settings apply only when `--tag=package-2017-08 --java` is specified on the command line. -Please also specify `--azure-libraries-for-java=`. - -``` yaml $(tag) == 'package-2017-08' && $(java) && $(multiapi) -java: - namespace: com.microsoft.azure.management.analysisservices.v2017_08_01 - output-folder: $(azure-libraries-for-java-folder)/analysisservices/resource-manager/v2017_08_01 -regenerate-manager: true -generate-interface: true -``` - -### Tag: package-2017-08-beta and java - -These settings apply only when `--tag=package-2017-08-beta --java` is specified on the command line. -Please also specify `--azure-libraries-for-java=`. - -``` yaml $(tag) == 'package-2017-08-beta' && $(java) && $(multiapi) -java: - namespace: com.microsoft.azure.management.analysisservices.v2017_08_01_beta - output-folder: $(azure-libraries-for-java-folder)/analysisservices/resource-manager/v2017_08_01_beta -regenerate-manager: true -generate-interface: true -``` - - diff --git a/specification/analysisservices/resource-manager/readme.typescript.md b/specification/analysisservices/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..c87e05f32327 --- /dev/null +++ b/specification/analysisservices/resource-manager/readme.typescript.md @@ -0,0 +1,12 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-analysisservices" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-analysisservices" + generate-metadata: true +``` diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-01-01/apimapis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-01-01/apimapis.json index c5074d3c172a..bdedca08bd5a 100644 --- a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-01-01/apimapis.json +++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-01-01/apimapis.json @@ -233,6 +233,9 @@ }, "ApiManagementCreateApiRevision": { "$ref": "./examples/ApiManagementCreateApiRevision.json" + }, + "ApiManagementCreateApiWithOpenIdConnect": { + "$ref": "./examples/ApiManagementCreateApiWithOpenIdConnect.json" } }, "consumes": [ @@ -3740,7 +3743,7 @@ { "value": "soap", "description": "Imports the Soap API having a SOAP front end.", - "name": "SoapPassThrough" + "name": "SoapPassThrough" } ] } @@ -3905,7 +3908,7 @@ }, "apiRevisionDescription": { "type": "string", - "description": "Description of the Api Revision.", + "description": "Description of the Api Revision.", "maxLength": 256 }, "apiVersionDescription": { @@ -4104,6 +4107,14 @@ "oAuth2": { "$ref": "#/definitions/OAuth2AuthenticationSettingsContract", "description": "OAuth2 Authentication settings" + }, + "openid": { + "$ref": "#/definitions/OpenIdAuthenticationSettingsContract", + "description": "OpenID Connect Authentication Settings" + }, + "subscriptionKeyRequired": { + "type": "boolean", + "description": "Specifies whether subscription key is required during call to this API, true - API is included into closed products only, false - API is included into open products alone, null - there is a mix of products." } }, "description": "API Authentication Settings." @@ -4121,6 +4132,44 @@ }, "description": "API OAuth2 Authentication settings details." }, + "OpenIdAuthenticationSettingsContract": { + "properties": { + "openidProviderId": { + "type": "string", + "description": "OAuth authorization server identifier." + }, + "bearerTokenSendingMethods": { + "description": "How to send token to the server.", + "type": "array", + "items": { + "$ref": "#/definitions/BearerTokenSendingMethodsContract" + } + } + }, + "description": "API OAuth2 Authentication settings details." + }, + "BearerTokenSendingMethodsContract": { + "type": "string", + "description": "Form of an authorization grant, which the client uses to request the access token.", + "enum": [ + "authorizationHeader", + "query" + ], + "x-ms-enum": { + "modelAsString": true, + "name": "bearerTokenSendingMethods", + "values": [ + { + "value": "authorizationHeader", + "description": "Access token will be transmitted in the Authorization header using Bearer schema" + }, + { + "value": "query", + "description": "Access token will be transmitted as query parameters." + } + ] + } + }, "OperationCollection": { "properties": { "value": { @@ -4511,7 +4560,7 @@ "description": "Text describing the issue." }, "createdDate": { - "type":"string", + "type": "string", "format": "date-time", "description": "Date and time when the issue was created." }, @@ -4608,7 +4657,7 @@ "description": "Comment text." }, "createdDate": { - "type":"string", + "type": "string", "format": "date-time", "description": "Date and time when the comment was created." }, @@ -4663,7 +4712,7 @@ "description": "Filename by which the binary data will be saved." }, "contentFormat": { - "type":"string", + "type": "string", "description": "Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property." }, "content": { diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-01-01/examples/ApiManagementCreateApiWithOpenIdConnect.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-01-01/examples/ApiManagementCreateApiWithOpenIdConnect.json new file mode 100644 index 000000000000..2e18b4aa455a --- /dev/null +++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-01-01/examples/ApiManagementCreateApiWithOpenIdConnect.json @@ -0,0 +1,94 @@ +{ + "parameters": { + "serviceName": "apimService1", + "resourceGroupName": "rg1", + "api-version": "2018-01-01", + "subscriptionId": "subid", + "apiId": "tempgroup", + "parameters": { + "properties": { + "displayName": "Swagger Petstore", + "description": "This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters.", + "serviceUrl": "http://petstore.swagger.io/v2", + "path": "petstore", + "protocols": [ + "https" + ], + "authenticationSettings": { + "openid": { + "openidProviderId": "testopenid", + "bearerTokenSendingMethods": [ + "authorizationHeader" + ] + } + }, + "subscriptionKeyParameterNames": { + "header": "Ocp-Apim-Subscription-Key", + "query": "subscription-key" + } + } + } + }, + "responses": { + "201": { + "body": { + "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/58da4c4ccdae970a08121230", + "type": "Microsoft.ApiManagement/service/apis", + "name": "58da4c4ccdae970a08121230", + "properties": { + "displayName": "Swagger Petstore", + "apiRevision": "1", + "description": "This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters.", + "serviceUrl": "http://petstore.swagger.io/v2", + "path": "petstore", + "protocols": [ + "https" + ], + "authenticationSettings": { + "openid": { + "openidProviderId": "testopenid", + "bearerTokenSendingMethods": [ + "authorizationHeader" + ] + } + }, + "subscriptionKeyParameterNames": { + "header": "Ocp-Apim-Subscription-Key", + "query": "subscription-key" + }, + "isCurrent": true + } + } + }, + "200": { + "body": { + "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/58da4c4ccdae970a08121230", + "type": "Microsoft.ApiManagement/service/apis", + "name": "58da4c4ccdae970a08121230", + "properties": { + "displayName": "Swagger Petstore", + "apiRevision": "1", + "description": "This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters.", + "serviceUrl": "http://petstore.swagger.io/v2", + "path": "petstore", + "protocols": [ + "https" + ], + "authenticationSettings": { + "openid": { + "openidProviderId": "testopenid", + "bearerTokenSendingMethods": [ + "authorizationHeader" + ] + } + }, + "subscriptionKeyParameterNames": { + "header": "Ocp-Apim-Subscription-Key", + "query": "subscription-key" + }, + "isCurrent": true + } + } + } + } +} \ No newline at end of file diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-06-01-preview/apimapis.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-06-01-preview/apimapis.json index a82ad9455ebe..89326eeb3b1f 100644 --- a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-06-01-preview/apimapis.json +++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-06-01-preview/apimapis.json @@ -233,6 +233,9 @@ }, "ApiManagementCreateApiRevision": { "$ref": "./examples/ApiManagementCreateApiRevision.json" + }, + "ApiManagementCreateApiWithOpenIdConnect": { + "$ref": "./examples/ApiManagementCreateApiWithOpenIdConnect.json" } }, "consumes": [ @@ -3528,7 +3531,7 @@ { "value": "soap", "description": "Imports the Soap API having a SOAP front end.", - "name": "SoapPassThrough" + "name": "SoapPassThrough" } ] } @@ -3896,6 +3899,14 @@ "oAuth2": { "$ref": "#/definitions/OAuth2AuthenticationSettingsContract", "description": "OAuth2 Authentication settings" + }, + "openid": { + "$ref": "#/definitions/OpenIdAuthenticationSettingsContract", + "description": "OpenID Connect Authentication Settings" + }, + "subscriptionKeyRequired": { + "type": "boolean", + "description": "Specifies whether subscription key is required during call to this API, true - API is included into closed products only, false - API is included into open products alone, null - there is a mix of products." } }, "description": "API Authentication Settings." @@ -3913,6 +3924,44 @@ }, "description": "API OAuth2 Authentication settings details." }, + "OpenIdAuthenticationSettingsContract": { + "properties": { + "openidProviderId": { + "type": "string", + "description": "OAuth authorization server identifier." + }, + "bearerTokenSendingMethods": { + "description": "How to send token to the server.", + "type": "array", + "items": { + "$ref": "#/definitions/BearerTokenSendingMethodsContract" + } + } + }, + "description": "API OAuth2 Authentication settings details." + }, + "BearerTokenSendingMethodsContract": { + "type": "string", + "description": "Form of an authorization grant, which the client uses to request the access token.", + "enum": [ + "authorizationHeader", + "query" + ], + "x-ms-enum": { + "modelAsString": true, + "name": "bearerTokenSendingMethods", + "values": [ + { + "value": "authorizationHeader", + "description": "Access token will be transmitted in the Authorization header using Bearer schema" + }, + { + "value": "query", + "description": "Access token will be transmitted as query parameters." + } + ] + } + }, "OperationCollection": { "properties": { "value": { @@ -4303,7 +4352,7 @@ "description": "Text describing the issue." }, "createdDate": { - "type":"string", + "type": "string", "format": "date-time", "description": "Date and time when the issue was created." }, @@ -4400,7 +4449,7 @@ "description": "Comment text." }, "createdDate": { - "type":"string", + "type": "string", "format": "date-time", "description": "Date and time when the comment was created." }, @@ -4455,7 +4504,7 @@ "description": "Filename by which the binary data will be saved." }, "contentFormat": { - "type":"string", + "type": "string", "description": "Either 'link' if content is provided via an HTTP link or the MIME type of the Base64-encoded binary data provided in the 'content' property." }, "content": { diff --git a/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-06-01-preview/examples/ApiManagementCreateApiWithOpenIdConnect.json b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-06-01-preview/examples/ApiManagementCreateApiWithOpenIdConnect.json new file mode 100644 index 000000000000..5ac2af2116a4 --- /dev/null +++ b/specification/apimanagement/resource-manager/Microsoft.ApiManagement/preview/2018-06-01-preview/examples/ApiManagementCreateApiWithOpenIdConnect.json @@ -0,0 +1,94 @@ +{ + "parameters": { + "serviceName": "apimService1", + "resourceGroupName": "rg1", + "api-version": "2018-06-01-preview", + "subscriptionId": "subid", + "apiId": "tempgroup", + "parameters": { + "properties": { + "displayName": "Swagger Petstore", + "description": "This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters.", + "serviceUrl": "http://petstore.swagger.io/v2", + "path": "petstore", + "protocols": [ + "https" + ], + "authenticationSettings": { + "openid": { + "openidProviderId": "testopenid", + "bearerTokenSendingMethods": [ + "authorizationHeader" + ] + } + }, + "subscriptionKeyParameterNames": { + "header": "Ocp-Apim-Subscription-Key", + "query": "subscription-key" + } + } + } + }, + "responses": { + "201": { + "body": { + "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/58da4c4ccdae970a08121230", + "type": "Microsoft.ApiManagement/service/apis", + "name": "58da4c4ccdae970a08121230", + "properties": { + "displayName": "Swagger Petstore", + "apiRevision": "1", + "description": "This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters.", + "serviceUrl": "http://petstore.swagger.io/v2", + "path": "petstore", + "protocols": [ + "https" + ], + "authenticationSettings": { + "openid": { + "openidProviderId": "testopenid", + "bearerTokenSendingMethods": [ + "authorizationHeader" + ] + } + }, + "subscriptionKeyParameterNames": { + "header": "Ocp-Apim-Subscription-Key", + "query": "subscription-key" + }, + "isCurrent": true + } + } + }, + "200": { + "body": { + "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/58da4c4ccdae970a08121230", + "type": "Microsoft.ApiManagement/service/apis", + "name": "58da4c4ccdae970a08121230", + "properties": { + "displayName": "Swagger Petstore", + "apiRevision": "1", + "description": "This is a sample server Petstore server. You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/). For this sample, you can use the api key `special-key` to test the authorization filters.", + "serviceUrl": "http://petstore.swagger.io/v2", + "path": "petstore", + "protocols": [ + "https" + ], + "authenticationSettings": { + "openid": { + "openidProviderId": "testopenid", + "bearerTokenSendingMethods": [ + "authorizationHeader" + ] + } + }, + "subscriptionKeyParameterNames": { + "header": "Ocp-Apim-Subscription-Key", + "query": "subscription-key" + }, + "isCurrent": true + } + } + } + } +} \ No newline at end of file diff --git a/specification/apimanagement/resource-manager/readme.go.md b/specification/apimanagement/resource-manager/readme.go.md new file mode 100644 index 000000000000..d569b68cb750 --- /dev/null +++ b/specification/apimanagement/resource-manager/readme.go.md @@ -0,0 +1,66 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: apimanagement + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2018-06-preview + - tag: package-2018-01 + - tag: package-2017-03 + - tag: package-2016-10 + - tag: package-2016-07 +``` + +### Tag: package-2018-06-preview and go + +These settings apply only when `--tag=package-2018-06-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2018-06-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-06-01-preview/$(namespace) +``` + +### Tag: package-2018-01 and go + +These settings apply only when `--tag=package-2018-01 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2018-01' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-01-01/$(namespace) +``` + +### Tag: package-2017-03 and go + +These settings apply only when `--tag=package-2017-03 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-03' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-03-01/$(namespace) +``` + +### Tag: package-2016-10 and go + +These settings apply only when `--tag=package-2016-10 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2016-10' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2016-10-10/$(namespace) +``` + +### Tag: package-2016-07 and go + +These settings apply only when `--tag=package-2016-07 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2016-07' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2016-07-07/$(namespace) +``` \ No newline at end of file diff --git a/specification/apimanagement/resource-manager/readme.md b/specification/apimanagement/resource-manager/readme.md index 57b1649bb26d..9ac8d31299df 100644 --- a/specification/apimanagement/resource-manager/readme.md +++ b/specification/apimanagement/resource-manager/readme.md @@ -202,6 +202,7 @@ This is not used by Autorest itself. swagger-to-sdk: - repo: azure-sdk-for-go - repo: azure-sdk-for-python + - repo: azure-sdk-for-js - repo: azure-sdk-for-node autorest_options: use: "@microsoft.azure/autorest.python@~3.0" @@ -231,71 +232,7 @@ See configuration in [readme.python.md](./readme.python.md) ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: apimanagement - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2018-06-preview - - tag: package-2018-01 - - tag: package-2017-03 - - tag: package-2016-10 - - tag: package-2016-07 -``` - -### Tag: package-2018-06-preview and go - -These settings apply only when `--tag=package-2018-06-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2018-06-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/apimanagement/mgmt/2018-06-01-preview/apimanagement -``` - -### Tag: package-2018-01 and go - -These settings apply only when `--tag=package-2018-01 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2018-01' && $(go) -output-folder: $(go-sdk-folder)/services/preview/apimanagement/mgmt/2018-01-01/apimanagement -``` - -### Tag: package-2017-03 and go - -These settings apply only when `--tag=package-2017-03 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-03' && $(go) -output-folder: $(go-sdk-folder)/services/apimanagement/mgmt/2017-03-01/apimanagement -``` - -### Tag: package-2016-10 and go - -These settings apply only when `--tag=package-2016-10 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2016-10' && $(go) -output-folder: $(go-sdk-folder)/services/apimanagement/mgmt/2016-10-10/apimanagement -``` - -### Tag: package-2016-07 and go - -These settings apply only when `--tag=package-2016-07 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2016-07' && $(go) -output-folder: $(go-sdk-folder)/services/apimanagement/mgmt/2016-07-07/apimanagement -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/apimanagement/resource-manager/readme.typescript.md b/specification/apimanagement/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..eb7303dc7bac --- /dev/null +++ b/specification/apimanagement/resource-manager/readme.typescript.md @@ -0,0 +1,12 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-apimanagement" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-apimanagement" + generate-metadata: true +``` diff --git a/specification/applicationinsights/data-plane/readme.go.md b/specification/applicationinsights/data-plane/readme.go.md new file mode 100644 index 000000000000..618a78d847fa --- /dev/null +++ b/specification/applicationinsights/data-plane/readme.go.md @@ -0,0 +1,39 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: insights + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: v1 +``` + +### Tag: v1 and go + +These settings apply only when `--tag=v1 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'v1' && $(go) +output-folder: $(go-sdk-folder)/services/appinsights/v1/$(namespace) +``` + +``` yaml $(typescript) +typescript: + package-name: azure-applicationinsights-query + package-version: 1.0.0-Preview-1 + output-folder: $(node-sdks-folder)/lib/services/applicationinsightsQuery/lib + generate-metadata: true + azure-arm: true + add-credentials: true +directive: + - from: swagger-document + where: $.definitions.table.properties.rows.items.items + transform: $.type = "object" +``` \ No newline at end of file diff --git a/specification/applicationinsights/data-plane/readme.md b/specification/applicationinsights/data-plane/readme.md index 16eae313e7c3..aa0e29fe91f6 100644 --- a/specification/applicationinsights/data-plane/readme.md +++ b/specification/applicationinsights/data-plane/readme.md @@ -1,5 +1,5 @@ # ApplicationInsights - + > see https://aka.ms/autorest This is the AutoRest configuration file for ApplicationInsightsDataPlane. @@ -7,7 +7,7 @@ This is the AutoRest configuration file for ApplicationInsightsDataPlane. --- -## Getting Started +## Getting Started To build the SDK for ApplicationInsightsDataPlane, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run: > `autorest` @@ -19,7 +19,7 @@ To see additional help and options, run: ## Configuration -### Basic Information +### Basic Information These are the global settings for the ApplicationInsights API. @@ -67,9 +67,12 @@ This is not used by Autorest itself. ``` yaml $(swagger-to-sdk) swagger-to-sdk: - repo: azure-sdk-for-python + - repo: azure-sdk-for-go + - repo: azure-sdk-for-js + - repo: azure-sdk-for-node ``` -## C# +## C# These settings apply only when `--csharp` is specified on the command line. Please also specify `--csharp-sdks-folder=`. @@ -107,46 +110,9 @@ python: output-folder: $(python-sdks-folder)/azure-applicationinsights ``` - ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: insights - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: v1 -``` - -### Tag: v1 and go - -These settings apply only when `--tag=v1 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'v1' && $(go) -output-folder: $(go-sdk-folder)/services/appinsights/v1/insights -``` - -``` yaml $(typescript) -typescript: - package-name: azure-applicationinsights-query - package-version: 1.0.0-Preview-1 - output-folder: $(node-sdks-folder)/lib/services/applicationinsightsQuery/lib - generate-metadata: true - azure-arm: true - add-credentials: true -directive: - - from: swagger-document - where: $.definitions.table.properties.rows.items.items - transform: $.type = "object" -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/applicationinsights/data-plane/readme.typescript.md b/specification/applicationinsights/data-plane/readme.typescript.md new file mode 100644 index 000000000000..fdc157eca9d2 --- /dev/null +++ b/specification/applicationinsights/data-plane/readme.typescript.md @@ -0,0 +1,14 @@ + +## TypeScriptJS +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +directive: + - reason: Remove Events_GetOdataMetadata from Node SDK due to XML issues. + remove-operation: Events_GetOdataMetadata +typescript: + package-name: "@azure/arm-applicationinsights-query" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-applicationinsights-query" + generate-metadata: true +``` \ No newline at end of file diff --git a/specification/applicationinsights/resource-manager/readme.go.md b/specification/applicationinsights/resource-manager/readme.go.md new file mode 100644 index 000000000000..d3b2a8df018a --- /dev/null +++ b/specification/applicationinsights/resource-manager/readme.go.md @@ -0,0 +1,47 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: insights + clear-output-folder: true +``` + +### Go mult-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2015-05 +``` + +### Tag: package-2015-05 and go + +These settings apply only when `--tag=package-2015-05 --go` is specified on he command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2015-05' && $(go) +output-folder: $(go-sdk-folder)/services/appinsights/mgmt/2015-05-01/$(namespace) +``` + +### Tag: schema-2015-05-preview + +These settings apply only when `--tag=schema-2015-05-01` is specified on the +command line. + +This section contains the input swagger files that are used when generating +resource manager schemas for version 2015-05-01. Note that many of our +pre-existing APIs are note currently compatible with ARM schemas, upon any +updates applied to our services we will bring them up to compliance. + +``` yaml $(tag) == 'schema-2015-05-01' +input-file: + - ./Microsoft.Insights/stable/2015-05-01/aiOperations_API.json + - ./Microsoft.Insights/stable/2015-05-01/components_API.json + - ./Microsoft.Insights/stable/2015-05-01/webTests_API.json + - ./Microsoft.Insights/stable/2015-05-01/workbooks_API.json + +override-info: + title: ApplicationInsightsManagementClient +``` diff --git a/specification/applicationinsights/resource-manager/readme.md b/specification/applicationinsights/resource-manager/readme.md index 45c4fd90e929..8118aaee342a 100644 --- a/specification/applicationinsights/resource-manager/readme.md +++ b/specification/applicationinsights/resource-manager/readme.md @@ -38,7 +38,7 @@ directive: where: - $.paths["/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Insights/components/{resourceName}/purge"].post reason: Original creation of the service did not comply with current ARM schema standards. The team is aware of it and any future updates should rectify the issue. - + - suppress: TrackedResourceListByImmediateParent where: - $.definitions @@ -290,6 +290,7 @@ swagger-to-sdk: - repo: azure-sdk-for-python - repo: azure-sdk-for-java - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node ``` @@ -322,6 +323,9 @@ python: output-folder: $(python-sdks-folder)/azure-mgmt-applicationinsights ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) ## C# @@ -337,53 +341,6 @@ csharp: output-folder: $(csharp-sdks-folder)/ApplicationInsights/Management.ApplicationInsights/Generated clear-output-folder: true ``` -## Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: insights - clear-output-folder: true -``` - -### Go mult-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2015-05 -``` - -### Tag: package-2015-05 and go - -These settings apply only when `--tag=package-2015-05 --go` is specified on he command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2015-05' && $(go) -output-folder: $(go-sdk-folder)/services/appinsights/mgmt/2015-05-01/insights -``` - -### Tag: schema-2015-05-preview - -These settings apply only when `--tag=schema-2015-05-01` is specified on the -command line. - -This section contains the input swagger files that are used when generating -resource manager schemas for version 2015-05-01. Note that many of our -pre-existing APIs are note currently compatible with ARM schemas, upon any -updates applied to our services we will bring them up to compliance. - -``` yaml $(tag) == 'schema-2015-05-01' -input-file: - - ./Microsoft.Insights/stable/2015-05-01/aiOperations_API.json - - ./Microsoft.Insights/stable/2015-05-01/components_API.json - - ./Microsoft.Insights/stable/2015-05-01/webTests_API.json - - ./Microsoft.Insights/stable/2015-05-01/workbooks_API.json - -override-info: - title: ApplicationInsightsManagementClient -``` ## Java diff --git a/specification/applicationinsights/resource-manager/readme.typescript.md b/specification/applicationinsights/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..1d42b39e5a5f --- /dev/null +++ b/specification/applicationinsights/resource-manager/readme.typescript.md @@ -0,0 +1,12 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-appinsights" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-appinsights" + generate-metadata: true +``` diff --git a/specification/authorization/resource-manager/readme.go.md b/specification/authorization/resource-manager/readme.go.md new file mode 100644 index 000000000000..d0461c583f4e --- /dev/null +++ b/specification/authorization/resource-manager/readme.go.md @@ -0,0 +1,56 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: authorization + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2015-07 + - tag: package-2017-10-01-preview + - tag: package-2018-01-01-preview + - tag: package-2018-09-01-preview +``` + +### Tag: package-2015-07 and go + +These settings apply only when `--tag=package-2015-07 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2015-07' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2015-07-01/$(namespace) +``` + +### Tag: package-2017-10-01-preview and go + +These settings apply only when `--tag=package-2017-10-01-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-10-01-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2017-10-01-preview/$(namespace) +``` + +### Tag: package-2018-01-01-preview and go + +These settings apply only when `--tag=package-2018-01-01-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2018-01-01-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-01-01-preview/$(namespace) +``` + +### Tag: package-2018-09-01-preview and go + +These settings apply only when `--tag=package-2018-09-01-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2018-09-01-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-09-01-preview/$(namespace) +``` \ No newline at end of file diff --git a/specification/authorization/resource-manager/readme.md b/specification/authorization/resource-manager/readme.md index 277ce8ac828e..e2eaa8ba206d 100644 --- a/specification/authorization/resource-manager/readme.md +++ b/specification/authorization/resource-manager/readme.md @@ -162,60 +162,7 @@ swagger-to-sdk: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: authorization - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2015-07 - - tag: package-2017-10-01-preview - - tag: package-2018-01-01-preview - - tag: package-2018-09-01-preview -``` - -### Tag: package-2015-07 and go - -These settings apply only when `--tag=package-2015-07 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2015-07' && $(go) -output-folder: $(go-sdk-folder)/services/authorization/mgmt/2015-07-01/authorization -``` - -### Tag: package-2017-10-01-preview and go - -These settings apply only when `--tag=package-2017-10-01-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-10-01-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/authorization/mgmt/2017-10-01-preview/authorization -``` - -### Tag: package-2018-01-01-preview and go - -These settings apply only when `--tag=package-2018-01-01-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2018-01-01-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/authorization/mgmt/2018-01-01-preview/authorization -``` - -### Tag: package-2018-09-01-preview and go - -These settings apply only when `--tag=package-2018-09-01-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2018-09-01-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/authorization/mgmt/2018-09-01-preview/authorization -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/authorization/resource-manager/readme.typescript.md b/specification/authorization/resource-manager/readme.typescript.md index 713cd4549746..f32a2033cfd9 100644 --- a/specification/authorization/resource-manager/readme.typescript.md +++ b/specification/authorization/resource-manager/readme.typescript.md @@ -7,7 +7,7 @@ Please also specify `--typescript-sdks-folder=`. + +``` yaml $(tag) == 'package-2015-10' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2015-10-31/$(namespace) +``` + +### Tag: package-2017-05-preview and go + +These settings apply only when `--tag=package-2017-05-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-05-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2017-05-15-preview/$(namespace) +``` + +### Tag: package-2018-01-preview and go + +These settings apply only when `--tag=package-2018-01-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2018-01-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-01-15-preview/$(namespace) +``` + +### Tag: package-2018-06-preview and go + +These settings apply only when `--tag=package-2018-06-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2018-06-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-06-30-preview/$(namespace) +``` \ No newline at end of file diff --git a/specification/automation/resource-manager/readme.md b/specification/automation/resource-manager/readme.md index c4c3d846a108..e3fe750df431 100644 --- a/specification/automation/resource-manager/readme.md +++ b/specification/automation/resource-manager/readme.md @@ -195,6 +195,7 @@ This is not used by Autorest itself. swagger-to-sdk: - repo: azure-sdk-for-python - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node - repo: azure-sdk-for-ruby after_scripts: @@ -246,60 +247,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: automation - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2015-10 - - tag: package-2017-05-preview - - tag: package-2018-01-preview - - tag: package-2018-06-preview -``` - -### Tag: package-2015-10 and go - -These settings apply only when `--tag=package-2015-10 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2015-10' && $(go) -output-folder: $(go-sdk-folder)/services/automation/mgmt/2015-10-31/automation -``` - -### Tag: package-2017-05-preview and go - -These settings apply only when `--tag=package-2017-05-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-05-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/automation/mgmt/2017-05-15-preview/automation -``` - -### Tag: package-2018-01-preview and go - -These settings apply only when `--tag=package-2018-01-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2018-01-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/automation/mgmt/2018-01-preview/automation -``` - -### Tag: package-2018-06-preview and go - -These settings apply only when `--tag=package-2018-06-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2018-06-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/automation/mgmt/2018-06-preview/automation -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/automation/resource-manager/readme.typescript.md b/specification/automation/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..045e54639f04 --- /dev/null +++ b/specification/automation/resource-manager/readme.typescript.md @@ -0,0 +1,12 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-automation" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-automation" + generate-metadata: true +``` diff --git a/specification/azurestack/resource-manager/readme.go.md b/specification/azurestack/resource-manager/readme.go.md new file mode 100644 index 000000000000..6f8306627a08 --- /dev/null +++ b/specification/azurestack/resource-manager/readme.go.md @@ -0,0 +1,40 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + clear-output-folder: true + namespace: azurestack +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2017-06-01 +``` + +### Tag: package-2017-06-01 and go + +These settings apply only when `--tag=package-2017-06-01 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2017-06-01' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-06-01/$(namespace) +``` + +## Python + +These settings apply only when `--python` is specified on the command line. + +``` yaml $(python) +python: + azure-arm: true + license-header: MICROSOFT_MIT_NO_VERSION + payload-flattening-threshold: 2 + package-name: azure-mgmt-azurestack + no-namespace-folders: true + clear-output-folder: true +``` \ No newline at end of file diff --git a/specification/azurestack/resource-manager/readme.md b/specification/azurestack/resource-manager/readme.md index a22bcb1bf82d..f06d9ffce1c4 100644 --- a/specification/azurestack/resource-manager/readme.md +++ b/specification/azurestack/resource-manager/readme.md @@ -73,6 +73,7 @@ swagger-to-sdk: - repo: azure-sdk-for-python - repo: azure-sdk-for-java - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node ``` @@ -94,44 +95,7 @@ csharp: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - clear-output-folder: true - namespace: azurestack -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2017-06-01 -``` - -### Tag: package-2017-06-01 and go - -These settings apply only when `--tag=package-2017-06-01 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2017-06-01' && $(go) -output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-06-01/$(namespace) -``` - -## Python - -These settings apply only when `--python` is specified on the command line. - -``` yaml $(python) -python: - azure-arm: true - license-header: MICROSOFT_MIT_NO_VERSION - payload-flattening-threshold: 2 - package-name: azure-mgmt-azurestack - no-namespace-folders: true - clear-output-folder: true -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/azurestack/resource-manager/readme.typescript.md b/specification/azurestack/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..17fb1f326796 --- /dev/null +++ b/specification/azurestack/resource-manager/readme.typescript.md @@ -0,0 +1,12 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-azurestack" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-azurestack" + generate-metadata: true +``` diff --git a/specification/batch/data-plane/readme.go.md b/specification/batch/data-plane/readme.go.md new file mode 100644 index 000000000000..8a4fd8de3a49 --- /dev/null +++ b/specification/batch/data-plane/readme.go.md @@ -0,0 +1,100 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + clear-output-folder: true + namespace: batch +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2017-05.5.0 + - tag: package-2018-03.6.1 + - tag: package-2018-08.7.0 +``` + +### Tag: package-2018-08.7.0 and go + +These settings apply only when `--tag=package-2018-08.7.0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2018-08.7.0' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2018-08-01.7.0/$(namespace) +``` + +### Tag: package-2018-03.6.1 and go + +These settings apply only when `--tag=package-2018-03.6.1 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2018-03.6.1' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2018-03-01.6.1/$(namespace) +``` + +### Tag: package-2017-09.6.0 and go + +These settings apply only when `--tag=package-2017-09.6.0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2017-09.6.0' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2017-09-01.6.0/$(namespace) +``` + +### Tag: package-2017-06.5.1 and go + +These settings apply only when `--tag=package-2017-06.5.1 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2017-06.5.1' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2017-06-01.5.1/$(namespace) +``` + +### Tag: package-2017-05.5.0 and go + +These settings apply only when `--tag=package-2017-05.5.0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2017-05.5.0' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2017-05-01.5.0/$(namespace) +``` + +### Tag: package-2017-01.4.0 and go + +These settings apply only when `--tag=package-2017-01.4.0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2017-01.4.0' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2017-01-01.4.0/$(namespace) +``` + +### Tag: package-2016-07.3.1 and go + +These settings apply only when `--tag=package-2016-07.3.1 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2016-07.3.1' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2016-07-01.3.1/$(namespace) +``` + +### Tag: package-2016-02.3.0 and go + +These settings apply only when `--tag=package-2016-02.3.0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2016-02.3.0' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2016-02-01.3.0/$(namespace) +``` + +### Tag: package-2015-12.2.2 and go + +These settings apply only when `--tag=package-2017-05.5.0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2017-05.5.0' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/2015-12-01.2.2/$(namespace) +``` \ No newline at end of file diff --git a/specification/batch/data-plane/readme.md b/specification/batch/data-plane/readme.md index 1f92c5cfa469..d4b574b3817e 100644 --- a/specification/batch/data-plane/readme.md +++ b/specification/batch/data-plane/readme.md @@ -230,6 +230,7 @@ This is not used by Autorest itself. ``` yaml $(swagger-to-sdk) swagger-to-sdk: - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node ``` @@ -276,6 +277,10 @@ python: output-folder: $(python-sdks-folder)/azure-batch ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) + ## Java These settings apply only when `--java` is specified on the command line. @@ -292,108 +297,6 @@ nodejs: clear-output-folder: true ``` -## Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - clear-output-folder: true - namespace: batch -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2017-05.5.0 - - tag: package-2018-03.6.1 - - tag: package-2018-08.7.0 -``` - -### Tag: package-2018-08.7.0 and go - -These settings apply only when `--tag=package-2018-08.7.0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2018-08.7.0' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2018-08-01.7.0/batch -``` - -### Tag: package-2018-03.6.1 and go - -These settings apply only when `--tag=package-2018-03.6.1 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2018-03.6.1' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2018-03-01.6.1/batch -``` - -### Tag: package-2017-09.6.0 and go - -These settings apply only when `--tag=package-2017-09.6.0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2017-09.6.0' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2017-09-01.6.0/batch -``` - -### Tag: package-2017-06.5.1 and go - -These settings apply only when `--tag=package-2017-06.5.1 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2017-06.5.1' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2017-06-01.5.1/batch -``` - -### Tag: package-2017-05.5.0 and go - -These settings apply only when `--tag=package-2017-05.5.0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2017-05.5.0' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2017-05-01.5.0/batch -``` - -### Tag: package-2017-01.4.0 and go - -These settings apply only when `--tag=package-2017-01.4.0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2017-01.4.0' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2017-01-01.4.0/batch -``` - -### Tag: package-2016-07.3.1 and go - -These settings apply only when `--tag=package-2016-07.3.1 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2016-07.3.1' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2016-07-01.3.1/batch -``` - -### Tag: package-2016-02.3.0 and go - -These settings apply only when `--tag=package-2016-02.3.0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2016-02.3.0' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2016-02-01.3.0/batch -``` - -### Tag: package-2015-12.2.2 and go - -These settings apply only when `--tag=package-2017-05.5.0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2017-05.5.0' && $(go) -output-folder: $(go-sdk-folder)/services/batch/2015-12-01.2.2/batch -``` - - ## Java These settings apply only when `--java` is specified on the command line. diff --git a/specification/batch/data-plane/readme.typescript.md b/specification/batch/data-plane/readme.typescript.md new file mode 100644 index 000000000000..1607505b5612 --- /dev/null +++ b/specification/batch/data-plane/readme.typescript.md @@ -0,0 +1,13 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/batch" + output-folder: "$(typescript-sdks-folder)/packages/@azure/batch" + payload-flattening-threshold: 1 + generate-metadata: true +``` \ No newline at end of file diff --git a/specification/batch/resource-manager/readme.go.md b/specification/batch/resource-manager/readme.go.md new file mode 100644 index 000000000000..2e388a22fd8e --- /dev/null +++ b/specification/batch/resource-manager/readme.go.md @@ -0,0 +1,57 @@ + + +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: batch + clear-output-folder: true +``` + +### Go multi-api +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2017-09 + - tag: package-2017-05 + - tag: package-2017-01 + - tag: package-2015-12 +``` + +### Tag: package-2017-09 and go + +These settings apply only when `--tag=package-2017-09 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-09' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-09-01/$(namespace) +``` + +### Tag: package-2017-05 and go + +These settings apply only when `--tag=package-2017-05 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-05' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-05-01/$(namespace) +``` + +### Tag: package-2017-01 and go + +These settings apply only when `--tag=package-2017-01 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-01' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-01-01/$(namespace) +``` + +### Tag: package-2015-12 and go + +These settings apply only when `--tag=package-2015-12 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2015-12' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2015-12-01/$(namespace) +``` diff --git a/specification/batch/resource-manager/readme.md b/specification/batch/resource-manager/readme.md index 2f4df18a329b..4a68131db865 100644 --- a/specification/batch/resource-manager/readme.md +++ b/specification/batch/resource-manager/readme.md @@ -140,6 +140,10 @@ csharp: clear-output-folder: true ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) + ## Python These settings apply only when `--python` is specified on the command line. @@ -167,64 +171,6 @@ python: output-folder: $(python-sdks-folder)/azure-mgmt-batch ``` - -## Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: batch - clear-output-folder: true -``` - -### Go multi-api -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2017-09 - - tag: package-2017-05 - - tag: package-2017-01 - - tag: package-2015-12 -``` - -### Tag: package-2017-09 and go - -These settings apply only when `--tag=package-2017-09 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-09' && $(go) -output-folder: $(go-sdk-folder)/services/batch/mgmt/2017-09-01/batch -``` - -### Tag: package-2017-05 and go - -These settings apply only when `--tag=package-2017-05 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-05' && $(go) -output-folder: $(go-sdk-folder)/services/batch/mgmt/2017-05-01/batch -``` - -### Tag: package-2017-01 and go - -These settings apply only when `--tag=package-2017-01 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-01' && $(go) -output-folder: $(go-sdk-folder)/services/batch/mgmt/2017-01-01/batch -``` - -### Tag: package-2015-12 and go - -These settings apply only when `--tag=package-2015-12 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2015-12' && $(go) -output-folder: $(go-sdk-folder)/services/batch/mgmt/2015-12-01/batch -``` - - ## Java These settings apply only when `--java` is specified on the command line. diff --git a/specification/batch/resource-manager/readme.typescript.md b/specification/batch/resource-manager/readme.typescript.md index 8f5db5653f64..f3c8e77215b2 100644 --- a/specification/batch/resource-manager/readme.typescript.md +++ b/specification/batch/resource-manager/readme.typescript.md @@ -7,7 +7,7 @@ Please also specify `--typescript-sdks-folder=`. + +``` yaml $(tag)=='package-2017-09-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2017-09-01-preview/$(namespace) +``` + +### Tag: package-2018-03 and go + +These settings apply only when `--tag=package-2018-03 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2018-03' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2018-03-01/$(namespace) +``` + +### Tag: package-2018-05 and go + +These settings apply only when `--tag=package-2018-05 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag)=='package-2018-05' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2018-05-01/$(namespace) +``` \ No newline at end of file diff --git a/specification/batchai/resource-manager/readme.md b/specification/batchai/resource-manager/readme.md index 16ddf36b1a0d..d53bac6a8b43 100644 --- a/specification/batchai/resource-manager/readme.md +++ b/specification/batchai/resource-manager/readme.md @@ -69,6 +69,7 @@ swagger-to-sdk: - repo: azure-sdk-for-python - repo: azure-sdk-for-java - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node ``` @@ -117,50 +118,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - clear-output-folder: true - namespace: batchai -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2017-09-preview - - tag: package-2018-03 - - tag: package-2018-05 -``` - -### Tag: package-2017-09-preview and go - -These settings apply only when `--tag=package-2017-09-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2017-09-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/batchai/mgmt/2017-09-preview/batchai -``` - -### Tag: package-2018-03 and go - -These settings apply only when `--tag=package-2018-03 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2018-03' && $(go) -output-folder: $(go-sdk-folder)/services/batchai/mgmt/2018-03-01/batchai -``` - -### Tag: package-2018-05 and go - -These settings apply only when `--tag=package-2018-05 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag)=='package-2018-05' && $(go) -output-folder: $(go-sdk-folder)/services/batchai/mgmt/2018-05-01/batchai -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/batchai/resource-manager/readme.typescript.md b/specification/batchai/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..13ca86de2aa9 --- /dev/null +++ b/specification/batchai/resource-manager/readme.typescript.md @@ -0,0 +1,13 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-batchai" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-batchai" + payload-flattening-threshold: 1 + generate-metadata: true +``` diff --git a/specification/billing/resource-manager/readme.go.md b/specification/billing/resource-manager/readme.go.md new file mode 100644 index 000000000000..de07176c21c7 --- /dev/null +++ b/specification/billing/resource-manager/readme.go.md @@ -0,0 +1,46 @@ + +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: billing + clear-output-folder: true +``` + +### Go multi-api +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2018-03-preview + - tag: package-2017-04-preview + - tag: package-2017-02-preview +``` + +### Tag: package-2018-03-preview and go + +These settings apply only when `--tag=package-2018-03-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2018-03-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2018-03-01-preview/$(namespace) +``` + +### Tag: package-2017-04-preview and go + +These settings apply only when `--tag=package-2017-04-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-04-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2017-04-24-preview/$(namespace) +``` + +### Tag: package-2017-02-preview and go + +These settings apply only when `--tag=package-2017-02-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-02-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2017-02-27-preview/$(namespace) +``` \ No newline at end of file diff --git a/specification/billing/resource-manager/readme.md b/specification/billing/resource-manager/readme.md index 06bd750d35f7..c19596101d82 100644 --- a/specification/billing/resource-manager/readme.md +++ b/specification/billing/resource-manager/readme.md @@ -71,6 +71,7 @@ swagger-to-sdk: - repo: azure-sdk-for-python - repo: azure-sdk-for-java - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node - repo: azure-sdk-for-ruby after_scripts: @@ -92,6 +93,10 @@ csharp: clear-output-folder: true ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) + ## Python These settings apply only when `--python` is specified on the command line. @@ -120,54 +125,6 @@ python: output-folder: $(python-sdks-folder)/azure-mgmt-billing ``` - -## Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: billing - clear-output-folder: true -``` - -### Go multi-api -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2018-03-preview - - tag: package-2017-04-preview - - tag: package-2017-02-preview -``` - -### Tag: package-2018-03-preview and go - -These settings apply only when `--tag=package-2018-03-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2018-03-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/billing/mgmt/2018-03-01-preview/billing -``` - -### Tag: package-2017-04-preview and go - -These settings apply only when `--tag=package-2017-04-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-04-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/billing/mgmt/2017-04-24-preview/billing -``` - -### Tag: package-2017-02-preview and go - -These settings apply only when `--tag=package-2017-02-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-02-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/billing/mgmt/2017-02-27-preview/billing -``` - - ## Java These settings apply only when `--java` is specified on the command line. diff --git a/specification/billing/resource-manager/readme.typescript.md b/specification/billing/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..30bd7cb6ff66 --- /dev/null +++ b/specification/billing/resource-manager/readme.typescript.md @@ -0,0 +1,13 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-billing" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-billing" + payload-flattening-threshold: 1 + generate-metadata: true +``` diff --git a/specification/blueprint/resource-manager/readme.md b/specification/blueprint/resource-manager/readme.md index 950bd2c2fda0..e13d9aaf0dfd 100644 --- a/specification/blueprint/resource-manager/readme.md +++ b/specification/blueprint/resource-manager/readme.md @@ -96,6 +96,10 @@ python: output-folder: $(python-sdks-folder)/azure-mgmt-blueprint ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) + ## Java These settings apply only when `--java` is specified on the command line. diff --git a/specification/botservice/resource-manager/readme.md b/specification/botservice/resource-manager/readme.md index 00ca7eeb6255..d9621f5b4be9 100644 --- a/specification/botservice/resource-manager/readme.md +++ b/specification/botservice/resource-manager/readme.md @@ -1,5 +1,5 @@ # BotService - + > see https://aka.ms/autorest This is the AutoRest configuration file for BotService. @@ -41,7 +41,7 @@ regenerate-manager: true generate-interface: true ``` -## Getting Started +## Getting Started To build the SDK for BotService, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run: > `autorest` @@ -55,7 +55,7 @@ To see additional help and options, run: -### Basic Information +### Basic Information These are the global settings for the BotService API. ``` yaml @@ -120,7 +120,7 @@ swagger-to-sdk: - repo: azure-sdk-for-go ``` -## C# +## C# These settings apply only when `--csharp` is specified on the command line. Please also specify `--csharp-sdks-folder=`. @@ -134,6 +134,10 @@ csharp: clear-output-folder: true ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) + ## Python See readme.python.md file. diff --git a/specification/cdn/resource-manager/readme.go.md b/specification/cdn/resource-manager/readme.go.md index 10afebd50bb0..42e00ec3d462 100644 --- a/specification/cdn/resource-manager/readme.go.md +++ b/specification/cdn/resource-manager/readme.go.md @@ -26,7 +26,7 @@ These settings apply only when `--tag=package-2017-10 --go` is specified on the Please also specify `--go-sdk-folder=`. ``` yaml $(tag) == 'package-2017-10' && $(go) -output-folder: $(go-sdk-folder)/services/cdn/mgmt/2017-10-12/cdn +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-10-12/$(namespace) ``` ### Tag: package-2017-04 and go @@ -35,7 +35,7 @@ These settings apply only when `--tag=package-2017-04 --go` is specified on the Please also specify `--go-sdk-folder=`. ``` yaml $(tag) == 'package-2017-04' && $(go) -output-folder: $(go-sdk-folder)/services/cdn/mgmt/2017-04-02/cdn +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-04-02/$(namespace) ``` ### Tag: package-2016-10 and go @@ -44,7 +44,7 @@ These settings apply only when `--tag=package-2016-10 --go` is specified on the Please also specify `--go-sdk-folder=`. ``` yaml $(tag) == 'package-2016-10' && $(go) -output-folder: $(go-sdk-folder)/services/cdn/mgmt/2016-10-02/cdn +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2016-10-02/$(namespace) ``` ### Tag: package-2016-04 and go @@ -53,7 +53,7 @@ These settings apply only when `--tag=package-2016-04 --go` is specified on the Please also specify `--go-sdk-folder=`. ``` yaml $(tag) == 'package-2016-04' && $(go) -output-folder: $(go-sdk-folder)/services/cdn/mgmt/2016-04-02/cdn +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2016-04-02/$(namespace) ``` ### Tag: package-2015-06 and go @@ -62,5 +62,5 @@ These settings apply only when `--tag=package-2015-06 --go` is specified on the Please also specify `--go-sdk-folder=`. ``` yaml $(tag) == 'package-2015-06' && $(go) -output-folder: $(go-sdk-folder)/services/cdn/mgmt/2015-06-01/cdn +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2015-06-01/$(namespace) ``` diff --git a/specification/cdn/resource-manager/readme.md b/specification/cdn/resource-manager/readme.md index 12ec17266500..137ee3956bcb 100644 --- a/specification/cdn/resource-manager/readme.md +++ b/specification/cdn/resource-manager/readme.md @@ -90,6 +90,7 @@ swagger-to-sdk: - repo: azure-sdk-for-java - repo: azure-sdk-for-go - repo: azure-sdk-for-net + - repo: azure-sdk-for-js - repo: azure-sdk-for-node - repo: azure-sdk-for-ruby after_scripts: diff --git a/specification/cdn/resource-manager/readme.typescript.md b/specification/cdn/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..5a3b29431ba2 --- /dev/null +++ b/specification/cdn/resource-manager/readme.typescript.md @@ -0,0 +1,14 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + license-header: MICROSOFT_MIT_NO_VERSION + payload-flattening-threshold: 2 + package-name: "@azure/arm-cdn" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-cdn" + generate-metadata: true +``` diff --git a/specification/cognitiveservices/data-plane/AutoSuggest/readme.go.md b/specification/cognitiveservices/data-plane/AutoSuggest/readme.go.md new file mode 100644 index 000000000000..51191370d554 --- /dev/null +++ b/specification/cognitiveservices/data-plane/AutoSuggest/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: autosuggest + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/AutoSuggest/readme.md b/specification/cognitiveservices/data-plane/AutoSuggest/readme.md index 1febb3331bac..fa68a292805e 100644 --- a/specification/cognitiveservices/data-plane/AutoSuggest/readme.md +++ b/specification/cognitiveservices/data-plane/AutoSuggest/readme.md @@ -82,31 +82,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: autosuggest - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/autosuggest -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/ComputerVision/readme.go.md b/specification/cognitiveservices/data-plane/ComputerVision/readme.go.md new file mode 100644 index 000000000000..1e1b74602e22 --- /dev/null +++ b/specification/cognitiveservices/data-plane/ComputerVision/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: computervision + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_2_0 +``` + +### Tag: release_2_0 and go + +These settings apply only when `--tag=release_2_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_2_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/ComputerVision/readme.md b/specification/cognitiveservices/data-plane/ComputerVision/readme.md index 6a7dc3febccf..f9a000adc2fb 100644 --- a/specification/cognitiveservices/data-plane/ComputerVision/readme.md +++ b/specification/cognitiveservices/data-plane/ComputerVision/readme.md @@ -18,7 +18,9 @@ openapi-type: data-plane These settings apply only when `--tag=release_2_0` is specified on the command line. ``` yaml $(tag) == 'release_2_0' -input-file: stable/v2.0/ComputerVision.json +input-file: + - stable/v2.0/ComputerVision.json + - stable/v2.0/Ocr.json ``` ## Swagger to SDK @@ -92,31 +94,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: computervision - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_2_0 -``` - -### Tag: release_2_0 and go - -These settings apply only when `--tag=release_2_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_2_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.0/computervision -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/ComputerVision.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/ComputerVision.json index 2931089da705..2d01aade02f9 100644 --- a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/ComputerVision.json +++ b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/ComputerVision.json @@ -54,8 +54,8 @@ } }, "x-ms-examples": { - "Successful List Domains request": { - "$ref": "./examples/SuccessfulListDomainModels.json" + "Successful ListModels request": { + "$ref": "./examples/SuccessfulListModels.json" } } } @@ -116,8 +116,8 @@ } }, "x-ms-examples": { - "Successful Analyze with Url request": { - "$ref": "./examples/SuccessfulAnalyzeWithUrl.json" + "Successful AnalyzeImage request": { + "$ref": "./examples/SuccessfulAnalyzeImageWithUrl.json" } } } @@ -178,7 +178,7 @@ } }, "x-ms-examples": { - "Successful Generate Thumbnail request": { + "Successful GenerateThumbnail request": { "$ref": "./examples/SuccessfulGenerateThumbnailWithUrl.json" } } @@ -220,8 +220,8 @@ } }, "x-ms-examples": { - "Successful Ocr request": { - "$ref": "./examples/SuccessfulOcrWithUrl.json" + "Successful RecognizePrintedText request": { + "$ref": "./examples/SuccessfulRecognizePrintedTextWithUrl.json" } } } @@ -267,8 +267,8 @@ } }, "x-ms-examples": { - "Successful Describe request": { - "$ref": "./examples/SuccessfulDescribeWithUrl.json" + "Successful DescribeImage request": { + "$ref": "./examples/SuccessfulDescribeImageWithUrl.json" } } } @@ -306,8 +306,8 @@ } }, "x-ms-examples": { - "Successful Tag request": { - "$ref": "./examples/SuccessfulTagWithUrl.json" + "Successful TagImage request": { + "$ref": "./examples/SuccessfulTagImageWithUrl.json" } } } @@ -352,87 +352,8 @@ } }, "x-ms-examples": { - "Successful Domain Model analysis request": { - "$ref": "./examples/SuccessfulDomainModelWithUrl.json" - } - } - } - }, - "/recognizeText": { - "post": { - "description": "Recognize Text operation. When you use the Recognize Text interface, the response contains a field called 'Operation-Location'. The 'Operation-Location' field contains the URL that you must use for your Get Recognize Text Operation Result operation.", - "operationId": "RecognizeText", - "parameters": [ - { - "$ref": "#/parameters/ImageUrl" - }, - { - "$ref": "#/parameters/TextRecognitionMode" - } - ], - "consumes": [ - "application/json" - ], - "produces": [ - "application/json" - ], - "responses": { - "202": { - "description": "The service has accepted the request and will start processing later. It will return Accepted immediately and include an Operation-Location header. Client side should further query the operation status using the URL specified in this header. The operation ID will expire in 48 hours.", - "headers": { - "Operation-Location": { - "description": "URL to query for status of the operation. The operation ID will expire in 48 hours. ", - "type": "string" - } - } - }, - "default": { - "description": "Error response.", - "schema": { - "$ref": "#/definitions/ComputerVisionError" - } - } - }, - "x-ms-examples": { - "Successful Domain Model analysis request": { - "$ref": "./examples/SuccessfulRecognizeTextWithUrl.json" - } - } - } - }, - "/textOperations/{operationId}": { - "get": { - "description": "This interface is used for getting text operation result. The URL to this interface should be retrieved from 'Operation-Location' field returned from Recognize Text interface.", - "operationId": "GetTextOperationResult", - "parameters": [ - { - "name": "operationId", - "in": "path", - "description": "Id of the text operation returned in the response of the 'Recognize Text'", - "required": true, - "type": "string" - } - ], - "produces": [ - "application/json" - ], - "responses": { - "200": { - "description": "Returns the operation status.", - "schema": { - "$ref": "#/definitions/TextOperationResult" - } - }, - "default": { - "description": "Error response.", - "schema": { - "$ref": "#/definitions/ComputerVisionError" - } - } - }, - "x-ms-examples": { - "Successful Domain Model analysis request": { - "$ref": "./examples/SuccessfulGetTextOperationResult.json" + "Successful AnalyzeImageByDomain request": { + "$ref": "./examples/SuccessfulAnalyzeImageByDomainWithUrl.json" } } } @@ -496,8 +417,8 @@ } }, "x-ms-examples": { - "Successful Analyze with Url request": { - "$ref": "./examples/SuccessfulAnalyzeWithStream.json" + "Successful AnalyzeImage request": { + "$ref": "./examples/SuccessfulAnalyzeImageWithStream.json" } } } @@ -559,7 +480,7 @@ } }, "x-ms-examples": { - "Successful Generate Thumbnail request": { + "Successful GenerateThumbnail request": { "$ref": "./examples/SuccessfulGenerateThumbnailWithStream.json" } } @@ -602,8 +523,8 @@ } }, "x-ms-examples": { - "Successful Ocr request": { - "$ref": "./examples/SuccessfulOcrWithStream.json" + "Successful RecognizePrintedText request": { + "$ref": "./examples/SuccessfulRecognizePrintedTextWithStream.json" } } } @@ -650,8 +571,8 @@ } }, "x-ms-examples": { - "Successful Describe request": { - "$ref": "./examples/SuccessfulDescribeWithStream.json" + "Successful DescribeImage request": { + "$ref": "./examples/SuccessfulDescribeImageWithStream.json" } } } @@ -690,8 +611,8 @@ } }, "x-ms-examples": { - "Successful Tag request": { - "$ref": "./examples/SuccessfulTagWithStream.json" + "Successful TagImage request": { + "$ref": "./examples/SuccessfulTagImageWithStream.json" } } } @@ -737,125 +658,14 @@ } }, "x-ms-examples": { - "Successful Domain Model analysis request": { - "$ref": "./examples/SuccessfulDomainModelWithStream.json" - } - } - } - }, - "/recognizeText?overload=stream": { - "post": { - "description": "Recognize Text operation. When you use the Recognize Text interface, the response contains a field called 'Operation-Location'. The 'Operation-Location' field contains the URL that you must use for your Get Recognize Text Operation Result operation.", - "operationId": "RecognizeTextInStream", - "parameters": [ - { - "$ref": "#/parameters/ImageStream" - }, - { - "$ref": "#/parameters/TextRecognitionMode" - } - ], - "consumes": [ - "application/octet-stream" - ], - "produces": [ - "application/json" - ], - "responses": { - "202": { - "description": "The service has accepted the request and will start processing later.", - "headers": { - "Operation-Location": { - "description": "URL to query for status of the operation. The operation ID will expire in 48 hours. ", - "type": "string" - } - } - }, - "default": { - "description": "Error response.", - "schema": { - "$ref": "#/definitions/ComputerVisionError" - } - } - }, - "x-ms-examples": { - "Successful Domain Model analysis request": { - "$ref": "./examples/SuccessfulRecognizeTextWithStream.json" + "Successful AnalyzeImageByDomain request": { + "$ref": "./examples/SuccessfulAnalyzeImageByDomainWithStream.json" } } } } }, "definitions": { - "TextOperationResult": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Status of the text operation.", - "enum": [ - "Not Started", - "Running", - "Failed", - "Succeeded" - ], - "x-ms-enum": { - "name": "TextOperationStatusCodes", - "modelAsString": false - }, - "x-nullable": false - }, - "recognitionResult": { - "$ref": "#/definitions/RecognitionResult" - } - } - }, - "RecognitionResult": { - "type": "object", - "properties": { - "lines": { - "type": "array", - "items": { - "$ref": "#/definitions/Line" - } - } - } - }, - "Line": { - "type": "object", - "properties": { - "boundingBox": { - "$ref": "#/definitions/BoundingBox" - }, - "text": { - "type": "string" - }, - "words": { - "type": "array", - "items": { - "$ref": "#/definitions/Word" - } - } - } - }, - "Word": { - "type": "object", - "properties": { - "boundingBox": { - "$ref": "#/definitions/BoundingBox" - }, - "text": { - "type": "string" - } - } - }, - "BoundingBox": { - "type": "array", - "items": { - "type": "integer", - "x-nullable": false - } - }, "ImageAnalysis": { "type": "object", "description": "Result of AnalyzeImage operation.", diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/Ocr.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/Ocr.json new file mode 100644 index 000000000000..cec25885d414 --- /dev/null +++ b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/Ocr.json @@ -0,0 +1,331 @@ +{ + "swagger": "2.0", + "info": { + "version": "2.0", + "title": "Computer Vision Client", + "description": "The Computer Vision API provides state-of-the-art algorithms to process images and return information. For example, it can be used to determine if an image contains mature content, or it can be used to find all the faces in an image. It also has other features like estimating dominant and accent colors, categorizing the content of images, and describing an image with complete English sentences. Additionally, it can also intelligently generate images thumbnails for displaying large images effectively." + }, + "securityDefinitions": { + "apim_key": { + "type": "apiKey", + "name": "Ocp-Apim-Subscription-Key", + "in": "header" + } + }, + "security": [ + { + "apim_key": [] + } + ], + "x-ms-parameterized-host": { + "hostTemplate": "{Endpoint}", + "useSchemePrefix": false, + "parameters": [ + { + "$ref": "#/parameters/Endpoint" + } + ] + }, + "host": "westcentralus.api.cognitive.microsoft.com", + "basePath": "/vision/v2.0", + "schemes": [ + "https" + ], + "paths": { + "/recognizeText": { + "post": { + "description": "Recognize Text operation. When you use the Recognize Text interface, the response contains a field called 'Operation-Location'. The 'Operation-Location' field contains the URL that you must use for your Get Recognize Text Operation Result operation.", + "operationId": "RecognizeText", + "parameters": [ + { + "$ref": "#/parameters/ImageUrl" + }, + { + "$ref": "#/parameters/TextRecognitionMode" + } + ], + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "responses": { + "202": { + "description": "The service has accepted the request and will start processing later. It will return Accepted immediately and include an Operation-Location header. Client side should further query the operation status using the URL specified in this header. The operation ID will expire in 48 hours.", + "headers": { + "Operation-Location": { + "description": "URL to query for status of the operation. The operation ID will expire in 48 hours. ", + "type": "string" + } + } + }, + "default": { + "description": "Error response.", + "schema": { + "$ref": "#/definitions/ComputerVisionError" + } + } + }, + "x-ms-examples": { + "Successful Domain Model analysis request": { + "$ref": "./examples/SuccessfulRecognizeTextWithUrl.json" + } + } + } + }, + "/textOperations/{operationId}": { + "get": { + "description": "This interface is used for getting text operation result. The URL to this interface should be retrieved from 'Operation-Location' field returned from Recognize Text interface.", + "operationId": "GetTextOperationResult", + "parameters": [ + { + "name": "operationId", + "in": "path", + "description": "Id of the text operation returned in the response of the 'Recognize Text'", + "required": true, + "type": "string" + } + ], + "produces": [ + "application/json" + ], + "responses": { + "200": { + "description": "Returns the operation status.", + "schema": { + "$ref": "#/definitions/TextOperationResult" + } + }, + "default": { + "description": "Error response.", + "schema": { + "$ref": "#/definitions/ComputerVisionError" + } + } + }, + "x-ms-examples": { + "Successful Domain Model analysis request": { + "$ref": "./examples/SuccessfulGetTextOperationResult.json" + } + } + } + } + }, + "x-ms-paths": { + "/recognizeText?overload=stream": { + "post": { + "description": "Recognize Text operation. When you use the Recognize Text interface, the response contains a field called 'Operation-Location'. The 'Operation-Location' field contains the URL that you must use for your Get Recognize Text Operation Result operation.", + "operationId": "RecognizeTextInStream", + "parameters": [ + { + "$ref": "#/parameters/ImageStream" + }, + { + "$ref": "#/parameters/TextRecognitionMode" + } + ], + "consumes": [ + "application/octet-stream" + ], + "produces": [ + "application/json" + ], + "responses": { + "202": { + "description": "The service has accepted the request and will start processing later.", + "headers": { + "Operation-Location": { + "description": "URL to query for status of the operation. The operation ID will expire in 48 hours. ", + "type": "string" + } + } + }, + "default": { + "description": "Error response.", + "schema": { + "$ref": "#/definitions/ComputerVisionError" + } + } + }, + "x-ms-examples": { + "Successful Domain Model analysis request": { + "$ref": "./examples/SuccessfulRecognizeTextWithStream.json" + } + } + } + } + }, + "definitions": { + "TextOperationResult": { + "type": "object", + "properties": { + "status": { + "type": "string", + "description": "Status of the text operation.", + "enum": [ + "Not Started", + "Running", + "Failed", + "Succeeded" + ], + "x-ms-enum": { + "name": "TextOperationStatusCodes", + "modelAsString": false + }, + "x-nullable": false + }, + "recognitionResult": { + "$ref": "#/definitions/RecognitionResult" + } + } + }, + "RecognitionResult": { + "type": "object", + "properties": { + "lines": { + "type": "array", + "items": { + "$ref": "#/definitions/Line" + } + } + } + }, + "Line": { + "type": "object", + "properties": { + "boundingBox": { + "$ref": "#/definitions/BoundingBox" + }, + "text": { + "type": "string" + }, + "words": { + "type": "array", + "items": { + "$ref": "#/definitions/Word" + } + } + } + }, + "Word": { + "type": "object", + "properties": { + "boundingBox": { + "$ref": "#/definitions/BoundingBox" + }, + "text": { + "type": "string" + } + } + }, + "BoundingBox": { + "type": "array", + "items": { + "type": "integer", + "x-nullable": false + } + }, + "ComputerVisionError": { + "type": "object", + "required": [ + "code", + "message" + ], + "properties": { + "code": { + "type": "string", + "description": "The error code.", + "enum": [ + "InvalidImageUrl", + "InvalidImageFormat", + "InvalidImageSize", + "NotSupportedVisualFeature", + "NotSupportedImage", + "InvalidDetails", + "NotSupportedLanguage", + "BadArgument", + "FailedToProcess", + "Timeout", + "InternalServerError", + "Unspecified", + "StorageException" + ], + "x-ms-enum": { + "name": "ComputerVisionErrorCodes", + "modelAsString": false + } + }, + "message": { + "type": "string", + "description": "A message explaining the error reported by the service." + }, + "requestId": { + "type": "string", + "description": "A unique request identifier." + } + } + }, + "ImageUrl": { + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "description": "Publicly reachable URL of an image", + "type": "string" + } + } + } + }, + "parameters": { + "TextRecognitionMode": { + "name": "mode", + "in": "query", + "description": "Type of text to recognize.", + "required": true, + "x-ms-parameter-location": "method", + "type": "string", + "x-ms-enum": { + "name": "TextRecognitionMode", + "modelAsString": false + }, + "enum": [ + "Handwritten", + "Printed" + ] + }, + "ImageUrl": { + "name": "ImageUrl", + "in": "body", + "required": true, + "x-ms-parameter-location": "method", + "x-ms-client-flatten": true, + "description": "A JSON document with a URL pointing to the image that is to be analyzed.", + "schema": { + "$ref": "#/definitions/ImageUrl" + } + }, + "ImageStream": { + "name": "Image", + "in": "body", + "required": true, + "x-ms-parameter-location": "method", + "description": "An image stream.", + "schema": { + "type": "object", + "format": "file" + } + }, + "Endpoint": { + "name": "Endpoint", + "description": "Supported Cognitive Services endpoints", + "x-ms-parameter-location": "client", + "required": true, + "type": "string", + "in": "path", + "x-ms-skip-url-encoding": true + } + } +} diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDomainModelWithStream.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeImageByDomainWithStream.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDomainModelWithStream.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeImageByDomainWithStream.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDomainModelWithUrl.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeImageByDomainWithUrl.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDomainModelWithUrl.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeImageByDomainWithUrl.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeWithStream.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeImageWithStream.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeWithStream.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeImageWithStream.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeWithUrl.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeImageWithUrl.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeWithUrl.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulAnalyzeImageWithUrl.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDescribeWithStream.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDescribeImageWithStream.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDescribeWithStream.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDescribeImageWithStream.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDescribeWithUrl.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDescribeImageWithUrl.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDescribeWithUrl.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulDescribeImageWithUrl.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulListDomainModels.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulListModels.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulListDomainModels.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulListModels.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulOcrWithStream.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulRecognizePrintedTextWithStream.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulOcrWithStream.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulRecognizePrintedTextWithStream.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulOcrWithUrl.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulRecognizePrintedTextWithUrl.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulOcrWithUrl.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulRecognizePrintedTextWithUrl.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulTagWithStream.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulTagImageWithStream.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulTagWithStream.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulTagImageWithStream.json diff --git a/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulTagWithUrl.json b/specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulTagImageWithUrl.json similarity index 100% rename from specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulTagWithUrl.json rename to specification/cognitiveservices/data-plane/ComputerVision/stable/v2.0/examples/SuccessfulTagImageWithUrl.json diff --git a/specification/cognitiveservices/data-plane/ContentModerator/readme.go.md b/specification/cognitiveservices/data-plane/ContentModerator/readme.go.md new file mode 100644 index 000000000000..554ae9bbae68 --- /dev/null +++ b/specification/cognitiveservices/data-plane/ContentModerator/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: contentmoderator + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/ContentModerator/readme.md b/specification/cognitiveservices/data-plane/ContentModerator/readme.md index 2d531f01202b..3a88fc613123 100644 --- a/specification/cognitiveservices/data-plane/ContentModerator/readme.md +++ b/specification/cognitiveservices/data-plane/ContentModerator/readme.md @@ -89,31 +89,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: contentmoderator - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/contentmoderator -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/CustomImageSearch/readme.go.md b/specification/cognitiveservices/data-plane/CustomImageSearch/readme.go.md new file mode 100644 index 000000000000..85b113782f7b --- /dev/null +++ b/specification/cognitiveservices/data-plane/CustomImageSearch/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: customimagesearch + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/CustomImageSearch/readme.md b/specification/cognitiveservices/data-plane/CustomImageSearch/readme.md index 0babb830e27c..4f7e162b6a46 100644 --- a/specification/cognitiveservices/data-plane/CustomImageSearch/readme.md +++ b/specification/cognitiveservices/data-plane/CustomImageSearch/readme.md @@ -72,33 +72,6 @@ python: output-folder: $(python-sdks-folder)/azure-cognitiveservices-search-customimagesearch ``` -## Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: customimagesearch - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/customimagesearch -``` - ## Suppressions Suppressing errors due to API design: ``` yaml @@ -107,6 +80,9 @@ directive: reason: _type is a polymorphic discriminator that can't be changed. ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/CustomVision/Prediction/readme.go.md b/specification/cognitiveservices/data-plane/CustomVision/Prediction/readme.go.md new file mode 100644 index 000000000000..f37ddd4038bc --- /dev/null +++ b/specification/cognitiveservices/data-plane/CustomVision/Prediction/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: prediction + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.1/customvision/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/CustomVision/Prediction/readme.md b/specification/cognitiveservices/data-plane/CustomVision/Prediction/readme.md index ba75914f85de..f3e3c623891c 100644 --- a/specification/cognitiveservices/data-plane/CustomVision/Prediction/readme.md +++ b/specification/cognitiveservices/data-plane/CustomVision/Prediction/readme.md @@ -48,8 +48,8 @@ swagger-to-sdk: ## CSharp Settings These settings apply only when `--csharp` is specified on the command line. -``` yaml $(csharp) -csharp: +``` yaml $(csharp) +csharp: sync-methods: all license-header: MICROSOFT_MIT_NO_VERSION azure-arm: false @@ -86,31 +86,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: prediction - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.1/customvision/$(namespace) -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.go.md b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.go.md new file mode 100644 index 000000000000..3ca63efd9bfb --- /dev/null +++ b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.go.md @@ -0,0 +1,36 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: training + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 + - tag: release_2_1 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.2/customvision/$(namespace) +``` + +### Tag: release_2_1 and go + +These settings apply only when `--tag=release_2_1 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_2_1' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.1/customvision/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.md b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.md index 6bd7275f0655..50ef559e634b 100644 --- a/specification/cognitiveservices/data-plane/CustomVision/Training/readme.md +++ b/specification/cognitiveservices/data-plane/CustomVision/Training/readme.md @@ -54,8 +54,8 @@ swagger-to-sdk: ## CSharp Settings These settings apply only when `--csharp` is specified on the command line. -``` yaml $(csharp) -csharp: +``` yaml $(csharp) +csharp: sync-methods: all license-header: MICROSOFT_MIT_NO_VERSION azure-arm: false @@ -93,40 +93,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: training - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 - - tag: release_2_1 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.2/customvision/$(namespace) -``` - -### Tag: release_2_1 and go - -These settings apply only when `--tag=release_2_1 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_2_1' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.1/customvision/$(namespace) -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/CustomWebSearch/readme.go.md b/specification/cognitiveservices/data-plane/CustomWebSearch/readme.go.md new file mode 100644 index 000000000000..98124fcd1a4f --- /dev/null +++ b/specification/cognitiveservices/data-plane/CustomWebSearch/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: customsearch + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/CustomWebSearch/readme.md b/specification/cognitiveservices/data-plane/CustomWebSearch/readme.md index 4de3f40edad3..2c25c9db9c86 100644 --- a/specification/cognitiveservices/data-plane/CustomWebSearch/readme.md +++ b/specification/cognitiveservices/data-plane/CustomWebSearch/readme.md @@ -75,33 +75,6 @@ python: output-folder: $(python-sdks-folder)/azure-cognitiveservices-search-customsearch ``` -## Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: customsearch - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/customsearch -``` - ## Suppressions Suppressing errors due to API design: ``` yaml @@ -110,6 +83,9 @@ directive: reason: _type is a polymorphic discriminator that can't be changed. ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/EntitySearch/readme.go.md b/specification/cognitiveservices/data-plane/EntitySearch/readme.go.md new file mode 100644 index 000000000000..af1d8fc4eddc --- /dev/null +++ b/specification/cognitiveservices/data-plane/EntitySearch/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: entitysearch + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/EntitySearch/readme.md b/specification/cognitiveservices/data-plane/EntitySearch/readme.md index f55dc630ea08..10e231e19d1a 100644 --- a/specification/cognitiveservices/data-plane/EntitySearch/readme.md +++ b/specification/cognitiveservices/data-plane/EntitySearch/readme.md @@ -75,31 +75,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: entitysearch - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/entitysearch -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/Face/readme.go.md b/specification/cognitiveservices/data-plane/Face/readme.go.md new file mode 100644 index 000000000000..a5217486e00b --- /dev/null +++ b/specification/cognitiveservices/data-plane/Face/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: face + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/Face/readme.md b/specification/cognitiveservices/data-plane/Face/readme.md index 5c8ccf20dc8a..043487a1c87b 100644 --- a/specification/cognitiveservices/data-plane/Face/readme.md +++ b/specification/cognitiveservices/data-plane/Face/readme.md @@ -79,31 +79,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: face - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/face -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/ImageSearch/readme.go.md b/specification/cognitiveservices/data-plane/ImageSearch/readme.go.md new file mode 100644 index 000000000000..f05151358d5a --- /dev/null +++ b/specification/cognitiveservices/data-plane/ImageSearch/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: imagesearch + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/ImageSearch/readme.md b/specification/cognitiveservices/data-plane/ImageSearch/readme.md index 9bb44157ef38..aaa0ccc09bcd 100644 --- a/specification/cognitiveservices/data-plane/ImageSearch/readme.md +++ b/specification/cognitiveservices/data-plane/ImageSearch/readme.md @@ -74,33 +74,6 @@ python: output-folder: $(python-sdks-folder)/azure-cognitiveservices-search-imagesearch ``` -## Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: imagesearch - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/imagesearch -``` - ## Suppressions Suppressing errors due to API design: ``` yaml @@ -109,6 +82,9 @@ directive: reason: _type is a polymorphic discriminator that can't be changed. ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/LUIS/Authoring/readme.go.md b/specification/cognitiveservices/data-plane/LUIS/Authoring/readme.go.md new file mode 100644 index 000000000000..1bd6bea985e6 --- /dev/null +++ b/specification/cognitiveservices/data-plane/LUIS/Authoring/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: authoring + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: authoring_2_0 +``` + +### Tag: authoring_2_0 and go + +These settings apply only when `--tag=authoring_2_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'authoring_2_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.0/luis/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/LUIS/Authoring/readme.md b/specification/cognitiveservices/data-plane/LUIS/Authoring/readme.md index ce0e2b543774..bb35d7240112 100644 --- a/specification/cognitiveservices/data-plane/LUIS/Authoring/readme.md +++ b/specification/cognitiveservices/data-plane/LUIS/Authoring/readme.md @@ -77,31 +77,7 @@ csharp: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: authoring - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: authoring_2_0 -``` - -### Tag: authoring_2_0 and go - -These settings apply only when `--tag=authoring_2_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'authoring_2_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.0/luis/$(namespace) -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/LUIS/Runtime/readme.go.md b/specification/cognitiveservices/data-plane/LUIS/Runtime/readme.go.md new file mode 100644 index 000000000000..810dbbba0f0b --- /dev/null +++ b/specification/cognitiveservices/data-plane/LUIS/Runtime/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: runtime + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: runtime_2_0 +``` + +### Tag: runtime_2_0 and go + +These settings apply only when `--tag=runtime_2_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'runtime_2_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.0/luis/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/LUIS/Runtime/readme.md b/specification/cognitiveservices/data-plane/LUIS/Runtime/readme.md index a9389a7cc28e..278d367e5d95 100644 --- a/specification/cognitiveservices/data-plane/LUIS/Runtime/readme.md +++ b/specification/cognitiveservices/data-plane/LUIS/Runtime/readme.md @@ -64,31 +64,7 @@ directive: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: runtime - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: runtime_2_0 -``` - -### Tag: runtime_2_0 and go - -These settings apply only when `--tag=runtime_2_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'runtime_2_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.0/luis/runtime -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/NewsSearch/readme.go.md b/specification/cognitiveservices/data-plane/NewsSearch/readme.go.md new file mode 100644 index 000000000000..16b18ebe45f2 --- /dev/null +++ b/specification/cognitiveservices/data-plane/NewsSearch/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: newssearch + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/NewsSearch/readme.md b/specification/cognitiveservices/data-plane/NewsSearch/readme.md index f67edcdc06c9..9df4ff55d5ad 100644 --- a/specification/cognitiveservices/data-plane/NewsSearch/readme.md +++ b/specification/cognitiveservices/data-plane/NewsSearch/readme.md @@ -85,31 +85,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: newssearch - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/newssearch -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/SpellCheck/readme.go.md b/specification/cognitiveservices/data-plane/SpellCheck/readme.go.md new file mode 100644 index 000000000000..5aa5885a59fe --- /dev/null +++ b/specification/cognitiveservices/data-plane/SpellCheck/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: spellcheck + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/SpellCheck/readme.md b/specification/cognitiveservices/data-plane/SpellCheck/readme.md index 59dd20fa22af..33db78c23264 100644 --- a/specification/cognitiveservices/data-plane/SpellCheck/readme.md +++ b/specification/cognitiveservices/data-plane/SpellCheck/readme.md @@ -76,31 +76,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: spellcheck - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/spellcheck -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/readme.go.md b/specification/cognitiveservices/data-plane/TextAnalytics/readme.go.md new file mode 100644 index 000000000000..d7f271eeeebe --- /dev/null +++ b/specification/cognitiveservices/data-plane/TextAnalytics/readme.go.md @@ -0,0 +1,36 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: textanalytics + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_2_0 + - tag: release_2_1 +``` + +### Tag: release_2_0 and go + +These settings apply only when `--tag=release_2_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_2_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.0/$(namespace) +``` + +### Tag: release_2_1 and go + +These settings apply only when `--tag=release_2_1 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_2_1' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.1/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/TextAnalytics/readme.md b/specification/cognitiveservices/data-plane/TextAnalytics/readme.md index 137950e39873..603fec1d97af 100644 --- a/specification/cognitiveservices/data-plane/TextAnalytics/readme.md +++ b/specification/cognitiveservices/data-plane/TextAnalytics/readme.md @@ -201,40 +201,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: textanalytics - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_2_0 - - tag: release_2_1 -``` - -### Tag: release_2_0 and go - -These settings apply only when `--tag=release_2_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_2_1' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.0/textanalytics -``` - -### Tag: release_2_1 and go - -These settings apply only when `--tag=release_2_1 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_2_1' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v2.1/textanalytics -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/VideoSearch/readme.go.md b/specification/cognitiveservices/data-plane/VideoSearch/readme.go.md new file mode 100644 index 000000000000..c61ebf23aa63 --- /dev/null +++ b/specification/cognitiveservices/data-plane/VideoSearch/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: videosearch + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/VideoSearch/readme.md b/specification/cognitiveservices/data-plane/VideoSearch/readme.md index d791055165a0..d4bdd6d4de8a 100644 --- a/specification/cognitiveservices/data-plane/VideoSearch/readme.md +++ b/specification/cognitiveservices/data-plane/VideoSearch/readme.md @@ -76,31 +76,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: videosearch - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/videosearch -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/VisualSearch/readme.go.md b/specification/cognitiveservices/data-plane/VisualSearch/readme.go.md new file mode 100644 index 000000000000..f5241d4cf945 --- /dev/null +++ b/specification/cognitiveservices/data-plane/VisualSearch/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: visualsearch + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/preview/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/VisualSearch/readme.md b/specification/cognitiveservices/data-plane/VisualSearch/readme.md index 85d43b586109..5b0b4d0cb399 100644 --- a/specification/cognitiveservices/data-plane/VisualSearch/readme.md +++ b/specification/cognitiveservices/data-plane/VisualSearch/readme.md @@ -41,8 +41,8 @@ swagger-to-sdk: ## CSharp Settings These settings apply only when `--csharp` is specified on the command line. -``` yaml $(csharp) -csharp: +``` yaml $(csharp) +csharp: namespace: Microsoft.Azure.CognitiveServices.Search.VisualSearch output-folder: $(csharp-sdks-folder)/CognitiveServices/dataPlane/Search/Search/Generated/VisualSearch sync-methods: none @@ -77,30 +77,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: visualsearch - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/preview/cognitiveservices/v1.0/$(namespace) -``` +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/data-plane/WebSearch/readme.go.md b/specification/cognitiveservices/data-plane/WebSearch/readme.go.md new file mode 100644 index 000000000000..f610feae8594 --- /dev/null +++ b/specification/cognitiveservices/data-plane/WebSearch/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: websearch + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: release_1_0 +``` + +### Tag: release_1_0 and go + +These settings apply only when `--tag=release_1_0 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'release_1_0' && $(go) +output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/$(namespace) +``` \ No newline at end of file diff --git a/specification/cognitiveservices/data-plane/WebSearch/readme.md b/specification/cognitiveservices/data-plane/WebSearch/readme.md index ef4b7eb48573..707ed35c0f41 100644 --- a/specification/cognitiveservices/data-plane/WebSearch/readme.md +++ b/specification/cognitiveservices/data-plane/WebSearch/readme.md @@ -77,31 +77,7 @@ python: ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: websearch - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: release_1_0 -``` - -### Tag: release_1_0 and go - -These settings apply only when `--tag=release_1_0 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'release_1_0' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/v1.0/websearch -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/resource-manager/readme.go.md b/specification/cognitiveservices/resource-manager/readme.go.md new file mode 100644 index 000000000000..53b03ae33d05 --- /dev/null +++ b/specification/cognitiveservices/resource-manager/readme.go.md @@ -0,0 +1,36 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: cognitiveservices + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2017-04 + - tag: package-2016-02-preview +``` + +### Tag: package-2017-04 and go + +These settings apply only when `--tag=package-2017-04 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-04' && $(go) +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-04-18/$(namespace) +``` + +### Tag: package-2016-02-preview and go + +These settings apply only when `--tag=package-2016-02-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2016-02-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2016-02-01-preview/$(namespace) +``` diff --git a/specification/cognitiveservices/resource-manager/readme.md b/specification/cognitiveservices/resource-manager/readme.md index e0b15a12effb..b7231ef1800c 100644 --- a/specification/cognitiveservices/resource-manager/readme.md +++ b/specification/cognitiveservices/resource-manager/readme.md @@ -64,6 +64,7 @@ swagger-to-sdk: - repo: azure-sdk-for-python - repo: azure-sdk-for-java - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node - repo: azure-sdk-for-ruby after_scripts: @@ -85,44 +86,9 @@ csharp: clear-output-folder: true ``` - ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: cognitiveservices - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2017-04 - - tag: package-2016-02-preview -``` - -### Tag: package-2017-04 and go - -These settings apply only when `--tag=package-2017-04 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-04' && $(go) -output-folder: $(go-sdk-folder)/services/cognitiveservices/mgmt/2017-04-18/cognitiveservices -``` - -### Tag: package-2016-02-preview and go - -These settings apply only when `--tag=package-2016-02-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2016-02-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/cognitiveservices/preview/mgmt/2016-02-01-preview/cognitiveservices -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/cognitiveservices/resource-manager/readme.typescript.md b/specification/cognitiveservices/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..758b157510ce --- /dev/null +++ b/specification/cognitiveservices/resource-manager/readme.typescript.md @@ -0,0 +1,12 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-cognitiveservices" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-cognitiveservices" + generate-metadata: true +``` diff --git a/specification/commerce/resource-manager/readme.go.md b/specification/commerce/resource-manager/readme.go.md new file mode 100644 index 000000000000..b3764e08ef61 --- /dev/null +++ b/specification/commerce/resource-manager/readme.go.md @@ -0,0 +1,26 @@ +## Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: commerce + clear-output-folder: true +``` + +### Go multi-api + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-2015-06-preview +``` + +### Tag: package-2015-06-preview and go + +These settings apply only when `--tag=package-2015-06-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2015-06-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2015-06-01-preview/$(namespace) +``` \ No newline at end of file diff --git a/specification/commerce/resource-manager/readme.md b/specification/commerce/resource-manager/readme.md index b007fe0c7294..bec772b597ed 100644 --- a/specification/commerce/resource-manager/readme.md +++ b/specification/commerce/resource-manager/readme.md @@ -53,6 +53,7 @@ swagger-to-sdk: - repo: azure-sdk-for-python - repo: azure-sdk-for-java - repo: azure-sdk-for-go + - repo: azure-sdk-for-js - repo: azure-sdk-for-node - repo: azure-sdk-for-ruby after_scripts: @@ -87,34 +88,9 @@ python: output-folder: $(python-sdks-folder)/azure-mgmt-commerce ``` - ## Go -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: commerce - clear-output-folder: true -``` - -### Go multi-api - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-2015-06-preview -``` - -### Tag: package-2015-06-preview and go - -These settings apply only when `--tag=package-2015-06-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2015-06-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/commerce/mgmt/2015-06-01-preview/commerce -``` - +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/commerce/resource-manager/readme.typescript.md b/specification/commerce/resource-manager/readme.typescript.md new file mode 100644 index 000000000000..4cc1ffeef333 --- /dev/null +++ b/specification/commerce/resource-manager/readme.typescript.md @@ -0,0 +1,13 @@ +## TypeScript + +These settings apply only when `--typescript` is specified on the command line. +Please also specify `--typescript-sdks-folder=`. + +``` yaml $(typescript) +typescript: + azure-arm: true + package-name: "@azure/arm-commerce" + output-folder: "$(typescript-sdks-folder)/packages/@azure/arm-commerce" + payload-flattening-threshold: 2 + generate-metadata: true +``` diff --git a/specification/compute/resource-manager/readme.go.md b/specification/compute/resource-manager/readme.go.md index 73d41d3c9232..d23c584373ec 100644 --- a/specification/compute/resource-manager/readme.go.md +++ b/specification/compute/resource-manager/readme.go.md @@ -2,7 +2,7 @@ These settings apply only when `--go` is specified on the command line. -``` yaml $(go) +```yaml $(go) go: license-header: MICROSOFT_APACHE_NO_VERSION clear-output-folder: true @@ -10,7 +10,7 @@ go: ### Go multi-api -``` yaml $(go) && $(multiapi) +```yaml $(go) && $(multiapi) batch: - tag: package-2018-10-01 - tag: package-2018-06 @@ -32,9 +32,9 @@ batch: These settings apply only when `--tag=package-2018-10-01 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-2018-10-01' && $(go) +```yaml $(tag)=='package-2018-10-01' && $(go) namespace: compute -output-folder: $(go-sdk-folder)/services/compute/mgmt/2018-10-01/compute +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2018-10-01/$(namespace) ``` ### Tag: package-2018-06 and go @@ -42,9 +42,9 @@ output-folder: $(go-sdk-folder)/services/compute/mgmt/2018-10-01/compute These settings apply only when `--tag=package-2018-06 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-2018-06' && $(go) +```yaml $(tag)=='package-2018-06' && $(go) namespace: compute -output-folder: $(go-sdk-folder)/services/compute/mgmt/2018-06-01/compute +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2018-06-01/$(namespace) ``` ### Tag: package-compute-2018-04 and go @@ -52,9 +52,9 @@ output-folder: $(go-sdk-folder)/services/compute/mgmt/2018-06-01/compute These settings apply only when `--tag=package-compute-2018-04 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-compute-2018-04' && $(go) +```yaml $(tag)=='package-compute-2018-04' && $(go) namespace: compute -output-folder: $(go-sdk-folder)/services/compute/mgmt/2018-04-01/compute +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2018-04-01/$(namespace) ``` ### Tag: package-compute-only-2017-12 and go @@ -62,9 +62,9 @@ output-folder: $(go-sdk-folder)/services/compute/mgmt/2018-04-01/compute These settings apply only when `--tag=package-compute-only-2017-12 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-compute-only-2017-12' && $(go) +```yaml $(tag)=='package-compute-only-2017-12' && $(go) namespace: compute -output-folder: $(go-sdk-folder)/services/compute/mgmt/2017-12-01/compute +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-12-01/$(namespace) ``` ### Tag: package-compute-2017-03 and go @@ -72,9 +72,9 @@ output-folder: $(go-sdk-folder)/services/compute/mgmt/2017-12-01/compute These settings apply only when `--tag=package-compute-2017-03 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-compute-2017-03' && $(go) +```yaml $(tag)=='package-compute-2017-03' && $(go) namespace: compute -output-folder: $(go-sdk-folder)/services/compute/mgmt/2017-03-30/compute +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-03-30/$(namespace) ``` ### Tag: package-compute-2016-04-preview and go @@ -82,9 +82,9 @@ output-folder: $(go-sdk-folder)/services/compute/mgmt/2017-03-30/compute These settings apply only when `--tag=package-compute-2016-04-preview --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-compute-2016-04-preview' && $(go) +```yaml $(tag)=='package-compute-2016-04-preview' && $(go) namespace: compute -output-folder: $(go-sdk-folder)/services/preview/compute/mgmt/2016-04-30-preview/compute +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2016-04-30-preview/$(namespace) ``` ### Tag: package-compute-2016-03 and go @@ -92,9 +92,9 @@ output-folder: $(go-sdk-folder)/services/preview/compute/mgmt/2016-04-30-preview These settings apply only when `--tag=package-compute-2016-03 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-compute-2016-03' && $(go) +```yaml $(tag)=='package-compute-2016-03' && $(go) namespace: compute -output-folder: $(go-sdk-folder)/services/compute/mgmt/2016-03-30/compute +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2016-03-30/$(namespace) ``` ### Tag: package-compute-2015-06 and go @@ -102,9 +102,9 @@ output-folder: $(go-sdk-folder)/services/compute/mgmt/2016-03-30/compute These settings apply only when `--tag=package-compute-2015-06 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-compute-2015-06' && $(go) +```yaml $(tag)=='package-compute-2015-06' && $(go) namespace: compute -output-folder: $(go-sdk-folder)/services/compute/mgmt/2015-06-15/compute +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2015-06-15/$(namespace) ``` ### Tag: package-skus-2017-09 and go @@ -112,9 +112,9 @@ output-folder: $(go-sdk-folder)/services/compute/mgmt/2015-06-15/compute These settings apply only when `--tag=package-skus-2017-09 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-skus-2017-09' && $(go) +```yaml $(tag)=='package-skus-2017-09' && $(go) namespace: skus -output-folder: $(go-sdk-folder)/services/compute/mgmt/2017-09-01/skus +output-folder: $(go-sdk-folder)/services/compute/mgmt/2017-09-01/$(namespace) ``` ### Tag: package-container-service-2017-01 and go @@ -122,9 +122,9 @@ output-folder: $(go-sdk-folder)/services/compute/mgmt/2017-09-01/skus These settings apply only when `--tag=package-container-service-2017-01 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-container-service-2017-01' && $(go) +```yaml $(tag)=='package-container-service-2017-01' && $(go) namespace: containerservice -output-folder: $(go-sdk-folder)/services/containerservice/mgmt/2017-01-31/containerservice +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2017-01-31/$(namespace) ``` ### Tag: package-container-service-2016-09 and go @@ -132,9 +132,9 @@ output-folder: $(go-sdk-folder)/services/containerservice/mgmt/2017-01-31/contai These settings apply only when `--tag=package-container-service-2016-09 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-container-service-2016-09' && $(go) +```yaml $(tag)=='package-container-service-2016-09' && $(go) namespace: containerservice -output-folder: $(go-sdk-folder)/services/containerservice/mgmt/2016-09-30/containerservice +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2016-09-30/$(namespace) ``` ### Tag: package-container-service-2016-03 and go @@ -142,9 +142,9 @@ output-folder: $(go-sdk-folder)/services/containerservice/mgmt/2016-09-30/contai These settings apply only when `--tag=package-container-service-2016-03 --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-container-service-2016-03' && $(go) +```yaml $(tag)=='package-container-service-2016-03' && $(go) namespace: containerservice -output-folder: $(go-sdk-folder)/services/containerservice/mgmt/2016-03-30/containerservice +output-folder: $(go-sdk-folder)/services/$(namespace)/mgmt/2016-03-30/$(namespace) ``` ### Tag: package-container-service-2015-11-preview and go @@ -152,7 +152,7 @@ output-folder: $(go-sdk-folder)/services/containerservice/mgmt/2016-03-30/contai These settings apply only when `--tag=package-container-service-2015-11-preview --go` is specified on the command line. Please also specify `--go-sdk-folder=`. -``` yaml $(tag)=='package-container-service-2015-11-preview' && $(go) +```yaml $(tag)=='package-container-service-2015-11-preview' && $(go) namespace: containerservice -output-folder: $(go-sdk-folder)/services/preview/containerservice/mgmt/2015-11-01-preview/containerservice +output-folder: $(go-sdk-folder)/services/preview/$(namespace)/mgmt/2015-11-01-preview/$(namespace) ``` diff --git a/specification/compute/resource-manager/readme.md b/specification/compute/resource-manager/readme.md index 12591b3719f4..84d30596a34c 100644 --- a/specification/compute/resource-manager/readme.md +++ b/specification/compute/resource-manager/readme.md @@ -487,6 +487,9 @@ swagger-to-sdk: - bundle install && rake arm:regen_all_profiles['azure_mgmt_compute'] ``` +## Go + +See configuration in [readme.go.md](./readme.go.md) ## Java diff --git a/specification/compute/resource-manager/readme.typescript.md b/specification/compute/resource-manager/readme.typescript.md index bdace03dd258..c244018bf218 100644 --- a/specification/compute/resource-manager/readme.typescript.md +++ b/specification/compute/resource-manager/readme.typescript.md @@ -7,6 +7,6 @@ Please also specify `--typescript-sdks-folder=