Delen via


Update Runs - Put

Update-uitvoeringen 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-01-01

URI-parameters

Name In Vereist Type Description
clusterName
path True

string

De naam van het cluster.

resourceGroupName
path True

string

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

subscriptionId
path True

string

De id van het doelabonnement.

updateName
path True

string

De naam van de update

updateRunName
path True

string

De naam van de update-uitvoering

api-version
query True

string

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 update-uitvoering.

properties.lastUpdatedTime

string

Tijdstempel van de laatst voltooide stap in de update-uitvoering.

properties.progress.description

string

Meer gedetailleerde beschrijving van de stap.

properties.progress.endTimeUtc

string

Wanneer de stap een terminalstatus heeft bereikt.

properties.progress.errorMessage

string

Foutbericht, opgegeven als de stap de status Mislukt heeft.

properties.progress.lastUpdatedTimeUtc

string

Voltooiingstijd van deze stap of de laatste voltooide substap.

properties.progress.name

string

Naam van de stap.

properties.progress.startTimeUtc

string

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

properties.progress.status

string

Status van de stap, opgebeld uit 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 update-uitvoering.

properties.timeStarted

string

Tijdstempel van de update-uitvoering 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-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": []
        }
      ]
    }
  }
}

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 proxyresource UpdateRuns.

Step

Voortgangsweergave van de stappen voor het uitvoeren van updates.

systemData

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

UpdateRun

Details van een update-uitvoering

updateRunPropertiesState

Status van de update-uitvoering.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

Aanvullende informatie over de fout.

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 proxyresource UpdateRuns.

Name Type Description
Accepted

string

Canceled

string

Failed

string

Provisioning

string

Succeeded

string

Step

Voortgangsweergave van de stappen voor het uitvoeren van updates.

Name Type Description
description

string

Meer gedetailleerde beschrijving van de stap.

endTimeUtc

string

Wanneer de stap een terminalstatus heeft bereikt.

errorMessage

string

Foutbericht, opgegeven als de stap de status Mislukt heeft.

lastUpdatedTimeUtc

string

Voltooiingstijd van deze stap of de laatste voltooide substap.

name

string

Naam van de stap.

startTimeUtc

string

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

status

string

Status van de stap, opgebeld uit 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 laatste wijzigen van de resource.

Name Type Description
createdAt

string

Het 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

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

lastModifiedBy

string

De identiteit die de resource het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.

UpdateRun

Details van een update-uitvoering

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Ex - /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 update-uitvoering.

properties.lastUpdatedTime

string

Tijdstempel van de laatst voltooide stap in de update-uitvoering.

properties.progress.description

string

Meer gedetailleerde beschrijving van de stap.

properties.progress.endTimeUtc

string

Wanneer de stap een terminalstatus heeft bereikt.

properties.progress.errorMessage

string

Foutbericht, opgegeven als de stap de status Mislukt heeft.

properties.progress.lastUpdatedTimeUtc

string

Voltooiingstijd van deze stap of de laatste voltooide substap.

properties.progress.name

string

Naam van de stap.

properties.progress.startTimeUtc

string

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

properties.progress.status

string

Status van de stap, opgebeld uit 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 proxyresource UpdateRuns.

properties.state

updateRunPropertiesState

Status van de update-uitvoering.

properties.timeStarted

string

Tijdstempel van de update-uitvoering is gestart.

systemData

systemData

Azure Resource Manager metagegevens met informatie over createdBy en modifiedBy.

type

string

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

updateRunPropertiesState

Status van de update-uitvoering.

Name Type Description
Failed

string

InProgress

string

Succeeded

string

Unknown

string