Compartir a través de

Obtener la confirmación de la aceptación por parte del cliente del Contrato de Microsoft Cloud

  • Artículo

Se aplica a: Centro de partners

No se aplica a: Centro de partners operado por 21Vianet | Centro de partners para Microsoft Cloud for US Government

El recurso Agreement solo es compatible actualmente con el Centro de partners en la nube pública de Microsoft.

Requisitos previos

  • Si usa el SDK de .NET del Centro de partners, se requiere la versión 1.9 o posterior.

    Importante

    A partir de junio de 2023, la versión 3.4.0 más reciente del SDK de .NET del Centro de partners ahora está archivada. Puede descargar esta versión del SDK de GitHub, junto con un archivo Léame que contiene información útil.

    Se recomienda a los partners seguir usando las API REST del Centro de partners.

  • Si usa el SDK de Java del Centro de partners, se requiere la versión 1.8 o posterior.

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

  • 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 , luego el cliente de la lista de clientes y, a continuación , Cuenta. En la página Cuenta del cliente, busque el identificador de Microsoft en la sección Información de la cuenta de cliente. El id. de Microsoft es el mismo que el de cliente (customer-tenant-id).

.NET (versión 1.4 o posterior)

Para recuperar confirmaciones de aceptación del cliente proporcionadas anteriormente:

  • Use la colección IAggregatePartner.Customers y llame al método ById con el identificador de cliente especificado.

  • Capture la propiedad Agreement y filtre los resultados en Microsoft Cloud Agreement llamando al método ByAgreementType .

  • Llame al método Get o GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

string agreementType = "MicrosoftCloudAgreement";

var cloudAgreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.ByAgreementType(agreementType).Get();

Puede encontrar un ejemplo completo en la clase GetCustomerAgreements del proyecto de aplicación de prueba de consola.

.NET (versión 1.9 - 1.13)

Para recuperar la confirmación de la aceptación del cliente proporcionada anteriormente:

Use la colección IAggregatePartner.Customers y llame al método ById con el identificador del cliente especificado. A continuación, obtenga la propiedad Agreements , seguida de llamar a los métodos Get o GetAsync .

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

var agreements = partnerOperations.Customers.ById(selectedCustomerId).Agreements.Get();

Java

El SDK de Java del Centro de partners se puede usar para administrar los recursos del Centro de partners. Es un proyecto de código abierto mantenido por la comunidad de partners y no es compatible oficialmente con Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.

Para recuperar la confirmación de la aceptación del cliente proporcionada anteriormente:

Use la función IAggregatePartner.getCustomers y llame a la función byId con el identificador del cliente especificado. A continuación, obtenga la función getAgreements , seguida de llamar a la función get .

// IAggregatePartner partnerOperations;
// String selectedCustomerId;

ResourceCollection<Agreement> agreements = partnerOperations.getCustomers().byId(selectedCustomerId).getAgreements().get();

Puede encontrar un ejemplo completo en la clase GetCustomerAgreements del proyecto de aplicación de prueba de consola.

PowerShell

El módulo de PowerShell del Centro de partners se puede usar para administrar los recursos del Centro de partners. Es un proyecto de código abierto mantenido por la comunidad de partners y no es compatible oficialmente con Microsoft. Puedes obtener ayuda de la comunidad o abrir una incidencia en GitHub si se produce un problema.

Para recuperar la confirmación de la aceptación del cliente proporcionada anteriormente:

Use el comando Get-PartnerCustomerAgreement.

Get-PartnerCustomerAgreement -CustomerId '14876998-c0dc-46e6-9d0c-65a57a6c32ec'

Solicitud REST

Para recuperar la confirmación de la aceptación del cliente proporcionada anteriormente, consulte las instrucciones siguientes.

Cree un nuevo recurso de Contrato con la información de certificación pertinente.

Sintaxis de la solicitud

Método URI de solicitud
GET {baseURL}/v1/customers/{customer-tenant-id}/agreements HTTP/1.1

Parámetro de URI

Use el siguiente parámetro de consulta para especificar el cliente que está confirmando.

Nombre Type Obligatorio Descripción
CustomerTenantId GUID Y El valor es un GUID con formato CustomerTenantId que permite especificar un cliente.

Encabezados de solicitud

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

Cuerpo de la solicitud

Ninguno.

Ejemplo de solicitud

GET https://api.partnercenter.microsoft.com/v1/customers/14876998-c0dc-46e6-9d0c-65a57a6c32ec/agreements HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b

Respuesta REST

Si se ejecuta correctamente, este método devuelve una colección de recursos de Agreement 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 éxito o error y otra información de depuración. Use una herramienta de seguimiento de red para leer este código, tipo de error y otros parámetros. Para obtener la lista completa, consulta Códigos de error de REST del Centro de partners.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 620
Content-Type: application/json
MS-RequestId: 94e4e214-6b06-4fb7-96d1-94d559f9b47f
MS-CorrelationId: ab993325-1605-4cf4-bac4-fb584142a31b
{
    "totalCount": 2,
    "items":
    [
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber":"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2018-07-28T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        },
        {
            "primaryContact":
            {
                "firstName":"Tania",
                "lastName":"Carr",
                "email":"SomeEmail@Outlook.com"
                "phoneNumber:"1234567890"
            },
            "templateId":"998b88de-aa99-4388-a42c-1b3517d49490",
            "dateAgreed":"2017-08-01T00:00:00",
            "type":"MicrosoftCloudAgreement",
            "agreementLink":"https://learn.microsoft.com/partner-center/agreements"
        }
    ]
}