Compartir a través de

Creación de suscripciones de Azure mediante programación con las API heredadas

  • Artículo

Este artículo le ayuda a crear mediante programación suscripciones de Azure con nuestra API en versión preliminar heredada. En este artículo, se ofrece información sobre cómo crear suscripciones mediante programación con Azure Resource Manager.

Tenemos nuevos artículos sobre la versión más reciente de la API que se usan con los diferentes tipos de suscripción de los contratos de Azure:

Sin embargo, puede seguir usando la información de este artículo si no desea utilizar la versión de API más reciente.

Los clientes de Azure con una cuenta de facturación para los siguientes tipos de contrato pueden crear suscripciones mediante programación:

  • Contrato Enterprise
  • Contrato de cliente de Microsoft (MCA).
  • Microsoft Partner Agreement (MPA)

Si se crea una suscripción a Azure mediante programación, esta se rige por el contrato en cuyo marco ha obtenido los servicios de Azure de Microsoft o de cualquier distribuidor autorizado. Para más información, consulte Información legal de Microsoft Azure.

Nota:

Se recomienda usar el módulo Azure Az de PowerShell para interactuar con Azure. Para comenzar, consulte Instalación de Azure PowerShell. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.

No se pueden crear planes de soporte técnico mediante programación. Puede comprar un nuevo plan de soporte técnico o actualizar uno en Azure Portal. Vaya a ayuda y soporte técnico y, a continuación, en la parte superior de la página, seleccione Elegir el plan de soporte técnico adecuado.

Creación de suscripciones para una cuenta de facturación de EA

Use la información de las secciones siguientes para aprender a crea suscripciones a EA.

Requisitos previos

Debe tener un rol de propietario en una cuenta de inscripción o ser administrador de empresa para crear una suscripción. Existen dos formas de obtener el rol:

Búsqueda de cuentas a las que tiene acceso

Cuando haya sido agregado a una cuenta de inscripción asociada a un propietario de cuenta, Azure usa la relación cuenta-inscripción para determinar dónde se cobra la suscripción. Todas las suscripciones creadas en la cuenta se facturan a la inscripción de EA en la que se encuentra la cuenta. Para crear suscripciones, debe pasar valores sobre la cuenta de inscripción y las entidades de seguridad de usuario al propietario de la suscripción.

Para ejecutar los siguientes comandos, debe iniciar sesión en el directorio particular del propietario de cuenta, que es el directorio en el que se crean las suscripciones de manera predeterminada.

Solicite mostrar todas las cuentas de inscripción a las que tiene acceso:

GET https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts?api-version=2018-03-01-preview

La respuesta de la API muestra todas las cuentas de inscripción a las que tiene acceso:

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/enrollmentAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "type": "Microsoft.Billing/enrollmentAccounts",
      "properties": {
        "principalName": "SignUpEngineering@contoso.com"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/enrollmentAccounts/4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "Microsoft.Billing/enrollmentAccounts",
      "properties": {
        "principalName": "BillingPlatformTeam@contoso.com"
      }
    }
  ]
}

Use la propiedad principalName para identificar la cuenta a la que quiere que se facturen las suscripciones. Copie el elemento name de esa cuenta. Por ejemplo, cree suscripciones en la cuenta de inscripción SignUpEngineering@contoso.com y copie aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e. El identificador es el identificador de objeto de la cuenta de inscripción. Pegue el valor en algún lugar para poder usarlo en el paso siguiente como enrollmentAccountObjectId.

Creación de suscripciones con una cuenta de inscripción concreta

En el ejemplo siguiente se crea una suscripción denominada Dev Team Subscription en la cuenta de inscripción seleccionada en el paso anterior. La oferta de suscripción es MS-AZR-0017P (Contrato Enterprise de Microsoft normal). Opcionalmente, también agrega dos usuarios como propietarios de Azure RBAC a la suscripción.

