Aktualizace zásady SelfServePolicy

  • Článek

Tento článek vysvětluje, jak aktualizovat samoobslužné zásady.

Požadavky

C#

Aktualizace samoobslužných zásad:

  1. Volání metody IAggregatePartner.SelfServePolicies.ById s identifikátorem entity pro načtení rozhraní pro operace se zásadami.

  2. Voláním metody Put nebo PutAsync aktualizujte samoobslužné zásady.

// 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);

Požadavek REST

Syntaxe požadavku

Metoda Identifikátor URI žádosti
PUT {baseURL}/v1/SelfServePolicy HTTP/1.1

Hlavičky požadavku

Text požadavku

Tato tabulka popisuje požadované vlastnosti v textu požadavku.

Název Typ Description
SelfServePolicy object Informace o samoobslužných zásadách

SelfServePolicy

Tato tabulka popisuje minimální požadovaná pole z prostředku SelfServePolicy potřebného k vytvoření nové samoobslužné zásady.

Vlastnost Typ Description
id řetězec Identifikátor samoobslužné zásady, který se zadává po úspěšném vytvoření samoobslužné zásady.
SelfServeEntity SelfServeEntity Samoobslužná entita, které se uděluje přístup.
Grantor Grantor Grantor, který uděluje přístup.
Oprávnění Pole oprávnění Pole prostředků oprávnění .
Etag řetězec Značka Etag.

Příklad požadavku

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

Odpověď REST

V případě úspěchu vrátí toto rozhraní API prostředek SelfServePolicy pro aktualizované samoobslužné zásady.

Kódy úspěšných odpovědí a chyb

Každá odpověď obsahuje stavový kód HTTP, který označuje úspěch nebo selhání, a další informace o ladění. Ke čtení tohoto kódu, typu chyby a dalších parametrů použijte nástroj trasování sítě. Úplný seznam najdete v tématu Kódy chyb REST v Partnerském centru.

Tato metoda vrátí následující kódy chyb:

Stavový kód HTTP Kód chyby Popis
404 600039 Samoobslužné zásady nebyly nalezeny
404 600040 Identifikátor samoobslužných zásad je nesprávný.

Příklad odpovědi

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