Azure 容器執行個體
使用單一命令在 Azure 上輕鬆執行容器。 建立容器群組、取得容器的記錄等等。
此連接器適用於以下產品和區域:
| 服務 | Class | Regions |
|---|---|---|
| 副駕駛工作室 | 進階 | 所有 Power Automate 區域 |
| 邏輯應用程式 | 標準 | 所有 Logic Apps 區域 |
| Power Apps | 進階 | 所有 Power Apps 區域 |
| Power Automate(自動化服務) | 進階 | 所有 Power Automate 區域 |
| 連絡人 | |
|---|---|
| 名稱 | Microsoft |
| URL |
Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援 |
| 連接器中繼資料 | |
|---|---|
| Publisher | Microsoft |
| 網站 | https://azure.microsoft.com/services/container-instances/ |
正在建立連線
連接器支援下列驗證類型:
| 預設值 | 建立連線的參數。 | 所有區域 | 不可共享 |
預設
適用:所有地區
建立連線的參數。
這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。
節流限制
| 名稱 | 呼叫 | 續約期間 |
|---|---|---|
| 每個連線的 API 呼叫 | 100 | 60 秒 |
動作
| 停止容器群組中的容器 |
停止容器群組中的所有容器。 計算資源將會解除配置,且計費將會停止。 |
| 刪除容器群組 |
刪除指定訂用帳戶和資源群組中的指定容器群組。 此作業不會刪除使用者提供的其他資源,例如磁碟區。 |
| 刪除容器群組虛擬網路關聯連結 |
刪除容器群組虛擬網路關聯連結。 該操作不會刪除使用者提供的其他資源。 |
| 取得功能 |
取得區域中訂用帳戶的 CPU/記憶體/GPU 功能清單。 |
| 取得容器群組的屬性 |
取得指定訂用帳戶和資源群組中指定容器群組的屬性。 此作業會傳回每個容器群組的屬性,包括容器、映像登錄認證、重新啟動原則、IP 位址類型、OS 類型、狀態和磁碟區。 |
| 取得容器群組的所有網路相依性 |
取得此容器群組的所有網路相依性,以允許完全控制網路設定和組態。 對於容器群組,這一律是空白清單。 |
| 取得快取的影像 |
取得區域中訂用帳戶的特定 OS 類型上的快取映像清單。 |
| 取得目前的使用量 |
取得訂用帳戶的使用量 |
| 取得訂用帳戶中的容器群組清單 |
取得指定訂用帳戶中的容器群組清單。 此作業會傳回每個容器群組的屬性,包括容器、映像登錄認證、重新啟動原則、IP 位址類型、OS 類型、狀態和磁碟區。 |
| 取得資源群組中的容器群組清單 |
取得指定訂用帳戶和資源群組中的容器群組清單。 此作業會傳回每個容器群組的屬性,包括容器、映像登錄認證、重新啟動原則、IP 位址類型、OS 類型、狀態和磁碟區。 |
| 在容器群組中啟動容器 |
啟動容器群組中的所有容器。 將會配置計算資源,並開始計費。 |
| 在特定容器執行個體中執行命令 |
針對指定資源群組和容器群組中的特定容器執行個體執行命令。 |
| 建立或更新容器群組 |
使用指定的組態建立或更新容器群組。 |
| 從容器執行個體取得記錄 |
取得指定資源群組和容器群組中指定容器執行個體的記錄。 |
| 更新容器群組位置或標籤 |
使用指定的標籤和/或位置更新容器群組。 |
| 重新啟動容器群組中的容器 |
就地重新啟動容器群組中的所有容器。 如果容器映像有更新,則會下載新映像。 |
| 附加至特定容器執行個體的輸出 |
附加至指定資源群組及儲存器群組中特定儲存器執行個體的輸出串流。 |
停止容器群組中的容器
停止容器群組中的所有容器。 計算資源將會解除配置,且計費將會停止。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
刪除容器群組
刪除指定訂用帳戶和資源群組中的指定容器群組。 此作業不會刪除使用者提供的其他資源,例如磁碟區。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
傳回
容器群組。
- 容器組
- ContainerGroup
刪除容器群組虛擬網路關聯連結
刪除容器群組虛擬網路關聯連結。 該操作不會刪除使用者提供的其他資源。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
虛擬網路名稱
|
virtualNetworkName | True | string |
虛擬網路的名稱。 |
|
子網路名稱
|
subnetName | True | string |
子網的名稱。 |
取得功能
取得區域中訂用帳戶的 CPU/記憶體/GPU 功能清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
地點
|
location | True | string |
實體 Azure 位置的識別碼。 |
傳回
包含功能清單的回應。
取得容器群組的屬性
取得指定訂用帳戶和資源群組中指定容器群組的屬性。 此作業會傳回每個容器群組的屬性,包括容器、映像登錄認證、重新啟動原則、IP 位址類型、OS 類型、狀態和磁碟區。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
傳回
容器群組。
- 容器組
- ContainerGroup
取得容器群組的所有網路相依性
取得此容器群組的所有網路相依性,以允許完全控制網路設定和組態。 對於容器群組,這一律是空白清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
傳回
網路相依性的回應,一律為空白清單。
取得快取的影像
取得區域中訂用帳戶的特定 OS 類型上的快取映像清單。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
地點
|
location | True | string |
實體 Azure 位置的識別碼。 |
傳回
包含快取影像的回應。
取得目前的使用量
取得訂用帳戶的使用量
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
地點
|
location | True | string |
實體 Azure 位置的識別碼。 |
傳回
包含使用量資料的回應
取得訂用帳戶中的容器群組清單
取得指定訂用帳戶中的容器群組清單。 此作業會傳回每個容器群組的屬性,包括容器、映像登錄認證、重新啟動原則、IP 位址類型、OS 類型、狀態和磁碟區。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
傳回
包含容器群組屬性的容器群組清單回應。
取得資源群組中的容器群組清單
取得指定訂用帳戶和資源群組中的容器群組清單。 此作業會傳回每個容器群組的屬性,包括容器、映像登錄認證、重新啟動原則、IP 位址類型、OS 類型、狀態和磁碟區。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
傳回
包含容器群組屬性的容器群組清單回應。
在容器群組中啟動容器
啟動容器群組中的所有容器。 將會配置計算資源,並開始計費。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
在特定容器執行個體中執行命令
針對指定資源群組和容器群組中的特定容器執行個體執行命令。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
|
containerName
|
containerName | True | string |
容器執行個體的名稱。 |
|
指令
|
command | string |
要執行的命令。 |
|
|
資料列
|
rows | integer |
終端機的列大小 |
|
|
科爾斯
|
cols | integer |
終端機的直欄大小 |
傳回
container exec 指令的資訊。
建立或更新容器群組
使用指定的組態建立或更新容器群組。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
|
識別碼
|
id | string |
資源標識碼。 |
|
|
名稱
|
name | string |
資源名稱。 |
|
|
型別
|
type | string |
資源類型。 |
|
|
地點
|
location | True | string |
資源位置。 |
|
Tags
|
tags | object |
資源標記。 |
|
|
區域
|
zones | array of string |
容器群組的區域。 |
|
|
principalId
|
principalId | string |
容器群組身分識別的主體標識碼。 此屬性只會針對系統指派的身分識別提供。 |
|
|
tenantId
|
tenantId | string |
與容器群組相關聯的租用戶標識碼。 此屬性只會針對系統指派的身分識別提供。 |
|
|
類型
|
type | string |
用於容器群組的身分識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 會從容器群組中移除任何身分識別。 |
|
|
使用者指派的身分識別
|
userAssignedIdentities | object |
與容器群組相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
|
|
provisioningState
|
provisioningState | string |
容器群組的布建狀態。 這隻會出現在回應中。 |
|
|
名稱
|
name | True | string |
容器的名稱。 |
|
影像
|
image | True | string |
用來建立容器的映像名稱。 例如 nginx:latest |
|
Command
|
command | array of string |
在容器內執行的命令。 例如 [ “echo”, “hello aci” ] |
|
|
協定
|
protocol | string |
與埠相關聯的通訊協定。 |
|
|
Number
|
port | True | integer |
容器群組內公開的埠號碼。 |
|
名稱
|
name | True | string |
環境變數的名稱。 |
|
價值觀
|
value | string |
環境變數的值。 |
|
|
secureValue 安全型
|
secureValue | string |
安全環境變數的值。 |
|
|
重新啟動計數
|
restartCount | integer |
容器實例已重新啟動的次數。 |
|
|
狀態
|
state | string |
容器實例的狀態。 |
|
|
startTime
|
startTime | date-time |
容器實例狀態啟動時的日期時間。 |
|
|
退出代碼
|
exitCode | integer |
容器實例結束代碼會對應至來自 |
|
|
完成時間
|
finishTime | date-time |
容器實例狀態完成的日期時間。 |
|
|
detail狀態
|
detailStatus | string |
容器實例狀態的人類可讀取狀態。 |
|
|
count
|
count | integer |
事件的計數。 |
|
|
firstTimestamp
|
firstTimestamp | date-time |
最早記錄事件的日期時間。 |
|
|
lastTimestamp
|
lastTimestamp | date-time |
最新記錄事件的日期時間。 |
|
|
名稱
|
name | string |
事件名稱。 |
|
|
訊息
|
message | string |
事件訊息。 |
|
|
型別
|
type | string |
事件類型。 |
|
|
Memory
|
memoryInGB | True | number |
此容器的記憶體要求 (以 GB 為單位)。 例如 3.5 |
|
CPU
|
cpu | True | number |
此容器的 CPU 要求。 例如 2.0 |
|
Count
|
count | integer |
GPU 資源的計數。 |
|
|
SKU
|
sku | string |
GPU 資源的 SKU。 |
|
|
Memory
|
memoryInGB | double |
此儲存器的記憶體限制 (以 GB 為單位)。 |
|
|
CPU
|
cpu | double |
此容器的 CPU 限制。 |
|
|
名稱
|
name | True | string |
卷名。 |
|
路徑
|
mountPath | True | string |
容器內應掛接磁碟區的路徑。 不得包含冒號 (:)。 |
|
唯讀
|
readOnly | boolean |
指出磁碟區掛接是否為唯讀的旗標。 |
|
|
Command
|
command | array of string |
在容器內執行的命令。 |
|
|
路徑
|
path | string |
探查的路徑。 |
|
|
港口
|
port | integer |
要探查的埠號碼。 |
|
|
配置
|
scheme | string |
配置。 |
|
|
名稱
|
name | string |
標頭名稱。 |
|
|
value
|
value | string |
標頭值。 |
|
|
初始延遲
|
initialDelaySeconds | integer |
初始延遲秒。 |
|
|
期間
|
periodSeconds | integer |
句點秒數。 |
|
|
失敗臨界值
|
failureThreshold | integer |
失敗臨界值。 |
|
|
成功臨界值
|
successThreshold | integer |
成功臨界值。 |
|
|
暫停
|
timeoutSeconds | integer |
逾時秒數。 |
|
|
具特殊權限
|
privileged | boolean |
用來判斷容器許可權是否提升為 Privileged 的旗標。 |
|
|
allowPrivilegeEscalation 許可權提升
|
allowPrivilegeEscalation | boolean |
布爾值,指出 init 進程是否可以提高其許可權 |
|
|
新增
|
add | array of string |
要新增至容器的功能。 |
|
|
卸除
|
drop | array of string |
要從容器卸除的功能。 |
|
|
runAsGroup
|
runAsGroup | integer |
設定容器的使用者 GID。 |
|
|
runAsUser
|
runAsUser | integer |
設定容器的使用者 UID。 |
|
|
seccomp配置檔
|
seccompProfile | string |
base64 編碼字串,其中包含 seccomp 配置檔中 JSON 的內容 |
|
|
伺服器
|
server | True | string |
沒有通訊協定的 Docker 映像登錄伺服器,例如 “myacr.azurecr.io”。 |
|
使用者名
|
username | string |
私人登錄的用戶名稱。 |
|
|
密碼
|
password | string |
私人登錄的密碼。 |
|
|
身份
|
identity | string |
私人登錄的身分識別。 |
|
|
身分識別URL
|
identityUrl | string |
私人登錄的識別 URL。 |
|
|
重啟策略
|
restartPolicy | string |
重新啟動容器群組內所有容器的原則。
|
|
|
協定
|
protocol | string |
與埠相關聯的通訊協定。 |
|
|
Number
|
port | True | integer |
埠號碼。 |
|
類型
|
type | True | string |
指定IP是否公開至公用因特網。 |
|
IP 位址
|
ip | string |
公開至公用因特網的IP。 |
|
|
DNS名稱
|
dnsNameLabel | string |
IP 的 Dns 名稱標籤。 |
|
|
autoGeneratedDomainNameLabelScope
|
autoGeneratedDomainNameLabelScope | string |
表示安全性列舉的值。 如果未選取,則 'Unsecure' 值是預設值,表示物件的域名卷標不會受到子域接管的保護。 如果選取 'TenantReuse' 值,則為預設值,表示物件域名標籤可以在相同的租用戶內重複使用。 'SubscriptionReuse' 值表示物件域名標籤可以在相同的訂用帳戶內重複使用。 'ResourceGroupReuse' 值表示物件域名標籤可以在相同的資源群組內重複使用。 'NoReuse' 值表示物件功能變數名稱標籤無法在相同的資源群組、訂用帳戶或租用戶內重複使用。 |
|
|
fqdn
|
fqdn | string |
IP 的 FQDN。 |
|
|
osType
|
osType | True | string |
容器群組中容器所需的操作系統類型。 |
|
名稱
|
name | True | string |
卷名。 |
|
共用名稱
|
shareName | True | string |
要掛接為磁碟區的 Azure 檔案共享名稱。 |
|
ReadOnly
|
readOnly | boolean |
旗標,指出掛接為磁碟區的 Azure 檔案共用是否為唯讀。 |
|
|
儲存體帳戶名稱
|
storageAccountName | True | string |
包含 Azure 檔案共用的記憶體帳戶名稱。 |
|
儲存體帳戶金鑰
|
storageAccountKey | string |
用來存取 Azure 檔案共用的記憶體帳戶存取金鑰。 |
|
|
秘密卷
|
secret | object |
秘密磁碟區。 |
|
|
Directory
|
directory | string |
目標目錄名稱。 不得包含或開頭為 『..』。 如果提供 『.』,磁碟區目錄將會是 git 存放庫。 否則,如果指定,磁碟區將會在具有指定名稱的子目錄中包含 git 存放庫。 |
|
|
存儲庫
|
repository | True | string |
存放庫 URL |
|
Revision
|
revision | string |
認可指定修訂的哈希。 |
|
|
狀態
|
state | string |
容器群組的狀態。 只有在回應中才有效。 |
|
|
工作區識別碼
|
workspaceId | True | string |
記錄分析的工作區標識碼 |
|
工作區索引鍵
|
workspaceKey | True | string |
記錄分析的工作區金鑰 |
|
日誌類型
|
logType | string |
要使用的記錄類型。 |
|
|
後設資料
|
metadata | object |
記錄分析的元數據。 |
|
|
workspaceResourceId
|
workspaceResourceId | string |
記錄分析的工作區資源標識碼 |
|
|
識別碼
|
id | True | string |
虛擬網路和子網的資源標識碼。 |
|
名稱
|
name | string |
子網的易記名稱。 |
|
|
名稱伺服器
|
nameServers | True | array of string |
容器群組的 DNS 伺服器。 |
|
搜尋網域
|
searchDomains | string |
容器群組中主機名查閱的 DNS 搜尋網域。 |
|
|
選項
|
options | string |
容器群組的 DNS 選項。 |
|
|
SKU
|
sku | string |
容器群組 SKU。 |
|
|
保存庫網址
|
vaultBaseUrl | True | string |
keyvault 基底 URL。 |
|
索引鍵名稱
|
keyName | True | string |
加密金鑰名稱。 |
|
金鑰版本
|
keyVersion | True | string |
加密金鑰版本。 |
|
身份
|
identity | string |
keyvault 受控識別。 |
|
|
名稱
|
name | True | string |
init 容器的名稱。 |
|
影像
|
image | string |
init 容器的映像。 |
|
|
Command
|
command | array of string |
在 exec 表單的 init 容器內執行的命令。 |
|
|
重新啟動計數
|
restartCount | integer |
init 容器已重新啟動的次數。 |
|
|
名稱
|
name | True | string |
延伸模組的名稱。 |
|
擴展類型
|
extensionType | True | string |
要加入的延伸模組類型。 |
|
版本
|
version | True | string |
所使用的擴充功能版本。 |
|
設定
|
settings | object |
延伸模組的設定。 |
|
|
protectedSettings
|
protectedSettings | object |
延伸模組的受保護設定。 |
|
|
CCE政策
|
ccePolicy | string |
base64 編碼的機密計算強制執行原則 |
|
|
priority
|
priority | string |
容器群組的優先順序。 |
傳回
容器群組。
- 容器組
- ContainerGroup
從容器執行個體取得記錄
取得指定資源群組和容器群組中指定容器執行個體的記錄。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
|
容器名稱
|
containerName | True | string |
容器執行個體的名稱。 |
|
尾線
|
tail | integer |
從容器執行個體日誌的尾部顯示的行數。 如果未提供,則所有可用的日誌最多顯示 4mb。 |
傳回
日誌。
- 身體
- Logs
更新容器群組位置或標籤
使用指定的標籤和/或位置更新容器群組。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
|
識別碼
|
id | string |
資源標識碼。 |
|
|
名稱
|
name | string |
資源名稱。 |
|
|
型別
|
type | string |
資源類型。 |
|
|
地點
|
location | string |
資源位置。 |
|
|
Tags
|
tags | object |
資源標記。 |
|
|
區域
|
zones | array of string |
容器群組的區域。 |
傳回
容器群組。
- 容器組
- ContainerGroup
重新啟動容器群組中的容器
就地重新啟動容器群組中的所有容器。 如果容器映像有更新,則會下載新映像。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
附加至特定容器執行個體的輸出
附加至指定資源群組及儲存器群組中特定儲存器執行個體的輸出串流。
參數
| 名稱 | 機碼 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
訂用帳戶識別碼
|
subscriptionId | True | string |
可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。 |
|
資源群組
|
resourceGroupName | True | string |
資源群組的名稱。 |
|
容器群組名稱
|
containerGroupName | True | string |
容器群組的名稱。 |
|
containerName
|
containerName | True | string |
容器執行個體的名稱。 |
傳回
容器連接輸出串流的資訊。
定義
容器
容器實例。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
name | string |
容器的名稱。 |
|
properties
|
properties | ContainerProperties |
容器屬性。 |
容器屬性
容器屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
影像
|
image | string |
用來建立容器的映像名稱。 例如 nginx:latest |
|
Command
|
command | array of string |
在容器內執行的命令。 例如 [ “echo”, “hello aci” ] |
|
Ports
|
ports | array of ContainerPort |
容器實例上公開的埠。 |
|
環境變數
|
environmentVariables | array of EnvironmentVariable |
要設定於容器實例中的環境變數。 |
|
重新啟動計數
|
instanceView.restartCount | integer |
容器實例已重新啟動的次數。 |
|
目前狀態
|
instanceView.currentState | ContainerState |
容器實例狀態。 |
|
上一頁狀態
|
instanceView.previousState | ContainerState |
容器實例狀態。 |
|
events
|
instanceView.events | array of Event |
容器實例的事件。 |
|
resources
|
resources | ResourceRequirements |
資源需求。 |
|
磁碟區掛載
|
volumeMounts | array of VolumeMount |
磁碟區會掛接給容器實例。 |
|
活體探針
|
livenessProbe | ContainerProbe |
容器探頭,用於活躍 |
|
活體探針
|
readinessProbe | ContainerProbe |
容器探頭,用於活躍 |
|
securityContext
|
securityContext | SecurityContextDefinition |
容器的安全性內容。 |
SecurityContext定義
容器的安全性內容。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
具特殊權限
|
privileged | boolean |
用來判斷容器許可權是否提升為 Privileged 的旗標。 |
|
allowPrivilegeEscalation 許可權提升
|
allowPrivilegeEscalation | boolean |
布爾值,指出 init 進程是否可以提高其許可權 |
|
capabilities
|
capabilities | SecurityContextCapabilitiesDefinition |
從容器新增或卸除的功能。 |
|
runAsGroup
|
runAsGroup | integer |
設定容器的使用者 GID。 |
|
runAsUser
|
runAsUser | integer |
設定容器的使用者 UID。 |
|
seccomp配置檔
|
seccompProfile | string |
base64 編碼字串,其中包含 seccomp 配置檔中 JSON 的內容 |
SecurityContextCapabilities定義
從容器新增或卸除的功能。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
新增
|
add | array of string |
要新增至容器的功能。 |
|
卸除
|
drop | array of string |
要從容器卸除的功能。 |
ContainerState
容器實例狀態。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
狀態
|
state | string |
容器實例的狀態。 |
|
startTime
|
startTime | date-time |
容器實例狀態啟動時的日期時間。 |
|
退出代碼
|
exitCode | integer |
容器實例結束代碼會對應至來自 |
|
完成時間
|
finishTime | date-time |
容器實例狀態完成的日期時間。 |
|
detail狀態
|
detailStatus | string |
容器實例狀態的人類可讀取狀態。 |
Event
容器群組或容器實例事件。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
count
|
count | integer |
事件的計數。 |
|
firstTimestamp
|
firstTimestamp | date-time |
最早記錄事件的日期時間。 |
|
lastTimestamp
|
lastTimestamp | date-time |
最新記錄事件的日期時間。 |
|
名稱
|
name | string |
事件名稱。 |
|
訊息
|
message | string |
事件訊息。 |
|
型別
|
type | string |
事件類型。 |
ResourceRequirements
資源需求。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
資源請求
|
requests | ResourceRequests |
資源要求。 |
|
資源限制
|
limits | ResourceLimits |
資源限制。 |
ResourceRequests
資源要求。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Memory
|
memoryInGB | number |
此容器的記憶體要求 (以 GB 為單位)。 例如 3.5 |
|
CPU
|
cpu | number |
此容器的 CPU 要求。 例如 2.0 |
|
GPU
|
gpu | GpuResource |
GPU 資源。 |
ResourceLimits
資源限制。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Memory
|
memoryInGB | double |
此儲存器的記憶體限制 (以 GB 為單位)。 |
|
CPU
|
cpu | double |
此容器的 CPU 限制。 |
|
GPU
|
gpu | GpuResource |
GPU 資源。 |
GpuResource (圖形資源)
GPU 資源。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Count
|
count | integer |
GPU 資源的計數。 |
|
SKU
|
sku | string |
GPU 資源的 SKU。 |
AzureFileVolume
Azure 檔案磁碟區的屬性。 Azure 檔案共用會掛接為磁碟區。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
共用名稱
|
shareName | string |
要掛接為磁碟區的 Azure 檔案共享名稱。 |
|
ReadOnly
|
readOnly | boolean |
旗標,指出掛接為磁碟區的 Azure 檔案共用是否為唯讀。 |
|
儲存體帳戶名稱
|
storageAccountName | string |
包含 Azure 檔案共用的記憶體帳戶名稱。 |
|
儲存體帳戶金鑰
|
storageAccountKey | string |
用來存取 Azure 檔案共用的記憶體帳戶存取金鑰。 |
EmptyDirVolume
空的目錄磁碟區。
SecretVolume (秘密卷)
秘密磁碟區。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
秘密卷
|
object |
秘密磁碟區。 |
GitRepoVolume
表示填入 Git 存放庫內容的磁碟區
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Directory
|
directory | string |
目標目錄名稱。 不得包含或開頭為 『..』。 如果提供 『.』,磁碟區目錄將會是 git 存放庫。 否則,如果指定,磁碟區將會在具有指定名稱的子目錄中包含 git 存放庫。 |
|
存儲庫
|
repository | string |
存放庫 URL |
|
Revision
|
revision | string |
認可指定修訂的哈希。 |
音量
磁碟區的屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
name | string |
卷名。 |
|
Azure 檔案磁碟區
|
azureFile | AzureFileVolume |
Azure 檔案磁碟區的屬性。 Azure 檔案共用會掛接為磁碟區。 |
|
空白目錄磁碟區
|
emptyDir | EmptyDirVolume |
空的目錄磁碟區。 |
|
秘密卷
|
secret | SecretVolume |
秘密磁碟區。 |
|
Git 存放庫磁碟區
|
gitRepo | GitRepoVolume |
表示填入 Git 存放庫內容的磁碟區 |
VolumeMount (體積掛載)
磁碟區掛接的屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
name | string |
卷名。 |
|
路徑
|
mountPath | string |
容器內應掛接磁碟區的路徑。 不得包含冒號 (:)。 |
|
唯讀
|
readOnly | boolean |
指出磁碟區掛接是否為唯讀的旗標。 |
容器執行
容器執行命令,用於即時性或整備探查
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Command
|
command | array of string |
在容器內執行的命令。 |
ContainerHttpGet
容器 Http Get 設定,用於即時性或整備探查
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
路徑
|
path | string |
探查的路徑。 |
|
港口
|
port | integer |
要探查的埠號碼。 |
|
配置
|
scheme | string |
配置。 |
|
HTTP 標頭
|
httpHeaders | array of HttpHeader |
HTTP 標頭。 |
容器探測
容器探頭,用於活躍
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
執行官
|
exec | ContainerExec |
容器執行命令,用於即時性或整備探查 |
|
HTTP 取得
|
httpGet | ContainerHttpGet |
容器 Http Get 設定,用於即時性或整備探查 |
|
初始延遲
|
initialDelaySeconds | integer |
初始延遲秒。 |
|
期間
|
periodSeconds | integer |
句點秒數。 |
|
失敗臨界值
|
failureThreshold | integer |
失敗臨界值。 |
|
成功臨界值
|
successThreshold | integer |
成功臨界值。 |
|
暫停
|
timeoutSeconds | integer |
逾時秒數。 |
容器組
容器群組。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
資源標識碼。 |
|
名稱
|
name | string |
資源名稱。 |
|
型別
|
type | string |
資源類型。 |
|
地點
|
location | string |
資源位置。 |
|
Tags
|
tags | object |
資源標記。 |
|
區域
|
zones | array of string |
容器群組的區域。 |
|
管理式識別
|
identity | ContainerGroupIdentity |
容器群組的身分識別。 |
|
properties
|
properties | ContainerGroupProperties |
容器群組屬性 |
ContainerGroupProperties
容器群組屬性
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
provisioningState
|
provisioningState | string |
容器群組的布建狀態。 這隻會出現在回應中。 |
|
containers
|
containers | array of Container |
容器群組內的容器。 |
|
imageRegistryCredentials
|
imageRegistryCredentials | array of ImageRegistryCredential |
建立容器群組的來源映像登錄認證。 |
|
重啟策略
|
restartPolicy | string |
重新啟動容器群組內所有容器的原則。
|
|
IP 位址
|
ipAddress | IpAddress |
容器群組的IP位址。 |
|
osType
|
osType | string |
容器群組中容器所需的操作系統類型。 |
|
volumes
|
volumes | array of Volume |
此容器群組中的容器可以掛接的磁碟區清單。 |
|
events
|
instanceView.events | array of Event |
這個容器群組的事件。 |
|
狀態
|
instanceView.state | string |
容器群組的狀態。 只有在回應中才有效。 |
|
diagnostics
|
diagnostics | ContainerGroupDiagnostics |
容器群組診斷資訊。 |
|
subnetIds
|
subnetIds | array of ContainerGroupSubnetId |
容器群組的子網資源標識碼。 |
|
DNS 組態
|
dnsConfig | DnsConfiguration |
容器群組的 DNS 組態。 |
|
SKU
|
sku | ContainerGroupSku |
容器群組 SKU。 |
|
Encryption
|
encryptionProperties | EncryptionProperties |
容器群組加密屬性。 |
|
initContainers
|
initContainers | array of InitContainerDefinition |
容器群組的 init 容器。 |
|
extensions
|
extensions | array of DeploymentExtensionSpec |
virtual kubelet 所使用的擴充功能 |
|
confidentialComputeProperties
|
confidentialComputeProperties | ConfidentialComputeProperties |
機密容器群組的屬性 |
|
priority
|
priority | string |
容器群組的優先順序。 |
DeploymentExtensionSpec
要新增至部署的擴充功能提要。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
name | string |
延伸模組的名稱。 |
|
擴展類型
|
properties.extensionType | string |
要加入的延伸模組類型。 |
|
版本
|
properties.version | string |
所使用的擴充功能版本。 |
|
設定
|
properties.settings | object |
延伸模組的設定。 |
|
protectedSettings
|
properties.protectedSettings | object |
延伸模組的受保護設定。 |
容器組身份
容器群組的身分識別。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
principalId
|
principalId | string |
容器群組身分識別的主體標識碼。 此屬性只會針對系統指派的身分識別提供。 |
|
tenantId
|
tenantId | string |
與容器群組相關聯的租用戶標識碼。 此屬性只會針對系統指派的身分識別提供。 |
|
類型
|
type | string |
用於容器群組的身分識別類型。 類型 'SystemAssigned, UserAssigned' 包含隱含建立的身分識別和一組使用者指派的身分識別。 類型 『None』 會從容器群組中移除任何身分識別。 |
|
使用者指派的身分識別
|
userAssignedIdentities | object |
與容器群組相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
ImageRegistryCredential
映射登錄認證。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
伺服器
|
server | string |
沒有通訊協定的 Docker 映像登錄伺服器,例如 “myacr.azurecr.io”。 |
|
使用者名
|
username | string |
私人登錄的用戶名稱。 |
|
密碼
|
password | string |
私人登錄的密碼。 |
|
身份
|
identity | string |
私人登錄的身分識別。 |
|
身分識別URL
|
identityUrl | string |
私人登錄的識別 URL。 |
ContainerGroupDiagnostics (容器組診斷)
容器群組診斷資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Log Analytics
|
logAnalytics | LogAnalytics |
容器群組記錄分析資訊。 |
日誌分析
容器群組記錄分析資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
工作區識別碼
|
workspaceId | string |
記錄分析的工作區標識碼 |
|
工作區索引鍵
|
workspaceKey | string |
記錄分析的工作區金鑰 |
|
日誌類型
|
logType | string |
要使用的記錄類型。 |
|
後設資料
|
metadata | object |
記錄分析的元數據。 |
|
workspaceResourceId
|
workspaceResourceId | string |
記錄分析的工作區資源標識碼 |
容器組子網ID
容器群組子網資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
虛擬網路和子網的資源標識碼。 |
|
名稱
|
name | string |
子網的易記名稱。 |
IP地址
容器群組的IP位址。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
Ports
|
ports | array of Port |
容器群組上公開的埠清單。 |
|
類型
|
type | string |
指定IP是否公開至公用因特網。 |
|
IP 位址
|
ip | string |
公開至公用因特網的IP。 |
|
DNS名稱
|
dnsNameLabel | string |
IP 的 Dns 名稱標籤。 |
|
autoGeneratedDomainNameLabelScope
|
autoGeneratedDomainNameLabelScope | string |
表示安全性列舉的值。 如果未選取,則 'Unsecure' 值是預設值,表示物件的域名卷標不會受到子域接管的保護。 如果選取 'TenantReuse' 值,則為預設值,表示物件域名標籤可以在相同的租用戶內重複使用。 'SubscriptionReuse' 值表示物件域名標籤可以在相同的訂用帳戶內重複使用。 'ResourceGroupReuse' 值表示物件域名標籤可以在相同的資源群組內重複使用。 'NoReuse' 值表示物件功能變數名稱標籤無法在相同的資源群組、訂用帳戶或租用戶內重複使用。 |
|
fqdn
|
fqdn | string |
IP 的 FQDN。 |
港口
在容器群組上公開的埠。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
協定
|
protocol | string |
與埠相關聯的通訊協定。 |
|
Number
|
port | integer |
埠號碼。 |
容器埠
在容器實例上公開的埠。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
協定
|
protocol | string |
與埠相關聯的通訊協定。 |
|
Number
|
port | integer |
容器群組內公開的埠號碼。 |
EnvironmentVariable
要設定於容器實例內的環境變數。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
name | string |
環境變數的名稱。 |
|
價值觀
|
value | string |
環境變數的值。 |
|
secureValue 安全型
|
secureValue | string |
安全環境變數的值。 |
使用情況清單結果
包含使用量資料的回應
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of Usage |
使用情況資料。 |
Usage
單一使用結果
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
識別碼
|
id | string |
使用結果的 ID |
|
單位
|
unit | string |
使用結果的單位 |
|
當前值
|
currentValue | integer |
資源的目前使用量 |
|
limit
|
limit | integer |
資源允許的最大使用量。 |
|
value
|
name.value | string |
資源的名稱 |
|
本地化值
|
name.localizedValue | string |
資源的當地語系化名稱 |
ContainerGroupList結果
包含容器群組屬性的容器群組清單回應。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of ContainerGroup |
容器群組的清單。 |
|
nextLink
|
nextLink | string |
要擷取容器群組下一頁的 URI。 |
日誌
日誌。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
內容
|
content | string |
日誌的內容。 |
ContainerExec回應
container exec 指令的資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
webSocketUri
|
webSocketUri | string |
exec websocket 的 uri。 |
|
密碼
|
password | string |
啟動exec指令的密碼。 |
ContainerAttach回應
容器連接輸出串流的資訊。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
webSocketUri
|
webSocketUri | string |
附加輸出資料流程的 URI。 |
|
密碼
|
password | string |
連接輸出串流的密碼。 連線到 websocketUri 時,以 Authorization 標頭值的形式傳送。 |
HttpHeader 的
HTTP 標頭。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
name | string |
標頭名稱。 |
|
value
|
value | string |
標頭值。 |
DnsConfiguration
容器群組的 DNS 組態。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱伺服器
|
nameServers | array of string |
容器群組的 DNS 伺服器。 |
|
搜尋網域
|
searchDomains | string |
容器群組中主機名查閱的 DNS 搜尋網域。 |
|
選項
|
options | string |
容器群組的 DNS 選項。 |
快取影像清單結果
包含快取影像的回應。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of cachedImages |
快取影像的清單。 |
|
nextLink
|
nextLink | string |
擷取快取影像下一頁的 URI。 |
快取影像
快取的映像和作業系統類型。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
osType
|
osType | string |
快取映像的作業系統類型。 |
|
圖片
|
image | string |
快取的映像名稱。 |
功能清單結果
包含功能清單的回應。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
value
|
value | array of Capabilities |
功能清單。 |
|
nextLink
|
nextLink | string |
擷取下一頁功能的 URI。 |
能力
區域能力。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
resourceType
|
resourceType | string |
此功能所描述的資源類型。 |
|
osType
|
osType | string |
此功能所描述的作業系統類型。 |
|
位置
|
location | string |
資源位置。 |
|
ipAddress類型
|
ipAddressType | string |
此功能描述的 IP 位址類型。 |
|
gpu
|
gpu | string |
此功能所描述的 GPU SKU。 |
|
最大記憶體以GB
|
capabilities.maxMemoryInGB | number |
允許的記憶體要求上限 (以 GB 為單位)。 |
|
最大CPU值
|
capabilities.maxCpu | number |
允許的 CPU 要求上限 (以核心為單位)。 |
|
maxGpu計數
|
capabilities.maxGpuCount | number |
允許的 GPU 計數上限。 |
ContainerGroupSku
加密屬性
容器群組加密屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
保存庫網址
|
vaultBaseUrl | string |
keyvault 基底 URL。 |
|
索引鍵名稱
|
keyName | string |
加密金鑰名稱。 |
|
金鑰版本
|
keyVersion | string |
加密金鑰版本。 |
|
身份
|
identity | string |
keyvault 受控識別。 |
InitContainerDefinition
init 容器定義。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
名稱
|
name | string |
init 容器的名稱。 |
|
properties
|
properties | InitContainerPropertiesDefinition |
init 容器定義屬性。 |
InitContainerProperties定義
init 容器定義屬性。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
影像
|
image | string |
init 容器的映像。 |
|
Command
|
command | array of string |
在 exec 表單的 init 容器內執行的命令。 |
|
環境變數
|
environmentVariables | array of EnvironmentVariable |
在 init 容器中設定的環境變數。 |
|
重新啟動計數
|
instanceView.restartCount | integer |
init 容器已重新啟動的次數。 |
|
目前狀態
|
instanceView.currentState | ContainerState |
容器實例狀態。 |
|
上一頁狀態
|
instanceView.previousState | ContainerState |
容器實例狀態。 |
|
events
|
instanceView.events | array of Event |
init 容器的事件。 |
|
磁碟區掛載
|
volumeMounts | array of VolumeMount |
磁碟區掛接可供 init 容器使用。 |
|
securityContext
|
securityContext | SecurityContextDefinition |
容器的安全性內容。 |
NetworkDependencies回應
網路相依性的回應,一律為空白清單。
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
物品
|
string |
機密計算屬性
機密容器群組的屬性
| 名稱 | 路徑 | 類型 | Description |
|---|---|---|---|
|
CCE政策
|
ccePolicy | string |
base64 編碼的機密計算強制執行原則 |