Experiments - Create Or Update

Référence

Service:: Chaos Studio

Version d'API:: 2025-01-01

Créez ou mettez à jour une ressource d’expérience.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Chaos/experiments/{experimentName}?api-version=2025-01-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
experimentName	path	True	string	Chaîne qui représente un nom de ressource Experiment. Modèle d’expression régulière: `^[^<>%&:?#/\\]+$`
resourceGroupName	path	True	string	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string uuid	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Liste des sélecteurs.
properties.steps	True	ChaosExperimentStep[]	Liste des étapes.
identity		ManagedServiceIdentity	Identités de service managées affectées à cette ressource.
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	Experiment	Opération de mise à jour « Expérience » de ressource réussie
201 Created	Experiment	Opération de création de ressource « Expérience » réussie En-têtes Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

Experiment

Opération de mise à jour « Expérience » de ressource réussie

201 Created

Experiment

Opération de création de ressource « Expérience » réussie

En-têtes

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Réponse d’erreur inattendue.

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

Create/update a Experiment in a resource group.

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment?api-version=2025-01-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "tags": {
    "key7131": "ryohwcoiccwsnewjigfmijz",
    "key2138": "fjaeecgnvqd"
  },
  "location": "eastus2euap",
  "properties": {
    "selectors": [
      {
        "type": "List",
        "id": "selector1",
        "targets": [
          {
            "type": "ChaosTarget",
            "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Compute/virtualMachines/exampleVM/providers/Microsoft.Chaos/targets/Microsoft-VirtualMachine"
          }
        ]
      }
    ],
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "type": "continuous",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ],
                "selectorId": "selector1"
              }
            ]
          }
        ]
      }
    ]
  }
}

Exemple de réponse

Code d’état:: 200

Azure-AsyncOperation: https://management.azure.com/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/myResourceGroup/providers/Microsoft.Chaos/locations/eastus/operationStatus/00000000-0000-0000-0000-000000000000?api-version=2024-11-01-preview
Location: https://management.azure.com/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/myResourceGroup/providers/Microsoft.Chaos/experiments/00000000-0000-0000-0000-000000000000?api-version=2024-11-01-preview

{
  "name": "exampleExperiment",
  "type": "Microsoft.Chaos/experiments",
  "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "d04ab567-2c07-43ef-a7f4-4527626b7f56",
    "tenantId": "8c3e2fb2-fe7a-4bf1-b779-d73990782fe6"
  },
  "tags": {
    "key7131": "ryohwcoiccwsnewjigfmijz",
    "key2138": "fjaeecgnvqd"
  },
  "location": "eastus2euap",
  "properties": {
    "provisioningState": "Updating",
    "selectors": [
      {
        "type": "List",
        "id": "selector1",
        "targets": [
          {
            "type": "ChaosTarget",
            "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Compute/virtualMachines/exampleVM/providers/Microsoft.Chaos/targets/Microsoft-VirtualMachine"
          }
        ]
      }
    ],
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "type": "continuous",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ],
                "selectorId": "selector1"
              }
            ]
          }
        ]
      }
    ]
  },
  "systemData": {
    "createdAt": "2021-07-01T00:00:00.0Z",
    "createdBy": "User",
    "createdByType": "b3a41dba-4415-4d36-9ee8-e5eaa86db976",
    "lastModifiedAt": "2021-07-01T00:00:00.0Z",
    "lastModifiedBy": "User",
    "lastModifiedByType": "b3a41dba-4415-4d36-9ee8-e5eaa86db976"
  }
}

Code d’état:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/myResourceGroup/providers/Microsoft.Chaos/locations/eastus/operationStatus/00000000-0000-0000-0000-000000000000?api-version=2024-11-01-preview
Location: https://management.azure.com/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/myResourceGroup/providers/Microsoft.Chaos/experiments/00000000-0000-0000-0000-000000000000?api-version=2024-11-01-preview

