Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fixing migrate swagger issues #9949

Merged
merged 6 commits into from
Jul 21, 2020
Merged

Conversation

shsingla
Copy link
Contributor

MSFT employees can try out our new experience at OpenAPI Hub - one location for using our validation tools and finding your workflow.

Contribution checklist:

If any further question about AME onboarding or validation tools, please view the FAQ.

ARM API Review Checklist

  • Service team MUST add the "WaitForARMFeedback" label if the management plane API changes fall into one of the below categories.
    • adding/removing APIs.
    • adding/removing properties.
    • adding/removing API-version.
    • adding a new service in Azure.

Failure to comply may result in delays for manifest application. Note this does not apply to data plane APIs.

  • If you are blocked on ARM review and want to get the PR merged urgently, please get the ARM oncall for reviews (RP Manifest Approvers team under Azure Resource Manager service) from IcM and reach out to them.
    Please follow the link to find more details on API review process.

@AutorestCI
Copy link

You don't have permission to trigger SDK Automation.
Please add yourself to Azure group from opensource portal if you are MSFT employee,
or please ask reviewer to add comment *** /openapibot sdkautomation ***.
Please ask [email protected] (or NullMDR in github) for additional help.

@openapi-pipeline-app
Copy link

openapi-pipeline-app bot commented Jun 24, 2020

[Staging] Swagger Validation Report

BreakingChange: 5 Errors, 0 Warnings [Detail] [Expand]
Rule Message
1007 - RemovedClientParameter The new version is missing a client parameter that was found in the old version. Was 'acceptLanguage' removed or renamed?
New: Microsoft.Migrate/stable/2019-10-01/migrate.json#L22:3
Old: Microsoft.Migrate/stable/2019-10-01/migrate.json#L22:3
1008 - ModifiedOperationId The operation id has been changed from 'Project_AssessmentOptions' to 'Projects_AssessmentOptions'. This will impact generated code.
New: Microsoft.Migrate/stable/2019-10-01/migrate.json#L2471:7
Old: Microsoft.Migrate/stable/2019-10-01/migrate.json#L2490:7
1008 - ModifiedOperationId The operation id has been changed from 'Project_AssessmentOptionsList' to 'Projects_AssessmentOptionsList'. This will impact generated code.
New: Microsoft.Migrate/stable/2019-10-01/migrate.json#L2520:7
Old: Microsoft.Migrate/stable/2019-10-01/migrate.json#L2542:7
1041 - AddedPropertyInResponse The new version has a new property 'nextLink' in response that was not found in the old version.
New: Microsoft.Migrate/stable/2019-10-01/migrate.json#L1790:7
Old: Microsoft.Migrate/stable/2019-10-01/migrate.json#L1796:7
1041 - AddedPropertyInResponse The new version has a new property 'nextLink' in response that was not found in the old version.
New: Microsoft.Migrate/stable/2019-10-01/migrate.json#L1790:7
Old: Microsoft.Migrate/stable/2019-10-01/migrate.json#L1796:7
️✔️LintDiff [Detail]
 Validation passes for LintDiff. 
️✔️Avocado [Detail]
 Validation passes for Avocado. 
Posted by Swagger Pipeline | How to fix these errors?

@azuresdkci
Copy link
Contributor

Can one of the admins verify this patch?

@fengzhou-msft
Copy link
Member

/azp run

@azure-pipelines
Copy link

Azure Pipelines successfully started running 3 pipeline(s).

@fengzhou-msft fengzhou-msft added the WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required label Jun 25, 2020
@openapi-sdkautomation
Copy link

openapi-sdkautomation bot commented Jun 25, 2020

azure-sdk-for-python - Release

No readme.md specification configuration files were found that are associated with the files modified in this pull request, or swagger_to_sdk section in readme.md is not configured

@openapi-sdkautomation
Copy link

openapi-sdkautomation bot commented Jun 25, 2020

azure-sdk-for-go - Release

️✔️ succeeded [Logs] [Expand Details]

@openapi-sdkautomation
Copy link

openapi-sdkautomation bot commented Jun 25, 2020

azure-sdk-for-java - Release

