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 .
Vous pouvez mettre à jour cette relation lorsque sa propriété status est created.
Vous pouvez mettre à jour la propriété autoExtendDuration lorsque l’état est ou createdactive.
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.
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 .
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 qui doivent être mises à 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.
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.
Nom complet et identificateur unique du client de la relation.
displayName
Chaîne
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
Heure après laquelle un appel d’API ultérieur peut être effectué à l’URL d’emplacement pour vérifier l’état 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é d’état 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.
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Beta.Models;
var requestBody = new DelegatedAdminRelationship
{
DisplayName = "Updated Contoso admin relationship",
Duration = TimeSpan.Parse("P31D"),
Customer = new DelegatedAdminRelationshipCustomerParticipant
{
TenantId = "52eaad04-13a2-4a2f-9ce8-93a294fadf36",
},
AccessDetails = new DelegatedAdminAccessDetails
{
UnifiedRoles = new List<UnifiedRole>
{
new UnifiedRole
{
RoleDefinitionId = "44367163-eba1-44c3-98af-f5787879f96a",
},
new UnifiedRole
{
RoleDefinitionId = "29232cdf-9323-42fd-ade2-1d097af3e4de",
},
new UnifiedRole
{
RoleDefinitionId = "69091246-20e8-4a56-aa4d-066075b2a7a8",
},
new UnifiedRole
{
RoleDefinitionId = "3a2c62db-5318-420d-8d74-23affee5d9d5",
},
},
},
AutoExtendDuration = TimeSpan.Parse("P180D"),
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.TenantRelationships.DelegatedAdminRelationships["{delegatedAdminRelationship-id}"].PatchAsync(requestBody, (requestConfiguration) =>
{
requestConfiguration.Headers.Add("If-Match", "W/\"JyI0NzAwNjg0NS0wMDAwLTE5MDAtMDAwMC02MGY0Yjg4MzAwMDAiJw==\"");
});
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.