Experiments - Create Or Update

Referens

Tjänst:: Chaos Studio

API-version:: 2025-01-01

Skapa eller uppdatera en experimentresurs.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
experimentName	path	True	string minLength: 1 pattern: ^[^<>%&:?#/\\]+$	Sträng som representerar ett experimentresursnamn.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string (uuid)	ID för målprenumerationen. Värdet måste vara ett UUID.
api-version	query	True	string minLength: 1	DEN API-version som ska användas för den här åtgärden.

Begärandetext

Name	Obligatorisk	Typ	Description
location	True	string	Den geo-plats där resursen finns
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Lista över väljare.
properties.steps	True	ChaosExperimentStep[]	Lista över steg.
identity		ManagedServiceIdentity	De hanterade tjänstidentiteter som tilldelats den här resursen.
tags		object	Resurstaggar.

Svar

Name	Typ	Description
200 OK	Experiment	Resursens "experiment"-uppdateringsåtgärd lyckades
201 Created	Experiment	Åtgärden för att skapa resursen Experiment har slutförts Sidhuvuden Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Ett oväntat felsvar.

Name

Typ

Description

200 OK

Experiment

Resursens "experiment"-uppdateringsåtgärd lyckades

201 Created

Experiment

Åtgärden för att skapa resursen Experiment har slutförts

Sidhuvuden

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

Create/update a Experiment in a resource group.

Exempelbegäran

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

Exempelsvar

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

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

Definitioner

Name	Description
ChaosExperimentBranch	Modell som representerar en gren i steget. 9 totalt per experiment.
ChaosExperimentStep	Modell som representerar ett steg i experimentresursen.
ChaosTargetListSelector	Modell som representerar en listväljare.
ChaosTargetQuerySelector	Modell som representerar en frågeväljare.
ChaosTargetSimpleFilter	Modell som representerar ett enkelt målfilter.
ChaosTargetSimpleFilterParameters	Modell som representerar enkla filterparametrar.
ContinuousAction	Modell som representerar en kontinuerlig åtgärd.
createdByType	Den typ av identitet som skapade resursen.
DelayAction	Modell som representerar en fördröjningsåtgärd.
DiscreteAction	Modell som representerar en diskret åtgärd.
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
Experiment	Modell som representerar en experimentresurs.
ExperimentActionType	Räkna upp union av chaosexperimentåtgärdstyper.
FilterType	Uppräkning som skiljer mellan filtertyper. För närvarande stöds endast `Simple` typ.
KeyValuePair	En karta som beskriver inställningarna för en åtgärd.
ManagedServiceIdentity	Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter)
ManagedServiceIdentityType	Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).
ProvisioningState	Aktuellt etableringstillstånd för en viss Azure Chaos-resurs.
SelectorType	Uppräkning av väljarens typ.
systemData	Metadata som rör skapande och senaste ändring av resursen.
TargetReference	Modell som representerar en referens till ett mål i väljaren.
TargetReferenceType	Uppräkning av referenstypen Mål.
UserAssignedIdentity	Användartilldelade identitetsegenskaper

ChaosExperimentBranch

Objekt

Modell som representerar en gren i steget. 9 totalt per experiment.

Name	Typ	Description
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Lista över åtgärder.
name	string minLength: 1	Sträng för grennamnet.

ChaosExperimentStep

Objekt

Modell som representerar ett steg i experimentresursen.

Name	Typ	Description
branches	ChaosExperimentBranch[]	Lista över grenar.
name	string minLength: 1	Sträng för stegnamnet.

ChaosTargetListSelector

Objekt

Modell som representerar en listväljare.

Name	Typ	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modell som representerar tillgängliga filtertyper som kan tillämpas på en mållista.
id	string minLength: 1	Sträng för väljarens ID.
targets	TargetReference[]	Lista över målreferenser.
type	string: List	Kaosmålväljare – diskriminerande typ

ChaosTargetQuerySelector

Objekt

Modell som representerar en frågeväljare.

Name	Typ	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modell som representerar tillgängliga filtertyper som kan tillämpas på en mållista.
id	string minLength: 1	Sträng för väljarens ID.
queryString	string	Azure Resource Graph (ARG) Fråga språkfråga för målresurser.
subscriptionIds	string[]	Prenumerations-ID-lista för omfångsresursfråga.
type	string: Query	Kaosmålväljare – diskriminerande typ

ChaosTargetSimpleFilter

Objekt

Modell som representerar ett enkelt målfilter.

Name	Typ	Description
parameters	ChaosTargetSimpleFilterParameters	Modell som representerar enkla filterparametrar.
type	string: Simple	Filterdiskriminatortyp för Chaos-mål

ChaosTargetSimpleFilterParameters

Objekt

Modell som representerar enkla filterparametrar.

Name	Typ	Description
zones	string[]	Lista över Azure-tillgänglighetszoner som mål ska filtreras efter.

ContinuousAction

Objekt

Modell som representerar en kontinuerlig åtgärd.

Name	Typ	Description
duration	string (duration)	ISO8601 formaterad sträng som representerar en varaktighet.
name	string maxLength: 2048	Sträng som representerar ett funktions-URN.
parameters	KeyValuePair[]	Lista över nyckelvärdepar.
selectorId	string minLength: 1	Sträng som representerar en väljare.
type	string: continuous	Diskrimineringstyp för kaosexperiment

