Add docstring to indicate only one agent_pool_profile can be in the list

[WebSpider]

Enhance documentation so limit of one agent_pool_profile per managed_cluster is more clear

[codecov-io]

Codecov Report

Merging #3256 into master will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##           master    #3256   +/-   ##
=======================================
  Coverage    55.2%    55.2%           
=======================================
  Files        9198     9198           
  Lines      184891   184891           
=======================================
  Hits       102070   102070           
  Misses      82821    82821

Impacted Files	Coverage Δ
...re/mgmt/containerservice/models/managed_cluster.py	27.77% <ø> (ø)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 4a76ec8...cbac577. Read the comment docs.

[azuresdkci]

Can one of the admins verify this patch?

[lmazuel]

@mboersma ?

[mboersma]

Yes, this is a good clarification--thanks! Only one AKS node (agent) pool is supported currently.

But shouldn't we make this change here, in the Swagger spec so it propagates to all the SDKs?

[WebSpider]

I can pr there, no problem

[lmazuel]

Yes @mboersma , it has to be done in the Swagger. But at first I wasn't even sure it was accurate :). Could you fix the Swagger and link this issue? Thanks!

[mboersma]

Swagger PR opened at Azure/azure-rest-api-specs#3835.

[lmazuel]

Done in #3298