مشاركة عبر

أنشئ اشتراكات Azure برمجياً باستخدام واجهات برمجة التطبيقات القديمة

  • مقالة

تساعدك هذه المقالة في إنشاء اشتراكات Azure برمجياً باستخدام واجهة برمجة تطبيقات المعاينة القديمة الخاصة بنا. في هذه المقالة، ستتعرف على كيفية إنشاء اشتراكات برمجياً باستخدام مدير موارد Azure.

لدينا مقالات جديدة لأحدث إصدار من واجهة برمجة التطبيقات للاستخدام مع أنواع اشتراك مختلفة لاتفاقية Azure:

ومع ذلك، لا يزال بإمكانك استخدام المعلومات الواردة في هذه المقالة إذا كنت لا تريد استخدام أحدث إصدار من واجهة برمجة التطبيقات.

يمكن لعملاء Azure الذين لديهم حساب فوترة لأنواع الاتفاقيات التالية إنشاء اشتراكات برمجياً:

  • اتفاقية Enterprise
  • اتفاقية العملاء من Microsoft (MCA)
  • اتفاقية شركاء Microsoft (MPA)

عند إنشاء اشتراك Azure برمجياً، يخضع الاشتراك للاتفاقية التي حصلت بموجبها على خدمات Azure من Microsoft أو من بائع معتمد. لمزيد من المعلومات، راجع معلومات Microsoft Azure القانونية .

إشعار

نوصي باستخدام الوحدة النمطية Azure Az PowerShell للتفاعل مع Azure. للبدء، راجع تثبيت Azure PowerShell. لمعرفة كيفية الترحيل إلى الوحدة النمطية Az PowerShell، راجع ترحيل Azure PowerShell من AzureRM إلى Az.

لا يمكنك إنشاء خطط الدعم برمجيا. يمكنك شراء خطة دعم جديدة أو ترقية خطة في مدخل Microsoft Azure. انتقل إلى Help + support ثم في أعلى الصفحة، حدد Choose the right support plan.

إنشاء اشتراكات لحساب فوترة EA

استخدم المعلومات الواردة في الأقسام التالية لإنشاء اشتراكات EA.

المتطلبات الأساسية

يجب أن يكون لديك دور المالك في حساب التسجيل أو أن تكون مسؤول المؤسسة لإنشاء اشتراك. هناك طريقتان للحصول على الدور:

ابحث عن الحسابات التي لديك حق الوصول إليها

بعد إضافتك إلى حساب التسجيل المرتبط بمالك الحساب، يستخدم Azure علاقة الحساب بالتسجيل لتحديد مكان فوترة رسوم الاشتراك. يتم إصدار فاتورة بجميع الاشتراكات التي تم إنشاؤها بموجب الحساب إلى تسجيل EA الموجود به الحساب. لإنشاء اشتراكات، يجب عليك تمرير قيم حول حساب التسجيل وأساسيات المستخدم لامتلاك الاشتراك.

لتشغيل الأوامر التالية، يجب تسجيل الدخول إلى الدليل الرئيسي لمالك الحساب، وهو الدليل الذي يتم فيه إنشاء الاشتراكات بشكل افتراضي.

طلب إدراج جميع حسابات التسجيل التي يمكنك الوصول إليها:

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

تسرد استجابة واجهة برمجة التطبيقات جميع حسابات التسجيل التي يمكنك الوصول إليها:

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/enrollmentAccounts/747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "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"
      }
    }
  ]
}

استخدم الخاصية principalName لتحديد الحساب الذي تريد إصدار فواتير الاشتراكات إليه. انسخ name من هذا الحساب. على سبيل المثال، قم بإنشاء اشتراكات ضمن SignUpEngineering@contoso.com حساب التسجيل، انسخ 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx. المعرف هو معرف الكائن لحساب التسجيل. الصق القيمة في مكان ما بحيث يمكنك استخدامها في الخطوة التالية كـ enrollmentAccountObjectId.

إنشاء اشتراكات تحت حساب تسجيل محدد

