import Jobs - Get

Referencia

Servicio:: Storagecache

Versión de la API:: 2024-07-01

Devuelve un trabajo de importación.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}/importJobs/{importJobName}?api-version=2024-07-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
amlFilesystemName	path	True	string minLength: 2 maxLength: 80 pattern: ^[0-9a-zA-Z][-0-9a-zA-Z_]{0,78}[0-9a-zA-Z]$	Nombre del sistema de archivos AML. Permite caracteres alfanuméricos, caracteres de subrayado y guiones. Comience y termine con alfanumérico.
importJobName	path	True	string minLength: 2 maxLength: 80 pattern: ^[0-9a-zA-Z][-0-9a-zA-Z_]{0,78}[0-9a-zA-Z]$	Nombre del trabajo de importación. Permite caracteres alfanuméricos, caracteres de subrayado y guiones. Comience y termine con alfanumérico.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre no distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
api-version	query	True	string minLength: 1	Versión de la API que se va a usar para esta operación.

Respuestas

Nombre	Tipo	Description
200 OK	ImportJob	Devuelve el objeto de trabajo de importación correspondiente a amlFilesystemName.
Other Status Codes	ErrorResponse	Respuesta de error que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

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

Ejemplos

importJobs_Get

Solicitud de ejemplo

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.StorageCache/amlFilesystems/fs1/importJobs/job1?api-version=2024-07-01

Respuesta de muestra

status code:: 200

{
  "name": "job1",
  "location": "eastus",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.StorageCache/amlfilesystems/fs1/importJobs/job1",
  "type": "Microsoft.StorageCache/amlFilesystem/importJob",
  "properties": {
    "adminStatus": "Active",
    "provisioningState": "Succeeded",
    "importPrefixes": [
      "/"
    ],
    "conflictResolutionMode": "OverwriteAlways",
    "maximumErrors": 0,
    "status": {
      "state": "Completed",
      "statusMessage": "Import job completed successfully",
      "totalBlobsWalked": 1000000,
      "blobsWalkedPerSecond": 10000,
      "totalBlobsImported": 1000000,
      "importedFiles": 1000,
      "importedDirectories": 500,
      "importedSymlinks": 1000,
      "preexistingFiles": 500,
      "preexistingDirectories": 100,
      "preexistingSymlinks": 200,
      "blobsImportedPerSecond": 4000,
      "totalErrors": 1,
      "totalConflicts": 1,
      "lastCompletionTime": "2019-04-21T18:25:43.511Z",
      "lastStartedTime": "2019-04-21T17:25:43.511Z"
    }
  }
}

Definiciones

Nombre	Description
ConflictResolutionMode	Cómo controlará el trabajo de importación los conflictos. Por ejemplo, si el trabajo de importación intenta incorporar un directorio, pero un archivo está en esa ruta de acceso, cómo lo controla. Error indica que el trabajo de importación debe detenerse inmediatamente y no hacer nada con el conflicto. Skip indica que debe pasar el conflicto. OverwriteIfDirty hace que el trabajo de importación elimine y vuelva a importar el archivo o directorio si es un tipo en conflicto, está sucio o no se importó anteriormente. OverwriteAlways extiende OverwriteIfDirty para incluir la liberación de archivos que se habían restaurado, pero que no estaban sucios. Consulte https://learn.microsoft.com/en-us/azure/azure-managed-lustre/ para obtener una explicación exhaustiva de estos modos de resolución.
createdByType	Tipo de identidad que creó el recurso.
ErrorAdditionalInfo	Información adicional sobre el error de administración de recursos.
ErrorDetail	Detalle del error.
ErrorResponse	Respuesta de error
ImportJob	Una instancia de trabajo de importación. Sigue los estándares de Azure Resource Manager: https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md
ImportJobAdminStatus	Estado administrativo del trabajo de importación. Valores posibles: "Active", "Cancel". Al pasar un valor de "Cancelar", se cancelará el trabajo de importación activo actual. De forma predeterminada, se establece en "Activo".
ImportJobProvisioningStateType	Estado de aprovisionamiento de ARM.
ImportStatusType	Estado operativo del trabajo de importación. InProgress indica que la importación todavía se está ejecutando. Cancelado indica que el usuario lo ha cancelado. Completado indica que la importación ha finalizado, importando correctamente todos los blobs detectados en el espacio de nombres lustre. CompletedPartial indica que la importación finalizó, pero se encontraron algunos blobs en conflicto y no se pudieron importar u otros errores se encontraron. Error significa que la importación no se pudo completar debido a un error irrecuperable.
systemData	Metadatos relativos a la creación y última modificación del recurso.

