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-04-01
Parâmetros de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
cluster
|
path | True |
string |
O nome do cluster. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string minLength: 1 |
A ID da assinatura de destino. |
|
update
|
path | True |
string |
O nome da Atualização |
|
update
|
path | True |
string |
O nome da Execução de Atualização |
|
api-version
|
query | True |
string minLength: 1 |
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 onde o recurso reside |
| properties.duration |
string |
Duração da execução da atualização. |
| properties.lastUpdatedTime |
string (date-time) |
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 (date-time) |
Quando a etapa atingiu um estado terminal. |
| properties.progress.errorMessage |
string |
Mensagem de erro, especificada se a etapa estiver em um estado com falha. |
| properties.progress.expectedExecutionTime |
string |
Tempo de execução esperado de uma determinada etapa. Opcionalmente, isso é criado no plano de ação de atualização e pode estar vazio. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Hora de conclusão desta etapa ou da última sub-etapa concluída. |
| properties.progress.name |
string |
Nome da etapa. |
| properties.progress.startTimeUtc |
string (date-time) |
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: 'Êxito', 'Erro', 'InProgress' e 'Status desconhecido'. |
| properties.progress.steps |
Step[] |
Modelo recursivo para etapas filho desta etapa. |
| properties.state |
Estado da execução da atualização. |
|
| properties.timeStarted |
string (date-time) |
O carimbo de data/hora da execução da atualização foi iniciado. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
OKEY |
|
| Other Status Codes |
Resposta de erro que descreve por que a operação falhou. |
Segurança
azure_auth
Fluxo 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-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": []
}
]
}
}
}
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 |
|---|---|
|
created |
O tipo de identidade que criou o recurso. |
|
Error |
As informações adicionais do erro de gerenciamento de recursos. |
|
Error |
O detalhe do erro. |
|
Error |
Resposta de erro |
|
Provisioning |
Estado de provisionamento do recurso proxy UpdateRuns. |
| Step |
Representação de progresso das etapas de execução de atualização. |
|
system |
Metadados relativos à criação e última modificação do recurso. |
|
Update |
Detalhes de uma execução de atualização |
|
update |
Estado da execução da atualização. |
createdByType
O tipo de identidade que criou o recurso.
| Valor | Description |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
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 |
As informações adicionais do erro. |
|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro. |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro. |
ErrorResponse
Resposta de erro
| Nome | Tipo | Description |
|---|---|---|
| error |
O objeto de erro. |
ProvisioningState
Estado de provisionamento do recurso proxy UpdateRuns.
| Valor | Description |
|---|---|
| Succeeded | |
| Failed | |
| Canceled | |
| Accepted | |
| Provisioning |
Step
Representação de progresso das etapas de execução de atualização.
| Nome | Tipo | Description |
|---|---|---|
| description |
string |
Descrição mais detalhada da etapa. |
| endTimeUtc |
string (date-time) |
Quando a etapa atingiu um estado terminal. |
| errorMessage |
string |
Mensagem de erro, especificada se a etapa estiver em um estado com falha. |
| expectedExecutionTime |
string |
Tempo de execução esperado de uma determinada etapa. Opcionalmente, isso é criado no plano de ação de atualização e pode estar vazio. |
| lastUpdatedTimeUtc |
string (date-time) |
Hora de conclusão desta etapa ou da última sub-etapa concluída. |
| name |
string |
Nome da etapa. |
| startTimeUtc |
string (date-time) |
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: 'Êxito', 'Erro', 'InProgress' e 'Status desconhecido'. |
| 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 (date-time) |
O carimbo de data/hora da criação de recursos (UTC). |
| createdBy |
string |
A identidade que criou o recurso. |
| createdByType |
O tipo de identidade que criou o recurso. |
|
| lastModifiedAt |
string (date-time) |
O carimbo de data/hora da última modificação do recurso (UTC) |
| lastModifiedBy |
string |
A identidade que modificou o recurso pela última vez. |
| lastModifiedByType |
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 onde o recurso reside |
| name |
string |
O nome do recurso |
| properties.duration |
string |
Duração da execução da atualização. |
| properties.lastUpdatedTime |
string (date-time) |
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 (date-time) |
Quando a etapa atingiu um estado terminal. |
| properties.progress.errorMessage |
string |
Mensagem de erro, especificada se a etapa estiver em um estado com falha. |
| properties.progress.expectedExecutionTime |
string |
Tempo de execução esperado de uma determinada etapa. Opcionalmente, isso é criado no plano de ação de atualização e pode estar vazio. |
| properties.progress.lastUpdatedTimeUtc |
string (date-time) |
Hora de conclusão desta etapa ou da última sub-etapa concluída. |
| properties.progress.name |
string |
Nome da etapa. |
| properties.progress.startTimeUtc |
string (date-time) |
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: 'Êxito', 'Erro', 'InProgress' e 'Status desconhecido'. |
| properties.progress.steps |
Step[] |
Modelo recursivo para etapas filho desta etapa. |
| properties.provisioningState |
Estado de provisionamento do recurso proxy UpdateRuns. |
|
| properties.state |
Estado da execução da atualização. |
|
| properties.timeStarted |
string (date-time) |
O carimbo de data/hora da execução da atualização foi iniciado. |
| systemData |
Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy. |
|
| type |
string |
O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts" |
updateRunPropertiesState
Estado da execução da atualização.
| Valor | Description |
|---|---|
| Unknown | |
| Succeeded | |
| InProgress | |
| Failed |