Obtener una lista de directivas de autoservicio
Obtiene una colección de recursos que representa directivas de autoservicio para una entidad.
Requisitos previos
- Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con credenciales de aplicación y usuario.
C#
Para obtener una lista de todas las directivas de autoservicio:
- Llame al método IAggregatePartner.With(IRequestContext) con el identificador de entidad para recuperar una interfaz a las operaciones en las directivas.
// 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);
Para obtener un ejemplo, consulte lo siguiente:
- Ejemplo: Aplicación de prueba de la consola
- Proyecto: PartnerSDK.FeatureSamples
- Clase: GetSelfServePolicies.cs
Solicitud REST
Sintaxis de la solicitud
Método | URI de la solicitud |
---|---|
GET | {baseURL}/v1/SelfServePolicy?entity_id={entity_id} HTTP/1.1 |
Parámetro de URI
Use el siguiente parámetro de consulta para obtener una lista de clientes.
Nombre | Tipo | Obligatorio | Descripción |
---|---|---|---|
entity_id | string | Y | Identificador de entidad para el que se solicita acceso. Este será el identificador de inquilino del cliente. |
Encabezados de solicitud
Para obtener más información, vea Encabezados.
Cuerpo de la solicitud
Ninguno.
Ejemplo de solicitud
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
Respuesta REST
Si se ejecuta correctamente, este método devuelve una colección de recursos SelfServePolicy en el cuerpo de la respuesta.
Códigos de error y de respuesta correctos
Cada respuesta incluye un código de estado HTTP que indica si la operación se ha realizado correctamente o con errores y proporciona información de depuración adicional. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales. Para obtener una lista completa, consulte Códigos de error.
Ejemplo de respuesta
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"
}
}