az apim api
Azure API Management API を管理します。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az apim api create |
API Management API を作成します。 |
コア | GA |
az apim api delete |
API Management API を削除します。 |
コア | GA |
az apim api export |
API Management API をエクスポートします。 |
コア | GA |
az apim api import |
API Management API をインポートします。 |
コア | GA |
az apim api list |
API Management API を一覧表示します。 |
コア | GA |
az apim api operation |
Azure API Management API 操作を管理します。 |
コア | GA |
az apim api operation create |
API で新しい操作を作成します。 |
コア | GA |
az apim api operation delete |
API の指定された操作を削除します。 |
コア | GA |
az apim api operation list |
指定した API の操作のコレクションを一覧表示します。 |
コア | GA |
az apim api operation show |
識別子で指定された API 操作の詳細を取得します。 |
コア | GA |
az apim api operation update |
識別子で指定された API の操作の詳細を更新します。 |
コア | GA |
az apim api release |
Azure API Management API リリースを管理します。 |
コア | GA |
az apim api release create |
API の新しいリリースを作成します。 |
コア | GA |
az apim api release delete |
API で指定したリリースを削除します。 |
コア | GA |
az apim api release list |
API のすべてのリリースを一覧表示します。 |
コア | GA |
az apim api release show |
API リリースの詳細を返します。 |
コア | GA |
az apim api release update |
識別子で指定された API のリリースの詳細を更新します。 |
コア | GA |
az apim api revision |
Azure API Management API リビジョンを管理します。 |
コア | GA |
az apim api revision create |
API リビジョンを作成します。 |
コア | GA |
az apim api revision list |
API のすべてのリビジョンを一覧表示します。 |
コア | GA |
az apim api schema |
Azure API Management API スキーマを管理します。 |
コア | GA |
az apim api schema create |
API Management API スキーマを作成します。 |
コア | GA |
az apim api schema delete |
API Management API スキーマを削除します。 |
コア | GA |
az apim api schema get-etag |
API Management API スキーマの etag を取得します。 |
コア | GA |
az apim api schema list |
API Management API スキーマを一覧表示します。 |
コア | GA |
az apim api schema show |
API Management API スキーマの詳細を表示します。 |
コア | GA |
az apim api schema wait |
apim api スキーマの条件が満たされるまで、CLI を待機状態にします。 |
コア | GA |
az apim api show |
API Management API の詳細を表示します。 |
コア | GA |
az apim api update |
API Management API を更新します。 |
コア | GA |
az apim api versionset |
Azure API Management API バージョン セットを管理します。 |
コア | GA |
az apim api versionset create |
API バージョン セットを作成します。 |
コア | GA |
az apim api versionset delete |
特定の API バージョン セットを削除します。 |
コア | GA |
az apim api versionset list |
指定されたサービス インスタンスにおける API バージョン セットのコレクションを一覧表示します。 |
コア | GA |
az apim api versionset show |
識別子で指定された API バージョン セットの詳細を取得します。 |
コア | GA |
az apim api versionset update |
識別子で指定された Api VersionSet の詳細を更新します。 |
コア | GA |
az apim api wait |
apim API の条件が満たされるまで、CLI を待機状態にします。 |
コア | GA |
az apim api create
API Management API を作成します。
az apim api create --api-id
--display-name
--path
--resource-group
--service-name
[--api-type {graphql, http, soap, websocket}]
[--authorization-scope]
[--authorization-server-id]
[--bearer-token-sending-methods]
[--description]
[--no-wait]
[--open-id-provider-id]
[--protocols {http, https, ws, wss}]
[--service-url]
[--subscription-key-header-name]
[--subscription-key-query-param-name]
[--subscription-key-required]
[--subscription-required {false, true}]
例
基本的な API を作成します。
az apim api create --service-name MyApim -g MyResourceGroup --api-id MyApi --path '/myapi' --display-name 'My API'
必須のパラメーター
作成する API の一意の名前。
API リビジョン識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。
作成する API の表示名。
API へのパス。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
API Management サービス インスタンスの名前。
省略可能のパラメーター
API の型。
OAuth 操作スコープを指定します。
OAuth 承認サーバー ID を指定します。
ベアラー トークンの送信メソッドを指定します。
API の説明。 HTML 書式設定タグを含めることができます。
実行時間の長い操作の終了を待機しません。
認証設定の openid を指定します。
この API の操作を呼び出すことができるプロトコルを記述します。
この API を実装するバックエンド サービスの絶対 URL。 2,000 文字を超えることはできません。
サブスクリプション キーのヘッダー名を指定します。
サブスクリプション キークエリ文字列パラメーター名を指定します。
この API の呼び出し中にサブスクリプション キーが必要かどうかを指定します。true - API は閉じた製品にのみ含まれます。false - API はオープン製品のみに含まれます。null - 製品が混在しています。
true の場合、API には要求時にサブスクリプション キーが必要です。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az apim api delete
API Management API を削除します。
az apim api delete --api-id
--resource-group
--service-name
[--delete-revisions]
[--if-match]
[--no-wait]
[--yes]
必須のパラメーター
API 識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
API Management サービス インスタンスの名前。
省略可能のパラメーター
API のすべてのリビジョンを削除します。
エンティティの ETag。
実行時間の長い操作の終了を待機しません。
確認のダイアログを表示しません。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az apim api export
API Management API をエクスポートします。
az apim api export --api-id
--ef {OpenApiJsonFile, OpenApiJsonUrl, OpenApiYamlFile, OpenApiYamlUrl, SwaggerFile, SwaggerUrl, WadlFile, WadlUrl, WsdlFile, WsdlUrl}
--resource-group
--service-name
[--file-path]
例
API Management API をファイルにエクスポートするか、エクスポートのリンクを含む応答を返します。
az apim api export -g MyResourceGroup --service-name MyApim --api-id MyApi --export-format OpenApiJson --file-path path
必須のパラメーター
API 識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。 正規表現パターン: ^[^*#>:<>?]+$.
エクスポート API の形式を指定します。
リソース グループの名前。 名前の大文字と小文字は区別されます。
API Management サービス インスタンスの名前。
省略可能のパラメーター
API をエクスポートするために指定されたファイル パス。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az apim api import
API Management API をインポートします。
az apim api import --path
--resource-group
--service-name
--specification-format {GraphQL, OpenApi, OpenApiJson, Swagger, Wadl, Wsdl}
[--api-id]
[--api-revision]
[--api-type {graphql, http, soap, websocket}]
[--api-version]
[--api-version-set-id]
[--description]
[--display-name]
[--no-wait]
[--protocols {http, https, ws, wss}]
[--service-url]
[--soap-api-type]
[--specification-path]
[--specification-url]
[--subscription-key-header-name]
[--subscription-key-query-param-name]
[--subscription-required {false, true}]
[--wsdl-endpoint-name]
[--wsdl-service-name]
例
ファイルまたは URL から API Management API をインポートする
az apim api import -g MyResourceGroup --service-name MyApim --path MyApi --specification-url https://MySpecificationURL --specification-format OpenApiJson
必須のパラメーター
必須。 API Management サービス インスタンス内のこの API とそのすべてのリソース パスを一意に識別する相対 URL。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
API Management サービス インスタンスの名前。
インポートした API の形式を指定します。
省略可能のパラメーター
API 識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。
API のリビジョンについて説明します。 値が指定されていない場合は、既定のリビジョン 1 が作成されます。
API の型。
API のバージョンについて説明します。 バージョン管理されていない API にバージョンを追加すると、元のバージョンが自動的に作成され、既定の URL に応答します。
API で使用するバージョン セットについて説明します。
API の説明。 HTML 書式設定タグを含めることができます。
この API の表示名。
実行時間の長い操作の終了を待機しません。
この API の操作を呼び出すことができるプロトコル (1 つ以上) について説明します。
この API を実装するバックエンド サービスの絶対 URL。 2,000 文字を超えることはできません。
ファイル形式が WSDL の場合の API の種類。
API をインポートするために指定されたファイル パス。
API をインポートするために指定された URL。
サブスクリプション キーのヘッダー名を指定します。
サブスクリプション キークエリ文字列パラメーター名を指定します。
true の場合、API には要求時にサブスクリプション キーが必要です。
インポートする WSDL エンドポイント (ポート) のローカル名。
インポートする WSDL サービスのローカル名。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az apim api list
API Management API を一覧表示します。
az apim api list --resource-group
--service-name
[--filter-display-name]
[--skip]
[--top]
必須のパラメーター
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
API Management サービス インスタンスの名前。
省略可能のパラメーター
displayName による API のフィルター処理。
スキップするレコードの数。
返されるレコードの数。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az apim api show
API Management API の詳細を表示します。
az apim api show --api-id
--resource-group
--service-name
必須のパラメーター
API 識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
API Management サービス インスタンスの名前。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az apim api update
API Management API を更新します。
az apim api update --api-id
--resource-group
--service-name
[--add]
[--api-type {graphql, http, soap, websocket}]
[--description]
[--display-name]
[--force-string]
[--if-match]
[--no-wait]
[--path]
[--protocols {http, https, ws, wss}]
[--remove]
[--service-url]
[--set]
[--subscription-key-header-name]
[--subscription-key-query-param-name]
[--subscription-required {false, true}]
[--tags]
例
基本的な API を作成します。
az apim api update --service-name MyApim -g MyResourceGroup --api-id MyApi --description foo
必須のパラメーター
作成する API の一意の名前。
API リビジョン識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
API Management サービス インスタンスの名前。
省略可能のパラメーター
パスとキー値のペアを指定して、オブジェクトの一覧にオブジェクトを追加します。 例: --add property.listProperty <key=value, string or JSON string>
。
API の型。
API の説明。 HTML 書式設定タグを含めることができます。
API 名。 長さは 1 ~ 300 文字にする必要があります。
'set' または 'add' を使用する場合は、JSON に変換するのではなく、文字列リテラルを保持します。
エンティティの ETag。 エンティティを作成する場合は必要ありませんが、エンティティを更新する場合は必須です。 既定値は None です。
実行時間の長い操作の終了を待機しません。
必須。 API Management サービス インスタンス内のこの API とそのすべてのリソース パスを一意に識別する相対 URL。
この API の操作を呼び出すことができるプロトコルを記述します。
リストからプロパティまたは要素を削除します。 例: --remove property.list <indexToRemove>
OR --remove propertyToRemove
.
この API を実装するバックエンド サービスの絶対 URL。 2,000 文字を超えることはできません。
設定するプロパティ パスと値を指定して、オブジェクトを更新します。 例: --set property1.property2=<value>
。
サブスクリプション キーのヘッダー名を指定します。
サブスクリプション キークエリ文字列パラメーター名を指定します。
true の場合、API には要求時にサブスクリプション キーが必要です。
スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az apim api wait
apim API の条件が満たされるまで、CLI を待機状態にします。
az apim api wait --api-id
--name
--resource-group
[--created]
[--custom]
[--deleted]
[--exists]
[--interval]
[--timeout]
[--updated]
例
apim API の条件が満たされるまで、CLI を待機状態にします。 (自動生成)
az apim api wait --created --api-id MyApi --name MyApim --resource-group MyResourceGroup
必須のパラメーター
API リビジョン識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。 必須。
API Management サービス インスタンスの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
'provisioningState' が 'Succeeded' で作成されるまで待ちます。
条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。
削除されるまで待ちます。
リソースが存在するまで待ちます。
ポーリング間隔 (秒単位)。
最大待機時間 (秒単位)。
provisioningState が 'Succeeded' で更新されるまで待ちます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
Azure CLI