Dela via


Update Runs - Put

Placera uppdateringskörningar för en angiven uppdatering

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

URI-parametrar

Name I Obligatorisk Typ Description
clusterName
path True

string

Namnet på klustret.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
path True

string

minLength: 1

ID för målprenumerationen.

updateName
path True

string

Namnet på uppdateringen

updateRunName
path True

string

Namnet på uppdateringskörningen

api-version
query True

string

minLength: 1

DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name Typ Description
location

string

Den geo-plats där resursen finns

properties.duration

string

Varaktighet för uppdateringskörningen.

properties.lastUpdatedTime

string (date-time)

Tidsstämpel för det senast slutförda steget i uppdateringskörningen.

properties.progress.description

string

Mer detaljerad beskrivning av steget.

properties.progress.endTimeUtc

string (date-time)

När steget nådde ett terminaltillstånd.

properties.progress.errorMessage

string

Felmeddelande, som anges om steget är i ett feltillstånd.

properties.progress.expectedExecutionTime

string

Förväntad körningstid för ett visst steg. Detta kan också skrivas i åtgärdsplanen för uppdatering och kan vara tomt.

properties.progress.lastUpdatedTimeUtc

string (date-time)

Slutförandetid för det här steget eller det senaste slutförda understeget.

properties.progress.name

string

Namnet på steget.

properties.progress.startTimeUtc

string (date-time)

När steget startade eller tomt om det inte har börjat köras.

properties.progress.status

string

Status för steget, bubblade upp från ECE-åtgärdsplanen för installationsförsök. Värdena är: "Success", "Error", "InProgress" och "Unknown status".

properties.progress.steps

Step[]

Rekursiv modell för underordnade steg i det här steget.

properties.state

updateRunPropertiesState

Status för uppdateringskörningen.

properties.timeStarted

string (date-time)

Tidsstämpeln för uppdateringskörningen startades.

Svar

Name Typ Description
200 OK

UpdateRun

OKEJ

Other Status Codes

ErrorResponse

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Get Update runs under cluster resource

Exempelbegäran

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

Exempelsvar

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

Definitioner

Name Description
createdByType

Den typ av identitet som skapade resursen.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

ProvisioningState

Etableringstillstånd för proxyresursen UpdateRuns.

Step

Förloppsrepresentation av uppdateringskörningsstegen.

systemData

Metadata som rör skapande och senaste ändring av resursen.

UpdateRun

Information om en uppdateringskörning

updateRunPropertiesState

Status för uppdateringskörningen.

createdByType

Den typ av identitet som skapade resursen.

Värde Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Ytterligare informationstyp.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

ProvisioningState

Etableringstillstånd för proxyresursen UpdateRuns.

Värde Description
Succeeded
Failed
Canceled
Accepted
Provisioning

Step

Förloppsrepresentation av uppdateringskörningsstegen.

Name Typ Description
description

string

Mer detaljerad beskrivning av steget.

endTimeUtc

string (date-time)

När steget nådde ett terminaltillstånd.

errorMessage

string

Felmeddelande, som anges om steget är i ett feltillstånd.

expectedExecutionTime

string

Förväntad körningstid för ett visst steg. Detta kan också skrivas i åtgärdsplanen för uppdatering och kan vara tomt.

lastUpdatedTimeUtc

string (date-time)

Slutförandetid för det här steget eller det senaste slutförda understeget.

name

string

Namnet på steget.

startTimeUtc

string (date-time)

När steget startade eller tomt om det inte har börjat köras.

status

string

Status för steget, bubblade upp från ECE-åtgärdsplanen för installationsförsök. Värdena är: "Success", "Error", "InProgress" och "Unknown status".

steps

Step[]

Rekursiv modell för underordnade steg i det här steget.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string (date-time)

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string (date-time)

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.

UpdateRun

Information om en uppdateringskörning

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Den geo-plats där resursen finns

name

string

Namnet på resursen

properties.duration

string

Varaktighet för uppdateringskörningen.

properties.lastUpdatedTime

string (date-time)

Tidsstämpel för det senast slutförda steget i uppdateringskörningen.

properties.progress.description

string

Mer detaljerad beskrivning av steget.

properties.progress.endTimeUtc

string (date-time)

När steget nådde ett terminaltillstånd.

properties.progress.errorMessage

string

Felmeddelande, som anges om steget är i ett feltillstånd.

properties.progress.expectedExecutionTime

string

Förväntad körningstid för ett visst steg. Detta kan också skrivas i åtgärdsplanen för uppdatering och kan vara tomt.

properties.progress.lastUpdatedTimeUtc

string (date-time)

Slutförandetid för det här steget eller det senaste slutförda understeget.

properties.progress.name

string

Namnet på steget.

properties.progress.startTimeUtc

string (date-time)

När steget startade eller tomt om det inte har börjat köras.

properties.progress.status

string

Status för steget, bubblade upp från ECE-åtgärdsplanen för installationsförsök. Värdena är: "Success", "Error", "InProgress" och "Unknown status".

properties.progress.steps

Step[]

Rekursiv modell för underordnade steg i det här steget.

properties.provisioningState

ProvisioningState

Etableringstillstånd för proxyresursen UpdateRuns.

properties.state

updateRunPropertiesState

Status för uppdateringskörningen.

properties.timeStarted

string (date-time)

Tidsstämpeln för uppdateringskörningen startades.

systemData

systemData

Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

updateRunPropertiesState

Status för uppdateringskörningen.

Värde Description
Unknown
Succeeded
InProgress
Failed