Buat lab di Azure Education Hub melalui REST API.
Artikel ini akan memanmbing Anda melalui cara membuat lab, menambahkan siswa ke lab tersebut, dan memverifikasi bahwa lab telah dibuat.
Prasyarat
- Mengetahui ID akun penagihan, ID profil Penagihan, dan ID Bagian Faktur
- Memiliki akun Azure yang disetujui Edu
Membuat lab
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<BillingAccountID>/billingProfiles/<BillingProfileID>/invoiceSections/<InvoiceSectionID>/providers/Microsoft.Education/labs/default?api-version=2021-12-01-preview
Panggil API di atas dengan isi yang mirip dengan yang di bawah ini. Sertakan detail Anda untuk apa nama tampilannya dan berapa banyak anggaran yang akan Anda alokasikan untuk lab ini.
{
"properties": {
"displayName": "string",
"budgetPerStudent": {
"currency": "string",
"value": 0
},
"description": "string",
"expirationDate": "2021-12-21T22:56:17.314Z",
"totalBudget": {
"currency": "string",
"value": 0
},
"totalAllocatedBudget": {
"currency": "string",
"value": 0
}
}
}
Respons API mengembalikan detail lab yang baru dibuat. Selamat, Anda telah membuat lab di pusat pendidikan.
{
"id": "string",
"name": "string",
"type": "string",
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2021-12-21T22:56:17.338Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2021-12-21T22:56:17.338Z"
},
"properties": {
"displayName": "string",
"budgetPerStudent": {
"currency": "string",
"value": 0
},
"description": "string",
"expirationDate": "2021-12-21T22:56:17.339Z",
"effectiveDate": "2021-12-21T22:56:17.339Z",
"status": "Active",
"maxStudentCount": 0,
"invitationCode": "string",
"totalBudget": {
"currency": "string",
"value": 0
},
"totalAllocatedBudget": {
"currency": "string",
"value": 0
}
}
}
Menambahkan siswa ke lab
Sekarang setelah lab berhasil dibuat, Anda dapat mulai menambahkan siswa ke lab.
Panggil titik akhir di bawah ini dan pastikan untuk mengganti bagian yang dikelilingi oleh <>.
PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<BillingAccountID>/billingProfiles/<BillingProfileID>/invoiceSections/<InvoiceSectionID>/providers/Microsoft.Education/labs/default/students/<StudentID>?api-version=2021-12-01-preview
Panggil API di atas dengan isi yang mirip dengan yang di bawah ini. Ubah isi untuk menyertakan detail siswa yang ingin Anda tambahkan ke lab.
{
"properties": {
"firstName": "string",
"lastName": "string",
"email": "string",
"role": "Student",
"budget": {
"currency": "string",
"value": 0
},
"expirationDate": "2021-12-21T23:01:41.943Z",
"subscriptionAlias": "string",
"subscriptionInviteLastSentDate": "string"
}
}
Respons API mengembalikan detail siswa yang baru ditambahkan.
{
"id": "string",
"name": "string",
"type": "string",
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2021-12-21T23:02:20.163Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2021-12-21T23:02:20.163Z"
},
"properties": {
"firstName": "string",
"lastName": "string",
"email": "string",
"role": "Student",
"budget": {
"currency": "string",
"value": 0
},
"subscriptionId": "string",
"expirationDate": "2021-12-21T23:02:20.163Z",
"status": "Active",
"effectiveDate": "2021-12-21T23:02:20.163Z",
"subscriptionAlias": "string",
"subscriptionInviteLastSentDate": "string"
}
}
Memeriksa detail lab
Sekarang lab telah dibuat dan siswa telah ditambahkan ke lab, mari kita dapatkan detail untuk lab. Mendapatkan detail lab akan memberi Anda data meta seperti ketika lab dibuat dan berapa banyak anggaran yang dimilikinya. Ini tidak akan mencakup informasi tentang siswa di lab.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<BillingAccountID>/billingProfiles/<BillingProfileID>/invoiceSections/<InvoiceSectionID>/providers/Microsoft.Education/labs/default?includeBudget=true&api-version=2021-12-01-preview
Respons API akan mencakup informasi tentang lab dan informasi anggaran (jika bendera anggaran sertakan diatur ke true)
{
"id": "string",
"name": "string",
"type": "string",
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2021-12-21T23:10:10.867Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2021-12-21T23:10:10.867Z"
},
"properties": {
"displayName": "string",
"budgetPerStudent": {
"currency": "string",
"value": 0
},
"description": "string",
"expirationDate": "2021-12-21T23:10:10.867Z",
"effectiveDate": "2021-12-21T23:10:10.867Z",
"status": "Active",
"maxStudentCount": 0,
"invitationCode": "string",
"totalBudget": {
"currency": "string",
"value": 0
},
"totalAllocatedBudget": {
"currency": "string",
"value": 0
}
}
}
Memeriksa detail siswa di laboratorium
Memanggil API ini akan memungkinkan kita untuk melihat semua siswa yang berada di lab yang ditentukan.
GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<BillingAccountID/billingProfiles/<BillingProfileID>/invoiceSections/<InvoiceSectionID>/providers/Microsoft.Education/labs/default/students?includeDeleted=true&api-version=2021-12-01-preview
Respons API akan menyertakan informasi tentang siswa di lab dan bahkan akan menampilkan siswa yang telah dihapus dari lab (jika bendera includeDeleted diatur ke true)
{
"value": [
{
"id": "string",
"name": "string",
"type": "string",
"systemData": {
"createdBy": "string",
"createdByType": "User",
"createdAt": "2021-12-21T23:15:45.430Z",
"lastModifiedBy": "string",
"lastModifiedByType": "User",
"lastModifiedAt": "2021-12-21T23:15:45.430Z"
},
"properties": {
"firstName": "string",
"lastName": "string",
"email": "string",
"role": "Student",
"budget": {
"currency": "string",
"value": 0
},
"subscriptionId": "string",
"expirationDate": "2021-12-21T23:15:45.430Z",
"status": "Active",
"effectiveDate": "2021-12-21T23:15:45.430Z",
"subscriptionAlias": "string",
"subscriptionInviteLastSentDate": "string"
}
}
],
"nextLink": "string"
}