{
  "name": "exampleExperiment",
  "type": "Microsoft.Chaos/experiments",
  "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "d04ab567-2c07-43ef-a7f4-4527626b7f56",
    "tenantId": "8c3e2fb2-fe7a-4bf1-b779-d73990782fe6"
  },
  "tags": {
    "key7131": "ryohwcoiccwsnewjigfmijz",
    "key2138": "fjaeecgnvqd"
  },
  "location": "eastus2euap",
  "properties": {
    "provisioningState": "Creating",
    "selectors": [
      {
        "type": "List",
        "id": "selector1",
        "targets": [
          {
            "type": "ChaosTarget",
            "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Compute/virtualMachines/exampleVM/providers/Microsoft.Chaos/targets/Microsoft-VirtualMachine"
          }
        ]
      }
    ],
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "type": "continuous",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ],
                "selectorId": "selector1"
              }
            ]
          }
        ]
      }
    ]
  },
  "systemData": {
    "createdAt": "2021-07-01T00:00:00.0Z",
    "createdBy": "User",
    "createdByType": "b3a41dba-4415-4d36-9ee8-e5eaa86db976",
    "lastModifiedAt": "2021-07-01T00:00:00.0Z",
    "lastModifiedBy": "User",
    "lastModifiedByType": "b3a41dba-4415-4d36-9ee8-e5eaa86db976"
  }
}

Définitions

Nom	Description
ChaosExperimentBranch	Modèle qui représente une branche à l’étape. 9 totaux par expérience.
ChaosExperimentStep	Modèle qui représente une étape dans la ressource Expérience.
ChaosTargetListSelector	Modèle qui représente un sélecteur de liste.
ChaosTargetQuerySelector	Modèle qui représente un sélecteur de requête.
ChaosTargetSimpleFilter	Modèle qui représente un filtre cible simple.
ChaosTargetSimpleFilterParameters	Modèle qui représente les paramètres de filtre simple.
ContinuousAction	Modèle qui représente une action continue.
createdByType	Type d’identité qui a créé la ressource.
DelayAction	Modèle qui représente une action de délai.
DiscreteAction	Modèle qui représente une action discrète.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
Experiment	Modèle qui représente une ressource Experiment.
ExperimentActionType	Union d’énumération des types d’actions d’expérience Chaos.
FilterType	Énumération qui distingue les types de filtres. Actuellement, seul `Simple` type est pris en charge.
KeyValuePair	Carte pour décrire les paramètres d’une action.
ManagedServiceIdentity	Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)
ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
ProvisioningState	État d’approvisionnement actuel d’une ressource Azure Chaos donnée.
SelectorType	Énumération du type de sélecteur.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
TargetReference	Modèle qui représente une référence à une cible dans le sélecteur.
TargetReferenceType	Énumération du type de référence cible.
UserAssignedIdentity	Propriétés d’identité attribuées par l’utilisateur

ChaosExperimentBranch

Modèle qui représente une branche à l’étape. 9 totaux par expérience.

Nom	Type	Description
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Liste des actions.
name	string	Chaîne du nom de la branche.

ChaosExperimentStep

Modèle qui représente une étape dans la ressource Expérience.

Nom	Type	Description
branches	ChaosExperimentBranch[]	Liste des branches.
name	string	Chaîne du nom de l’étape.

ChaosTargetListSelector

Modèle qui représente un sélecteur de liste.

Nom	Type	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modèle qui représente les types de filtres disponibles qui peuvent être appliqués à une liste de cibles.
id	string	Chaîne de l’ID de sélecteur.
targets	TargetReference[]	Liste des références cibles.
type	string: List	Type de discriminateur de sélecteur cible chaos

ChaosTargetQuerySelector

Modèle qui représente un sélecteur de requête.

Nom	Type	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modèle qui représente les types de filtres disponibles qui peuvent être appliqués à une liste de cibles.
id	string	Chaîne de l’ID de sélecteur.
queryString	string	Requête du langage de requête Azure Resource Graph (ARG) pour les ressources cibles.
subscriptionIds	string[]	Liste d’ID d’abonnement pour étendre la requête de ressource.
type	string: Query	Type de discriminateur de sélecteur cible chaos

ChaosTargetSimpleFilter

Modèle qui représente un filtre cible simple.

Nom	Type	Description
parameters	ChaosTargetSimpleFilterParameters	Modèle qui représente les paramètres de filtre simple.
type	string: Simple	Type de discriminateur de filtre cible chaos

ChaosTargetSimpleFilterParameters

Modèle qui représente les paramètres de filtre simple.

Nom	Type	Description
zones	string[]	Liste des zones de disponibilité Azure par lesquelles filtrer les cibles.

ContinuousAction

Modèle qui représente une action continue.

