Encabezados y parámetros comunes

La información siguiente es común para todas las operaciones que se pueden llevar a cabo en relación con los recursos de Batch:

• Especifique el valor opcional $select como una lista de propiedades que se van a devolver para un recurso.

• Especifique el valor opcional $skiptoken en el URI si se devuelve un resultado parcial en una llamada de operación anterior. Si la respuesta contiene un elemento odata.nextLink , el valor del elemento odata.nextLink incluye un parámetro $skiptoken con un valor que especifica el punto inicial de la colección de entidades para la siguiente operación GET. El parámetro $skiptoken solo se debe usar en el URI contenido en el valor del elemento odata.nextLink .

• Especifique el valor maxresults opcional en el URI para definir el número de elementos que se devolverán en una respuesta. El número máximo de elementos varía en función del recurso:

  • Se pueden devolver un máximo de 100 certificados.

  • Se pueden devolver un máximo de 1.000 grupos.

  • Se puede devolver un máximo de 1000 nodos.

  • Se puede devolver un máximo de 1000 programaciones de trabajo.

  • Se pueden devolver un máximo de 1.000 trabajos.

  • Se puede especificar un máximo de 1.000 tareas.

• Establezca el encabezado Authorization en una cadena que contenga el esquema de autenticación, el nombre de la cuenta y la firma de autenticación. Para obtener más información, consulte Autenticar solicitudes en el servicio Azure Batch.

Representación de valores de fecha y hora

Especificar valores de fecha y hora en encabezados HTTP

El servicio de Batch sigue el formato RFC 1123 para representar valores de fecha y hora en encabezados. Este es el formato preferido para las operaciones HTTP/1.1, como se describe en la sección 3.3 de la especificación de parámetros del protocolo HTTP/1.1 . A continuación se muestra un ejemplo de este formato:

Sun, 06 Nov 1994 08:49:37 GMT  

También se admite el formato siguiente, como se describe en la especificación de protocolo HTTP/1.1:

Sunday, 06-Nov-94 08:49:37 GMT  

Ambos se representan en la hora universal coordinada (UTC), también conocida como hora del meridiano de Greenwich.

Especificar valores de fecha y hora en parámetros URI y en el cuerpo de solicitud/respuesta

Los valores de fecha y hora incluidos en parámetros de consulta y en el cuerpo de solicitud/respuesta se expresan como horas UTC y deben adherirse a un formato ISO 8601 válido. Entre los formatos ISO 8601 admitidos se incluyen los siguientes:

• YYYY-MM-DD

• YYYY-MM-DDThh:mmTZD

• YYYY-MM-DDThh:mm:ssTZD

Para la parte de fecha de estos formatos, YYYY es una representación de cuatro dígitos del año, MM es una representación de dos dígitos del mes y DD es una representación de dos dígitos del día. Para la parte de hora, hh es la representación de la hora en la notación de 24 horas, mm es la representación de dos dígitos de los minutos y ss es la representación de dos dígitos de los segundos. Un designador de hora T separa las partes de fecha y de hora de la cadena, mientras que un designador de zona horaria TZD especifica una zona horaria.