I see. thanks. but actually this api can meet the requirement.
by the way, I prefer to discuss API changes in the design doc instead of this PR. Otherwise, we'll have a long-time review and never commit it.