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:
- Membuat langganan EA secara terprogram dengan API terbaru
- Membuat langganan MCA secara terprogram dengan API terbaru
- Membuat langganan MPA secara terprogram dengan API terbaru
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:
- Admin Perusahaan dari pendaftaran Anda dapat menjadikan Anda Pemilik Akun (wajib masuk) yang menjadikan Anda Pemilik Akun Pendaftaran.
- Pemilik Akun Pendaftaran yang ada dapat memberi Anda akses. Demikian pula, untuk menggunakan perwakilan layanan untuk membuat langganan EA, Anda harus memberikan layanan tersebut kemampuan untuk membuat langganan.
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.
- Setelah membuat langganan, Anda dapat memberikan kemampuan tersebut kepada pengguna lain dan perwakilan layanan. Informasi selengkapnya, lihat Memberikan akses untuk membuat langganan Azure Enterprise (pratinjau).
- Untuk mengetahui informasi selengkapnya tentang mengelola langganan dalam jumlah besar menggunakan grup manajemen, lihat Mengelola sumber daya Anda dengan grup manajemen Azure.