Mettre à jour une stratégie SelfServePolicy

Article
03/19/2024

Cet article explique comment mettre à jour une stratégie en libre-service.

Prérequis

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification Application+Utilisateur.

C#

Pour mettre à jour une stratégie en libre-service :

Appelez la méthode IAggregatePartner.SelfServePolicies.ById avec l’identificateur d’entité pour récupérer une interface aux opérations sur les stratégies.
Appelez la méthode Put ou PutAsync pour mettre à jour la stratégie en libre-service.

// IAggregatePartner partnerOperations;
SelfServePolicy policy;

// All the operations executed on this partner operation instance will share the same correlation identifier but will differ in request identifier
IPartner scopedPartnerOperations = partnerOperations.With(RequestContextFactory.Instance.Create(Guid.NewGuid()));

// updates the self-serve policies
partnerOperations.SelfServePolicies.ById(policy.id).Put(policy);

Demande REST

Syntaxe de la requête

Méthode	URI de demande
PUT	{baseURL}/v1/SelfServePolicy HTTP/1.1

En-têtes de requête

Un identificateur de demande et un identificateur de corrélation sont requis.
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

Ce tableau décrit les propriétés requises dans le corps de la demande.

Nom	Type	Description
SelfServePolicy	object	Informations de stratégie en libre-service.

SelfServePolicy

Ce tableau décrit les champs minimum requis de la ressource SelfServePolicy nécessaires pour créer une stratégie libre-service.

Propriété	Type	Description
id	string	Identificateur de stratégie en libre-service fourni lors de la création réussie de la stratégie en libre-service.
SelfServeEntity	SelfServeEntity	Entité libre-service à laquelle l’accès est accordé.
Fournisseur d'autorisations	Fournisseur d'autorisations	Le bénéficiaire qui accorde l’accès.
Autorisations	Tableau de Permission	Tableau de ressources d’autorisation .
Etag	string	L’Etag.

Exemple de requête

PUT https://api.partnercenter.microsoft.com/v1/SelfServePolicy HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

{
    "id": "634f6379-ad54-449b-9821-564f737158ab_0431a72c-7d8a-4393-b25e-ef63f5efb415",
    "selfServeEntity": {
        "selfServeEntityType": "customer",
        "tenantID": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
    },
    "grantor": {
        "grantorType": "billToPartner",
        "tenantID": "634f6379-ad54-449b-9821-564f737158ab"
    },
    "permissions": [
        {
            "resource": "AzureReservedInstances",
            "action": "Purchase"
        },
        {
            "resource": "AzureSavingsPlan",
            "action": "Purchase"
        }
    ],
    "attributes": {
        "etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
        "objectType": "SelfServePolicy"
    }
}

Réponse REST

Si elle réussit, cette API retourne une ressource SelfServePolicy pour la stratégie de libre-service mise à jour.

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur REST de l’Espace partenaires.

Cette méthode retourne les codes d’erreur suivants :

Code d’état HTTP	Code d'erreur	Description
404	600039	La stratégie de libre-service est introuvable
404	600040	L’identificateur de stratégie en libre-service est incorrect

Exemple de réponse

HTTP/1.1 200 Ok
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
Date: Tue, 14 Feb 2017 20:06:02 GMT

{
    "id": "634f6379-ad54-449b-9821-564f737158ab_0431a72c-7d8a-4393-b25e-ef63f5efb415",
    "selfServeEntity": {
        "selfServeEntityType": "customer",
        "tenantID": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
    },
    "grantor": {
        "grantorType": "billToPartner",
        "tenantID": "634f6379-ad54-449b-9821-564f737158ab"
    },
    "permissions": [
        {
            "resource": "AzureReservedInstances",
            "action": "Purchase"
        },
        {
            "resource": "AzureSavingsPlan",
            "action": "Purchase"
        }
    ],
    "attributes": {
        "etag": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
        "objectType": "SelfServePolicy"
    }
}

Partager via