Students - Create Or Update

Dienst:: Education

API-Version:: 2021-12-01-preview

Erstellen und hinzufügen Sie einen neuen Kursteilnehmer zum angegebenen Labor, oder aktualisieren Sie die Details eines vorhandenen Kursteilnehmers in einem Labor. Beachten Sie, dass der Kursteilnehmer über einen gültigen Mandanten verfügen muss, um das Labor zu akzeptieren, nachdem sie dem Lab hinzugefügt wurden.

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/students/{studentAlias}?api-version=2021-12-01-preview

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
billingAccountName	path	True	string	Der Name des Abrechnungskontos.
billingProfileName	path	True	string	Der Name des Abrechnungsprofils.
invoiceSectionName	path	True	string	Der Name des Rechnungsabschnitts.
studentAlias	path	True	string	Das Studentenalias.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
properties.budget	True	Amount	Kursteilnehmerbudget
properties.email	True	string	Schüler-E-Mail
properties.expirationDate	True	string (date-time)	Das Datum, an dem dieser Kursteilnehmer festgelegt ist, läuft ab dem Labor ab.
properties.firstName	True	string	First Name (Vorname)
properties.lastName	True	string	Last Name (Nachname)
properties.role	True	StudentRole	Schülerrolle
properties.subscriptionAlias		string	Abonnementalias
properties.subscriptionInviteLastSentDate		string (date-time)	Datum der letzten Übermittlung der Abonnement-Einladung

Antworten

Name	Typ	Beschreibung
200 OK	StudentDetails	Die Aktualisierung der Ressource 'StudentDetails' war erfolgreich
201 Created	StudentDetails	Resource 'StudentDetails' Erstellungsoperation erfolgreich
Other Status Codes	ErrorResponseBody	Beschreibt den Fehler, wenn der Vorgang nicht erfolgreich ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Student

Beispielanforderung

HTTP

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/students/{studentAlias}?api-version=2021-12-01-preview

{
  "properties": {
    "budget": {
      "currency": "USD",
      "value": 100
    },
    "email": "test@contoso.com",
    "expirationDate": "2021-11-09T22:13:21.795Z",
    "firstName": "test",
    "lastName": "user",
    "role": "Student"
  }
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "name": "{studentAlias}",
  "type": "Microsoft.Education/Students",
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/students/{studentAlias}",
  "properties": {
    "budget": {
      "currency": "USD",
      "value": 100
    },
    "effectiveDate": "2021-11-09T21:43:54.161Z",
    "email": "test@contoso.com",
    "expirationDate": "2022-11-09T21:43:54.161Z",
    "firstName": "test",
    "lastName": "user",
    "role": "Student",
    "status": "Active",
    "subscriptionId": "000000000-0000-0000-0000-00000000000000"
  }
}

Statuscode:: 201

{
  "name": "{studentAlias}",
  "type": "Microsoft.Education/Students",
  "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/providers/Microsoft.Education/labs/default/students/{studentAlias}",
  "properties": {
    "budget": {
      "currency": "USD",
      "value": 100
    },
    "effectiveDate": "2021-11-09T21:43:54.161Z",
    "email": "test@contoso.com",
    "expirationDate": "2022-11-09T21:43:54.161Z",
    "firstName": "test",
    "lastName": "user",
    "role": "Student",
    "status": "Active",
    "subscriptionId": "000000000-0000-0000-0000-00000000000000"
  }
}

Definitionen

Name	Beschreibung
Amount	Der Betrag.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
ErrorResponse	Beschreibt das Format der Fehlerantwort.
ErrorResponseBody	Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.
StudentDetails	Details des Kursteilnehmers.
StudentLabStatus	Status des Schülerlabors
StudentRole	Schülerrolle
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

Amount

Objekt

Der Betrag.

Name	Typ	Beschreibung
currency	string	Der Typ der Währung, die für den Wert verwendet wird.
value	number (float)	Betragswert.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

ErrorResponse

Objekt

Beschreibt das Format der Fehlerantwort.

Name	Typ	Beschreibung
code	string	Fehlercode
message	string	Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

ErrorResponseBody

Objekt

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Name	Typ	Beschreibung
error	ErrorResponse	Die Details des Fehlers.

StudentDetails

Objekt

Details des Kursteilnehmers.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Zum Beispiel - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.budget	Amount	Kursteilnehmerbudget
properties.effectiveDate	string (date-time)	Datum, an dem Kursteilnehmer zum Labor hinzugefügt wurde
properties.email	string	Schüler-E-Mail
properties.expirationDate	string (date-time)	Das Datum, an dem dieser Kursteilnehmer festgelegt ist, läuft ab dem Labor ab.
properties.firstName	string	First Name (Vorname)
properties.lastName	string	Last Name (Nachname)
properties.role	StudentRole	Schülerrolle
properties.status	StudentLabStatus	Status des Schülerlabors
properties.subscriptionAlias	string	Abonnementalias
properties.subscriptionId	string	Subscription Id (Abonnement-ID)
properties.subscriptionInviteLastSentDate	string (date-time)	Datum der letzten Übermittlung der Abonnement-Einladung
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

StudentLabStatus

Enumeration

Status des Schülerlabors

Wert	Beschreibung
Active	Active
Disabled	Disabled
Expired	Abgelaufen
Pending	Anhängig
Deleted	Gelöscht

StudentRole

Enumeration

Schülerrolle

Wert	Beschreibung
Student	Student
Admin	Admin

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.