Compartir a través de


Update Runs - Put

Put Update runs for a specified update (Put Update runs for a specified update)

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/clusters/{clusterName}/updates/{updateName}/updateRuns/{updateRunName}?api-version=2024-01-01

Parámetros de identificador URI

Nombre En Requerido Tipo Description
clusterName
path True

string

Nombre del clúster.

resourceGroupName
path True

string

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string

Identificador de la suscripción de destino.

updateName
path True

string

Nombre de la actualización

updateRunName
path True

string

Nombre de la ejecución de actualización

api-version
query True

string

Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre Tipo Description
location

string

Ubicación geográfica donde reside el recurso

properties.duration

string

Duración de la ejecución de la actualización.

properties.lastUpdatedTime

string

Marca de tiempo del paso completado más recientemente en la ejecución de la actualización.

properties.progress.description

string

Descripción más detallada del paso.

properties.progress.endTimeUtc

string

Cuando el paso alcanzó un estado terminal.

properties.progress.errorMessage

string

Mensaje de error, especificado si el paso está en estado de error.

properties.progress.lastUpdatedTimeUtc

string

Hora de finalización de este paso o el último subproceso completado.

properties.progress.name

string

Nombre del paso.

properties.progress.startTimeUtc

string

Cuando se inicia el paso o está vacío si no se ha iniciado la ejecución.

properties.progress.status

string

Estado del paso, se propaga desde el plan de acción ECE para los intentos de instalación. Los valores son: "Correcto", "Error", "InProgress" y "Estado desconocido".

properties.progress.steps

Step[]

Modelo recursivo para los pasos secundarios de este paso.

properties.state

updateRunPropertiesState

Estado de la ejecución de la actualización.

properties.timeStarted

string

Se inició la marca de tiempo de la ejecución de la actualización.

Respuestas

Nombre Tipo Description
200 OK

UpdateRun

Aceptar

Other Status Codes

ErrorResponse

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantación de su cuenta de usuario

Ejemplos

Get Update runs under cluster resource

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
createdByType

Tipo de identidad que creó el recurso.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

ProvisioningState

Estado de aprovisionamiento del recurso de proxy UpdateRuns.

Step

Representación del progreso de los pasos de ejecución de la actualización.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

UpdateRun

Detalles de una ejecución de actualización

updateRunPropertiesState

Estado de la ejecución de la actualización.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ProvisioningState

Estado de aprovisionamiento del recurso de proxy UpdateRuns.

Nombre Tipo Description
Accepted

string

Canceled

string

Failed

string

Provisioning

string

Succeeded

string

Step

Representación del progreso de los pasos de ejecución de la actualización.

Nombre Tipo Description
description

string

Descripción más detallada del paso.

endTimeUtc

string

Cuando el paso alcanzó un estado terminal.

errorMessage

string

Mensaje de error, especificado si el paso está en estado de error.

lastUpdatedTimeUtc

string

Hora de finalización de este paso o el último subproceso completado.

name

string

Nombre del paso.

startTimeUtc

string

Cuando se inicia el paso o está vacío si no se ha iniciado la ejecución.

status

string

Estado del paso, se propaga desde el plan de acción ECE para los intentos de instalación. Los valores son: "Correcto", "Error", "InProgress" y "Estado desconocido".

steps

Step[]

Modelo recursivo para los pasos secundarios de este paso.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

UpdateRun

Detalles de una ejecución de actualización

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso.

properties.duration

string

Duración de la ejecución de la actualización.

properties.lastUpdatedTime

string

Marca de tiempo del paso completado más recientemente en la ejecución de la actualización.

properties.progress.description

string

Descripción más detallada del paso.

properties.progress.endTimeUtc

string

Cuando el paso alcanzó un estado terminal.

properties.progress.errorMessage

string

Mensaje de error, especificado si el paso está en estado de error.

properties.progress.lastUpdatedTimeUtc

string

Hora de finalización de este paso o el último subproceso completado.

properties.progress.name

string

Nombre del paso.

properties.progress.startTimeUtc

string

Cuando se inicia el paso o está vacío si no se ha iniciado la ejecución.

properties.progress.status

string

Estado del paso, se propaga desde el plan de acción ECE para los intentos de instalación. Los valores son: "Correcto", "Error", "InProgress" y "Estado desconocido".

properties.progress.steps

Step[]

Modelo recursivo para los pasos secundarios de este paso.

properties.provisioningState

ProvisioningState

Estado de aprovisionamiento del recurso de proxy UpdateRuns.

properties.state

updateRunPropertiesState

Estado de la ejecución de la actualización.

properties.timeStarted

string

Se inició la marca de tiempo de la ejecución de la actualización.

systemData

systemData

Metadatos de Azure Resource Manager que contienen información sobre los valores de createdBy y modifiedBy.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

updateRunPropertiesState

Estado de la ejecución de la actualización.

Nombre Tipo Description
Failed

string

InProgress

string

Succeeded

string

Unknown

string