LogsIngestionClient.Upload メソッド

定義

名前空間:

Azure.Monitor.Ingestion

アセンブリ:

Azure.Monitor.Ingestion.dll

パッケージ:

Azure.Monitor.Ingestion v1.1.2

オーバーロード

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

Upload(String, String, RequestContent, String, RequestContext)

Source:

LogsIngestionClient.cs

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

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

public virtual Azure.Response Upload (string ruleId, string streamName, Azure.Core.RequestContent content, string contentEncoding = default, Azure.RequestContext context = default);

abstract member Upload : string * string * Azure.Core.RequestContent * string * Azure.RequestContext -> Azure.Response
override this.Upload : string * string * Azure.Core.RequestContent * string * Azure.RequestContext -> Azure.Response

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

パラメーター

ruleId

String

データ収集ルール リソースの変更できない ID。

streamName

String

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

content

RequestContent

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

contentEncoding

String

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

context

RequestContext

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

戻り値

Response

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

例外

ArgumentNullException

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

ArgumentException

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

RequestFailedException

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

例

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

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 = client.Upload("<ruleId>", "<streamName>", content);

Console.WriteLine(response.Status);

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

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 = client.Upload("<ruleId>", "<streamName>", content, contentEncoding: "<contentEncoding>");

Console.WriteLine(response.Status);

注釈

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

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

Source:

LogsIngestionClient.cs

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

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

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

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

型パラメーター

T

パラメーター

ruleId

String

データ収集ルール リソースの変更できない ID。

streamName

String

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

logs

IEnumerable<T>

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

options

LogsUploadOptions

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

cancellationToken

CancellationToken

戻り値

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

注釈

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