Apply Updates - Create Or Update Or Cancel
將 匯報 套用至資源
將維護更新套用至資源
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/{providerName}/{resourceType}/{resourceName}/providers/Microsoft.Maintenance/applyUpdates/{applyUpdateName}?api-version=2023-09-01-preview
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
apply
|
path | True |
string |
ApplyUpdate 名稱 |
provider
|
path | True |
string |
資源提供者名稱 |
resource
|
path | True |
string |
資源群組名稱 |
resource
|
path | True |
string |
資源標識碼 |
resource
|
path | True |
string |
資源類型 |
subscription
|
path | True |
string |
可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。 訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。 |
api-version
|
query | True |
string |
要與用戶端要求搭配使用的 API 版本。 |
要求本文
名稱 | 類型 | Description |
---|---|---|
properties.lastUpdateTime |
string |
上次更新時間 |
properties.resourceId |
string |
resourceId |
properties.status |
狀態 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
已接受ApplyUpdate更新要求 |
|
201 Created |
ApplyUpdate 建立已接受要求 |
|
Other Status Codes |
BadRequest |
範例
Apply |
Apply |
ApplyUpdates_CreateOrUpdateOnly_NoCancellation
範例要求
範例回覆
{
"id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/providers/Microsoft.Maintenance/applyUpdates/e9b9685d-78e4-44c4-a81c-64a14f9b87b6",
"name": "e9b9685d-78e4-44c4-a81c-64a14f9b87b6",
"type": "Microsoft.Maintenance/applyUpdates",
"properties": {
"resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1",
"status": "Pending"
}
}
{
"id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1/providers/Microsoft.Maintenance/applyUpdates/e9b9685d-78e4-44c4-a81c-64a14f9b87b6",
"name": "e9b9685d-78e4-44c4-a81c-64a14f9b87b6",
"type": "Microsoft.Maintenance/applyUpdates",
"properties": {
"resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Compute/virtualMachineScaleSets/smdtest1",
"status": "Pending"
}
}
ApplyUpdates_CreateOrUpdateOrCancel
範例要求
PUT https://management.azure.com/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/Microsoft.Maintenance/maintenanceConfigurations/maintenanceConfig1/providers/Microsoft.Maintenance/applyUpdates/20230901121200?api-version=2023-09-01-preview
{
"properties": {
"status": "Cancel"
}
}
範例回覆
{
"id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/microsoft.maintenance/maintenanceconfigurations/maintenanceconfig1/providers/microsoft.maintenance/applyupdates/20230901121200",
"name": "maintenanceConfig1",
"type": "Microsoft.Maintenance/applyUpdates",
"properties": {
"status": "Cancelled",
"resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/microsoft.maintenance/maintenanceconfigurations/maintenanceconfig1"
}
}
{
"id": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/microsoft.maintenance/maintenanceconfigurations/maintenanceconfig1/providers/microsoft.maintenance/applyupdates/20230901121200",
"name": "maintenanceConfig1",
"type": "Microsoft.Maintenance/applyUpdates",
"properties": {
"status": "Cancelled",
"resourceId": "/subscriptions/5b4b650e-28b9-4790-b3ab-ddbd88d727c4/resourcegroups/examplerg/providers/microsoft.maintenance/maintenanceconfigurations/maintenanceconfig1"
}
}
定義
名稱 | Description |
---|---|
Apply |
套用更新要求 |
created |
建立資源的身分識別類型。 |
Error |
從 Azure 維護服務收到的錯誤回應詳細數據。 |
Maintenance |
從 Azure 維護服務收到的錯誤回應。 |
system |
與建立和上次修改資源相關的元數據。 |
Update |
狀態 |
ApplyUpdate
套用更新要求
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源的完整識別碼 |
name |
string |
資源名稱 |
properties.lastUpdateTime |
string |
上次更新時間 |
properties.resourceId |
string |
resourceId |
properties.status |
狀態 |
|
systemData |
Azure Resource Manager 包含 createdBy 和 modifiedBy 資訊的中繼資料。 |
|
type |
string |
資源的類型 |
createdByType
建立資源的身分識別類型。
名稱 | 類型 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
ErrorDetails
從 Azure 維護服務收到的錯誤回應詳細數據。
名稱 | 類型 | Description |
---|---|---|
code |
string |
服務定義的錯誤碼。 此代碼會作為回應中指定之 HTTP 錯誤碼的子狀態。 |
message |
string |
人類可閱讀的錯誤表示法。 |
MaintenanceError
從 Azure 維護服務收到的錯誤回應。
名稱 | 類型 | Description |
---|---|---|
error |
錯誤的詳細數據 |
systemData
與建立和上次修改資源相關的元數據。
名稱 | 類型 | Description |
---|---|---|
createdAt |
string |
資源建立的時間戳 (UTC) 。 |
createdBy |
string |
建立資源的身分識別。 |
createdByType |
建立資源的身分識別類型。 |
|
lastModifiedAt |
string |
上次修改的資源時間戳 (UTC) |
lastModifiedBy |
string |
上次修改資源的身分識別。 |
lastModifiedByType |
上次修改資源的身分識別類型。 |
UpdateStatus
狀態
名稱 | 類型 | Description |
---|---|---|
Cancel |
string |
取消排程,並停止為其部分的資源建立 PMR。 僅適用於維護組態資源類型。 |
Cancelled |
string |
如果要求是取消排程,請將已取消的回應傳送給使用者。 僅適用於維護組態資源類型。 |
Completed |
string |
已成功套用所有更新。 |
InProgress |
string |
匯報 安裝正在進行中。 |
NoUpdatesPending |
string |
沒有擱置中的更新。 |
Pending |
string |
安裝擱置中的更新。 |
RetryLater |
string |
匯報 安裝失敗,稍後應該重試。 |
RetryNow |
string |
匯報 安裝失敗,但已準備好再次重試。 |