CosmosDatabase.CreateUserAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Erstellt einen Benutzer als asynchronen Vorgang im Azure Cosmos-Dienst.
public abstract System.Threading.Tasks.Task<Azure.Cosmos.UserResponse> CreateUserAsync (string id, Azure.Cosmos.RequestOptions requestOptions = default, System.Threading.CancellationToken cancellationToken = default);
abstract member CreateUserAsync : string * Azure.Cosmos.RequestOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Cosmos.UserResponse>
Public MustOverride Function CreateUserAsync (id As String, Optional requestOptions As RequestOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of UserResponse)
Parameter
- id
- String
Die cosmos-Benutzer-ID
- requestOptions
- RequestOptions
(Optional) Die Optionen für die Benutzeranforderung RequestOptions
- cancellationToken
- CancellationToken
(Optional) CancellationToken stellt die Anforderungsabbruch dar.
Gibt zurück
Eine Task , die einen UserResponse enthält, der einen UserProperties umschließt, der den Leseressourcendatensatz enthält.
Ausnahmen
Wenn id
nicht festgelegt ist.
Diese Ausnahme kann viele verschiedene Fehlertypen kapseln. Um den spezifischen Fehler zu ermitteln, sehen Sie sich immer die StatusCode-Eigenschaft an. Einige allgemeine Codes, die Sie beim Erstellen eines Benutzers erhalten, sind:
StatusCode | Ausnahmegrund |
---|---|
400 | BadRequest: Dies bedeutet, dass mit der bereitgestellten Anforderung etwas nicht stimmte. Es ist wahrscheinlich, dass für den neuen Benutzer keine ID angegeben wurde. |
409 | Konflikt: Dies bedeutet, dass eine UserProperties mit einer ID übereinstimmt, die der von Ihnen angegebenen ID entspricht, bereits vorhanden ist. |
Beispiele
UserResponse response = await this.cosmosDatabase.CreateUserAsync(Guid.NewGuid().ToString());
Gilt für:
Azure SDK for .NET