Experiments - Create Or Update

Referenz

Dienst:: Chaos Studio

API-Version:: 2025-01-01

Erstellen oder Aktualisieren einer Experiment-Ressource.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
experimentName	path	True	string	Zeichenfolge, die einen Experiment-Ressourcennamen darstellt. RegEx-Muster: `^[^<>%&:?#/\\]+$`
resourceGroupName	path	True	string	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string uuid	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
location	True	string	Der geografische Standort, an dem sich die Ressource befindet
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Liste der Selektoren.
properties.steps	True	ChaosExperimentStep[]	Liste der Schritte.
identity		ManagedServiceIdentity	Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind.
tags		object	Ressourcentags.

Antworten

Name	Typ	Beschreibung
200 OK	Experiment	Der Aktualisierungsvorgang der Ressource "Experiment" war erfolgreich.
201 Created	Experiment	Der Vorgang zum Erstellen der Ressource "Experiment" war erfolgreich. Header Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

Experiment

Der Aktualisierungsvorgang der Ressource "Experiment" war erfolgreich.

201 Created

Experiment

Der Vorgang zum Erstellen der Ressource "Experiment" war erfolgreich.

Header

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Create/update a Experiment in a resource group.

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:: 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"
  }
}

Statuscode:: 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"
  }
}

Definitionen

Name	Beschreibung
ChaosExperimentBranch	Modell, das eine Verzweigung im Schritt darstellt. Insgesamt 9 pro Experiment.
ChaosExperimentStep	Modell, das einen Schritt in der Experiment-Ressource darstellt.
ChaosTargetListSelector	Modell, das eine Listenauswahl darstellt.
ChaosTargetQuerySelector	Modell, das eine Abfrageauswahl darstellt.
ChaosTargetSimpleFilter	Modell, das einen einfachen Zielfilter darstellt.
ChaosTargetSimpleFilterParameters	Modell, das die Parameter "Einfacher Filter" darstellt.
ContinuousAction	Modell, das eine fortlaufende Aktion darstellt.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DelayAction	Modell, das eine Verzögerungsaktion darstellt.
DiscreteAction	Modell, das eine diskrete Aktion darstellt.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
Experiment	Modell, das eine Experiment-Ressource darstellt.
ExperimentActionType	Aufzählungsunion von Chaos Experiment Aktionstypen.
FilterType	Enumeration, die zwischen Filtertypen diskriminiert. Derzeit wird nur `Simple` Typ unterstützt.
KeyValuePair	Eine Karte zur Beschreibung der Einstellungen einer Aktion.
ManagedServiceIdentity	Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)
ManagedServiceIdentityType	Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).
ProvisioningState	Aktueller Bereitstellungsstatus für eine bestimmte Azure Chaos-Ressource.
SelectorType	Enumeration des Selektortyps.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
TargetReference	Modell, das einen Verweis auf ein Ziel in der Auswahl darstellt.
TargetReferenceType	Enumeration des Zielverweistyps.
UserAssignedIdentity	Benutzer zugewiesene Identitätseigenschaften

ChaosExperimentBranch

Modell, das eine Verzweigung im Schritt darstellt. Insgesamt 9 pro Experiment.

Name	Typ	Beschreibung
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Liste der Aktionen.
name	string	Zeichenfolge des Verzweigungsnamens.

ChaosExperimentStep

Modell, das einen Schritt in der Experiment-Ressource darstellt.

Name	Typ	Beschreibung
branches	ChaosExperimentBranch[]	Liste der Verzweigungen.
name	string	Zeichenfolge des Schrittnamens.

ChaosTargetListSelector

Modell, das eine Listenauswahl darstellt.

Name	Typ	Beschreibung
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modell, das verfügbare Filtertypen darstellt, die auf eine Zielliste angewendet werden können.
id	string	Zeichenfolge der Selektor-ID.
targets	TargetReference[]	Liste der Zielverweise.
type	string: List	Chaos-Zielauswahl-Diskriminatortyp

ChaosTargetQuerySelector

Modell, das eine Abfrageauswahl darstellt.

Name	Typ	Beschreibung
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modell, das verfügbare Filtertypen darstellt, die auf eine Zielliste angewendet werden können.
id	string	Zeichenfolge der Selektor-ID.
queryString	string	Abfragespracheabfrage für Azure Resource Graph (ARG) für Zielressourcen.
subscriptionIds	string[]	Abonnement-ID-Liste zum Bereich der Ressourcenabfrage.
type	string: Query	Chaos-Zielauswahl-Diskriminatortyp

ChaosTargetSimpleFilter

Modell, das einen einfachen Zielfilter darstellt.

