Aktualizace zásady SelfServePolicy
Tento článek vysvětluje, jak aktualizovat samoobslužné zásady.
Požadavky
- Přihlašovací údaje, jak je popsáno v tématu Ověřování v Partnerském centru. Tento scénář podporuje ověřování pomocí přihlašovacích údajů aplikace a uživatele.
C#
Aktualizace samoobslužných zásad:
Volání metody IAggregatePartner.SelfServePolicies.ById s identifikátorem entity pro načtení rozhraní pro operace se zásadami.
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
- Vyžaduje se identifikátor požadavku a identifikátor korelace.
- Další informace najdete v tématu Hlavičky REST Partnerského centra.
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: aaaa0000-bb11-2222-33cc-444444dddddd
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": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
},
"grantor": {
"grantorType": "billToPartner",
"tenantID": "bbbbcccc-1111-dddd-2222-eeee3333ffff"
},
"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: aaaa0000-bb11-2222-33cc-444444dddddd
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": "aaaabbbb-0000-cccc-1111-dddd2222eeee"
},
"grantor": {
"grantorType": "billToPartner",
"tenantID": "bbbbcccc-1111-dddd-2222-eeee3333ffff"
},
"permissions": [
{
"resource": "AzureReservedInstances",
"action": "Purchase"
},
{
"resource": "AzureSavingsPlan",
"action": "Purchase"
}
],
"attributes": {
"etag": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
"objectType": "SelfServePolicy"
}
}