Compartilhar via


Atualizar delegatedAdminRelationship

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Atualize as propriedades de um objeto delegatedAdminRelationship .

Aplicam-se as seguintes restrições:

  • Pode atualizar esta relação quando a respetiva propriedade status for created.
  • Pode atualizar a propriedade autoExtendDuration quando status é created ou active.
  • Só pode remover a função de Administrador Global Microsoft Entra quando a propriedade status for active, o que indica uma operação de execução prolongada.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) DelegatedAdminRelationship.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application DelegatedAdminRelationship.ReadWrite.All Indisponível.

Importante

Para chamar esta API através de permissões de aplicação, tem de aprovisionar o principal de serviço identificado por appId2832473f-ec63-45fb-976f-5d45a7d4bb91 e com o nome Administração Delegada de Cliente Parceiro no inquilino do parceiro. Para aprovisionar o principal de serviço no inquilino do parceiro, chame a API Create servicePrincipal .

Solicitação HTTP

PATCH /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationshipId}

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
If-Match If-match: {etag}. Último valor de ETag conhecido para a delegatedAdminRelationship a ser atualizada. Obtenha o valor ETag a partir de uma operação LIST ou GET. Obrigatório.
Content-Type application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça apenas os valores das propriedades a atualizar. As propriedades existentes que não estão incluídas no corpo do pedido mantêm os valores anteriores ou são recalculadas com base em alterações a outros valores de propriedade.

A tabela a seguir especifica as propriedades que podem ser atualizadas.

Propriedade Tipo Descrição
accessDetails delegatedAdminAccessDetails Os identificadores das funções administrativas a que o parceiro solicita ou tem acesso no inquilino do cliente.
autoExtendDuration Duração A duração pela qual a validade da relação é expandida automaticamente, indicada no formato ISO 8601. Os valores suportados são: P0D, PT0S, P180D. O valor padrão é PT0S. PT0S indica que a relação expira quando o endDateTime é atingido e não é expandido automaticamente.
cliente delegatedAdminRelationshipCustomerParticipant O nome a apresentar e o identificador exclusivo do cliente da relação.
displayName Cadeia de caracteres O nome a apresentar da relação utilizada para facilitar a identificação. Tem de ser exclusivo em todas as relações de administrador delegadas do parceiro. O comprimento máximo é de 50 carateres.
duração Duração A duração da relação no formato ISO 8601. Tem de ser um valor entre P1D e P2Y inclusive.

Resposta

Se for bem-sucedido, este método devolve um 200 OK ou um código de 202 Accepted resposta. O corpo da resposta contém um objeto delegatedAdminRelationship quando a resposta é 200 OK.

Cabeçalhos de resposta

Nome Descrição
Content-Type application/json.
Local A localização da operação de execução prolongada.
Retry-After O tempo após o qual pode ser efetuada uma chamada à API subsequente para o URL de Localização para marcar a status da operação de execução prolongada.

Este método devolve uma 202 Accepted resposta se remover a função de Administrador Global Microsoft Entra da relação enquanto a respetiva propriedade status é active. A resposta inclui um URL no cabeçalho Localização que pode utilizar para monitorizar o progresso da operação.

Se não fornecer o ID do modelo que corresponde à função de Administrador Global Microsoft Entra na unifiedRoles matriz na accessDetails propriedade do corpo do pedido, a API é devolvida 200 OK e o objeto delegatedAdminRelationship original no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra a solicitação.

PATCH https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836
If-Match: W/"JyI0NzAwNjg0NS0wMDAwLTE5MDAtMDAwMC02MGY0Yjg4MzAwMDAiJw=="
Content-Type: application/json

{
  "displayName": "Updated Contoso admin relationship",
  "duration": "P31D",
  "customer": {
    "tenantId": "52eaad04-13a2-4a2f-9ce8-93a294fadf36"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "44367163-eba1-44c3-98af-f5787879f96a"
      },
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "69091246-20e8-4a56-aa4d-066075b2a7a8"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.delegatedAdminRelationship",
  "@odata.context": "https://graph.microsoft.com/beta/tenantRelationships/$metadata#delegatedAdminRelationships/$entity",
  "@odata.etag": "W/\"JyIwMzAwZTM0ZS0wMDAwLTAyMDAtMDAwMC02MTRjZjI1YzAwMDAiJw==\"",
  "id": "5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836",
  "displayName": "Updated Contoso admin relationship",
  "duration": "P31D",
  "status": "created",
  "createdDateTime": "2022-02-10T11:24:42.3148266Z",
  "lastModifiedDateTime": "2022-02-10T11:26:44.9941884Z",
  "customer": {
    "tenantId": "52eaad04-13a2-4a2f-9ce8-93a294fadf36"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "44367163-eba1-44c3-98af-f5787879f96a"
      },
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "69091246-20e8-4a56-aa4d-066075b2a7a8"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

Segue-se uma resposta de exemplo que devolve um 202 Accepted código de resposta juntamente com os cabeçalhos Localização e Repetição Após .

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5e5594d3-6f82-458b-b567-77db4811f0cd-00000000-0000-0000-0000-000000001234/operations/d8dbb27b-7fe7-4523-a3df-f766355fe0f2
Retry-After: 10
Content-Type: application/json

{
}