No readme.md specification configuration files were found that are associated with the files modified in this pull request, or swagger_to_sdk section in readme.md is not configured

@openapi-sdkautomation
Copy link

openapi-sdkautomation bot commented Jun 25, 2020

Trenton Generation - Release

No readme.md specification configuration files were found that are associated with the files modified in this pull request, or swagger_to_sdk section in readme.md is not configured

@openapi-sdkautomation
Copy link

openapi-sdkautomation bot commented Jun 25, 2020

azure-sdk-for-js - Release

️✔️ succeeded [Logs] [Expand Details]
  • ️✔️ Generate from 4d61e0a with merge commit 23e12a4. SDK Automation 13.0.17.20200619.4
  • ️✔️@azure/arm-migrate [View full logs]  [Release SDK Changes]
    Only show 100 items here, please refer to log for details.
    [npmPack] npm WARN deprecated [email protected]: This package has been deprecated and is no longer maintained. Please use @rollup/plugin-node-resolve.
    [npmPack] npm WARN deprecated [email protected]: https://github.com/lydell/resolve-url#deprecated
    [npmPack] npm WARN deprecated [email protected]: Please see https://github.com/lydell/urix#deprecated
    [npmPack] npm notice created a lockfile as package-lock.json. You should commit this file.
    [npmPack] loaded rollup.config.js with warnings
    [npmPack] (!) Unused external imports
    [npmPack] default imported from external module 'rollup' but never used
    [npmPack] 
    [npmPack] ./esm/azureMigrateV2.js → ./dist/arm-migrate.js...
    [npmPack] created ./dist/arm-migrate.js in 520ms
    [npmPack] npm notice 
    [npmPack] npm notice package: @azure/[email protected]
    [npmPack] npm notice === Tarball Contents === 
    [npmPack] npm notice 155.7kB dist/arm-migrate.js                        
    [npmPack] npm notice 57.0kB  dist/arm-migrate.min.js                    
    [npmPack] npm notice 4.7kB   esm/operations/assessedMachines.js         
    [npmPack] npm notice 921B    esm/models/assessedMachinesMappers.js      
    [npmPack] npm notice 8.9kB   esm/operations/assessments.js              
    [npmPack] npm notice 1.0kB   esm/models/assessmentsMappers.js           
    [npmPack] npm notice 1.9kB   esm/azureMigrateV2.js                      
    [npmPack] npm notice 2.5kB   esm/azureMigrateV2Context.js               
    [npmPack] npm notice 7.1kB   esm/operations/groups.js                   
    [npmPack] npm notice 987B    esm/models/groupsMappers.js                
    [npmPack] npm notice 6.2kB   esm/operations/hyperVCollectors.js         
    [npmPack] npm notice 974B    esm/models/hyperVCollectorsMappers.js      
    [npmPack] npm notice 345B    esm/models/index.js                        
    [npmPack] npm notice 602B    esm/operations/index.js                    
    [npmPack] npm notice 4.0kB   esm/operations/machines.js                 
    [npmPack] npm notice 886B    esm/models/machinesMappers.js              
    [npmPack] npm notice 67.2kB  esm/models/mappers.js                      
    [npmPack] npm notice 1.5kB   esm/operations/operations.js               
    [npmPack] npm notice 455B    esm/models/operationsMappers.js            
    [npmPack] npm notice 3.2kB   esm/models/parameters.js                   
    [npmPack] npm notice 11.7kB  esm/operations/projects.js                 
    [npmPack] npm notice 1.1kB   esm/models/projectsMappers.js              
    [npmPack] npm notice 974B    rollup.config.js                           
    [npmPack] npm notice 6.2kB   esm/operations/vMwareCollectors.js         
    [npmPack] npm notice 974B    esm/models/vMwareCollectorsMappers.js      
    [npmPack] npm notice 1.6kB   package.json                               
    [npmPack] npm notice 457B    tsconfig.json                              
    [npmPack] npm notice 357.8kB dist/arm-migrate.js.map                    
    [npmPack] npm notice 45.7kB  dist/arm-migrate.min.js.map                
    [npmPack] npm notice 2.0kB   esm/operations/assessedMachines.d.ts.map   
    [npmPack] npm notice 2.6kB   esm/operations/assessedMachines.js.map     
    [npmPack] npm notice 501B    esm/models/assessedMachinesMappers.d.ts.map
    [npmPack] npm notice 514B    esm/models/assessedMachinesMappers.js.map  
    [npmPack] npm notice 3.6kB   esm/operations/assessments.d.ts.map        
    [npmPack] npm notice 5.0kB   esm/operations/assessments.js.map          
    [npmPack] npm notice 553B    esm/models/assessmentsMappers.d.ts.map     
    [npmPack] npm notice 566B    esm/models/assessmentsMappers.js.map       
    [npmPack] npm notice 861B    esm/azureMigrateV2.d.ts.map                
    [npmPack] npm notice 1.1kB   esm/azureMigrateV2.js.map                  
    [npmPack] npm notice 494B    esm/azureMigrateV2Context.d.ts.map         
    [npmPack] npm notice 1.4kB   esm/azureMigrateV2Context.js.map           
    [npmPack] npm notice 2.8kB   esm/operations/groups.d.ts.map             
    [npmPack] npm notice 4.2kB   esm/operations/groups.js.map               
    [npmPack] npm notice 540B    esm/models/groupsMappers.d.ts.map          
    [npmPack] npm notice 553B    esm/models/groupsMappers.js.map            
    [npmPack] npm notice 2.3kB   esm/operations/hyperVCollectors.d.ts.map   
    [npmPack] npm notice 3.5kB   esm/operations/hyperVCollectors.js.map     
    [npmPack] npm notice 527B    esm/models/hyperVCollectorsMappers.d.ts.map
    [npmPack] npm notice 540B    esm/models/hyperVCollectorsMappers.js.map  
    [npmPack] npm notice 28.3kB  esm/models/index.d.ts.map                  
    [npmPack] npm notice 290B    esm/operations/index.d.ts.map              
    [npmPack] npm notice 126B    esm/models/index.js.map                    
    [npmPack] npm notice 305B    esm/operations/index.js.map                
    [npmPack] npm notice 1.7kB   esm/operations/machines.d.ts.map           
    [npmPack] npm notice 2.4kB   esm/operations/machines.js.map             
    [npmPack] npm notice 485B    esm/models/machinesMappers.d.ts.map        
    [npmPack] npm notice 498B    esm/models/machinesMappers.js.map          
    [npmPack] npm notice 3.5kB   esm/models/mappers.d.ts.map                
    [npmPack] npm notice 37.4kB  esm/models/mappers.js.map                  
    [npmPack] npm notice 664B    esm/operations/operations.d.ts.map         
    [npmPack] npm notice 867B    esm/operations/operations.js.map           
    [npmPack] npm notice 215B    esm/models/operationsMappers.d.ts.map      
    [npmPack] npm notice 228B    esm/models/operationsMappers.js.map        
    [npmPack] npm notice 782B    esm/models/parameters.d.ts.map             
    [npmPack] npm notice 2.4kB   esm/models/parameters.js.map               
    [npmPack] npm notice 4.5kB   esm/operations/projects.d.ts.map           
    [npmPack] npm notice 7.0kB   esm/operations/projects.js.map             
    [npmPack] npm notice 576B    esm/models/projectsMappers.d.ts.map        
    [npmPack] npm notice 589B    esm/models/projectsMappers.js.map          
    [npmPack] npm notice 2.3kB   esm/operations/vMwareCollectors.d.ts.map   
    [npmPack] npm notice 3.5kB   esm/operations/vMwareCollectors.js.map     
    [npmPack] npm notice 526B    esm/models/vMwareCollectorsMappers.d.ts.map
    [npmPack] npm notice 539B    esm/models/vMwareCollectorsMappers.js.map  
    [npmPack] npm notice 3.1kB   README.md                                  
    [npmPack] npm notice 6.7kB   esm/operations/assessedMachines.d.ts       
    [npmPack] npm notice 11.0kB  src/operations/assessedMachines.ts         
    [npmPack] npm notice 611B    esm/models/assessedMachinesMappers.d.ts    
    [npmPack] npm notice 927B    src/models/assessedMachinesMappers.ts      
    [npmPack] npm notice 12.0kB  esm/operations/assessments.d.ts            
    [npmPack] npm notice 20.5kB  src/operations/assessments.ts              
    [npmPack] npm notice 724B    esm/models/assessmentsMappers.d.ts         
    [npmPack] npm notice 1.1kB   src/models/assessmentsMappers.ts           
    [npmPack] npm notice 1.2kB   esm/azureMigrateV2.d.ts                    
    [npmPack] npm notice 2.1kB   src/azureMigrateV2.ts                      
    [npmPack] npm notice 791B    esm/azureMigrateV2Context.d.ts             
    [npmPack] npm notice 2.3kB   src/azureMigrateV2Context.ts               
    [npmPack] npm notice 8.2kB   esm/operations/groups.d.ts                 

