Obtención de un derecho de Azure para una suscripción

Artículo
02/05/2024

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

Los asociados pueden ver su derecho de Azure para una suscripción mediante esta API, que obtiene el derecho del identificador de suscripción de un cliente.

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+usuario.
Customer_id.
Subscription_id.
Entitlement_id.

C#

Para cancelar una suscripción de Azure, deberá identificar el identificador de cliente, el identificador de suscripción y el identificador de derecho de la suscripción de Azure que desea cancelar.

Para obtener un cliente, consulte Obtención de un cliente por identificador y Obtención del cliente por identificador de cliente: API REST para obtener más ayuda.
Para obtener una suscripción, consulte Obtención de una suscripción por identificador y Obtención de la suscripción por identificador: API REST para obtener más ayuda.
Para obtener un derecho, consulte Obtención de un derecho de Azure para una suscripción: API REST.

Solicitud REST

Sintaxis de la solicitud

Método	URI de solicitud
POST	{baseURL}/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id} HTTP/1.1

Parámetro de URI

En esta tabla se enumeran los parámetros de consulta necesarios para cancelar una suscripción de Azure.

Nombre	Type	Necesario	Descripción
customer_id	Cadena	Y	El valor es una cadena que denota el identificador del cliente.
subscription_id	Cadena	Y	El valor es una cadena que denota el identificador del cliente.
entitlement_id	Cadena	Y	El valor es una cadena que indica el identificador del derecho de la suscripción de Azure.

Encabezados de solicitud

Consulte Encabezados REST del Centro de partners.

Cuerpo de la solicitud

No se requiere ningún cuerpo de solicitud.

Ejemplo de solicitud

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}

HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd

Respuesta REST

Si se ejecuta correctamente, este método devuelve un derecho de Azure para un recurso de suscripción 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 más 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.

Estado HTTP	Código HTTP	Código de error	Descripción
BadRequest	400	900118	Identificador de cliente no válido.
BadRequest	400	800002	El identificador {0} de cliente debe tener formato GUID (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).
BadRequest	400	800002	Se requiere el identificador de suscripción.
BadRequest	400	800002	Se requiere el identificador de derecho.
BadRequest	400	800002	Se requiere el contenido de la solicitud de cancelación de derechos de Azure.
Prohibido	403	900159	El asociado con el identificador {0} de cuenta y el identificador {1} de organización no tiene ninguna relación comercial con el cliente con el identificador de cuenta y el identificador {2}{3}de organización .
BadRequest	400	900307	El motivo de cancelación '{0} no es válido.
NotFound	404	800111	No se encuentra el derecho de Azure con el identificador {0} .

Ejemplo de respuesta

La respuesta devuelve el derecho de Azure para un cliente determinado.

HTTP
HTTP/1.1 200 OK
Content-Length: 1132
Content-Type: application/json; charset=utf-8
MS-CorrelationId: 6eacec93-852d-4167-9d96-c57809bea7ed
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT

{ 
    "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383", 
    "friendlyName": " Cancel_Azure_Subscription", 
    "status": “inactive", 
    "subscriptionId": "065eefc4-915b-453d-c558-152e39ec25b1", 
    "links": { 
        "self": { 
            "uri": "/customers/425829ba-6938-4b55-af29-fbbd28ebeebf/subscriptions/065eefc4-915b-453d-c558-152e39ec25b1/azureEntitlements/5b76b8c3-dd85-4096-bb2e-9804b1d7b383", 
            "method": "GET", 
            "headers": [] 
        } 
    }

Share via