你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

BatchClient.GetPoolUsageMetrics Method

Definition

Overloads

GetPoolUsageMetrics(Nullable<Int32>, Nullable<DateTimeOffset>, Nullable<Int32>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, String, CancellationToken)

Lists the usage metrics, aggregated by Pool across individual time intervals, for the specified Account.

GetPoolUsageMetrics(Nullable<Int32>, Nullable<DateTimeOffset>, Nullable<Int32>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, String, RequestContext)

[Protocol Method] Lists the usage metrics, aggregated by Pool across individual time intervals, for the specified Account.

GetPoolUsageMetrics(Nullable<Int32>, Nullable<DateTimeOffset>, Nullable<Int32>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, String, CancellationToken)

Source:
BatchClient.cs

Lists the usage metrics, aggregated by Pool across individual time intervals, for the specified Account.

public virtual Azure.Pageable<Azure.Compute.Batch.BatchPoolUsageMetrics> GetPoolUsageMetrics (int? timeOutInSeconds = default, DateTimeOffset? ocpdate = default, int? maxresults = default, DateTimeOffset? starttime = default, DateTimeOffset? endtime = default, string filter = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GetPoolUsageMetrics : Nullable<int> * Nullable<DateTimeOffset> * Nullable<int> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * string * System.Threading.CancellationToken -> Azure.Pageable<Azure.Compute.Batch.BatchPoolUsageMetrics>
override this.GetPoolUsageMetrics : Nullable<int> * Nullable<DateTimeOffset> * Nullable<int> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * string * System.Threading.CancellationToken -> Azure.Pageable<Azure.Compute.Batch.BatchPoolUsageMetrics>
Public Overridable Function GetPoolUsageMetrics (Optional timeOutInSeconds As Nullable(Of Integer) = Nothing, Optional ocpdate As Nullable(Of DateTimeOffset) = Nothing, Optional maxresults As Nullable(Of Integer) = Nothing, Optional starttime As Nullable(Of DateTimeOffset) = Nothing, Optional endtime As Nullable(Of DateTimeOffset) = Nothing, Optional filter As String = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Pageable(Of BatchPoolUsageMetrics)

Parameters

timeOutInSeconds
Nullable<Int32>

The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be used instead.".

ocpdate
Nullable<DateTimeOffset>

The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.

maxresults
Nullable<Int32>

The maximum number of items to return in the response. A maximum of 1000 applications can be returned.

starttime
Nullable<DateTimeOffset>

The earliest time from which to include metrics. This must be at least two and a half hours before the current time. If not specified this defaults to the start time of the last aggregation interval currently available.

endtime
Nullable<DateTimeOffset>

The latest time from which to include metrics. This must be at least two hours before the current time. If not specified this defaults to the end time of the last aggregation interval currently available.

filter
String

An OData $filter clause. For more information on constructing this filter, see https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-account-usage-metrics.

cancellationToken
CancellationToken

The cancellation token to use.

Returns

Examples

This sample shows how to call GetPoolUsageMetrics.

Uri endpoint = new Uri("<https://my-service.azure.com>");
TokenCredential credential = new DefaultAzureCredential();
BatchClient client = new BatchClient(endpoint, credential);

foreach (BatchPoolUsageMetrics item in client.GetPoolUsageMetrics())
{
}

This sample shows how to call GetPoolUsageMetrics with all parameters.

Uri endpoint = new Uri("<https://my-service.azure.com>");
TokenCredential credential = new DefaultAzureCredential();
BatchClient client = new BatchClient(endpoint, credential);

foreach (BatchPoolUsageMetrics item in client.GetPoolUsageMetrics(timeOutInSeconds: 1234, ocpdate: DateTimeOffset.Parse("Tue, 10 May 2022 18:57:31 GMT"), maxresults: 1234, starttime: DateTimeOffset.Parse("2022-05-10T18:57:31.2311892Z"), endtime: DateTimeOffset.Parse("2022-05-10T18:57:31.2311892Z"), filter: "<filter>"))
{
}

Remarks

If you do not specify a $filter clause including a poolId, the response includes all Pools that existed in the Account in the time range of the returned aggregation intervals. If you do not specify a $filter clause including a startTime or endTime these filters default to the start and end times of the last aggregation interval currently available; that is, only the last aggregation interval is returned.

Applies to

GetPoolUsageMetrics(Nullable<Int32>, Nullable<DateTimeOffset>, Nullable<Int32>, Nullable<DateTimeOffset>, Nullable<DateTimeOffset>, String, RequestContext)

Source:
BatchClient.cs

[Protocol Method] Lists the usage metrics, aggregated by Pool across individual time intervals, for the specified Account.

public virtual Azure.Pageable<BinaryData> GetPoolUsageMetrics (int? timeOutInSeconds, DateTimeOffset? ocpdate, int? maxresults, DateTimeOffset? starttime, DateTimeOffset? endtime, string filter, Azure.RequestContext context);
abstract member GetPoolUsageMetrics : Nullable<int> * Nullable<DateTimeOffset> * Nullable<int> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * string * Azure.RequestContext -> Azure.Pageable<BinaryData>
override this.GetPoolUsageMetrics : Nullable<int> * Nullable<DateTimeOffset> * Nullable<int> * Nullable<DateTimeOffset> * Nullable<DateTimeOffset> * string * Azure.RequestContext -> Azure.Pageable<BinaryData>
Public Overridable Function GetPoolUsageMetrics (timeOutInSeconds As Nullable(Of Integer), ocpdate As Nullable(Of DateTimeOffset), maxresults As Nullable(Of Integer), starttime As Nullable(Of DateTimeOffset), endtime As Nullable(Of DateTimeOffset), filter As String, context As RequestContext) As Pageable(Of BinaryData)

Parameters

timeOutInSeconds
Nullable<Int32>

The maximum time that the server can spend processing the request, in seconds. The default is 30 seconds. If the value is larger than 30, the default will be used instead.".

ocpdate
Nullable<DateTimeOffset>

The time the request was issued. Client libraries typically set this to the current system clock time; set it explicitly if you are calling the REST API directly.

maxresults
Nullable<Int32>

The maximum number of items to return in the response. A maximum of 1000 applications can be returned.

starttime
Nullable<DateTimeOffset>

The earliest time from which to include metrics. This must be at least two and a half hours before the current time. If not specified this defaults to the start time of the last aggregation interval currently available.

endtime
Nullable<DateTimeOffset>

The latest time from which to include metrics. This must be at least two hours before the current time. If not specified this defaults to the end time of the last aggregation interval currently available.

filter
String

An OData $filter clause. For more information on constructing this filter, see https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-account-usage-metrics.

context
RequestContext

The request context, which can override default behaviors of the client pipeline on a per-call basis.

Returns

The Pageable<T> from the service containing a list of BinaryData objects. Details of the body schema for each item in the collection are in the Remarks section below.

Exceptions

Service returned a non-success status code.

Examples

This sample shows how to call GetPoolUsageMetrics and parse the result.

Uri endpoint = new Uri("<https://my-service.azure.com>");
TokenCredential credential = new DefaultAzureCredential();
BatchClient client = new BatchClient(endpoint, credential);

foreach (BinaryData item in client.GetPoolUsageMetrics(null, null, null, null, null, null, null))
{
    JsonElement result = JsonDocument.Parse(item.ToStream()).RootElement;
    Console.WriteLine(result.GetProperty("poolId").ToString());
    Console.WriteLine(result.GetProperty("startTime").ToString());
    Console.WriteLine(result.GetProperty("endTime").ToString());
    Console.WriteLine(result.GetProperty("vmSize").ToString());
    Console.WriteLine(result.GetProperty("totalCoreHours").ToString());
}

This sample shows how to call GetPoolUsageMetrics with all parameters and parse the result.

Uri endpoint = new Uri("<https://my-service.azure.com>");
TokenCredential credential = new DefaultAzureCredential();
BatchClient client = new BatchClient(endpoint, credential);

foreach (BinaryData item in client.GetPoolUsageMetrics(1234, DateTimeOffset.Parse("Tue, 10 May 2022 18:57:31 GMT"), 1234, DateTimeOffset.Parse("2022-05-10T18:57:31.2311892Z"), DateTimeOffset.Parse("2022-05-10T18:57:31.2311892Z"), "<filter>", null))
{
    JsonElement result = JsonDocument.Parse(item.ToStream()).RootElement;
    Console.WriteLine(result.GetProperty("poolId").ToString());
    Console.WriteLine(result.GetProperty("startTime").ToString());
    Console.WriteLine(result.GetProperty("endTime").ToString());
    Console.WriteLine(result.GetProperty("vmSize").ToString());
    Console.WriteLine(result.GetProperty("totalCoreHours").ToString());
}

Applies to