Actualizar un contacto de soporte técnico de suscripción

  • Article

Se aplica a: Centro de partners | Centro de partners para Microsoft Cloud for US Government

Cómo actualizar el contacto de soporte técnico de una suscripción a uno de los revendedores de valor agregado del asociado.

Nota:

No se admite la asignación y actualización de contactos de soporte técnico designados en el nuevo comercio. Como resultado, la sección Contacto de soporte técnico designado no se muestra para las nuevas suscripciones comerciales en el portal y las API del Centro de partners.

Requisitos previos

  • Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación solo con credenciales de aplicación y usuario.

  • Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners. Seleccione el área de trabajo Clientes en la página principal del Centro de partners. Seleccione el cliente en la lista Customer (Cliente) y, a continuación, seleccione Account (Cuenta). En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Detalles de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

  • Identificador de suscripción.

  • Información sobre el nuevo contacto de soporte técnico: identificador de inquilino, PartnerID y nombre. El contacto de soporte técnico debe ser uno de los revendedores de valor agregado del asociado.

  • Esta funcionalidad de API está habilitada para las suscripciones tradicionales basadas en licencias y actualmente no se admiten nuevas suscripciones de Experiencia comercial.

C#

Para actualizar el contacto de soporte técnico de una suscripción, primero cree una instancia y rellene un objeto SupportContact con los nuevos valores. A continuación, use el método IAggregatePartner.Customers.ById con el identificador de cliente para identificar al cliente. A continuación, obtenga una interfaz para las operaciones de suscripción llamando al método Subscriptions.ById con el identificador de suscripción. A continuación, use la propiedad SupportContact para obtener una interfaz para admitir las operaciones de contacto. Por último, llame al método Update o UpdateAsync con el objeto SupportContact rellenado para actualizar el contacto de soporte técnico.

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Instantiate a SupportContact object and populate it with the new support contact information.
var supportContact = new SupportContact()
{
    Name = "Support contact's name",
    SupportTenantId = "Support contact's tenant ID",
    SupportMpnId = "Support contact's PartnerID"
};

// Update the support contact with a new object that has valid VAR values.
var updatedSupportContact = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).SupportContact.Update(supportContact);

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

Solicitud REST

Sintaxis de la solicitud

Método URI de la solicitud
PUT {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/supportcontact HTTP/1.1

Parámetro de URI

Use los siguientes parámetros de ruta de acceso para identificar el cliente y la suscripción.

Nombre Type Obligatorio Descripción
customer-id string Sí Cadena con formato GUID que identifica al cliente.
subscription-id string Sí Cadena con formato GUID que identifica la suscripción de prueba.

Encabezados de solicitud

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

Cuerpo de la solicitud

Debe incluir un recurso SupportContact rellenado en el cuerpo de la solicitud. El contacto de soporte técnico debe ser un revendedor existente con una relación con el asociado.

Ejemplo de solicitud

PUT https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/C8D8FBAB-6A62-44DC-BE50-B7C74E43A296/supportcontact HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: b72d732a-eed7-4a60-82d1-1b2e6cba0ed2
MS-CorrelationId: 84eff9e1-6a8c-42aa-8678-c00b0d3fb26f
X-Locale: en-US
Content-Type: application/json
Host: api.partnercenter.microsoft.com
Content-Length: 320
Expect: 100-continue

{
    "SupportTenantId": "3B33E682-00C3-41EE-9DD2-A548ADF56438",
    "SupportMpnId": "4391507",
    "Name": "Trey Research",
    "Links": {
        "Self": {
            "Uri": "/customers/0C39D6D5-C70D-4C55-BC02-F620844F3FD1/subscriptions/C8D8FBAB-6A62-44DC-BE50-B7C74E43A296/supportcontact",
            "Method": "Get",
            "Headers": []
        }
    },
    "Attributes": {
        "ObjectType": "SupportContact"
    }
}

Respuesta REST

Si se ejecuta correctamente, el cuerpo de la respuesta contiene el recurso SupportContact .

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, consulte Códigos de error del Centro de partners.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 328
Content-Type: application/json; charset=utf-8
MS-CorrelationId: b0cd9bcc-742e-4c76-9e34-a96d3bdc7673
MS-RequestId: 7591ca22-d4e3-409d-bfa6-09806eaff4f3
MS-CV: W8Tzj6NGckKHcq+E.0
MS-ServerId: 030020344
Date: Wed, 21 Jun 2017 01:01:17 GMT

{
    "supportTenantId": "3B33E682-00C3-41EE-9DD2-A548ADF56438",
    "supportMpnId": "4391507",
    "name": "Trey Research",
    "links": {
        "self": {
            "uri": "/customers/0C39D6D5-C70D-4C55-BC02-F620844F3FD1/subscriptions/C8D8FBAB-6A62-44DC-BE50-B7C74E43A296/supportcontact",
            "method": "Get",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "SupportContact"
    }
}