Compartir a través de

File - Get From Compute Node

  • Referencia
Servicio:
Batch Service
Versión de la API:
2024-07-01.20.0

Devuelve el contenido del archivo de nodo de proceso especificado.

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/files/{filePath}?api-version=2024-07-01.20.0
Con parámetros opcionales: 
GET {batchUrl}/pools/{poolId}/nodes/{nodeId}/files/{filePath}?timeout={timeout}&api-version=2024-07-01.20.0

Parámetros de identificador URI

Nombre En Requerido Tipo Description
batchUrl
 path True

string

Dirección URL base de todas las solicitudes de servicio de Azure Batch.
filePath
 path True

string

Ruta de acceso al archivo de nodo de proceso del que desea obtener el contenido.
nodeId
 path True

string

Identificador del nodo de proceso que contiene el archivo.
poolId
 path True

string

Identificador del grupo que contiene el nodo de proceso.
api-version
 query True

string

Versión de la API de cliente.
timeout
 query

integer (int32)

Tiempo máximo que el servidor puede dedicar a procesar la solicitud, en segundos. El valor predeterminado es 30 segundos. Si el valor es mayor que 30, se usará el valor predeterminado en su lugar.

Encabezado de la solicitud

Media Types: "application/json; odata=minimalmetadata"

Nombre Requerido Tipo Description
client-request-id

string (uuid)

La identidad de solicitud generada por el autor de la llamada, en forma de GUID sin decoración como llaves, por ejemplo, 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id

boolean

Si el servidor debe devolver el client-request-id en la respuesta.
ocp-date

string (date-time-rfc1123)

Hora en que se emitió la solicitud. Las bibliotecas cliente suelen establecer esto en la hora del reloj del sistema actual; establézcalo explícitamente si llama directamente a la API REST.
ocp-range

string

Intervalo de bytes que se va a recuperar. El valor predeterminado es recuperar todo el archivo. El formato es bytes=startRange-endRange.
If-Modified-Since

string (date-time-rfc1123)

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio se ha modificado desde el momento especificado.
If-Unmodified-Since

string (date-time-rfc1123)

Marca de tiempo que indica la hora de última modificación del recurso conocido para el cliente. La operación solo se realizará si el recurso del servicio no se ha modificado desde el momento especificado.

Respuestas

Nombre Tipo Description
200 OK

object

Contenido del archivo.

Media Types: "application/json", "application/octet-stream"

Encabezados

  • client-request-id: string
  • request-id: string
  • ETag: string
  • Last-Modified: string
  • ocp-creation-time: string
  • ocp-batch-file-isdirectory: boolean
  • ocp-batch-file-url: string
  • ocp-batch-file-mode: string
  • Content-Type: string
  • Content-Length: integer
Other Status Codes

BatchError

Error del servicio Batch.

Media Types: "application/json", "application/octet-stream"

Seguridad

azure_auth

Flujo de código de autenticación de Microsoft Entra OAuth 2.0

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation Suplantar la cuenta de usuario

Authorization

Tipo: apiKey
En: header

Ejemplos

Get File From Compute Node

Solicitud de ejemplo

GET account.region.batch.azure.com/pools/poolId/nodes/nodeId/files/workitems\jobId\job-1\task1\wd\testFile.txt?api-version=2024-07-01.20.0

Respuesta de muestra

status code:
200 
"This is actually a byte stream. This request/response is being presented as a string for readability in the example"

Definiciones

Nombre Description
BatchError

Respuesta de error recibida del servicio Azure Batch.
BatchErrorDetail

Un elemento de información adicional incluida en una respuesta de error de Azure Batch.
ErrorMessage

Mensaje de error recibido en una respuesta de error de Azure Batch.

BatchError

Object

Respuesta de error recibida del servicio Azure Batch.

Nombre Tipo Description
code

string

Identificador del error. Los códigos son invariables y están diseñados para consumirse mediante programación.
message

ErrorMessage

Mensaje que describe el error, diseñado para ser adecuado para mostrarse en una interfaz de usuario.
values

BatchErrorDetail[]

Colección de pares clave-valor que contienen detalles adicionales sobre el error.

BatchErrorDetail

Object

Un elemento de información adicional incluida en una respuesta de error de Azure Batch.

Nombre Tipo Description
key

string

Identificador que especifica el significado de la propiedad Value.
value

string

La información adicional incluida con la respuesta de error.

ErrorMessage

Object

Mensaje de error recibido en una respuesta de error de Azure Batch.

Nombre Tipo Description
lang

string

El código de idioma del mensaje de error
value

string

El texto del mensaje.