次の方法で共有


az apim api

Azure API Management API を管理します。

コマンド

名前 説明 状態
az apim api create

API Management API を作成します。

Core GA
az apim api delete

API Management API を削除します。

Core GA
az apim api export

API Management API をエクスポートします。

Core GA
az apim api import

API Management API をインポートします。

Core GA
az apim api list

API Management API を一覧表示します。

Core GA
az apim api operation

Azure API Management API 操作を管理します。

Core GA
az apim api operation create

API で新しい操作を作成します。

Core GA
az apim api operation delete

API で指定された操作を削除します。

Core GA
az apim api operation list

指定した API の操作のコレクションを一覧表示します。

Core GA
az apim api operation show

識別子で指定された API 操作の詳細を取得します。

Core GA
az apim api operation update

識別子で指定された API の操作の詳細を更新します。

Core GA
az apim api release

Azure API Management API リリースを管理します。

Core GA
az apim api release create

API の新しいリリースを作成します。

Core GA
az apim api release delete

API で指定したリリースを削除します。

Core GA
az apim api release list

API のすべてのリリースを一覧表示します。

Core GA
az apim api release show

API リリースの詳細を返します。

Core GA
az apim api release update

識別子で指定された API のリリースの詳細を更新します。

Core GA
az apim api revision

Azure API Management API リビジョンを管理します。

Core GA
az apim api revision create

API リビジョンを作成します。

Core GA
az apim api revision list

API のすべてのリビジョンを一覧表示します。

Core GA
az apim api schema

Azure API Management API スキーマを管理します。

Core GA
az apim api schema create

API Management API スキーマを作成します。

Core GA
az apim api schema delete

API Management API スキーマを削除します。

Core GA
az apim api schema get-etag

API Management API スキーマの etag を取得します。

Core GA
az apim api schema list

API Management API スキーマを一覧表示します。

Core GA
az apim api schema show

API Management API スキーマの詳細を表示します。

Core GA
az apim api schema wait

apim api スキーマの条件が満たされるまで、CLI を待機状態にします。

Core GA
az apim api show

API Management API の詳細を表示します。

Core GA
az apim api update

API Management API を更新します。

Core GA
az apim api versionset

Azure API Management API バージョン セットを管理します。

Core GA
az apim api versionset create

API バージョン セットを作成します。

Core GA
az apim api versionset delete

特定の API バージョン セットを削除します。

Core GA
az apim api versionset list

指定したサービス インスタンス内の API バージョン セットのコレクションを一覧表示します。

Core GA
az apim api versionset show

識別子で指定された API バージョン セットの詳細を取得します。

Core GA
az apim api versionset update

識別子で指定された Api VersionSet の詳細を更新します。

Core GA
az apim api wait

apim API の条件が満たされるまで、CLI を待機状態にします。

Core 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-id

作成する API の一意の名前。

API リビジョン識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。

プロパティ
Parameter group: API Arguments
--display-name

作成する API の表示名。

プロパティ
Parameter group: API Arguments
--path

API へのパス。

プロパティ
Parameter group: API Arguments
--resource-group -g

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

--service-name -n

API Management サービス インスタンスの名前。

省略可能のパラメーター

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

--api-type

API の型。

プロパティ
Parameter group: API Arguments
指定可能な値: graphql, http, soap, websocket
--authorization-scope

OAuth 操作スコープを指定します。

--authorization-server-id

OAuth 承認サーバー ID を指定します。

--bearer-token-sending-methods

ベアラー トークンの送信メソッドを指定します。

--description

API の説明。 HTML 書式設定タグを含めることができます。

プロパティ
Parameter group: API Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--open-id-provider-id

認証設定の openid を指定します。

--protocols

この API の操作を呼び出すことができるプロトコルについて説明します。

プロパティ
Parameter group: API Arguments
指定可能な値: http, https, ws, wss
--service-url

この API を実装するバックエンド サービスの絶対 URL。 2,000 文字を超えることはできません。

プロパティ
Parameter group: API Arguments
--subscription-key-header-name

サブスクリプション キーのヘッダー名を指定します。

プロパティ
Parameter group: API Arguments
--subscription-key-query-param-name

サブスクリプション キークエリ文字列パラメーター名を指定します。

プロパティ
Parameter group: API Arguments
--subscription-key-required

この API の呼び出し中にサブスクリプション キーが必要かどうかを指定します。true - API は閉じた製品にのみ含まれます。false - API はオープン製品のみに含まれます。null - 製品が混在しています。

--subscription-required

true の場合、API には要求時にサブスクリプション キーが必要です。