createdByType

Uppräkning

Den typ av identitet som skapade resursen.

Värde	Description
Application
Key
ManagedIdentity
User

DelayAction

Objekt

Modell som representerar en fördröjningsåtgärd.

Name	Typ	Description
duration	string (duration)	ISO8601 formaterad sträng som representerar en varaktighet.
name	string maxLength: 2048	Sträng som representerar ett funktions-URN.
type	string: delay	Diskrimineringstyp för kaosexperiment

DiscreteAction

Objekt

Modell som representerar en diskret åtgärd.

Name	Typ	Description
name	string maxLength: 2048	Sträng som representerar ett funktions-URN.
parameters	KeyValuePair[]	Lista över nyckelvärdepar.
selectorId	string minLength: 1	Sträng som representerar en väljare.
type	string: discrete	Diskrimineringstyp för kaosexperiment

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

Experiment

Objekt

Modell som representerar en experimentresurs.

Name	Typ	Description
id	string (arm-id)	Fullständigt kvalificerat resurs-ID för resursen. Till exempel "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	De hanterade tjänstidentiteter som tilldelats den här resursen.
location	string	Den geo-plats där resursen finns
name	string	Namnet på resursen
properties.provisioningState	ProvisioningState	Senaste etableringstillståndet för den angivna experimentresursen.
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Lista över väljare.
properties.steps	ChaosExperimentStep[]	Lista över steg.
systemData	systemData	Azure Resource Manager-metadata som innehåller createdBy och modifiedBy information.
tags	object	Resurstaggar.
type	string	Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

ExperimentActionType

Uppräkning

Räkna upp union av chaosexperimentåtgärdstyper.

Värde	Description
continuous
delay
discrete

FilterType

Uppräkning

Uppräkning som skiljer mellan filtertyper. För närvarande stöds endast Simple typ.

Värde	Description
Simple	Enkel filtertyp.

KeyValuePair

Objekt

En karta som beskriver inställningarna för en åtgärd.

Name	Typ	Description
key	string minLength: 1	Namnet på inställningen för åtgärden.
value	string minLength: 1	Värdet för inställningen för åtgärden.

ManagedServiceIdentity

Objekt

Hanterad tjänstidentitet (systemtilldelade och/eller användartilldelade identiteter)

Name	Typ	Description
principalId	string (uuid)	Tjänstens huvudnamns-ID för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet.
tenantId	string (uuid)	Klientorganisations-ID för den systemtilldelade identiteten. Den här egenskapen tillhandahålls endast för en systemtilldelad identitet.
type	ManagedServiceIdentityType	Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned identiteter Uppsättningen användartilldelade identiteter som är associerade med resursen. Ordlistenycklarna userAssignedIdentities är ARM-resurs-ID:er i formuläret: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Ordlistevärdena kan vara tomma objekt ({}) i begäranden.

ManagedServiceIdentityType

Uppräkning

Typ av hanterad tjänstidentitet (där både SystemAssigned- och UserAssigned-typer tillåts).

Värde	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ProvisioningState

Uppräkning

Aktuellt etableringstillstånd för en viss Azure Chaos-resurs.

Värde	Description
Canceled	Resursskapandet avbröts.
Creating	Inledande skapande pågår.
Deleting	Borttagning pågår.
Failed	Det gick inte att skapa resurser.
Succeeded	Resursen har skapats.
Updating	Uppdatering pågår.

SelectorType

Uppräkning

Uppräkning av väljarens typ.

Värde	Description
List	Listväljare.
Query	Frågeväljare.

systemData

Objekt

Metadata som rör skapande och senaste ändring av resursen.

Name	Typ	Description
createdAt	string (date-time)	Tidsstämpeln för resursskapande (UTC).
createdBy	string	Identiteten som skapade resursen.
createdByType	createdByType	Den typ av identitet som skapade resursen.
lastModifiedAt	string (date-time)	Tidsstämpeln för resursens senaste ändring (UTC)
lastModifiedBy	string	Identiteten som senast ändrade resursen.
lastModifiedByType	createdByType	Den typ av identitet som senast ändrade resursen.

TargetReference

Objekt

Modell som representerar en referens till ett mål i väljaren.

Name	Typ	Description
id	string (arm-id)	Sträng för resurs-ID för en målresurs.
type	TargetReferenceType	Uppräkning av referenstypen Mål.

TargetReferenceType

Uppräkning

Uppräkning av referenstypen Mål.

Värde	Description
ChaosTarget	Chaos-målreferenstyp.

UserAssignedIdentity

Objekt

Användartilldelade identitetsegenskaper

Name	Typ	Description
clientId	string (uuid)	Klient-ID för den tilldelade identiteten.
principalId	string (uuid)	Huvud-ID för den tilldelade identiteten.

Dela via

Experiments - Create Or Update

URI-parametrar

Begärandetext

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

Create/update a Experiment in a resource group.

Exempelbegäran

Exempelsvar

Definitioner

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

Ytterligare resurser