ينشئ المثال التالي اشتراكاً باسم Dev Team Subscription في حساب التسجيل المحدد في الخطوة السابقة. عرض الاشتراك هو MS-AZR-0017P (اتفاقية Microsoft Enterprise العادية). كما أنه يضيف بشكل اختياري مستخدمين كمالكين لـ Azure RBAC للاشتراك.

قم بإجراء الطلب التالي، مع استبدال <enrollmentAccountObjectId> بـ name المنسوخ من الخطوة الأولى (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx). لتحديد المالكين، راجع كيفية الحصول على معرفات عناصر المستخدم .

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>"
    }
  ]
}
اسم العنصر المطلوب نوع ‏‏الوصف
displayName لا السلسلة‬ اسم العرض للاشتراك. إذا لم يتم تحديده، يتم تعيينه على اسم العرض، مثل "Microsoft Azure Enterprise".
offerType ‏‏نعم‬ السلسلة‬ عرض الاشتراك. الخياران ل EA هما MS-AZR-0017P (استخدام الإنتاج) وMS-AZR-0148P (dev/test، يجب تمكينهما في مدخل Microsoft Azure).
owners لا السلسلة‬ معرف الكائن لأي مستخدم ستتم إضافته كمالك Azure RBAC على الاشتراك عند إنشائه.

في الاستجابة، كجزء من الرأس Location، يمكنك الحصول على عنوان url يمكنك الاستعلام عنه عن الحالة في عملية إنشاء الاشتراك. عند الانتهاء من إنشاء الاشتراك، سيعيد عنوان URL لـ GET على Location كائن subscriptionLink، الذي يحتوي على معرف الاشتراك. لمزيد من التفاصيل، راجع وثائق واجهة برمجة تطبيقات الاشتراك

قيود إنشاء اشتراك واجهة برمجة التطبيقاتAzure Enterprise

  • يمكن إنشاء اشتراكات Azure Enterprise فقط باستخدام واجهة برمجة التطبيقات.
  • يوجد حد 5000 اشتراك لكل حساب تسجيل. بعد ذلك، لا يمكن إنشاء المزيد من الاشتراكات للحساب إلا في مدخل Azure. إذا كنت ترغب في إنشاء المزيد من الاشتراكات من خلال واجهة برمجة التطبيقات، فقم بإنشاء حساب تسجيل آخر. تحتسب الاشتراكات التي تم إلغاؤها وحذفها وتحويلها من حد 5000.
  • لا يمكن للمستخدمين الذين ليسوا مالكي حسابات، ولكن تمت إضافتهم إلى حساب تسجيل مع Azure RBAC، إنشاء اشتراكات في مدخل Azure.
  • لا يمكنك تحديد المستأجر للاشتراك الذي سيتم إنشاؤه فيه. يتم إنشاء الاشتراك دائماً في المستأجر الرئيسي لمالك الحساب. لنقل الاشتراك إلى مستأجر مختلف، راجع تغيير مستأجر الاشتراك .

إنشاء اشتراكات لحساب MCA

استخدم المعلومات الواردة في الأقسام التالية لإنشاء اشتراكات لحساب MCA.

المتطلبات الأساسية

يجب أن يكون لديك دور مالك أو مساهم أو منشئ اشتراك Azure في قسم الفاتورة أو دور المالك أو المساهم في ملف تعريف الفوترة أو حساب الفوترة لإنشاء اشتراكات. لمزيد من المعلومات، راجع مهام وأدوار فواتير الاشتراك .

تستخدم الأمثلة التالية واجهات برمجة تطبيقات REST. حالياً، PowerShell و Azure CLI غير مدعومين.

البحث عن حسابات الفوترة التي يمكنك الوصول إليها

قم بإجراء الطلب التالي لسرد جميع حسابات الفواتير.

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

تسرد استجابة واجهة برمجة التطبيقات حسابات الفواتير التي لديك حق الوصول إليها.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "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"
    }
  ]
}

استخدم الخاصية displayName لتحديد حساب الفوترة الذي تريد إنشاء اشتراكات له. تأكد من أن نوع اتفاقية الحساب هو اتفاقية عملاء Microsoft . انسخ name الحساب. على سبيل المثال، لإنشاء اشتراك في Contoso حساب الفواتير، انسخ 5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. الصق القيمة في مكان ما بحيث يمكنك استخدامها في الخطوة التالية.

