auto Import Jobs - Create Or Update

Maak of werk een automatische importtaak bij.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.StorageCache/amlFilesystems/{amlFilesystemName}/autoImportJobs/{autoImportJobName}?api-version=2026-01-01

URI-parameters

Name In Vereist Type Description
amlFilesystemName
path True

string

minLength: 2
maxLength: 80
pattern: ^[0-9a-zA-Z][-0-9a-zA-Z_]{0,78}[0-9a-zA-Z]$

Naam voor het AML-bestandssysteem. Hiermee staat u alfanumerieke, onderstrepingstekens en afbreekstreepjes toe. Begin en eindig met alfanumeriek.

autoImportJobName
path True

string

minLength: 2
maxLength: 80
pattern: ^[0-9a-zA-Z][-0-9a-zA-Z_]{0,78}[0-9a-zA-Z]$

Naam voor de automatische importtaak. Hiermee staat u alfanumerieke, onderstrepingstekens en afbreekstreepjes toe. Begin en eindig met alfanumeriek.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is hoofdletterongevoelig.

subscriptionId
path True

string

minLength: 1

De id van het doelabonnement.

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Vereist Type Description
location True

string

De geografische locatie waar de resource zich bevindt

properties.adminStatus

AutoImportJobPropertiesAdminStatus

De administratieve status van de automatische importtaak. Mogelijke waarden: 'Inschakelen', 'Uitschakelen'. Als u de waarde 'Uitschakelen' invoert, wordt de huidige actieve automatische importtaak uitgeschakeld. Deze is standaard ingesteld op Inschakelen.

properties.autoImportPrefixes

string[]

Een matrix met blobpaden/voorvoegsels die automatisch worden geïmporteerd in de clusternaamruimte. Deze heeft '/' als de standaardwaarde. Het aantal maximaal toegestane paden is 100.

properties.conflictResolutionMode

ConflictResolutionMode

Hoe de automatische importtaak omgaat met conflicten. Als de automatische importtaak bijvoorbeeld een map probeert binnen te halen, maar een bestand zich op dat pad bevindt, hoe wordt dit dan afgehandeld. Fail geeft aan dat de automatische importtaak onmiddellijk moet worden gestopt en niets met het conflict moet worden gedaan. Skip geeft aan dat het conflict moet worden overschreden. OverwriteIfDirty zorgt ervoor dat de automatische importtaak het bestand of de map verwijdert en opnieuw importeert als het een conflicterend type is, vuil is of momenteel is vrijgegeven. OverwriteAlways breidt OverwriteIfDirty uit om het vrijgeven van bestanden op te nemen die zijn hersteld, maar die niet vuil waren. Raadpleeg https://learn.microsoft.com/en-us/azure/azure-managed-lustre/blob-integration#conflict-resolution-mode voor een grondige uitleg van deze resolutiemodi.

properties.enableDeletions

boolean

Of verwijderingen tijdens automatische import al dan niet moeten worden ingeschakeld. Dit heeft alleen invloed op overwrite-dirty.

properties.maximumErrors

integer (int64)

Totaal aantal niet-conflictgeoriënteerde fouten (bijv. OS-fouten) die Import tolereert, wordt getolereerd voordat deze wordt afgesloten met een fout. -1 betekent oneindig. 0 betekent onmiddellijk afsluiten bij elke fout.

tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

AutoImportJob

Resource 'AutoImportJob' updateoperatie is geslaagd

201 Created

AutoImportJob

Resource 'AutoImportJob' aanmaakoperatie geslaagd

Kopteksten

  • Azure-AsyncOperation: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation zich voordoen als uw gebruikersaccount

Voorbeelden

autoImportJobs_CreateOrUpdate

Voorbeeldaanvraag

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.StorageCache/amlFilesystems/fs1/autoImportJobs/autojob1?api-version=2026-01-01

{
  "location": "eastus",
  "properties": {
    "adminStatus": "Enable",
    "autoImportPrefixes": [
      "/"
    ],
    "conflictResolutionMode": "Skip",
    "enableDeletions": false,
    "maximumErrors": 0
  },
  "tags": {
    "Dept": "ContosoAds"
  }
}

Voorbeeldrespons

