Operations related to /roleManagement/directory/roleAssignmentApprovals marked for deprecation in beta with no replacement

オープン
#832 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 2 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
25/100
issue の種類
バグ
明瞭さ
説明が足りない
活発さ
停滞
技術スタック
openapi

調査の方向性

/roleManagement/directory/roleAssignmentApprovals の Beta OpenAPI.yaml 定義から始め、それらの非推奨メタデータを Microsoft Graph の変更履歴および Entra ID approval-workflow のドキュメントと比較します。非推奨化が意図的なものかどうかを確認し、割り当てを承認または拒否するための置き換えを特定し、確認済みの指針または必要なメタデータ修正を文書化します。

索引モデルが issue の本文から書いたものです。

説明

ToTriage

Hi,

We found that many of the operations that relates to roleManagement/directory/roleAssignmentApprovals/ are marked for deprecation, but we can't find any suitable replacement for approving or denying role assignments in Entra ID Privileged Identity Management.

More to that, we also can't find any related announcement in Microsoft Graph changelog.

The Entra ID documentation also doesn't state anything about the deprecation of those paths and still indicates to use them for our use case.

Am I reading the deprecation notice wrong in the SDK and in the OpenAPI.yaml for the beta API. Is there any planned replacement for the same operation?

Here is an exemple of operation that is marked for deprecation with a removal date of 2025-12-01'

Thank you or your input on this :)

/roleManagement/directory/roleAssignmentApprovals/{approval-id}/steps/{approvalStep-id}':
    description: Provides operations to manage the steps property of the microsoft.graph.approval entity.
    get:
      tags:
        - roleManagement.rbacApplication
      summary: Get steps from roleManagement
      description: Used to represent the decision associated with a single step in the approval process configured in approvalStage.
      operationId: roleManagement.directory.roleAssignmentApprovals.GetSteps
      parameters:
        - name: $select
          in: query
          description: Select properties to be returned
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
        - name: $expand
          in: query
          description: Expand related entities
          style: form
          explode: false
          schema:
            uniqueItems: true
            type: array
            items:
              type: string
      responses:
        2XX:
          description: Retrieved navigation property
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.approvalStep'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      deprecated: true
      x-ms-deprecation:
        removalDate: '2025-12-01'
        date: '2025-01-01'
        version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
        description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
      x-ms-docs-operation-type: operation
    patch:
      tags:
        - roleManagement.rbacApplication
      summary: Update the navigation property steps in roleManagement
      operationId: roleManagement.directory.roleAssignmentApprovals.UpdateSteps
      requestBody:
        description: New navigation property values
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/microsoft.graph.approvalStep'
        required: true
      responses:
        2XX:
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/microsoft.graph.approvalStep'
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      deprecated: true
      x-ms-deprecation:
        removalDate: '2025-12-01'
        date: '2025-01-01'
        version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
        description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
      x-ms-docs-operation-type: operation
    delete:
      tags:
        - roleManagement.rbacApplication
      summary: Delete navigation property steps for roleManagement
      operationId: roleManagement.directory.roleAssignmentApprovals.DeleteSteps
      parameters:
        - name: If-Match
          in: header
          description: ETag
          schema:
            type: string
      responses:
        '204':
          description: Success
        4XX:
          $ref: '#/components/responses/error'
        5XX:
          $ref: '#/components/responses/error'
      deprecated: true
      x-ms-deprecation:
        removalDate: '2025-12-01'
        date: '2025-01-01'
        version: 2025-01/PrivatePreview:microsoft.applicationAuthorization
        description: This version is being deprecated and is scheduled for removal on 2025-12-01.Please migrate to the latest version before the removal date.
      x-ms-docs-operation-type: operation
    parameters:
      - name: approval-id
        in: path
        description: The unique identifier of approval
        required: true
        schema:
          type: string
        x-ms-docs-key-type: approval
      - name: approvalStep-id
        in: path
        description: The unique identifier of approvalStep
        required: true
        schema:
          type: string
        x-ms-docs-key-type: approvalStep
    x-ms-docs-grouped-path:
      - '/roleManagement/enterpriseApps/{rbacApplication-id}/roleAssignmentApprovals/{approval-id}/steps/{approvalStep-id}'
      - '/roleManagement/entitlementManagement/roleAssignmentApprovals/{approval-id}/steps/{approvalStep-id}'

主要言語
XSLT
スター
171
フォーク
56
平均マージ
1日 11時間
マージ済み PR(30日)
9

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

microsoftgraph/msgraph-metadata のほかの issue

microsoftgraph/msgraph-metadata の issue をすべて見る

似ている issue

Backend & API Design の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。