From 7951e14543b520cda93df9fb30f0a57d4bacf19b Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Thu, 21 Apr 2022 16:39:45 +0200 Subject: [PATCH 01/15] Added swagger, examples and changed the readme.md file --- .../ManagedInstanceDTCs.json | 305 ++++++++++++++++++ .../examples/ManagedInstanceDtcGet.json | 34 ++ .../examples/ManagedInstanceDtcList.json | 38 +++ .../ManagedInstanceDtcUpdateEnableDtc.json | 40 +++ .../examples/ManagedInstanceDtcUpdateMax.json | 53 +++ specification/sql/resource-manager/readme.md | 2 + 6 files changed, 472 insertions(+) create mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json create mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json create mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcList.json create mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json create mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json new file mode 100644 index 000000000000..1019291a2f29 --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json @@ -0,0 +1,305 @@ +{ + "swagger": "2.0", + "info": { + "version": "2022-02-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/managedInstances/{managedInstanceName}/dtc": { + "get": { + "tags": [ + "ManagedInstanceDTCs" + ], + "description": "Gets a list of the managed instance DTC settings.", + "operationId": "ManagedInstanceDTCs_ListByManagedInstance", + "parameters": [ + { + "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupParameter" + }, + { + "name": "managedInstanceName", + "in": "path", + "description": "The name of the managed instance.", + "required": true, + "type": "string" + }, + { + "$ref": "../../../common/v1/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../common/v1/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Successfully retrieved the specified managed instance DTC settings.", + "schema": { + "$ref": "#/definitions/ManagedInstanceDTCListResult" + } + }, + "default": { + "description": "*** Error Responses: ***\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 SubscriptionNotFound - The requested subscription was not found.\n\n * 404 ResourceNotFound - The requested resource was not found." + } + }, + "x-ms-pageable": { + "nextLinkName": "nextLink" + }, + "x-ms-examples": { + "Gets a list of the managed instance DTC settings.": { + "$ref": "./examples/ManagedInstanceDtcList.json" + } + } + } + }, + "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dtc/{dtcName}": { + "get": { + "tags": [ + "ManagedInstanceDTCs" + ], + "description": "Gets the managed instance DTC settings.", + "operationId": "ManagedInstanceDTCs_Get", + "parameters": [ + { + "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupParameter" + }, + { + "name": "managedInstanceName", + "in": "path", + "description": "The name of the managed instance.", + "required": true, + "type": "string" + }, + { + "name": "dtcName", + "in": "path", + "description": "Name of the DTC instance used.", + "required": true, + "type": "string", + "enum": [ + "current" + ], + "x-ms-enum": { + "name": "DtcName", + "modelAsString": true + } + }, + { + "$ref": "../../../common/v1/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../common/v1/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Successfully retrieved the specified managed instance DTC settings.", + "schema": { + "$ref": "#/definitions/ManagedInstanceDTC" + } + }, + "default": { + "description": "*** Error Responses: ***\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 SubscriptionNotFound - The requested subscription was not found.\n\n * 404 ResourceNotFound - The requested resource was not found." + } + }, + "x-ms-examples": { + "Gets the managed instance DTC settings.": { + "$ref": "./examples/ManagedInstanceDtcGet.json" + } + } + }, + "put": { + "tags": [ + "ManagedInstanceDTCs" + ], + "description": "Updates the managed instance DTC settings.", + "operationId": "ManagedInstanceDTCs_CreateOrUpdate", + "parameters": [ + { + "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupParameter" + }, + { + "name": "managedInstanceName", + "in": "path", + "description": "The name of the managed instance.", + "required": true, + "type": "string" + }, + { + "name": "dtcName", + "in": "path", + "description": "Name of the DTC instance used.", + "required": true, + "type": "string", + "enum": [ + "current" + ], + "x-ms-enum": { + "name": "DtcName", + "modelAsString": true + } + }, + { + "name": "parameters", + "in": "body", + "description": "Settings of the DTC tied to the Managed instance.", + "required": true, + "schema": { + "$ref": "#/definitions/ManagedInstanceDTC" + } + }, + { + "$ref": "../../../common/v1/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../common/v1/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Successfully updated DTC settings.", + "schema": { + "$ref": "#/definitions/ManagedInstanceDTC" + } + }, + "default": { + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcAuthenticationMethod - DTC authetnication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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": "Applying DTC settings is in progress" + } + }, + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Updates the managed instance DTC settings with all optional parameters specified.": { + "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" + }, + "Updates the managed instance DTC settings by enabling DTC.": { + "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" + } + } + } + } + }, + "definitions": { + "ManagedInstanceDTC": { + "description": "SQL Managed Instance DTC", + "type": "object", + "allOf": [ + { + "$ref": "../../../common/v1/types.json#/definitions/ProxyResource" + } + ], + "properties": { + "properties": { + "$ref": "#/definitions/ManagedInstanceDTCProperties", + "description": "Resource properties.", + "x-ms-client-flatten": true + } + } + }, + "ManagedInstanceDTCListResult": { + "description": "A list of managed instance's DTCs.", + "type": "object", + "properties": { + "value": { + "description": "Array of results.", + "type": "array", + "items": { + "$ref": "#/definitions/ManagedInstanceDTC" + }, + "readOnly": true + }, + "nextLink": { + "description": "Link to retrieve next page of results.", + "type": "string", + "readOnly": true + } + } + }, + "ManagedInstanceDTCProperties": { + "description": "The properties of managed instance DTC.", + "type": "object", + "properties": { + "dtcEnabled": { + "description": "Active status of managed instance DTC.", + "type": "boolean" + }, + "securitySettings": { + "$ref": "#/definitions/ManagedInstanceDTCSecuritySettings", + "description": "Security settings of managed instance DTC." + }, + "externalDnsSuffixSearchList": { + "description": "External dns suffix search list of managed instance DTC.", + "type": "array", + "items": { + "type": "string" + } + }, + "dtcHostNameDnsSuffix": { + "description": "Host name dns suffix of managed instance DTC.", + "type": "string", + "readOnly": true + } + } + }, + "ManagedInstanceDTCSecuritySettings": { + "description": "The Transaction Manager Communication Settings of the DTC tied to managed instance.", + "type": "object", + "properties": { + "transactionManagerCommunicationSettings": { + "$ref": "#/definitions/ManagedInstanceDTCTransactionManagerCommunicationSettings", + "description": "Transaction Manager communication settings of managed instance DTC." + }, + "xaTransactionsEnabled": { + "description": "Allow XA Transactions to managed instance DTC.", + "type": "boolean" + }, + "snaLu6point2TransactionsEnabled": { + "description": "Allow SNA LU 6.2 to managed instance DTC.", + "type": "boolean" + } + } + }, + "ManagedInstanceDTCTransactionManagerCommunicationSettings": { + "description": "The Transaction Manager Communication Settings of the DTC tied to managed instance.", + "type": "object", + "properties": { + "allowInboundEnabled": { + "description": "Allow Inbund traffic to managed instance DTC.", + "type": "boolean" + }, + "allowOutboundEnabled": { + "description": "Allow Outbound traffic of managed instance DTC.", + "type": "boolean" + }, + "authentication": { + "description": "Authentication type of managed instance DTC.", + "type": "string" + } + } + } + }, + "parameters": {}, + "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" + } + } + } +} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json new file mode 100644 index 000000000000..2b816cb98bce --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json @@ -0,0 +1,34 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "testrg", + "managedInstanceName": "testinstance", + "api-version": "2022-02-01-preview" + }, + "responses": { + "200": { + "body": { + "properties": { + "dtcEnabled": true, + "securitySettings": { + "transactionManagerCommunicationSettings": { + "allowInboundEnabled": false, + "allowOutboundEnabled": true, + "authentication": "NoAuth" + }, + "xaTransactionsEnabled": false, + "snaLu6point2TransactionsEnabled": false + }, + "externalDnsSuffixSearchList": [ + "dns.example1.com", + "dns.example2.com" + ], + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", + "name": "current", + "type": "Microsoft.Sql/managedInstances/dtc" + } + } + } +} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcList.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcList.json new file mode 100644 index 000000000000..afb0edb6d5fd --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcList.json @@ -0,0 +1,38 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "testrg", + "managedInstanceName": "testinstance", + "api-version": "2022-02-01-preview" + }, + "responses": { + "200": { + "body": { + "value": [ + { + "properties": { + "dtcEnabled": true, + "securitySettings": { + "transactionManagerCommunicationSettings": { + "allowInboundEnabled": false, + "allowOutboundEnabled": true, + "authentication": "NoAuth" + }, + "xaTransactionsEnabled": false, + "snaLu6point2TransactionsEnabled": false + }, + "externalDnsSuffixSearchList": [ + "dns.example1.com", + "dns.example2.com" + ], + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", + "name": "current", + "type": "Microsoft.Sql/managedInstances/dtc" + } + ] + } + } + } +} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json new file mode 100644 index 000000000000..4df81058ad83 --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json @@ -0,0 +1,40 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "testrg", + "managedInstanceName": "testinstance", + "api-version": "2022-02-01-preview", + "parameters": { + "properties": { + "dtcEnabled": true + } + } + }, + "responses": { + "200": { + "body": { + "properties": { + "dtcEnabled": true, + "securitySettings": { + "transactionManagerCommunicationSettings": { + "allowInboundEnabled": false, + "allowOutboundEnabled": true, + "authentication": "NoAuth" + }, + "xaTransactionsEnabled": false, + "snaLu6point2TransactionsEnabled": false + }, + "externalDnsSuffixSearchList": [ + "dns.example1.com", + "dns.example2.com" + ], + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", + "name": "current", + "type": "Microsoft.Sql/managedInstances/dtc" + } + }, + "202": {} + } +} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json new file mode 100644 index 000000000000..d215cb358e38 --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json @@ -0,0 +1,53 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "testrg", + "managedInstanceName": "testinstance", + "api-version": "2022-02-01-preview", + "parameters": { + "properties": { + "dtcEnabled": true, + "securitySettings": { + "transactionManagerCommunicationSettings": { + "allowInboundEnabled": false, + "allowOutboundEnabled": true, + "authentication": "NoAuth" + }, + "xaTransactionsEnabled": false, + "snaLu6point2TransactionsEnabled": false + }, + "externalDnsSuffixSearchList": [ + "dns.example1.com", + "dns.example2.com" + ] + } + } + }, + "responses": { + "200": { + "body": { + "properties": { + "dtcEnabled": true, + "securitySettings": { + "transactionManagerCommunicationSettings": { + "allowInboundEnabled": false, + "allowOutboundEnabled": true, + "authentication": "NoAuth" + }, + "xaTransactionsEnabled": false, + "snaLu6point2TransactionsEnabled": false + }, + "externalDnsSuffixSearchList": [ + "dns.example1.com", + "dns.example2.com" + ], + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", + "name": "current", + "type": "Microsoft.Sql/managedInstances/dtc" + } + }, + "202": {} + } +} diff --git a/specification/sql/resource-manager/readme.md b/specification/sql/resource-manager/readme.md index 1b825cacb0a4..deaf325227f8 100644 --- a/specification/sql/resource-manager/readme.md +++ b/specification/sql/resource-manager/readme.md @@ -99,6 +99,7 @@ input-file: - Microsoft.Sql/preview/2022-02-01-preview/ManagedDatabases.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceAdministrators.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceAzureADOnlyAuthentications.json + - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceEncryptionProtectors.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceKeys.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceLongTermRetentionPolicies.json @@ -396,6 +397,7 @@ input-file: - ./Microsoft.Sql/preview/2021-11-01-preview/ManagedServerDnsAliases.json - ./Microsoft.Sql/preview/2021-11-01-preview/SensitivityLabels.json - ./Microsoft.Sql/preview/2021-11-01-preview/EndpointCertificates.json +- ./Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json # Needed when there is more than one input file From ddb7cfd8178412da71184fdee63d4c51866c0e16 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Thu, 21 Apr 2022 17:40:11 +0200 Subject: [PATCH 02/15] Fixed spelling errors and examples --- custom-words.txt | 3 ++- .../preview/2022-02-01-preview/ManagedInstanceDTCs.json | 4 ++-- .../2022-02-01-preview/examples/ManagedInstanceDtcGet.json | 1 + .../examples/ManagedInstanceDtcUpdateEnableDtc.json | 1 + .../examples/ManagedInstanceDtcUpdateMax.json | 1 + 5 files changed, 7 insertions(+), 3 deletions(-) diff --git a/custom-words.txt b/custom-words.txt index b28a5362f721..9b767207dd20 100644 --- a/custom-words.txt +++ b/custom-words.txt @@ -2523,4 +2523,5 @@ Dataworld Asana AppFigures Twilio -getazresiliencystatus \ No newline at end of file +getazresiliencystatus +DTCs \ No newline at end of file diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json index 1019291a2f29..56ce3274a4d4 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json @@ -173,7 +173,7 @@ } }, "default": { - "description": "*** Error Responses: ***\n\n * 400 InvalidDtcAuthenticationMethod - DTC authetnication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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." + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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": "Applying DTC settings is in progress" @@ -276,7 +276,7 @@ "type": "object", "properties": { "allowInboundEnabled": { - "description": "Allow Inbund traffic to managed instance DTC.", + "description": "Allow Inbound traffic to managed instance DTC.", "type": "boolean" }, "allowOutboundEnabled": { diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json index 2b816cb98bce..dcba200a0aab 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json @@ -3,6 +3,7 @@ "subscriptionId": "00000000-1111-2222-3333-444444444444", "resourceGroupName": "testrg", "managedInstanceName": "testinstance", + "dtcName": "current", "api-version": "2022-02-01-preview" }, "responses": { diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json index 4df81058ad83..a1957422e286 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json @@ -3,6 +3,7 @@ "subscriptionId": "00000000-1111-2222-3333-444444444444", "resourceGroupName": "testrg", "managedInstanceName": "testinstance", + "dtcName": "current", "api-version": "2022-02-01-preview", "parameters": { "properties": { diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json index d215cb358e38..de21d33568a9 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json @@ -3,6 +3,7 @@ "subscriptionId": "00000000-1111-2222-3333-444444444444", "resourceGroupName": "testrg", "managedInstanceName": "testinstance", + "dtcName": "current", "api-version": "2022-02-01-preview", "parameters": { "properties": { From d12615269a42c5e7ab1ef39613ea6429d0b4ea98 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Thu, 28 Apr 2022 13:16:58 +0200 Subject: [PATCH 03/15] Added a patch request option and renamed the file to lowercase --- ...anceDTCs.json => ManagedInstanceDtcs.json} | 140 +++++++++++++----- 1 file changed, 102 insertions(+), 38 deletions(-) rename specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/{ManagedInstanceDTCs.json => ManagedInstanceDtcs.json} (55%) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json similarity index 55% rename from specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json rename to specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index 56ce3274a4d4..36dfbbdf5ad1 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -19,20 +19,16 @@ "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dtc": { "get": { "tags": [ - "ManagedInstanceDTCs" + "ManagedInstanceDtcs" ], "description": "Gets a list of the managed instance DTC settings.", - "operationId": "ManagedInstanceDTCs_ListByManagedInstance", + "operationId": "ManagedInstanceDtcs_ListByManagedInstance", "parameters": [ { "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupParameter" }, { - "name": "managedInstanceName", - "in": "path", - "description": "The name of the managed instance.", - "required": true, - "type": "string" + "$ref": "#/parameters/ManagedInstanceNameParameter" }, { "$ref": "../../../common/v1/types.json#/parameters/SubscriptionIdParameter" @@ -45,7 +41,7 @@ "200": { "description": "Successfully retrieved the specified managed instance DTC settings.", "schema": { - "$ref": "#/definitions/ManagedInstanceDTCListResult" + "$ref": "#/definitions/ManagedInstanceDtcListResult" } }, "default": { @@ -65,25 +61,21 @@ "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dtc/{dtcName}": { "get": { "tags": [ - "ManagedInstanceDTCs" + "ManagedInstanceDtcs" ], "description": "Gets the managed instance DTC settings.", - "operationId": "ManagedInstanceDTCs_Get", + "operationId": "ManagedInstanceDtcs_Get", "parameters": [ { "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupParameter" }, { - "name": "managedInstanceName", - "in": "path", - "description": "The name of the managed instance.", - "required": true, - "type": "string" + "$ref": "#/parameters/ManagedInstanceNameParameter" }, { "name": "dtcName", "in": "path", - "description": "Name of the DTC instance used.", + "description": "The name of the managed instance DTC.", "required": true, "type": "string", "enum": [ @@ -105,11 +97,11 @@ "200": { "description": "Successfully retrieved the specified managed instance DTC settings.", "schema": { - "$ref": "#/definitions/ManagedInstanceDTC" + "$ref": "#/definitions/ManagedInstanceDtc" } }, "default": { - "description": "*** Error Responses: ***\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 SubscriptionNotFound - The requested subscription was not found.\n\n * 404 ResourceNotFound - The requested resource was not found." + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 SubscriptionNotFound - The requested subscription was not found.\n\n * 404 ResourceNotFound - The requested resource was not found." } }, "x-ms-examples": { @@ -120,25 +112,88 @@ }, "put": { "tags": [ - "ManagedInstanceDTCs" + "ManagedInstanceDtcs" ], "description": "Updates the managed instance DTC settings.", - "operationId": "ManagedInstanceDTCs_CreateOrUpdate", + "operationId": "ManagedInstanceDtcs_CreateOrUpdate", "parameters": [ { "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupParameter" }, { - "name": "managedInstanceName", + "$ref": "#/parameters/ManagedInstanceNameParameter" + }, + { + "name": "dtcName", "in": "path", - "description": "The name of the managed instance.", + "description": "The name of the managed instance DTC.", "required": true, - "type": "string" + "type": "string", + "enum": [ + "current" + ], + "x-ms-enum": { + "name": "DtcName", + "modelAsString": true + } + }, + { + "name": "parameters", + "in": "body", + "description": "Managed instance DTC settings.", + "required": true, + "schema": { + "$ref": "#/definitions/ManagedInstanceDtc" + } + }, + { + "$ref": "../../../common/v1/types.json#/parameters/SubscriptionIdParameter" + }, + { + "$ref": "../../../common/v1/types.json#/parameters/ApiVersionParameter" + } + ], + "responses": { + "200": { + "description": "Successfully updated DTC settings.", + "schema": { + "$ref": "#/definitions/ManagedInstanceDtc" + } + }, + "default": { + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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": "Applying DTC settings is in progress" + } + }, + "x-ms-long-running-operation": true, + "x-ms-examples": { + "Updates the managed instance DTC settings with all optional parameters specified.": { + "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" + }, + "Updates the managed instance DTC settings by enabling DTC.": { + "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" + } + } + }, + "patch": { + "tags": [ + "ManagedInstanceDtcs" + ], + "description": "Patches the managed instance DTC settings.", + "operationId": "ManagedInstanceDtcs_Update", + "parameters": [ + { + "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupParameter" + }, + { + "$ref": "#/parameters/ManagedInstanceNameParameter" }, { "name": "dtcName", "in": "path", - "description": "Name of the DTC instance used.", + "description": "The name of the managed instance DTC.", "required": true, "type": "string", "enum": [ @@ -152,10 +207,10 @@ { "name": "parameters", "in": "body", - "description": "Settings of the DTC tied to the Managed instance.", + "description": "Managed instance DTC settings.", "required": true, "schema": { - "$ref": "#/definitions/ManagedInstanceDTC" + "$ref": "#/definitions/ManagedInstanceDtc" } }, { @@ -169,11 +224,11 @@ "200": { "description": "Successfully updated DTC settings.", "schema": { - "$ref": "#/definitions/ManagedInstanceDTC" + "$ref": "#/definitions/ManagedInstanceDtc" } }, "default": { - "description": "*** Error Responses: ***\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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." + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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": "Applying DTC settings is in progress" @@ -192,7 +247,7 @@ } }, "definitions": { - "ManagedInstanceDTC": { + "ManagedInstanceDtc": { "description": "SQL Managed Instance DTC", "type": "object", "allOf": [ @@ -202,13 +257,13 @@ ], "properties": { "properties": { - "$ref": "#/definitions/ManagedInstanceDTCProperties", + "$ref": "#/definitions/ManagedInstanceDtcProperties", "description": "Resource properties.", "x-ms-client-flatten": true } } }, - "ManagedInstanceDTCListResult": { + "ManagedInstanceDtcListResult": { "description": "A list of managed instance's DTCs.", "type": "object", "properties": { @@ -216,7 +271,7 @@ "description": "Array of results.", "type": "array", "items": { - "$ref": "#/definitions/ManagedInstanceDTC" + "$ref": "#/definitions/ManagedInstanceDtc" }, "readOnly": true }, @@ -227,7 +282,7 @@ } } }, - "ManagedInstanceDTCProperties": { + "ManagedInstanceDtcProperties": { "description": "The properties of managed instance DTC.", "type": "object", "properties": { @@ -236,7 +291,7 @@ "type": "boolean" }, "securitySettings": { - "$ref": "#/definitions/ManagedInstanceDTCSecuritySettings", + "$ref": "#/definitions/ManagedInstanceDtcSecuritySettings", "description": "Security settings of managed instance DTC." }, "externalDnsSuffixSearchList": { @@ -253,12 +308,12 @@ } } }, - "ManagedInstanceDTCSecuritySettings": { + "ManagedInstanceDtcSecuritySettings": { "description": "The Transaction Manager Communication Settings of the DTC tied to managed instance.", "type": "object", "properties": { "transactionManagerCommunicationSettings": { - "$ref": "#/definitions/ManagedInstanceDTCTransactionManagerCommunicationSettings", + "$ref": "#/definitions/ManagedInstanceDtcTransactionManagerCommunicationSettings", "description": "Transaction Manager communication settings of managed instance DTC." }, "xaTransactionsEnabled": { @@ -271,7 +326,7 @@ } } }, - "ManagedInstanceDTCTransactionManagerCommunicationSettings": { + "ManagedInstanceDtcTransactionManagerCommunicationSettings": { "description": "The Transaction Manager Communication Settings of the DTC tied to managed instance.", "type": "object", "properties": { @@ -290,7 +345,16 @@ } } }, - "parameters": {}, + "parameters": { + "ManagedInstanceNameParameter": { + "name": "managedInstanceName", + "in": "path", + "description": "The name of the managed instance.", + "required": true, + "type": "string", + "x-ms-parameter-location": "method" + } + }, "securityDefinitions": { "azure_auth": { "type": "oauth2", From aba361aa13e99327cf4009d129eb742c93db329e Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic <51293916+krivi37@users.noreply.github.com> Date: Thu, 28 Apr 2022 16:12:20 +0200 Subject: [PATCH 04/15] Update readme.md --- specification/sql/resource-manager/readme.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/sql/resource-manager/readme.md b/specification/sql/resource-manager/readme.md index deaf325227f8..e208a4f70d7c 100644 --- a/specification/sql/resource-manager/readme.md +++ b/specification/sql/resource-manager/readme.md @@ -99,7 +99,7 @@ input-file: - Microsoft.Sql/preview/2022-02-01-preview/ManagedDatabases.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceAdministrators.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceAzureADOnlyAuthentications.json - - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json + - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceEncryptionProtectors.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceKeys.json - Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceLongTermRetentionPolicies.json @@ -397,7 +397,7 @@ input-file: - ./Microsoft.Sql/preview/2021-11-01-preview/ManagedServerDnsAliases.json - ./Microsoft.Sql/preview/2021-11-01-preview/SensitivityLabels.json - ./Microsoft.Sql/preview/2021-11-01-preview/EndpointCertificates.json -- ./Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDTCs.json +- ./Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json # Needed when there is more than one input file From c613fcb3b38ac4e4adbf5eabf4bd75c5cd5903e3 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Fri, 29 Apr 2022 15:27:19 +0200 Subject: [PATCH 05/15] Renamed examples for put and patch update --- .../preview/2022-02-01-preview/ManagedInstanceDtcs.json | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index 36dfbbdf5ad1..6f60683436a0 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -169,10 +169,10 @@ }, "x-ms-long-running-operation": true, "x-ms-examples": { - "Updates the managed instance DTC settings with all optional parameters specified.": { + "Updates the managed instance DTC settings with all optional parameters specified using PUT request.": { "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" }, - "Updates the managed instance DTC settings by enabling DTC.": { + "Updates the managed instance DTC settings by enabling DTC using PUT request.": { "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" } } @@ -236,10 +236,10 @@ }, "x-ms-long-running-operation": true, "x-ms-examples": { - "Updates the managed instance DTC settings with all optional parameters specified.": { + "Updates the managed instance DTC settings with all optional parameters specified using PATCH request.": { "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" }, - "Updates the managed instance DTC settings by enabling DTC.": { + "Updates the managed instance DTC settings by enabling DTC using PATCH request.": { "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" } } From 498f99d664876ddd1f4fa5f04aa9d87e4ee1da78 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Wed, 11 May 2022 15:36:46 +0200 Subject: [PATCH 06/15] Extracted resource properties for patch request --- .../preview/2022-02-01-preview/ManagedInstanceDtcs.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index 6f60683436a0..0d2ed1dd096f 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -210,7 +210,7 @@ "description": "Managed instance DTC settings.", "required": true, "schema": { - "$ref": "#/definitions/ManagedInstanceDtc" + "$ref": "#/definitions/ManagedInstanceDtcProperties" } }, { From 6fb2c3f987f610282332cc6020384c6d62f95603 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Fri, 13 May 2022 01:17:01 +0200 Subject: [PATCH 07/15] Added new examples and changed existing ones --- .../ManagedInstanceDtcs.json | 16 +++--- ...anagedInstanceDtcPatchUpdateEnableDtc.json | 39 ++++++++++++++ .../ManagedInstanceDtcPatchUpdateMax.json | 52 +++++++++++++++++++ ...ManagedInstanceDtcPutUpdateEnableDtc.json} | 0 ...on => ManagedInstanceDtcPutUpdateMax.json} | 0 5 files changed, 99 insertions(+), 8 deletions(-) create mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json create mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json rename specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/{ManagedInstanceDtcUpdateEnableDtc.json => ManagedInstanceDtcPutUpdateEnableDtc.json} (100%) rename specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/{ManagedInstanceDtcUpdateMax.json => ManagedInstanceDtcPutUpdateMax.json} (100%) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index 0d2ed1dd096f..8ebc20391edc 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -45,7 +45,7 @@ } }, "default": { - "description": "*** Error Responses: ***\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 SubscriptionNotFound - The requested subscription was not found.\n\n * 404 ResourceNotFound - The requested resource was not found." + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 404 SubscriptionNotFound - The requested subscription was not found.\n\n * 404 ResourceNotFound - The requested resource was not found." } }, "x-ms-pageable": { @@ -101,7 +101,7 @@ } }, "default": { - "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 SubscriptionNotFound - The requested subscription was not found.\n\n * 404 ResourceNotFound - The requested resource was not found." + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 404 SubscriptionNotFound - The requested subscription was not found.\n\n * 404 ResourceNotFound - The requested resource was not found." } }, "x-ms-examples": { @@ -161,7 +161,7 @@ } }, "default": { - "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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." + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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": "Applying DTC settings is in progress" @@ -170,10 +170,10 @@ "x-ms-long-running-operation": true, "x-ms-examples": { "Updates the managed instance DTC settings with all optional parameters specified using PUT request.": { - "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" + "$ref": "./examples/ManagedInstanceDtcPutUpdateMax.json" }, "Updates the managed instance DTC settings by enabling DTC using PUT request.": { - "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" + "$ref": "./examples/ManagedInstanceDtcPutUpdateEnableDtc.json" } } }, @@ -228,7 +228,7 @@ } }, "default": { - "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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." + "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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": "Applying DTC settings is in progress" @@ -237,10 +237,10 @@ "x-ms-long-running-operation": true, "x-ms-examples": { "Updates the managed instance DTC settings with all optional parameters specified using PATCH request.": { - "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" + "$ref": "./examples/ManagedInstanceDtcPatchUpdateMax.json" }, "Updates the managed instance DTC settings by enabling DTC using PATCH request.": { - "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" + "$ref": "./examples/ManagedInstanceDtcPatchUpdateEnableDtc.json" } } } diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json new file mode 100644 index 000000000000..8f808997a163 --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json @@ -0,0 +1,39 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "testrg", + "managedInstanceName": "testinstance", + "dtcName": "current", + "api-version": "2022-02-01-preview", + "parameters": { + "dtcEnabled": true + } + }, + "responses": { + "200": { + "body": { + "properties": { + "dtcEnabled": true, + "securitySettings": { + "transactionManagerCommunicationSettings": { + "allowInboundEnabled": false, + "allowOutboundEnabled": true, + "authentication": "NoAuth" + }, + "xaTransactionsEnabled": false, + "snaLu6point2TransactionsEnabled": false + }, + "externalDnsSuffixSearchList": [ + "dns.example1.com", + "dns.example2.com" + ], + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", + "name": "current", + "type": "Microsoft.Sql/managedInstances/dtc" + } + }, + "202": {} + } +} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json new file mode 100644 index 000000000000..087fec489d53 --- /dev/null +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json @@ -0,0 +1,52 @@ +{ + "parameters": { + "subscriptionId": "00000000-1111-2222-3333-444444444444", + "resourceGroupName": "testrg", + "managedInstanceName": "testinstance", + "dtcName": "current", + "api-version": "2022-02-01-preview", + "parameters": { + "dtcEnabled": true, + "securitySettings": { + "transactionManagerCommunicationSettings": { + "allowInboundEnabled": false, + "allowOutboundEnabled": true, + "authentication": "NoAuth" + }, + "xaTransactionsEnabled": false, + "snaLu6point2TransactionsEnabled": false + }, + "externalDnsSuffixSearchList": [ + "dns.example1.com", + "dns.example2.com" + ] + } + }, + "responses": { + "200": { + "body": { + "properties": { + "dtcEnabled": true, + "securitySettings": { + "transactionManagerCommunicationSettings": { + "allowInboundEnabled": false, + "allowOutboundEnabled": true, + "authentication": "NoAuth" + }, + "xaTransactionsEnabled": false, + "snaLu6point2TransactionsEnabled": false + }, + "externalDnsSuffixSearchList": [ + "dns.example1.com", + "dns.example2.com" + ], + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + }, + "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", + "name": "current", + "type": "Microsoft.Sql/managedInstances/dtc" + } + }, + "202": {} + } +} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json similarity index 100% rename from specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json rename to specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json similarity index 100% rename from specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json rename to specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json From ebfda3123a7c1dbbe11c390023cd83a60376d079 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Tue, 17 May 2022 22:21:53 +0200 Subject: [PATCH 08/15] Added provisioning state to put request --- .../ManagedInstanceDtcs.json | 22 +++++++++++++++++++ .../examples/ManagedInstanceDtcGet.json | 3 ++- .../examples/ManagedInstanceDtcList.json | 3 ++- ...anagedInstanceDtcPatchUpdateEnableDtc.json | 3 ++- .../ManagedInstanceDtcPatchUpdateMax.json | 3 ++- 5 files changed, 30 insertions(+), 4 deletions(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index 8ebc20391edc..79796f1a9f83 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -305,6 +305,28 @@ "description": "Host name dns suffix of managed instance DTC.", "type": "string", "readOnly": true + }, + "provisioningState": { + "description": "Provisioning state of managed instance DTC.", + "enum": [ + "Creating", + "Deleting", + "Updating", + "Unknown", + "Succeeded", + "Failed", + "Accepted", + "Created", + "Deleted", + "Unrecognized", + "Running", + "Canceled", + "NotSpecified", + "Registering", + "TimedOut" + ], + "type": "string", + "readOnly": true } } }, diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json index dcba200a0aab..6dddb775e3d4 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcGet.json @@ -24,7 +24,8 @@ "dns.example1.com", "dns.example2.com" ], - "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", + "provisioningState": "Succeeded" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcList.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcList.json index afb0edb6d5fd..002b21dc430e 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcList.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcList.json @@ -25,7 +25,8 @@ "dns.example1.com", "dns.example2.com" ], - "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", + "provisioningState": "Succeeded" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json index 8f808997a163..bf75fc78b1f0 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json @@ -27,7 +27,8 @@ "dns.example1.com", "dns.example2.com" ], - "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", + "provisioningState": "Succeeded" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json index 087fec489d53..7e57f87f34d7 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json @@ -40,7 +40,8 @@ "dns.example1.com", "dns.example2.com" ], - "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", + "provisioningState": "Succeeded" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", From 2d18c666b3ff49340123a37c05d8b5a26a7c7f7d Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Tue, 17 May 2022 22:25:05 +0200 Subject: [PATCH 09/15] Updated put examples --- .../examples/ManagedInstanceDtcPutUpdateEnableDtc.json | 3 ++- .../examples/ManagedInstanceDtcPutUpdateMax.json | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json index a1957422e286..7e6a7ef29458 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json @@ -29,7 +29,8 @@ "dns.example1.com", "dns.example2.com" ], - "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", + "provisioningState": "Succeeded" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json index de21d33568a9..c0a71cf88499 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json @@ -42,7 +42,8 @@ "dns.example1.com", "dns.example2.com" ], - "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com" + "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", + "provisioningState": "Succeeded" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", From 1484207e62ae9e0e1c9b1b710a67be7188831e66 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Tue, 17 May 2022 22:28:56 +0200 Subject: [PATCH 10/15] Changed provisioning status in the update examples --- .../examples/ManagedInstanceDtcPatchUpdateEnableDtc.json | 2 +- .../examples/ManagedInstanceDtcPatchUpdateMax.json | 2 +- .../examples/ManagedInstanceDtcPutUpdateEnableDtc.json | 2 +- .../examples/ManagedInstanceDtcPutUpdateMax.json | 2 +- 4 files changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json index bf75fc78b1f0..8f193ca62fb5 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json @@ -28,7 +28,7 @@ "dns.example2.com" ], "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", - "provisioningState": "Succeeded" + "provisioningState": "Updating" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json index 7e57f87f34d7..3eed5585c6b4 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json @@ -41,7 +41,7 @@ "dns.example2.com" ], "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", - "provisioningState": "Succeeded" + "provisioningState": "Updating" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json index 7e6a7ef29458..a866265ca032 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json @@ -30,7 +30,7 @@ "dns.example2.com" ], "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", - "provisioningState": "Succeeded" + "provisioningState": "Updating" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json index c0a71cf88499..7289d73794cf 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json @@ -43,7 +43,7 @@ "dns.example2.com" ], "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", - "provisioningState": "Succeeded" + "provisioningState": "Updating" }, "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", "name": "current", From 673a8ac3867e297bc3de34bebae85ad667c67aae Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Wed, 18 May 2022 12:28:24 +0200 Subject: [PATCH 11/15] Updated provisioning state enum --- .../ManagedInstanceDtcs.json | 22 +++++++------------ 1 file changed, 8 insertions(+), 14 deletions(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index 79796f1a9f83..a86ff60c547c 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -309,24 +309,18 @@ "provisioningState": { "description": "Provisioning state of managed instance DTC.", "enum": [ - "Creating", - "Deleting", - "Updating", - "Unknown", + "Created", + "InProgress", "Succeeded", "Failed", - "Accepted", - "Created", - "Deleted", - "Unrecognized", - "Running", - "Canceled", - "NotSpecified", - "Registering", - "TimedOut" + "Canceled" ], "type": "string", - "readOnly": true + "readOnly": true, + "x-ms-enum": { + "name": "ProvisioningState", + "modelAsString": true + } } } }, From 4daf2404fb189c1995845af67caebb2d66a5a1fa Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Thu, 19 May 2022 15:15:32 +0200 Subject: [PATCH 12/15] Removed 202 code from PUT provisioning state response and updated examples accordingly --- .../preview/2022-02-01-preview/ManagedInstanceDtcs.json | 5 +---- .../examples/ManagedInstanceDtcPutUpdateEnableDtc.json | 3 +-- .../examples/ManagedInstanceDtcPutUpdateMax.json | 3 +-- 3 files changed, 3 insertions(+), 8 deletions(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index a86ff60c547c..790b98e9f011 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -155,16 +155,13 @@ ], "responses": { "200": { - "description": "Successfully updated DTC settings.", + "description": "Applying DTC settings is in progress", "schema": { "$ref": "#/definitions/ManagedInstanceDtc" } }, "default": { "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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": "Applying DTC settings is in progress" } }, "x-ms-long-running-operation": true, diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json index a866265ca032..54bbf8b9d808 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json @@ -36,7 +36,6 @@ "name": "current", "type": "Microsoft.Sql/managedInstances/dtc" } - }, - "202": {} + } } } diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json index 7289d73794cf..99a81ca66fe5 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json @@ -49,7 +49,6 @@ "name": "current", "type": "Microsoft.Sql/managedInstances/dtc" } - }, - "202": {} + } } } From 7fbd99d9c9e5ee0c5e02cab866366cfd0c6e2596 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Fri, 20 May 2022 17:19:28 +0200 Subject: [PATCH 13/15] Removed patch operation and associated examples, also renamed put examples --- .../ManagedInstanceDtcs.json | 71 +------------------ ...anagedInstanceDtcPatchUpdateEnableDtc.json | 40 ----------- .../ManagedInstanceDtcPatchUpdateMax.json | 53 -------------- ...=> ManagedInstanceDtcUpdateEnableDtc.json} | 0 ....json => ManagedInstanceDtcUpdateMax.json} | 0 5 files changed, 2 insertions(+), 162 deletions(-) delete mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json delete mode 100644 specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json rename specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/{ManagedInstanceDtcPutUpdateEnableDtc.json => ManagedInstanceDtcUpdateEnableDtc.json} (100%) rename specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/{ManagedInstanceDtcPutUpdateMax.json => ManagedInstanceDtcUpdateMax.json} (100%) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index 790b98e9f011..fbbb653a4472 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -167,77 +167,10 @@ "x-ms-long-running-operation": true, "x-ms-examples": { "Updates the managed instance DTC settings with all optional parameters specified using PUT request.": { - "$ref": "./examples/ManagedInstanceDtcPutUpdateMax.json" + "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" }, "Updates the managed instance DTC settings by enabling DTC using PUT request.": { - "$ref": "./examples/ManagedInstanceDtcPutUpdateEnableDtc.json" - } - } - }, - "patch": { - "tags": [ - "ManagedInstanceDtcs" - ], - "description": "Patches the managed instance DTC settings.", - "operationId": "ManagedInstanceDtcs_Update", - "parameters": [ - { - "$ref": "../../../common/v1/types.json#/parameters/ResourceGroupParameter" - }, - { - "$ref": "#/parameters/ManagedInstanceNameParameter" - }, - { - "name": "dtcName", - "in": "path", - "description": "The name of the managed instance DTC.", - "required": true, - "type": "string", - "enum": [ - "current" - ], - "x-ms-enum": { - "name": "DtcName", - "modelAsString": true - } - }, - { - "name": "parameters", - "in": "body", - "description": "Managed instance DTC settings.", - "required": true, - "schema": { - "$ref": "#/definitions/ManagedInstanceDtcProperties" - } - }, - { - "$ref": "../../../common/v1/types.json#/parameters/SubscriptionIdParameter" - }, - { - "$ref": "../../../common/v1/types.json#/parameters/ApiVersionParameter" - } - ], - "responses": { - "200": { - "description": "Successfully updated DTC settings.", - "schema": { - "$ref": "#/definitions/ManagedInstanceDtc" - } - }, - "default": { - "description": "*** Error Responses: ***\n\n * 400 InvalidDtcName - User tried to interact with Azure SQL Managed Instance DTC settings with a DTC name different from 'current'.\n\n * 400 InvalidUpdateDtcOperationParameters - The provided set of parameters in the body of the request is either empty or invalid.\n\n * 400 InvalidDtcAuthenticationMethod - DTC authentication method \"{0}\" is not supported.\n\n * 400 InvalidDtcVirtualClusterVersion - Virtual cluster version of the Azure SQL Managed Instance \"{0}\" is not supported.\n\n * 400 ManagementServiceManagedInstanceDtcFeatureDisabled - User tried to interact with Azure SQL Managed Instance DTC settings but DTC feature is currently not supported.\n\n * 404 ResourceNotFound - The requested resource was not found.\n\n * 404 OperationIdNotFound - The operation with Id does not exist.\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": "Applying DTC settings is in progress" - } - }, - "x-ms-long-running-operation": true, - "x-ms-examples": { - "Updates the managed instance DTC settings with all optional parameters specified using PATCH request.": { - "$ref": "./examples/ManagedInstanceDtcPatchUpdateMax.json" - }, - "Updates the managed instance DTC settings by enabling DTC using PATCH request.": { - "$ref": "./examples/ManagedInstanceDtcPatchUpdateEnableDtc.json" + "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" } } } diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json deleted file mode 100644 index 8f193ca62fb5..000000000000 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateEnableDtc.json +++ /dev/null @@ -1,40 +0,0 @@ -{ - "parameters": { - "subscriptionId": "00000000-1111-2222-3333-444444444444", - "resourceGroupName": "testrg", - "managedInstanceName": "testinstance", - "dtcName": "current", - "api-version": "2022-02-01-preview", - "parameters": { - "dtcEnabled": true - } - }, - "responses": { - "200": { - "body": { - "properties": { - "dtcEnabled": true, - "securitySettings": { - "transactionManagerCommunicationSettings": { - "allowInboundEnabled": false, - "allowOutboundEnabled": true, - "authentication": "NoAuth" - }, - "xaTransactionsEnabled": false, - "snaLu6point2TransactionsEnabled": false - }, - "externalDnsSuffixSearchList": [ - "dns.example1.com", - "dns.example2.com" - ], - "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", - "provisioningState": "Updating" - }, - "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", - "name": "current", - "type": "Microsoft.Sql/managedInstances/dtc" - } - }, - "202": {} - } -} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json deleted file mode 100644 index 3eed5585c6b4..000000000000 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPatchUpdateMax.json +++ /dev/null @@ -1,53 +0,0 @@ -{ - "parameters": { - "subscriptionId": "00000000-1111-2222-3333-444444444444", - "resourceGroupName": "testrg", - "managedInstanceName": "testinstance", - "dtcName": "current", - "api-version": "2022-02-01-preview", - "parameters": { - "dtcEnabled": true, - "securitySettings": { - "transactionManagerCommunicationSettings": { - "allowInboundEnabled": false, - "allowOutboundEnabled": true, - "authentication": "NoAuth" - }, - "xaTransactionsEnabled": false, - "snaLu6point2TransactionsEnabled": false - }, - "externalDnsSuffixSearchList": [ - "dns.example1.com", - "dns.example2.com" - ] - } - }, - "responses": { - "200": { - "body": { - "properties": { - "dtcEnabled": true, - "securitySettings": { - "transactionManagerCommunicationSettings": { - "allowInboundEnabled": false, - "allowOutboundEnabled": true, - "authentication": "NoAuth" - }, - "xaTransactionsEnabled": false, - "snaLu6point2TransactionsEnabled": false - }, - "externalDnsSuffixSearchList": [ - "dns.example1.com", - "dns.example2.com" - ], - "dtcHostNameDnsSuffix": "dtcHostNameSuffixExample.com", - "provisioningState": "Updating" - }, - "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance/dtc/current", - "name": "current", - "type": "Microsoft.Sql/managedInstances/dtc" - } - }, - "202": {} - } -} diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json similarity index 100% rename from specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateEnableDtc.json rename to specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateEnableDtc.json diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json similarity index 100% rename from specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcPutUpdateMax.json rename to specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/examples/ManagedInstanceDtcUpdateMax.json From a89347518e592265f3e39028db7aaf666dd6379f Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Mon, 23 May 2022 11:20:15 +0200 Subject: [PATCH 14/15] Changed descriptions of some models --- .../ManagedInstanceDtcs.json | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index fbbb653a4472..1e364f4e8efe 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -21,7 +21,7 @@ "tags": [ "ManagedInstanceDtcs" ], - "description": "Gets a list of the managed instance DTC settings.", + "description": "Gets a list of managed instance DTC settings.", "operationId": "ManagedInstanceDtcs_ListByManagedInstance", "parameters": [ { @@ -52,7 +52,7 @@ "nextLinkName": "nextLink" }, "x-ms-examples": { - "Gets a list of the managed instance DTC settings.": { + "Gets a list of managed instance DTC settings.": { "$ref": "./examples/ManagedInstanceDtcList.json" } } @@ -63,7 +63,7 @@ "tags": [ "ManagedInstanceDtcs" ], - "description": "Gets the managed instance DTC settings.", + "description": "Gets managed instance DTC settings.", "operationId": "ManagedInstanceDtcs_Get", "parameters": [ { @@ -105,7 +105,7 @@ } }, "x-ms-examples": { - "Gets the managed instance DTC settings.": { + "Gets managed instance DTC settings.": { "$ref": "./examples/ManagedInstanceDtcGet.json" } } @@ -114,7 +114,7 @@ "tags": [ "ManagedInstanceDtcs" ], - "description": "Updates the managed instance DTC settings.", + "description": "Updates managed instance DTC settings.", "operationId": "ManagedInstanceDtcs_CreateOrUpdate", "parameters": [ { @@ -166,10 +166,10 @@ }, "x-ms-long-running-operation": true, "x-ms-examples": { - "Updates the managed instance DTC settings with all optional parameters specified using PUT request.": { + "Updates managed instance DTC settings with all optional parameters specified using PUT request.": { "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" }, - "Updates the managed instance DTC settings by enabling DTC using PUT request.": { + "Updates managed instance DTC settings by enabling DTC using PUT request.": { "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" } } @@ -255,7 +255,7 @@ } }, "ManagedInstanceDtcSecuritySettings": { - "description": "The Transaction Manager Communication Settings of the DTC tied to managed instance.", + "description": "The Security Settings of managed instance DTC.", "type": "object", "properties": { "transactionManagerCommunicationSettings": { @@ -273,7 +273,7 @@ } }, "ManagedInstanceDtcTransactionManagerCommunicationSettings": { - "description": "The Transaction Manager Communication Settings of the DTC tied to managed instance.", + "description": "The Transaction Manager Communication Settings of managed instance DTC.", "type": "object", "properties": { "allowInboundEnabled": { From c94a12c02d865039e8ce0ad26d8a2007bd398ca9 Mon Sep 17 00:00:00 2001 From: Stefan Krivokapic Date: Mon, 23 May 2022 11:59:33 +0200 Subject: [PATCH 15/15] Renamed an example description --- .../preview/2022-02-01-preview/ManagedInstanceDtcs.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json index 1e364f4e8efe..6969cb669700 100644 --- a/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json +++ b/specification/sql/resource-manager/Microsoft.Sql/preview/2022-02-01-preview/ManagedInstanceDtcs.json @@ -166,10 +166,10 @@ }, "x-ms-long-running-operation": true, "x-ms-examples": { - "Updates managed instance DTC settings with all optional parameters specified using PUT request.": { + "Updates managed instance DTC settings with all optional parameters specified.": { "$ref": "./examples/ManagedInstanceDtcUpdateMax.json" }, - "Updates managed instance DTC settings by enabling DTC using PUT request.": { + "Updates managed instance DTC settings by enabling DTC.": { "$ref": "./examples/ManagedInstanceDtcUpdateEnableDtc.json" } }