Ottenere un elenco di criteri self-service

Articolo
10/28/2024

Ottiene una raccolta di risorse che rappresenta i criteri self-service per un'entità.

Prerequisiti

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

C#

Per ottenere un elenco di tutti i criteri self-service:

Chiamare il metodo IAggregatePartner.With(IRequestContext) con l'identificatore di entità per recuperare un'interfaccia per le operazioni sui criteri.

// IAggregatePartner partnerOperations;

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

// gets the self-serve policies
var SelfServePolicies = scopedPartnerOperations.SelfServePolicies.Get(customerIdAsEntity);

Per un esempio, vedere quanto segue:

Esempio: App di test della console
Progetto: PartnerSDK.FeatureSamples
Classe: GetSelfServePolicies.cs

Richiesta REST

Sintassi della richiesta

Metodo	URI richiesta
GET	{baseURL}/v1/SelfServePolicy?entity_id={entity_id} HTTP/1.1

Parametro URI

Usare il parametro di query seguente per ottenere un elenco di clienti.

Nome	Tipo	Obbligatoria	Descrizione
entity_id	string	S	Identificatore di entità per cui viene richiesto l'accesso. Si tratta dell'ID tenant del cliente.

Intestazioni della richiesta

Per altre informazioni, vedere Intestazioni.

Testo della richiesta

Nessuno.

Esempio di richiesta

GET https://api.partnercenter.microsoft.com/v1/SelfServePolicy?entity_id=00aa00aa-bb11-cc22-dd33-44ee44ee44ee HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd

Risposta REST

In caso di esito positivo, questo metodo restituisce una raccolta di risorse SelfServePolicy nel corpo della risposta.

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 un elenco completo, vedere Codici di errore.

Esempio di risposta

HTTP/1.1 200 OK
Content-Length: 15650
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
Date: Fri, 20 Nov 2015 01:08:23 GMT

{
    "totalCount": 1,
    "items": [{
        "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"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}

Condividi tramite