Membuat langganan Azure secara terprogram dengan API lama

Artikel ini membantu Anda membuat langganan Azure secara terprogram menggunakan API pratinjau lama kami. Dalam artikel ini, Anda mempelajari cara membuat langganan secara terprogram menggunakan Azure Resource Manager.

Kami memiliki artikel baru untuk versi API terbaru untuk digunakan dengan jenis langganan perjanjian Azure yang berbeda:

Namun, Anda masih dapat menggunakan informasi di artikel ini jika Anda tidak ingin menggunakan versi API terbaru.

Pelanggan Azure dengan akun penagihan untuk jenis perjanjian berikut ini dapat membuat langganan secara terprogram:

  • Perjanjian Perusahaan
  • Perjanjian Pelanggan Microsoft (MCA)
  • Perjanjian Mitra Microsoft (MPA)

Saat Anda membuat langganan Azure secara terprogram, langganan diatur oleh perjanjian di mana Anda mendapatkan layanan Azure dari Microsoft atau penjual resmi. Untuk informasi selengkapnya, lihat Informasi Hukum Microsoft Azure.

Catatan

Sebaiknya Anda menggunakan modul Azure Az PowerShell untuk berinteraksi dengan Azure. Lihat Menginstal Azure PowerShell untuk memulai. Untuk mempelajari cara bermigrasi ke modul Az PowerShell, lihat Memigrasikan Azure PowerShell dari AzureRM ke Az.

Anda tidak dapat membuat paket dukungan secara terprogram. Anda dapat membeli paket dukungan baru atau meningkatkannya di portal Azure. Navigasi ke Bantuan + dukungan lalu di bagian atas halaman, pilih Pilih paket dukungan yang tepat.

Membuat langganan untuk akun penagihan EA

Gunakan informasi di bagian berikut untuk membuat langganan EA.

Prasyarat

Anda harus memiliki peran Pemilik pada Akun Pendaftaran atau menjadi Administrator Perusahaan untuk membuat langganan. Ada dua cara untuk mendapatkan peran:

Menemukan akun yang dapat Anda akses

Setelah Anda ditambahkan ke Akun Pendaftaran yang terkait dengan Pemilik Akun, Azure menggunakan hubungan akun-ke-pendaftaran untuk menentukan tempat untuk menagih biaya langganan. Semua langganan yang dibuat di bawah akun ditagih ke pendaftaran EA tempat akun tersebut berada. Untuk membuat langganan, Anda harus meneruskan nilai tentang akun pendaftaran dan perwakilan pengguna untuk memiliki langganan.

Untuk menjalankan perintah berikut, Anda harus masuk ke direktori beranda Pemilik Akun, yang merupakan direktori tempat langganan dibuat secara default.

Minta untuk mencantumkan semua akun pendaftaran yang dapat Anda akses:

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

Respons API mencantumkan semua akun pendaftaran yang dapat Anda akses:

{
  "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"
      }
    }
  ]
}

Gunakan properti principalName untuk mengidentifikasi akun yang Anda inginkan agar langganan ditagih. Salin name akun itu. Misalnya, buat langganan di bawah SignUpEngineering@contoso.com akun pendaftaran, salin 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Pengidentifikasi adalah ID objek dari akun pendaftaran. Tempelkan nilai di suatu tempat sehingga Anda dapat menggunakannya di langkah berikutnya sebagai enrollmentAccountObjectId.

Membuat langganan di bawah akun pendaftaran tertentu

Contoh berikut membuat langganan bernama Langganan Tim Dev di akun pendaftaran yang dipilih di langkah sebelumnya. Penawaran berlangganan adalah MS-AZR-0017P (Perjanjian Perusahaan Microsoft biasa). Ini juga secara opsional menambahkan dua pengguna sebagai Pemilik Azure RBAC untuk langganan.

Buat permintaan berikut, ganti <enrollmentAccountObjectId> dengan name disalin dari langkah pertama (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Untuk menentukan pemilik, lihat cara mendapatkan ID objek pengguna.

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>"
    }
  ]
}
Nama Elemen Wajib Tipe Deskripsi
displayName No String Nama tampilan langganan. Jika tidak ditentukan, ini diatur ke nama penawaran, seperti "Microsoft Azure Enterprise."
offerType Ya String Penawaran langganan. Dua opsi untuk EA adalah MS-AZR-0017P (penggunaan produksi) dan MS-AZR-0148P (dev/test, perlu diaktifkan dalam portal Azure).
owners No String ID Objek setiap pengguna yang akan ditambahkan sebagai Pemilik Azure RBAC pada langganan saat dibuat.

