你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Machine Extensions - Update
用于创建或更新扩展的操作。
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.HybridCompute/machines/{machineName}/extensions/{extensionName}?api-version=2022-12-27
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
extension
|
path | True |
string |
计算机扩展的名称。 |
machine
|
path | True |
string |
应在其中创建或更新扩展的计算机的名称。 Regex pattern: |
resource
|
path | True |
string |
资源组的名称。 此名称不区分大小写。 |
subscription
|
path | True |
string |
目标订阅的 ID。 |
api-version
|
query | True |
string |
要用于此操作的 API 版本。 |
请求正文
名称 | 类型 | 说明 |
---|---|---|
properties.autoUpgradeMinorVersion |
boolean |
指示扩展是否应使用较新的次要版本(如果在部署时可用)。 但是,部署后,除非重新部署,否则扩展不会升级次要版本,即使此属性设置为 true 也是如此。 |
properties.enableAutomaticUpgrade |
boolean |
指示如果有较新的可用版本,平台是否应自动升级扩展。 |
properties.forceUpdateTag |
string |
如何在扩展配置未更改的情况下强制更新扩展处理程序。 |
properties.protectedSettings |
该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault,或者根本不包含受保护的设置。 |
|
properties.publisher |
string |
扩展处理程序发布者的名称。 |
properties.settings |
扩展的 Json 格式的公共设置。 |
|
properties.type |
string |
指定扩展的类型;例如“CustomScriptExtension”。 |
properties.typeHandlerVersion |
string |
指定脚本处理程序的版本。 |
tags |
object |
资源标记 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 |
|
202 Accepted |
已接受 Headers
|
|
Other Status Codes |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Azure Active Directory OAuth2 流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Create or Update a Machine Extension
Sample Request
PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/machines/myMachine/extensions/CustomScriptExtension?api-version=2022-12-27
{
"properties": {
"publisher": "Microsoft.Compute",
"typeHandlerVersion": "1.10",
"enableAutomaticUpgrade": true,
"type": "CustomScriptExtension",
"settings": {
"commandToExecute": "powershell.exe -c \"Get-Process | Where-Object { $_.CPU -lt 100 }\""
}
}
}
Sample Response
{
"id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.HybridCompute/Machines/myMachine/Extensions/CustomScriptExtension",
"name": "CustomScriptExtension",
"type": "Microsoft.HybridCompute/machines/extensions",
"location": "eastus2euap",
"properties": {
"publisher": "Microsoft.Compute",
"type": "string",
"typeHandlerVersion": "1.10.3",
"enableAutomaticUpgrade": true,
"autoUpgradeMinorVersion": false,
"settings": {
"commandToExecute": "powershell.exe -c \"Get-Process | Where-Object { $_.CPU -gt 10000 }\""
},
"protectedSettings": {},
"provisioningState": "Succeeded",
"instanceView": {
"name": "CustomScriptExtension",
"type": "CustomScriptExtension",
"typeHandlerVersion": "1.10.3",
"status": {
"code": "success",
"level": "Information",
"message": "Finished executing command, StdOut: , StdErr:",
"time": "2020-01-08T20:42:10.999Z"
}
}
}
}
Location: {callbackUrl}
Retry-After: 200
Azure-AsyncOperation: {callbackUri}
定义
名称 | 说明 |
---|---|
created |
创建资源的标识类型。 |
Error |
资源管理错误附加信息。 |
Error |
错误详细信息。 |
Error |
错误响应 |
Machine |
描述计算机扩展。 |
Machine |
介绍计算机扩展实例视图。 |
Machine |
描述计算机扩展的属性。 |
Machine |
描述计算机扩展更新。 |
Status |
实例视图状态。 |
Status |
级别代码。 |
system |
与资源的创建和上次修改相关的元数据。 |
createdByType
创建资源的标识类型。
名称 | 类型 | 说明 |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorResponse
错误响应
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
MachineExtension
描述计算机扩展。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
资源的完全限定的资源 ID。 例如 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
资源所在的地理位置 |
name |
string |
资源的名称 |
properties |
介绍计算机扩展属性。 |
|
systemData |
包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。 |
|
tags |
object |
资源标记。 |
type |
string |
资源类型。 例如“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts” |
MachineExtensionInstanceView
介绍计算机扩展实例视图。
名称 | 类型 | 说明 |
---|---|---|
name |
string |
计算机扩展名称。 |
status |
实例视图状态。 |
|
type |
string |
指定扩展的类型;例如“CustomScriptExtension”。 |
typeHandlerVersion |
string |
指定脚本处理程序的版本。 |
MachineExtensionProperties
描述计算机扩展的属性。
名称 | 类型 | 说明 |
---|---|---|
autoUpgradeMinorVersion |
boolean |
指示扩展是否应使用较新的次要版本(如果在部署时可用)。 但是,部署后,除非重新部署,否则扩展不会升级次要版本,即使此属性设置为 true 也是如此。 |
enableAutomaticUpgrade |
boolean |
指示如果有较新的可用版本,平台是否应自动升级扩展。 |
forceUpdateTag |
string |
如何在扩展配置未更改的情况下强制更新扩展处理程序。 |
instanceView |
计算机扩展实例视图。 |
|
protectedSettings |
该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault,或者根本不包含受保护的设置。 |
|
provisioningState |
string |
预配状态,仅显示在响应中。 |
publisher |
string |
扩展处理程序发布者的名称。 |
settings |
扩展的 Json 格式的公共设置。 |
|
type |
string |
指定扩展的类型;例如“CustomScriptExtension”。 |
typeHandlerVersion |
string |
指定脚本处理程序的版本。 |
MachineExtensionUpdate
描述计算机扩展更新。
名称 | 类型 | 说明 |
---|---|---|
properties.autoUpgradeMinorVersion |
boolean |
指示扩展是否应使用较新的次要版本(如果在部署时可用)。 但是,部署后,除非重新部署,否则扩展不会升级次要版本,即使此属性设置为 true 也是如此。 |
properties.enableAutomaticUpgrade |
boolean |
指示如果有较新的可用版本,平台是否应自动升级扩展。 |
properties.forceUpdateTag |
string |
如何在扩展配置未更改的情况下强制更新扩展处理程序。 |
properties.protectedSettings |
该扩展可以包含 protectedSettings 或 protectedSettingsFromKeyVault,或者根本不包含受保护的设置。 |
|
properties.publisher |
string |
扩展处理程序发布者的名称。 |
properties.settings |
扩展的 Json 格式的公共设置。 |
|
properties.type |
string |
指定扩展的类型;例如“CustomScriptExtension”。 |
properties.typeHandlerVersion |
string |
指定脚本处理程序的版本。 |
tags |
object |
资源标记 |
Status
实例视图状态。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
状态代码。 |
displayStatus |
string |
状态的简短可本地化标签。 |
level |
级别代码。 |
|
message |
string |
详细状态消息,包括警报和错误消息。 |
time |
string |
状态的时间。 |
StatusLevelTypes
级别代码。
名称 | 类型 | 说明 |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
systemData
与资源的创建和上次修改相关的元数据。
名称 | 类型 | 说明 |
---|---|---|
createdAt |
string |
资源创建时间戳 (UTC) 。 |
createdBy |
string |
创建资源的标识。 |
createdByType |
创建资源的标识类型。 |
|
lastModifiedAt |
string |
资源上次修改的时间戳 (UTC) |
lastModifiedBy |
string |
上次修改资源的标识。 |
lastModifiedByType |
上次修改资源的标识类型。 |