Compartir a través de

Actualizar selfServePolicy

  • Artículo

En este artículo se explica cómo actualizar una directiva de autoservicio.

Requisitos previos

C#

Para actualizar una directiva de autoservicio:

  1. Llame al método IAggregatePartner.SelfServePolicies.ById con el identificador de entidad para recuperar una interfaz a las operaciones en las directivas.

  2. Llame al método Put o PutAsync para actualizar la directiva de autoservicio.

// 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);

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
PUT {baseURL}/v1/SelfServePolicy HTTP/1.1

Encabezados de solicitud

Cuerpo de la solicitud

En esta tabla se describen las propiedades necesarias en el cuerpo de la solicitud.

Nombre Tipo Descripción
SelfServePolicy object Información de la directiva de autoservicio.

SelfServePolicy

En esta tabla se describen los campos mínimos necesarios del recurso SelfServePolicy necesario para crear una nueva directiva de autoservicio.

Propiedad Tipo Descripción
id string Identificador de directiva de autoservicio que se proporciona tras la creación correcta de la directiva de autoservicio.
SelfServeEntity SelfServeEntity Entidad de autoservicio a la que se concede acceso.
Otorgante de permisos Otorgante de permisos Receptor al que se concede acceso.
Permisos Matriz de permisos Matriz de recursos de permiso .
Etag string The Etag.

Ejemplo de solicitud

PUT https://api.partnercenter.microsoft.com/v1/SelfServePolicy HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
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": "0431a72c-7d8a-4393-b25e-ef63f5efb415"
    },
    "grantor": {
        "grantorType": "billToPartner",
        "tenantID": "634f6379-ad54-449b-9821-564f737158ab"
    },
    "permissions": [
        {
            "resource": "AzureReservedInstances",
            "action": "Purchase"
        },
        {
            "resource": "AzureSavingsPlan",
            "action": "Purchase"
        }
    ],
    "attributes": {
        "etag": "\"933523d1-3f63-4fc3-8789-5e21c02cdaed\"",
        "objectType": "SelfServePolicy"
    }
}

Respuesta REST

Si se ejecuta correctamente, esta API devuelve un recurso SelfServePolicy para la directiva de autoservicio actualizada.

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 la lista completa, consulta Códigos de error de REST del Centro de partners.

Este método devuelve los siguientes códigos de error:

Código de estado HTTP Código de error Descripción
404 600039 No se encontró la directiva de autoservicio
404 600040 El identificador de directiva de autoservicio es incorrecto

Ejemplo de respuesta

HTTP/1.1 200 Ok
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"
        },
        {
            "resource": "AzureSavingsPlan",
            "action": "Purchase"
        }
    ],
    "attributes": {
        "etag": "\"1ec98034-a249-46f4-b9dd-9cd464fb5e47\"",
        "objectType": "SelfServePolicy"
    }
}