次の方法で共有

az apic metadata

  • リファレンス

Note

このリファレンスは、Azure CLI (バージョン 2.57.0 以降) の apic-extension 拡張機能の一部です。 拡張機能は、az apic metadata コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

API Center でメタデータ スキーマを管理するコマンド。

コマンド

名前 説明 型 Status
az apic metadata create

新しいメタデータ スキーマを作成するか、既存のメタデータ スキーマを更新します。

 拡張子 GA
az apic metadata delete

指定したメタデータ スキーマを削除します。

 拡張子 GA
az apic metadata export

メタデータ スキーマをエクスポートします。

 拡張子 GA
az apic metadata list

メタデータ スキーマのコレクションを一覧表示します。

 拡張子 GA
az apic metadata show

メタデータ スキーマの詳細を取得します。

 拡張子 GA
az apic metadata update

既存のメタデータ スキーマを更新します。

 拡張子 GA

az apic metadata create

新しいメタデータ スキーマを作成するか、既存のメタデータ スキーマを更新します。

az apic metadata create --assignments
                        --metadata-schema
                        --resource-group
                        --schema
                        --service
                        [--file-name]

例

メタデータの作成の例 1

az apic metadata create --resource-group api-center-test --service-name contoso --name "test1" --schema '{"type":"string", "title":"First name", "pattern": "^[a-zA-Z0-9]+$"}' --assignments '[{entity:api,required:true,deprecated:false}]'

メタデータの作成の例 2

az apic metadata create --resource-group api-center-test --service-name contoso  --name testregion --schema '{"type":"string","title":"testregion","oneOf":[{"const":"Region1","description":""},{"const":"Region2","description":""},{"const":"Region3","description":""}]}' --assignments '[{entity:api,required:true,deprecated:false},{entity:environment,required:true,deprecated:false}]'

必須のパラメーター

--assignments

カスタム メタデータの割り当てスコープを定義します (例: "[{entity:api,required:true,deprecated:false}]")。 使用可能なエンティティ値は、api、deployment、environment です。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--metadata-schema --metadata-schema-name --name

メタデータ スキーマの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--schema

型を定義する JSON スキーマ。

--service --service-name -s

API センター サービスの名前。

省略可能のパラメーター

--file-name

メタデータ スキーマを含むファイルの名前。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az apic metadata delete

指定したメタデータ スキーマを削除します。

az apic metadata delete [--ids]
                        [--metadata-schema]
                        [--resource-group]
                        [--service]
                        [--subscription]
                        [--yes]

例

メタデータ スキーマの削除

az apic metadata delete --resource-group api-center-test --service-name contoso --name "test1"

スキーマの削除

az apic metadata delete -g api-center-test -s contosoeuap --name "approver"

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--metadata-schema --metadata-schema-name --name

メタデータ スキーマの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service --service-name -s

API センター サービスの名前。

--subscription

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

--yes -y

確認のダイアログを表示しません。

既定値: False
グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az apic metadata export

メタデータ スキーマをエクスポートします。

az apic metadata export --assignments {api, deployment, environment}
                        --file-name
                        [--ids]
                        [--name]
                        [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                        [--resource-group]
                        [--subscription]

例

API に割り当てられたメタデータ スキーマのエクスポート

az apic metadata export -g api-center-test -s contosoeuap --assignments api --file-name filename.json

デプロイに割り当てられたメタデータ スキーマのエクスポート

az apic metadata export -g api-center-test -s contosoeuap --assignments deployment --file-name filename.json

環境に割り当てられたメタデータ スキーマをエクスポートする

az apic metadata export -g api-center-test -s contosoeuap --assignments environment --file-name filename.json

必須のパラメーター

--assignments

メタデータ スキーマが要求されるエンティティ。

承認された値: api, deployment, environment
--file-name

メタデータ スキーマのエクスポート先となるファイルの名前。

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--name --service --service-name -s

API センター サービスの名前。

--no-wait

実行時間の長い操作の終了を待機しません。

承認された値: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--subscription

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

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az apic metadata list

メタデータ スキーマのコレクションを一覧表示します。

az apic metadata list --resource-group
                      --service
                      [--filter]
                      [--max-items]
                      [--next-token]

例

スキーマを一覧表示する

az apic metadata list -g api-center-test -s contosoeuap

必須のパラメーター

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service --service-name -s

API センター サービスの名前。

省略可能のパラメーター

--filter

OData フィルター パラメーター。

--max-items

コマンドの出力で返される項目の合計数。 使用可能な項目の合計数が指定された値を超える場合は、コマンドの出力にトークンが提供されます。 改ページ位置の変更を再開するには、後続のコマンドの引数に --next-token トークン値を指定します。

--next-token

ページ分割を開始する場所を指定するトークン。 これは、以前に切り捨てられた応答からのトークン値です。

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az apic metadata show

メタデータ スキーマの詳細を取得します。

az apic metadata show [--ids]
                      [--metadata-schema]
                      [--resource-group]
                      [--service]
                      [--subscription]

例

スキーマの詳細を表示する 1

az apic metadata show -g api-center-test -s contosoeuap --name approver

スキーマの詳細を表示する 2

az apic metadata show --resource-group api-center-test --service-name contoso --name "testchoices"

省略可能のパラメーター

--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--metadata-schema --metadata-schema-name --name

メタデータ スキーマの名前。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--service --service-name -s

API センター サービスの名前。

--subscription

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

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。

az apic metadata update

既存のメタデータ スキーマを更新します。

az apic metadata update [--add]
                        [--assignments]
                        [--file-name]
                        [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                        [--ids]
                        [--metadata-schema]
                        [--remove]
                        [--resource-group]
                        [--schema]
                        [--service]
                        [--set]
                        [--subscription]

例

スキーマを更新する

az apic metadata update --resource-group api-center-test --service-name contoso --name "test1" --schema '{"type":"string", "title":"Last name", "pattern": "^[a-zA-Z0-9]+$"}'

省略可能のパラメーター

--add

パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value、string、または JSON 文字列>。

--assignments

カスタム メタデータの割り当てスコープを定義します (例: "[{entity:api,required:true,deprecated:false}]")。 使用可能なエンティティ値は、api、deployment、environment です。 短縮構文、json-file、yaml-file をサポートします。 詳細を表示するには、"??" を試してください。

--file-name

メタデータ スキーマを含むファイルの名前。

--force-string

'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。

承認された値: 0, 1, f, false, n, no, t, true, y, yes
--ids

1 つまたは複数のリソース ID (スペース区切り)。 これは、'Resource Id' 引数のすべての情報を含む完全なリソース ID である必要があります。 --ids または他の 'Resource Id' 引数を指定する必要があります。

--metadata-schema --metadata-schema-name --name

メタデータ スキーマの名前。

--remove

リストからプロパティまたは要素を削除します。 例: --remove property.list OR --remove propertyToRemove。

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name> を使用して、既定のグループを構成できます。

--schema

型を定義する YAML スキーマ。

--service --service-name -s

API センター サービスの名前。

--set

設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=。

--subscription

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

グローバル パラメーター
--debug

すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。

--help -h

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

--only-show-errors

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

--output -o

出力形式。

承認された値: json, jsonc, none, table, tsv, yaml, yamlc
既定値: json
--query

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

--subscription

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

--verbose

ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。