ابحث عن أقسام الفاتورة لإنشاء اشتراكات

تظهر رسوم اشتراكك في قسم من فاتورة ملف تعريف الفوترة. استخدم واجهة برمجة التطبيقات التالية للحصول على قائمة أقسام الفواتير وملفات تعريف الفوترة التي لديك إذن لإنشاء اشتراكات Azure عليها.

قم بإجراء الطلب التالي، مع استبدال <billingAccountName> بـ name المنسوخ من الخطوة الأولى (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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

تسرد استجابة واجهة برمجة التطبيقات (API) جميع أقسام الفاتورة وملفات تعريف الفوترة الخاصة بها والتي يمكنك الوصول إليها لإنشاء اشتراكات:

{
    "value": [{
        "billingProfileDisplayName": "Contoso finance",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX"
  }]
}

استخدم الخاصية invoiceSectionDisplayName لتحديد قسم الفاتورة الذي تريد إنشاء اشتراكات له. انسخ invoiceSectionId وbillingProfileId وأحد skuId لقسم الفاتورة. على سبيل المثال، لإنشاء اشتراك من النوع Microsoft Azure plan في Development قسم الفاتورة، انسخ /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX و/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-xxxx-xxx-xxx و0001. الصق القيم في مكان ما بحيث يمكنك استخدامها في الخطوة التالية.

إنشاء اشتراك لقسم الفاتورة

ينشئ المثال التالي اشتراكاً باسم اشتراك Dev Team من النوع خطة Microsoft Azure لقسم فاتورة التطوير . يتم إرسال فاتورة بالاشتراك إلى ملف الفوترة الخاص بـ شركة Contoso finance ويظهر في قسم التطوير في فاتورته.

قم بإجراء الطلب التالي، مع استبدال <invoiceSectionId> بـ invoiceSectionId المنسوخ من الخطوة الثانية (/providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX). قم بتمرير billingProfileId وskuId المنسوخة من الخطوة الثانية في معلمات الطلب لواجهة برمجة التطبيقات. لتحديد المالكين، راجع كيفية الحصول على معرفات عناصر المستخدم .

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",",
}'
اسم العنصر المطلوب نوع ‏‏الوصف
displayName ‏‏نعم‬ السلسلة‬ اسم العرض للاشتراك.
billingProfileId ‏‏نعم‬ السلسلة‬ معرّف ملف تعريف الفوترة الذي يتم تحرير فواتير به مقابل رسوم الاشتراك.
skuId ‏‏نعم‬ السلسلة‬ معرف sku الذي يحدد نوع خطة Azure.
owners لا السلسلة‬ معرف الكائن لأي مستخدم أو مدير خدمة يتم إضافته كمالك Azure RBAC في الاشتراك عند إنشائه.
costCenter لا السلسلة‬ مركز التكلفة المرتبط بالاشتراك. يظهر في ملف الاستخدام CSV.
managementGroupId لا السلسلة‬ معرّف مجموعة الإدارة التي سيتم إضافة الاشتراك إليها. للحصول على قائمة مجموعات الإدارة، راجع مجموعات الإدارة - قائمة API . استخدم معرّف مجموعة الإدارة من واجهة برمجة التطبيقات.

في الاستجابة، تحصل على كائن subscriptionCreationResult للمراقبة. عند الانتهاء من إنشاء الاشتراك، يقوم الكائن subscriptionCreationResult بإرجاع كائن subscriptionLink، له معرف الاشتراك.

إنشاء اشتراكات لحساب فوترة MPA

استخدم المعلومات الواردة في الأقسام التالية لإنشاء اشتراكات لحساب فوترة MPA.

المتطلبات الأساسية

يجب أن يكون لديك دور مسؤول عالمي أو وكيل إداري في حساب Cloud Solution Provider الخاص بمؤسستك لإنشاء اشتراك لحساب الفوترة الخاص بك. لمزيد من المعلومات، راجع مركز الشركاء - تعيين أدوار المستخدمين وأذوناتهم .