Realice la siguiente solicitud; para ello, reemplace <enrollmentAccountObjectId> por el elemento name copiado en el primer paso (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Para especificar los propietarios, consulte cómo obtener identificadores de objeto de usuario.

POST https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/<enrollmentAccountObjectId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-03-01-preview

{
  "displayName": "Dev Team Subscription",
  "offerType": "MS-AZR-0017P",
  "owners": [
    {
      "objectId": "<userObjectId>"
    },
    {
      "objectId": "<servicePrincipalObjectId>"
    }
  ]
}
Nombre del elemento Obligatorio Type Descripción
displayName No String Nombre para mostrar de la suscripción. Si no se especifica, se establece en el nombre de la oferta, por ejemplo, "Microsoft Azure Enterprise".
offerType Sí String Oferta de la suscripción. Las dos opciones para EA son MS-AZR-0017P (uso en producción) y MS-AZR-0148P (desarrollo y pruebas, tiene que habilitarse en el Azure Portal).
owners No String El identificador de objeto de cualquier usuario que se va a agregar como propietario de Azure RBAC a la suscripción al crearla.

En la respuesta, como parte del encabezado Location, obtiene una dirección URL en la que puede consultar el estado de la operación de creación de la suscripción. Cuando haya finalizado la creación de la suscripción, una solicitud GET en la URL Location devolvería un objeto subscriptionLink, que tiene el identificador de suscripción. Para obtener más información, consulte la documentación de la API de suscripción.

Limitaciones de la API de creación de suscripciones de Azure Enterprise

  • Las suscripciones de Azure Enterprise solo pueden crearse mediante la API.
  • Hay un límite de 5000 suscripciones por cuenta de inscripción. Después, solo se pueden crear más suscripciones para la cuenta en Azure Portal. Si quiere crear más suscripciones a través de la API, cree otra cuenta de inscripción. Las suscripciones canceladas, eliminadas y transferidas cuentan para el límite de 5000.
  • Los usuarios que no son propietarios de cuenta, aunque se hayan agregado a una cuenta de inscripción con Azure RBAC, no pueden crear suscripciones en Azure Portal.
  • No puede seleccionar el inquilino para la suscripción en que se va a crear. La suscripción siempre se crea en el inquilino principal del propietario de cuenta. Para mover la suscripción a otro inquilino, vea cómo cambiar un inquilino de la suscripción.

Creación de suscripciones para una cuenta de MCA

Use la información de las secciones siguientes para crear suscripciones a una cuenta de MCA.

Requisitos previos

Debe tener un rol de propietario, colaborador o creador de la suscripción de Azure en una sección de factura, o un rol de propietario o colaborador en un perfil de facturación o una cuenta de facturación para crear suscripciones. Para más información, consulte Tareas y roles de la facturación de suscripción.

En los ejemplos siguientes se usan las API REST. Actualmente, no están admitidos PowerShell ni la CLI de Azure.

Búsqueda de cuentas de facturación a las que tiene acceso

Realice la siguiente solicitud para mostrar todas las cuentas de facturación.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

La respuesta de la API muestra las cuentas de facturación a las que tiene acceso.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Contoso",
        "hasReadAccess": true,
        "organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Fabrikam",
        "hasReadAccess": true,
        "organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

Use la propiedad displayName para identificar la cuenta de facturación para la que desea crear suscripciones. Asegúrese de que el valor agreementType de la cuenta sea MicrosoftCustomerAgreement. Copie el valor de name de la cuenta. Por ejemplo, para crear una suscripción para la cuenta de facturación Contoso, copie bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Pegue este valor en algún lugar para poder usarlo en el paso siguiente.

Búsqueda de secciones de factura para crear suscripciones

Los cargos de la suscripción aparecerán en una sección de una factura del perfil de facturación. Use la siguiente API para obtener la lista de secciones de factura y perfiles de facturación en los que tiene permiso para crear suscripciones de Azure.

Realice la siguiente solicitud; para ello, reemplace <billingAccountName> por el elemento name copiado en el primer paso (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx).

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/listInvoiceSectionsWithCreateSubscriptionPermission?api-version=2019-10-01-preview

La respuesta de la API muestra todas las secciones de factura y sus perfiles de facturación en los que tiene acceso para crear suscripciones:

{
    "value": [{
        "billingProfileDisplayName": "Contoso finance",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
        "enabledAzurePlans": [{
            "productId": "DZH318Z0BPS6",
            "skuId": "0001",
            "skuDescription": "Microsoft Azure Plan"
        }, {
            "productId": "DZH318Z0BPS6",
            "skuId": "0002",
            "skuDescription": "Microsoft Azure Plan for DevTest"
        }],
        "invoiceSectionDisplayName": "Development",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx/invoiceSections/GJ77-xxxx-xxx-xxx"
    }, {
        "billingProfileDisplayName": "Contoso finance",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
        "enabledAzurePlans": [{
            "productId": "DZH318Z0BPS6",
            "skuId": "0001",
            "skuDescription": "Microsoft Azure Plan"
        }, {
            "productId": "DZH318Z0BPS6",
            "skuId": "0002",
            "skuDescription": "Microsoft Azure Plan for DevTest"
        }],
        "invoiceSectionDisplayName": "Testing",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX"
  }]
}

Use la propiedad invoiceSectionDisplayName para identificar la sección de factura para la que desea crear suscripciones. Copie los valores de invoiceSectionId, billingProfileId y uno de los valores de skuId en la sección de facturas. Por ejemplo, para crear una suscripción del tipo Microsoft Azure plan para la sección de facturas de Development, copie /providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-xxxx-xxx-xxx y 0001. Pegue los valores en algún lugar para poder usarlos en el paso siguiente.

Creación de una suscripción para una sección de factura

En el ejemplo siguiente se crea una suscripción llamada Dev Team subscription del tipo Microsoft Azure Plan para la sección de factura Development. La suscripción se factura al perfil de facturación del departamento financiero de Contoso y aparece en la sección Development de su factura.

Realice la siguiente solicitud; para ello, reemplace <invoiceSectionId> por el elemento invoiceSectionId copiado en el segundo paso (/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX). Utilice los valores billingProfileId y skuId copiados en el segundo paso en los parámetros de solicitud de la API. Para especificar los propietarios, consulte cómo obtener identificadores de objeto de usuario.

POST https://management.azure.com<invoiceSectionId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview

'{"displayName": "Dev Team subscription",
  "billingProfileId": "<billingProfileId>",
  "skuId": "<skuId>",
  "owners": [
      {
        "objectId": "<userObjectId>"
      },
      {
        "objectId": "<servicePrincipalObjectId>"
      }
    ],
  "costCenter": "35683",
  "managementGroupId": "/providers/Microsoft.Management/managementGroups/xxxxxxx",",
}'
Nombre del elemento Obligatorio Type Descripción
displayName Sí String Nombre para mostrar de la suscripción.
billingProfileId Sí String El identificador del perfil de facturación al que se facturan los cargos de la suscripción.
skuId Sí String Identificador de SKU que determina el tipo de plan de Azure.
owners No String El identificador de objeto de cualquier usuario o entidad de servicio que se agregue como propietario de Azure RBAC a la suscripción al crearla.
costCenter No String Centro de coste asociado a la suscripción. Se muestra en el archivo .csv del uso.
managementGroupId No String Identificador del grupo de administración al que se agregará la suscripción. Para obtener la lista de grupos de administración, consulte Grupos de administración: API de lista. Use el identificador de un grupo de administración de la API.

