Freigeben über

Experiments - Create Or Update

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

minLength: 1
pattern: ^[^<>%&:?#/\\]+$

Zeichenfolge, die einen Experiment-Ressourcennamen darstellt.
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

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

minLength: 1

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

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.

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

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

Objekt

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

Name Typ Beschreibung
actions ChaosExperimentAction[]:

Liste der Aktionen.
name

string

minLength: 1

Zeichenfolge des Verzweigungsnamens.

ChaosExperimentStep

Objekt

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

Name Typ Beschreibung
branches

ChaosExperimentBranch[]

Liste der Verzweigungen.
name

string

minLength: 1

Zeichenfolge des Schrittnamens.

ChaosTargetListSelector

Objekt

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

minLength: 1

Zeichenfolge der Selektor-ID.
targets

TargetReference[]

Liste der Zielverweise.
type string:

List

Chaos-Zielauswahl-Diskriminatortyp

ChaosTargetQuerySelector

Objekt

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

minLength: 1

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

Objekt

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

Objekt

Modell, das die Parameter "Einfacher Filter" darstellt.

Name Typ Beschreibung
zones

string[]

Liste der Azure-Verfügbarkeitszonen zum Filtern von Zielen nach.

ContinuousAction

Objekt

Modell, das eine fortlaufende Aktion darstellt.

Name Typ Beschreibung
duration

string (duration)

ISO8601 formatierte Zeichenfolge, die eine Dauer darstellt.
name

string

maxLength: 2048

Zeichenfolge, die einen Funktions-URN darstellt.
parameters

KeyValuePair[]

Liste der Schlüsselwertpaare.
selectorId

string

minLength: 1

Zeichenfolge, die eine Auswahl darstellt.
type string:

continuous

Chaos experiment action diskriminator type

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert Beschreibung
User
Application
ManagedIdentity
Key

DelayAction

Objekt

Modell, das eine Verzögerungsaktion darstellt.

Name Typ Beschreibung
duration

string (duration)

ISO8601 formatierte Zeichenfolge, die eine Dauer darstellt.
name

string

maxLength: 2048

Zeichenfolge, die einen Funktions-URN darstellt.
type string:

delay

Chaos experiment action diskriminator type

DiscreteAction

Objekt

Modell, das eine diskrete Aktion darstellt.

Name Typ Beschreibung
name

string

maxLength: 2048

Zeichenfolge, die einen Funktions-URN darstellt.
parameters

KeyValuePair[]

Liste der Schlüsselwertpaare.
selectorId

string

minLength: 1

Zeichenfolge, die eine Auswahl darstellt.
type string:

discrete

Chaos experiment action diskriminator type

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.
type

string

Der zusätzliche Informationstyp.

ErrorDetail

Objekt

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

Objekt

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

Experiment

Objekt

Modell, das eine Experiment-Ressource darstellt.

Name Typ Beschreibung
id

string (arm-id)

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

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

Enumeration

Aufzählungsunion von Chaos Experiment Aktionstypen.

Wert Beschreibung
delay
discrete
continuous

FilterType

Enumeration

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

Wert Beschreibung
Simple

Einfacher Filtertyp.

KeyValuePair

Objekt

Eine Karte zur Beschreibung der Einstellungen einer Aktion.

Name Typ Beschreibung
key

string

minLength: 1

Der Name der Einstellung für die Aktion.
value

string

minLength: 1

Der Wert der Einstellung für die Aktion.

ManagedServiceIdentity

Objekt

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

Name Typ Beschreibung
principalId

string (uuid)

Die Dienstprinzipal-ID der vom System zugewiesenen Identität. Diese Eigenschaft wird nur für eine vom System zugewiesene Identität bereitgestellt.
tenantId

string (uuid)

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

Enumeration

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

Wert Beschreibung
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Enumeration

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

Wert Beschreibung
Succeeded

Ressource wurde erstellt.
Failed

Fehler bei der Ressourcenerstellung.
Canceled

Die Ressourcenerstellung wurde abgebrochen.
Creating

Die anfängliche Erstellung wird ausgeführt.
Updating

Aktualisierung wird ausgeführt.
Deleting

Löschvorgang wird ausgeführt.

SelectorType

Enumeration

Enumeration des Selektortyps.

Wert Beschreibung
List

Listenauswahltyp.
Query

Abfrageauswahltyp.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name Typ Beschreibung
createdAt

string (date-time)

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 (date-time)

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

Objekt

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

Name Typ Beschreibung
id

string (arm-id)

Zeichenfolge der Ressourcen-ID einer Zielressource.
type

TargetReferenceType

Enumeration des Zielverweistyps.

TargetReferenceType

Enumeration

Enumeration des Zielverweistyps.

Wert Beschreibung
ChaosTarget

Chaos-Zielverweistyp.

UserAssignedIdentity

Objekt

Benutzer zugewiesene Identitätseigenschaften

Name Typ Beschreibung
clientId

string (uuid)

Die Client-ID der zugewiesenen Identität.
principalId

string (uuid)

Die Prinzipal-ID der zugewiesenen Identität.