Dalam respons, sebagai bagian dari header Location, Anda mendapatkan kembali url yang bisa Anda kueri untuk status pada operasi pembuatan langganan. Setelah pembuatan langganan selesai, url Location DAPATKAN di akan mengembalikan subscriptionLink objek, yang memiliki ID langganan. Untuk detail selengkapnya, lihat Dokumentasi API langganan

Batasan API pembuatan langganan Azure Enterprise

  • Hanya langganan Azure Enterprise yang dapat dibuat menggunakan API.
  • Ada batasan 5000 langganan per akun pendaftaran. Setelah itu, lebih banyak langganan untuk akun hanya dapat dibuat di portal Microsoft Azure. Jika Anda ingin membuat lebih banyak langganan melalui API, buat akun pendaftaran lain. Langganan yang dibatalkan, dihapus, dan ditransfer dihitung dalam batasan 5000.
  • Pengguna yang bukan Pemilik Akun, tetapi ditambahkan ke akun pendaftaran dengan Azure RBAC, tidak dapat membuat langganan di portal Microsoft Azure.
  • Anda tidak bisa memilih penyewa untuk membuat langganan. Langganan selalu dibuat di penyewa rumah Pemilik Akun. Untuk memindahkan langganan ke penyewa lain, lihat mengubah penyewa langganan.

Membuat langganan untuk akun MCA

Gunakan informasi di bagian berikut untuk membuat langganan akun MCA.

Prasyarat

Anda harus memiliki peran pemilik, kontributor, atau pembuat langganan Azure di bagian faktur, atau peran pemilik atau kontributor di profil tagihan, atau akun tagihan untuk membuat langganan. Untuk informasi selengkapnya, lihat Peran dan tugas penagihan langganan.

Contoh berikut menggunakan REST API. Saat ini, PowerShell dan Azure CLI tidak didukung.

Menemukan akun penagihan yang dapat Anda akses

Buat permintaan berikut untuk mencantumkan semua akun penagihan.

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

Respons API mencantumkan akun penagihan yang dapat Anda akses.

{
  "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"
    }
  ]
}

Gunakan properti displayName untuk mengidentifikasi akun penagihan yang ingin Anda buat langganannya. Pastikan, agreementType akun adalah MicrosoftCustomerAgreement. Salin name akun tersebut. Misalnya, untuk membuat langganan untuk akun penagihan Contoso, salin 5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Tempelkan nilai di suatu tempat sehingga Anda dapat menggunakannya di langkah berikutnya.

Menemukan bagian faktur untuk membuat langganan

Biaya untuk langganan Anda muncul di bagian faktur profil tagihan. Gunakan API berikut untuk mendapatkan daftar bagian faktur dan profil penagihan tempat Anda memiliki izin untuk membuat langganan Azure.

Buat permintaan berikut, ganti <billingAccountName> dengan name disalin dari langkah pertama (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

Respons API mencantumkan semua bagian faktur dan profil penagihannya tempat Anda memiliki akses untuk membuat langganan:

{
    "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"
  }]
}

Gunakan properti invoiceSectionDisplayName untuk mengidentifikasi bagian faktur yang ingin Anda buat langganannya. Salin invoiceSectionId, billingProfileId, dan salah satu skuId untuk bagian faktur. Misalnya, untuk membuat langganan jenis Microsoft Azure plan untu Development bagian faktur, salin /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, dan 0001. Tempelkan nilai di suatu tempat sehingga Anda dapat menggunakannya di langkah berikutnya.

Membuat langganan untuk bagian faktur

Contoh berikut membuat langganan bernama langganan Tim Dev dari jenis Rencana Microsoft Azure untuk bagian faktur Pengembangan. Langganan ditagihkan ke profil penagihan keuangan Contoso dan muncul di bagian Pengembangan di fakturnya.

Buat permintaan berikut, mengganti <invoiceSectionId> dengan invoiceSectionId disalin dari langkah kedua (/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). Berikan billingProfileId dan skuId disalin dari langkah kedua dalam parameter permintaan API. Untuk menentukan pemilik, lihat cara mendapatkan ID objek pengguna.

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",",
}'

Nama Elemen Wajib Tipe Deskripsi
displayName Ya String Nama tampilan langganan.
billingProfileId Ya String ID profil penagihan yang ditagih untuk biaya langganan.
skuId Ya String ID sku yang menentukan jenis paket Azure.
owners No String ID objek dari setiap pengguna atau perwakilan layanan untuk ditambahkan sebagai Pemilik Azure RBAC pada langganan saat dibuat.
costCenter No String Pusat biaya yang terkait dengan langganan. Ini muncul dalam file CSV penggunaan.
managementGroupId No String ID grup manajemen tempat langganan akan ditambahkan. Untuk mendapatkan daftar grup manajemen, lihat Grup Manajemen - Daftar API. Gunakan ID grup manajemen dari API.

