Compartir a través de


ODATADetailLevel Clase

Definición

Controla la cantidad de detalles solicitados desde el servicio Azure Batch al enumerar o recuperar recursos mediante cláusulas de consulta de OData.

public class ODATADetailLevel : Microsoft.Azure.Batch.DetailLevel
type ODATADetailLevel = class
    inherit DetailLevel
Public Class ODATADetailLevel
Inherits DetailLevel
Herencia
ODATADetailLevel

Ejemplos

En este ejemplo se muestra cómo especificar un ODataDetailLevel que muestra solo CloudPools activo y recupera solo , IdDisplayName y Statistics para cada grupo (por ejemplo, para mostrarlo en una interfaz de usuario de informes).

var detailLevel = new ODATADetailLevel(
    filterClause: "state eq 'active'",
    selectClause: "id,displayName,stats",
    expandClause: "stats"
);

var pools = batchClient.PoolOperations.ListPools(detailLevel);

Comentarios

Azure Batch admite consultas OData, que permiten al cliente obtener un control más preciso sobre el rendimiento de las consultas controlando qué recursos se devuelven en las operaciones list (FilterClause) y qué propiedades de cada recurso se devuelven en las operaciones List, Get o Refresh (SelectClause y ExpandClause).

De forma predeterminada, si no pasa un DetailLevel elemento a una operación List, Get o Refresh, el cliente de Batch no especifica ningún filtro (se devuelven todos los registros), no se devuelve ninguna cláusula select (se devuelven todas las propiedades simples) y no se devuelve ninguna cláusula expand (no se devuelven entidades asociadas). Por lo tanto, de forma predeterminada, las propiedades de entidad asociadas son null, en lugar de rellenarse como otras propiedades. Consulte la documentación de clases individuales para averiguar qué propiedades se consideran entidades asociadas y deben expandirse para rellenarse.

Dado que las consultas de OData se pasan directamente a la API REST, las cadenas de cláusulas deben usar los nombres de atributo JSON de la API REST, que no siempre son los mismos que los nombres de propiedad de .NET. Por ejemplo, la propiedad .NET CloudPool.VirtualMachineSize corresponde al atributo vmSize en la API REST; por lo tanto, para filtrar las operaciones de lista de grupos por tamaño de máquina virtual, tendría que escribir vmSize en lugar de VirtualMachineSize en la cadena de filtro. Consulte la documentación de la API REST para averiguar el nombre del atributo JSON correspondiente a una propiedad de .NET.

Para obtener más información sobre el uso de OData para consultar eficazmente el servicio Azure Batch, vea Consultas de lista eficaces en MSDN.

Constructores

ODATADetailLevel()

Inicializa una nueva instancia de la ODATADetailLevel clase con cláusulas vacías.

ODATADetailLevel(String, String, String)

Inicializa una nueva instancia de la ODATADetailLevel clase con las cláusulas especificadas.

Propiedades

ExpandClause

Obtiene o establece la cláusula expand de OData. Se usa para recuperar entidades asociadas de la entidad principal que se está recuperando.

FilterClause

Obtiene o establece la cláusula de filtro OData. Se usa para restringir una operación de lista a los elementos que coinciden con los criterios especificados.

SelectClause

Obtiene o establece la cláusula select de OData. Se usa para recuperar solo propiedades específicas en lugar de todas las propiedades de objeto.

Se aplica a