{
  "name": "autojob1",
  "type": "Microsoft.StorageCache/amlFilesystem/autoImportJob",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.StorageCache/amlfilesystems/fs1/autoImportJobs/autojob1",
  "location": "eastus",
  "properties": {
    "adminStatus": "Enable",
    "autoImportPrefixes": [
      "/"
    ],
    "conflictResolutionMode": "Skip",
    "enableDeletions": false,
    "maximumErrors": 0,
    "provisioningState": "Succeeded",
    "status": {
      "blobSyncEvents": {
        "deletions": 20,
        "importedDirectories": 100,
        "importedFiles": 500,
        "importedSymlinks": 50,
        "lastChangeFeedEventConsumedTime": "2024-03-21T18:35:43.511Z",
        "lastTimeFullySynchronized": "2024-03-21T18:25:43.511Z",
        "preexistingDirectories": 1000,
        "preexistingFiles": 10000,
        "preexistingSymlinks": 200,
        "rateOfBlobImport": 120,
        "totalBlobsImported": 11850,
        "totalConflicts": 1,
        "totalErrors": 3
      },
      "importedDirectories": 1000,
      "importedFiles": 8000,
      "importedSymlinks": 1000,
      "lastStartedTimeUTC": "2024-03-21T17:25:43.511Z",
      "preexistingDirectories": 80000,
      "preexistingFiles": 800000,
      "preexistingSymlinks": 10000,
      "rateOfBlobImport": 4000,
      "rateOfBlobWalk": 10000,
      "scanEndTime": "2024-03-21T18:25:43.511Z",
      "scanStartTime": "2024-03-21T17:25:43.511Z",
      "state": "InProgress",
      "totalBlobsImported": 900000,
      "totalBlobsWalked": 1000000,
      "totalConflicts": 5,
      "totalErrors": 10
    }
  },
  "tags": {
    "Dept": "ContosoAds"
  }
}
{
  "name": "autojob1",
  "type": "Microsoft.StorageCache/amlFilesystem/autoImportJob",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.StorageCache/amlfilesystems/fs1/autoImportJobs/autojob1",
  "location": "eastus",
  "properties": {
    "adminStatus": "Enable",
    "autoImportPrefixes": [
      "/"
    ],
    "conflictResolutionMode": "Skip",
    "enableDeletions": false,
    "maximumErrors": 0,
    "provisioningState": "Succeeded",
    "status": {
      "blobSyncEvents": {
        "deletions": 20,
        "importedDirectories": 100,
        "importedFiles": 500,
        "importedSymlinks": 50,
        "lastChangeFeedEventConsumedTime": "2024-03-21T18:35:43.511Z",
        "lastTimeFullySynchronized": "2024-03-21T18:25:43.511Z",
        "preexistingDirectories": 1000,
        "preexistingFiles": 10000,
        "preexistingSymlinks": 200,
        "rateOfBlobImport": 120,
        "totalBlobsImported": 11850,
        "totalConflicts": 1,
        "totalErrors": 3
      },
      "importedDirectories": 1000,
      "importedFiles": 8000,
      "importedSymlinks": 1000,
      "lastStartedTimeUTC": "2024-03-21T17:25:43.511Z",
      "preexistingDirectories": 80000,
      "preexistingFiles": 800000,
      "preexistingSymlinks": 10000,
      "rateOfBlobImport": 4000,
      "rateOfBlobWalk": 10000,
      "scanEndTime": "2024-03-21T18:25:43.511Z",
      "scanStartTime": "2024-03-21T17:25:43.511Z",
      "state": "InProgress",
      "totalBlobsImported": 900000,
      "totalBlobsWalked": 1000000,
      "totalConflicts": 5,
      "totalErrors": 10
    }
  },
  "tags": {
    "Dept": "ContosoAds"
  }
}

Definities

Name Description
AutoImportJob

Een exemplaar van een taak voor het automatisch importeren. Volgt Azure Resource Manager standaarden: https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md

AutoImportJobPropertiesAdminStatus

De administratieve status van de automatische importtaak. Mogelijke waarden: 'Inschakelen', 'Uitschakelen'. Als u de waarde 'Uitschakelen' invoert, wordt de huidige actieve automatische importtaak uitgeschakeld. Deze is standaard ingesteld op Inschakelen.

AutoImportJobPropertiesProvisioningState

Arm-inrichtingsstatus.

AutoImportJobPropertiesStatusBlobSyncEvents

De bulkcode van het opslagaccount wijzigt de feedstatus van de automatische importtaak.

AutoImportJobState

De status van de automatische importbewerking.

ConflictResolutionMode