プロパティ
Parameter group: API Arguments
規定値: False
指定可能な値: false, true
グローバル パラメーター
--debug

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

プロパティ
規定値: False
--help -h

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

--only-show-errors

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

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: 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 apim api delete

API Management API を削除します。

az apim api delete --api-id
                   --resource-group
                   --service-name
                   [--delete-revisions]
                   [--if-match]
                   [--no-wait]
                   [--yes]

必須のパラメーター

--api-id

API 識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。

プロパティ
Parameter group: API Arguments
--resource-group -g

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

--service-name -n

API Management サービス インスタンスの名前。

省略可能のパラメーター

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

--delete-revisions

API のすべてのリビジョンを削除します。

--if-match

エンティティの ETag。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--yes -y

確認を求めないでください。

プロパティ
規定値: False
グローバル パラメーター
--debug

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

プロパティ
規定値: False
--help -h

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

--only-show-errors

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

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: 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 apim api export

API Management API をエクスポートします。

az apim api export --api-id
                   --ef --export-format {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-id

API 識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。 正規表現パターン: ^[^*#&+:<>?]+$.

プロパティ
Parameter group: API Arguments
--ef --export-format

エクスポート API の形式を指定します。

プロパティ
指定可能な値: OpenApiJsonFile, OpenApiJsonUrl, OpenApiYamlFile, OpenApiYamlUrl, SwaggerFile, SwaggerUrl, WadlFile, WadlUrl, WsdlFile, WsdlUrl
--resource-group -g

リソース グループの名前。 名前では大文字と小文字が区別されません。

--service-name -n

API Management サービス インスタンスの名前。

省略可能のパラメーター

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

--file-path -f

API をエクスポートするために指定されたファイル パス。

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

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

プロパティ
規定値: False
--help -h

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

--only-show-errors

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

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: 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 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

必須のパラメーター

--path

Required. この API と API Management サービス インスタンス内のすべてのリソース パスを一意に識別する相対 URL。

プロパティ
Parameter group: API Arguments
--resource-group -g

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

--service-name -n

API Management サービス インスタンスの名前。

--specification-format

インポートした API の形式を指定します。

プロパティ
指定可能な値: GraphQL, OpenApi, OpenApiJson, Swagger, Wadl, Wsdl

省略可能のパラメーター

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

--api-id

API 識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。

プロパティ
Parameter group: API Arguments
--api-revision

API のリビジョンについて説明します。 値が指定されていない場合は、既定のリビジョン 1 が作成されます。

プロパティ
Parameter group: API Arguments
--api-type

API の型。

プロパティ
Parameter group: API Arguments
指定可能な値: graphql, http, soap, websocket
--api-version

API のバージョンについて説明します。 バージョン管理されていない API にバージョンを追加すると、元のバージョンが自動的に作成され、既定の URL に応答します。

プロパティ
Parameter group: API Arguments
--api-version-set-id

API で使用するバージョン セットについて説明します。

プロパティ
Parameter group: API Arguments
--description

API の説明。 HTML 書式設定タグを含めることができます。

プロパティ
Parameter group: API Arguments
--display-name

この API の表示名。

プロパティ
Parameter group: API Arguments
--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--protocols

この API の操作を呼び出すことができるプロトコル (1 つ以上) について説明します。

プロパティ
Parameter group: API Arguments
指定可能な値: http, https, ws, wss
--service-url

この API を実装するバックエンド サービスの絶対 URL。 2,000 文字を超えることはできません。

プロパティ
Parameter group: API Arguments
--soap-api-type

ファイル形式が WSDL の場合の API の種類。

--specification-path

API をインポートするために指定されたファイル パス。

--specification-url

API をインポートするために指定された URL。

--subscription-key-header-name

サブスクリプション キーのヘッダー名を指定します。

プロパティ
Parameter group: API Arguments
--subscription-key-query-param-name

サブスクリプション キークエリ文字列パラメーター名を指定します。

プロパティ
Parameter group: API Arguments
--subscription-required

true の場合、API には要求時にサブスクリプション キーが必要です。

プロパティ
Parameter group: API Arguments
指定可能な値: false, true
--wsdl-endpoint-name

インポートする WSDL エンドポイント (ポート) のローカル名。

--wsdl-service-name

インポートする WSDL サービスのローカル名。

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

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

プロパティ
規定値: False
--help -h

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

--only-show-errors

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

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: 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 apim api list

API Management API を一覧表示します。

az apim api list --resource-group
                 --service-name
                 [--filter-display-name]
                 [--skip]
                 [--top]

必須のパラメーター

--resource-group -g

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

--service-name -n

API Management サービス インスタンスの名前。

省略可能のパラメーター

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

--filter-display-name

displayName による API のフィルター処理。

プロパティ
Parameter group: API Arguments
--skip

スキップするレコードの数。

--top

返されるレコードの数。

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

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

プロパティ
規定値: False
--help -h

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

--only-show-errors

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

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: 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 apim api show

API Management API の詳細を表示します。

az apim api show --api-id
                 --resource-group
                 --service-name

必須のパラメーター

--api-id

API 識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。

プロパティ
Parameter group: API Arguments
--resource-group -g

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

--service-name

API Management サービス インスタンスの名前。

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

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

プロパティ
規定値: False
--help -h

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

--only-show-errors

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

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: 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 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-id

作成する API の一意の名前。

API リビジョン識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。

プロパティ
Parameter group: API Arguments
--resource-group -g

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

--service-name -n

API Management サービス インスタンスの名前。

省略可能のパラメーター

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

--add

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

プロパティ
Parameter group: Generic Update Arguments
規定値: []
--api-type

API の型。

プロパティ
Parameter group: API Arguments
指定可能な値: graphql, http, soap, websocket
--description

API の説明。 HTML 書式設定タグを含めることができます。

プロパティ
Parameter group: API Arguments
--display-name

API 名。 長さは 1 ~ 300 文字にする必要があります。

プロパティ
Parameter group: API Arguments
--force-string

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

プロパティ
Parameter group: Generic Update Arguments
規定値: False
--if-match

エンティティの ETag。 エンティティを作成する場合は必要ありませんが、エンティティを更新する場合は必須です。 既定値は None です。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

プロパティ
規定値: False
--path

Required. この API と API Management サービス インスタンス内のすべてのリソース パスを一意に識別する相対 URL。

プロパティ
Parameter group: API Arguments
--protocols

この API の操作を呼び出すことができるプロトコルについて説明します。

プロパティ
Parameter group: API Arguments
指定可能な値: http, https, ws, wss
--remove

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

プロパティ
Parameter group: Generic Update Arguments
規定値: []
--service-url

この API を実装するバックエンド サービスの絶対 URL。 2,000 文字を超えることはできません。

プロパティ
Parameter group: API Arguments
--set

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

プロパティ
Parameter group: Generic Update Arguments
規定値: []
--subscription-key-header-name

サブスクリプション キーのヘッダー名を指定します。

プロパティ
Parameter group: API Arguments
--subscription-key-query-param-name

サブスクリプション キークエリ文字列パラメーター名を指定します。

プロパティ
Parameter group: API Arguments
--subscription-required

true の場合、API には要求時にサブスクリプション キーが必要です。

プロパティ
Parameter group: API Arguments
指定可能な値: false, true
--tags

スペース区切りのタグ: key[=value] [key[=value] ...]既存のタグをクリアするには、"" を使用します。

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

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

プロパティ
規定値: False
--help -h

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

--only-show-errors

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

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: 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 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 を待機状態にします。 (autogenerated)

az apim api wait --created --api-id MyApi --name MyApim --resource-group MyResourceGroup

必須のパラメーター

--api-id

API リビジョン識別子。 現在の API Management サービス インスタンスで一意である必要があります。 現在のリビジョン以外のリビジョンには、rev=n はサフィックスであり、n はリビジョン番号です。 Required.

--name -n

API Management サービス インスタンスの名前。

--resource-group -g

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

省略可能のパラメーター

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

--created

'provisioningState' が 'Succeeded' で作成されるまで待ちます。

プロパティ
Parameter group: Wait Condition Arguments
規定値: False
--custom

条件がカスタム JMESPath クエリを満たすまで待ちます。 例: provisioningState!='InProgress'、instanceView.statuses[?code=='PowerState/running']。

プロパティ
Parameter group: Wait Condition Arguments
--deleted

削除されるまで待ちます。

プロパティ
Parameter group: Wait Condition Arguments
規定値: False
--exists

リソースが存在するまで待ちます。

プロパティ
Parameter group: Wait Condition Arguments
規定値: False
--interval

ポーリング間隔 (秒単位)。

プロパティ
Parameter group: Wait Condition Arguments
規定値: 30
--timeout

最大待機時間 (秒単位)。

プロパティ
Parameter group: Wait Condition Arguments
規定値: 3600
--updated

provisioningState が 'Succeeded' で更新されるまで待ちます。

プロパティ
Parameter group: Wait Condition Arguments
規定値: False
グローバル パラメーター
--debug

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

プロパティ
規定値: False
--help -h

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

--only-show-errors

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

プロパティ
規定値: False
--output -o

出力フォーマット。

プロパティ
規定値: 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