ConflictResolutionMode

Enumeración

Cómo controlará el trabajo de importación los conflictos. Por ejemplo, si el trabajo de importación intenta incorporar un directorio, pero un archivo está en esa ruta de acceso, cómo lo controla. Error indica que el trabajo de importación debe detenerse inmediatamente y no hacer nada con el conflicto. Skip indica que debe pasar el conflicto. OverwriteIfDirty hace que el trabajo de importación elimine y vuelva a importar el archivo o directorio si es un tipo en conflicto, está sucio o no se importó anteriormente. OverwriteAlways extiende OverwriteIfDirty para incluir la liberación de archivos que se habían restaurado, pero que no estaban sucios. Consulte https://learn.microsoft.com/en-us/azure/azure-managed-lustre/ para obtener una explicación exhaustiva de estos modos de resolución.

Valor	Description
Fail
OverwriteAlways
OverwriteIfDirty
Skip

createdByType

Enumeración

Tipo de identidad que creó el recurso.

Valor	Description
Application
Key
ManagedIdentity
User

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre	Tipo	Description
info	object	Información adicional.
type	string	Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	Información adicional del error.
code	string	Código de error.
details	ErrorDetail[]	Detalles del error.
message	string	Mensaje de error.
target	string	Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre	Tipo	Description
error	ErrorDetail	Objeto de error.

ImportJob

Object

Una instancia de trabajo de importación. Sigue los estándares de Azure Resource Manager: https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md

