Compartir a través de


Crear una directiva de configuración para el cliente especificado

Se aplica a: Centro de partners

Cómo eliminar una directiva de configuración para un cliente y un identificador de directiva especificados.

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 independiente y app+user.

  • Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners seleccionando el área de trabajo Clientes , el cliente de la lista de clientes y, a continuación, Cuenta. En la página Cuenta del cliente, busca el Id. de Microsoft en la sección Información de la cuenta del cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

  • Identificador de directiva.

C#

Para eliminar una directiva de configuración para un cliente especificado:

  1. Llame al método IAggregatePartner.Customers.ById con el identificador de cliente para recuperar una interfaz a las operaciones del cliente especificado.

  2. Llame al método ConfigurationPolicies.ById con el identificador de directiva para recuperar una interfaz a las operaciones de directiva de configuración de la directiva especificada.

  3. Llame al método Delete o DeleteAsync para eliminar la directiva de configuración.

IAggregatePartner partnerOperations;
string selectedCustomerId;
string selectedPolicyId;

partnerOperations.Customers.ById(selectedCustomerId).ConfigurationPolicies.ById(selectedPolicyId).Delete();

Ejemplo: aplicación de prueba de consola. Project: Clase de ejemplos del SDK del Centro de partners: DeleteConfigurationPolicy.cs

Solicitud REST

Sintaxis de la solicitud

Método URI de solicitud
DELETE {baseURL}/v1/customers/{customer-id}/policies/{policy-id} HTTP/1.1

Parámetros del identificador URI

Use los siguientes parámetros de ruta de acceso al crear la solicitud.

Nombre Tipo Obligatorio Descripción
customer-id string Cadena con formato de GUID que identifica al cliente.
policy-id string Cadena con formato GUID que identifica la directiva que se va a eliminar.

Encabezados de solicitud

Para obtener más información, consulta Encabezados REST del Centro de partners.

Cuerpo de la solicitud

None

Ejemplo de solicitud

DELETE https://api.partnercenter.microsoft.com/v1/customers/47021739-3426-40bf-9601-61b4b6d7c793/policies/56edf752-ee77-4fd8-b7f5-df1f74a3a9ac HTTP/1.1
Authorization: Bearer <token>
MS-RequestId: e88d014d-ab70-41de-90a0-f7fd1797267d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US
Content-Length: 0
Content-Type: application/json
Host: api.partnercenter.microsoft.com

Respuesta REST

Si se ejecuta correctamente, la respuesta devuelve un código de estado 204 Sin contenido.

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.

Ejemplo de respuesta

HTTP/1.1 204 No Content
Content-Length: 0
MS-CorrelationId: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 76b6f317-1da1-4b61-a6fd-9952439a2c46
MS-CV: YrLe3w6BbUSMt1fi.0
MS-ServerId: 030020344
Date: Tue, 25 Jul 2017 18:10:41 GMT