Поделиться через


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

Имя В Обязательно Тип Описание
clusterName
path True

string

Имя кластера.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя не учитывает регистр.

subscriptionId
path True

string

minLength: 1

Идентификатор целевой подписки.

updateName
path True

string

Имя обновления

updateRunName
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

updateRunPropertiesState

Состояние выполнения обновления.

properties.timeStarted

string (date-time)

Была запущена метка времени запуска обновления.

Ответы

Имя Тип Описание
200 OK

UpdateRun

ХОРОШО

Other Status Codes

ErrorResponse

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

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": []
        }
      ]
    }
  }
}

Определения

Имя Описание
createdByType

Тип удостоверения, создавшего ресурс.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

ErrorDetail

Сведения об ошибке.

ErrorResponse

Ответ на ошибку

ProvisioningState

Состояние подготовки прокси-ресурса UpdateRuns.

Step

Представление шагов выполнения обновления.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

UpdateRun

Сведения о выполнении обновления

updateRunPropertiesState

Состояние выполнения обновления.

createdByType

Тип удостоверения, создавшего ресурс.

Значение Описание
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.

type

string

Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.

code

string

Код ошибки.

details

ErrorDetail[]

Сведения об ошибке.

message

string

Сообщение об ошибке.

target

string

Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

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

createdByType

Тип удостоверения, создавшего ресурс.

lastModifiedAt

string (date-time)

Метка времени последнего изменения ресурса (UTC)

lastModifiedBy

string

Идентификатор, который последний раз изменил ресурс.

lastModifiedByType

createdByType

Тип удостоверения, который последний раз изменил ресурс.

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

ProvisioningState

Состояние подготовки прокси-ресурса UpdateRuns.

properties.state

updateRunPropertiesState

Состояние выполнения обновления.

properties.timeStarted

string (date-time)

Была запущена метка времени запуска обновления.

systemData

systemData

Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

updateRunPropertiesState

Состояние выполнения обновления.

Значение Описание
Unknown
Succeeded
InProgress
Failed