Mengalihkan langganan perdagangan baru
Berlaku Untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS
Peran yang sesuai
- Admin global
- Agen admin
Metode ini mendukung langganan sumber perdagangan tradisional dan baru.
Catatan
Pengalaman perdagangan baru untuk layanan berbasis lisensi mencakup banyak kemampuan baru dan tersedia untuk semua Penyedia Solusi Cloud (CSP). Untuk informasi selengkapnya, lihat gambaran umum pengalaman perdagangan baru.
Digunakan untuk meningkatkan langganan perdagangan baru pelanggan ke langganan target atau mengonversi uji coba NCE ke langganan berbayar. Untuk transisi langganan, dua permintaan API perlu dibuat. Transisi GET pertama yang memenuhi syarat untuk mendapatkan SKU yang tersedia untuk peningkatan. Kemudian transisi POST untuk menjalankan transisi.
Mendapatkan kelayakan transisi
Mengembalikan daftar transisi yang memenuhi syarat untuk pelanggan tertentu, langganan, dan jenis yang diminta. Juga mengembalikan kelayakan peningkatan langganan tujuan. Kelayakan transisi dapat mencakup penawaran yang berada dalam status EndofSaleWithConversions.
Prasyarat
Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
ID pelanggan (
customer-tenant-id). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih ruang kerja Pelanggan , lalu pelanggan dari daftar pelanggan, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id).ID langganan untuk langganan awal.
Peran GDAP
Anda akan memerlukan setidaknya salah satu peran GDAP berikut:
- Pembaca Direktori
- Pembaca Global
Catatan
Meskipun API ini tersedia untuk warisan dan NCE, GDAP hanya diperlukan untuk warisan.
Permintaan REST
Minta sintaks
| Metode | URI Permintaan |
|---|---|
| DAPATKAN | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType={immediate, scheduled} HTTP/1.1 |
Parameter URI
Gunakan parameter kueri berikut untuk mengembalikan transisi yang memenuhi syarat.
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| customer-tenant-id | Guid | Y | GUID yang sesuai dengan penyewa pelanggan. |
| id langganan | Guid | Y | GUID yang sesuai dengan langganan awal. |
| eligibilityType | tali | N | Menjelaskan kapan transisi akan dijalankan; dapat segera atau terjadwal. Defaultnya adalah Immediate. |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi permintaan
Tidak
Contoh permintaan
GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitionEligibilities?eligibilityType=immediate HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US
Respons REST
Jika berhasil, metode ini mengembalikan daftar transisi yang memenuhi syarat untuk langganan yang diberikan dalam isi respons.
Kode kesalahan dan keberhasilan respons
Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan lainnya. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, lihat Kode Kesalahan.
Kesalahan kelayakan
Deskripsi kesalahan dan arti.
| Deskripsi kesalahan | Makna |
|---|---|
| Langganan tidak dapat Ditransisikan - langganan sumber tidak aktif. | Sub status asli tidak Aktif |
| Langganan tidak dapat Ditransisikan - langganan sumber belum disediakan. | Sub FulfillmentState asli tidak berhasil |
| Jenis transisi tidak kompatibel - Pemetaan langganan AzureAD diperlukan. | Kesalahan LegacyCannotConvertSubscriptionId saat memanggil GetSubscriptionUpgradeConflicts |
| Jenis transisi tidak kompatibel - langganan yang bertentangan untuk transfer lisensi ada. | Jika ada layanan Microsoft Entra yang memiliki ID langganan dari langganan lain, tambahkan ke daftar konflik (termasuk pembelian yang dilakukan dengan alur pembelian warisan atau modern) |
Kesalahan kelayakan langganan
Jika langganan tujuan tidak memenuhi syarat untuk dimutakhirkan, salah satu alasan berikut akan dikembalikan.
Daftar kosong akan dikembalikan jika langganan sumber adalah uji coba atau jika eligibilityType ditentukan sebagai Terjadwal. Anda hanya dapat beralih ke langganan yang ada dengan transisi langsung (juga dikenal sebagai transisi "midterm"), bukan perubahan terjadwal.
| Deskripsi kesalahan | Kode kesalahan |
|---|---|
| Langganan tidak aktif. | SubscriptionNotActive = 1 |
| Langganan berada dalam jendela pembatalan. | SubscriptionInCancellationWindow = 2 |
| Durasi jangka waktu langganan lebih pendek dari durasi jangka waktu langganan sumber. | SubscriptionTermDurationShorterThanSourceTermDuration = 3 |
| Tanggal berakhir jangka waktu langganan adalah sebelum tanggal akhir masa langganan sumber. | Tanggal berakhir jangka waktu langganan adalah sebelum tanggal akhir masa langganan sumber. =4 |
Contoh tanggapan
HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT
{
"totalCount": 2,
"items": [
{
"operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
"catalogItemId": "CFQ7TTC0KZCR:0001:CFQ7TTC0K71H",
"title": "Microsoft 365 E5 Test Sku Title",
"description": "Microsoft 365 E5 Test Sku Description",
"quantity": 1,
"subscriptionEligibilities": [
{
"isEligible": false,
"subscriptionId": "92301b7d-7598-4938-d6f2-d31e080e9da6",
"subscriptionFriendlyName": "Microsoft 365 Business Premium",
"subscriptionTermDuration": "P1M",
"subscriptionBillingCycle": "monthly",
"errors": [
{
"code": 3,
"description": "The subscription's term duration is shorter than the source subscription's term duration."
}
]
},
{
"isEligible": true,
"subscriptionId": "151467a1-4246-4a00-da7b-3405463d9b78",
"subscriptionFriendlyName": "Microsoft 365 Business Premium",
"subscriptionTermDuration": "P1Y",
"subscriptionBillingCycle": "monthly",
"errors": []
}
],
"eligibilities": [
{
"isEligible": true,
"transitionType": "transition_only",
"errors": []
},
{
"isEligible": false,
"transitionType": "transition_with_license_transfer",
"errors": [
{
"code": 3,
"description": "Subscription cannot be transitioned because there are conflicting services."
}
]
}
],
"attributes": {
"objectType": "TransitionEligibility"
}
},
{
"operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
"catalogItemId": "CFQ7TTC0L4M3:0001:CFQ7TTC0K78T",
"title": "Business Premium Test Sku Title",
"description": "Business Premium Test Sku Description",
"quantity": 1,
"eligibilities": [
{
"isEligible": false,
"transitionType": "transition_with_license_transfer",
"errors": [
{
"code": 3,
"description": "Subscription cannot be transitioned because there are conflicting services."
}
]
}
],
"attributes": {
"objectType": "TransitionEligibility"
}
}
],
"attributes": {
"objectType": "Collection"
}
}
Pasca Transisi
Memposting permintaan transisi untuk pelanggan dan langganan tertentu. Mengembalikan transisi dengan status awalnya.
Prasyarat
Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
ID pelanggan (
customer-tenant-id). Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih ruang kerja Pelanggan , lalu pelanggan dari daftar pelanggan, lalu Akun. Pada halaman Akun pelanggan, cari ID Microsoft di bagian Info Akun Pelanggan. ID Microsoft sama dengan ID pelanggan (customer-tenant-id).ID langganan untuk langganan awal.
Peran GDAP
Anda akan memerlukan setidaknya salah satu peran GDAP berikut:
- Pembaca Direktori atau Pembaca global (hanya transisi)
- Penulis Direktori (transisi dengan transfer lisensi)
Catatan
Meskipun API ini tersedia untuk warisan dan NCE, GDAP hanya diperlukan untuk warisan.
Permintaan REST
Minta sintaks
| Metode | URI Permintaan |
|---|---|
| POST | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transisi HTTP/1.1 |
Parameter URI
Gunakan parameter kueri berikut untuk menjalankan transisi.
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| customer-tenant-id | Guid | Y | GUID yang sesuai dengan penyewa pelanggan. |
| id langganan | Guid | Y | GUID yang sesuai dengan langganan awal. |
Header permintaan
Untuk informasi selengkapnya, lihat Header REST Pusat Mitra.
Isi permintaan
Tabel ini menjelaskan properti Transisi dalam isi permintaan.
| Properti | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| fromCatalogItemId | string | No | Item katalog yang Anda transisikan. |
| fromSubscriptionId | string | No | ID langganan yang Anda transisikan. |
| toCatalogItemId | string | Ya | Item katalog yang Anda transisikan. |
| toSubscriptionId | string | No | ID langganan yang Anda transisikan. |
| kuantitas | Integer | Ya | Jumlah lisensi untuk transisi. |
| termDuration | string | No | Menentukan durasi istilah langganan. |
| billingCycle | string | No | Menentukan siklus penagihan langganan. |
| transisiTipe | string | Ya | Jenis transisi. Nilai yang mungkin - transition_only, transition_with_license_transfer. |
Contoh permintaan
POST https://api.partnercenter.microsoft.com/v1/customers/{customerId}/subscriptions/{subscriptionId}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US
{
"fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
"fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
"toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
"toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
"quantity": 2,
"termDuration": "P1M",
"billingCycle": "Monthly",
"transitionType": "transition_only"
}
Respons REST
Jika berhasil, metode ini mengembalikan sumber daya Transisi dengan status awalnya.
Kode kesalahan dan keberhasilan respons
Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan lainnya. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter lainnya. Untuk daftar lengkapnya, lihat Kode Kesalahan.
Contoh tanggapan
HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT
{
"fromCatalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0K39X",
"fromSubscriptionId": "e487e8dc-421e-4275-cb42-3c1c8daccf70",
"toCatalogItemId": "CFQ7TTC0LF8R:0001:CFQ7TTC0KCSV",
"toSubscriptionId": "0af52192-4a2a-4364-d25b-c8ecab3a5697",
"quantity": 2,
"termDuration": "P1M",
"billingCycle": "Monthly",
"transitionType": "transition_only"
"Events": [
{
"name": "Conversion",
"status": "Started ",
"timestamp": "2021-01-08T18:01:14.7488618Z",
"attributes":
{
"objectType": "TransitionEvent"
}
}
],
"attributes":
{
"objectType": "Transition"
}
}
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk