Experiments - Create Or Update

Referentie

Service:: Chaos Studio

API-versie:: 2025-01-01

Een experimentresource maken of bijwerken.

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

URI-parameters

Name	In	Vereist	Type	Description
experimentName	path	True	string minLength: 1 pattern: ^[^<>%&:?#/\\]+$	Tekenreeks die de naam van een experimentresource vertegenwoordigt.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is niet hoofdlettergevoelig.
subscriptionId	path	True	string (uuid)	De id van het doelabonnement. De waarde moet een UUID zijn.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Lijst met selectors.
properties.steps	True	ChaosExperimentStep[]	Lijst met stappen.
identity		ManagedServiceIdentity	De beheerde service-identiteiten die zijn toegewezen aan deze resource.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	Experiment	De updatebewerking experiment is voltooid
201 Created	Experiment	Het maken van de resource 'Experiment' is voltooid Kopteksten Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Een onverwachte foutreactie.

Name

Type

Description

200 OK

Experiment

De updatebewerking experiment is voltooid

201 Created

Experiment

Het maken van de resource 'Experiment' is voltooid

Kopteksten

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Create/update a Experiment in a resource group.

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
ChaosExperimentBranch	Model dat een vertakking in de stap vertegenwoordigt. 9 totaal per experiment.
ChaosExperimentStep	Model dat een stap in de experimentresource vertegenwoordigt.
ChaosTargetListSelector	Model dat een lijstkiezer vertegenwoordigt.
ChaosTargetQuerySelector	Model dat een queryselector vertegenwoordigt.
ChaosTargetSimpleFilter	Model dat een eenvoudig doelfilter vertegenwoordigt.
ChaosTargetSimpleFilterParameters	Model dat de eenvoudige filterparameters vertegenwoordigt.
ContinuousAction	Model dat een continue actie vertegenwoordigt.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DelayAction	Model dat een vertragingsactie vertegenwoordigt.
DiscreteAction	Model dat een discrete actie vertegenwoordigt.
ErrorAdditionalInfo	Aanvullende informatie over de resourcebeheerfout.
ErrorDetail	De foutdetails.
ErrorResponse	Foutreactie
Experiment	Model dat een Experiment-resource vertegenwoordigt.
ExperimentActionType	Enum union of Chaos experiment action types.
FilterType	Opsomming die onderscheid maakt tussen filtertypen. Momenteel wordt alleen `Simple` type ondersteund.
KeyValuePair	Een kaart om de instellingen van een actie te beschrijven.
ManagedServiceIdentity	Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)
ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).
ProvisioningState	Huidige inrichtingsstatus voor een bepaalde Azure Chaos-resource.
SelectorType	Opsomming van het type selector.
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
TargetReference	Model dat een verwijzing naar een doel in de selector vertegenwoordigt.
TargetReferenceType	Opsomming van het doelreferentietype.
UserAssignedIdentity	Door de gebruiker toegewezen identiteitseigenschappen

ChaosExperimentBranch

Object

Model dat een vertakking in de stap vertegenwoordigt. 9 totaal per experiment.

Name	Type	Description
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Lijst met acties.
name	string minLength: 1	Tekenreeks van de naam van de vertakking.

ChaosExperimentStep

Object

Model dat een stap in de experimentresource vertegenwoordigt.

Name	Type	Description
branches	ChaosExperimentBranch[]	Lijst met vertakkingen.
name	string minLength: 1	Tekenreeks van de naam van de stap.

ChaosTargetListSelector

Object

Model dat een lijstkiezer vertegenwoordigt.

Name	Type	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Model dat beschikbare filtertypen vertegenwoordigt die kunnen worden toegepast op een doelenlijst.
id	string minLength: 1	Tekenreeks van de selector-id.
targets	TargetReference[]	Lijst met doelverwijzingen.
type	string: List	Chaos target selector discriminator type

ChaosTargetQuerySelector

Object

Model dat een queryselector vertegenwoordigt.

Name	Type	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Model dat beschikbare filtertypen vertegenwoordigt die kunnen worden toegepast op een doelenlijst.
id	string minLength: 1	Tekenreeks van de selector-id.
queryString	string	Querytaalquery voor Azure Resource Graph (ARG) voor doelresources.
subscriptionIds	string[]	Lijst met abonnements-id's om de resourcequery te bepalen.
type	string: Query	Chaos target selector discriminator type

ChaosTargetSimpleFilter

Object

Model dat een eenvoudig doelfilter vertegenwoordigt.

Name	Type	Description
parameters	ChaosTargetSimpleFilterParameters	Model dat de eenvoudige filterparameters vertegenwoordigt.
type	string: Simple	Chaos-doelfilterdiscriminatietype

ChaosTargetSimpleFilterParameters

Object

Model dat de eenvoudige filterparameters vertegenwoordigt.

Name	Type	Description
zones	string[]	Lijst met Azure-beschikbaarheidszones om doelen te filteren.

ContinuousAction

Object

