az apic api
注意
此參考是 Azure CLI 的 apic-extension 延伸模組的一部分(2.57.0 版或更高版本)。 擴充功能會在您第一次執行 az apic api 命令時自動安裝。 深入了解擴充功能。
在 API 中心管理 API 的命令。
命令
名稱 | Description | 類型 | 狀態 |
---|---|---|---|
az apic api create |
註冊新的 API 或更新現有的 API。 |
副檔名 | GA |
az apic api definition |
在 API 中心管理 API 定義的命令。 |
副檔名 | GA |
az apic api definition create |
建立新的 API 定義或更新現有的 API 定義。 |
副檔名 | GA |
az apic api definition delete |
刪除指定的 API 定義。 |
副檔名 | GA |
az apic api definition export-specification |
匯出 API 規格。 |
副檔名 | GA |
az apic api definition import-specification |
匯入 API 規格。 |
副檔名 | GA |
az apic api definition list |
列出 API 定義的集合。 |
副檔名 | GA |
az apic api definition show |
取得 API 定義的詳細數據。 |
副檔名 | GA |
az apic api definition update |
更新現有的 API 定義。 |
副檔名 | GA |
az apic api delete |
刪除指定的 API。 |
副檔名 | GA |
az apic api deployment |
在 API 中心管理 API 部署的命令。 |
副檔名 | GA |
az apic api deployment create |
建立新的 API 部署或更新現有的 API 部署。 |
副檔名 | GA |
az apic api deployment delete |
刪除 API 部署。 |
副檔名 | GA |
az apic api deployment list |
列出 API 部署的集合。 |
副檔名 | GA |
az apic api deployment show |
取得 API 部署的詳細數據。 |
副檔名 | GA |
az apic api deployment update |
更新現有的 API 部署。 |
副檔名 | GA |
az apic api list |
列出 API 的集合。 |
副檔名 | GA |
az apic api register |
使用規格檔案作為事實來源,向版本、定義和相關聯的部署註冊新的 API。 目前我們只支援 OpenAPI JSON/YAML 格式。 |
副檔名 | 預覽 |
az apic api show |
取得 API 的詳細數據。 |
副檔名 | GA |
az apic api update |
更新現有的 API。 |
副檔名 | GA |
az apic api version |
在 API 中心管理 API 版本的命令。 |
副檔名 | GA |
az apic api version create |
建立新的 API 版本或更新現有的 API 版本。 |
副檔名 | GA |
az apic api version delete |
刪除指定的 API 版本。 |
副檔名 | GA |
az apic api version list |
列出 API 版本的集合。 |
副檔名 | GA |
az apic api version show |
取得 API 版本的詳細數據。 |
副檔名 | GA |
az apic api version update |
更新現有的 API 版本。 |
副檔名 | GA |
az apic api create
註冊新的 API 或更新現有的 API。
az apic api create --api-id
--resource-group
--service-name
--title
--type {graphql, grpc, rest, soap, webhook, websocket}
[--contacts]
[--custom-properties]
[--description]
[--external-documentation]
[--license]
[--summary]
範例
Create API
az apic api create -g contoso-resources -n contoso --api-id echo-api --title "Echo API" --type REST
使用自訂屬性建立 API
az apic api create -g contoso-resources -n contoso --api-id echo-api --title "Echo API" --type REST --custom-properties '{"public-facing":true}'
必要參數
API 的識別碼。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure API 中心服務的名稱。
API 標題。
API 的類型。
選擇性參數
API 的連絡資訊。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
針對 API 目錄實體定義的自訂元數據。 支援 json-file 和 yaml-file。
API 的描述。
API 的其他外部檔。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
API 的授權資訊。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
API 的簡短描述。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az apic api delete
刪除指定的 API。
az apic api delete [--api-id]
[--ids]
[--resource-group]
[--service-name]
[--subscription]
[--yes]
範例
刪除 API
az apic api delete -g contoso-resources -n contoso --api-id echo-api
選擇性參數
API 的識別碼。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure API 中心服務的名稱。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az apic api list
列出 API 的集合。
az apic api list --resource-group
--service-name
[--filter]
[--max-items]
[--next-token]
範例
列出 API
az apic api list -g contoso-resources -n contoso
列出具有篩選條件的 API
az apic api list -g contoso-resources -n contoso --filter "kind eq 'rest'"
必要參數
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure API 中心服務的名稱。
選擇性參數
OData 篩選參數。
命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值,則會在命令的輸出中提供令牌。 若要繼續分頁,請在後續命令的自變數中 --next-token
提供令牌值。
標記,指定要開始分頁的位置。 這是先前截斷回應中的令牌值。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az apic api register
此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
使用規格檔案作為事實來源,向版本、定義和相關聯的部署註冊新的 API。 目前我們只支援 OpenAPI JSON/YAML 格式。
az apic api register --api-location
--resource-group
--service-name
[--environment-id]
範例
藉由提供規格檔案來註冊 API。
az apic api register -g api-center-test -n contosoeuap --api-location "examples/cli-examples/spec-examples/openai.json" --environment-id public
az apic api register -g api-center-test -n contosoeuap --api-location "examples/cli-examples/spec-examples/openai.yml" --environment-id public
必要參數
規格檔案的位置。
資源組名。
APICenter 目錄或服務名稱。
選擇性參數
之前建立的環境標識碼。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az apic api show
取得 API 的詳細數據。
az apic api show [--api-id]
[--ids]
[--resource-group]
[--service-name]
[--subscription]
範例
顯示 API 詳細數據
az apic api show -g contoso-resources -n contoso --api-id echo-api
選擇性參數
API 的識別碼。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure API 中心服務的名稱。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az apic api update
更新現有的 API。
az apic api update [--add]
[--api-id]
[--contacts]
[--custom-properties]
[--description]
[--external-documentation]
[--force-string {0, 1, f, false, n, no, t, true, y, yes}]
[--ids]
[--license]
[--remove]
[--resource-group]
[--service-name]
[--set]
[--subscription]
[--summary]
[--title]
[--type {graphql, grpc, rest, soap, webhook, websocket}]
範例
更新 API
az apic api update -g contoso-resources -n contoso --api-id echo-api --summary "Basic REST API service"
更新自訂屬性
az apic api update -g contoso-resources -n contoso --api-id echo-api --custom-properties '{"public-facing":true}'
選擇性參數
藉由指定路徑和索引鍵值組,將物件加入物件清單。 範例:--add property.listProperty <key=value、string 或 JSON 字串>。
API 的識別碼。
API 的連絡資訊。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
針對 API 目錄實體定義的自訂元數據。 支援 json-file 和 yaml-file。
API 的描述。
API 的其他外部檔。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
使用 'set' 或 'add' 時,請保留字串常值,而不是嘗試轉換成 JSON。
一或多個資源識別碼 (以空格分隔)。 它應該是完整資源識別碼,其中包含「資源標識碼」引數的所有資訊。 您應該提供 --ids 或其他「資源識別碼」引數。
API 的授權資訊。 支援速記語法、json-file 和 yaml-file。 請嘗試 “??” 以顯示更多。
從清單中移除屬性或專案。 範例:--remove property.list OR --remove 屬性ToRemove。
資源群組的名稱。 您可以使用 az configure --defaults group=<name>
來設定預設群組。
Azure API 中心服務的名稱。
指定要設定的屬性路徑和值,以更新物件。 範例:--set property1.property2=。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
API 的簡短描述。
API 標題。
API 的類型。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID
設定預設訂用帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。