Delen via


Update Runs - Put

Updateuitvoeringen voor een opgegeven update plaatsen

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

URI-parameters

Name In Vereist Type Description
clusterName
path True

string

De naam van het cluster.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.

subscriptionId
path True

string

minLength: 1

De id van het doelabonnement.

updateName
path True

string

De naam van de update

updateRunName
path True

string

De naam van de updateuitvoering

api-version
query True

string

minLength: 1

De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name Type Description
location

string

De geografische locatie waar de resource zich bevindt

properties.duration

string

Duur van de updateuitvoering.

properties.lastUpdatedTime

string (date-time)

Tijdstempel van de laatst voltooide stap in de updateuitvoering.

properties.progress.description

string

Gedetailleerdere beschrijving van de stap.

properties.progress.endTimeUtc

string (date-time)

Wanneer de stap een terminalstatus heeft bereikt.

properties.progress.errorMessage

string

Foutbericht, opgegeven als de stap de status Mislukt heeft.

properties.progress.expectedExecutionTime

string

Verwachte uitvoeringstijd van een bepaalde stap. Dit is optioneel geschreven in het actieplan voor updates en kan leeg zijn.

properties.progress.lastUpdatedTimeUtc

string (date-time)

Voltooiingstijd van deze stap of de laatste voltooide substap.

properties.progress.name

string

Naam van de stap.

properties.progress.startTimeUtc

string (date-time)

Wanneer de stap is gestart of leeg is als deze nog niet is gestart.

properties.progress.status

string

Status van de stap, opgebeld vanuit het ECE-actieplan voor installatiepogingen. Waarden zijn: 'Success', 'Error', 'InProgress' en 'Unknown status'.

properties.progress.steps

Step[]

Recursief model voor onderliggende stappen van deze stap.

properties.state

updateRunPropertiesState

Status van de updateuitvoering.

properties.timeStarted

string (date-time)

De tijdstempel van de updateuitvoering is gestart.

Antwoorden

Name Type Description
200 OK

UpdateRun

OK

Other Status Codes

ErrorResponse

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Get Update runs under cluster resource

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
createdByType

Het type identiteit waarmee de resource is gemaakt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

ProvisioningState

Inrichtingsstatus van de UpdateRuns-proxyresource.

Step

Voortgangsweergave van de updateuitvoeringsstappen.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

UpdateRun

Details van een updateuitvoering

updateRunPropertiesState

Status van de updateuitvoering.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Waarde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het extra informatietype.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ProvisioningState

Inrichtingsstatus van de UpdateRuns-proxyresource.

Waarde Description
Succeeded
Failed
Canceled
Accepted
Provisioning

Step

Voortgangsweergave van de updateuitvoeringsstappen.

Name Type Description
description

string

Gedetailleerdere beschrijving van de stap.

endTimeUtc

string (date-time)

Wanneer de stap een terminalstatus heeft bereikt.

errorMessage

string

Foutbericht, opgegeven als de stap de status Mislukt heeft.

expectedExecutionTime

string

Verwachte uitvoeringstijd van een bepaalde stap. Dit is optioneel geschreven in het actieplan voor updates en kan leeg zijn.

lastUpdatedTimeUtc

string (date-time)

Voltooiingstijd van deze stap of de laatste voltooide substap.

name

string

Naam van de stap.

startTimeUtc

string (date-time)

Wanneer de stap is gestart of leeg is als deze nog niet is gestart.

status

string

Status van de stap, opgebeld vanuit het ECE-actieplan voor installatiepogingen. Waarden zijn: 'Success', 'Error', 'InProgress' en 'Unknown status'.

steps

Step[]

Recursief model voor onderliggende stappen van deze stap.

systemData

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name Type Description
createdAt

string (date-time)

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit waarmee de resource is gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string (date-time)

De tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource voor het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UpdateRun

Details van een updateuitvoering

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.duration

string

Duur van de updateuitvoering.

properties.lastUpdatedTime

string (date-time)

Tijdstempel van de laatst voltooide stap in de updateuitvoering.

properties.progress.description

string

Gedetailleerdere beschrijving van de stap.

properties.progress.endTimeUtc

string (date-time)

Wanneer de stap een terminalstatus heeft bereikt.

properties.progress.errorMessage

string

Foutbericht, opgegeven als de stap de status Mislukt heeft.

properties.progress.expectedExecutionTime

string

Verwachte uitvoeringstijd van een bepaalde stap. Dit is optioneel geschreven in het actieplan voor updates en kan leeg zijn.

properties.progress.lastUpdatedTimeUtc

string (date-time)

Voltooiingstijd van deze stap of de laatste voltooide substap.

properties.progress.name

string

Naam van de stap.

properties.progress.startTimeUtc

string (date-time)

Wanneer de stap is gestart of leeg is als deze nog niet is gestart.

properties.progress.status

string

Status van de stap, opgebeld vanuit het ECE-actieplan voor installatiepogingen. Waarden zijn: 'Success', 'Error', 'InProgress' en 'Unknown status'.

properties.progress.steps

Step[]

Recursief model voor onderliggende stappen van deze stap.

properties.provisioningState

ProvisioningState

Inrichtingsstatus van de UpdateRuns-proxyresource.

properties.state

updateRunPropertiesState

Status van de updateuitvoering.

properties.timeStarted

string (date-time)

De tijdstempel van de updateuitvoering is gestart.

systemData

systemData

Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

updateRunPropertiesState

Status van de updateuitvoering.

Waarde Description
Unknown
Succeeded
InProgress
Failed