LogsIngestionClient.UploadAsync Methode

Definition

Namespace:

Azure.Monitor.Ingestion

Assembly:

Azure.Monitor.Ingestion.dll

Paket:

Azure.Monitor.Ingestion v1.1.2

Überlädt

UploadAsync(String, String, RequestContent, String, RequestContext)	[Protokollmethode] Erfassungs-API zum direkten Erfassen von Daten mithilfe von Datensammlungsregeln Diese Protokollmethode ermöglicht die explizite Erstellung der Anforderung und Verarbeitung der Antwort für erweiterte Szenarien.
UploadAsync<T>(String, String, IEnumerable<T>, LogsUploadOptions, CancellationToken)	Erfassungs-API, die zum direkten Erfassen von Daten mithilfe von Datensammlungsregeln verwendet wird.

UploadAsync(String, String, RequestContent, String, RequestContext)

Source:

LogsIngestionClient.cs

[Protokollmethode] Erfassungs-API zum direkten Erfassen von Daten mithilfe von Datensammlungsregeln

• Diese Protokollmethode ermöglicht die explizite Erstellung der Anforderung und Verarbeitung der Antwort für erweiterte Szenarien.

public virtual System.Threading.Tasks.Task<Azure.Response> UploadAsync (string ruleId, string streamName, Azure.Core.RequestContent content, string contentEncoding = default, Azure.RequestContext context = default);

abstract member UploadAsync : string * string * Azure.Core.RequestContent * string * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>
override this.UploadAsync : string * string * Azure.Core.RequestContent * string * Azure.RequestContext -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function UploadAsync (ruleId As String, streamName As String, content As RequestContent, Optional contentEncoding As String = Nothing, Optional context As RequestContext = Nothing) As Task(Of Response)

Parameter

ruleId

String

Die unveränderliche ID der Datensammlungsregelressource.

streamName

String

Der name von streamDeclaration, wie in der Datensammlungsregel definiert.

content

RequestContent

Der Inhalt, der als Textkörper der Anforderung gesendet werden soll.

contentEncoding

String

Wenn Der Inhalt bereits gzippt ist, setzen Sie "gzip". Das Standardverhalten besteht darin, alle Eingaben zu gzipieren.

context

RequestContext

Der Anforderungskontext, der das Standardverhalten der Clientpipeline pro Aufruf außer Kraft setzen kann.

Gibt zurück

Task<Response>

Die vom Dienst zurückgegebene Antwort.

Ausnahmen

ArgumentNullException

ruleId, streamName oder content ist NULL.

ArgumentException

ruleId oder streamName ist eine leere Zeichenfolge und wurde erwartet, dass sie nicht leer ist.

RequestFailedException

Der Dienst hat einen nicht erfolgreichen status Code zurückgegeben.

Beispiele

In diesem Beispiel wird gezeigt, wie UploadAsync aufgerufen wird.

Uri endpoint = new Uri("<endpoint>");
TokenCredential credential = new DefaultAzureCredential();
LogsIngestionClient client = new LogsIngestionClient(endpoint, credential);

using RequestContent content = RequestContent.Create(new object[]
{
    new object()
});
Response response = await client.UploadAsync("<ruleId>", "<streamName>", content);

Console.WriteLine(response.Status);

In diesem Beispiel wird gezeigt, wie UploadAsync mit allen Parametern und Anforderungsinhalten aufgerufen wird.

Uri endpoint = new Uri("<endpoint>");
TokenCredential credential = new DefaultAzureCredential();
LogsIngestionClient client = new LogsIngestionClient(endpoint, credential);

using RequestContent content = RequestContent.Create(new object[]
{
    new object()
});
Response response = await client.UploadAsync("<ruleId>", "<streamName>", content, contentEncoding: "<contentEncoding>");

Console.WriteLine(response.Status);

Hinweise

Weitere Informationen finden Sie unter Fehlerantwortcode und Fehlermeldung.

UploadAsync<T>(String, String, IEnumerable<T>, LogsUploadOptions, CancellationToken)

Source:

LogsIngestionClient.cs

Erfassungs-API, die zum direkten Erfassen von Daten mithilfe von Datensammlungsregeln verwendet wird.

public virtual System.Threading.Tasks.Task<Azure.Response> UploadAsync<T> (string ruleId, string streamName, System.Collections.Generic.IEnumerable<T> logs, Azure.Monitor.Ingestion.LogsUploadOptions options = default, System.Threading.CancellationToken cancellationToken = default);

abstract member UploadAsync : string * string * seq<'T> * Azure.Monitor.Ingestion.LogsUploadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>
override this.UploadAsync : string * string * seq<'T> * Azure.Monitor.Ingestion.LogsUploadOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response>

Public Overridable Function UploadAsync(Of T) (ruleId As String, streamName As String, logs As IEnumerable(Of T), Optional options As LogsUploadOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response)

Typparameter

T

Parameter

ruleId

String

Die unveränderliche ID der Datensammlungsregelressource.

streamName

String

Der name von streamDeclaration, wie in der Datensammlungsregel definiert.

logs

IEnumerable<T>

Der Inhalt, der als Textkörper der Anforderung gesendet werden soll. Details zum Anforderungstextschema finden Sie im Abschnitt Hinweise unten.

options

LogsUploadOptions

Das Optionsmodell zum Konfigurieren der Anforderung zum Hochladen von Protokollen in Azure Monitor.

cancellationToken

CancellationToken

Gibt zurück

Task<Response>

Die vom Dienst zurückgegebene Antwort.

Ausnahmen

ArgumentNullException

ruleId, streamName oder logs ist NULL.

ArgumentException

ruleId oder streamName ist eine leere Zeichenfolge und wurde erwartet, dass sie nicht leer ist.

RequestFailedException

Der Dienst hat einen Nicht-Success-status-Code zurückgegeben.

Beispiele

In diesem Beispiel wird gezeigt, wie Upload mit den erforderlichen Parametern und Anforderungsinhalten aufgerufen wird.

var credential = new DefaultAzureCredential();
var endpoint = new Uri("<https://my-account-name.azure.com>");
var client = new LogsIngestionClient(endpoint, credential);

var data = new[] {
    new {}
};

Response response = client.Upload("<ruleId>", "<streamName>", data);
Console.WriteLine(response.Status);

Hinweise

Weitere Informationen finden Sie unter Fehlerantwortcode und Fehlermeldung.