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	Tekenreeks die de naam van een experimentresource vertegenwoordigt. Regex-patroon: `^[^<>%&:?#/\\]+$`
resourceGroupName	path	True	string	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	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

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	Tekenreeks van de naam van de vertakking.

ChaosExperimentStep

Model dat een stap in de experimentresource vertegenwoordigt.

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

ChaosTargetListSelector

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	Tekenreeks van de selector-id.
targets	TargetReference[]	Lijst met doelverwijzingen.
type	string: List	Chaos target selector discriminator type

ChaosTargetQuerySelector

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

Model dat een eenvoudig doelfilter vertegenwoordigt.

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

ChaosTargetSimpleFilterParameters

Model dat de eenvoudige filterparameters vertegenwoordigt.

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

ContinuousAction

Model dat een continue actie vertegenwoordigt.

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

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DelayAction

Model dat een vertragingsactie vertegenwoordigt.

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

DiscreteAction

Model dat een discrete actie vertegenwoordigt.

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

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

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

ErrorDetail

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

Foutreactie

Name	Type	Description
error	ErrorDetail	Het foutobject.

Experiment

Model dat een Experiment-resource vertegenwoordigt.

Name	Type	Description
id	string	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

Enum union of Chaos experiment action types.

Name	Type	Description
continuous	string
delay	string
discrete	string

FilterType

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

Name	Type	Description
Simple	string	Eenvoudig filtertype.

KeyValuePair

Een kaart om de instellingen van een actie te beschrijven.

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

ManagedServiceIdentity

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

Name	Type	Description
principalId	string	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	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

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

Name	Type	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ProvisioningState

Huidige inrichtingsstatus voor een bepaalde Azure Chaos-resource.

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

SelectorType

Opsomming van het type selector.

Name	Type	Description
List	string	Type lijstkiezer.
Query	string	Type queryselector.

systemData

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

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

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

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

TargetReferenceType

Opsomming van het doelreferentietype.

Name	Type	Description
ChaosTarget	string	Chaos target reference type.

UserAssignedIdentity

Door de gebruiker toegewezen identiteitseigenschappen

Name	Type	Description
clientId	string	De client-id van de toegewezen identiteit.
principalId	string	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