Sebagai tanggapan, Anda mendapatkan kembali objek subscriptionCreationResult untuk pemantauan. Setelah pembuatan langganan selesai, objek subscriptionCreationResult mengembalikan objek subscriptionLink, yang memiliki ID langganan.

Membuat langganan untuk akun penagihan MPA

Gunakan informasi di bagian berikut untuk membuat langganan akun penagihan MPA.

Prasyarat

Anda harus memiliki peran Admin Global atau Agen Admin di akun Penyedia Solusi Cloud organisasi Anda untuk membuat langganan untuk akun penagihan. Untuk mengetahui informasi selengkapnya tentang peran pusat mitra, lihat Pusat Mitra - Menetapkan peran dan izin pengguna.

Contoh berikut menggunakan REST API. Saat ini, PowerShell dan Azure CLI tidak didukung.

Menemukan akun penagihan yang dapat Anda akses

Buat permintaan di bawah ini untuk mencantumkan semua akun penagihan yang dapat Anda akses.

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

Respons API mencantumkan akun penagihan.

{
  "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"
    }
  ]
}

Gunakan properti displayName untuk mengidentifikasi akun penagihan yang ingin Anda buat langganannya. Pastikan, agreementType akun adalah MicrosoftPartnerAgreement. Salin name untuk akun tersebut. Misalnya, untuk membuat langganan untuk akun penagihan Contoso, salin 99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Tempelkan nilai di suatu tempat sehingga Anda dapat menggunakannya di langkah berikutnya.

Menemukan pelanggan yang memiliki paket Azure

Buat permintaan berikut, mengganti <billingAccountName> dengan name disalin dari langkah pertama (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) untuk mencantumkan semua pelanggan di akun penagihan yang dapat Anda buat langganan Azure.

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

Respons API mencantumkan pelanggan di akun penagihan dengan paket Azure. Anda dapat membuat langganan untuk pelanggan.

{
  "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"
    }]
}

Gunakan properti displayName untuk mengidentifikasi pelanggan yang ingin Anda buat langganannya. Salin id untuk pelanggan. Misalnya, untuk membuat langganan untuk Fabrikam toys, salin /providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx. Tempelkan nilai di suatu tempat untuk menggunakannya di langkah-langkah selanjutnya.

Opsional untuk Penyedia tidak langsung: Mendapatkan penjual untuk pelanggan

Jika Anda adalah Penyedia tidak langsung dalam model dua tingkat CSP, Anda dapat menentukan penjual saat membuat langganan untuk pelanggan.

Buat permintaan berikut, mengganti <customerId> dengan id disalin dari langkah kedua (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx) untuk mencantumkan semua penjual yang tersedia untuk pelanggan.

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

Respons API mencantumkan reseller untuk pelanggan:

{
  "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"
      }
    ]
  }
}]
}

Gunakan properti description untuk mengidentifikasi penjual yang akan dikaitkan dengan langganan. Salin resellerId untuk penjual. Misalnya, untuk mengaitkan Wingtip, salin 3xxxxx. Tempelkan nilai di suatu tempat sehingga Anda dapat menggunakannya di langkah berikutnya.

Membuat langganan untuk pelanggan

Contoh berikut membuat langganan bernama Langganan Tim Dev untuk Fabrikam toys dan mengaitkan reseller Wingtip ke langganan.

Buat permintaan berikut, mengganti <customerId> dengan id disalin dari langkah kedua (/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx). Berikan resellerId opsional yang disalin dari langkah kedua dalam parameter permintaan 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>",
}'
Nama Elemen Wajib Tipe Deskripsi
displayName Ya String Nama tampilan langganan.
skuId Ya String ID sku dari paket Azure. Menggunakan 0001 untuk langganan jenis Microsoft Azure
resellerId No String ID penjual yang akan dikaitkan dengan langganan.

Sebagai tanggapan, Anda mendapatkan kembali objek subscriptionCreationResult untuk pemantauan. Setelah pembuatan langganan selesai, objek subscriptionCreationResult akan mengembalikan objek subscriptionLink. Ini memiliki ID langganan.

Langkah berikutnya

  • Untuk melihat dan contoh pembuatan langganan Perjanjian Perusahaan (EA) menggunakan .NET, lihat contoh kode pada GitHub.