diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/InterfaceEndpointProfiles.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/InterfaceEndpointProfiles.json new file mode 100644 index 000000000000..9cb2df6bfe10 --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/InterfaceEndpointProfiles.json @@ -0,0 +1,416 @@ +{ + "swagger": "2.0", + "info": { + "version": "2017-10-01-preview", + "title": "SqlManagementClient", + "description": "The Azure SQL Database management API provides a RESTful set of web APIs that interact with Azure SQL Database services to manage your databases. The API enables users to create, retrieve, update, and delete databases, servers, and other entities." + }, + "host": "management.azure.com", + "schemes": [ + "https" + ], + "consumes": [ + "application/json" + ], + "produces": [ + "application/json" + ], + "paths": { + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/interfaceEndpointProfiles/{interfaceEndpointProfileName}": { + "get": { + "tags": [ + "InterfaceEndpointProfiles" + ], + "description": "Gets a interface endpoint profile.", + "operationId": "InterfaceEndpointProfiles_Get", + "parameters": [ + { + "$ref": "#/parameters/ResourceGroupParameter" + }, + { + "$ref": "#/parameters/ServerNameParameter" + }, + { + "name": "interfaceEndpointProfileName", + "in": "path", + "description": "The name of the interface endpoint profile.", + "required": true, + "type": "string" + }, + { + "$ref": "#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Successfully retrieved a specified interface endpoint profile.", + "schema": { + "$ref": "#/definitions/InterfaceEndpointProfile" + } + }, + "default": { + "description": "*** Error Responses: ***\n\n * 404 SubscriptionDoesNotHaveServer - The requested server was not found\n\n * 404 ResourceNotFound - The requested resource was not found." + } + }, + "x-ms-examples": { + "Gets interface endpoint profiles on server.": { + "$ref": "./examples/InterfaceEndpointProfileGet.json" + } + } + }, + "put": { + "tags": [ + "InterfaceEndpointProfiles" + ], + "description": "Creates or updates a interface endpoint profile.", + "operationId": "InterfaceEndpointProfiles_CreateOrUpdate", + "parameters": [ + { + "$ref": "#/parameters/ResourceGroupParameter" + }, + { + "$ref": "#/parameters/ServerNameParameter" + }, + { + "name": "interfaceEndpointProfileName", + "in": "path", + "required": true, + "type": "string" + }, + { + "name": "parameters", + "in": "body", + "required": true, + "schema": { + "$ref": "#/definitions/InterfaceEndpointProfile" + } + }, + { + "$ref": "#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Successfully updated a interface endpoint profile.", + "schema": { + "$ref": "#/definitions/InterfaceEndpointProfile" + } + }, + "default": { + "description": "*** Error Responses: ***\n\n * 400 InvalidResourceId - Invalid resource identifier.\n\n * 400 MismatchingSubscriptionWithUrl - The provided subscription did not match the subscription in the Url.\n\n * 400 MismatchingResourceGroupNameWithUrl - The provided resource group name did not match the name in the Url.\n\n * 400 MismatchingServerNameWithUrl - The provided server name did not match the name in the Url.\n\n * 400 NullInterfaceEndpointProfileRequest - Interface endpoint Profile Request is Null\n\n * 400 NullInterfaceEndpointProfileRequestParameters - Interface endpoint Profile Request Parameters are Null\n\n * 400 NullVnetNetworkSubnetId - Virtual Network subnet id is Null\n\n * 400 InterfaceEndpointProfileUserErrorBadRequest - Azure SQL Server Interface Endpoint Profile encountered an user error\n\n * 403 InterfaceEndpointProfileResourceAccessDenied - Azure SQL Server Interface Endpoint Profile encountered permission error\n\n * 404 SubscriptionDoesNotHaveServer - The requested server was not found\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 InterfaceEndpointProfileFeatureNotEnabled - Azure SQL Server Interface Endpoint Profiles feature is not enabled\n\n * 404 InterfaceEndpointProfileResourceNotFound - Azure SQL Server Interface Endpoint Profile encountered a resource not found error\n\n * 404 InterfaceEndpointProfileSubscriptionNotFound - Azure SQL Server Interface Endpoint Profiles subscription id not found\n\n * 504 InterfaceEndpointProfileResourceTimedOut - Azure SQL Server Interface Endpoint Profile encountered a timeout" + }, + "202": { + "description": "Accepted" + }, + "201": { + "description": "Successfully created a interface endpoint profile.", + "schema": { + "$ref": "#/definitions/InterfaceEndpointProfile" + } + } + }, + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Creates or updates interface endpoint profile.": { + "$ref": "./examples/InterfaceEndpointProfileCreateOrUpdate.json" + } + } + }, + "delete": { + "tags": [ + "InterfaceEndpointProfiles" + ], + "description": "Deletes the interface endpoint profile with the given name.", + "operationId": "InterfaceEndpointProfiles_Delete", + "parameters": [ + { + "$ref": "#/parameters/ResourceGroupParameter" + }, + { + "$ref": "#/parameters/ServerNameParameter" + }, + { + "name": "interfaceEndpointProfileName", + "in": "path", + "required": true, + "type": "string" + }, + { + "$ref": "#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Successfully deleted the interface endpoint profile." + }, + "default": { + "description": "*** Error Responses: ***\n\n * 404 SubscriptionDoesNotHaveServer - The requested server was not found\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\n\n * 409 OperationCancelled - The operation has been cancelled by user.\n\n * 409 OperationInterrupted - The operation on the resource could not be completed because it was interrupted by another operation on the same resource.\n\n * 500 OperationTimedOut - The operation timed out and automatically rolled back. Please retry the operation." + }, + "202": { + "description": "Accepted" + }, + "204": { + "description": "The specified interface endpoint profile does not exist." + } + }, + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Deletes interface endpoint profile.": { + "$ref": "./examples/InterfaceEndpointProfileDelete.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/interfaceEndpointProfiles": { + "get": { + "tags": [ + "InterfaceEndpointProfiles" + ], + "description": "Gets a list of interface endpoint profiles attached to a server.", + "operationId": "InterfaceEndpointProfiles_ListByServer", + "parameters": [ + { + "$ref": "#/parameters/ResourceGroupParameter" + }, + { + "$ref": "#/parameters/ServerNameParameter" + }, + { + "$ref": "#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Succesfully retrieved the list of interface endpoint profiles.", + "schema": { + "$ref": "#/definitions/InterfaceEndpointProfilesListResult" + } + }, + "default": { + "description": "*** Error Responses: ***\n\n * 404 SubscriptionDoesNotHaveServer - The requested server was not found\n\n * 404 ResourceNotFound - The requested resource was not found." + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "List of interface endpoint profiles on server.": { + "$ref": "./examples/InterfaceEndpointProfileListByServer.json" + } + } + } + } + }, + "definitions": { + "InterfaceEndpointProfileProperties": { + "description": "The properties of a interface endpoint profile.", + "required": [ + "virtualNetworkSubnetId" + ], + "type": "object", + "properties": { + "virtualNetworkSubnetId": { + "description": "The ARM resource id of the virtual network subnet.", + "type": "string" + }, + "privateIp": { + "description": "The Private ip associated with the interface endpoint profile", + "type": "string", + "readOnly": true + }, + "state": { + "description": "State of the interface endpoint profile.", + "enum": [ + "Initializing", + "InProgress", + "Ready", + "Failed", + "Deleting", + "Unknown" + ], + "type": "string", + "readOnly": true, + "x-ms-enum": { + "name": "InterfaceEndpointProfileStateType", + "modelAsString": true + } + } + } + }, + "Resource": { + "description": "ARM resource.", + "type": "object", + "properties": { + "id": { + "description": "Resource ID.", + "type": "string", + "readOnly": true + }, + "name": { + "description": "Resource name.", + "type": "string", + "readOnly": true + }, + "type": { + "description": "Resource type.", + "type": "string", + "readOnly": true + } + }, + "x-ms-azure-resource": true + }, + "ProxyResource": { + "description": "ARM proxy resource.", + "type": "object", + "allOf": [ + { + "$ref": "#/definitions/Resource" + } + ], + "properties": {} + }, + "InterfaceEndpointProfile": { + "description": "A interface endpoint profile resource.", + "type": "object", + "allOf": [ + { + "$ref": "../../../common/v1/types.json#/definitions/ProxyResource" + } + ], + "properties": { + "properties": { + "$ref": "#/definitions/InterfaceEndpointProfileProperties", + "description": "Resource properties.", + "x-ms-client-flatten": true + } + } + }, + "InterfaceEndpointProfilesListResult": { + "description": "A list of interface endpoint profiles.", + "type": "object", + "properties": { + "value": { + "description": "Array of results.", + "type": "array", + "items": { + "$ref": "#/definitions/InterfaceEndpointProfile" + }, + "readOnly": true + }, + "nextLink": { + "description": "Link to retrieve next page of results.", + "type": "string", + "readOnly": true + } + } + } + }, + "parameters": { + "SubscriptionIdParameter": { + "name": "subscriptionId", + "in": "path", + "description": "The subscription ID that identifies an Azure subscription.", + "required": true, + "type": "string", + "x-ms-parameter-location": "client" + }, + "ApiVersionParameter": { + "name": "api-version", + "in": "query", + "description": "The API version to use for the request.", + "required": true, + "type": "string", + "x-ms-parameter-location": "client" + }, + "ResourceGroupParameter": { + "name": "resourceGroupName", + "in": "path", + "description": "The name of the resource group that contains the resource. You can obtain this value from the Azure Resource Manager API or the portal.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method" + }, + "ServerNameParameter": { + "name": "serverName", + "in": "path", + "description": "The name of the server.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method" + }, + "ManagedInstanceNameParameter": { + "name": "managedInstanceName", + "in": "path", + "description": "The name of the managed instance.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method" + }, + "DatabaseNameParameter": { + "name": "databaseName", + "in": "path", + "description": "The name of the database.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method" + }, + "BlobAuditingPolicyNameParameter": { + "name": "blobAuditingPolicyName", + "in": "path", + "description": "The name of the blob auditing policy.", + "required": true, + "type": "string", + "enum": [ + "default" + ], + "x-ms-parameter-location": "method" + }, + "SqlVirtualMachineInstanceNameParameter": { + "name": "sqlVirtualMachineInstanceName", + "in": "path", + "description": "The name of the SqlVirtualMachineInstance.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method" + }, + "SqlVirtualMachineContainerNameParameter": { + "name": "sqlVirtualMachineContainerName", + "in": "path", + "description": "The name of the SqlVirtualMachineContainer.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method" + }, + "VirtualClusterNameParameter": { + "name": "virtualClusterName", + "in": "path", + "description": "The name of the virtual cluster.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method" + } + }, + "securityDefinitions": { + "azure_auth": { + "type": "oauth2", + "description": "Azure Active Directory OAuth2 Flow", + "flow": "implicit", + "authorizationUrl": "https://login.microsoftonline.com/common/oauth2/authorize", + "scopes": { + "user_impersonation": "impersonate your user account" + } + } + } +} \ No newline at end of file diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileCreateOrUpdate.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileCreateOrUpdate.json new file mode 100644 index 000000000000..7f89fcedfa11 --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileCreateOrUpdate.json @@ -0,0 +1,23 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "myresourceGroup", + "serverName": "alphasvr", + "interfaceEndpointProfileName": "ie7", + "api-version": "2017-10-01-preview", + "properties": { + "virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myresourceGroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet77" + } + }, + "responses": { + "200": { + "body": "" + }, + "202": { + "body": "" + }, + "204": { + "body": "" + } + } +} \ No newline at end of file diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileDelete.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileDelete.json new file mode 100644 index 000000000000..8c6072d3438c --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileDelete.json @@ -0,0 +1,20 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "myresourceGroup", + "serverName": "sourcesvr", + "interfaceEndpointProfileName": "myInterfaceEndpointName", + "api-version": "2017-10-01-preview" + }, + "responses": { + "200": { + "body": "" + }, + "202": { + "body": "" + }, + "204": { + "body": "" + } + } +} \ No newline at end of file diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileGet.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileGet.json new file mode 100644 index 000000000000..3d92bf7639d0 --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileGet.json @@ -0,0 +1,23 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "myresourceGroup", + "serverName": "alphasvr", + "interfaceEndpointProfileName": "ie7", + "api-version": "2017-10-01-preview" + }, + "responses": { + "200": { + "body": { + "properties": { + "virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myresourceGroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet77", + "privateIp": "10.20.30.40", + "state": "Ready" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myresourceGroup/providers/Microsoft.Sql/servers/alphasvr/interfaceEndpointProfiles/ie7", + "name": "ie7", + "type": "Microsoft.Sql/servers/interfaceEndpointProfiles" + } + } + } +} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileListByServer.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileListByServer.json new file mode 100644 index 000000000000..38951cdf9c8c --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2017-10-01-preview/examples/InterfaceEndpointProfileListByServer.json @@ -0,0 +1,36 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "myresourceGroup", + "serverName": "alphasvr", + "api-version": "2017-10-01-preview" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myresourceGroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet33", + "privateIp": "18.28.38.48", + "state": "Ready" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myresourceGroup/providers/Microsoft.Sql/servers/alphasvr/interfaceEndpointProfiles/ie44", + "name": "ie44", + "type": "Microsoft.Sql/servers/interfaceEndpointProfiles" + }, + { + "properties": { + "virtualNetworkSubnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myresourceGroup/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet77", + "privateIp": "18.28.38.48", + "state": "Ready" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myresourceGroup/providers/Microsoft.Sql/servers/alphasvr/interfaceEndpointProfiles/ie7", + "name": "ie7", + "type": "Microsoft.Sql/servers/interfaceEndpointProfiles" + } + ] + } + } + } +} \ No newline at end of file diff --git a/specification/sql/resource-manager/readme.md b/specification/sql/resource-manager/readme.md index e264d2fb1d60..0c3ac586d023 100644 --- a/specification/sql/resource-manager/readme.md +++ b/specification/sql/resource-manager/readme.md @@ -1,716 +1,718 @@ -# Sql - -> see https://aka.ms/autorest - -This is the AutoRest configuration file for Sql. - -## Getting Started - -To build the SDK for Sql, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run: - -> `autorest` - -To see additional help and options, run: - -> `autorest --help` - -## Configuration - -### Basic Information - -These are the global settings for the Sql API. - -``` yaml -title: SqlManagementClient -description: The Azure SQL Database management API provides a RESTful set of web services that interact with Azure SQL Database services to manage your databases. The API enables you to create, retrieve, update, and delete databases. -openapi-type: arm -tag: package-composite-v3 -``` - -## Composite packages - -The following packages may be composed from multiple api-versions. - -### Tag: package-composite-v3 - -These settings apply only when `--tag=package-composite-v3` is specified on the command line. - -This section contains the "composite-v3" set of APIs, which is composed from a selection of api-versions that will remain backwards compatible with "v3" clients such as .NET SDK Microsoft.Azure.Management.Sql version 1.14.0-preview. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - - -Differences in v3 (compared to v2): - - Decoupled database and recommended elastic pool APIs - - `-2014-04-01/recommendedElasticPools.json` - - `+2014-04-01/recommendedElasticPoolsDecoupled.json` - - Updated to new Sku-based API for databases and elastic pools - - `-2014-04-01/capabilities.json` - - `-2014-04-01/databases.json` - - `-2014-04-01/elasticPools.json` - - `+2017-10-01-preview/capabilities.json` - - `+2017-10-01-preview/databases.json` - - `+2017-10-01-preview/elasticPools.json` - -``` yaml $(tag) == 'package-composite-v3' -input-file: -- Microsoft.Sql/stable/2014-04-01/backups.json -- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json -- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json -- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json -- Microsoft.Sql/stable/2014-04-01/dataMasking.json -- Microsoft.Sql/stable/2014-04-01/firewallRules.json -- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json -- Microsoft.Sql/stable/2014-04-01/importExport.json -- Microsoft.Sql/stable/2014-04-01/metrics.json -- Microsoft.Sql/stable/2014-04-01/recommendedElasticPoolsDecoupled.json -- Microsoft.Sql/stable/2014-04-01/replicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json -- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json -- Microsoft.Sql/stable/2014-04-01/sql.core.json -- Microsoft.Sql/stable/2014-04-01/usages.json -- Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json -- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json -- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json -- Microsoft.Sql/preview/2015-05-01-preview/operations.json -- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json -- Microsoft.Sql/preview/2015-05-01-preview/servers.json -- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json -- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json -- Microsoft.Sql/preview/2015-05-01-preview/usages.json -- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json -- Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json -- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json -- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json -- Microsoft.Sql/preview/2017-03-01-preview/jobs.json -- Microsoft.Sql/preview/2017-03-01-preview/longTermRetention.json -- Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json -- Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json -- Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json -- Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json -- Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json -- Microsoft.Sql/preview/2017-10-01-preview/cancelOperations.json -- Microsoft.Sql/preview/2017-10-01-preview/cancelPoolOperations.json -- Microsoft.Sql/preview/2017-10-01-preview/capabilities.json -- Microsoft.Sql/preview/2017-10-01-preview/databases.json -- Microsoft.Sql/preview/2017-10-01-preview/elasticPools.json -- Microsoft.Sql/preview/2017-10-01-preview/databaseVulnerabilityAssessmentScans.json -- Microsoft.Sql/preview/2017-10-01-preview/instanceFailoverGroups.json -- Microsoft.Sql/preview/2017-10-01-preview/shortTermRetentionPolicies.json -- Microsoft.Sql/preview/2017-10-01-preview/TdeCertificates.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceTdeCertificates.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceKeys.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceEncryptionProtectors.json - - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -### Tag: package-composite-v2 - -These settings apply only when `--tag=package-composite-v2` is specified on the command line. - -This section contains the "composite-v2" set of APIs, which is composed from a selection of api-versions that will remain backwards compatible with "v2" clients such as .NET SDK Microsoft.Azure.Management.Sql version 1.13.0-preview. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -Differences in v2 (compared to v1): - -- Updated to LTRv2 - - `-201 4-04-01/backupLongTermRetentionPolicies.json` - - `-2014-04-01/backupLongTermRetentionVaults.json` - - `+2017-03-01-preview/longTermRetention.json` - -``` yaml $(tag) == 'package-composite-v2' -input-file: -- Microsoft.Sql/stable/2014-04-01/backups.json -- Microsoft.Sql/stable/2014-04-01/capabilities.json -- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json -- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json -- Microsoft.Sql/stable/2014-04-01/databases.json -- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json -- Microsoft.Sql/stable/2014-04-01/dataMasking.json -- Microsoft.Sql/stable/2014-04-01/elasticPools.json -- Microsoft.Sql/stable/2014-04-01/firewallRules.json -- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json -- Microsoft.Sql/stable/2014-04-01/importExport.json -- Microsoft.Sql/stable/2014-04-01/metrics.json -- Microsoft.Sql/stable/2014-04-01/recommendedElasticPools.json -- Microsoft.Sql/stable/2014-04-01/replicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json -- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json -- Microsoft.Sql/stable/2014-04-01/sql.core.json -- Microsoft.Sql/stable/2014-04-01/usages.json -- Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json -- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json -- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json -- Microsoft.Sql/preview/2015-05-01-preview/operations.json -- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json -- Microsoft.Sql/preview/2015-05-01-preview/servers.json -- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json -- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json -- Microsoft.Sql/preview/2015-05-01-preview/usages.json -- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json -- Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json -- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json -- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json -- Microsoft.Sql/preview/2017-03-01-preview/jobs.json -- Microsoft.Sql/preview/2017-03-01-preview/longTermRetention.json -- Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json -- Microsoft.Sql/preview/2017-03-01-preview/renameDatabase.json -- Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json -- Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json -- Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json -- Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json -- Microsoft.Sql/preview/2017-10-01-preview/cancelOperations.json -- Microsoft.Sql/preview/2017-10-01-preview/cancelPoolOperations.json -- Microsoft.Sql/preview/2017-10-01-preview/databaseVulnerabilityAssessmentScans.json -- Microsoft.Sql/preview/2017-10-01-preview/instanceFailoverGroups.json -- Microsoft.Sql/preview/2017-10-01-preview/shortTermRetentionPolicies.json -- Microsoft.Sql/preview/2017-10-01-preview/TdeCertificates.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceTdeCertificates.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceKeys.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceEncryptionProtectors.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -### Tag: package-composite-v1 - -These settings apply only when `--tag=package-composite-v1` is specified on the command line. - -This section contains the "composite-v1" set of APIs, which is composed from a selection of api-versions that will remain backwards compatible with "v1" clients such as .NET SDK Microsoft.Azure.Management.Sql version 1.12.0-preview and earlier. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -``` yaml $(tag) == 'package-composite-v1' -input-file: -- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionPolicies.json -- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionVaults.json -- Microsoft.Sql/stable/2014-04-01/backups.json -- Microsoft.Sql/stable/2014-04-01/capabilities.json -- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json -- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json -- Microsoft.Sql/stable/2014-04-01/databases.json -- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json -- Microsoft.Sql/stable/2014-04-01/dataMasking.json -- Microsoft.Sql/stable/2014-04-01/elasticPools.json -- Microsoft.Sql/stable/2014-04-01/firewallRules.json -- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json -- Microsoft.Sql/stable/2014-04-01/importExport.json -- Microsoft.Sql/stable/2014-04-01/metrics.json -- Microsoft.Sql/stable/2014-04-01/recommendedElasticPools.json -- Microsoft.Sql/stable/2014-04-01/replicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json -- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json -- Microsoft.Sql/stable/2014-04-01/sql.core.json -- Microsoft.Sql/stable/2014-04-01/usages.json -- Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json -- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json -- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json -- Microsoft.Sql/preview/2015-05-01-preview/operations.json -- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json -- Microsoft.Sql/preview/2015-05-01-preview/servers.json -- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json -- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json -- Microsoft.Sql/preview/2015-05-01-preview/usages.json -- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json -- Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json -- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json -- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json -- Microsoft.Sql/preview/2017-03-01-preview/jobs.json -- Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json -- Microsoft.Sql/preview/2017-03-01-preview/renameDatabase.json -- Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json -- Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json -- Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json -- Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json -- Microsoft.Sql/preview/2017-10-01-preview/cancelOperations.json -- Microsoft.Sql/preview/2017-10-01-preview/cancelPoolOperations.json -- Microsoft.Sql/preview/2017-10-01-preview/databaseVulnerabilityAssessmentScans.json -- Microsoft.Sql/preview/2017-10-01-preview/instanceFailoverGroups.json -- Microsoft.Sql/preview/2017-10-01-preview/shortTermRetentionPolicies.json -- Microsoft.Sql/preview/2017-10-01-preview/TdeCertificates.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceTdeCertificates.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceKeys.json -- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceEncryptionProtectors.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -### Tag: package-2017-03-preview - -These settings apply only when `--tag=package-2017-03-preview` is specified on the command line. - -This section contains the input swagger files that are used when generating client SDKs up to and including api-version 2017-03-01-preview, except databases.json which remains at api-version 2014-04-01 in order to maintain compatibility with clients that have been previously released with this package. To prevent similar confusion moving forward, sections named like `package-20xx-xx(-preview)` will not be used after package-2017-03-preview. Instead, sections named like `package-composite-vx` will be used to compose across api-versions and `package-pure-20xx-xx(-preview)` will be used for single api-versions. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -``` yaml $(tag) == 'package-2017-03-preview' -input-file: -- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionPolicies.json -- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionVaults.json -- Microsoft.Sql/stable/2014-04-01/backups.json -- Microsoft.Sql/stable/2014-04-01/capabilities.json -- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json -- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json -- Microsoft.Sql/stable/2014-04-01/databases.json -- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json -- Microsoft.Sql/stable/2014-04-01/dataMasking.json -- Microsoft.Sql/stable/2014-04-01/elasticPools.json -- Microsoft.Sql/stable/2014-04-01/firewallRules.json -- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json -- Microsoft.Sql/stable/2014-04-01/importExport.json -- Microsoft.Sql/stable/2014-04-01/metrics.json -- Microsoft.Sql/stable/2014-04-01/replicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json -- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json -- Microsoft.Sql/stable/2014-04-01/sql.core.json -- Microsoft.Sql/stable/2014-04-01/usages.json -- Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json -- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json -- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json -- Microsoft.Sql/preview/2015-05-01-preview/operations.json -- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json -- Microsoft.Sql/preview/2015-05-01-preview/servers.json -- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json -- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json -- Microsoft.Sql/preview/2015-05-01-preview/usages.json -- Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json -- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json -- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json -- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json -- Microsoft.Sql/preview/2017-03-01-preview/cancelOperations.json -- Microsoft.Sql/preview/2017-03-01-preview/dataWarehouseUserActivities.json -- Microsoft.Sql/preview/2017-03-01-preview/jobs.json -- Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json -- Microsoft.Sql/preview/2017-03-01-preview/renameDatabase.json -- Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json -- Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json -- Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json -- Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -### Tag: package-2015-05-preview - -These settings apply only when `--tag=package-2015-05-preview` is specified on the command line. - -This section contains the input swagger files that are used when generating client SDKs up to and including api-version 2015-05-01-preview. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -``` yaml $(tag) == 'package-2015-05-preview' -input-file: -- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionPolicies.json -- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionVaults.json -- Microsoft.Sql/stable/2014-04-01/backups.json -- Microsoft.Sql/stable/2014-04-01/restorePoints.json -- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json -- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json -- Microsoft.Sql/stable/2014-04-01/databases.json -- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json -- Microsoft.Sql/stable/2014-04-01/dataMasking.json -- Microsoft.Sql/stable/2014-04-01/elasticPools.json -- Microsoft.Sql/stable/2014-04-01/firewallRules.json -- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json -- Microsoft.Sql/stable/2014-04-01/importExport.json -- Microsoft.Sql/stable/2014-04-01/metrics.json -- Microsoft.Sql/stable/2014-04-01/replicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json -- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json -- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json -- Microsoft.Sql/stable/2014-04-01/sql.core.json -- Microsoft.Sql/stable/2014-04-01/usages.json -- Microsoft.Sql/stable/2015-05-01/capabilities.json -- Microsoft.Sql/preview/2015-05-01-preview/blobAuditing.json -- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json -- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json -- Microsoft.Sql/preview/2015-05-01-preview/operations.json -- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json -- Microsoft.Sql/preview/2015-05-01-preview/servers.json -- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json -- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json -- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json -- Microsoft.Sql/preview/2015-05-01-preview/usages.json -- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -### Tag: package-2014-04 - -These settings apply only when `--tag=package-2014-04` is specified on the command line. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -``` yaml $(tag) == 'package-2014-04' -input-file: -- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json -- Microsoft.Sql/stable/2014-04-01/databases.json -- Microsoft.Sql/stable/2014-04-01/elasticPools.json -- Microsoft.Sql/stable/2014-04-01/firewallRules.json -- Microsoft.Sql/stable/2014-04-01/importExport.json -- Microsoft.Sql/stable/2014-04-01/recommendedElasticPools.json -- Microsoft.Sql/stable/2014-04-01/replicationLinks.json -- Microsoft.Sql/stable/2014-04-01/sql.core.json -- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -## Pure package versions - -The following packages are each composed of all apis from only one api-version. - -### Tag: package-pure-2017-10-preview - -These settings apply only when `--tag=package-pure-2017-10-preview` is specified on the command line. - -This section contains all input swagger files for version 2017-10-01-preview. All APIs of that version must be added this section when the API is ready for production. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -These can be regenerated by running the following PowerShell script from this readme file's folder: `dir .\Microsoft.Sql\preview\2017-10-01-preview\ -File | Resolve-Path -Relative | % { " - $_".Replace("\", "/") }` - -``` yaml $(tag) == 'package-pure-2017-10-preview' -input-file: - - ./Microsoft.Sql/preview/2017-10-01-preview/cancelOperations.json - - ./Microsoft.Sql/preview/2017-10-01-preview/cancelPoolOperations.json - - ./Microsoft.Sql/preview/2017-10-01-preview/databaseVulnerabilityAssessmentScans.json - - ./Microsoft.Sql/preview/2017-10-01-preview/capabilities.json - - ./Microsoft.Sql/preview/2017-10-01-preview/databases.json - - ./Microsoft.Sql/preview/2017-10-01-preview/elasticPools.json - - ./Microsoft.Sql/preview/2017-10-01-preview/instanceFailoverGroups.json - - ./Microsoft.Sql/preview/2017-10-01-preview/shortTermRetentionPolicies.json - - ./Microsoft.Sql/preview/2017-10-01-preview/TdeCertificates.json - - ./Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceTdeCertificates.json - - ./Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceKeys.json - - ./Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceEncryptionProtectors.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -### Tag: package-pure-2017-03-preview - -These settings apply only when `--tag=package-pure-2017-03-preview` is specified on the command line. - -This section contains all input swagger files for version 2017-03-01-preview. All APIs of that version must be added this section when the API is ready for production. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -These can be regenerated by running the following PowerShell script from this readme file's folder: `dir .\Microsoft.Sql\preview\2017-03-01-preview\ -File | Resolve-Path -Relative | % { " - $_".Replace("\", "/") }` - -``` yaml $(tag) == 'package-pure-2017-03-preview' -input-file: - - ./Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json - - ./Microsoft.Sql/preview/2017-03-01-preview/cancelOperations.json - - ./Microsoft.Sql/preview/2017-03-01-preview/databases.json - - ./Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json - - ./Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json - - ./Microsoft.Sql/preview/2017-03-01-preview/dataWarehouseUserActivities.json - - ./Microsoft.Sql/preview/2017-03-01-preview/jobs.json - - ./Microsoft.Sql/preview/2017-03-01-preview/longTermRetention.json - - ./Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json - - ./Microsoft.Sql/preview/2017-03-01-preview/renameDatabase.json - - ./Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json - - ./Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json - - ./Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json - - ./Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -### Tag: package-pure-2015-05-preview - -These settings apply only when `--tag=package-pure-2015-05-preview` is specified on the command line. - -This section contains all input swagger files for version 2015-05-01-preview. All APIs of that version must be added this section when the API is ready for production. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -These can be regenerated by running the following PowerShell script from this readme file's folder: `dir .\Microsoft.Sql\preview\2015-05-01-preview\ -File | Resolve-Path -Relative | % { " - $_".Replace("\", "/") }` - -``` yaml $(tag) == 'package-pure-2015-05-preview' -input-file: - - ./Microsoft.Sql/preview/2015-05-01-preview/advisors.json - - ./Microsoft.Sql/preview/2015-05-01-preview/blobAuditing.json - - ./Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json - - ./Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json - - ./Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json - - ./Microsoft.Sql/preview/2015-05-01-preview/firewallRules.json - - ./Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json - - ./Microsoft.Sql/preview/2015-05-01-preview/operations.json - - ./Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json - - ./Microsoft.Sql/preview/2015-05-01-preview/servers.json - - ./Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json - - ./Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json - - ./Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json - - ./Microsoft.Sql/preview/2015-05-01-preview/usages.json - - ./Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - -### Tag: package-pure-2014-04 - -These settings apply only when `--tag=package-pure-2014-04` is specified on the command line. - -This section contains all input swagger files for version 2014-04-01-preview. All APIs of that version must be added this section when the API is ready for production. - -APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. - -These can be regenerated by running the following PowerShell script from this readme file's folder: `dir .\Microsoft.Sql\stable\2014-04-01\ -File | Resolve-Path -Relative | % { " - $_".Replace("\", "/") }` - -``` yaml $(tag) == 'package-pure-2014-04' -input-file: - - ./Microsoft.Sql/stable/2014-04-01/advisors.json - - ./Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionPolicies.json - - ./Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionVaults.json - - ./Microsoft.Sql/stable/2014-04-01/backups.json - - ./Microsoft.Sql/stable/2014-04-01/capabilities.json - - ./Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json - - ./Microsoft.Sql/stable/2014-04-01/connectionPolicies.json - - ./Microsoft.Sql/stable/2014-04-01/databases.json - - ./Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json - - ./Microsoft.Sql/stable/2014-04-01/dataMasking.json - - ./Microsoft.Sql/stable/2014-04-01/deprecated.json - - ./Microsoft.Sql/stable/2014-04-01/disasterRecoveryConfigurations.json - - ./Microsoft.Sql/stable/2014-04-01/elasticPools.json - - ./Microsoft.Sql/stable/2014-04-01/firewallRules.json - - ./Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json - - ./Microsoft.Sql/stable/2014-04-01/importExport.json - - ./Microsoft.Sql/stable/2014-04-01/metrics.json - - ./Microsoft.Sql/stable/2014-04-01/operations.json - - ./Microsoft.Sql/stable/2014-04-01/queries.json - - ./Microsoft.Sql/stable/2014-04-01/recommendedElasticPools.json - - ./Microsoft.Sql/stable/2014-04-01/replicationLinks.json - - ./Microsoft.Sql/stable/2014-04-01/restorePoints.json - - ./Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json - - ./Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json - - ./Microsoft.Sql/stable/2014-04-01/servers.json - - ./Microsoft.Sql/stable/2014-04-01/serviceObjectives.json - - ./Microsoft.Sql/stable/2014-04-01/sql.core.json - - ./Microsoft.Sql/stable/2014-04-01/tableAuditing.json - - ./Microsoft.Sql/stable/2014-04-01/usages.json - -# Needed when there is more than one input file -override-info: - title: SqlManagementClient -``` - ---- -## Code Generation - -### Swagger to SDK - -This section describes what SDK should be generated by the automatic system. -This is not used by Autorest itself. - -``` yaml $(swagger-to-sdk) -swagger-to-sdk: - - repo: azure-sdk-for-python - - repo: azure-sdk-for-java - - repo: azure-sdk-for-go - - repo: azure-sdk-for-node - - repo: azure-sdk-for-ruby - after_scripts: - - bundle install && rake arm:regen_all_profiles['azure_mgmt_sql'] -``` - -### C# - -These settings apply only when `--csharp` is specified on the command line. -Please also specify `--csharp-sdks-folder=`. - -``` yaml $(csharp) -csharp: - azure-arm: true - license-header: MICROSOFT_MIT_NO_VERSION - namespace: Microsoft.Azure.Management.Sql - output-folder: $(csharp-sdks-folder)/SqlManagement/Management.Sql/Generated - clear-output-folder: true -``` - -### Python - -These settings apply only when `--python` is specified on the command line. -Please also specify `--python-sdks-folder=`. -Use `--python-mode=update` if you already have a setup.py and just want to update the code itself. - -``` yaml $(python) -python-mode: create -python: - azure-arm: true - license-header: MICROSOFT_MIT_NO_VERSION - payload-flattening-threshold: 2 - namespace: azure.mgmt.sql - package-name: azure-mgmt-sql - package-version: 0.9.0 - clear-output-folder: true -``` - -``` yaml $(python) && $(python-mode) == 'update' -python: - no-namespace-folders: true - output-folder: $(python-sdks-folder)/azure-mgmt-sql/azure/mgmt/sql -``` - -``` yaml $(python) && $(python-mode) == 'create' -python: - basic-setup-py: true - output-folder: $(python-sdks-folder)/azure-mgmt-sql -``` - -### Go - -These settings apply only when `--go` is specified on the command line. - -``` yaml $(go) -go: - license-header: MICROSOFT_APACHE_NO_VERSION - namespace: sql - clear-output-folder: true -``` - -#### Go multi-api - -From api-version 2017-10 and onwards, only pure package versions should be used. Composite package versions are used for earlier api-versions (2017-03 and earlier) in order to ensure backwards compatibility with previously released versions of Go SDK, - -``` yaml $(go) && $(multiapi) -batch: - - tag: package-pure-2017-10-preview - - tag: package-2017-03-preview - - tag: package-2015-05-preview - - tag: package-2014-04 -``` - -#### Tag: package-pure-2017-10-preview and go - -These settings apply only when `--tag=package-2017-10-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-pure-2017-10-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/sql/mgmt/2017-10-01-preview/sql -``` - -#### Tag: package-2017-03-preview and go - -These settings apply only when `--tag=package-2017-03-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2017-03-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/sql/mgmt/2017-03-01-preview/sql -``` - -#### Tag: package-2015-05-preview and go - -These settings apply only when `--tag=package-2015-05-preview --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2015-05-preview' && $(go) -output-folder: $(go-sdk-folder)/services/preview/sql/mgmt/2015-05-01-preview/sql -``` - -#### Tag: package-2014-04 and go - -These settings apply only when `--tag=package-2014-04 --go` is specified on the command line. -Please also specify `--go-sdk-folder=`. - -``` yaml $(tag) == 'package-2014-04' && $(go) -output-folder: $(go-sdk-folder)/services/sql/mgmt/2014-04-01/sql -``` - -### 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.sql -license-header: MICROSOFT_MIT_NO_CODEGEN -payload-flattening-threshold: 1 -output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-sql -``` - - -### Java multi-api - -``` yaml $(java) && $(multiapi) -batch: - - tag: package-pure-2017-10-preview - - tag: package-2014-04 -``` - -### Tag: package-pure-2017-10-preview and java - -These settings apply only when `--tag=package-pure-2017-10-preview --java` is specified on the command line. -Please also specify `--azure-libraries-for-java=`. - -``` yaml $(tag) == 'package-pure-2017-10-preview' && $(java) && $(multiapi) -java: - namespace: com.microsoft.azure.management.sql.v2017_10_01_preview - output-folder: $(azure-libraries-for-java-folder)/sql/resource-manager/v2017_10_01_preview -regenerate-manager: true -generate-interface: true -``` - -### Tag: package-2014-04 and java - -These settings apply only when `--tag=package-2014-04 --java` is specified on the command line. -Please also specify `--azure-libraries-for-java=`. - -``` yaml $(tag) == 'package-2014-04' && $(java) && $(multiapi) -java: - namespace: com.microsoft.azure.management.sql.v2014_04_01 - output-folder: $(azure-libraries-for-java-folder)/sql/resource-manager/v2014_04_01 -regenerate-manager: true -generate-interface: true -``` - - -## Validation - -``` yaml -directive: - - suppress: TrackedResourceListByImmediateParent - reason: This warning gives many false positives for proxy resources. - - suppress: GuidUsage - reason: This warning gives many positives for existing APIs that cannot be changed. - - suppress: EnumInsteadOfBoolean - reason: This warning gives many positives for existing APIs that cannot be changed. -``` \ No newline at end of file +# Sql + +> see https://aka.ms/autorest + +This is the AutoRest configuration file for Sql. + +## Getting Started + +To build the SDK for Sql, simply [Install AutoRest](https://aka.ms/autorest/install) and in this folder, run: + +> `autorest` + +To see additional help and options, run: + +> `autorest --help` + +## Configuration + +### Basic Information + +These are the global settings for the Sql API. + +``` yaml +title: SqlManagementClient +description: The Azure SQL Database management API provides a RESTful set of web services that interact with Azure SQL Database services to manage your databases. The API enables you to create, retrieve, update, and delete databases. +openapi-type: arm +tag: package-composite-v3 +``` + +## Composite packages + +The following packages may be composed from multiple api-versions. + +### Tag: package-composite-v3 + +These settings apply only when `--tag=package-composite-v3` is specified on the command line. + +This section contains the "composite-v3" set of APIs, which is composed from a selection of api-versions that will remain backwards compatible with "v3" clients such as .NET SDK Microsoft.Azure.Management.Sql version 1.14.0-preview. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + + +Differences in v3 (compared to v2): + - Decoupled database and recommended elastic pool APIs + - `-2014-04-01/recommendedElasticPools.json` + - `+2014-04-01/recommendedElasticPoolsDecoupled.json` + - Updated to new Sku-based API for databases and elastic pools + - `-2014-04-01/capabilities.json` + - `-2014-04-01/databases.json` + - `-2014-04-01/elasticPools.json` + - `+2017-10-01-preview/capabilities.json` + - `+2017-10-01-preview/databases.json` + - `+2017-10-01-preview/elasticPools.json` + +``` yaml $(tag) == 'package-composite-v3' +input-file: +- Microsoft.Sql/stable/2014-04-01/backups.json +- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json +- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json +- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json +- Microsoft.Sql/stable/2014-04-01/dataMasking.json +- Microsoft.Sql/stable/2014-04-01/firewallRules.json +- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json +- Microsoft.Sql/stable/2014-04-01/importExport.json +- Microsoft.Sql/stable/2014-04-01/metrics.json +- Microsoft.Sql/stable/2014-04-01/recommendedElasticPoolsDecoupled.json +- Microsoft.Sql/stable/2014-04-01/replicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json +- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json +- Microsoft.Sql/stable/2014-04-01/sql.core.json +- Microsoft.Sql/stable/2014-04-01/usages.json +- Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json +- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json +- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json +- Microsoft.Sql/preview/2015-05-01-preview/operations.json +- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json +- Microsoft.Sql/preview/2015-05-01-preview/servers.json +- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json +- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json +- Microsoft.Sql/preview/2015-05-01-preview/usages.json +- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json +- Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json +- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json +- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json +- Microsoft.Sql/preview/2017-03-01-preview/jobs.json +- Microsoft.Sql/preview/2017-03-01-preview/longTermRetention.json +- Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json +- Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json +- Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json +- Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json +- Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json +- Microsoft.Sql/preview/2017-10-01-preview/cancelOperations.json +- Microsoft.Sql/preview/2017-10-01-preview/cancelPoolOperations.json +- Microsoft.Sql/preview/2017-10-01-preview/capabilities.json +- Microsoft.Sql/preview/2017-10-01-preview/databases.json +- Microsoft.Sql/preview/2017-10-01-preview/elasticPools.json +- Microsoft.Sql/preview/2017-10-01-preview/databaseVulnerabilityAssessmentScans.json +- Microsoft.Sql/preview/2017-10-01-preview/instanceFailoverGroups.json +- Microsoft.Sql/preview/2017-10-01-preview/shortTermRetentionPolicies.json +- Microsoft.Sql/preview/2017-10-01-preview/TdeCertificates.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceTdeCertificates.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceKeys.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceEncryptionProtectors.json +- Microsoft.Sql/preview/2017-10-01-preview/InterfaceEndpointProfiles.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +### Tag: package-composite-v2 + +These settings apply only when `--tag=package-composite-v2` is specified on the command line. + +This section contains the "composite-v2" set of APIs, which is composed from a selection of api-versions that will remain backwards compatible with "v2" clients such as .NET SDK Microsoft.Azure.Management.Sql version 1.13.0-preview. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +Differences in v2 (compared to v1): + +- Updated to LTRv2 + - `-201 4-04-01/backupLongTermRetentionPolicies.json` + - `-2014-04-01/backupLongTermRetentionVaults.json` + - `+2017-03-01-preview/longTermRetention.json` + +``` yaml $(tag) == 'package-composite-v2' +input-file: +- Microsoft.Sql/stable/2014-04-01/backups.json +- Microsoft.Sql/stable/2014-04-01/capabilities.json +- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json +- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json +- Microsoft.Sql/stable/2014-04-01/databases.json +- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json +- Microsoft.Sql/stable/2014-04-01/dataMasking.json +- Microsoft.Sql/stable/2014-04-01/elasticPools.json +- Microsoft.Sql/stable/2014-04-01/firewallRules.json +- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json +- Microsoft.Sql/stable/2014-04-01/importExport.json +- Microsoft.Sql/stable/2014-04-01/metrics.json +- Microsoft.Sql/stable/2014-04-01/recommendedElasticPools.json +- Microsoft.Sql/stable/2014-04-01/replicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json +- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json +- Microsoft.Sql/stable/2014-04-01/sql.core.json +- Microsoft.Sql/stable/2014-04-01/usages.json +- Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json +- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json +- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json +- Microsoft.Sql/preview/2015-05-01-preview/operations.json +- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json +- Microsoft.Sql/preview/2015-05-01-preview/servers.json +- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json +- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json +- Microsoft.Sql/preview/2015-05-01-preview/usages.json +- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json +- Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json +- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json +- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json +- Microsoft.Sql/preview/2017-03-01-preview/jobs.json +- Microsoft.Sql/preview/2017-03-01-preview/longTermRetention.json +- Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json +- Microsoft.Sql/preview/2017-03-01-preview/renameDatabase.json +- Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json +- Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json +- Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json +- Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json +- Microsoft.Sql/preview/2017-10-01-preview/cancelOperations.json +- Microsoft.Sql/preview/2017-10-01-preview/cancelPoolOperations.json +- Microsoft.Sql/preview/2017-10-01-preview/databaseVulnerabilityAssessmentScans.json +- Microsoft.Sql/preview/2017-10-01-preview/instanceFailoverGroups.json +- Microsoft.Sql/preview/2017-10-01-preview/shortTermRetentionPolicies.json +- Microsoft.Sql/preview/2017-10-01-preview/TdeCertificates.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceTdeCertificates.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceKeys.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceEncryptionProtectors.json +- Microsoft.Sql/preview/2017-10-01-preview/InterfaceEndpointProfiles.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +### Tag: package-composite-v1 + +These settings apply only when `--tag=package-composite-v1` is specified on the command line. + +This section contains the "composite-v1" set of APIs, which is composed from a selection of api-versions that will remain backwards compatible with "v1" clients such as .NET SDK Microsoft.Azure.Management.Sql version 1.12.0-preview and earlier. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +``` yaml $(tag) == 'package-composite-v1' +input-file: +- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionPolicies.json +- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionVaults.json +- Microsoft.Sql/stable/2014-04-01/backups.json +- Microsoft.Sql/stable/2014-04-01/capabilities.json +- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json +- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json +- Microsoft.Sql/stable/2014-04-01/databases.json +- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json +- Microsoft.Sql/stable/2014-04-01/dataMasking.json +- Microsoft.Sql/stable/2014-04-01/elasticPools.json +- Microsoft.Sql/stable/2014-04-01/firewallRules.json +- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json +- Microsoft.Sql/stable/2014-04-01/importExport.json +- Microsoft.Sql/stable/2014-04-01/metrics.json +- Microsoft.Sql/stable/2014-04-01/recommendedElasticPools.json +- Microsoft.Sql/stable/2014-04-01/replicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json +- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json +- Microsoft.Sql/stable/2014-04-01/sql.core.json +- Microsoft.Sql/stable/2014-04-01/usages.json +- Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json +- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json +- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json +- Microsoft.Sql/preview/2015-05-01-preview/operations.json +- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json +- Microsoft.Sql/preview/2015-05-01-preview/servers.json +- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json +- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json +- Microsoft.Sql/preview/2015-05-01-preview/usages.json +- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json +- Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json +- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json +- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json +- Microsoft.Sql/preview/2017-03-01-preview/jobs.json +- Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json +- Microsoft.Sql/preview/2017-03-01-preview/renameDatabase.json +- Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json +- Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json +- Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json +- Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json +- Microsoft.Sql/preview/2017-10-01-preview/cancelOperations.json +- Microsoft.Sql/preview/2017-10-01-preview/cancelPoolOperations.json +- Microsoft.Sql/preview/2017-10-01-preview/databaseVulnerabilityAssessmentScans.json +- Microsoft.Sql/preview/2017-10-01-preview/instanceFailoverGroups.json +- Microsoft.Sql/preview/2017-10-01-preview/shortTermRetentionPolicies.json +- Microsoft.Sql/preview/2017-10-01-preview/TdeCertificates.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceTdeCertificates.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceKeys.json +- Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceEncryptionProtectors.json +- Microsoft.Sql/preview/2017-10-01-preview/InterfaceEndpointProfiles.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +### Tag: package-2017-03-preview + +These settings apply only when `--tag=package-2017-03-preview` is specified on the command line. + +This section contains the input swagger files that are used when generating client SDKs up to and including api-version 2017-03-01-preview, except databases.json which remains at api-version 2014-04-01 in order to maintain compatibility with clients that have been previously released with this package. To prevent similar confusion moving forward, sections named like `package-20xx-xx(-preview)` will not be used after package-2017-03-preview. Instead, sections named like `package-composite-vx` will be used to compose across api-versions and `package-pure-20xx-xx(-preview)` will be used for single api-versions. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +``` yaml $(tag) == 'package-2017-03-preview' +input-file: +- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionPolicies.json +- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionVaults.json +- Microsoft.Sql/stable/2014-04-01/backups.json +- Microsoft.Sql/stable/2014-04-01/capabilities.json +- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json +- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json +- Microsoft.Sql/stable/2014-04-01/databases.json +- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json +- Microsoft.Sql/stable/2014-04-01/dataMasking.json +- Microsoft.Sql/stable/2014-04-01/elasticPools.json +- Microsoft.Sql/stable/2014-04-01/firewallRules.json +- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json +- Microsoft.Sql/stable/2014-04-01/importExport.json +- Microsoft.Sql/stable/2014-04-01/metrics.json +- Microsoft.Sql/stable/2014-04-01/replicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json +- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json +- Microsoft.Sql/stable/2014-04-01/sql.core.json +- Microsoft.Sql/stable/2014-04-01/usages.json +- Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json +- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json +- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json +- Microsoft.Sql/preview/2015-05-01-preview/operations.json +- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json +- Microsoft.Sql/preview/2015-05-01-preview/servers.json +- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json +- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json +- Microsoft.Sql/preview/2015-05-01-preview/usages.json +- Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json +- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json +- Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json +- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json +- Microsoft.Sql/preview/2017-03-01-preview/cancelOperations.json +- Microsoft.Sql/preview/2017-03-01-preview/dataWarehouseUserActivities.json +- Microsoft.Sql/preview/2017-03-01-preview/jobs.json +- Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json +- Microsoft.Sql/preview/2017-03-01-preview/renameDatabase.json +- Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json +- Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json +- Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json +- Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +### Tag: package-2015-05-preview + +These settings apply only when `--tag=package-2015-05-preview` is specified on the command line. + +This section contains the input swagger files that are used when generating client SDKs up to and including api-version 2015-05-01-preview. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +``` yaml $(tag) == 'package-2015-05-preview' +input-file: +- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionPolicies.json +- Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionVaults.json +- Microsoft.Sql/stable/2014-04-01/backups.json +- Microsoft.Sql/stable/2014-04-01/restorePoints.json +- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json +- Microsoft.Sql/stable/2014-04-01/connectionPolicies.json +- Microsoft.Sql/stable/2014-04-01/databases.json +- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json +- Microsoft.Sql/stable/2014-04-01/dataMasking.json +- Microsoft.Sql/stable/2014-04-01/elasticPools.json +- Microsoft.Sql/stable/2014-04-01/firewallRules.json +- Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json +- Microsoft.Sql/stable/2014-04-01/importExport.json +- Microsoft.Sql/stable/2014-04-01/metrics.json +- Microsoft.Sql/stable/2014-04-01/replicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json +- Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json +- Microsoft.Sql/stable/2014-04-01/serviceObjectives.json +- Microsoft.Sql/stable/2014-04-01/sql.core.json +- Microsoft.Sql/stable/2014-04-01/usages.json +- Microsoft.Sql/stable/2015-05-01/capabilities.json +- Microsoft.Sql/preview/2015-05-01-preview/blobAuditing.json +- Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json +- Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json +- Microsoft.Sql/preview/2015-05-01-preview/operations.json +- Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json +- Microsoft.Sql/preview/2015-05-01-preview/servers.json +- Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json +- Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json +- Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json +- Microsoft.Sql/preview/2015-05-01-preview/usages.json +- Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +### Tag: package-2014-04 + +These settings apply only when `--tag=package-2014-04` is specified on the command line. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +``` yaml $(tag) == 'package-2014-04' +input-file: +- Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json +- Microsoft.Sql/stable/2014-04-01/databases.json +- Microsoft.Sql/stable/2014-04-01/elasticPools.json +- Microsoft.Sql/stable/2014-04-01/firewallRules.json +- Microsoft.Sql/stable/2014-04-01/importExport.json +- Microsoft.Sql/stable/2014-04-01/recommendedElasticPools.json +- Microsoft.Sql/stable/2014-04-01/replicationLinks.json +- Microsoft.Sql/stable/2014-04-01/sql.core.json +- Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +## Pure package versions + +The following packages are each composed of all apis from only one api-version. + +### Tag: package-pure-2017-10-preview + +These settings apply only when `--tag=package-pure-2017-10-preview` is specified on the command line. + +This section contains all input swagger files for version 2017-10-01-preview. All APIs of that version must be added this section when the API is ready for production. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +These can be regenerated by running the following PowerShell script from this readme file's folder: `dir .\Microsoft.Sql\preview\2017-10-01-preview\ -File | Resolve-Path -Relative | % { " - $_".Replace("\", "/") }` + +``` yaml $(tag) == 'package-pure-2017-10-preview' +input-file: + - ./Microsoft.Sql/preview/2017-10-01-preview/cancelOperations.json + - ./Microsoft.Sql/preview/2017-10-01-preview/cancelPoolOperations.json + - ./Microsoft.Sql/preview/2017-10-01-preview/databaseVulnerabilityAssessmentScans.json + - ./Microsoft.Sql/preview/2017-10-01-preview/capabilities.json + - ./Microsoft.Sql/preview/2017-10-01-preview/databases.json + - ./Microsoft.Sql/preview/2017-10-01-preview/elasticPools.json + - ./Microsoft.Sql/preview/2017-10-01-preview/instanceFailoverGroups.json + - ./Microsoft.Sql/preview/2017-10-01-preview/shortTermRetentionPolicies.json + - ./Microsoft.Sql/preview/2017-10-01-preview/TdeCertificates.json + - ./Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceTdeCertificates.json + - ./Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceKeys.json + - ./Microsoft.Sql/preview/2017-10-01-preview/ManagedInstanceEncryptionProtectors.json + - ./Microsoft.Sql/preview/2017-10-01-preview/InterfaceEndpointProfiles.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +### Tag: package-pure-2017-03-preview + +These settings apply only when `--tag=package-pure-2017-03-preview` is specified on the command line. + +This section contains all input swagger files for version 2017-03-01-preview. All APIs of that version must be added this section when the API is ready for production. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +These can be regenerated by running the following PowerShell script from this readme file's folder: `dir .\Microsoft.Sql\preview\2017-03-01-preview\ -File | Resolve-Path -Relative | % { " - $_".Replace("\", "/") }` + +``` yaml $(tag) == 'package-pure-2017-03-preview' +input-file: + - ./Microsoft.Sql/preview/2017-03-01-preview/blobAuditing.json + - ./Microsoft.Sql/preview/2017-03-01-preview/cancelOperations.json + - ./Microsoft.Sql/preview/2017-03-01-preview/databases.json + - ./Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessmentBaselines.json + - ./Microsoft.Sql/preview/2017-03-01-preview/databaseVulnerabilityAssessments.json + - ./Microsoft.Sql/preview/2017-03-01-preview/dataWarehouseUserActivities.json + - ./Microsoft.Sql/preview/2017-03-01-preview/jobs.json + - ./Microsoft.Sql/preview/2017-03-01-preview/longTermRetention.json + - ./Microsoft.Sql/preview/2017-03-01-preview/managedDatabases.json + - ./Microsoft.Sql/preview/2017-03-01-preview/renameDatabase.json + - ./Microsoft.Sql/preview/2017-03-01-preview/restorePoints.json + - ./Microsoft.Sql/preview/2017-03-01-preview/serverAutomaticTuning.json + - ./Microsoft.Sql/preview/2017-03-01-preview/serverDnsAliases.json + - ./Microsoft.Sql/preview/2017-03-01-preview/serverSecurityAlertPolicies.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +### Tag: package-pure-2015-05-preview + +These settings apply only when `--tag=package-pure-2015-05-preview` is specified on the command line. + +This section contains all input swagger files for version 2015-05-01-preview. All APIs of that version must be added this section when the API is ready for production. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +These can be regenerated by running the following PowerShell script from this readme file's folder: `dir .\Microsoft.Sql\preview\2015-05-01-preview\ -File | Resolve-Path -Relative | % { " - $_".Replace("\", "/") }` + +``` yaml $(tag) == 'package-pure-2015-05-preview' +input-file: + - ./Microsoft.Sql/preview/2015-05-01-preview/advisors.json + - ./Microsoft.Sql/preview/2015-05-01-preview/blobAuditing.json + - ./Microsoft.Sql/preview/2015-05-01-preview/databaseAutomaticTuning.json + - ./Microsoft.Sql/preview/2015-05-01-preview/encryptionProtectors.json + - ./Microsoft.Sql/preview/2015-05-01-preview/failoverGroups.json + - ./Microsoft.Sql/preview/2015-05-01-preview/firewallRules.json + - ./Microsoft.Sql/preview/2015-05-01-preview/managedInstances.json + - ./Microsoft.Sql/preview/2015-05-01-preview/operations.json + - ./Microsoft.Sql/preview/2015-05-01-preview/serverKeys.json + - ./Microsoft.Sql/preview/2015-05-01-preview/servers.json + - ./Microsoft.Sql/preview/2015-05-01-preview/syncAgents.json + - ./Microsoft.Sql/preview/2015-05-01-preview/syncGroups.json + - ./Microsoft.Sql/preview/2015-05-01-preview/syncMembers.json + - ./Microsoft.Sql/preview/2015-05-01-preview/usages.json + - ./Microsoft.Sql/preview/2015-05-01-preview/virtualNetworkRules.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +### Tag: package-pure-2014-04 + +These settings apply only when `--tag=package-pure-2014-04` is specified on the command line. + +This section contains all input swagger files for version 2014-04-01-preview. All APIs of that version must be added this section when the API is ready for production. + +APIs must only be added to this section when the API is publicly available in at least 1 production region and at least 1 generated client has been tested end-to-end. + +These can be regenerated by running the following PowerShell script from this readme file's folder: `dir .\Microsoft.Sql\stable\2014-04-01\ -File | Resolve-Path -Relative | % { " - $_".Replace("\", "/") }` + +``` yaml $(tag) == 'package-pure-2014-04' +input-file: + - ./Microsoft.Sql/stable/2014-04-01/advisors.json + - ./Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionPolicies.json + - ./Microsoft.Sql/stable/2014-04-01/backupLongTermRetentionVaults.json + - ./Microsoft.Sql/stable/2014-04-01/backups.json + - ./Microsoft.Sql/stable/2014-04-01/capabilities.json + - ./Microsoft.Sql/stable/2014-04-01/checkNameAvailability.json + - ./Microsoft.Sql/stable/2014-04-01/connectionPolicies.json + - ./Microsoft.Sql/stable/2014-04-01/databases.json + - ./Microsoft.Sql/stable/2014-04-01/databaseSecurityAlertPolicies.json + - ./Microsoft.Sql/stable/2014-04-01/dataMasking.json + - ./Microsoft.Sql/stable/2014-04-01/deprecated.json + - ./Microsoft.Sql/stable/2014-04-01/disasterRecoveryConfigurations.json + - ./Microsoft.Sql/stable/2014-04-01/elasticPools.json + - ./Microsoft.Sql/stable/2014-04-01/firewallRules.json + - ./Microsoft.Sql/stable/2014-04-01/geoBackupPolicies.json + - ./Microsoft.Sql/stable/2014-04-01/importExport.json + - ./Microsoft.Sql/stable/2014-04-01/metrics.json + - ./Microsoft.Sql/stable/2014-04-01/operations.json + - ./Microsoft.Sql/stable/2014-04-01/queries.json + - ./Microsoft.Sql/stable/2014-04-01/recommendedElasticPools.json + - ./Microsoft.Sql/stable/2014-04-01/replicationLinks.json + - ./Microsoft.Sql/stable/2014-04-01/restorePoints.json + - ./Microsoft.Sql/stable/2014-04-01/serverAzureADAdministrators.json + - ./Microsoft.Sql/stable/2014-04-01/serverCommunicationLinks.json + - ./Microsoft.Sql/stable/2014-04-01/servers.json + - ./Microsoft.Sql/stable/2014-04-01/serviceObjectives.json + - ./Microsoft.Sql/stable/2014-04-01/sql.core.json + - ./Microsoft.Sql/stable/2014-04-01/tableAuditing.json + - ./Microsoft.Sql/stable/2014-04-01/usages.json + +# Needed when there is more than one input file +override-info: + title: SqlManagementClient +``` + +--- +## Code Generation + +### Swagger to SDK + +This section describes what SDK should be generated by the automatic system. +This is not used by Autorest itself. + +``` yaml $(swagger-to-sdk) +swagger-to-sdk: + - repo: azure-sdk-for-python + - repo: azure-sdk-for-java + - repo: azure-sdk-for-go + - repo: azure-sdk-for-node + - repo: azure-sdk-for-ruby + after_scripts: + - bundle install && rake arm:regen_all_profiles['azure_mgmt_sql'] +``` + +### C# + +These settings apply only when `--csharp` is specified on the command line. +Please also specify `--csharp-sdks-folder=`. + +``` yaml $(csharp) +csharp: + azure-arm: true + license-header: MICROSOFT_MIT_NO_VERSION + namespace: Microsoft.Azure.Management.Sql + output-folder: $(csharp-sdks-folder)/SqlManagement/Management.Sql/Generated + clear-output-folder: true +``` + +### Python + +These settings apply only when `--python` is specified on the command line. +Please also specify `--python-sdks-folder=`. +Use `--python-mode=update` if you already have a setup.py and just want to update the code itself. + +``` yaml $(python) +python-mode: create +python: + azure-arm: true + license-header: MICROSOFT_MIT_NO_VERSION + payload-flattening-threshold: 2 + namespace: azure.mgmt.sql + package-name: azure-mgmt-sql + package-version: 0.9.0 + clear-output-folder: true +``` + +``` yaml $(python) && $(python-mode) == 'update' +python: + no-namespace-folders: true + output-folder: $(python-sdks-folder)/azure-mgmt-sql/azure/mgmt/sql +``` + +``` yaml $(python) && $(python-mode) == 'create' +python: + basic-setup-py: true + output-folder: $(python-sdks-folder)/azure-mgmt-sql +``` + +### Go + +These settings apply only when `--go` is specified on the command line. + +``` yaml $(go) +go: + license-header: MICROSOFT_APACHE_NO_VERSION + namespace: sql + clear-output-folder: true +``` + +#### Go multi-api + +From api-version 2017-10 and onwards, only pure package versions should be used. Composite package versions are used for earlier api-versions (2017-03 and earlier) in order to ensure backwards compatibility with previously released versions of Go SDK, + +``` yaml $(go) && $(multiapi) +batch: + - tag: package-pure-2017-10-preview + - tag: package-2017-03-preview + - tag: package-2015-05-preview + - tag: package-2014-04 +``` + +#### Tag: package-pure-2017-10-preview and go + +These settings apply only when `--tag=package-2017-10-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-pure-2017-10-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/sql/mgmt/2017-10-01-preview/sql +``` + +#### Tag: package-2017-03-preview and go + +These settings apply only when `--tag=package-2017-03-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2017-03-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/sql/mgmt/2017-03-01-preview/sql +``` + +#### Tag: package-2015-05-preview and go + +These settings apply only when `--tag=package-2015-05-preview --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2015-05-preview' && $(go) +output-folder: $(go-sdk-folder)/services/preview/sql/mgmt/2015-05-01-preview/sql +``` + +#### Tag: package-2014-04 and go + +These settings apply only when `--tag=package-2014-04 --go` is specified on the command line. +Please also specify `--go-sdk-folder=`. + +``` yaml $(tag) == 'package-2014-04' && $(go) +output-folder: $(go-sdk-folder)/services/sql/mgmt/2014-04-01/sql +``` + +### 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.sql +license-header: MICROSOFT_MIT_NO_CODEGEN +payload-flattening-threshold: 1 +output-folder: $(azure-libraries-for-java-folder)/azure-mgmt-sql +``` + + +### Java multi-api + +``` yaml $(java) && $(multiapi) +batch: + - tag: package-pure-2017-10-preview + - tag: package-2014-04 +``` + +### Tag: package-pure-2017-10-preview and java + +These settings apply only when `--tag=package-pure-2017-10-preview --java` is specified on the command line. +Please also specify `--azure-libraries-for-java=`. + +``` yaml $(tag) == 'package-pure-2017-10-preview' && $(java) && $(multiapi) +java: + namespace: com.microsoft.azure.management.sql.v2017_10_01_preview + output-folder: $(azure-libraries-for-java-folder)/sql/resource-manager/v2017_10_01_preview +regenerate-manager: true +generate-interface: true +``` + +### Tag: package-2014-04 and java + +These settings apply only when `--tag=package-2014-04 --java` is specified on the command line. +Please also specify `--azure-libraries-for-java=`. + +``` yaml $(tag) == 'package-2014-04' && $(java) && $(multiapi) +java: + namespace: com.microsoft.azure.management.sql.v2014_04_01 + output-folder: $(azure-libraries-for-java-folder)/sql/resource-manager/v2014_04_01 +regenerate-manager: true +generate-interface: true +``` + + +## Validation + +``` yaml +directive: + - suppress: TrackedResourceListByImmediateParent + reason: This warning gives many false positives for proxy resources. + - suppress: GuidUsage + reason: This warning gives many positives for existing APIs that cannot be changed. + - suppress: EnumInsteadOfBoolean + reason: This warning gives many positives for existing APIs that cannot be changed.