[v3 wrappers] Support arbitrary optional query parameters

Đang mở
  • Có gì không ổn?
#3,897 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

@ramsessanchez đang làm issue này rồi.

Từ ngày 6/11/2026.

  • #3900 của @ramsessanchez — đang mở

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
35/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
csharp, powershell
Lĩnh vực
api, developer-experience

Hướng nghiên cứu

This is tracking only and names no implementation files or tests. Start by reading #3882 and the v3 generator's OpenAPI operation handling to map how query parameters reach generated cmdlets. Done means a follow-up covers optional parameters across supported operation families and methods, preserves existing behavior, and adds the listed generation and transport regressions.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

status:waiting-for-triage type:feature
Is your feature request related to a problem? Please describe the problem.

The v3 wrapper generator currently exposes a predefined set of optional OData query options where the operation and emitter support them, such as $filter, $select, $expand, $orderby, $search, $top, $skip, and $count.

Other optional query parameters declared in an operation's OpenAPI contract are not automatically exposed as cmdlet parameters, even when the generated Kiota client supports them. For example, an operation declaring an optional mode, locale, or includeArchived query cannot necessarily receive that input through its generated cmdlet. These names are illustrative, not claims about particular Graph endpoints.

The required-query work in #3882 is separate: it adds mandatory -Query<Name> inputs for required queries and deliberately does not broaden arbitrary optional-query support.

Describe the solution you'd like.

Track a future enhancement to generate and bind supported arbitrary optional query parameters from the effective OpenAPI operation contract across supported operation families and HTTP methods.

Acceptance criteria for that follow-up:

  • Expose optional inputs as nonmandatory cmdlet parameters and bind them through Kiota's typed query properties, preserving the API wire name and encoding.
  • Send an optional query only when the caller supplies it; preserve explicitly supplied false and 0 rather than treating them as omission. Define null/empty and array behavior consistently with the supported schema contract.
  • Honor inherited path-item parameters, operation-level overrides, supported types, and naming/collision rules. Consider the Query<Name> convention from #3882 for newly exposed inputs without breaking existing standard OData names and aliases or generating duplicates.
  • Preserve request bodies, headers, confirmation behavior, API-profile/cloud routing, and each operation's independent query contract, including PATCH refetch and pagination/delta continuation handling.
  • Add generated-code and compiled transport/binder regressions covering representative GET and mutation operations, omitted versus bound values, encoding, and collisions. Document any unsupported contracts explicitly.

This issue is tracking only. Do not implement as part of filing it or expand #3882 to include this work.

Additional context?

Parent release tracker: #3874 — Tracking for V3 Upgrade.

Related required-query work: #3882.

This is a v3 generator/API-coverage follow-up, not a claim that every optional query is currently unsupported. Existing supported optional OData behavior must remain intact. Track release disposition in the v3 upgrade issue; this filing alone does not classify the enhancement as a release blocker.

Ngôn ngữ chính
C#
Star
909
Fork
234
Merge trung bình
3 ngày 21 giờ
Pull request đã merge (30 ngày)
23

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của microsoftgraph/msgraph-sdk-powershell

Tất cả issue của microsoftgraph/msgraph-sdk-powershell

Issue tương tự

Thêm issue về C#

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.