Nombre	Tipo	Valor predeterminado	Description
id	string		Identificador de recurso completo para el recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string		Ubicación geográfica donde reside el recurso
name	string		Nombre del recurso
properties.adminStatus	ImportJobAdminStatus	Active	Estado administrativo del trabajo de importación. Valores posibles: "Active", "Cancel". Al pasar un valor de "Cancelar", se cancelará el trabajo de importación activo actual. De forma predeterminada, se establece en "Activo".
properties.conflictResolutionMode	ConflictResolutionMode	Fail	Cómo controlará el trabajo de importación los conflictos. Por ejemplo, si el trabajo de importación intenta incorporar un directorio, pero un archivo está en esa ruta de acceso, cómo lo controla. Error indica que el trabajo de importación debe detenerse inmediatamente y no hacer nada con el conflicto. Skip indica que debe pasar el conflicto. OverwriteIfDirty hace que el trabajo de importación elimine y vuelva a importar el archivo o directorio si es un tipo en conflicto, está sucio o no se importó anteriormente. OverwriteAlways extiende OverwriteIfDirty para incluir la liberación de archivos que se habían restaurado, pero que no estaban sucios. Consulte https://learn.microsoft.com/en-us/azure/azure-managed-lustre/ para obtener una explicación exhaustiva de estos modos de resolución.
properties.importPrefixes	string[]		Matriz de rutas de acceso o prefijos de blobs que se importan en el espacio de nombres del clúster. Tiene '/' como valor predeterminado.
properties.maximumErrors	integer (int32)	0	Total de errores no orientados a conflictos que el trabajo de importación tolerará antes de salir con error. -1 significa infinito. 0 significa salir inmediatamente y es el valor predeterminado.
properties.provisioningState	ImportJobProvisioningStateType		Estado de aprovisionamiento de ARM.
properties.status.blobsImportedPerSecond	integer (int64)		Tasa reciente y actualizada con frecuencia de archivos totales, directorios y vínculos simbólicos importados por segundo.
properties.status.blobsWalkedPerSecond	integer (int64)		Una tasa de blobs reciente y actualizada con frecuencia se ha recorrido por segundo.
properties.status.importedDirectories	integer (int64)		Directorios nuevos o modificados que se han importado en el sistema de archivos.
properties.status.importedFiles	integer (int64)		Archivos nuevos o modificados que se han importado en el sistema de archivos.
properties.status.importedSymlinks	integer (int64)		Recientemente se han agregado vínculos simbólicos al sistema de archivos.
properties.status.lastCompletionTime	string (date-time)		Hora (en UTC) del último trabajo de importación completado.
properties.status.lastStartedTime	string (date-time)		La hora (en UTC) se inició el trabajo de importación más reciente.
properties.status.preexistingDirectories	integer (int64)		Directorios que ya existen en el sistema de archivos y no se han modificado.
properties.status.preexistingFiles	integer (int64)		Archivos que ya existen en el sistema de archivos y que no se han modificado.
properties.status.preexistingSymlinks	integer (int64)		Vínculos simbólicos que ya existen en el sistema de archivos y que no se han modificado.
properties.status.state	ImportStatusType		Estado operativo del trabajo de importación. InProgress indica que la importación todavía se está ejecutando. Cancelado indica que el usuario lo ha cancelado. Completado indica que la importación ha finalizado, importando correctamente todos los blobs detectados en el espacio de nombres lustre. CompletedPartial indica que la importación finalizó, pero se encontraron algunos blobs en conflicto y no se pudieron importar u otros errores se encontraron. Error significa que la importación no se pudo completar debido a un error irrecuperable.
properties.status.statusMessage	string		Mensaje de estado del trabajo de importación.
properties.status.totalBlobsImported	integer (int64)		El total de blobs importados desde el inicio de la importación.
properties.status.totalBlobsWalked	integer (int64)		Se han recorrido los objetos de blob totales.
properties.status.totalConflicts	integer (int32)		Número de conflictos en el trabajo de importación.
properties.status.totalErrors	integer (int32)		Número de errores en el trabajo de importación.
systemData	systemData		Metadatos de Azure Resource Manager que contienen información createdBy y modifiedBy.
tags	object		Etiquetas de recursos.
type	string		Tipo del recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ImportJobAdminStatus

Enumeración

Estado administrativo del trabajo de importación. Valores posibles: "Active", "Cancel". Al pasar un valor de "Cancelar", se cancelará el trabajo de importación activo actual. De forma predeterminada, se establece en "Activo".

Valor	Description
Active
Cancel

ImportJobProvisioningStateType

Enumeración

Estado de aprovisionamiento de ARM.

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

ImportStatusType

Enumeración

Estado operativo del trabajo de importación. InProgress indica que la importación todavía se está ejecutando. Cancelado indica que el usuario lo ha cancelado. Completado indica que la importación ha finalizado, importando correctamente todos los blobs detectados en el espacio de nombres lustre. CompletedPartial indica que la importación finalizó, pero se encontraron algunos blobs en conflicto y no se pudieron importar u otros errores se encontraron. Error significa que la importación no se pudo completar debido a un error irrecuperable.

Valor	Description
Canceled
Cancelling
Completed
CompletedPartial
Failed
InProgress

systemData

Object

Metadatos relativos a la creación y última modificación del recurso.

Nombre	Tipo	Description
createdAt	string (date-time)	Marca de tiempo de creación de recursos (UTC).
createdBy	string	Identidad que creó el recurso.
createdByType	createdByType	Tipo de identidad que creó el recurso.
lastModifiedAt	string (date-time)	Marca de tiempo de la última modificación del recurso (UTC)
lastModifiedBy	string	Identidad que modificó por última vez el recurso.
lastModifiedByType	createdByType	Tipo de identidad que modificó por última vez el recurso.

Compartir a través de

import Jobs - Get

Parámetros de identificador URI

Respuestas

Seguridad

azure_auth

Ámbitos

Ejemplos

importJobs_Get

Solicitud de ejemplo

Respuesta de muestra

Definiciones

ConflictResolutionMode

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImportJob

ImportJobAdminStatus

ImportJobProvisioningStateType

ImportStatusType

systemData