Mendapatkan tanggal akhir istilah kustom

Artikel
02/19/2024

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.
A CustomerTenantId. 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.

Permintaan REST

Minta sintaks

Metode	URI Permintaan
DAPATKAN	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

String Kueri

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

Nama:	Wajib diisi:	Deskripsi:
term_duration	Ya	Representasi ISO 8601 dari durasi istilah. Nilai yang didukung saat ini adalah P1M (1 bulan), P1Y (1 tahun) dan P3Y (3 tahun).
term_start_date	No	Tanggal pembelian yang dimaksudkan. Ini tidak mungkin di masa lalu.
target_coterm_subscription_id	No	String berformat GUID yang mengidentifikasi langganan untuk dikoterm.

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 ada.

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