تستخدم الأمثلة التالية واجهات برمجة تطبيقات REST. حالياً، PowerShell و Azure CLI غير مدعومين.

ابحث عن حسابات الفواتير التي يمكنك الوصول إليها

قدم الطلب أدناه لسرد جميع حسابات الفواتير التي لديك حق الوصول إليها.

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

تسرد استجابة واجهة برمجة التطبيقات حسابات الفوترة.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "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"
    }
  ]
}

استخدم الخاصية displayName لتحديد حساب الفوترة الذي تريد إنشاء اشتراكات له. تأكد من أن نوع اتفاقية الحساب هو اتفاقية شركاء Microsoft . انسخ name للحساب. على سبيل المثال، لإنشاء اشتراك في Contoso حساب الفواتير، انسخ 99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. الصق القيمة في مكان ما بحيث يمكنك استخدامها في الخطوة التالية.

ابحث عن العملاء الذين لديهم خطط Azure

قم بإجراء الطلب التالي، مع استبدال <billingAccountName> بـ name المنسوخة من الخطوة الأولى (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) لإدراج جميع العملاء في حساب الفوترة الذين يمكنك إنشاء اشتراكات Azure لهم.

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

تسرد استجابة واجهة برمجة التطبيقات العملاء في حساب الفوترة مع خطط Azure. يمكنك إنشاء اشتراكات للعملاء.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "properties": {
        "billingProfileDisplayName": "Contoso USD",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
        "displayName": "Fabrikam bakery"
      },
      "type": "Microsoft.Billing/billingAccounts/customers"
    }]
}

استخدم الخاصية displayName لتحديد العميل الذي تريد إنشاء اشتراكات له. انسخ id للعميل. على سبيل المثال، لإنشاء اشتراك لـ Fabrikam toys، انسخ /providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx. الصق القيمة في مكان ما لاستخدامها في خطوات لاحقة.

اختياري لموفري الخدمات غير المباشرة: احصل على البائعين للعميل

إذا كنت موفراً غير مباشر في نموذج CSP ثنائي المستوى، فيمكنك تحديد مورِّد أثناء إنشاء اشتراكات للعملاء.

قدم الطلب التالي، واستبدل <customerId> بـ id المنسوخ من الخطوة الثانية (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx) لإدراج جميع الموردين المتاحين للعميل.

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

تسرد استجابة واجهة برمجة التطبيقات البائعين للعميل:

{
  "value": [{
  "id": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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"
      }
    ]
  }
}]
}

استخدم الخاصية description لتحديد المورِّد المراد ربطه بالاشتراك. انسخ resellerId الخاص بالمورِّد. على سبيل المثال، لربط Wingtip، انسخ 3xxxxx. الصق القيمة في مكان ما بحيث يمكنك استخدامها في الخطوة التالية.

إنشاء اشتراك للعميل

ينشئ المثال التالي اشتراكاً باسم اشتراك Dev Team لـ Fabrikam toys ومورد Wingtip للاشتراك.

قم بإجراء الطلب التالي، مع استبدال <customerId> بـ id المنسوخ من الخطوة الثانية (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx). قم بتمرير resellerId الاختياري المنسوخ من الخطوة الثانية في معلمات الطلب لواجهة برمجة التطبيقات.

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

'{"displayName": "Dev Team subscription",
  "skuId": "0001",
  "resellerId": "<resellerId>",
}'
اسم العنصر المطلوب نوع ‏‏الوصف
displayName ‏‏نعم‬ السلسلة‬ اسم العرض للاشتراك.
skuId ‏‏نعم‬ السلسلة‬ معرف SKU لخطة Azure. استخدم 0001 للاشتراكات من نوع Microsoft Azure Plan
resellerId لا السلسلة‬ معرف البائع الذي سيتم إقرانه بالاشتراك.

في الاستجابة، تحصل على كائن subscriptionCreationResult للمراقبة. عند الانتهاء من إنشاء الاشتراك، يقوم الكائن subscriptionCreationResult بإرجاع كائن subscriptionLink. لديها معرف الاشتراك.

الخطوات التالية