Compartir a través de

Cancelación de una suscripción de Azure

  • Artículo

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 administradores 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.

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 de la suscripción.
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: aaaa0000-bb11-2222-33cc-444444dddddd
{
 "id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
 "friendlyName": "Cancel_Azure_Subscription ",
 "status": "active",
 "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
 "links": {
  "self": {
  "uri":
  "/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
  "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: bbbb1111-cc22-3333-44dd-555555eeeeee
MS-RequestId: 22bfd0fb-d1e6-4a8f-aa1a-124b7c820d80
MS-CV: cmde2DtbuUWi8JLq.0
MS-ServerId: 201022015
Date: Wed, 14 Dec 2022 00:12:53 GMT
{
"id": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"friendlyName": " Cancel_Azure_Subscription",
"status": "active",
"subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
"links": {
"self": {
"uri":
"/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/azureEntitlements/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
"method": "GET",
"headers": []
 }
}

Contenido relacionado