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 |
|---|---|---|---|---|
|
cluster
|
path | True |
string |
Nom du cluster. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nom du groupe de ressources. Le nom ne respecte pas la casse. |
|
subscription
|
path | True |
string minLength: 1 |
ID de l’abonnement cible. |
|
update
|
path | True |
string |
Nom de la mise à jour |
|
update
|
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 |
É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 |
D’ACCORD |
|
| Other Status Codes |
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 |
|---|---|
|
created |
Type d’identité qui a créé la ressource. |
|
Error |
Informations supplémentaires sur l’erreur de gestion des ressources. |
|
Error |
Détail de l’erreur. |
|
Error |
Réponse d’erreur |
|
Provisioning |
État d’approvisionnement de la ressource proxy UpdateRuns. |
| Step |
Représentation de progression des étapes d’exécution de mise à jour. |
|
system |
Métadonnées relatives à la création et à la dernière modification de la ressource. |
|
Update |
Détails d’une exécution de mise à jour |
|
update |
É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 |
Informations supplémentaires sur l’erreur. |
|
| code |
string |
Code d’erreur. |
| details |
Détails de l’erreur. |
|
| message |
string |
Message d’erreur. |
| target |
string |
Cible d’erreur. |
ErrorResponse
Réponse d’erreur
| Nom | Type | Description |
|---|---|---|
| error |
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 |
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 |
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 |
État d’approvisionnement de la ressource proxy UpdateRuns. |
|
| properties.state |
É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 |
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 |