[Azure Digital Twins ] API Review

[azure-sdk]

New API Review meeting has been requested.

Service Name: Azure Digital Twins
Review Created By: Rachel Teitelbaum
Review Date: 09/05/2023 01:00 PM PT
Onboarding Record:
PR:
Hero Scenarios Link: Not Provided
Core Concepts Doc Link: Not Provided

Description: Would like to take our private previewed Bulk Delete API to GA on an accelerated timeline

Detailed meeting information and documents provided can be accessed here
For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[azure-sdk]

Meeting updated by Rachel Teitelbaum

Service Name: Azure Digital Twins
Review Created By: Rachel Teitelbaum
Review Date: 09/13/2023 09:00 AM PT
Onboarding Record:
PR:
Hero Scenarios Link: Not Provided
Core Concepts Doc Link: Not Provided

Description: Would like to take our private previewed Bulk Delete API to GA on an accelerated timeline

Detailed meeting information and documents provided can be accessed here
For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[azure-sdk]

Meeting updated by Rachel Teitelbaum

Service Name: Azure Digital Twins
Review Created By: Rachel Teitelbaum
Review Date: 09/13/2023 09:00 AM PT
Onboarding Record:
PR: #25746
Hero Scenarios Link: Not Provided
Core Concepts Doc Link: Not Provided

Description: Would like to take our private previewed Bulk Delete API to General Availability. No major API changes from private preview to GA at the moment.

Detailed meeting information and documents provided can be accessed here
For more information that will help prepare you for this review, the requirements, and office hours, visit the documentation here

[mikekistler]

Notes from API Review meeting, 9/13/23

API is essentially unchanged from private preview. [PR 12803]

Discussed during the meeting:

• Why use POST rather than PUT to create the delete job?
• What customer feedback did you get from private preview?
• If we have /jobs/imports collection, should the delete collection then also be called /jobs/deletesin plural?
• Have any customers used SDKs for this new feature?
• Why delete on /jobs/imports but not on /jobs/delete ?
• Need better documentation! When to use delete vs cancel.
• Using the same API pattern for imports and deletes will make it easier on users
  • PUT will be easier for idempotency as well
• "deletions" is a better option than "delete"
  • "/jobs/deletions"