Hoe de automatische importtaak omgaat met conflicten. Als de automatische importtaak bijvoorbeeld een map probeert binnen te halen, maar een bestand zich op dat pad bevindt, hoe wordt dit dan afgehandeld. Fail geeft aan dat de automatische importtaak onmiddellijk moet worden gestopt en niets met het conflict moet worden gedaan. Skip geeft aan dat het conflict moet worden overschreden. OverwriteIfDirty zorgt ervoor dat de automatische importtaak het bestand of de map verwijdert en opnieuw importeert als het een conflicterend type is, vuil is of momenteel is vrijgegeven. OverwriteAlways breidt OverwriteIfDirty uit om het vrijgeven van bestanden op te nemen die zijn hersteld, maar die niet vuil waren. Raadpleeg https://learn.microsoft.com/en-us/azure/azure-managed-lustre/blob-integration#conflict-resolution-mode voor een grondige uitleg van deze resolutiemodi.

createdByType

Het type identiteit waarmee de resource is gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

AutoImportJob

Een exemplaar van een taak voor het automatisch importeren. Volgt Azure Resource Manager standaarden: https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md

Name Type Default value Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.adminStatus

AutoImportJobPropertiesAdminStatus

Enable

De administratieve status van de automatische importtaak. Mogelijke waarden: 'Inschakelen', 'Uitschakelen'. Als u de waarde 'Uitschakelen' invoert, wordt de huidige actieve automatische importtaak uitgeschakeld. Deze is standaard ingesteld op Inschakelen.

properties.autoImportPrefixes

string[]

Een matrix met blobpaden/voorvoegsels die automatisch worden geïmporteerd in de clusternaamruimte. Deze heeft '/' als de standaardwaarde. Het aantal maximaal toegestane paden is 100.

properties.conflictResolutionMode

ConflictResolutionMode

Skip

Hoe de automatische importtaak omgaat met conflicten. Als de automatische importtaak bijvoorbeeld een map probeert binnen te halen, maar een bestand zich op dat pad bevindt, hoe wordt dit dan afgehandeld. Fail geeft aan dat de automatische importtaak onmiddellijk moet worden gestopt en niets met het conflict moet worden gedaan. Skip geeft aan dat het conflict moet worden overschreden. OverwriteIfDirty zorgt ervoor dat de automatische importtaak het bestand of de map verwijdert en opnieuw importeert als het een conflicterend type is, vuil is of momenteel is vrijgegeven. OverwriteAlways breidt OverwriteIfDirty uit om het vrijgeven van bestanden op te nemen die zijn hersteld, maar die niet vuil waren. Raadpleeg https://learn.microsoft.com/en-us/azure/azure-managed-lustre/blob-integration#conflict-resolution-mode voor een grondige uitleg van deze resolutiemodi.

properties.enableDeletions

boolean

False

Of verwijderingen tijdens automatische import al dan niet moeten worden ingeschakeld. Dit heeft alleen invloed op overwrite-dirty.

properties.maximumErrors

integer (int64)

Totaal aantal niet-conflictgeoriënteerde fouten (bijv. OS-fouten) die Import tolereert, wordt getolereerd voordat deze wordt afgesloten met een fout. -1 betekent oneindig. 0 betekent onmiddellijk afsluiten bij elke fout.

properties.provisioningState

AutoImportJobPropertiesProvisioningState

Arm-inrichtingsstatus.

properties.status.blobSyncEvents

AutoImportJobPropertiesStatusBlobSyncEvents

De bulkcode van het opslagaccount wijzigt de feedstatus van de automatische importtaak.

properties.status.importedDirectories

integer (int64)

Aantal mappen dat tijdens de volledige scan is geïmporteerd.

properties.status.importedFiles

integer (int64)

Aantal bestanden dat tijdens de volledige scan is geïmporteerd.

properties.status.importedSymlinks

integer (int64)

Aantal symlinks geïmporteerd tijdens volledige scan.

properties.status.lastCompletionTimeUTC

string (date-time)

De tijd (in UTC) van de laatste voltooide automatische importtaak.

properties.status.lastStartedTimeUTC

string (date-time)

De tijd (in UTC) waarop de laatste automatische importtaak is gestart.

properties.status.preexistingDirectories

integer (int64)

Aantal reeds bestaande mappen tijdens volledige scan.

properties.status.preexistingFiles

integer (int64)

Aantal reeds bestaande bestanden tijdens volledige scan.

properties.status.preexistingSymlinks

integer (int64)

Aantal reeds bestaande symlinks tijdens volledige scan.

properties.status.rateOfBlobImport

integer (int64)

Snelheid van blob-import tijdens volledige scan.

properties.status.rateOfBlobWalk

integer (int64)

Snelheid van blobs gelopen tijdens volledige scan.

properties.status.scanEndTime

string (date-time)

Datum en tijd waarop de volledige scan is geëindigd.

properties.status.scanStartTime

string (date-time)

Datum en tijd waarop de momenteel lopende volledige scan is begonnen.

properties.status.state

AutoImportJobState

