共用方式為

AppConfigurationClient class

  • 參考
套件:
@azure/app-configuration

Azure 應用程式組態服務的用戶端。

建構函式

AppConfigurationClient(string, AppConfigurationClientOptions)

初始化 AppConfigurationClient 類別的新實例。
AppConfigurationClient(string, TokenCredential, AppConfigurationClientOptions)

使用 TokenCredential 初始化 AppConfigurationClient 類別的新實例。

方法

addConfigurationSetting(AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>, AddConfigurationSettingOptions)

將設定新增至Azure 應用程式組態服務，如果服務已經存在，就會失敗。

使用方式範例：

const result = await client.addConfigurationSetting({ key: "MyKey", label: "MyLabel", value: "MyValue" });
archiveSnapshot(string, UpdateSnapshotOptions)

封存就緒快照集

使用方式範例：

const result = await client.archiveSnapshot({name: "MySnapshot"});
beginCreateSnapshot(SnapshotInfo, CreateSnapshotOptions)

開始建立Azure 應用程式組態服務的快照集，如果已存在，就會失敗。
beginCreateSnapshotAndWait(SnapshotInfo, CreateSnapshotOptions)

開始建立Azure 應用程式組態服務的快照集，等到完成為止，如果已經存在，就會失敗。
deleteConfigurationSetting(ConfigurationSettingId, DeleteConfigurationSettingOptions)

從Azure 應用程式組態服務中刪除設定

使用方式範例：

const deletedSetting = await client.deleteConfigurationSetting({ key: "MyKey", label: "MyLabel" });
getConfigurationSetting(ConfigurationSettingId, GetConfigurationSettingOptions)

從Azure 應用程式組態服務取得設定。

程式碼範例：

const setting = await client.getConfigurationSetting({ key: "MyKey", label: "MyLabel" });
getSnapshot(string, GetSnapshotOptions)

從Azure 應用程式組態服務取得快照集

使用方式範例：

const result = await client.getSnapshot("MySnapshot");
listConfigurationSettings(ListConfigurationSettingsOptions)

列出Azure 應用程式組態服務的設定，選擇性地依索引鍵名稱、標籤和接受日期時間篩選。

程式碼範例：

const allSettingsWithLabel = client.listConfigurationSettings({ labelFilter: "MyLabel" });
listConfigurationSettingsForSnapshot(string, ListConfigurationSettingsForSnapshotOptions)

根據名稱列出快照集Azure 應用程式組態服務的設定，選擇性地依索引鍵名稱、標籤和接受日期時間篩選。

程式碼範例：

const allSettingsWithLabel = client.listConfigurationSettingsForSnashots({ snapshotName: "MySnapshot" });
listRevisions(ListRevisionsOptions)

列出一組索引鍵的修訂，選擇性地依索引鍵名稱、標籤和接受日期時間篩選。

程式碼範例：

const revisionsIterator = client.listRevisions({ keys: ["MyKey"] });
listSnapshots(ListSnapshotsOptions)

列出來自Azure 應用程式組態服務的所有快照集

使用方式範例：

const result = await client.listSnapshots();
recoverSnapshot(string, UpdateSnapshotOptions)

將封存的快照集復原回就緒狀態

使用方式範例：

const result = await client.recoverSnapshot("MySnapshot");
setConfigurationSetting(SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>, SetConfigurationSettingOptions)

設定Azure 應用程式組態服務中索引鍵的值，允許選擇性 etag。
setReadOnly(ConfigurationSettingId, boolean, SetReadOnlyOptions)

設定或清除金鑰的唯讀狀態。
updateSyncToken(string)

新增外部同步處理權杖，以確保服務要求接收最新的值。

建構函式詳細資料

AppConfigurationClient(string, AppConfigurationClientOptions)

初始化 AppConfigurationClient 類別的新實例。

new AppConfigurationClient(connectionString: string, options?: AppConfigurationClientOptions)

參數

connectionString

string

用戶端連線到 Azure 所需的連接字串。

options
AppConfigurationClientOptions

AppConfigurationClient 的選項。

AppConfigurationClient(string, TokenCredential, AppConfigurationClientOptions)

使用 TokenCredential 初始化 AppConfigurationClient 類別的新實例。

new AppConfigurationClient(endpoint: string, tokenCredential: TokenCredential, options?: AppConfigurationClientOptions)

