Obter uma lista de políticas de autoatendimentoGet a list of self-serve policies

Aplica-se a:Applies to:

  • Partner CenterPartner Center

Este artigo descreve como obter uma coleção de recursos que representa políticas de autoatendimento para uma entidade.This article describes how to get a collection of resources that represents self-serve policies for an entity.

Pré-requisitosPrerequisites

Solicitação RESTREST request

Sintaxe da solicitaçãoRequest syntax

MétodoMethod URI da solicitaçãoRequest URI
GETGET {baseURL}/v1/SelfServePolicy? entity_id = {ENTITY_ID} http/1.1{baseURL}/v1/SelfServePolicy?entity_id={entity_id} HTTP/1.1

Parâmetro do URIURI parameter

Use o parâmetro de consulta a seguir para obter uma lista de clientes.Use the following query parameter to get a list of customers.

NomeName TipoType ObrigatórioRequired DescriçãoDescription
entity_identity_id cadeia de caracteresstring SY O identificador de entidade que solicita acesso para.The entity identifier requesting access for. Essa será a ID de locatário do cliente.This will be the customer's tenant ID.

Cabeçalhos de solicitaçãoRequest headers

Para obter mais informações, consulte cabeçalhos.For more information, see Headers.

Corpo da solicitaçãoRequest body

Nenhum.None.

Exemplo de solicitaçãoRequest example

GET https://api.partnercenter.microsoft.com/v1/SelfServePolicy?entity_id=0431a72c-7d8a-4393-b25e-ef63f5efb415 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 3705fc6d-4127-4a87-bdba-9658f73fe019
MS-CorrelationId: b12260fb-82de-4701-a25f-dcd367690645

Resposta RESTREST response

Se for bem-sucedido, esse método retornará uma coleção de recursos SelfServePolicy no corpo da resposta.If successful, this method returns a collection of SelfServePolicy resources in the response body.

Códigos de êxito e de erro de respostaResponse success and error codes

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais.Use a network trace tool to read this code, error type, and additional parameters. Para obter uma lista completa, consulte códigos de erro.For a full list, see Error Codes.

Exemplo de respostaResponse example

HTTP/1.1 200 OK
Content-Length: 15650
Content-Type: application/json
MS-CorrelationId: b12260fb-82de-4701-a25f-dcd367690645
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": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
        },
        "grantor": {
            "grantorType": "billToPartner",
            "tenantID": "634f6379-ad54-449b-9821-564f737158ab"
        },
        "permissions": [{
            "resource": "AzureReservedInstances",
            "action": "Purchase"
        }],
        "attributes": {
            "etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
            "objectType": "SelfServePolicy"
        }
    }],
    "attributes": {
        "objectType": "Collection"
    }
}