Obtener el presupuesto de gasto de uso de un cliente

Artigo
01/29/2024

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

Puede actualizar el presupuesto de gasto (el objeto SpendingBudget) en el resumen de uso del cliente (el recurso CustomerUsageSummary).

Requisitos previos

Credenciales tal como se describen en el artículo Autenticación del Centro de partners. Este escenario admite la autenticación con las credenciales de aplicación independiente y app+usuario.
Un id. de cliente (customer-tenant-id). Si no conoce el identificador del cliente, puede buscarlo en el Centro de partners si selecciona 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).

C#

Para actualizar el presupuesto de gasto de uso de un cliente:

Cree un nuevo objeto SpendingBudget con la cantidad actualizada.
Use la colección IAggregatePartner.Customers para llamar al método ById() con el identificador del cliente especificado.
Llame al método Get o GetAsync para obtener el presupuesto de uso del cliente.

// IAggregatePartner partnerOperations;
// string selectedCustomerId;

// Create a new spending budget with the udpated amount.
var newUsageBudget = new SpendingBudget()
{
    Amount = 100
};

// Update the customer's usage budget.
var usageBudget = partnerOperations.Customers.ById(selectedCustomerId).UsageBudget.Get();

Solicitud REST

Sintaxis de la solicitud

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

Parámetro de URI

Use el siguiente parámetro de consulta para actualizar el perfil de facturación.

Nombre	Tipo	Obligatorio	Descripción
customer-tenant-id	guid	Y	El valor es un GUID con formato customer-tenant-id que permite al revendedor filtrar los resultados de un cliente determinado que pertenece al revendedor.

Encabezados de solicitud

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

Cuerpo de la solicitud

Recurso completo.

Ejemplo de solicitud

GET https://api.partnercenter.microsoft.com/v1/customers/<customer-tenant-id>/usagebudget HTTP/1.1
Authorization: Bearer <token>
Accept: application/json, text/plain, */*
MS-RequestId: 312b044d-dc41-4b37-c2d5-7d27322d9654
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
Content-Type: application/json;charset=utf-8
X-Locale: "en-US"

Respuesta REST

Si se ejecuta correctamente, este método devuelve el presupuesto de gasto de un usuario con la cantidad 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, consulte Códigos de error.

Ejemplo de respuesta

HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: 7cb67bb7-4750-403d-cc2e-6bc44c52d52c
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 17 Sep 2019 20:31:45 GMT

{
    {
        "amount": 100,
        "usageSpendingBudget": 100,
        "attributes":{
            "objectType":"SpendingBudget"
        }
    },
    "links":{
        "self":{
            "uri":"/v1/customers/<customer-tenant-id>/usagebudget",
            "method":"GET",
            "headers":[]
        }
    }
}

Share via