Update Runs - Put
Размещение запусков обновления для указанного обновления
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}/updateRuns/{updateRunName}?api-version=2024-04-01
Параметры URI
| Имя | В | Обязательно | Тип | Описание |
|---|---|---|---|---|
|
cluster
|
path | True |
string |
Имя кластера. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Имя группы ресурсов. Имя не учитывает регистр. |
|
subscription
|
path | True |
string minLength: 1 |
Идентификатор целевой подписки. |
|
update
|
path | True |
string |
Имя обновления |
|
update
|
path | True |
string |
Имя запуска обновления |
|
api-version
|
query | True |
string minLength: 1 |
Версия API, используемая для этой операции. |
Текст запроса
| Имя | Тип | Описание |
|---|---|---|
| location |
string |
Географическое расположение, в котором находится ресурс |
| properties.duration |
string |
Длительность выполнения обновления. |
| properties.lastUpdatedTime |
string (date-time) |
Метка времени последнего завершенного шага в запуске обновления. |
| properties.progress.description |
string |
Более подробное описание шага. |
| properties.progress.endTimeUtc |
string (date-time) |
Когда шаг достиг состояния терминала. |
| properties.progress.errorMessage |
string |
Сообщение об ошибке, указанное, если шаг находится в состоянии сбоя. |
| properties.progress.expectedExecutionTime |
string |
Ожидаемое время выполнения заданного шага. Это необязательно создано в плане действий обновления и может быть пустым. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Время завершения этого шага или последнего завершенного подшагового шага. |
| properties.progress.name |
string |
Имя шага. |
| properties.progress.startTimeUtc |
string (date-time) |
Когда шаг запущен или пуст, если он не начал выполняться. |
| properties.progress.status |
string |
Состояние шага, перемыкающееся из плана действий ПО ДЛЯ установки. Значения: "Success", "Error", "InProgress" и "Неизвестно состояние". |
| properties.progress.steps |
Step[] |
Рекурсивная модель для дочерних шагов этого шага. |
| properties.state |
Состояние выполнения обновления. |
|
| properties.timeStarted |
string (date-time) |
Была запущена метка времени запуска обновления. |
Ответы
| Имя | Тип | Описание |
|---|---|---|
| 200 OK |
ХОРОШО |
|
| Other Status Codes |
Ответ на ошибку, описывающий причину сбоя операции. |
Безопасность
azure_auth
Поток OAuth2 Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
| Имя | Описание |
|---|---|
| user_impersonation | олицетворения учетной записи пользователя |
Примеры
Get Update runs under cluster resource
Образец запроса
PUT https://management.azure.com/subscriptions/b8d594e5-51f3-4c11-9c54-a7771b81c712/resourceGroups/testrg/providers/Microsoft.AzureStackHCI/clusters/testcluster/updates/Microsoft4.2203.2.32/updateRuns/23b779ba-0d52-4a80-8571-45ca74664ec3?api-version=2024-04-01
{
"properties": {
"progress": {
"name": "Unnamed step",
"description": "Update Azure Stack.",
"errorMessage": "",
"status": "Success",
"startTimeUtc": "2022-04-06T01:36:33.3876751+00:00",
"endTimeUtc": "2022-04-06T13:58:42.969006+00:00",
"lastUpdatedTimeUtc": "2022-04-06T13:58:42.969006+00:00",
"steps": [
{
"name": "PreUpdate Cloud",
"description": "Prepare for SSU update",
"errorMessage": "",
"status": "Success",
"startTimeUtc": "2022-04-06T01:36:33.3876751+00:00",
"endTimeUtc": "2022-04-06T01:37:16.8728314+00:00",
"lastUpdatedTimeUtc": "2022-04-06T01:37:16.8728314+00:00",
"steps": []
}
]
}
}
}
Пример ответа
{
"id": "/subscriptions/b8d594e5-51f3-4c11-9c54-a7771b81c712/resourceGroups/testrg/providers/Microsoft.AzureStackHCI/clusters/testcluster/updates/Microsoft4.2203.2.32/updateRuns/23b779ba-0d52-4a80-8571-45ca74664ec3",
"name": "Microsoft4.2203.2.32/23b779ba-0d52-4a80-8571-45ca74664ec3",
"type": "Microsoft.AzureStackHCI/updates/updateRuns",
"location": "West US",
"properties": {
"progress": {
"name": "Unnamed step",
"description": "Update Azure Stack.",
"errorMessage": "",
"status": "Success",
"startTimeUtc": "2022-04-06T01:36:33.3876751+00:00",
"endTimeUtc": "2022-04-06T13:58:42.969006+00:00",
"lastUpdatedTimeUtc": "2022-04-06T13:58:42.969006+00:00",
"steps": [
{
"name": "PreUpdate Cloud",
"description": "Prepare for SSU update",
"errorMessage": "",
"status": "Success",
"startTimeUtc": "2022-04-06T01:36:33.3876751+00:00",
"endTimeUtc": "2022-04-06T01:37:16.8728314+00:00",
"lastUpdatedTimeUtc": "2022-04-06T01:37:16.8728314+00:00",
"steps": []
}
]
}
}
}
Определения
| Имя | Описание |
|---|---|
|
created |
Тип удостоверения, создавшего ресурс. |
|
Error |
Дополнительные сведения об ошибке управления ресурсами. |
|
Error |
Сведения об ошибке. |
|
Error |
Ответ на ошибку |
|
Provisioning |
Состояние подготовки прокси-ресурса UpdateRuns. |
| Step |
Представление шагов выполнения обновления. |
|
system |
Метаданные, относящиеся к созданию и последнему изменении ресурса. |
|
Update |
Сведения о выполнении обновления |
|
update |
Состояние выполнения обновления. |
createdByType
Тип удостоверения, создавшего ресурс.
| Значение | Описание |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
| Имя | Тип | Описание |
|---|---|---|
| info |
object |
Дополнительные сведения. |
| type |
string |
Дополнительный тип сведений. |
ErrorDetail
Сведения об ошибке.
| Имя | Тип | Описание |
|---|---|---|
| additionalInfo |
Дополнительные сведения об ошибке. |
|
| code |
string |
Код ошибки. |
| details |
Сведения об ошибке. |
|
| message |
string |
Сообщение об ошибке. |
| target |
string |
Целевой объект ошибки. |
ErrorResponse
Ответ на ошибку
| Имя | Тип | Описание |
|---|---|---|
| error |
Объект ошибки. |
ProvisioningState
Состояние подготовки прокси-ресурса UpdateRuns.
| Значение | Описание |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Accepted | |
| Provisioning |
Step
Представление шагов выполнения обновления.
| Имя | Тип | Описание |
|---|---|---|
| description |
string |
Более подробное описание шага. |
| endTimeUtc |
string (date-time) |
Когда шаг достиг состояния терминала. |
| errorMessage |
string |
Сообщение об ошибке, указанное, если шаг находится в состоянии сбоя. |
| expectedExecutionTime |
string |
Ожидаемое время выполнения заданного шага. Это необязательно создано в плане действий обновления и может быть пустым. |
| lastUpdatedTimeUtc |
string (date-time) |
Время завершения этого шага или последнего завершенного подшагового шага. |
| name |
string |
Имя шага. |
| startTimeUtc |
string (date-time) |
Когда шаг запущен или пуст, если он не начал выполняться. |
| status |
string |
Состояние шага, перемыкающееся из плана действий ПО ДЛЯ установки. Значения: "Success", "Error", "InProgress" и "Неизвестно состояние". |
| steps |
Step[] |
Рекурсивная модель для дочерних шагов этого шага. |
systemData
Метаданные, относящиеся к созданию и последнему изменении ресурса.
| Имя | Тип | Описание |
|---|---|---|
| createdAt |
string (date-time) |
Метка времени создания ресурса (UTC). |
| createdBy |
string |
Удостоверение, создающее ресурс. |
| createdByType |
Тип удостоверения, создавшего ресурс. |
|
| lastModifiedAt |
string (date-time) |
Метка времени последнего изменения ресурса (UTC) |
| lastModifiedBy |
string |
Идентификатор, который последний раз изменил ресурс. |
| lastModifiedByType |
Тип удостоверения, который последний раз изменил ресурс. |
UpdateRun
Сведения о выполнении обновления
| Имя | Тип | Описание |
|---|---|---|
| id |
string |
Полный идентификатор ресурса для ресурса. Пример - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
| location |
string |
Географическое расположение, в котором находится ресурс |
| name |
string |
Имя ресурса |
| properties.duration |
string |
Длительность выполнения обновления. |
| properties.lastUpdatedTime |
string (date-time) |
Метка времени последнего завершенного шага в запуске обновления. |
| properties.progress.description |
string |
Более подробное описание шага. |
| properties.progress.endTimeUtc |
string (date-time) |
Когда шаг достиг состояния терминала. |
| properties.progress.errorMessage |
string |
Сообщение об ошибке, указанное, если шаг находится в состоянии сбоя. |
| properties.progress.expectedExecutionTime |
string |
Ожидаемое время выполнения заданного шага. Это необязательно создано в плане действий обновления и может быть пустым. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Время завершения этого шага или последнего завершенного подшагового шага. |
| properties.progress.name |
string |
Имя шага. |
| properties.progress.startTimeUtc |
string (date-time) |
Когда шаг запущен или пуст, если он не начал выполняться. |
| properties.progress.status |
string |
Состояние шага, перемыкающееся из плана действий ПО ДЛЯ установки. Значения: "Success", "Error", "InProgress" и "Неизвестно состояние". |
| properties.progress.steps |
Step[] |
Рекурсивная модель для дочерних шагов этого шага. |
| properties.provisioningState |
Состояние подготовки прокси-ресурса UpdateRuns. |
|
| properties.state |
Состояние выполнения обновления. |
|
| properties.timeStarted |
string (date-time) |
Была запущена метка времени запуска обновления. |
| systemData |
Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy. |
|
| type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
updateRunPropertiesState
Состояние выполнения обновления.
| Значение | Описание |
|---|---|
| Unknown | |
| Succeeded | |
| InProgress | |
| Failed |