Virtual Machine Scale Sets - List
取得資源群組下所有 VM 擴展集的清單。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets?api-version=2020-06-01
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
resource
|
path | True |
string |
資源群組的名稱。 |
subscription
|
path | True |
string |
可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。 |
api-version
|
query | True |
string |
用戶端 API 版本。 |
名稱 | 類型 | Description |
---|---|---|
200 OK |
確定 |
Azure Active Directory OAuth2 Flow
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
名稱 | Description |
---|---|
Additional |
啟用或停用虛擬機或虛擬機擴展集上的功能。 |
Additional |
指定 Windows 安裝程式所使用的 Unattend.xml 檔案中可包含的其他 XML 格式資訊。 內容是透過設定名稱、元件名稱和套用內容的傳遞來定義。 |
Api |
API 實體參考。 |
Automatic |
用於執行自動OS升級的組態參數。 |
Automatic |
指定虛擬機擴展集上自動修復的組態參數。 |
Billing |
指定 Azure Spot VM 或 VMSS 的計費相關詳細數據。 |
Boot |
開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照以診斷 VM 狀態。 |
Caching |
指定快取需求。 |
Component |
元件名稱。 目前唯一允許的值是 Microsoft-Windows-Shell-Setup。 |
Diagnostics |
指定開機診斷設定狀態。 |
Diff |
指定作業系統磁碟的暫時磁碟設定。 |
Diff |
指定作業系統磁碟的暫時磁碟位置。 這個屬性可由要求中的使用者用來選擇位置,也就是快取磁碟或暫時OS磁碟布建的資源磁碟空間。 如需暫時 OS 磁碟大小需求的詳細資訊,請參閱 Windows VM 的 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements 暫時 OS 磁碟大小需求,以及位於的 Linux VM https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements |
Diff |
描述可針對操作系統磁碟指定之暫時磁碟設定的參數。 |
Disk |
指定虛擬機的建立方式。 |
Disk |
描述可針對磁碟指定的客戶受控磁碟加密集資源標識符參數。 |
Image |
指定要使用之映像的相關信息。 您可以指定平臺映像、Marketplace 映像或虛擬機映射的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但不會用於其他建立作業時,需要此元素。 注意:映像參考發行者和供應專案只能在您建立擴展集時設定。 |
In |
指定對 IaaS 虛擬機進行客體修補的模式。 |
IPVersion |
從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 |
Linux |
指定虛擬機上的Linux作業系統設定。 |
Operating |
osDiskImage 的操作系統。 |
Pass |
傳遞名稱。 目前唯一允許的值是 OobeSystem。 |
Patch |
|
Plan |
指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站 中,尋找您想要使用的 Marketplace 映射,然後按兩下 [想要以程式設計方式部署],[開始使用] -> 。 輸入任何必要資訊,然後按兩下 [ 儲存]。 |
Protocol |
指定 WinRM 接聽程式的通訊協定。 |
Resource |
用於虛擬機的身分識別類型。 「SystemAssigned、UserAssigned」類型同時包含隱含建立的身分識別,和一組使用者指派的身分識別。 類型 『None』 會從虛擬機中移除任何身分識別。 |
Rolling |
執行滾動升級時所使用的組態參數。 |
Scale |
描述虛擬機擴展集的相應縮小原則。 |
Scheduled |
|
Security |
指定虛擬機或虛擬機擴展集的安全性配置檔設定。 |
Setting |
指定要套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。 |
Sku |
描述虛擬機擴展集 SKU。 注意:如果擴展集目前所在的硬體不支援新的 VM SKU,您必須先解除分配擴展集中的 VM,才能修改 SKU 名稱。 |
Ssh |
在 Azure 上執行的 Linux 型 VM SSH 組態 |
Ssh |
包含 SSH 憑證公鑰的相關信息,以及放置公鑰之 Linux VM 上的路徑。 |
Storage |
指定受控磁碟的記憶體帳戶類型。 只有在建立擴展集時,才能設定受控 OS 磁碟記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,它不能與OS磁碟搭配使用。 |
Sub |
|
Terminate |
|
Upgrade |
指定升級至擴展集中虛擬機的模式。 |
Upgrade |
描述升級原則 - 自動、手動或滾動。 |
User |
與虛擬機相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
Vault |
描述 金鑰保存庫 中的單一憑證參考,以及憑證應該位於 VM 上的位置。 |
Vault |
描述一組憑證,這些憑證全都在相同的 金鑰保存庫 中。 |
Virtual |
描述磁碟的 URI。 |
Virtual |
指定 Azure Spot 虛擬機和 Azure Spot 擴展集的收回原則。 |
Virtual |
指定虛擬機的優先順序。 |
Virtual |
描述虛擬機擴展集。 |
Virtual |
描述虛擬機擴展集數據磁碟。 |
Virtual |
描述虛擬機擴展集擴充功能。 |
Virtual |
描述虛擬機擴展集擴充配置檔。 |
Virtual |
虛擬機擴展集的身分識別。 |
Virtual |
描述虛擬機擴展集網路配置檔的IP組態。 |
Virtual |
包含與公用IP位址相關聯的IP標記。 |
Virtual |
列出虛擬機作業回應。 |
Virtual |
描述 ScaleSet 受控磁碟的參數。 |
Virtual |
描述虛擬機擴展集網路配置檔的網路組態。 |
Virtual |
描述虛擬機擴展集網路設定的 DNS 設定。 |
Virtual |
描述虛擬機擴展集網路配置檔。 |
Virtual |
描述虛擬機擴展集作業系統磁碟。 |
Virtual |
描述虛擬機擴展集 OS 配置檔。 |
Virtual |
描述虛擬機擴展集IP組態的PublicIPAddress設定 |
Virtual |
描述虛擬機擴展集網路設定的 DNS 設定。 |
Virtual |
調整虛擬機擴展集時要遵循的規則。 |
Virtual |
描述虛擬機擴展集記憶體配置檔。 |
Virtual |
描述虛擬機擴展集虛擬機配置檔。 |
Windows |
指定虛擬機器上的 Windows 作業系統設定。 |
Win |
描述 VM 的 Windows 遠端管理設定 |
Win |
描述 Windows 遠端管理接聽程式的通訊協議和指紋 |
啟用或停用虛擬機或虛擬機擴展集上的功能。
名稱 | 類型 | Description |
---|---|---|
ultraSSDEnabled |
boolean |
旗標,可啟用或停用在 VM 或 VMSS 上具有一或多個具有 UltraSSD_LRS記憶體帳戶類型的受控數據磁碟。 只有啟用此屬性時,才能將具有記憶體帳戶類型的受控磁碟UltraSSD_LRS新增至虛擬機或虛擬機擴展集。 |
指定 Windows 安裝程式所使用的 Unattend.xml 檔案中可包含的其他 XML 格式資訊。 內容是透過設定名稱、元件名稱和套用內容的傳遞來定義。
名稱 | 類型 | Description |
---|---|---|
componentName |
元件名稱。 目前唯一允許的值是 Microsoft-Windows-Shell-Setup。 |
|
content |
string |
針對指定的路徑和元件,指定新增至 unattend.xml 檔案的 XML 格式化內容。 XML 必須小於 4KB,而且必須包含要插入之設定或功能的根元素。 |
passName |
傳遞名稱。 目前唯一允許的值是 OobeSystem。 |
|
settingName |
指定要套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。 |
API 實體參考。
名稱 | 類型 | Description |
---|---|---|
id |
string |
/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... 形式的 ARM 資源標識符 |
用於執行自動OS升級的組態參數。
名稱 | 類型 | Description |
---|---|---|
disableAutomaticRollback |
boolean |
是否應該停用OS映像復原功能。 預設值為 False。 |
enableAutomaticOSUpgrade |
boolean |
指出當較新版本的OS映像可用時,是否應該以滾動方式自動套用OS升級至擴展集實例。 預設值為 False。 |
指定虛擬機擴展集上自動修復的組態參數。
名稱 | 類型 | Description |
---|---|---|
enabled |
boolean |
指定是否應在虛擬機擴展集上啟用自動修復。 預設值為 false。 |
gracePeriod |
string |
因為 VM 上的狀態變更而暫停自動修復的時間量。 寬限時間會在狀態變更完成之後開始。 這有助於避免提前或意外修復。 時間持續時間應以 ISO 8601 格式指定。 允許的寬限期下限為 30 分鐘 (PT30M) ,這也是預設值。 允許的寬限期上限為 90 分鐘, (PT90M) 。 |
指定 Azure Spot VM 或 VMSS 的計費相關詳細數據。
API 版本下限:2019-03-01。
名稱 | 類型 | Description |
---|---|---|
maxPrice |
number |
指定您願意支付 Azure Spot VM/VMSS 的最大價格。 此價格以美元為單位。 |
開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照以診斷 VM 狀態。
您可以輕鬆地檢視主控台記錄檔的輸出。
Azure 也可讓您從 Hypervisor 查看 VM 的螢幕快照。
名稱 | 類型 | Description |
---|---|---|
enabled |
boolean |
是否應在虛擬機上啟用開機診斷。 |
storageUri |
string |
用來放置主控台輸出和螢幕快照的記憶體帳戶 URI。 |
指定快取需求。
可能的值包括:
無
ReadOnly
讀寫
預設值: 標準記憶體無 。 進階記憶體的 ReadOnly。
名稱 | 類型 | Description |
---|---|---|
None |
string |
|
ReadOnly |
string |
|
ReadWrite |
string |
元件名稱。 目前唯一允許的值是 Microsoft-Windows-Shell-Setup。
名稱 | 類型 | Description |
---|---|---|
Microsoft-Windows-Shell-Setup |
string |
指定開機診斷設定狀態。
API 版本下限:2015-06-15。
名稱 | 類型 | Description |
---|---|---|
bootDiagnostics |
開機診斷是一項偵錯功能,可讓您檢視控制台輸出和螢幕快照以診斷 VM 狀態。 |
指定作業系統磁碟的暫時磁碟設定。
名稱 | 類型 | Description |
---|---|---|
Local |
string |
指定作業系統磁碟的暫時磁碟位置。 這個屬性可由要求中的使用者用來選擇位置,也就是快取磁碟或暫時OS磁碟布建的資源磁碟空間。 如需暫時 OS 磁碟大小需求的詳細資訊,請參閱 Windows VM 的 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements 暫時 OS 磁碟大小需求,以及位於的 Linux VM https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements
名稱 | 類型 | Description |
---|---|---|
CacheDisk |
string |
|
ResourceDisk |
string |
描述可針對操作系統磁碟指定之暫時磁碟設定的參數。
注意:暫時磁碟設定只能針對受控磁碟指定。
名稱 | 類型 | Description |
---|---|---|
option |
指定作業系統磁碟的暫時磁碟設定。 |
|
placement |
指定作業系統磁碟的暫時磁碟位置。 |
指定虛擬機的建立方式。
可能的值包括:
附加 \u2013 當您使用特製化磁碟來建立虛擬機時,會使用此值。
FromImage \u2013 當您使用映射來建立虛擬機時,會使用此值。 如果您使用平臺映像,則也會使用上述的 imageReference 元素。 如果您使用市集映射,您也會使用先前所述的 plan 元素。
名稱 | 類型 | Description |
---|---|---|
Attach |
string |
|
Empty |
string |
|
FromImage |
string |
描述可針對磁碟指定的客戶受控磁碟加密集資源標識符參數。
注意:磁碟加密集資源標識碼只能針對受控磁碟指定。 如需詳細資訊,請參閱 https://aka.ms/mdssewithcmkoverview 。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼 |
指定要使用之映像的相關信息。 您可以指定平臺映像、Marketplace 映像或虛擬機映射的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但不會用於其他建立作業時,需要此元素。 注意:映像參考發行者和供應專案只能在您建立擴展集時設定。
名稱 | 類型 | Description |
---|---|---|
exactVersion |
string |
以十進位數指定,也就是用來建立虛擬機的平臺映像或市集映射版本。 這個只讀欄位與 'version' 不同,只有在 'version' 字段中指定的值為 'latest' 時。 |
id |
string |
資源標識碼 |
offer |
string |
指定用來建立虛擬機的平臺映像或市集映像供應專案。 |
publisher |
string |
映像發行者。 |
sku |
string |
映像 SKU。 |
version |
string |
指定用來建立虛擬機的平臺映像或 Marketplace 映像版本。 允許的格式為 Major.Minor.Build 或 'latest'。 主要、次要和組建都是十進位數。 指定「最新」以使用部署階段可用的最新映像版本。 即使您使用「最新」,即使有新版本可供使用,VM 映像也不會在部署時間之後自動更新。 |
指定對 IaaS 虛擬機進行客體修補的模式。
可能的值包括:
手動 - 您可以控制將修補程式應用程式套用至虛擬機。 您可以在 VM 內手動套用修補程式來執行此動作。 在此模式中,自動更新會停用;屬性 WindowsConfiguration.enableAutomaticUpdates 必須為 false
AutomaticByOS - 作業系統會自動更新虛擬機。 WindowsConfiguration.enableAutomaticUpdates 屬性必須是 true。
AutomaticByPlatform - 虛擬機將會由平台自動更新。 provisionVMAgent 和 WindowsConfiguration.enableAutomaticUpdates 屬性必須是 true
名稱 | 類型 | Description |
---|---|---|
AutomaticByOS |
string |
|
AutomaticByPlatform |
string |
|
Manual |
string |
從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。
名稱 | 類型 | Description |
---|---|---|
IPv4 |
string |
|
IPv6 |
string |
指定虛擬機上的Linux作業系統設定。
如需支援的Linux發行版清單,請參閱 linux on Azure-Endorsed Distributions
如需執行非背書散發套件,請參閱 非背書散發套件的資訊。
名稱 | 類型 | Description |
---|---|---|
disablePasswordAuthentication |
boolean |
指定是否應該停用密碼驗證。 |
provisionVMAgent |
boolean |
指出是否應該在虛擬機器上佈建虛擬機器代理程式。 |
ssh |
指定 Linux OS 的 SSH 金鑰組態。 |
osDiskImage 的操作系統。
名稱 | 類型 | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
傳遞名稱。 目前唯一允許的值是 OobeSystem。
名稱 | 類型 | Description |
---|---|---|
OobeSystem |
string |
名稱 | 類型 | Description |
---|---|---|
patchMode |
指定對 IaaS 虛擬機進行客體內修補的模式。 |
指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站 中,尋找您想要使用的 Marketplace 映射,然後按兩下 [想要以程式設計方式部署],[開始使用] -> 。 輸入任何必要資訊,然後按兩下 [ 儲存]。
名稱 | 類型 | Description |
---|---|---|
name |
string |
方案標識碼。 |
product |
string |
指定市集中映像的產品。 這個值與 imageReference 元素下的 Offer 相同。 |
promotionCode |
string |
促銷碼。 |
publisher |
string |
發行者標識碼。 |
指定 WinRM 接聽程式的通訊協定。
可能的值包括:
http
https
名稱 | 類型 | Description |
---|---|---|
Http |
string |
|
Https |
string |
用於虛擬機的身分識別類型。 「SystemAssigned、UserAssigned」類型同時包含隱含建立的身分識別,和一組使用者指派的身分識別。 類型 『None』 會從虛擬機中移除任何身分識別。
名稱 | 類型 | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
SystemAssigned, UserAssigned |
string |
|
UserAssigned |
string |
執行滾動升級時所使用的組態參數。
名稱 | 類型 | Description |
---|---|---|
maxBatchInstancePercent |
integer |
一個批次中滾動升級同時升級的虛擬機實例總數百分比上限。 由於這是最大,先前或未來批次中狀況不良的實例可能會導致批次中的實例百分比降低,以確保更高的可靠性。 此參數的預設值為 20%。 |
maxUnhealthyInstancePercent |
integer |
擴展集中可同時狀況不良之虛擬機實例總數的百分比上限,可能是因為升級而發生,或是在輪流升級中止之前,在虛擬機健康情況檢查處於狀況不良狀態時找到。 啟動任何批次之前,將會先檢查此條件約束。 此參數的預設值為 20%。 |
maxUnhealthyUpgradedInstancePercent |
integer |
可發現處於狀況不良狀態的升級虛擬機實例百分比上限。 升級每個批次之後,就會進行這項檢查。 如果超過此百分比,滾動更新就會中止。 此參數的預設值為 20%。 |
pauseTimeBetweenBatches |
string |
完成一個批次中所有虛擬機的更新和啟動下一個批次之間的等候時間。 時間持續時間應以 ISO 8601 格式指定。 默認值為 0 秒, (PT0S) 。 |
描述虛擬機擴展集的相應縮小原則。
名稱 | 類型 | Description |
---|---|---|
rules |
調整虛擬機擴展集時所要遵循的規則。 |
名稱 | 類型 | Description |
---|---|---|
terminateNotificationProfile |
指定終止排程事件相關組態。 |
指定虛擬機或虛擬機擴展集的安全性配置檔設定。
名稱 | 類型 | Description |
---|---|---|
encryptionAtHost |
boolean |
用戶可以在要求中使用此屬性,以啟用或停用虛擬機或虛擬機擴展集的主機加密。 這會啟用所有磁碟的加密,包括主機本身的資源/暫存磁碟。 |
指定要套用內容之設定的名稱。 可能的值為:FirstLogonCommands 和 AutoLogon。
名稱 | 類型 | Description |
---|---|---|
AutoLogon |
string |
|
FirstLogonCommands |
string |
描述虛擬機擴展集 SKU。 注意:如果擴展集目前所在的硬體不支援新的 VM SKU,您必須先解除分配擴展集中的 VM,才能修改 SKU 名稱。
名稱 | 類型 | Description |
---|---|---|
capacity |
integer |
指定擴展集中的虛擬機數目。 |
name |
string |
SKU 名稱。 |
tier |
string |
指定擴展集中的虛擬機層。 |
在 Azure 上執行的 Linux 型 VM SSH 組態
名稱 | 類型 | Description |
---|---|---|
publicKeys |
用來向Linux型VM進行驗證的SSH公鑰清單。 |
包含 SSH 憑證公鑰的相關信息,以及放置公鑰之 Linux VM 上的路徑。
名稱 | 類型 | Description |
---|---|---|
keyData |
string |
用來透過 ssh 向 VM 進行驗證的 SSH 公鑰憑證。 密鑰至少必須是 2048 位,且以 ssh-rsa 格式表示。 |
path |
string |
指定儲存 ssh 公鑰之已建立 VM 上的完整路徑。 如果檔案已經存在,指定的金鑰就會附加至該檔案。 範例:/home/user/.ssh/authorized_keys |
指定受控磁碟的記憶體帳戶類型。 只有在建立擴展集時,才能設定受控 OS 磁碟記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,它不能與OS磁碟搭配使用。
名稱 | 類型 | Description |
---|---|---|
Premium_LRS |
string |
|
StandardSSD_LRS |
string |
|
Standard_LRS |
string |
|
UltraSSD_LRS |
string |
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼 |
名稱 | 類型 | Description |
---|---|---|
enable |
boolean |
指定是否啟用或停用 Terminate Scheduled 事件。 |
notBeforeTimeout |
string |
刪除虛擬機的可設定時間長度,在自動核准事件之前,虛擬機必須核准終止排程事件, (逾時) 。 設定必須以 ISO 8601 格式指定,預設值為 5 分鐘, (PT5M) |
指定升級至擴展集中虛擬機的模式。
可能的值包括:
手動 - 您可以控制擴充集中虛擬機更新的應用程式。 您可以使用 manualUpgrade 動作來執行此動作。
自動 -擴展集中的所有虛擬機都會同時自動更新。
名稱 | 類型 | Description |
---|---|---|
Automatic |
string |
|
Manual |
string |
|
Rolling |
string |
描述升級原則 - 自動、手動或滾動。
名稱 | 類型 | Description |
---|---|---|
automaticOSUpgradePolicy |
用於執行自動OS升級的組態參數。 |
|
mode |
指定升級至擴展集中虛擬機的模式。 |
|
rollingUpgradePolicy |
執行滾動升級時所使用的組態參數。 |
與虛擬機相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。
名稱 | 類型 | Description |
---|---|---|
|
描述 金鑰保存庫 中的單一憑證參考,以及憑證應該位於 VM 上的位置。
名稱 | 類型 | Description |
---|---|---|
certificateStore |
string |
針對 Windows VM,指定應該新增憑證之虛擬機上的證書存儲。 指定的證書存儲隱含地位於LocalMachine帳戶中。 |
certificateUrl |
string |
這是已上傳至 金鑰保存庫 作為秘密之憑證的 URL。 如需將秘密新增至 金鑰保存庫,請參閱將密鑰或秘密新增至密鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼方式,此物件是以 UTF-8 編碼: |
描述一組憑證,這些憑證全都在相同的 金鑰保存庫 中。
名稱 | 類型 | Description |
---|---|---|
sourceVault |
包含 VaultCertificates 中所有憑證之 金鑰保存庫 的相對 URL。 |
|
vaultCertificates |
SourceVault 中包含憑證的金鑰保存庫參考清單。 |
描述磁碟的 URI。
名稱 | 類型 | Description |
---|---|---|
uri |
string |
指定虛擬硬碟的 URI。 |
指定 Azure Spot 虛擬機和 Azure Spot 擴展集的收回原則。
針對 Azure Spot 虛擬機,支援「解除分配」和「刪除」,而最低 API 版本為 2019-03-01。
針對 Azure Spot 擴展集,同時支援 'Deallocate' 和 'Delete',而最低 API 版本為 2017-10-30-preview。
名稱 | 類型 | Description |
---|---|---|
Deallocate |
string |
|
Delete |
string |
指定虛擬機的優先順序。
最低 api-version:2019-03-01
名稱 | 類型 | Description |
---|---|---|
Low |
string |
|
Regular |
string |
|
Spot |
string |
描述虛擬機擴展集。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼 |
identity |
如果已設定,則為虛擬機擴展集的身分識別。 |
|
location |
string |
資源位置 |
name |
string |
資源名稱 |
plan |
指定用來建立虛擬機之 Marketplace 映像的相關信息。 此元素僅用於市集映像。 您必須先啟用映像以程序設計方式使用,才能從 API 使用市集映射。 在 Azure 入口網站 中,尋找您想要使用的 Marketplace 映射,然後按兩下 [想要以程式設計方式部署],[開始使用] -> 。 輸入任何必要資訊,然後按兩下 [ 儲存]。 |
|
properties.additionalCapabilities |
指定虛擬機擴展集中 虛擬機器 上啟用或停用的其他功能。 例如:虛擬機器 是否能夠支援使用UltraSSD_LRS記憶體帳戶類型鏈接受控數據磁碟。 |
|
properties.automaticRepairsPolicy |
自動修復的原則。 |
|
properties.doNotRunExtensionsOnOverprovisionedVMs |
boolean |
啟用 Overprovision 時,擴充功能只會在最後保留的要求 VM 數目上啟動。 因此,此屬性可確保擴充功能不會在額外的過度布建 VM 上執行。 |
properties.hostGroup |
指定虛擬機擴展集所在專用主機群組的相關信息。 |
|
properties.overprovision |
boolean |
指定是否應該過度布建虛擬機擴展集。 |
properties.platformFaultDomainCount |
integer |
每個放置群組的容錯網域計數。 |
properties.provisioningState |
string |
布建狀態,只會出現在回應中。 |
properties.proximityPlacementGroup |
指定虛擬機擴展集應指派的鄰近放置群組相關信息。 |
|
properties.scaleInPolicy |
指定相應縮小原則,決定在虛擬機擴展集相應縮小時要移除的虛擬機。 |
|
properties.singlePlacementGroup |
boolean |
若為 true,則會將擴展集限制為單一放置群組,大小上限為 100 部虛擬機。 注意:如果 singlePlacementGroup 為 true,它可能會修改為 false。 不過,如果 singlePlacementGroup 為 false,則無法修改成 true。 |
properties.uniqueId |
string |
指定可唯一識別虛擬機擴展集的標識碼。 |
properties.upgradePolicy |
升級原則。 |
|
properties.virtualMachineProfile |
虛擬機器配置檔。 |
|
properties.zoneBalance |
boolean |
如果發生區域中斷,是否要強制甚至跨 x 區域的虛擬機散發。 |
sku |
虛擬機擴展集 SKU。 |
|
tags |
object |
資源標籤 |
type |
string |
資源類型 |
zones |
string[] |
虛擬機擴展集區域。 注意:只有在建立擴展集時,才能設定可用性區域 |
描述虛擬機擴展集數據磁碟。
名稱 | 類型 | Description |
---|---|---|
caching |
指定快取需求。 |
|
createOption |
create 選項。 |
|
diskIOPSReadWrite |
integer |
指定受控磁碟的 Read-Write IOPS。 只有當 StorageAccountType 是UltraSSD_LRS時,才應該使用。 如果未指定,則會根據diskSizeGB指派預設值。 |
diskMBpsReadWrite |
integer |
指定受控磁碟的每秒 MB 頻寬。 只有當 StorageAccountType 是UltraSSD_LRS時,才應該使用。 如果未指定,則會根據diskSizeGB指派預設值。 |
diskSizeGB |
integer |
指定以 GB 為單位的空白資料磁碟大小。 此元素可用來覆寫虛擬機映像中的磁碟大小。 |
lun |
integer |
指定數據磁碟的邏輯單元編號。 這個值是用來識別 VM 內的數據磁碟,因此對於連結至 VM 的每個數據磁碟都必須是唯一的。 |
managedDisk |
受控磁碟參數。 |
|
name |
string |
磁碟名稱。 |
writeAcceleratorEnabled |
boolean |
指定是否應該在磁碟上啟用或停用 writeAccelerator。 |
描述虛擬機擴展集擴充功能。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼 |
name |
string |
延伸模組的名稱。 |
properties.autoUpgradeMinorVersion |
boolean |
指出擴充功能是否應該在部署期間使用較新的次要版本。 不過,部署之後,除非重新部署延伸模組,否則延伸模組將不會升級次要版本,即使此屬性設定為 true 亦然。 |
properties.enableAutomaticUpgrade |
boolean |
指出如果有較新版本的擴充功能可用,平臺是否應該自動升級延伸模組。 |
properties.forceUpdateTag |
string |
如果提供值且與先前的值不同,即使延伸模組組態尚未變更,擴充處理程式仍會強制更新。 |
properties.protectedSettings |
object |
延伸模組可以包含 protectedSettings 或 protectedSettingsFromKeyVault,或完全不包含受保護的設定。 |
properties.provisionAfterExtensions |
string[] |
延伸模組名稱的集合,之後必須布建此延伸模組。 |
properties.provisioningState |
string |
布建狀態,只會出現在回應中。 |
properties.publisher |
string |
擴充處理程序發行者的名稱。 |
properties.settings |
object |
延伸模組的 Json 格式化公用設定。 |
properties.type |
string |
指定延伸模組的類型;例如“CustomScriptExtension”。 |
properties.typeHandlerVersion |
string |
指定文稿處理程式的版本。 |
type |
string |
資源類型 |
描述虛擬機擴展集擴充配置檔。
名稱 | 類型 | Description |
---|---|---|
extensions |
虛擬機擴展集子擴充功能資源。 |
|
extensionsTimeBudget |
string |
指定要啟動之所有延伸模組加上批注的時間。 持續時間應介於 15 分鐘到 120 分鐘之間, (包含) ,且應以 ISO 8601 格式指定。 預設值為90分鐘 (PT1H30M) 。 |
虛擬機擴展集的身分識別。
名稱 | 類型 | Description |
---|---|---|
principalId |
string |
虛擬機擴展集身分識別的主體標識碼。 此屬性只會針對系統指派的身分識別提供。 |
tenantId |
string |
與虛擬機擴展集相關聯的租用戶標識碼。 此屬性只會針對系統指派的身分識別提供。 |
type |
用於虛擬機擴展集的身分識別類型。 「SystemAssigned、UserAssigned」類型同時包含隱含建立的身分識別,和一組使用者指派的身分識別。 類型 『None』 會從虛擬機擴展集移除任何身分識別。 |
|
userAssignedIdentities |
與虛擬機擴展集相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。 |
描述虛擬機擴展集網路配置檔的IP組態。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼 |
name |
string |
IP 組態名稱。 |
properties.applicationGatewayBackendAddressPools |
指定應用程式閘道後端位址池的參考數位。 擴展集可以參考多個應用程式閘道的後端位址池。 多個擴展集無法使用相同的應用程式閘道。 |
|
properties.applicationSecurityGroups |
指定應用程式安全組的參考陣列。 |
|
properties.loadBalancerBackendAddressPools |
指定負載平衡器後端位址池參考的陣列。 擴展集可以參考一個公用和一個內部負載平衡器的後端位址池。 多個擴展集無法使用相同的基本 SKU 負載平衡器。 |
|
properties.loadBalancerInboundNatPools |
指定負載平衡器輸入 Nat 集區的參考陣列。 擴展集可以參考一個公用和一個內部負載平衡器的輸入 nat 集區。 多個擴展集無法使用相同的基本 SKU 負載平衡器。 |
|
properties.primary |
boolean |
指定虛擬機有1個以上的網路介面時的主要網路介面。 |
properties.privateIPAddressVersion |
從 Api-Version 2017-03-30 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 |
|
properties.publicIPAddressConfiguration |
publicIPAddressConfiguration。 |
|
properties.subnet |
指定子網的識別碼。 |
包含與公用IP位址相關聯的IP標記。
名稱 | 類型 | Description |
---|---|---|
ipTagType |
string |
IP 標籤類型。 範例:FirstPartyUsage。 |
tag |
string |
與公用IP相關聯的IP標籤。 範例:SQL、記憶體等。 |
列出虛擬機作業回應。
名稱 | 類型 | Description |
---|---|---|
nextLink |
string |
要擷取下一頁的 uri 虛擬機器擴展集。 使用此呼叫 ListNext () 以擷取 VMSS 的下一頁。 |
value |
虛擬機擴展集的清單。 |
描述 ScaleSet 受控磁碟的參數。
名稱 | 類型 | Description |
---|---|---|
diskEncryptionSet |
指定受控磁碟的客戶受控磁碟加密集資源標識符。 |
|
storageAccountType |
指定受控磁碟的記憶體帳戶類型。 注意:UltraSSD_LRS只能與數據磁碟搭配使用,它不能與OS磁碟搭配使用。 |
描述虛擬機擴展集網路配置檔的網路組態。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源標識碼 |
name |
string |
網路組態名稱。 |
properties.dnsSettings |
要套用在網路介面上的 DNS 設定。 |
|
properties.enableAcceleratedNetworking |
boolean |
指定網路介面是否已啟用加速網路。 |
properties.enableFpga |
boolean |
指定網路介面是否已啟用 FPGA 網路功能。 |
properties.enableIPForwarding |
boolean |
是否在此 NIC 上啟用 IP 轉送。 |
properties.ipConfigurations |
指定網路介面的IP組態。 |
|
properties.networkSecurityGroup |
網路安全組。 |
|
properties.primary |
boolean |
指定虛擬機有1個以上的網路介面時的主要網路介面。 |
描述虛擬機擴展集網路設定的 DNS 設定。
名稱 | 類型 | Description |
---|---|---|
dnsServers |
string[] |
DNS 伺服器 IP 位址清單 |
描述虛擬機擴展集網路配置檔。
名稱 | 類型 | Description |
---|---|---|
healthProbe |
負載平衡器探查的參考,用來判斷虛擬機擴展集中實例的健康情況。 參考的格式為:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/loadBalancers/{loadBalancerName}/probes/{probeName}'。 |
|
networkInterfaceConfigurations |
網路組態的清單。 |
描述虛擬機擴展集作業系統磁碟。
名稱 | 類型 | Description |
---|---|---|
caching |
指定快取需求。 |
|
createOption |
指定應如何建立擴展集中的虛擬機。 |
|
diffDiskSettings |
指定虛擬機擴展集所使用作業系統磁碟的暫時磁碟設定。 |
|
diskSizeGB |
integer |
指定以 GB 為單位的作業系統磁碟大小。 此元素可用來覆寫虛擬機映像中的磁碟大小。 |
image |
指定要根據擴展集之非受控使用者映像的資訊。 |
|
managedDisk |
受控磁碟參數。 |
|
name |
string |
磁碟名稱。 |
osType |
此屬性可讓您指定從使用者映像或特製化 VHD 建立 VM 時,磁碟包含的 OS 類型。 |
|
vhdContainers |
string[] |
指定用來儲存擴展集作業系統磁碟的容器 URL。 |
writeAcceleratorEnabled |
boolean |
指定是否應該在磁碟上啟用或停用 writeAccelerator。 |
描述虛擬機擴展集 OS 配置檔。
名稱 | 類型 | Description |
---|---|---|
adminPassword |
string |
指定系統管理員帳戶的密碼。 |
adminUsername |
string |
指定系統管理員帳戶的名稱。 |
computerNamePrefix |
string |
指定擴展集中所有虛擬機的計算機名稱前置詞。 計算機名稱前置詞長度必須為1到15個字元。 |
customData |
string |
指定自訂資料的 Base-64 編碼字串。 Base-64 編碼字串會解碼成二進位陣列而儲存為虛擬機器上的檔案。 二進位陣列的長度上限是 65535 個位元組。 |
linuxConfiguration |
指定虛擬機上的Linux作業系統設定。 |
|
secrets |
指定應該安裝在擴展集中虛擬機上的憑證集。 |
|
windowsConfiguration |
指定虛擬機器上的 Windows 作業系統設定。 |
描述虛擬機擴展集IP組態的PublicIPAddress設定
名稱 | 類型 | Description |
---|---|---|
name |
string |
publicIP 位址組態名稱。 |
properties.dnsSettings |
Virtual |
要套用至 publicIP 位址的 DNS 設定。 |
properties.idleTimeoutInMinutes |
integer |
公用IP位址的閒置逾時。 |
properties.ipTags |
與公用IP位址相關聯的IP標籤清單。 |
|
properties.publicIPAddressVersion |
從 Api-Version 2019-07-01 起提供,它代表特定 ipconfiguration 是 IPv4 或 IPv6。 預設值會視為 IPv4。 可能的值為:'IPv4' 和 'IPv6'。 |
|
properties.publicIPPrefix |
要從中配置 publicIP 位址的 PublicIPPrefix。 |
描述虛擬機擴展集網路設定的 DNS 設定。
名稱 | 類型 | Description |
---|---|---|
domainNameLabel |
string |
功能變數名稱標籤。功能變數名稱標籤和 vm 索引的串連將會是將建立之 PublicIPAddress 資源的功能變數名稱標籤 |
調整虛擬機擴展集時要遵循的規則。
可能的值包括:
預設 當虛擬機擴展集相應縮小時,如果擴展集是區域性擴展集,則擴展集會先跨區域平衡。 然後,它將會盡可能跨容錯網域進行平衡。 在每個容錯網域內,選擇移除的虛擬機將會是不受相應縮小保護的最新虛擬機。
OldestVM 當虛擬機擴展集進行相應縮小時,將會選擇未受相應縮小保護的最舊虛擬機進行移除。 針對區域性虛擬機擴展集,擴展集會先跨區域平衡。 在每個區域內,將會選擇未受保護的最舊虛擬機來移除。
NewestVM 當虛擬機擴展集正在相應縮小時,系統會選擇未受相應縮小保護的最新虛擬機,以移除。 針對區域性虛擬機擴展集,擴展集會先跨區域平衡。 在每個區域中,將會選擇未受保護的最新虛擬機來移除。
名稱 | 類型 | Description |
---|---|---|
Default |
string |
|
NewestVM |
string |
|
OldestVM |
string |
描述虛擬機擴展集記憶體配置檔。
名稱 | 類型 | Description |
---|---|---|
dataDisks |
指定參數,用來將數據磁碟新增至擴展集中的虛擬機。 |
|
imageReference |
指定要使用之映像的相關信息。 您可以指定平臺映像、市集映像或虛擬機映像的相關信息。 當您想要使用平臺映像、市集映像或虛擬機映像,但不會用於其他建立作業時,需要此元素。 |
|
osDisk |
指定擴展集中虛擬機所使用的操作系統磁碟相關信息。 |
描述虛擬機擴展集虛擬機配置檔。
名稱 | 類型 | Description |
---|---|---|
billingProfile |
指定 Azure Spot VMSS 的計費相關詳細數據。 |
|
diagnosticsProfile |
指定開機診斷設定狀態。 |
|
evictionPolicy |
指定 Azure Spot 虛擬機和 Azure Spot 擴展集的收回原則。 |
|
extensionProfile |
指定擴展集中虛擬機上安裝之延伸模組的設定集合。 |
|
licenseType |
string |
指定正在使用的映像或磁碟是內部部署授權的。 |
networkProfile |
指定擴展集中虛擬機網路介面的屬性。 |
|
osProfile |
指定擴展集中虛擬機的作業系統設定。 |
|
priority |
指定擴展集中虛擬機的優先順序。 |
|
scheduledEventsProfile |
指定排程的事件相關組態。 |
|
securityProfile |
指定擴展集中虛擬機的安全性相關配置檔設定。 |
|
storageProfile |
指定虛擬機器磁碟的儲存體設定。 |
指定虛擬機器上的 Windows 作業系統設定。
名稱 | 類型 | Description |
---|---|---|
additionalUnattendContent |
指定可併入 Unattend.xml 檔案 (由 Windows 安裝程式使用) 的額外 Base-64 編碼 XML 格式資訊。 |
|
enableAutomaticUpdates |
boolean |
指出是否為 Windows 虛擬機啟用自動 匯報。 預設值為 true。 |
patchSettings |
指定與客體內修補 (KB) 相關的設定。 |
|
provisionVMAgent |
boolean |
指出是否應該在虛擬機器上佈建虛擬機器代理程式。 |
timeZone |
string |
指定虛擬機的時區。 例如“Pacific Standard Time”。 |
winRM |
指定 Windows 遠端管理接聽程式。 藉此將啟用遠端 Windows PowerShell。 |
描述 VM 的 Windows 遠端管理設定
名稱 | 類型 | Description |
---|---|---|
listeners |
Windows 遠端管理接聽程式清單 |
描述 Windows 遠端管理接聽程式的通訊協議和指紋
名稱 | 類型 | Description |
---|---|---|
certificateUrl |
string |
這是已上傳至 金鑰保存庫 做為秘密之憑證的 URL。 如需將秘密新增至 金鑰保存庫,請參閱將密鑰或秘密新增至密鑰保存庫。 在此情況下,您的憑證必須是下列 JSON 物件的 Base64 編碼,其編碼方式為 UTF-8: |
protocol |
指定 WinRM 接聽程式的通訊協定。 |