Face API calls JSON "required" body parameter

[jxu]

https://learn.microsoft.com/en-us/python/api/azure-ai-vision-face/azure.ai.vision.face.operations.largepersongroupoperations?view=azure-python-preview#azure-ai-vision-face-operations-largepersongroupoperations-create-person

The parameter body says in its description "Required.", but doesn't have a red asterisk. I tried passing the keyword-only parameters without body and it worked fine. So all the JSON body parameters for these functions should be clarified what "Required" means.

[github-actions]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @dipidoo @JinyuID @SteveMSFT.

[github-actions]

Hi @jxu, I'm an AI Support assistant here to help with your issue. While the Azure SDK team reviews your request, I wanted to provide some possible tips and documentation that might help you in the meantime.

• The "Required" label comes from the service specification, and in some operations the body is mandatory by design even though the generated signature (via Autorest) doesn’t add a red asterisk.
• This behavior is consistent with other Azure SDK operations—for example, see the discussion on required parameters and the reasoning behind it in the Azure SDK for Python issue #10646 and the corresponding README.
• In this context, "Required" means that the JSON body should be considered an integral part of the request payload, even if some internal defaults exist when the parameter is omitted, as hinted by similar changes noted in changelogs (e.g. PowerBI Embedded CHANGELOG).
• For guidance on how operations are structured (including required parameters), you might review the Azure AI Face client library README and relevant samples such as the sample_verify_and_identify_from_large_person_group.py.

The Azure SDK team will respond to your issue shortly. I hope these suggestions are helpful in the meantime. If this comment helped you, please give it a 👍. If the suggestion was not helpful or incorrect, please give it a 👎. Your feedback helps us improve!

[jxu]

I don't want and never wanted AI chatbot responses to issues. None of the links are helpful.