Compartir a través de

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

  • Artículo

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.

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: 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": “inactive", 
    "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