Aggiornare un oggetto SelfServePolicy

Articolo
03/19/2024

Questo articolo illustra come aggiornare un criterio self-service.

Prerequisiti

Credenziali descritte in Autenticazione del Centro per i partner. Questo scenario supporta l'autenticazione con le credenziali Application+User.

C#

Per aggiornare un criterio self-service:

Chiamare il metodo IAggregatePartner.SelfServePolicies.ById con l'identificatore di entità per recuperare un'interfaccia per le operazioni sui criteri.
Chiamare il metodo Put o PutAsync per aggiornare i criteri self-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);

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
PUT	{baseURL}/v1/SelfServePolicy HTTP/1.1

Intestazioni della richiesta

Sono necessari un identificatore di richiesta e un identificatore di correlazione.
Per altre informazioni, vedi Intestazioni REST del Centro per i partner.

Testo della richiesta

Questa tabella descrive le proprietà necessarie nel corpo della richiesta.

Nome	Tipo	Descrizione
SelfServePolicy	object	Informazioni sui criteri self-service.

SelfServePolicy

Questa tabella descrive i campi minimi obbligatori della risorsa SelfServePolicy necessaria per creare un nuovo criterio self-service.

Proprietà	Type	Descrizione
id	string	Identificatore di criteri self-service fornito al completamento della creazione del criterio self-service.
SelfServeEntity	SelfServeEntity	Entità self-service a cui viene concesso l'accesso.
Utente che concede le autorizzazioni	Utente che concede le autorizzazioni	L'utente autorizzato a concedere l'accesso.
Autorizzazioni	Matrice di autorizzazioni	Matrice di risorse di autorizzazione .
ETag	string	The Etag.

Esempio di richiesta

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

Risposta REST

In caso di esito positivo, questa API restituisce una risorsa SelfServePolicy per i criteri self-service aggiornati.

Codici di errore e di esito della risposta

Ogni risposta viene fornita con un codice di stato HTTP che ne indica l'esito e con informazioni di debug aggiuntive. Usa uno strumento di traccia di rete per leggere il codice, il tipo di errore e parametri aggiuntivi. Per l'elenco completo, vedi Codici di errore REST del Centro per i partner.

Questo metodo restituisce i codici di errore seguenti:

Codice di stato HTTP	Codice di errore	Descrizione
404	600039	Criteri self-service non trovati
404	600040	L'identificatore dei criteri self-service non è corretto

Esempio di risposta

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

Condividi tramite