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

Aberta
#832 0 comentários 0 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 2 dias

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
25/100
Tipo de issue
Bug
Clareza
Precisa de esclarecimento
Status de atividade
Estagnada
Stack de tecnologia
openapi

Direção de pesquisa

Comece pelas definições Beta OpenAPI.yaml em /roleManagement/directory/roleAssignmentApprovals e compare os metadados de descontinuação delas com o changelog do Microsoft Graph e a documentação do Entra ID approval-workflow. Determine se a descontinuação é intencional, identifique alguma substituição para aprovar ou negar atribuições e documente as orientações confirmadas ou a correção de metadados necessária.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

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}'

Linguagem predominante
XSLT
Estrelas
171
Forks
56
Merge médio
1d 11h
PRs com merge (30d)
9

Preparar o ambiente

Este projeto não oferece contêiner de desenvolvimento, Dockerfile nem guia de contribuição, então a configuração fica por sua conta: comece pelo README e veja nosso guia da primeira contribuição para os passos gerais.

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de microsoftgraph/msgraph-metadata

Todas as issues de microsoftgraph/msgraph-metadata

Issues semelhantes

Mais issues de Backend & API Design

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.