Menentukan tanggal akhir periode kustom

Artikel
03/07/2025

Berlaku untuk: Pusat Mitra | Pusat Mitra yang dioperasikan oleh 21Vianet | Pusat Mitra untuk Microsoft Cloud untuk Pemerintah AS

Mitra dapat melihat tanggal akhir jangka waktu kustom yang diizinkan untuk langganan berbasis lisensi NCE yang mereka beli untuk pelanggan mereka. Mitra dapat melihat tanggal akhir yang selaras dengan akhir bulan kalender atau yang berdampingan dengan langganan pelanggan yang sudah ada.

API hanya mendukung perhitungan tanggal akhir jangka waktu kustom untuk pembelian langganan baru dan bukan untuk perpanjangan langganan yang ada.

Prasyarat

Kredensial seperti yang dijelaskan dalam autentikasi Pusat Mitra. Skenario ini mendukung autentikasi dengan kredensial Aplikasi mandiri dan Aplikasi+Pengguna.
Sebuah CustomerTenantId. Jika Anda tidak mengetahui ID pelanggan, Anda dapat mencarinya di Pusat Mitra dengan memilih workspace 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.

Permintaan REST

Sintaksis permintaan

Metode	Meminta URI
GET	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Kueri String

Tabel ini mencantumkan string kueri yang diperlukan untuk memfilter dan mengambil tanggal akhir istilah kustom.

Nama:	Diperlukan:	Deskripsi:
durasi_termin	Ya	Representasi ISO 8601 dari durasi jangka waktu. Nilai yang didukung saat ini adalah P1M (1 bulan), P1Y (1 tahun) dan P3Y (3 tahun).
tanggal_mulai_periode	Tidak	Tanggal pembelian yang dimaksudkan. Ini tidak mungkin terjadi di masa lalu.
target_id_berlangganan_coterm	Tidak	String berformat GUID yang mengidentifikasi langganan untuk coterm.

Header permintaan

Untuk informasi selengkapnya, lihat header REST Pusat Mitra. Respons API mengembalikan maksimum 300 rekaman halaman. Jika lebih dari 300 rekaman dikembalikan dalam kueri yang diinput, token kelanjutan disediakan di header respons. Token kelanjutan dapat dimasukkan di header permintaan berikut untuk mengembalikan rekaman halaman tambahan yang dikueri.

Isi permintaan

Tidak.

Respons REST

Jika berhasil, metode ini mengembalikan detail Langganan yang dimigrasikan (objek migrasi) dalam isi respons. Ini termasuk ID migrasi.

Kode kesalahan dan keberhasilan respons

Setiap respons dilengkapi dengan kode status HTTP yang menunjukkan keberhasilan atau kegagalan dan informasi penelusuran kesalahan tambahan. Gunakan alat pelacakan jaringan untuk membaca kode ini, jenis kesalahan, dan parameter tambahan. Untuk daftar lengkapnya, lihat kode kesalahan REST Pusat Mitra .

Contoh URL permintaan

baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M

Contoh respons

 {
    "totalCount": 2,
    "items": [
        {
            "allowedCustomTermEndDateType": "calendarMonthAligned",
            "allowedCustomTermEndDate": "2023-07-31T00:00:00"
        },
        {
            "allowedCustomTermEndDateType": "subscriptionAligned",
            "cotermSubscriptionIds": [
               "5fcf618b-1daa-4604-da99-cc3e1c9ee422",
               "d30a9ff9-713e-4546-c97e-f06b9dcf6ef6"
            ],
            "allowedCustomTermEndDate": "2023-08-01T00:00:00"
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
 }

Bagikan melalui