Skip to content

Latest commit

 

History

History
150 lines (103 loc) · 4.68 KB

readme.md

File metadata and controls

150 lines (103 loc) · 4.68 KB
Raw

CognitiveServices

see https://aka.ms/autorest

This is the AutoRest configuration file for CognitiveServices.

Notice

Microsoft will use data you send to Bing Search Services or the Translator Speech API to improve Microsoft products and services. Where you send personal data to these Cognitive Services, you are responsible for obtaining sufficient consent from the data subjects. The General Privacy and Security Terms in the Online Services Terms do not apply to these Cognitive Services. Please refer to the Microsoft Cognitive Services section in the Online Services Terms for details. Microsoft offers policy controls that may be used to disable new Cognitive Services deployments.

Getting Started

To build the SDK for CognitiveServices, simply Install AutoRest and in this folder, run:

autorest

To see additional help and options, run:

autorest --help

Configuration

Basic Information

These are the global settings for the CognitiveServices API.

openapi-type: arm
tag: package-2017-04

Tag: package-2017-04

These settings apply only when --tag=package-2017-04 is specified on the command line.

input-file:
- Microsoft.CognitiveServices/stable/2017-04-18/cognitiveservices.json

Tag: package-2016-02-preview

These settings apply only when --tag=package-2016-02-preview is specified on the command line.

input-file:
- Microsoft.CognitiveServices/preview/2016-02-01-preview/cognitiveservices.json

Code Generation

Swagger to SDK

This section describes what SDK should be generated by the automatic system. This is not used by Autorest itself.

swagger-to-sdk:
  - repo: azure-sdk-for-net
  - 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:
      - bundle install && rake arm:regen_all_profiles['azure_mgmt_cognitive_services']
  - repo: azure-resource-manager-schemas
    after_scripts:
      - node sdkauto_afterscript.js cognitiveservices/resource-manager

C#

These settings apply only when --csharp is specified on the command line. Please also specify --csharp-sdks-folder=<path to "SDKs" directory of your azure-sdk-for-net clone>.

csharp:
  azure-arm: true
  license-header: MICROSOFT_MIT_NO_VERSION
  namespace: Microsoft.Azure.Management.CognitiveServices
  output-folder: $(csharp-sdks-folder)/cognitiveservices/Microsoft.Azure.Management.CognitiveServices/src/Generated
  clear-output-folder: true

Go

See configuration in readme.go.md

Java

These settings apply only when --java is specified on the command line. Please also specify --azure-libraries-for-java-folder=<path to the root directory of your azure-libraries-for-java clone>.

azure-arm: true
fluent: true
namespace: com.microsoft.azure.management.cognitiveservices
license-header: MICROSOFT_MIT_NO_CODEGEN
payload-flattening-threshold: 1
output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-cognitiveservices

Java multi-api

batch:
  - tag: package-2017-04
  - tag: package-2016-02-preview

Tag: package-2017-04 and java

These settings apply only when --tag=package-2017-04 --java is specified on the command line. Please also specify --azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>.

java:
  namespace: com.microsoft.azure.management.cognitiveservices.v2017_04_18
  output-folder: $(azure-libraries-for-java-folder)/sdk/cognitiveservices/mgmt-v2017_04_18
regenerate-manager: true
generate-interface: true

Tag: package-2016-02-preview and java

These settings apply only when --tag=package-2016-02-preview --java is specified on the command line. Please also specify --azure-libraries-for-java-folder=<path to the root directory of your azure-sdk-for-java clone>.

java:
  namespace: com.microsoft.azure.management.cognitiveservices.v2016_02_01_preview
  output-folder: $(azure-libraries-for-java-folder)/sdk/cognitiveservices/mgmt-v2016_02_01_preview
regenerate-manager: true
generate-interface: true

AzureResourceSchema

See configuration in readme.azureresourceschema.md