Model dat een continue actie vertegenwoordigt.

Name	Type	Description
duration	string (duration)	ISO8601 opgemaakte tekenreeks die een duur vertegenwoordigt.
name	string maxLength: 2048	Tekenreeks die een mogelijkheids-URN vertegenwoordigt.
parameters	KeyValuePair[]	Lijst met sleutel-waardeparen.
selectorId	string minLength: 1	Tekenreeks die een selector vertegenwoordigt.
type	string: continuous	Chaos experiment action discriminator type

createdByType

Inventarisatie

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
Application
Key
ManagedIdentity
User

DelayAction

Object

Model dat een vertragingsactie vertegenwoordigt.

Name	Type	Description
duration	string (duration)	ISO8601 opgemaakte tekenreeks die een duur vertegenwoordigt.
name	string maxLength: 2048	Tekenreeks die een mogelijkheids-URN vertegenwoordigt.
type	string: delay	Chaos experiment action discriminator type

DiscreteAction

Object

Model dat een discrete actie vertegenwoordigt.

Name	Type	Description
name	string maxLength: 2048	Tekenreeks die een mogelijkheids-URN vertegenwoordigt.
parameters	KeyValuePair[]	Lijst met sleutel-waardeparen.
selectorId	string minLength: 1	Tekenreeks die een selector vertegenwoordigt.
type	string: discrete	Chaos experiment action discriminator type

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name	Type	Description
info	object	De aanvullende informatie.
type	string	Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	De fout bevat aanvullende informatie.
code	string	De foutcode.
details	ErrorDetail[]	De foutdetails.
message	string	Het foutbericht.
target	string	Het foutdoel.

ErrorResponse

Object

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

Experiment

Object

Model dat een Experiment-resource vertegenwoordigt.

Name	Type	Description
id	string (arm-id)	Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	De beheerde service-identiteiten die zijn toegewezen aan deze resource.
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.provisioningState	ProvisioningState	De meest recente inrichtingsstatus voor de opgegeven experimentresource.
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Lijst met selectors.
properties.steps	ChaosExperimentStep[]	Lijst met stappen.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

ExperimentActionType

Inventarisatie

Enum union of Chaos experiment action types.

Waarde	Description
continuous
delay
discrete

FilterType

Inventarisatie

Opsomming die onderscheid maakt tussen filtertypen. Momenteel wordt alleen Simple type ondersteund.

Waarde	Description
Simple	Eenvoudig filtertype.

KeyValuePair

Object

Een kaart om de instellingen van een actie te beschrijven.

Name	Type	Description
key	string minLength: 1	De naam van de instelling voor de actie.
value	string minLength: 1	De waarde van de instelling voor de actie.

ManagedServiceIdentity

Object

Beheerde service-identiteit (door het systeem toegewezen en/of door de gebruiker toegewezen identiteiten)

Name	Type	Description
principalId	string (uuid)	De service-principal-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
tenantId	string (uuid)	De tenant-id van de door het systeem toegewezen identiteit. Deze eigenschap wordt alleen verstrekt voor een door het systeem toegewezen identiteit.
type	ManagedServiceIdentityType	Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identiteiten De set door de gebruiker toegewezen identiteiten die aan de resource zijn gekoppeld. De woordenlijstsleutels userAssignedIdentities zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. De waarden van de woordenlijst kunnen lege objecten ({}) zijn in aanvragen.

ManagedServiceIdentityType

Inventarisatie

Type beheerde service-identiteit (waarbij zowel SystemAssigned- als UserAssigned-typen zijn toegestaan).

Waarde	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ProvisioningState

Inventarisatie

Huidige inrichtingsstatus voor een bepaalde Azure Chaos-resource.

Waarde	Description
Canceled	Het maken van resources is geannuleerd.
Creating	Eerste aanmaak wordt uitgevoerd.
Deleting	Verwijdering wordt uitgevoerd.
Failed	Het maken van resources is mislukt.
Succeeded	De resource is gemaakt.
Updating	Update wordt uitgevoerd.

SelectorType

Inventarisatie

Opsomming van het type selector.

Waarde	Description
List	Type lijstkiezer.
Query	Type queryselector.

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

TargetReference

Object

Model dat een verwijzing naar een doel in de selector vertegenwoordigt.

Name	Type	Description
id	string (arm-id)	Tekenreeks van de resource-id van een doelresource.
type	TargetReferenceType	Opsomming van het doelreferentietype.

TargetReferenceType

Inventarisatie

Opsomming van het doelreferentietype.

Waarde	Description
ChaosTarget	Chaos target reference type.

UserAssignedIdentity

Object

Door de gebruiker toegewezen identiteitseigenschappen

Name	Type	Description
clientId	string (uuid)	De client-id van de toegewezen identiteit.
principalId	string (uuid)	De principal-id van de toegewezen identiteit.

Delen via

Experiments - Create Or Update

URI-parameters

Aanvraagbody

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Create/update a Experiment in a resource group.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

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

Aanvullende resources