Skip to content

Updating api summaries for discovery services#33828

Merged
weidongxu-microsoft merged 17 commits into
Azure:mainfrom
eladschartz:eladschwartz/updating-api-code-lifecycle-docs
Jun 4, 2025
Merged

Updating api summaries for discovery services#33828
weidongxu-microsoft merged 17 commits into
Azure:mainfrom
eladschartz:eladschwartz/updating-api-code-lifecycle-docs

Fixing typspec supressions tool name

6faf1ea
Select commit
Loading
Failed to load commit list.
openapi-pipeline-app / Swagger LintDiff completed Jun 3, 2025 in 2m 31s

Swagger LintDiff failed

LintDiff: 12 Errors, 173 Warnings
The check status is neutral due to the check being suppressed by the label Approved-LintDiff.
View Azure DevOps build log for more details.

Details

[must fix]The following errors/warnings are introduced by current PR:

Rule Message Related RPC [For API reviewers]
AutoRest exception "tag":"package-2023-05-01-preview",
"details":"Process() cancelled due to failure"
AutoRest exception "tag":"package-2023-05-01-preview",
"details":"!Error: Operation response '/paths/1products1id/get/responses/200' produces type couldn't be resolved. Operation is probably is missing a produces field and there isn't any global value. Please add "produces": []""
AutoRest exception "tag":"package-2023-05-01-preview",
"details":"stack: Error: Operation response '/paths/1products1id/get/responses/200' produces type couldn't be resolved. Operation is probably is missing a produces field and there isn't any global value. Please add "produces": []" at Oai2ToOai3.visitResponse (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:11923:23) at Oai2ToOai3.visitResponses (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:11903:28) at Oai2ToOai3.visitOperation (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:11699:32) at runNextTicks (node:internal/process/task_queues:65:5) at processImmediate (node:internal/timers:453:9) at Oai2ToOai3.visitPath (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:11652:21) at Oai2ToOai3.visitPaths (/home/cloudtest/.autorest/@autorest_core@3.1"
AutoRest exception "tag":"package-2023-05-01-preview",
"details":"Autorest completed with an error. If you think the error message is unclear,
or is a bug,
please declare an issues at https://github.com/Azure/autorest/issues with the error message you are seeing."
AutoRest exception "tag":"package-2023-01-01-preview",
"details":"Process() cancelled due to failure"
AutoRest exception "tag":"package-2023-01-01-preview",
"details":"!Error: Operation response '/paths/1products1id/get/responses/200' produces type couldn't be resolved. Operation is probably is missing a produces field and there isn't any global value. Please add "produces": []""
AutoRest exception "tag":"package-2023-01-01-preview",
"details":"stack: Error: Operation response '/paths/1products1id/get/responses/200' produces type couldn't be resolved. Operation is probably is missing a produces field and there isn't any global value. Please add "produces": []" at Oai2ToOai3.visitResponse (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:11923:23) at Oai2ToOai3.visitResponses (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:11903:28) at Oai2ToOai3.visitOperation (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:11699:32) at runNextTicks (node:internal/process/task_queues:65:5) at processImmediate (node:internal/timers:453:9) at Oai2ToOai3.visitPath (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:11652:21) at Oai2ToOai3.visitPaths (/home/cloudtest/.autorest/@autorest_core@3.1"
AutoRest exception "tag":"package-2023-01-01-preview",
"details":"Autorest completed with an error. If you think the error message is unclear,
or is a bug,
please declare an issues at https://github.com/Azure/autorest/issues with the error message you are seeing."
AutoRest exception "tag":"package-2023-01-01-preview",
"details":"Process() cancelled due to failure"
AutoRest exception "tag":"package-2023-01-01-preview",
"details":"!Error: $ref to original location 'file:///mnt/vss/_work/1/azure-rest-api-specs/specification/marketplacecatalog/data-plane/Search/preview/2023-01-01-preview/search.json#/definitions/AzureBenefit' is not found in the new refs collection"
AutoRest exception "tag":"package-2023-01-01-preview",
"details":"stack: Error: $ref to original location 'file:///mnt/vss/_work/1/azure-rest-api-specs/specification/marketplacecatalog/data-plane/Search/preview/2023-01-01-preview/search.json#/definitions/AzureBenefit' is not found in the new refs collection at Deduplicator.updateRefs (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:9495:31) at Deduplicator.updateRefs (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:9499:22) at Deduplicator.updateRefs (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:9499:22) at Deduplicator.updateRefs (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:9499:22) at Deduplicator.deduplicateComponent (/home/cloudtest/.autorest/@autorest_core@3.10.7/node_modules/@autorest/core/dist/src_lib_autorest-core_ts.js:9427:42) at runNextTicks (node:i"
AutoRest exception "tag":"package-2023-01-01-preview",
"details":"Autorest completed with an error. If you think the error message is unclear,
or is a bug,
please declare an issues at https://github.com/Azure/autorest/issues with the error message you are seeing."


The following errors/warnings exist before current PR submission:
Only 50 items are listed, please refer to log for more details.

Rule Message
⚠️ ErrorResponse Error response schema should contain an object property named error.
Location: Search/preview/2023-01-01-preview/search.json#L349
⚠️ ErrorResponse Error response schema should contain an object property named error.
Location: Search/preview/2023-01-01-preview/search.json#L758
⚠️ ListInOperationName Since operation response has model definition in array type, it should be of the form '_list'.
Location: Search/preview/2023-01-01-preview/search.json#L772
⚠️ PageableOperation Based on the response model schema, operation 'Suggestions_GetProducts' might be pageable. Consider adding the x-ms-pageable extension.
Location: Search/preview/2023-01-01-preview/search.json#L772
⚠️ PaginationResponse Operation might be pageable. Consider adding the x-ms-pageable extension.
Location: Search/preview/2023-01-01-preview/search.json#L772
⚠️ ErrorResponse Error response schema should contain an object property named error.
Location: Search/preview/2023-01-01-preview/search.json#L1090
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1146
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1579
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1594
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1602
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1614
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1691
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1769
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1777
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1785
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Search/preview/2023-01-01-preview/search.json#L1812
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1842
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Search/preview/2023-01-01-preview/search.json#L1854
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1912
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1973
⚠️ PropertyType Property should have a defined type.
Location: Search/preview/2023-01-01-preview/search.json#L1993
⚠️ PathParameterSchema Path parameter should specify a maximum length (maxLength) and characters allowed (pattern).
Location: Products/preview/2023-01-01-preview/products.json#L28
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L57
⚠️ ParameterNamesConvention header parameter name 'X-API-Key' should be kebab case.
Location: Products/preview/2023-01-01-preview/products.json#L76
⚠️ SchemaTypeAndFormat Schema with type: number should specify format
Location: Products/preview/2023-01-01-preview/products.json#L85
⚠️ SchemaTypeAndFormat Schema with type: number should specify format
Location: Products/preview/2023-01-01-preview/products.json#L85
⚠️ PageableOperation Based on the response model schema, operation 'PublicProducts_List' might be pageable. Consider adding the x-ms-pageable extension.
Location: Products/preview/2023-01-01-preview/products.json#L105
⚠️ PaginationResponse Operation might be pageable. Consider adding the x-ms-pageable extension.
Location: Products/preview/2023-01-01-preview/products.json#L105
⚠️ ParameterNamesConvention header parameter name 'X-API-Key' should be kebab case.
Location: Products/preview/2023-01-01-preview/products.json#L189
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L291
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L306
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L314
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L326
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L392
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L430
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L446
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L450
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L454
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L462
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L478
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L563
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L571
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L575
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L743
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L751
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L759
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L786
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L816
⚠️ EnumInsteadOfBoolean Booleans properties are not descriptive in all cases and can make them to use, evaluate whether is makes sense to keep the property as boolean or turn it into an enum.
Location: Products/preview/2023-01-01-preview/products.json#L828
⚠️ PropertyType Property should have a defined type.
Location: Products/preview/2023-01-01-preview/products.json#L885