Name	Typ	Beschreibung
parameters	ChaosTargetSimpleFilterParameters	Modell, das die Parameter "Einfacher Filter" darstellt.
type	string: Simple	Chaos-Zielfilter-Diskriminatortyp

ChaosTargetSimpleFilterParameters

Modell, das die Parameter "Einfacher Filter" darstellt.

Name	Typ	Beschreibung
zones	string[]	Liste der Azure-Verfügbarkeitszonen zum Filtern von Zielen nach.

ContinuousAction

Modell, das eine fortlaufende Aktion darstellt.

Name	Typ	Beschreibung
duration	string	ISO8601 formatierte Zeichenfolge, die eine Dauer darstellt.
name	string	Zeichenfolge, die einen Funktions-URN darstellt.
parameters	KeyValuePair[]	Liste der Schlüsselwertpaare.
selectorId	string	Zeichenfolge, die eine Auswahl darstellt.
type	string: continuous	Chaos experiment action diskriminator type

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

DelayAction

Modell, das eine Verzögerungsaktion darstellt.

Name	Typ	Beschreibung
duration	string	ISO8601 formatierte Zeichenfolge, die eine Dauer darstellt.
name	string	Zeichenfolge, die einen Funktions-URN darstellt.
type	string: delay	Chaos experiment action diskriminator type

DiscreteAction

Modell, das eine diskrete Aktion darstellt.

Name	Typ	Beschreibung
name	string	Zeichenfolge, die einen Funktions-URN darstellt.
parameters	KeyValuePair[]	Liste der Schlüsselwertpaare.
selectorId	string	Zeichenfolge, die eine Auswahl darstellt.
type	string: discrete	Chaos experiment action diskriminator type

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

Experiment

Modell, das eine Experiment-Ressource darstellt.

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind.
location	string	Der geografische Standort, an dem sich die Ressource befindet
name	string	Der Name der Ressource
properties.provisioningState	ProvisioningState	Der letzte Bereitstellungsstatus für die angegebene Experimentressource.
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Liste der Selektoren.
properties.steps	ChaosExperimentStep[]	Liste der Schritte.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
tags	object	Ressourcentags.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

ExperimentActionType

Aufzählungsunion von Chaos Experiment Aktionstypen.

Name	Typ	Beschreibung
continuous	string
delay	string
discrete	string

FilterType

Enumeration, die zwischen Filtertypen diskriminiert. Derzeit wird nur Simple Typ unterstützt.

Name	Typ	Beschreibung
Simple	string	Einfacher Filtertyp.

KeyValuePair

Eine Karte zur Beschreibung der Einstellungen einer Aktion.

Name	Typ	Beschreibung
key	string	Der Name der Einstellung für die Aktion.
value	string	Der Wert der Einstellung für die Aktion.

ManagedServiceIdentity

Verwaltete Dienstidentität (vom System zugewiesene und/oder vom Benutzer zugewiesene Identitäten)

Name	Typ	Beschreibung
principalId	string	Die Dienstprinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.
tenantId	string	Die Mandanten-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.
type	ManagedServiceIdentityType	Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identitäten Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein.

ManagedServiceIdentityType

Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind).

Name	Typ	Beschreibung
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ProvisioningState

Aktueller Bereitstellungsstatus für eine bestimmte Azure Chaos-Ressource.

Name	Typ	Beschreibung
Canceled	string	Die Ressourcenerstellung wurde abgebrochen.
Creating	string	Die anfängliche Erstellung wird ausgeführt.
Deleting	string	Löschvorgang wird ausgeführt.
Failed	string	Fehler bei der Ressourcenerstellung.
Succeeded	string	Ressource wurde erstellt.
Updating	string	Aktualisierung wird ausgeführt.

SelectorType

Enumeration des Selektortyps.

Name	Typ	Beschreibung
List	string	Listenauswahltyp.
Query	string	Abfrageauswahltyp.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

TargetReference

Modell, das einen Verweis auf ein Ziel in der Auswahl darstellt.

Name	Typ	Beschreibung
id	string	Zeichenfolge der Ressourcen-ID einer Zielressource.
type	TargetReferenceType	Enumeration des Zielverweistyps.

TargetReferenceType

Enumeration des Zielverweistyps.

Name	Typ	Beschreibung
ChaosTarget	string	Chaos-Zielverweistyp.

UserAssignedIdentity

Benutzer zugewiesene Identitätseigenschaften

Name	Typ	Beschreibung
clientId	string	Die Client-ID der zugewiesenen Identität.
principalId	string	Die Prinzipal-ID der zugewiesenen Identität.

Freigeben über

Experiments - Create Or Update

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Create/update a Experiment in a resource group.

Beispielanforderung

Beispiel für eine Antwort

Definitionen

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

Zusätzliche Ressourcen