Cancelación de una suscripción de Azure

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

Si se pone en peligro o se usa un abuso, los asociados con las suscripciones de cliente de Azure pueden cancelar las suscripciones directamente desde el portal del Centro de partners o por API, cerrando la actividad sospechosa detectada en sus suscripciones de plan de Azure.

Esta API cancelará una suscripción de Azure. Si los partners quieren cancelar más de una suscripción, deben llamar por separado a la API para cancelar cada una.

Si los partners quieren suspender su plan de Azure, deben usar la API existente disponible, Actualice una suscripción por identificador.

La siguiente API no admite la cancelación del plan de Azure.

Los asociados deben ser Administración istrators globales con roles de agente de Administración para cancelar.

Requisitos previos

Credenciales como se describe en autenticación del Centro de partners Este escenario admite la autenticación tanto con credenciales de aplicación independiente como de app+usuario.
Customer_id.
Subscription_id.
Entitlement_id.

C#

Para cancelar una suscripción de Azure, debe identificar el identificador de cliente, el identificador de suscripción y el identificador de derecho de esa suscripción.

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}/cancel 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

HTTP
{ "cancellationReason": "compromise" }

Ejemplo de solicitud

POST
[https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/azureEntitlements/{entitlement_id}/cancel](https://api.partnercenter.microsoft.com/v1/customers/%7bcustomer_id%7d/subscriptions/%7bsubscription_id%7d/azureEntitlements/%7bentitlement_id%7d/cancel)
HTTP/1.1
Accept: application/json
MS-RequestId: 655890ba-4d2b-4d09-a95f-4ea1348686a5
MS-CorrelationId: 1438ea3d-b515-45c7-9ec1-27ee0cc8e6bd
{
 "id": "5b76b8c3-dd85-4096-bb2e-9804b1d7b383",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "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": []
   }
  }
}

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 para cancelar una suscripción incluye el estado del derecho. Espere unos 10 minutos para que el estado se refleje (es decir, activo a inactivo).

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": "active",
"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