En la respuesta, se recupera un objeto subscriptionCreationResult para la supervisión. Cuando finaliza la creación de la suscripción, el objeto subscriptionCreationResult devuelve un objeto subscriptionLink, el cual incluye el identificador de la suscripción.

Creación de suscripciones para una cuenta de facturación de MPA

Use la información de las secciones siguientes para crear suscripciones a una cuenta de facturación de MPA.

Requisitos previos

Debe tener un rol Administrador global o Agente de administración en la cuenta de proveedor de soluciones en la nube de su organización para crear una suscripción para la cuenta de facturación. Para más información, consulte Centro de partners: Asignar roles y permisos de usuarios.

En los ejemplos siguientes se usan las API REST. Actualmente, no están admitidos PowerShell ni la CLI de Azure.

Búsqueda de cuentas de facturación a las que tiene acceso

Realice la solicitud siguiente para mostrar todas las cuentas de facturación a las que tiene acceso.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

La respuesta de la API muestra las cuentas de facturación.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftPartnerAgreement",
        "displayName": "Contoso",
        "hasReadAccess": true,
        "organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Fabrikam",
        "hasReadAccess": true,
        "organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

Use la propiedad displayName para identificar la cuenta de facturación para la que desea crear suscripciones. Asegúrese de que el valor agreementType de la cuenta sea MicrosoftPartnerAgreement. Copie el valor name de la cuenta. Por ejemplo, para crear una suscripción para la cuenta de facturación Contoso, copie cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Pegue este valor en algún lugar para poder usarlo en el paso siguiente.

