Address Comments - use plain English and fix Capitalization

[curiekim0]

Choose a PR Template

Switch to "Preview" on this description then select one of the choices below.

Click here to open a PR for a Data Plane API.

Click here to open a PR for a Control Plane (ARM) API.

[openapi-pipeline-app]

Next Steps to Merge

⌛ Please wait. Next steps to merge this PR are being evaluated by automation. ⌛

[openapi-pipeline-app]

Swagger Validation Report

️️✔️BreakingChange succeeded [Detail] [Expand]

There are no breaking changes.

️️✔️Breaking Change(Cross-Version) succeeded [Detail] [Expand]

There are no breaking changes.

Compared specs (v0.10.8)	new version	base version
accessconnector.json	2024-05-01(5ae6979)	2023-05-01(main)
accessconnector.json	2024-05-01(5ae6979)	2022-10-01-preview(main)

️⚠️LintDiff: 0 Warnings warning [Detail]

Compared specs (v2.2.1)	new version	base version
package-2024-05-01	package-2024-05-01(5ae6979)	package-2024-05-01(curiekim0-databricks-Microsoft.Databricks-2024-05-01)

The following errors/warnings exist before current PR submission:

Rule	Message
❌ ResourceNameRestriction	The resource name parameter 'connectorName' should be defined with a 'pattern' restriction. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L37
❌ DeleteResponseCodes	Long-running delete operations must have responses with 202, 204 and default return codes. They also must have no other response codes. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L78
❌ LroLocationHeader	A 202 response should include an Location response header. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L104
❌ LroErrorContent	Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L116
❌ LroErrorContent	Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L175
❌ PatchBodyParametersSchema	Properties of a PATCH request body must not be required, property:type. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L197
❌ LroLocationHeader	A 202 response should include an Location response header. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L216
❌ LroErrorContent	Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L228
❌ ProvisioningStateValidation	ProvisioningState must have terminal states: Succeeded, Failed and Canceled. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L343
❌ XmsParameterLocation	The parameter 'SubscriptionIdParameter' is defined in global parameters section without 'x-ms-parameter-location' extension. This would add the parameter as the client property. Please ensure that this is exactly you want. If so, apply the extension 'x-ms-parameter-location': 'client'. Else, apply the extension 'x-ms-parameter-location': 'method'. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L402
❌ XmsParameterLocation	The parameter 'ApiVersionParameter' is defined in global parameters section without 'x-ms-parameter-location' extension. This would add the parameter as the client property. Please ensure that this is exactly you want. If so, apply the extension 'x-ms-parameter-location': 'client'. Else, apply the extension 'x-ms-parameter-location': 'method'. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L409
⚠️ LatestVersionOfCommonTypesMustBeUsed	Use the latest version v5 of managedidentity.json. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L322
⚠️ LatestVersionOfCommonTypesMustBeUsed	Use the latest version v5 of types.json. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L326
⚠️ SchemaDescriptionOrTitle	Schema should have a description or title. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L340
⚠️ LatestVersionOfCommonTypesMustBeUsed	Use the latest version v5 of managedidentity.json. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L379
⚠️ ParameterNotUsingCommonTypes	Not using the common-types defined parameter 'subscriptionId'. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L403
⚠️ ParameterNotUsingCommonTypes	Not using the common-types defined parameter 'api-version'. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L410
⚠️ ParameterNotUsingCommonTypes	Not using the common-types defined parameter 'resourceGroupName'. Location: Microsoft.Databricks/stable/2024-05-01/accessconnector.json#L417

️️✔️Avocado succeeded [Detail] [Expand]

Validation passes for Avocado.

️️✔️SwaggerAPIView succeeded [Detail] [Expand]

️️✔️TypeSpecAPIView succeeded [Detail] [Expand]

️️✔️ModelValidation succeeded [Detail] [Expand]

Validation passes for ModelValidation.

️️✔️SemanticValidation succeeded [Detail] [Expand]

Validation passes for SemanticValidation.

️️✔️SpellCheck succeeded [Detail] [Expand]

Validation passes for SpellCheck.

️⌛PR Summary pending [Detail]

️⌛Automated merging requirements met pending [Detail]

_{Posted by Swagger Pipeline | How to fix these errors?}

[openapi-pipeline-app]

Swagger Generation Artifacts

️❌ApiDocPreview: 1 Errors, 0 Warnings failed [Detail]

Rule	Message
❌ RestBuild error	"logUrl":"https://apidrop.visualstudio.com/Content%20CI/_build/results?buildId=426853&view=logs&j=fd490c07-0b22-5182-fac9-6d67fe1e939b", "detail":"Run.ps1 failed with exit code 128 "

️🔄 azure-sdk-for-python inProgress [Detail]

️🔄 azure-sdk-for-js inProgress [Detail]

️🔄 azure-resource-manager-schemas inProgress [Detail]

️🔄 azure-powershell inProgress [Detail]

_{Posted by Swagger Pipeline | How to fix these errors?}

[openapi-pipeline-app]

Generated ApiView

Language	Package Name	ApiView Link
Swagger	Microsoft.Databricks	https://apiview.dev/Assemblies/Review/f9d12b39de0149c788c5f4055531110f?revisionId=ba85f2e12e7d4dbdafd862d2edef3b5d