Skip to main content

path

Creates, updates, deletes, gets or lists a path resource.

Overview

Namepath
TypeResource
Idazure.storage_file_datalake.path

Fields

The following fields are returned by SELECT queries:

SELECT not supported for this resource, use SHOW METHODS to view available operations for the resource.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
leaseexecx-ms-lease-action, x-ms-version, endpointx-ms-client-request-id, timeout, x-ms-lease-break-period, x-ms-lease-id, x-ms-proposed-lease-id, If-Match, If-None-Match, If-Modified-Since, If-Unmodified-Since, x-ms-lease-durationLease Path. Create and manage a lease to restrict write and delete access to the path. This operation supports conditional HTTP requests. For more information, see Specifying Conditional Headers for Blob Service Operations _.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
endpointstringThe service endpoint host (no scheme). (default: )
x-ms-lease-actionstringThere are five lease actions: "acquire", "break", "change", "renew", and "release". Use "acquire" and specify the "x-ms-proposed-lease-id" and "x-ms-lease-duration" to acquire a new lease. Use "break" to break an existing lease. When a lease is broken, the lease break period is allowed to elapse, during which time no lease operation except break and release can be performed on the file. When a lease is successfully broken, the response indicates the interval in seconds until a new lease can be acquired. Use "change" and specify the current lease ID in "x-ms-lease-id" and the new lease ID in "x-ms-proposed-lease-id" to change the lease ID of an active lease. Use "renew" and specify the "x-ms-lease-id" to renew an existing lease. Use "release" and specify the "x-ms-lease-id" to release a lease. Known values are: "acquire", "break", "change", "renew", and "release". Required.
x-ms-versionstring
If-Matchstring
If-Modified-Sincestring
If-None-Matchstring
If-Unmodified-Sincestring
timeoutintegerThe timeout parameter is expressed in seconds. For more information, see
x-ms-client-request-idstringProvides a client-generated, opaque value with a 1 KB character limit that is recorded in the analytics logs when storage analytics logging is enabled. Default value is None.
x-ms-lease-break-periodintegerThe lease break period duration is optional to break a lease, and specifies the break period of the lease in seconds. The lease break duration must be between 0 and 60 seconds. Default value is None.
x-ms-lease-durationinteger
x-ms-lease-idstring
x-ms-proposed-lease-idstringProposed lease ID, in a GUID string format. The Blob service returns 400 (Invalid request) if the proposed lease ID is not in the correct format. See Guid Constructor (String) for a list of valid GUID string formats. Default value is None.

Lifecycle Methods

Lease Path. Create and manage a lease to restrict write and delete access to the path. This operation supports conditional HTTP requests. For more information, see Specifying Conditional Headers for Blob Service Operations _.

EXEC azure.storage_file_datalake.path.lease 
@x-ms-lease-action='{{ x-ms-lease-action }}' --required,
@x-ms-version='{{ x-ms-version }}' --required,
@endpoint='{{ endpoint }}' --required,
@x-ms-client-request-id='{{ x-ms-client-request-id }}',
@timeout='{{ timeout }}',
@x-ms-lease-break-period='{{ x-ms-lease-break-period }}',
@x-ms-lease-id='{{ x-ms-lease-id }}',
@x-ms-proposed-lease-id='{{ x-ms-proposed-lease-id }}',
@If-Match='{{ If-Match }}',
@If-None-Match='{{ If-None-Match }}',
@If-Modified-Since='{{ If-Modified-Since }}',
@If-Unmodified-Since='{{ If-Unmodified-Since }}',
@x-ms-lease-duration='{{ x-ms-lease-duration }}'
@@json=
'{
"leaseId": "{{ leaseId }}"
}'
;