Partager via

Mettre à jour delegatedAdminRelationship

  • Article

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Mettez à jour les propriétés d’un objet delegatedAdminRelationship .

Les restrictions suivantes s’appliquent :

  • Vous pouvez mettre à jour cette relation lorsque sa propriété status est created.
  • Vous pouvez mettre à jour la propriété autoExtendDuration lorsque status a la valeur created ou active.
  • Vous ne pouvez supprimer le rôle administrateur général Microsoft Entra que lorsque la propriété status est active, ce qui indique une opération de longue durée.

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet
✅ ❌ ❌ ❌

Autorisations

Choisissez l’autorisation ou les autorisations marquées comme moins privilégiées pour cette API. Utilisez une autorisation ou des autorisations privilégiées plus élevées uniquement si votre application en a besoin. Pour plus d’informations sur les autorisations déléguées et d’application, consultez Types d’autorisations. Pour en savoir plus sur ces autorisations, consultez les informations de référence sur les autorisations.

Type d’autorisation Autorisations avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) DelegatedAdminRelationship.ReadWrite.All Non disponible.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application DelegatedAdminRelationship.ReadWrite.All Non disponible.

Importante

Pour appeler cette API à l’aide d’autorisations d’application, vous devez provisionner le principal de service identifié par appId2832473f-ec63-45fb-976f-5d45a7d4bb91 et nommé Partner Customer Delegated Administration dans le locataire partenaire. Pour approvisionner le principal de service dans le locataire partenaire, appelez l’API Create servicePrincipal .

Requête HTTP

PATCH /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationshipId}

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.
If-Match If-match : {etag}. Dernière valeur ETag connue pour le delegatedAdminRelationship à mettre à jour. Récupérez la valeur ETag d’une opération LIST ou GET. Obligatoire.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez uniquement les valeurs des propriétés à mettre à jour. Les propriétés existantes qui ne sont pas incluses dans le corps de la demande conservent leurs valeurs précédentes ou sont recalculées en fonction des modifications apportées à d’autres valeurs de propriété.

Le tableau suivant spécifie les propriétés qui peuvent être mises à jour.

Propriété Type Description
accessDetails delegatedAdminAccessDetails Identificateurs des rôles d’administration auxquels le partenaire demande ou a accès dans le locataire du client.
autoExtendDuration Durée Durée d’extension automatique de la validité de la relation, indiquée au format ISO 8601. Les valeurs prises en charge sont : P0D, PT0S, P180D. La valeur par défaut est PT0S. PT0S indique que la relation expire lorsque la valeur endDateTime est atteinte et qu’elle n’est pas automatiquement étendue.
client delegatedAdminRelationshipCustomerParticipant Nom complet et identificateur unique du client de la relation.
displayName String Nom complet de la relation utilisée pour faciliter l’identification. Doit être unique dans toutes les relations d’administration déléguées du partenaire. La longueur maximale est de 50 caractères.
durée Durée Durée de la relation au format ISO 8601. Doit être une valeur comprise entre P1D et P2Y inclusive.

Réponse

Si elle réussit, cette méthode retourne un 200 OK code de réponse ou .202 Accepted Le corps de la réponse contient un objet delegatedAdminRelationship lorsque la réponse est 200 OK.

En-têtes de réponse

Nom Description
Content-Type application/json.
Emplacement Emplacement de l’opération de longue durée.
Retry-After Durée après laquelle un appel d’API ultérieur peut être effectué à l’URL d’emplacement pour case activée la status de l’opération de longue durée.

Cette méthode retourne une 202 Accepted réponse si vous supprimez le rôle Administrateur général Microsoft Entra de la relation alors que sa propriété status est active. La réponse inclut une URL dans l’en-tête Location que vous pouvez utiliser pour surveiller la progression de l’opération.

Si vous ne fournissez pas l’ID de modèle qui correspond au rôle administrateur général Microsoft Entra dans le unifiedRoles tableau dans la accessDetails propriété du corps de la demande, l’API retourne 200 OK et l’objet delegatedAdminRelationship d’origine dans le corps de la réponse.

Exemples

Demande

L’exemple suivant illustre la demande.

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

Réponse

L’exemple suivant illustre la réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

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

Voici un exemple de réponse qui retourne un 202 Accepted code de réponse avec les en-têtes Location et Retry-After .

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

{
}