參數

endpoint

string

應用程式組態服務的端點 (，例如： https://sample.azconfig.io) 。

tokenCredential
TokenCredential

物件，實作 TokenCredential 介面，用來驗證對服務的要求。 @azure/identity使用套件來建立符合您需求的認證。

options
AppConfigurationClientOptions

AppConfigurationClient 的選項。

方法詳細資料

addConfigurationSetting(AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>, AddConfigurationSettingOptions)

將設定新增至Azure 應用程式組態服務，如果服務已經存在，就會失敗。

使用方式範例：

const result = await client.addConfigurationSetting({ key: "MyKey", label: "MyLabel", value: "MyValue" });

function addConfigurationSetting(configurationSetting: AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>, options?: AddConfigurationSettingOptions): Promise<AddConfigurationSettingResponse>

參數

configurationSetting

AddConfigurationSettingParam<string> | AddConfigurationSettingParam<FeatureFlagValue> | AddConfigurationSettingParam<SecretReferenceValue>

組態設定。

options
AddConfigurationSettingOptions

要求的選擇性參數。

傳回

Promise<AddConfigurationSettingResponse>

archiveSnapshot(string, UpdateSnapshotOptions)

封存就緒快照集

使用方式範例：

const result = await client.archiveSnapshot({name: "MySnapshot"});

function archiveSnapshot(name: string, options?: UpdateSnapshotOptions): Promise<UpdateSnapshotResponse>

參數

name

string

快照集的名稱。

options
UpdateSnapshotOptions

要求的選擇性參數。

傳回

Promise<UpdateSnapshotResponse>

beginCreateSnapshot(SnapshotInfo, CreateSnapshotOptions)

開始建立Azure 應用程式組態服務的快照集，如果已存在，就會失敗。

function beginCreateSnapshot(snapshot: SnapshotInfo, options?: CreateSnapshotOptions): Promise<SimplePollerLike<OperationState<CreateSnapshotResponse>, CreateSnapshotResponse>>

參數

snapshot
SnapshotInfo
options
CreateSnapshotOptions

傳回

Promise<@azure/core-lro.SimplePollerLike<OperationState<CreateSnapshotResponse>, CreateSnapshotResponse>>

beginCreateSnapshotAndWait(SnapshotInfo, CreateSnapshotOptions)

開始建立Azure 應用程式組態服務的快照集，等到完成為止，如果已經存在，就會失敗。

function beginCreateSnapshotAndWait(snapshot: SnapshotInfo, options?: CreateSnapshotOptions): Promise<CreateSnapshotResponse>

參數

snapshot
SnapshotInfo
options
CreateSnapshotOptions

傳回

Promise<CreateSnapshotResponse>

deleteConfigurationSetting(ConfigurationSettingId, DeleteConfigurationSettingOptions)

從Azure 應用程式組態服務中刪除設定

使用方式範例：

const deletedSetting = await client.deleteConfigurationSetting({ key: "MyKey", label: "MyLabel" });

function deleteConfigurationSetting(id: ConfigurationSettingId, options?: DeleteConfigurationSettingOptions): Promise<DeleteConfigurationSettingResponse>

參數

id
ConfigurationSettingId

要刪除之組態設定的識別碼。

options
DeleteConfigurationSettingOptions

要求 (選擇性參數，例如：etag、標籤)

傳回

Promise<DeleteConfigurationSettingResponse>

getConfigurationSetting(ConfigurationSettingId, GetConfigurationSettingOptions)

從Azure 應用程式組態服務取得設定。

程式碼範例：

const setting = await client.getConfigurationSetting({ key: "MyKey", label: "MyLabel" });

function getConfigurationSetting(id: ConfigurationSettingId, options?: GetConfigurationSettingOptions): Promise<GetConfigurationSettingResponse>

參數

id
ConfigurationSettingId

要取得之組態設定的識別碼。

options
GetConfigurationSettingOptions

要求的選擇性參數。

傳回

Promise<GetConfigurationSettingResponse>

getSnapshot(string, GetSnapshotOptions)

從Azure 應用程式組態服務取得快照集

使用方式範例：

const result = await client.getSnapshot("MySnapshot");

function getSnapshot(name: string, options?: GetSnapshotOptions): Promise<GetSnapshotResponse>

參數

name

string

快照集的名稱。

options
GetSnapshotOptions

要求的選擇性參數。

傳回

Promise<GetSnapshotResponse>

listConfigurationSettings(ListConfigurationSettingsOptions)

列出Azure 應用程式組態服務的設定，選擇性地依索引鍵名稱、標籤和接受日期時間篩選。

程式碼範例：

const allSettingsWithLabel = client.listConfigurationSettings({ labelFilter: "MyLabel" });

function listConfigurationSettings(options?: ListConfigurationSettingsOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>

參數

options
ListConfigurationSettingsOptions

要求的選擇性參數。

傳回

PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>

listConfigurationSettingsForSnapshot(string, ListConfigurationSettingsForSnapshotOptions)

根據名稱列出快照集Azure 應用程式組態服務的設定，選擇性地依索引鍵名稱、標籤和接受日期時間篩選。

程式碼範例：

const allSettingsWithLabel = client.listConfigurationSettingsForSnashots({ snapshotName: "MySnapshot" });

function listConfigurationSettingsForSnapshot(snapshotName: string, options?: ListConfigurationSettingsForSnapshotOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>

參數

snapshotName

string

options
ListConfigurationSettingsForSnapshotOptions

要求的選擇性參數。

傳回

PagedAsyncIterableIterator<ConfigurationSetting<string>, ListConfigurationSettingPage, PageSettings>

listRevisions(ListRevisionsOptions)

列出一組索引鍵的修訂，選擇性地依索引鍵名稱、標籤和接受日期時間篩選。

程式碼範例：

const revisionsIterator = client.listRevisions({ keys: ["MyKey"] });

function listRevisions(options?: ListRevisionsOptions): PagedAsyncIterableIterator<ConfigurationSetting<string>, ListRevisionsPage, PageSettings>

參數

options
ListRevisionsOptions

要求的選擇性參數。

傳回

PagedAsyncIterableIterator<ConfigurationSetting<string>, ListRevisionsPage, PageSettings>

listSnapshots(ListSnapshotsOptions)

列出來自Azure 應用程式組態服務的所有快照集

使用方式範例：

const result = await client.listSnapshots();

function listSnapshots(options?: ListSnapshotsOptions): PagedAsyncIterableIterator<ConfigurationSnapshot, ListSnapshotsPage, PageSettings>

參數

options
ListSnapshotsOptions

要求的選擇性參數。

傳回

PagedAsyncIterableIterator<ConfigurationSnapshot, ListSnapshotsPage, PageSettings>

recoverSnapshot(string, UpdateSnapshotOptions)

將封存的快照集復原回就緒狀態

使用方式範例：

const result = await client.recoverSnapshot("MySnapshot");

function recoverSnapshot(name: string, options?: UpdateSnapshotOptions): Promise<UpdateSnapshotResponse>

參數

name

string

快照集的名稱。

options
UpdateSnapshotOptions

要求的選擇性參數。

傳回

Promise<UpdateSnapshotResponse>

setConfigurationSetting(SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>, SetConfigurationSettingOptions)

設定Azure 應用程式組態服務中索引鍵的值，允許選擇性 etag。

function setConfigurationSetting(configurationSetting: SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>, options?: SetConfigurationSettingOptions): Promise<SetConfigurationSettingResponse>

參數

configurationSetting

SetConfigurationSettingParam<string> | SetConfigurationSettingParam<FeatureFlagValue> | SetConfigurationSettingParam<SecretReferenceValue>

組態值。

options
SetConfigurationSettingOptions

要求的選擇性參數。

程式碼範例：

await client.setConfigurationSetting({ key: "MyKey", value: "MyValue" });

傳回

Promise<SetConfigurationSettingResponse>

setReadOnly(ConfigurationSettingId, boolean, SetReadOnlyOptions)

設定或清除金鑰的唯讀狀態。

function setReadOnly(id: ConfigurationSettingId, readOnly: boolean, options?: SetReadOnlyOptions): Promise<SetReadOnlyResponse>

參數

id
ConfigurationSettingId

要修改之組態設定的識別碼。

readOnly

boolean

options
SetReadOnlyOptions

傳回

Promise<SetReadOnlyResponse>

updateSyncToken(string)

新增外部同步處理權杖，以確保服務要求接收最新的值。

function updateSyncToken(syncToken: string)

參數

syncToken

string

同步處理權杖值。