LogsIngestionClient.UploadAsync メソッド

定義

名前空間:

Azure.Monitor.Ingestion

アセンブリ:

Azure.Monitor.Ingestion.dll

パッケージ:

Azure.Monitor.Ingestion v1.1.2

オーバーロード

UploadAsync(String, String, RequestContent, String, RequestContext)	[プロトコルメソッド]データ収集ルールを使用してデータを直接取り込むためのインジェスト API この プロトコル メソッド を使用すると、高度なシナリオで応答の要求と処理を明示的に作成できます。
UploadAsync<T>(String, String, IEnumerable<T>, LogsUploadOptions, CancellationToken)	データ収集ルールを使用してデータを直接取り込むためのインジェスト API。

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

Source:

LogsIngestionClient.cs

[プロトコルメソッド]データ収集ルールを使用してデータを直接取り込むためのインジェスト API

• この プロトコル メソッド を使用すると、高度なシナリオで応答の要求と処理を明示的に作成できます。

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)

パラメーター

ruleId

String

データ収集ルール リソースの不変 ID。

streamName

String

データ収集規則で定義されている streamDeclaration 名。

content

RequestContent

要求の本文として送信するコンテンツ。

contentEncoding

String

コンテンツが既に gzipped になっている場合は、"gzip" を入力します。 既定の動作は、すべての入力を gzip に設定します。

context

RequestContext

要求コンテキスト。これは、クライアント パイプラインの既定の動作を呼び出しごとにオーバーライドできます。

戻り値

Task<Response>

サービスから返された応答。

例外

ArgumentNullException

ruleId、streamName、または content が null です。

ArgumentException

ruleId または streamName が空の文字列であり、空でないと想定されていました。

RequestFailedException

サービスから成功以外の状態コードが返されました。

例

このサンプルでは、UploadAsync を呼び出す方法を示します。

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);

このサンプルでは、すべてのパラメーターと要求コンテンツを使用して UploadAsync を呼び出す方法を示します。

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);

注釈

詳細については、「エラー応答コードとエラー応答メッセージ」を参照してください。

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

Source:

LogsIngestionClient.cs

データ収集ルールを使用してデータを直接取り込むためのインジェスト API。

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)

型パラメーター

T

パラメーター

ruleId

String

データ収集ルール リソースの不変 ID。

streamName

String

データ収集規則で定義されている streamDeclaration 名。

logs

IEnumerable<T>

要求の本文として送信するコンテンツ。 要求本文スキーマの詳細については、以下の「解説」セクションを参照してください。

options

LogsUploadOptions

Azure Monitor にログをアップロードする要求を構成するためのオプション モデル。

cancellationToken

CancellationToken

戻り値

Task<Response>

サービスから返された応答。

例外

ArgumentNullException

ruleId、streamName、または logs が null です。

ArgumentException

ruleId または streamName が空の文字列であり、空でないと想定されていました。

RequestFailedException

サービスから成功以外の状態コードが返されました。

例

このサンプルでは、必要なパラメーターと要求コンテンツを使用して Upload を呼び出す方法を示します。

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);

注釈

詳細については、「エラー応答コードとエラー応答メッセージ」を参照してください。