Partager via


Update Runs - Put

Placer les exécutions de mise à jour pour une mise à jour spécifiée

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

Paramètres URI

Nom Dans Obligatoire Type Description
clusterName
path True

string

Nom du cluster.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nom du groupe de ressources. Le nom ne respecte pas la casse.

subscriptionId
path True

string

minLength: 1

ID de l’abonnement cible.

updateName
path True

string

Nom de la mise à jour

updateRunName
path True

string

Nom de l’exécution de la mise à jour

api-version
query True

string

minLength: 1

Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom Type Description
location

string

Emplacement géographique où réside la ressource

properties.duration

string

Durée de l’exécution de la mise à jour.

properties.lastUpdatedTime

string (date-time)

Horodatage de l’étape la plus récente terminée dans l’exécution de la mise à jour.

properties.progress.description

string

Description plus détaillée de l’étape.

properties.progress.endTimeUtc

string (date-time)

Lorsque l’étape a atteint un état terminal.

properties.progress.errorMessage

string

Message d’erreur, spécifié si l’étape est dans un état d’échec.

properties.progress.expectedExecutionTime

string

Durée d’exécution attendue d’une étape donnée. Cela est éventuellement créé dans le plan d’action de mise à jour et peut être vide.

properties.progress.lastUpdatedTimeUtc

string (date-time)

Heure d’achèvement de cette étape ou de la dernière sous-étape terminée.

properties.progress.name

string

Nom de l’étape.

properties.progress.startTimeUtc

string (date-time)

Lorsque l’étape a démarré ou est vide si elle n’a pas commencé à s’exécuter.

properties.progress.status

string

État de l’étape, en bulles à partir du plan d’action DE la COMMISSION pour les tentatives d’installation. Les valeurs sont : « Réussite », « Erreur », « InProgress » et « État inconnu ».

properties.progress.steps

Step[]

Modèle récursif pour les étapes enfants de cette étape.

properties.state

updateRunPropertiesState

État de l’exécution de la mise à jour.

properties.timeStarted

string (date-time)

L’horodatage de l’exécution de la mise à jour a été démarré.

Réponses

Nom Type Description
200 OK

UpdateRun

D’ACCORD

Other Status Codes

ErrorResponse

Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation emprunter l’identité de votre compte d’utilisateur

Exemples

Get Update runs under cluster resource

Exemple de requête

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

Exemple de réponse

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

Définitions

Nom Description
createdByType

Type d’identité qui a créé la ressource.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

ProvisioningState

État d’approvisionnement de la ressource proxy UpdateRuns.

Step

Représentation de progression des étapes d’exécution de mise à jour.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

UpdateRun

Détails d’une exécution de mise à jour

updateRunPropertiesState

État de l’exécution de la mise à jour.

createdByType

Type d’identité qui a créé la ressource.

Valeur Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ProvisioningState

État d’approvisionnement de la ressource proxy UpdateRuns.

Valeur Description
Succeeded
Failed
Canceled
Accepted
Provisioning

Step

Représentation de progression des étapes d’exécution de mise à jour.

Nom Type Description
description

string

Description plus détaillée de l’étape.

endTimeUtc

string (date-time)

Lorsque l’étape a atteint un état terminal.

errorMessage

string

Message d’erreur, spécifié si l’étape est dans un état d’échec.

expectedExecutionTime

string

Durée d’exécution attendue d’une étape donnée. Cela est éventuellement créé dans le plan d’action de mise à jour et peut être vide.

lastUpdatedTimeUtc

string (date-time)

Heure d’achèvement de cette étape ou de la dernière sous-étape terminée.

name

string

Nom de l’étape.

startTimeUtc

string (date-time)

Lorsque l’étape a démarré ou est vide si elle n’a pas commencé à s’exécuter.

status

string

État de l’étape, en bulles à partir du plan d’action DE la COMMISSION pour les tentatives d’installation. Les valeurs sont : « Réussite », « Erreur », « InProgress » et « État inconnu ».

steps

Step[]

Modèle récursif pour les étapes enfants de cette étape.

systemData

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom Type Description
createdAt

string (date-time)

Horodatage de la création de ressources (UTC).

createdBy

string

Identité qui a créé la ressource.

createdByType

createdByType

Type d’identité qui a créé la ressource.

lastModifiedAt

string (date-time)

Horodatage de la dernière modification de ressource (UTC)

lastModifiedBy

string

Identité qui a modifié la ressource pour la dernière fois.

lastModifiedByType

createdByType

Type d’identité qui a modifié la ressource pour la dernière fois.

UpdateRun

Détails d’une exécution de mise à jour

Nom Type Description
id

string

ID de ressource complet pour la ressource. ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

location

string

Emplacement géographique où réside la ressource

name

string

Nom de la ressource

properties.duration

string

Durée de l’exécution de la mise à jour.

properties.lastUpdatedTime

string (date-time)

Horodatage de l’étape la plus récente terminée dans l’exécution de la mise à jour.

properties.progress.description

string

Description plus détaillée de l’étape.

properties.progress.endTimeUtc

string (date-time)

Lorsque l’étape a atteint un état terminal.

properties.progress.errorMessage

string

Message d’erreur, spécifié si l’étape est dans un état d’échec.

properties.progress.expectedExecutionTime

string

Durée d’exécution attendue d’une étape donnée. Cela est éventuellement créé dans le plan d’action de mise à jour et peut être vide.

properties.progress.lastUpdatedTimeUtc

string (date-time)

Heure d’achèvement de cette étape ou de la dernière sous-étape terminée.

properties.progress.name

string

Nom de l’étape.

properties.progress.startTimeUtc

string (date-time)

Lorsque l’étape a démarré ou est vide si elle n’a pas commencé à s’exécuter.

properties.progress.status

string

État de l’étape, en bulles à partir du plan d’action DE la COMMISSION pour les tentatives d’installation. Les valeurs sont : « Réussite », « Erreur », « InProgress » et « État inconnu ».

properties.progress.steps

Step[]

Modèle récursif pour les étapes enfants de cette étape.

properties.provisioningState

ProvisioningState

État d’approvisionnement de la ressource proxy UpdateRuns.

properties.state

updateRunPropertiesState

État de l’exécution de la mise à jour.

properties.timeStarted

string (date-time)

L’horodatage de l’exécution de la mise à jour a été démarré.

systemData

systemData

Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.

type

string

Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

updateRunPropertiesState

État de l’exécution de la mise à jour.

Valeur Description
Unknown
Succeeded
InProgress
Failed