@openapi-sdkautomation
Copy link

openapi-sdkautomation bot commented Jun 25, 2020

Azure CLI Extension Generation - Release

No readme.md specification configuration files were found that are associated with the files modified in this pull request, or swagger_to_sdk section in readme.md is not configured

@openapi-sdkautomation
Copy link

openapi-sdkautomation bot commented Jun 25, 2020

azure-sdk-for-python-track2 - Release

No readme.md specification configuration files were found that are associated with the files modified in this pull request, or swagger_to_sdk section in readme.md is not configured

@openapi-sdkautomation
Copy link

openapi-sdkautomation bot commented Jun 25, 2020

azure-sdk-for-net - Release

No readme.md specification configuration files were found that are associated with the files modified in this pull request, or swagger_to_sdk section in readme.md is not configured

Fixing some more things.
@@ -2209,9 +2202,6 @@
}
}
},
"x-ms-pageable": {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this API is pageable. ARM will return a nextLink if one of your regional endpoints doesn't respond in time or has a retryable error.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

applies to any collection GETs on tracked reosurces

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nextLinkName should be specified (and equal "nextLink") and the response in the subscription and resource group level collection GETs should return a nextLink property (the definition does not contain it right now). Your RP doesn't control whether ARM returns a nextLink here or not and the SDK should be set up to follow it if it is returned.

@@ -2580,9 +2546,6 @@
}
}
},
"x-ms-pageable": {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why are you removing x-ms-pageable from your proxy resource collection GETs? You can keep this even if you never return a nextLink value. If your definition doesn't have a "nextLink" property "nextLinkName" can be null. https://github.com/Azure/autorest/blob/master/docs/extensions/readme.md#x-ms-pageable

@pilor pilor added ARMChangesRequested <valid label in PR review process>add this label when require changes after ARM review and removed WaitForARMFeedback <valid label in PR review process> add this label when ARM review is required labels Jul 2, 2020
Taking commenst.
@@ -2209,9 +2202,6 @@
}
}
},
"x-ms-pageable": {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nextLinkName should be specified (and equal "nextLink") and the response in the subscription and resource group level collection GETs should return a nextLink property (the definition does not contain it right now). Your RP doesn't control whether ARM returns a nextLink here or not and the SDK should be set up to follow it if it is returned.

Taking comments
@pilor pilor added ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review and removed ARMChangesRequested <valid label in PR review process>add this label when require changes after ARM review labels Jul 16, 2020
@fengzhou-msft fengzhou-msft added Approved-BreakingChange DO NOT USE! OBSOLETE label. See https://github.com/Azure/azure-sdk-tools/issues/6374 and removed BreakingChangeReviewRequired labels Jul 21, 2020
@fengzhou-msft
Copy link
Member

/azp run automation - sdk

@azure-pipelines
Copy link

Azure Pipelines successfully started running 1 pipeline(s).

@fengzhou-msft fengzhou-msft merged commit 23e12a4 into Azure:master Jul 21, 2020
00Kai0 pushed a commit to 00Kai0/azure-rest-api-specs that referenced this pull request Oct 12, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Approved-BreakingChange DO NOT USE! OBSOLETE label. See https://github.com/Azure/azure-sdk-tools/issues/6374 ARMSignedOff <valid label in PR review process>add this label when ARM approve updates after review
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants