az appconfig snapshot

アプリ構成ストアに関連付けられているスナップショットを管理します。

コマンド

名前	説明	型	状態
az appconfig snapshot archive	スナップショットをアーカイブします。	Core	GA
az appconfig snapshot create	アプリ構成スナップショットを作成します。	Core	GA
az appconfig snapshot list	List snapshots.	Core	GA
az appconfig snapshot recover	アーカイブされたスナップショットを回復します。	Core	GA
az appconfig snapshot show	アプリ構成スナップショットのすべての属性を表示します。	Core	GA

az appconfig snapshot archive

スナップショットをアーカイブします。

az appconfig snapshot archive --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

例

構成ストア MyAppConfiguration のアーカイブ スナップショット MySnapshot。

az appconfig snapshot archive -s MySnapshot -n MyAppConfiguration

必須のパラメーター

--snapshot-name -s

アプリ構成スナップショットの名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auth-mode

このパラメーターは、データ操作を承認する方法を示すために使用できます。 認証モードが "キー" の場合は、接続文字列またはストア名を指定すると、承認のためにアカウント アクセス キーが取得されます。 認証モードが "login" の場合は、--endpoint または --name を指定します。"az login" 資格情報が承認に使用されます。 az configure --defaults appconfig_auth_mode=<auth_mode>を使用して、既定の認証モードを構成できます。 詳細については、https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbacを参照してください。

プロパティ	値
規定値:	key
指定可能な値:	key, login

--connection-string

App Configuration ストアのアクセス キーとエンドポイントの組み合わせ。 'az appconfig credential list' を使用して見つけることができます。 ユーザーは、az configure --defaults appconfig_connection_string=<connection_string> または環境変数を使用して、AZURE_APPCONFIG_CONNECTION_STRINGという名前で事前設定できます。

--endpoint

認証モードが "login" の場合は、App Configuration ストアのエンドポイント URL を指定します。 エンドポイントは、"az appconfig show" コマンドを使用して取得できます。 az configure --defaults appconfig_endpoint=<endpoint>を使用して既定のエンドポイントを構成できます。

--name -n

App Configuration ストアの名前。 az configure --defaults app_configuration_store=<name>を使用して既定の名前を構成できます。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az appconfig snapshot create

アプリ構成スナップショットを作成します。

az appconfig snapshot create --filters
                             --snapshot-name
                             [--auth-mode {key, login}]
                             [--composition-type {key, key_label}]
                             [--connection-string]
                             [--endpoint]
                             [--name]
                             [--retention-period]
                             [--tags]

例

構成ストア MyAppConfiguration で 'Test' で始まるすべてのキーのスナップショット MySnapshot を作成します。

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"Test*\"}'

'abc' で始まり、保持期間が 1 時間であるすべてのキーのスナップショット MySnapshot を作成します。

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"abc*\"}' --retention-period 3600

"app/" で始まり、ラベルが既定で指定されていないすべてのキーのスナップショットを作成し、キー値が存在する場合は、キーの値を "prod" というラベルでオーバーライドします。

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"app/*\"}' '{\"key\":\"app/*\", \"label\":\"prod\"}' --composition-type 'key'

'Test' で始まるすべてのキーのスナップショットを作成し、タグ 'tag1=value1' と 'tag2=value2' を持ちます。

az appconfig snapshot create -s MySnapshot -n MyAppConfiguration --filters '{\"key\":\"Test*\", \"tags\":[\"tag1=value1\", \"tag2=value2\"]}'

必須のパラメーター

--filters

App Configuration スナップショットの作成に使用されるキー、ラベル、タグ フィルターを表すエスケープされた JSON オブジェクトのスペース区切りの一覧。

--snapshot-name -s

アプリ構成スナップショットの名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auth-mode

このパラメーターは、データ操作を承認する方法を示すために使用できます。 認証モードが "キー" の場合は、接続文字列またはストア名を指定すると、承認のためにアカウント アクセス キーが取得されます。 認証モードが "login" の場合は、--endpoint または --name を指定します。"az login" 資格情報が承認に使用されます。 az configure --defaults appconfig_auth_mode=<auth_mode>を使用して、既定の認証モードを構成できます。 詳細については、https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbacを参照してください。

プロパティ	値
規定値:	key
指定可能な値:	key, login

--composition-type

App Configuration スナップショットの構築に使用されるコンポジションの種類。 指定しない場合、既定値は key です。

プロパティ	値
指定可能な値:	key, key_label

--connection-string

App Configuration ストアのアクセス キーとエンドポイントの組み合わせ。 'az appconfig credential list' を使用して見つけることができます。 ユーザーは、az configure --defaults appconfig_connection_string=<connection_string> または環境変数を使用して、AZURE_APPCONFIG_CONNECTION_STRINGという名前で事前設定できます。

--endpoint

認証モードが "login" の場合は、App Configuration ストアのエンドポイント URL を指定します。 エンドポイントは、"az appconfig show" コマンドを使用して取得できます。 az configure --defaults appconfig_endpoint=<endpoint>を使用して既定のエンドポイントを構成できます。

--name -n

App Configuration ストアの名前。 az configure --defaults app_configuration_store=<name>を使用して既定の名前を構成できます。

--retention-period

有効期限が切れる前にスナップショットをアーカイブできる期間 (秒単位)。 スナップショットは、Free 層と開発者層のストアでは最大 7 日間 (604,800 秒)、Standard 層と Premium 層のストアでは 90 日間 (7,776,000 秒) アーカイブできます。 指定する場合、保持期間は少なくとも 1 時間 (3600 秒) である必要があります。

--tags

スペース区切りのタグ: key[=value] [key[=value] ...]

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az appconfig snapshot list

List snapshots.

az appconfig snapshot list [--all]
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]
                           [--snapshot-name]
                           [--status {archived, failed, provisioning, ready}]
                           [--top]

例

プレフィックス 'abc' で始まる名前を持つすべてのスナップショットを一覧表示します。

az appconfig snapshot list -s abc* -n MyAppConfiguration

アーカイブされたすべてのスナップショットを一覧表示します。

az appconfig snapshot list --status archived -n MyAppConfiguration

プレフィックス 'app' で始まる名前を持つすべてのプロビジョニング スナップショットを一覧表示します。

az appconfig snapshot list -s app* --status provisioning -n MyAppConfiguration

失敗したすべてのスナップショットとプロビジョニング スナップショットを一覧表示します。

az appconfig snapshot list --status failed provisioning -n MyAppConfiguration

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--all

すべてのアイテムを一覧表示します。

--auth-mode

このパラメーターは、データ操作を承認する方法を示すために使用できます。 認証モードが "キー" の場合は、接続文字列またはストア名を指定すると、承認のためにアカウント アクセス キーが取得されます。 認証モードが "login" の場合は、--endpoint または --name を指定します。"az login" 資格情報が承認に使用されます。 az configure --defaults appconfig_auth_mode=<auth_mode>を使用して、既定の認証モードを構成できます。 詳細については、https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbacを参照してください。

プロパティ	値
規定値:	key
指定可能な値:	key, login

--connection-string

App Configuration ストアのアクセス キーとエンドポイントの組み合わせ。 'az appconfig credential list' を使用して見つけることができます。 ユーザーは、az configure --defaults appconfig_connection_string=<connection_string> または環境変数を使用して、AZURE_APPCONFIG_CONNECTION_STRINGという名前で事前設定できます。

--endpoint

認証モードが "login" の場合は、App Configuration ストアのエンドポイント URL を指定します。 エンドポイントは、"az appconfig show" コマンドを使用して取得できます。 az configure --defaults appconfig_endpoint=<endpoint>を使用して既定のエンドポイントを構成できます。

--fields

スナップショットの出力フィールドをカスタマイズします。

プロパティ	値
指定可能な値:	composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags

--name -n

App Configuration ストアの名前。 az configure --defaults app_configuration_store=<name>を使用して既定の名前を構成できます。

--snapshot-name -s

名前が指定されていない場合は、既定ですべてのスナップショットを返します。 たとえば abc* のように、フィルターとしての星印のサポートは、名前のプレフィックスとして abc を持つスナップショットを意味します。

プロパティ	値
規定値:	*

--status

スナップショットを状態でフィルター処理します。 状態が指定されていない場合は、既定ですべてのスナップショットを返します。

プロパティ	値
指定可能な値:	archived, failed, provisioning, ready

--top -t

返されるアイテムの最大数。 正の整数にする必要があります。 既定値は 100 です。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az appconfig snapshot recover

アーカイブされたスナップショットを回復します。

az appconfig snapshot recover --snapshot-name
                              [--auth-mode {key, login}]
                              [--connection-string]
                              [--endpoint]
                              [--name]

例

構成ストア MyAppConfiguration でスナップショット MySnapshot を回復します。

az appconfig snapshot recover -s MySnapshot -n MyAppConfiguration

必須のパラメーター

--snapshot-name -s

アプリ構成スナップショットの名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auth-mode

このパラメーターは、データ操作を承認する方法を示すために使用できます。 認証モードが "キー" の場合は、接続文字列またはストア名を指定すると、承認のためにアカウント アクセス キーが取得されます。 認証モードが "login" の場合は、--endpoint または --name を指定します。"az login" 資格情報が承認に使用されます。 az configure --defaults appconfig_auth_mode=<auth_mode>を使用して、既定の認証モードを構成できます。 詳細については、https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbacを参照してください。

プロパティ	値
規定値:	key
指定可能な値:	key, login

--connection-string

App Configuration ストアのアクセス キーとエンドポイントの組み合わせ。 'az appconfig credential list' を使用して見つけることができます。 ユーザーは、az configure --defaults appconfig_connection_string=<connection_string> または環境変数を使用して、AZURE_APPCONFIG_CONNECTION_STRINGという名前で事前設定できます。

--endpoint

認証モードが "login" の場合は、App Configuration ストアのエンドポイント URL を指定します。 エンドポイントは、"az appconfig show" コマンドを使用して取得できます。 az configure --defaults appconfig_endpoint=<endpoint>を使用して既定のエンドポイントを構成できます。

--name -n

App Configuration ストアの名前。 az configure --defaults app_configuration_store=<name>を使用して既定の名前を構成できます。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False

az appconfig snapshot show

アプリ構成スナップショットのすべての属性を表示します。

az appconfig snapshot show --snapshot-name
                           [--auth-mode {key, login}]
                           [--connection-string]
                           [--endpoint]
                           [--fields {composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags}]
                           [--name]

例

構成ストア MyAppConfiguration に MySnapshot という名前のアプリ構成スナップショットを表示します。

az appconfig snapshot show -s MySnapshot -n MyAppConfiguration

必須のパラメーター

--snapshot-name -s

アプリ構成スナップショットの名前。

省略可能のパラメーター

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auth-mode

このパラメーターは、データ操作を承認する方法を示すために使用できます。 認証モードが "キー" の場合は、接続文字列またはストア名を指定すると、承認のためにアカウント アクセス キーが取得されます。 認証モードが "login" の場合は、--endpoint または --name を指定します。"az login" 資格情報が承認に使用されます。 az configure --defaults appconfig_auth_mode=<auth_mode>を使用して、既定の認証モードを構成できます。 詳細については、https://learn.microsoft.com/azure/azure-app-configuration/concept-enable-rbacを参照してください。

プロパティ	値
規定値:	key
指定可能な値:	key, login

--connection-string

App Configuration ストアのアクセス キーとエンドポイントの組み合わせ。 'az appconfig credential list' を使用して見つけることができます。 ユーザーは、az configure --defaults appconfig_connection_string=<connection_string> または環境変数を使用して、AZURE_APPCONFIG_CONNECTION_STRINGという名前で事前設定できます。

--endpoint

認証モードが "login" の場合は、App Configuration ストアのエンドポイント URL を指定します。 エンドポイントは、"az appconfig show" コマンドを使用して取得できます。 az configure --defaults appconfig_endpoint=<endpoint>を使用して既定のエンドポイントを構成できます。

--fields

スナップショットの出力フィールドをカスタマイズします。

プロパティ	値
指定可能な値:	composition_type, created, etag, expires, filters, items_count, name, retention_period, size, status, tags

--name -n

App Configuration ストアの名前。 az configure --defaults app_configuration_store=<name>を使用して既定の名前を構成できます。

グローバル パラメーター

--debug

ログの詳細度を上げて、すべてのデバッグ ログを表示します。

プロパティ	値
規定値:	False

--help -h

このヘルプ メッセージを表示して終了します。

--only-show-errors

エラーのみを表示し、警告を抑制します。

プロパティ	値
規定値:	False

--output -o

Output format.

プロパティ	値
規定値:	json
指定可能な値:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ を参照してください。

--subscription

サブスクリプションの名前または ID。 az account set -s NAME_OR_IDを使用して既定のサブスクリプションを構成できます。

--verbose

ログの詳細度を高める。 完全なデバッグ ログには --debug を使用します。

プロパティ	値
規定値:	False