@azure/storage-file-datalake package
クラス
| AccountSASPermissions |
NODE.JSランタイムでのみ使用できます。 これは、AccountSAS によって付与されるアクセス許可を表す文字列を構築するためのヘルパー クラスです。 値を true に設定すると、これらのアクセス許可を使用するすべての SAS にその操作のアクセス許可が付与されます。 すべての値が設定されたら、これを toString でシリアル化し、AccountSASSignatureValues オブジェクトのアクセス許可フィールドとして設定する必要があります。 このクラスを使用せずにアクセス許可文字列を構築することはできますが、アクセス許可の順序は特定であり、このクラスは正確性を保証します。 |
| AccountSASResourceTypes |
NODE.JSランタイムでのみ使用できます。 これは、AccountSAS によってアクセス可能なリソースを表す文字列を構築するためのヘルパー クラスです。 値を true に設定すると、これらのアクセス許可を使用するすべての SAS によって、そのリソースの種類へのアクセスが許可されます。 すべての値が設定されたら、これを toString でシリアル化し、AccountSASSignatureValues オブジェクトのリソース フィールドとして設定する必要があります。 このクラスを使用せずにリソース文字列を構築することはできますが、リソースの順序は特定であり、このクラスは正確性を保証します。 |
| AccountSASServices |
NODE.JSランタイムでのみ使用できます。 これは、AccountSAS によってアクセス可能なサービスを表す文字列を構築するためのヘルパー クラスです。 値を true に設定すると、これらのアクセス許可を使用するすべての SAS によって、そのサービスへのアクセスが許可されます。 すべての値が設定されたら、これを toString でシリアル化し、AccountSASSignatureValues オブジェクトのサービス フィールドとして設定する必要があります。 このクラスを使用せずにサービス文字列を構築することはできますが、サービスの順序は特定であり、このクラスは正確性を保証します。 |
| AnonymousCredential |
AnonymousCredential は、AnonymousCredentialPolicy オブジェクトの作成に使用される credentialPolicyCreator メンバーを提供します。 AnonymousCredentialPolicy は、パブリック リソースを読み取る HTTP(S) 要求または Shared Access Signature (SAS) で使用する要求で使用されます。 |
| AnonymousCredentialPolicy |
AnonymousCredentialPolicy は、パブリック リソースを読み取る HTTP(S) 要求または Shared Access Signature (SAS) で使用する要求で使用されます。 |
| BaseRequestPolicy |
すべての要求ポリシーの派生元となる基本クラス。 |
| Credential |
資格情報は、Azure Storage HTTP 要求の署名のための抽象クラスです。 このクラスは、CredentialPolicy を生成する credentialPolicyCreator ファクトリをホストします。 |
| CredentialPolicy |
送信前に HTTP(S) 要求に署名するために使用される資格情報ポリシー。 これは抽象クラスです。 |
| DataLakeAclChangeFailedError |
操作が中断されたときにスローされ、後で続行できるエラー。 |
| DataLakeDirectoryClient |
DataLakeDirectoryClient は、Azure Storage ディレクトリへの URL を表します。 |
| DataLakeFileClient |
DataLakeFileClient は、Azure Storage ファイルの URL を表します。 |
| DataLakeFileSystemClient |
DataLakeFileSystemClient は、Azure Storage ファイル システムへの URL を表し、ディレクトリとファイルを操作できます。 |
| DataLakeLeaseClient | |
| DataLakePathClient |
DataLakePathClient は、Azure Storage パス (ディレクトリまたはファイル) への URL を表します。 |
| DataLakeSASPermissions |
NODE.JSランタイムでのみ使用できます。 これは、ServiceSAS によって付与されるアクセス許可を表す文字列を構築するためのヘルパー クラスです。 値を true に設定すると、これらのアクセス許可を使用するすべての SAS にその操作のアクセス許可が付与されます。 すべての値が設定されたら、これを toString でシリアル化し、DataLakeSASSignatureValues オブジェクトの権限フィールドとして設定する必要があります。 このクラスを使用せずにアクセス許可文字列を構築することはできますが、アクセス許可の順序は特定であり、このクラスは正確性を保証します。 |
| DataLakeServiceClient |
DataLakeServiceClient を使用すると、Azure Data Lake サービスのリソースとファイル システムを操作できます。 ストレージ アカウントは、Data Lake サービスの最上位レベルの名前空間を提供します。 |
| DirectorySASPermissions |
これは、ServiceSAS によってディレクトリに付与されるアクセス許可を表す文字列を構築するためのヘルパー クラスです。 値を true に設定すると、これらのアクセス許可を使用するすべての SAS にその操作のアクセス許可が付与されます。 すべての値が設定されたら、これを toString でシリアル化し、DataLakeSASSignatureValues オブジェクトの権限フィールドとして設定する必要があります。 このクラスを使用せずにアクセス許可文字列を構築することはできますが、アクセス許可の順序は特定であり、このクラスは正確性を保証します。 |
| FileSystemSASPermissions |
これは、ServiceSAS によってコンテナーに付与されるアクセス許可を表す文字列を構築するためのヘルパー クラスです。 値を true に設定すると、これらのアクセス許可を使用するすべての SAS にその操作のアクセス許可が付与されます。 すべての値が設定されたら、これを toString でシリアル化し、DataLakeSASSignatureValues オブジェクトの権限フィールドとして設定する必要があります。 このクラスを使用せずにアクセス許可文字列を構築することはできますが、アクセス許可の順序は特定であり、このクラスは正確性を保証します。 |
| Pipeline |
HTTP 要求ポリシーを含む Pipeline クラス。 newPipeline 呼び出すことで、既定のパイプラインを作成できます。 または、Pipeline のコンストラクターによって独自のポリシーを使用してパイプラインを作成することもできます。 カスタマイズしたパイプライン 実装する前に、newPipeline と指定されたポリシーを参照してください。 |
| SASQueryParameters |
Azure Storage SAS のクエリ パラメーターを構成するコンポーネントを表します。 この型は、ユーザーによって直接構築されるわけではありません。これは、AccountSASSignatureValues および <xref:BlobSASSignatureValues> 型によってのみ生成されます。 生成されると、toString() にエンコードして URL に直接追加できます (ただし、既存のクエリ パラメーターがある場合は注意が必要です。これらのクエリ パラメーターを追加する適切な方法に影響する可能性があります)。 注: このクラスのインスタンスは不変です。 |
| StorageBrowserPolicy |
StorageBrowserPolicy は、次のような Node.js とブラウザー ランタイムの違いを処理します。
Node.jsでは、このポリシーは no-op パススルーです。 |
| StorageBrowserPolicyFactory |
StorageBrowserPolicyFactory は、StorageBrowserPolicy オブジェクトの生成を支援するファクトリ クラスです。 |
| StorageRetryPolicy |
指数再試行と線形再試行が実装された再試行ポリシー。 |
| StorageRetryPolicyFactory |
StorageRetryPolicyFactory は、StorageRetryPolicy オブジェクト 生成するのに役立つファクトリ クラスです。 |
| StorageSharedKeyCredential |
NODE.JSランタイムでのみ使用できます。 Azure Storage サービスのアカウント キー承認用の StorageSharedKeyCredential。 |
| StorageSharedKeyCredentialPolicy |
StorageSharedKeyCredentialPolicy は、共有キーを使用して HTTP 要求に署名するために使用されるポリシーです。 |
インターフェイス
型エイリアス
列挙型
| PathGetPropertiesAction |
PathGetPropertiesAction の値を定義します。 使用可能な値は、'getAccessControl'、'getStatus' です。 |
| PathRenameMode |
PathRenameMode の値を定義します。 使用可能な値は、'legacy'、'posix' です。 |
| PathResourceType |
PathResourceType の値を定義します。 指定できる値は、'directory'、'file' です。 |
| SASProtocol |
生成された SAS のプロトコル。 |
| StorageDataLakeAudience |
Storage の既知のクラウド対象ユーザーを定義します。 |
| StorageRetryPolicyType |
RetryPolicy 型。 |
関数
| generate |
NODE.JSランタイムでのみ使用できます。 実際の REST 要求を行うために必要なすべての SAS クエリ パラメーターを含む、SASQueryParameters オブジェクトを生成します。 https://learn.microsoft.com/rest/api/storageservices/constructing-an-account-sas を参照してください |
| generate |
NODE.JSランタイムでのみ使用できます。 SASQueryParameters のインスタンスを作成します。 SAS の作成に必要な設定のみを受け入れます。 オプションの設定については、アクセス許可、startsOn、識別子など、対応するプロパティを直接設定してください。 警告: 識別子が指定されていない場合、アクセス許可と expiresOn が必要です。 このコンストラクターを最初に使用する場合は、識別子または expiresOn & アクセス許可に値を手動で割り当てる必要があります。 次のスニペットを実行する前に、必要な詳細を入力します。 Example
スニペットを実行する前に、必要な詳細を入力します。 Example
|
| generate |
NODE.JSランタイムでのみ使用できます。 SASQueryParameters のインスタンスを作成します。 警告: ユーザー委任 SAS を生成するときに識別子は無視されます。アクセス許可と expiresOn が必要です。 Example
|
| get |
datalake サービスのストレージ アカウントの OAuth 対象ユーザーを取得します。 |
| is |
指定された引数がパイプライン コントラクトを満たすかどうかを判断するヘルパー |
| new |
Credential が指定された新しい Pipeline オブジェクトを作成します。 |
変数
| Rest |
失敗したパイプライン要求のカスタム エラーの種類。 |
| Storage |
Azure Storageで使うOAuthのスコープについて。 |
| To |
|
| To |
|
| logger | このパッケージの |
関数の詳細
generateAccountSASQueryParameters(AccountSASSignatureValues, StorageSharedKeyCredential)
NODE.JSランタイムでのみ使用できます。
実際の REST 要求を行うために必要なすべての SAS クエリ パラメーターを含む、SASQueryParameters オブジェクトを生成します。
https://learn.microsoft.com/rest/api/storageservices/constructing-an-account-sas を参照してください
function generateAccountSASQueryParameters(accountSASSignatureValues: AccountSASSignatureValues, sharedKeyCredential: StorageSharedKeyCredential): SASQueryParameters
パラメーター
- accountSASSignatureValues
- AccountSASSignatureValues
- sharedKeyCredential
- StorageSharedKeyCredential
返品
generateDataLakeSASQueryParameters(DataLakeSASSignatureValues, StorageSharedKeyCredential)
NODE.JSランタイムでのみ使用できます。
SASQueryParameters のインスタンスを作成します。
SAS の作成に必要な設定のみを受け入れます。 オプションの設定については、アクセス許可、startsOn、識別子など、対応するプロパティを直接設定してください。
警告: 識別子が指定されていない場合、アクセス許可と expiresOn が必要です。 このコンストラクターを最初に使用する場合は、識別子または expiresOn & アクセス許可に値を手動で割り当てる必要があります。
次のスニペットを実行する前に、必要な詳細を入力します。
Example
// Generate service level SAS for a file system
const containerSAS = generateDataLakeSASQueryParameters({
fileSystemName, // Required
permissions: ContainerSASPermissions.parse("racwdl"), // Required
startsOn: new Date(), // Optional
expiresOn: new Date(new Date().valueOf() + 86400), // Required. Date type
ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
protocol: SASProtocol.HttpsAndHttp, // Optional
version: "2016-05-31" // Optional
},
sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();
スニペットを実行する前に、必要な詳細を入力します。
Example
// Generate service level SAS for a file
const fileSAS = generateDataLakeSASQueryParameters({
fileSystemName, // Required
fileName, // Required
permissions: DataLakeSASPermissions.parse("racwd"), // Required
startsOn: new Date(), // Optional
expiresOn: new Date(new Date().valueOf() + 86400), // Required. Date type
cacheControl: "cache-control-override", // Optional
contentDisposition: "content-disposition-override", // Optional
contentEncoding: "content-encoding-override", // Optional
contentLanguage: "content-language-override", // Optional
contentType: "content-type-override", // Optional
ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
protocol: SASProtocol.HttpsAndHttp, // Optional
version: "2016-05-31" // Optional
},
sharedKeyCredential // StorageSharedKeyCredential - `new StorageSharedKeyCredential(account, accountKey)`
).toString();
function generateDataLakeSASQueryParameters(dataLakeSASSignatureValues: DataLakeSASSignatureValues, sharedKeyCredential: StorageSharedKeyCredential): SASQueryParameters
パラメーター
- dataLakeSASSignatureValues
- DataLakeSASSignatureValues
- sharedKeyCredential
- StorageSharedKeyCredential
返品
generateDataLakeSASQueryParameters(DataLakeSASSignatureValues, UserDelegationKey, string)
NODE.JSランタイムでのみ使用できます。
SASQueryParameters のインスタンスを作成します。 警告: ユーザー委任 SAS を生成するときに識別子は無視されます。アクセス許可と expiresOn が必要です。
Example
// Generate user delegation SAS for a file system
const userDelegationKey = await dataLakeServiceClient.getUserDelegationKey(startsOn, expiresOn);
const fileSystemSAS = generateDataLakeSASQueryParameters({
fileSystemName, // Required
permissions: FileSystemSASPermissions.parse("racwdl"), // Required
startsOn, // Optional. Date type
expiresOn, // Required. Date type
ipRange: { start: "0.0.0.0", end: "255.255.255.255" }, // Optional
protocol: SASProtocol.HttpsAndHttp, // Optional
version: "2018-11-09" // Must greater than or equal to 2018-11-09 to generate user delegation SAS
},
userDelegationKey, // UserDelegationKey
accountName
).toString();
function generateDataLakeSASQueryParameters(dataLakeSASSignatureValues: DataLakeSASSignatureValues, userDelegationKey: UserDelegationKey, accountName: string): SASQueryParameters
パラメーター
- dataLakeSASSignatureValues
- DataLakeSASSignatureValues
- userDelegationKey
- UserDelegationKey
blobServiceClient.getUserDelegationKey() の戻り値
- accountName
-
string
返品
getDataLakeServiceAccountAudience(string)
datalake サービスのストレージ アカウントの OAuth 対象ユーザーを取得します。
function getDataLakeServiceAccountAudience(storageAccountName: string): string
パラメーター
- storageAccountName
-
string
返品
string
isPipelineLike(unknown)
指定された引数がパイプライン コントラクトを満たすかどうかを判断するヘルパー
function isPipelineLike(pipeline: unknown): pipeline is PipelineLike
パラメーター
- pipeline
-
unknown
パイプラインである可能性がある引数
返品
pipeline is PipelineLike
引数がパイプライン コントラクトを満たす場合は true
newPipeline(StorageSharedKeyCredential | AnonymousCredential | TokenCredential, StoragePipelineOptions)
Credential が指定された新しい Pipeline オブジェクトを作成します。
function newPipeline(credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, pipelineOptions?: StoragePipelineOptions): Pipeline
パラメーター
- credential
-
StorageSharedKeyCredential | AnonymousCredential | TokenCredential
AnonymousCredential、StorageSharedKeyCredential、サービスへの要求を認証するための @azure/identity パッケージの資格情報など。 TokenCredential インターフェイスを実装するオブジェクトを指定することもできます。 指定しない場合は、AnonymousCredential が使用されます。
- pipelineOptions
- StoragePipelineOptions
Optional. Options.
返品
新しい Pipeline オブジェクト。
変数の詳細
RestError
StorageOAuthScopes
Azure Storageで使うOAuthのスコープについて。
StorageOAuthScopes: string | string[]
型
string | string[]
ToBlobEndpointHostMappings
ToBlobEndpointHostMappings: string[][]
型
string[][]
ToDfsEndpointHostMappings
ToDfsEndpointHostMappings: string[][]
型
string[][]