BlobServiceClient class

BlobServiceClient のインスタンスを作成します。

new BlobServiceClient(url: string, pipeline: PipelineLike)

パラメーター

BlobServiceClient のインスタンスを作成します。

new BlobServiceClient(url: string, credential?: StorageSharedKeyCredential | AnonymousCredential | TokenCredential, options?: StoragePipelineOptions)

パラメーター

const account = "<storage account name>";

const defaultAzureCredential = new DefaultAzureCredential();

const blobServiceClient = new BlobServiceClient(
  `https://${account}.blob.core.windows.net`,
  defaultAzureCredential
);

const account = "<storage account name>"
const sharedKeyCredential = new StorageSharedKeyCredential(account, "<account key>");

const blobServiceClient = new BlobServiceClient(
  `https://${account}.blob.core.windows.net`,
  sharedKeyCredential
);

accountName: string

プロパティ値

AnonymousCredential、StorageSharedKeyCredential、またはサービスへの要求を @azure/identity 認証するためのパッケージからの資格情報など。 TokenCredential インターフェイスを実装する オブジェクトを指定することもできます。 指定しない場合は、AnonymousCredential が使用されます。

credential: StorageSharedKeyCredential | AnonymousCredential | TokenCredential

プロパティ値

エンコードされた URL 文字列値。

url: string

プロパティ値

BLOB コンテナーを作成します。

function createContainer(containerName: string, options?: ContainerCreateOptions)

パラメーター

戻り値

コンテナー作成応答と、対応するコンテナー クライアント。

BLOB コンテナーを削除します。

function deleteContainer(containerName: string, options?: ContainerDeleteMethodOptions)

パラメーター

戻り値

コンテナーの削除応答。

指定したアカウントの下で、指定したタグを持つすべての BLOB を検索する非同期反復可能な反復子を返します。 .byPage() は、ページ内の BLOB を一覧表示する非同期反復可能な反復子を返します。

function findBlobsByTags(tagFilterSqlExpression: string, options?: ServiceFindBlobByTagsOptions)

パラメーター

戻り値

接続文字列から BlobServiceClient のインスタンスを作成します。

static function fromConnectionString(connectionString: string, options?: StoragePipelineOptions)

パラメーター

戻り値

共有キー資格情報を使用して構築された BlobServiceClient でのみ使用できます。 渡されたクライアントのプロパティとパラメーターに基づいて、BLOB アカウント Shared Access Signature (SAS) URI を生成します。 SAS は、クライアントの共有キー資格情報によって署名されます。

function generateAccountSasUrl(expiresOn?: Date, permissions?: AccountSASPermissions, resourceTypes?: string, options?: ServiceGenerateAccountSasUrlOptions)

パラメーター

戻り値

このクライアントで表されるリソースへの URI と、生成された SAS トークンで構成されるアカウント SAS URI。

アカウント情報の取得操作は、指定されたアカウントの SKU 名とアカウントの種類を返します。 アカウント情報の取得操作は、バージョン 2018-03-28 以降のサービス バージョンで使用できます。

function getAccountInfo(options?: ServiceGetAccountInfoOptions)

パラメーター

戻り値

サービスのアカウント情報の取得操作の応答データ。

バッチ操作を実行する BlobBatchClient オブジェクトを作成します。

function getBlobBatchClient()

戻り値

このサービスの新しい BlobBatchClient オブジェクト。

オブジェクトを作成します。<xref:ContainerClient>

function getContainerClient(containerName: string)

パラメーター

戻り値

指定されたコンテナー名の新しい ContainerClient オブジェクト。

使用例:

const containerClient = blobServiceClient.getContainerClient("<container name>");

Storage Analyticsおよび CORS (クロスオリジン リソース共有) ルールのプロパティを含む、ストレージ アカウントの BLOB サービスのプロパティを取得します。

function getProperties(options?: ServiceGetPropertiesOptions)

パラメーター

戻り値

サービスのプロパティの取得操作の応答データ。

BLOB Service のレプリケーションに関連する統計情報を取得します。 読み取りアクセスの地理冗長レプリケーションがストレージ アカウントで有効なとき、これは 2 次拠点のエンドポイントでのみ使用できます。

function getStatistics(options?: ServiceGetStatisticsOptions)

パラメーター

戻り値

Service Get Statistics 操作の応答データ。

ベアラー トークン認証 (TokenCredential) を使用している場合にのみ使用できます。 BLOB サービスのユーザー委任キーを取得します。 これは、ベアラー トークン認証を使用する場合にのみ有効な操作です。

function getUserDelegationKey(startsOn: Date, expiresOn: Date, options?: ServiceGetUserDelegationKeyOptions)

パラメーター

戻り値

指定したアカウントのすべてのコンテナーを一覧表示する非同期反復可能反復子を返します。 .byPage() は、ページ内のコンテナーを一覧表示する非同期反復可能反復子を返します。

構文の使用 for await 例:

let i = 1;
for await (const container of blobServiceClient.listContainers()) {
  console.log(`Container ${i++}: ${container.name}`);
}

iter.next() の使用例:

let i = 1;
const iter = blobServiceClient.listContainers();
let containerItem = await iter.next();
while (!containerItem.done) {
  console.log(`Container ${i++}: ${containerItem.value.name}`);
  containerItem = await iter.next();
}

byPage() の使用例:

// passing optional maxPageSize in the page settings
let i = 1;
for await (const response of blobServiceClient.listContainers().byPage({ maxPageSize: 20 })) {
  if (response.containerItems) {
    for (const container of response.containerItems) {
      console.log(`Container ${i++}: ${container.name}`);
    }
  }
}

マーカーでページングを使用する例:

let i = 1;
let iterator = blobServiceClient.listContainers().byPage({ maxPageSize: 2 });
let response = (await iterator.next()).value;

// Prints 2 container names
if (response.containerItems) {
  for (const container of response.containerItems) {
    console.log(`Container ${i++}: ${container.name}`);
  }
}

// Gets next marker
let marker = response.continuationToken;
// Passing next marker as continuationToken
iterator = blobServiceClient
  .listContainers()
  .byPage({ continuationToken: marker, maxPageSize: 10 });
response = (await iterator.next()).value;

// Prints 10 container names
if (response.containerItems) {
  for (const container of response.containerItems) {
     console.log(`Container ${i++}: ${container.name}`);
  }
}

function listContainers(options?: ServiceListContainersOptions)

パラメーター

戻り値

ページングをサポートする asyncIterableIterator。

ストレージ アカウントの BLOB サービス エンドポイントのプロパティを設定します。これには、Storage Analytics、CORS (クロスオリジン リソース共有) ルール、論理的な削除設定のプロパティが含まれます。

function setProperties(properties: BlobServiceProperties, options?: ServiceSetPropertiesOptions)

パラメーター

戻り値

サービス セット プロパティ操作の応答データ。

以前に削除した BLOB コンテナーを復元します。 この API は、コンテナーに関連付けられているストレージ アカウントに対して Container Soft Delete が有効になっている場合にのみ機能します。

function undeleteContainer(deletedContainerName: string, deletedContainerVersion: string, options?: ServiceUndeleteContainerOptions)

パラメーター

戻り値

コンテナーの削除応答。