Creación de un SelfServePolicyCreate a SelfServePolicy

Se aplica a:Applies to:

  • Centro de partnersPartner Center

En este tema se explica cómo crear una nueva Directiva de autoservicio.This topic explains how to create a new self serve policy.

Requisitos previosPrerequisites

Solicitud RESTREST request

Sintaxis de la solicitudRequest syntax

MétodoMethod URI de la solicitudRequest URI
POSTPOST {baseurl}/v1/SelfServePolicy http/1.1{baseURL}/v1/SelfServePolicy HTTP/1.1

Encabezados de solicitudRequest headers

Cuerpo de la solicitudRequest body

En esta tabla se describen las propiedades necesarias en el cuerpo de la solicitud.This table describes the required properties in the request body.

NombreName TipoType DescriptionDescription
SelfServePolicySelfServePolicy objetoobject La información de la Directiva de autoservicio.The self serve policy information.

SelfServePolicySelfServePolicy

En esta tabla se describen los campos obligatorios mínimos del recurso SelfServePolicy necesarios para crear una nueva Directiva de autoservicio.This table describes the minimum required fields from the SelfServePolicy resource needed to create a new self serve policy.

Propiedad.Property TipoType DescriptionDescription
SelfServeEntitySelfServeEntity SelfServeEntitySelfServeEntity La entidad de autoservicio a la que se concede acceso.The self serve entity that is being granted access.
Otorgante de permisosGrantor Otorgante de permisosGrantor El otorgante que concede acceso.The grantor that is granting access.
PermisosPermissions Matriz de permisosArray of Permission Matriz de recursos de permiso .An Array of Permission resources.

Ejemplo de solicitudRequest example

POST https://api.partnercenter.microsoft.com/v1/SelfServePolicy HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 789
Expect: 100-continue
Connection: Keep-Alive

{
    "selfServeEntity": {
        "selfServeEntityType": "customer",
        "tenantID": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
    },
    "grantor": {
        "grantorType": "billToPartner",
        "tenantID": "634f6379-ad54-449b-9821-564f737158ab"
    },
    "permissions": [{
        "resource": "AzureReservedInstances",
        "action": "Purchase"
    }
}

Respuesta RESTREST response

Si se realiza correctamente, esta API devuelve un recurso SelfServePolicy para la nueva Directiva de SELD Serve.If successful, this API returns a SelfServePolicy resource for the new seld serve policy.

Códigos de error y de respuesta correctosResponse success and error codes

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.Each response comes with an HTTP status code that indicates success or failure and additional debugging information. Use una herramienta de seguimiento de red para leer este código, el tipo de error y los parámetros adicionales.Use a network trace tool to read this code, error type, and additional parameters. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.For the full list, see Partner Center REST error codes.

Este método devuelve los siguientes códigos de error:This method returns the following error codes:

Código de estado HTTPHTTP Status Code Código de errorError code DescripciónDescription
409409 600041600041 La Directiva de autoservicio ya existe.Self serve policy already exists.

Ejemplo de respuestaResponse example

HTTP/1.1 201 Created
Content-Length: 834
Content-Type: application/json; charset=utf-8
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
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": "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"
    }
}