Path - Lease
Percorso lease
Creare e gestire un lease per limitare l'accesso in scrittura ed eliminazione al percorso. Questa operazione supporta le richieste HTTP condizionali. Per altre informazioni, vedere Specifica di intestazioni condizionali per le operazioni del servizio BLOB.
POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}
POST https://{accountName}.{dnsSuffix}/{filesystem}/{path}?timeout={timeout}
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
account
|
path | True |
string |
Nome dell'account di archiviazione di Azure. |
dns
|
path | True |
string |
Suffisso DNS per l'endpoint di Azure Data Lake Storage. |
filesystem
|
path | True |
string minLength: 3maxLength: 63 pattern: ^[$a-z0-9](?!.*--)[-a-z0-9]{1,61}[a-z0-9]$ |
Identificatore del file system. |
path
|
path | True |
string |
Percorso del file o della directory. |
timeout
|
query |
integer (int32) minimum: 1 |
Valore facoltativo di timeout dell'operazione in secondi. Il periodo inizia quando la richiesta viene ricevuta dal servizio. Se il valore di timeout è trascorso prima del completamento dell'operazione, l'operazione ha esito negativo. |
Intestazione della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
x-ms-lease-action | True |
Sono disponibili cinque azioni di lease: "acquire", "break", "change", "renew" e "release". Usare "acquire" e specificare "x-ms-proposed-lease-id" e "x-ms-lease-duration" per acquisire un nuovo lease. Usare "break" per interrompere un lease esistente. Quando un lease viene interrotto, il periodo di interruzione del lease può trascorrere, durante il quale non è possibile eseguire alcuna operazione di lease tranne interruzione e rilascio nel file. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi fino a quando non è possibile acquisire un nuovo lease. Usare "change" e specificare l'ID lease corrente in "x-ms-lease-id" e il nuovo ID lease in "x-ms-proposed-lease-id" per modificare l'ID lease di un lease attivo. Usare "renew" e specificare "x-ms-lease-id" per rinnovare un lease esistente. Usare "release" e specificare "x-ms-lease-id" per rilasciare un lease. |
|
x-ms-lease-duration |
integer (int32) |
La durata del lease è necessaria per acquisire un lease e specifica la durata del lease in secondi. La durata del lease deve essere compresa tra 15 e 60 secondi o -1 per un lease infinito. |
|
x-ms-lease-break-period |
integer (int32) |
La durata del periodo di interruzione del lease è facoltativa per interrompere un lease e specifica il periodo di interruzione del lease in secondi. La durata dell'interruzione del lease deve essere compresa tra 0 e 60 secondi. |
|
x-ms-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Obbligatorio quando "x-ms-lease-action" è "renew", "change" o "release". Per le azioni di rinnovo e rilascio, questo deve corrispondere all'ID lease corrente. |
|
x-ms-proposed-lease-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
Obbligatorio quando "x-ms-lease-action" è "acquire" o "change". Se l'operazione ha esito positivo, verrà acquisito un lease con questo ID lease. |
|
If-Match |
string |
Opzionale. Un valore ETag. Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa corrisponde al valore specificato. L'ETag deve essere specificato tra virgolette. |
|
If-None-Match |
string |
Opzionale. Valore ETag o valore con caratteri jolly speciali ("*"). Specificare questa intestazione per eseguire l'operazione solo se l'ETag della risorsa non corrisponde al valore specificato. L'ETag deve essere specificato tra virgolette. |
|
If-Modified-Since |
string |
Opzionale. Valore di data e ora. Specificare questa intestazione per eseguire l'operazione solo se la risorsa è stata modificata dopo la data e l'ora specificate. |
|
If-Unmodified-Since |
string |
Opzionale. Valore di data e ora. Specificare questa intestazione per eseguire l'operazione solo se la risorsa non è stata modificata dopo la data e l'ora specificate. |
|
x-ms-client-request-id |
string pattern: ^[{(]?[0-9a-f]{8}[-]?([0-9a-f]{4}[-]?){3}[0-9a-f]{12}[)}]?$ |
UUID registrato nei log di analisi per la risoluzione dei problemi e la correlazione. |
|
x-ms-date |
string |
Specifica l'ora UTC (Coordinated Universal Time) per la richiesta. Questa operazione è necessaria quando si usa l'autorizzazione con chiave condivisa. |
|
x-ms-version |
string |
Specifica la versione del protocollo REST usato per l'elaborazione della richiesta. Questa operazione è necessaria quando si usa l'autorizzazione con chiave condivisa. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
L'azione "renew", "change" o "release" ha avuto esito positivo. Intestazioni
|
|
201 Created |
È stato creato un nuovo lease. L'azione "acquisizione" ha avuto esito positivo. Intestazioni
|
|
202 Accepted |
L'azione di lease di interruzione ha avuto esito positivo. Intestazioni
|
|
Other Status Codes |
Si è verificato un errore. Di seguito sono elencate le possibili stringhe di stato, codice e messaggio HTTP:
Intestazioni
|
Definizioni
Nome | Descrizione |
---|---|
Data |
|
Error |
Oggetto risposta di errore del servizio. |
Path |
Sono disponibili cinque azioni di lease: "acquire", "break", "change", "renew" e "release". Usare "acquire" e specificare "x-ms-proposed-lease-id" e "x-ms-lease-duration" per acquisire un nuovo lease. Usare "break" per interrompere un lease esistente. Quando un lease viene interrotto, il periodo di interruzione del lease può trascorrere, durante il quale non è possibile eseguire alcuna operazione di lease tranne interruzione e rilascio nel file. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi fino a quando non è possibile acquisire un nuovo lease. Usare "change" e specificare l'ID lease corrente in "x-ms-lease-id" e il nuovo ID lease in "x-ms-proposed-lease-id" per modificare l'ID lease di un lease attivo. Usare "renew" e specificare "x-ms-lease-id" per rinnovare un lease esistente. Usare "release" e specificare "x-ms-lease-id" per rilasciare un lease. |
DataLakeStorageError
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto risposta di errore del servizio. |
Error
Oggetto risposta di errore del servizio.
Nome | Tipo | Descrizione |
---|---|---|
code |
string |
Codice di errore del servizio. |
message |
string |
Messaggio di errore del servizio. |
PathLeaseAction
Sono disponibili cinque azioni di lease: "acquire", "break", "change", "renew" e "release". Usare "acquire" e specificare "x-ms-proposed-lease-id" e "x-ms-lease-duration" per acquisire un nuovo lease. Usare "break" per interrompere un lease esistente. Quando un lease viene interrotto, il periodo di interruzione del lease può trascorrere, durante il quale non è possibile eseguire alcuna operazione di lease tranne interruzione e rilascio nel file. Quando un lease viene interrotto correttamente, la risposta indica l'intervallo in secondi fino a quando non è possibile acquisire un nuovo lease. Usare "change" e specificare l'ID lease corrente in "x-ms-lease-id" e il nuovo ID lease in "x-ms-proposed-lease-id" per modificare l'ID lease di un lease attivo. Usare "renew" e specificare "x-ms-lease-id" per rinnovare un lease esistente. Usare "release" e specificare "x-ms-lease-id" per rilasciare un lease.
Valore | Descrizione |
---|---|
acquire | |
break | |
change | |
release | |
renew |