De status van de automatische importbewerking.

properties.status.statusCode

string

Door de server gedefinieerde statuscode voor automatische importtaak.

properties.status.statusMessage

string

Door de server gedefinieerd statusbericht voor automatische importtaak.

properties.status.totalBlobsImported

integer (int64)

Het totale aantal blobs dat tijdens de volledige scan is geïmporteerd.

properties.status.totalBlobsWalked

integer (int64)

Het totale aantal klodders dat tijdens de volledige scan is gelopen.

properties.status.totalConflicts

integer (int64)

Totaal aantal conflicten dat is opgetreden tijdens de volledige scan.

properties.status.totalErrors

integer (int64)

Totaal aantal fouten dat is opgetreden tijdens de volledige scan.

systemData

systemData

Azure Resource Manager metadata met creationBy en modifiedBy informatie.

tags

object

Resourcetags.

type

string

Het type bron. Bijvoorbeeld: "Microsoft. Compute/virtualMachines" of "Microsoft. Opslag/opslagAccounts"

AutoImportJobPropertiesAdminStatus

De administratieve status van de automatische importtaak. Mogelijke waarden: 'Inschakelen', 'Uitschakelen'. Als u de waarde 'Uitschakelen' invoert, wordt de huidige actieve automatische importtaak uitgeschakeld. Deze is standaard ingesteld op Inschakelen.

Waarde Description
Enable

Enable

Disable

Disable

AutoImportJobPropertiesProvisioningState

Arm-inrichtingsstatus.

Waarde Description
Succeeded

Geslaagd

Failed

Mislukt

Creating

Creëren

Deleting

Verwijderen

Updating

Bijwerken

Canceled

Geannuleerd

AutoImportJobPropertiesStatusBlobSyncEvents

De bulkcode van het opslagaccount wijzigt de feedstatus van de automatische importtaak.

Name Type Description
deletions

integer (int64)

Aantal verwijderingen tijdens automatisch importeren.

importedDirectories

integer (int64)

Aantal mappen geïmporteerd tijdens automatische import.

importedFiles

integer (int64)

Aantal bestanden dat is geïmporteerd tijdens automatische import.

importedSymlinks

integer (int64)

Aantal symlinks geïmporteerd tijdens automatische import.

lastChangeFeedEventConsumedTime

string (date-time)

Datum en tijd van de laatste gebeurtenis 'Feed wijzigen' die is verbruikt.

lastTimeFullySynchronized

string (date-time)

Datum en tijd wanneer de laatste keer volledig gesynchroniseerd is.

preexistingDirectories

integer (int64)

Aantal reeds bestaande mappen tijdens automatische import.

preexistingFiles

integer (int64)

Aantal reeds bestaande bestanden tijdens automatische import.

preexistingSymlinks

integer (int64)

Aantal reeds bestaande symlinks tijdens automatische import.

rateOfBlobImport

integer (int64)

Snelheid van blob-import per seconde tijdens automatische import.

totalBlobsImported

integer (int64)

Totaal aantal blobs geïmporteerd tijdens automatische import.

totalConflicts

integer (int64)

Totaal aantal conflicten die zijn opgetreden tijdens het automatisch importeren.

totalErrors

integer (int64)

Totaal aantal fouten dat is opgetreden tijdens het automatisch importeren.

AutoImportJobState

De status van de automatische importbewerking.

Waarde Description
InProgress

In uitvoering

Failed

Mislukt

Disabling

Uitschakelen

Disabled

Disabled

ConflictResolutionMode

Hoe de automatische importtaak omgaat met conflicten. Als de automatische importtaak bijvoorbeeld een map probeert binnen te halen, maar een bestand zich op dat pad bevindt, hoe wordt dit dan afgehandeld. Fail geeft aan dat de automatische importtaak onmiddellijk moet worden gestopt en niets met het conflict moet worden gedaan. Skip geeft aan dat het conflict moet worden overschreden. OverwriteIfDirty zorgt ervoor dat de automatische importtaak het bestand of de map verwijdert en opnieuw importeert als het een conflicterend type is, vuil is of momenteel is vrijgegeven. OverwriteAlways breidt OverwriteIfDirty uit om het vrijgeven van bestanden op te nemen die zijn hersteld, maar die niet vuil waren. Raadpleeg https://learn.microsoft.com/en-us/azure/azure-managed-lustre/blob-integration#conflict-resolution-mode voor een grondige uitleg van deze resolutiemodi.

Waarde Description
Fail

Fail

Skip

Overslaan

OverwriteIfDirty

OverwriteIfDirty

OverwriteAlways

OverwriteAlways

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.