Adding AvailabilityZone Field to Machine API #34906
Merged
openapi-pipeline-app / Swagger LintDiff
succeeded
May 27, 2025 in 4m 2s
Swagger LintDiff succeeded
Details
| Compared specs (v2.2.3) | new version | base version |
|---|---|---|
| package-2025-04 | package-2025-04(a0feb4c) | package-2025-04(dev-containerservice-Microsoft.ContainerService-2025-04-01) |
[must fix]The following errors/warnings are introduced by current PR:
| Rule | Message | Related RPC [For API reviewers] |
|---|---|---|
| Based on the response model schema, operation 'Machines_Get' might be pageable. Consider adding the x-ms-pageable extension. Location: aks/stable/2025-04-01/managedClusters.json#L3095 |
The following errors/warnings exist before current PR submission:
Only 50 items are listed, please refer to log for more details.
| Rule | Message |
|---|---|
OperationsApiResponseSchema |
The response schema of operations API '/providers/Microsoft.ContainerService/operations' does not match the ARM specification. Please standardize the schema. Location: aks/stable/2025-04-01/managedClusters.json#L52 |
OperationsApiSchemaUsesCommonTypes |
Operations API path must follow the schema provided in the common types. Location: aks/stable/2025-04-01/managedClusters.json#L53 |
XmsPageableForListCalls |
x-ms-pageable extension must be specified for LIST APIs.Location: aks/stable/2025-04-01/managedClusters.json#L74 |
GetCollectionOnlyHasValueAndNextLink |
Get endpoints for collections of resources must only have the value and nextLink properties in their model.Location: aks/stable/2025-04-01/managedClusters.json#L95 |
ResourceNameRestriction |
The resource name parameter 'roleName' should be defined with a 'pattern' restriction. Location: aks/stable/2025-04-01/managedClusters.json#L236 |
ParametersInPost |
server-fqdn is a query parameter. Post operation must not contain any query parameter other than api-version. Location: aks/stable/2025-04-01/managedClusters.json#L294 |
ParametersInPost |
server-fqdn is a query parameter. Post operation must not contain any query parameter other than api-version. Location: aks/stable/2025-04-01/managedClusters.json#L339 |
ParametersInPost |
format is a query parameter. Post operation must not contain any query parameter other than api-version. Location: aks/stable/2025-04-01/managedClusters.json#L339 |
ParametersInPost |
server-fqdn is a query parameter. Post operation must not contain any query parameter other than api-version. Location: aks/stable/2025-04-01/managedClusters.json#L387 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L527 |
PatchResponseCodes |
Long-running PATCH operations must have responses with 200, 202 and default return codes. They also must not have other response codes. Location: aks/stable/2025-04-01/managedClusters.json#L619 |
PatchIdentityProperty |
The patch operation body parameter schema should contain property 'identity'. Location: aks/stable/2025-04-01/managedClusters.json#L638 |
LroPatch202 |
The async patch operation should return 202. Location: aks/stable/2025-04-01/managedClusters.json#L656 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L666 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L721 |
ResourceNameRestriction |
The resource name parameter 'configName' should be defined with a 'pattern' restriction. Location: aks/stable/2025-04-01/managedClusters.json#L781 |
PostResponseCodes |
Long-running POST operations must have responses with 202 and default return codes. They must also have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. They also must not have other response codes. Location: aks/stable/2025-04-01/managedClusters.json#L951 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L995 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1163 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1284 |
XmsPageableForListCalls |
x-ms-pageable extension must be specified for LIST APIs.Location: aks/stable/2025-04-01/managedClusters.json#L1400 |
OperationIdNounVerb |
Per the Noun_Verb convention for Operation Ids, the noun 'AgentPools' should not appear after the underscore. Note: If you have already shipped an SDK on top of this spec, fixing this warning may introduce a breaking change. Location: aks/stable/2025-04-01/managedClusters.json#L1404 |
GetCollectionOnlyHasValueAndNextLink |
Get endpoints for collections of resources must only have the value and nextLink properties in their model.Location: aks/stable/2025-04-01/managedClusters.json#L1424 |
PostResponseCodes |
200 return code does not have a schema specified. LRO POST must have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. Location: aks/stable/2025-04-01/managedClusters.json#L1443 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1489 |
PostResponseCodes |
200 return code does not have a schema specified. LRO POST must have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. Location: aks/stable/2025-04-01/managedClusters.json#L1505 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1552 |
PostResponseCodes |
Long-running POST operations must have responses with 202 and default return codes. They must also have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. They also must not have other response codes. Location: aks/stable/2025-04-01/managedClusters.json#L1568 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1605 |
PostResponseCodes |
Long-running POST operations must have responses with 202 and default return codes. They must also have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. They also must not have other response codes. Location: aks/stable/2025-04-01/managedClusters.json#L1621 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1662 |
PostResponseCodes |
Long-running POST operations must have responses with 202 and default return codes. They must also have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. They also must not have other response codes. Location: aks/stable/2025-04-01/managedClusters.json#L1678 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1713 |
PostResponseCodes |
Long-running POST operations must have responses with 202 and default return codes. They must also have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. They also must not have other response codes. Location: aks/stable/2025-04-01/managedClusters.json#L1729 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1766 |
PostResponseCodes |
Long-running POST operations must have responses with 202 and default return codes. They must also have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. They also must not have other response codes. Location: aks/stable/2025-04-01/managedClusters.json#L1782 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L1819 |
XmsPageableForListCalls |
x-ms-pageable extension must be specified for LIST APIs.Location: aks/stable/2025-04-01/managedClusters.json#L1835 |
GetCollectionOnlyHasValueAndNextLink |
Get endpoints for collections of resources must only have the value and nextLink properties in their model.Location: aks/stable/2025-04-01/managedClusters.json#L1859 |
DeleteResponseCodes |
Long-running delete operations must have responses with 202, 204 and default return codes. They also must have no other response codes. Location: aks/stable/2025-04-01/managedClusters.json#L1988 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L2025 |
PostResponseCodes |
202 response for a LRO POST operation must not have a response schema specified. Location: aks/stable/2025-04-01/managedClusters.json#L2038 |
PostResponseCodes |
200 return code does not have a schema specified. LRO POST must have a 200 return code if only if the final response is intended to have a schema, if not the 200 return code must not be specified. Location: aks/stable/2025-04-01/managedClusters.json#L2038 |
LroLocationHeader |
A 202 response should include an Location response header. Location: aks/stable/2025-04-01/managedClusters.json#L2068 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L2081 |
XmsPageableForListCalls |
x-ms-pageable extension must be specified for LIST APIs.Location: aks/stable/2025-04-01/managedClusters.json#L2097 |
PrivateEndpointResourceSchemaValidation |
The private endpoint model 'PrivateLinkResourcesListResult' schema does not conform to the common type definition. Location: aks/stable/2025-04-01/managedClusters.json#L2119 |
GetCollectionOnlyHasValueAndNextLink |
Get endpoints for collections of resources must only have the value and nextLink properties in their model.Location: aks/stable/2025-04-01/managedClusters.json#L2121 |
LroErrorContent |
Error response content of long running operations must follow the error schema provided in the common types v2 and above. Location: aks/stable/2025-04-01/managedClusters.json#L2240 |
RequiredPropertiesMissingInResourceModel |
Model definition 'OperationListResult' must have the properties 'name', 'id' and 'type' in its hierarchy and these properties must be marked as readonly. Location: aks/stable/2025-04-01/managedClusters.json#L3144 |
Loading