Nom	Type	Description
duration	string	ISO8601 chaîne mise en forme qui représente une durée.
name	string	Chaîne qui représente un URN de capacité.
parameters	KeyValuePair[]	Liste des paires clé-valeur.
selectorId	string	Chaîne qui représente un sélecteur.
type	string: continuous	Type de discriminateur d’action d’expérience chaos

createdByType

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

Nom	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DelayAction

Modèle qui représente une action de délai.

Nom	Type	Description
duration	string	ISO8601 chaîne mise en forme qui représente une durée.
name	string	Chaîne qui représente un URN de capacité.
type	string: delay	Type de discriminateur d’action d’expérience chaos

DiscreteAction

Modèle qui représente une action discrète.

Nom	Type	Description
name	string	Chaîne qui représente un URN de capacité.
parameters	KeyValuePair[]	Liste des paires clé-valeur.
selectorId	string	Chaîne qui représente un sélecteur.
type	string: discrete	Type de discriminateur d’action d’expérience chaos

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.

Experiment

Modèle qui représente une ressource Experiment.

Nom	Type	Description
id	string	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
identity	ManagedServiceIdentity	Identités de service managées affectées à cette ressource.
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties.provisioningState	ProvisioningState	État d’approvisionnement le plus récent pour la ressource d’expérience donnée.
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Liste des sélecteurs.
properties.steps	ChaosExperimentStep[]	Liste des étapes.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

ExperimentActionType

Union d’énumération des types d’actions d’expérience Chaos.

Nom	Type	Description
continuous	string
delay	string
discrete	string

FilterType

Énumération qui distingue les types de filtres. Actuellement, seul Simple type est pris en charge.

Nom	Type	Description
Simple	string	Type de filtre simple.

KeyValuePair

Carte pour décrire les paramètres d’une action.

Nom	Type	Description
key	string	Nom du paramètre de l’action.
value	string	Valeur du paramètre de l’action.

ManagedServiceIdentity

Identité de service managée (identités affectées par le système et/ou identités affectées par l’utilisateur)

Nom	Type	Description
principalId	string	ID du principal de service de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
tenantId	string	ID de locataire de l’identité affectée par le système. Cette propriété est fournie uniquement pour une identité affectée par le système.
type	ManagedServiceIdentityType	Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).
userAssignedIdentities	<string, UserAssignedIdentity>	identités User-Assigned Ensemble d’identités affectées par l’utilisateur associées à la ressource. Les clés de dictionnaire userAssignedIdentities seront des ID de ressource ARM sous la forme : « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Les valeurs de dictionnaire peuvent être des objets vides ({}) dans les requêtes.

ManagedServiceIdentityType

Type d’identité de service managé (où les types SystemAssigned et UserAssigned sont autorisés).

Nom	Type	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ProvisioningState

État d’approvisionnement actuel d’une ressource Azure Chaos donnée.

Nom	Type	Description
Canceled	string	La création de ressources a été annulée.
Creating	string	Création initiale en cours.
Deleting	string	Suppression en cours.
Failed	string	Échec de la création de ressources.
Succeeded	string	La ressource a été créée.
Updating	string	Mise à jour en cours.

SelectorType

Énumération du type de sélecteur.

Nom	Type	Description
List	string	Type de sélecteur de liste.
Query	string	Type de sélecteur de requête.

systemData

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

Nom	Type	Description
createdAt	string	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	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.

TargetReference

Modèle qui représente une référence à une cible dans le sélecteur.

Nom	Type	Description
id	string	Chaîne de l’ID de ressource d’une ressource cible.
type	TargetReferenceType	Énumération du type de référence cible.

TargetReferenceType

Énumération du type de référence cible.

Nom	Type	Description
ChaosTarget	string	Type de référence cible chaos.

UserAssignedIdentity

Propriétés d’identité attribuées par l’utilisateur

Nom	Type	Description
clientId	string	ID client de l’identité affectée.
principalId	string	ID principal de l’identité affectée.

Partager via

Experiments - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Create/update a Experiment in a resource group.

Exemple de requête

Exemple de réponse

Définitions

ChaosExperimentBranch

ChaosExperimentStep

ChaosTargetListSelector

ChaosTargetQuerySelector

ChaosTargetSimpleFilter

ChaosTargetSimpleFilterParameters

ContinuousAction

createdByType

DelayAction

DiscreteAction

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Experiment

ExperimentActionType

FilterType

KeyValuePair

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

SelectorType

systemData

TargetReference

TargetReferenceType

UserAssignedIdentity

Ressources supplémentaires