Búsqueda de clientes que tienen planes de Azure

Realice la solicitud siguiente, reemplazando <billingAccountName> por el valor name copiado en el primer paso (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) para enumerar todos los clientes de la cuenta de facturación para los que puede crear suscripciones de Azure.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/customers?api-version=2019-10-01-preview

La respuesta de la API muestra los clientes de la cuenta de facturación con planes de Azure. Puede crear suscripciones para los clientes.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "name": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "properties": {
        "billingProfileDisplayName": "Contoso USD",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
        "displayName": "Fabrikam toys"
      },
      "type": "Microsoft.Billing/billingAccounts/customers"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "properties": {
        "billingProfileDisplayName": "Fabrikam sports",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
        "displayName": "Fabrikam bakery"
      },
      "type": "Microsoft.Billing/billingAccounts/customers"
    }]
}

Use la propiedad displayName para identificar al cliente para el que desea crear suscripciones. Copie el valor id del cliente. Por ejemplo, para crear una suscripción para Fabrikam toys, copie /providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b. Pegue el valor en algún lugar para usarlo en los pasos siguientes.

Opcional para proveedores indirectos: Obtención de los revendedores de un cliente

Como proveedor indirecto del modelo de dos niveles de CSP, puede especificar un revendedor mientras crea suscripciones para los clientes.

Realice la solicitud siguiente, reemplazando <customerId> por el valor id copiado en el segundo paso (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) para enumerar todos los revendedores que están disponibles para un cliente.

GET https://management.azure.com<customerId>?$expand=resellers&api-version=2019-10-01-preview

La respuesta de la API muestra los revendedores del cliente:

{
  "value": [{
  "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "type": "Microsoft.Billing/billingAccounts/customers",
  "properties": {
    "displayName": "Fabrikam toys",
    "resellers": [
      {
        "resellerId": "3xxxxx",
        "description": "Wingtip"
      }
    ]
  }
},
{
  "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "type": "Microsoft.Billing/billingAccounts/customers",
  "properties": {
    "displayName": "Fabrikam toys",
    "resellers": [
      {
        "resellerId": "5xxxxx",
        "description": "Tailspin"
      }
    ]
  }
}]
}

Use la propiedad description para identificar al revendedor que se va a asociar con la suscripción. Copie el valor resellerId del revendedor. Por ejemplo, para asociar Wingtip, copie 3xxxxx. Pegue este valor en algún lugar para poder usarlo en el paso siguiente.

Creación de una suscripción para un cliente

En el ejemplo siguiente, se crea una suscripción denominada Dev Team subscription para Fabrikam toys y se asocia el revendedor Wingtip a esa suscripción.

Realice la siguiente solicitud; para ello, reemplace <customerId> por el elemento id copiado en el segundo paso (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b). Debe pasar el valor resellerId copiado en el segundo paso en los parámetros de solicitud de la API.

POST https://management.azure.com<customerId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview

'{"displayName": "Dev Team subscription",
  "skuId": "0001",
  "resellerId": "<resellerId>",
}'
Nombre del elemento Obligatorio Type Descripción
displayName Sí String Nombre para mostrar de la suscripción.
skuId Sí String El identificador de SKU del plan de Azure. Use 0001 para las suscripciones de tipo Microsoft Azure Plan.
resellerId No String Use el identificador del revendedor que se va a asociar a la suscripción.

En la respuesta, se recupera un objeto subscriptionCreationResult para la supervisión. Cuando finaliza la creación de la suscripción, el objeto subscriptionCreationResult devuelve un objeto subscriptionLink. Tiene el identificador de la suscripción.

Pasos siguientes

  • Para ver y obtener un ejemplo de creación de suscripciones de Contrato Enterprise (EA) mediante .NET, consulte el ejemplo de código en GitHub.