Compartilhar via


Update Runs - Put

Colocar execuções de atualização para uma atualização especificada

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 URI

Nome Em Obrigatório Tipo Description
clusterName
path True

string

O nome do cluster.

resourceGroupName
path True

string

O nome do grupo de recursos. O nome diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

A ID da assinatura de destino.

updateName
path True

string

O nome da Atualização

updateRunName
path True

string

O nome da Execução de Atualização

api-version
query True

string

A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome Tipo Description
location

string

A localização geográfica em que o recurso reside

properties.duration

string

Duração da execução da atualização.

properties.lastUpdatedTime

string

Carimbo de data/hora da etapa concluída mais recentemente na execução da atualização.

properties.progress.description

string

Descrição mais detalhada da etapa.

properties.progress.endTimeUtc

string

Quando a etapa atingiu um estado de terminal.

properties.progress.errorMessage

string

Mensagem de erro, especificada se a etapa estiver em um estado de falha.

properties.progress.lastUpdatedTimeUtc

string

Tempo de conclusão desta etapa ou da última sub-etapa concluída.

properties.progress.name

string

Nome da etapa.

properties.progress.startTimeUtc

string

Quando a etapa for iniciada ou vazia, se ela não tiver começado a ser executada.

properties.progress.status

string

Status da etapa, gerado do plano de ação do ECE para tentativas de instalação. Os valores são: 'Success', 'Error', 'InProgress' e 'Unknown status'.

properties.progress.steps

Step[]

Modelo recursivo para etapas filho desta etapa.

properties.state

updateRunPropertiesState

Estado da execução da atualização.

properties.timeStarted

string

O carimbo de data/hora da execução da atualização foi iniciado.

Respostas

Nome Tipo Description
200 OK

UpdateRun

OK

Other Status Codes

ErrorResponse

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

Get Update runs under cluster resource

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
createdByType

O tipo de identidade que criou o recurso.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

ErrorDetail

O detalhe do erro.

ErrorResponse

Resposta de erro

ProvisioningState

Estado de provisionamento do recurso proxy UpdateRuns.

Step

Representação de progresso das etapas de execução da atualização.

systemData

Metadados relativos à criação e à última modificação do recurso.

UpdateRun

Detalhes de uma execução de atualização

updateRunPropertiesState

Estado da execução da atualização.

createdByType

O tipo de identidade que criou o recurso.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.

type

string

O tipo de informação adicional.

ErrorDetail

O detalhe do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.

code

string

O código de erro.

details

ErrorDetail[]

Os detalhes do erro.

message

string

A mensagem de erro.

target

string

O destino do erro.

ErrorResponse

Resposta de erro

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

ProvisioningState

Estado de provisionamento do recurso proxy UpdateRuns.

Nome Tipo Description
Accepted

string

Canceled

string

Failed

string

Provisioning

string

Succeeded

string

Step

Representação de progresso das etapas de execução da atualização.

Nome Tipo Description
description

string

Descrição mais detalhada da etapa.

endTimeUtc

string

Quando a etapa atingiu um estado de terminal.

errorMessage

string

Mensagem de erro, especificada se a etapa estiver em um estado de falha.

lastUpdatedTimeUtc

string

Tempo de conclusão desta etapa ou da última sub-etapa concluída.

name

string

Nome da etapa.

startTimeUtc

string

Quando a etapa for iniciada ou vazia, se ela não tiver começado a ser executada.

status

string

Status da etapa, gerado do plano de ação do ECE para tentativas de instalação. Os valores são: 'Success', 'Error', 'InProgress' e 'Unknown status'.

steps

Step[]

Modelo recursivo para etapas filho desta etapa.

systemData

Metadados relativos à criação e à última modificação do recurso.

Nome Tipo Description
createdAt

string

O carimbo de data/hora da criação de recursos (UTC).

createdBy

string

A identidade que criou o recurso.

createdByType

createdByType

O tipo de identidade que criou o recurso.

lastModifiedAt

string

O carimbo de data/hora da última modificação do recurso (UTC)

lastModifiedBy

string

A identidade que modificou o recurso pela última vez.

lastModifiedByType

createdByType

O tipo de identidade que modificou o recurso pela última vez.

UpdateRun

Detalhes de uma execução de atualização

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

A localização geográfica em que o recurso reside

name

string

O nome do recurso

properties.duration

string

Duração da execução da atualização.

properties.lastUpdatedTime

string

Carimbo de data/hora da etapa concluída mais recentemente na execução da atualização.

properties.progress.description

string

Descrição mais detalhada da etapa.

properties.progress.endTimeUtc

string

Quando a etapa atingiu um estado de terminal.

properties.progress.errorMessage

string

Mensagem de erro, especificada se a etapa estiver em um estado de falha.

properties.progress.lastUpdatedTimeUtc

string

Tempo de conclusão desta etapa ou da última sub-etapa concluída.

properties.progress.name

string

Nome da etapa.

properties.progress.startTimeUtc

string

Quando a etapa for iniciada ou vazia, se ela não tiver começado a ser executada.

properties.progress.status

string

Status da etapa, gerado do plano de ação do ECE para tentativas de instalação. Os valores são: 'Success', 'Error', 'InProgress' e 'Unknown status'.

properties.progress.steps

Step[]

Modelo recursivo para etapas filho desta etapa.

properties.provisioningState

ProvisioningState

Estado de provisionamento do recurso proxy UpdateRuns.

properties.state

updateRunPropertiesState

Estado da execução da atualização.

properties.timeStarted

string

O carimbo de data/hora da execução da atualização foi iniciado.

systemData

systemData

Os metadados do Azure Resource Manager que contêm as informações createdBy e modifiedBy.

type

string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

updateRunPropertiesState

Estado da execução da atualização.

Nome Tipo Description
Failed

string

InProgress

string

Succeeded

string

Unknown

string