Experiments - Create Or Update

Reference

Služba:: Chaos Studio

Verze rozhraní API:: 2025-01-01

Vytvoření nebo aktualizace prostředku experimentu

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
experimentName	path	True	string minLength: 1 pattern: ^[^<>%&:?#/\\]+$	Řetězec, který představuje název prostředku experimentu
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Text požadavku

Name	Vyžadováno	Typ	Description
location	True	string	Geografické umístění, ve kterém se nachází zdroj
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Seznam selektorů
properties.steps	True	ChaosExperimentStep[]	Seznam kroků
identity		ManagedServiceIdentity	Identity spravované služby přiřazené k tomuto prostředku.
tags		object	Značky prostředků

Odpovědi

Name	Typ	Description
200 OK	Experiment	Operace aktualizace Experiment prostředku proběhla úspěšně.
201 Created	Experiment	Operace vytvoření experimentu prostředku proběhla úspěšně. Hlavičky Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Name

Typ

Description

200 OK

Experiment

Operace aktualizace Experiment prostředku proběhla úspěšně.

201 Created

Experiment

Operace vytvoření experimentu prostředku proběhla úspěšně.

Hlavičky

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Create/update a Experiment in a resource group.

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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"
  }
}

Stavový kód:: 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"
  }
}

Definice

Name	Description
ChaosExperimentBranch	Model, který představuje větev v kroku Celkem 9 na experiment.
ChaosExperimentStep	Model, který představuje krok v prostředku experimentu
ChaosTargetListSelector	Model představující selektor seznamu
ChaosTargetQuerySelector	Model představující selektor dotazu
ChaosTargetSimpleFilter	Model, který představuje jednoduchý cílový filtr
ChaosTargetSimpleFilterParameters	Model, který představuje parametry jednoduchého filtru
ContinuousAction	Model, který představuje průběžnou akci
createdByType	Typ identity, která prostředek vytvořila.
DelayAction	Model, který představuje akci zpoždění
DiscreteAction	Model, který představuje samostatnou akci
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
Experiment	Model, který představuje prostředek experimentu
ExperimentActionType	Sjednocení součtů typů akcí experimentu chaosu
FilterType	Výčet, který rozlišuje mezi typy filtrů. V současné době se podporuje pouze typ `Simple`.
KeyValuePair	Mapa, která popisuje nastavení akce.
ManagedServiceIdentity	Identita spravované služby (identita přiřazená systémem nebo identita přiřazená uživatelem)
ManagedServiceIdentityType	Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned).
ProvisioningState	Aktuální stav zřizování pro daný prostředek Azure Chaos
SelectorType	Výčet typu selektoru
systemData	Metadata týkající se vytvoření a poslední změny prostředku.
TargetReference	Model, který představuje odkaz na cíl v selektoru
TargetReferenceType	Výčet cílového typu odkazu.
UserAssignedIdentity	Vlastnosti identity přiřazené uživatelem

ChaosExperimentBranch

Objekt

Model, který představuje větev v kroku Celkem 9 na experiment.

Name	Typ	Description
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Seznam akcí
name	string minLength: 1	Řetězec názvu větve

ChaosExperimentStep

Objekt

Model, který představuje krok v prostředku experimentu

Name	Typ	Description
branches	ChaosExperimentBranch[]	Seznam větví
name	string minLength: 1	Řetězec názvu kroku

ChaosTargetListSelector

Objekt

Model představující selektor seznamu

Name	Typ	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Model, který představuje dostupné typy filtrů, které lze použít na seznam cílů.
id	string minLength: 1	Řetězec ID selektoru
targets	TargetReference[]	Seznam cílových odkazů
type	string: List	Typ diskriminátoru selektoru cíle chaosu

ChaosTargetQuerySelector

Objekt

Model představující selektor dotazu

Name	Typ	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Model, který představuje dostupné typy filtrů, které lze použít na seznam cílů.
id	string minLength: 1	Řetězec ID selektoru
queryString	string	Dotaz dotazování dotazovacího jazyka Azure Resource Graphu (ARG) pro cílové prostředky
subscriptionIds	string[]	Seznam ID předplatného pro dotaz na rozsah prostředků
type	string: Query	Typ diskriminátoru selektoru cíle chaosu

ChaosTargetSimpleFilter

Objekt

Model, který představuje jednoduchý cílový filtr

Name	Typ	Description
parameters	ChaosTargetSimpleFilterParameters	Model, který představuje parametry jednoduchého filtru
type	string: Simple	Typ diskriminátoru filtru chaosu

ChaosTargetSimpleFilterParameters

Objekt

Model, který představuje parametry jednoduchého filtru

Name	Typ	Description
zones	string[]	Seznam zón dostupnosti Azure pro filtrování cílů podle.

ContinuousAction

Objekt

Model, který představuje průběžnou akci

Name	Typ	Description
duration	string (duration)	ISO8601 formátovaný řetězec, který představuje dobu trvání.
name	string maxLength: 2048	Řetězec představující URN funkce
parameters	KeyValuePair[]	Seznam párů klíč-hodnota
selectorId	string minLength: 1	Řetězec, který představuje selektor.
type	string: continuous	Typ diskriminátoru akce experimentu chaosu

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
Application
Key
ManagedIdentity
User

DelayAction

Objekt

Model, který představuje akci zpoždění

Name	Typ	Description
duration	string (duration)	ISO8601 formátovaný řetězec, který představuje dobu trvání.
name	string maxLength: 2048	Řetězec představující URN funkce
type	string: delay	Typ diskriminátoru akce experimentu chaosu

DiscreteAction

Objekt

Model, který představuje samostatnou akci

Name	Typ	Description
name	string maxLength: 2048	Řetězec představující URN funkce
parameters	KeyValuePair[]	Seznam párů klíč-hodnota
selectorId	string minLength: 1	Řetězec, který představuje selektor.
type	string: discrete	Typ diskriminátoru akce experimentu chaosu

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Experiment

Objekt

Model, který představuje prostředek experimentu

Name	Typ	Description
id	string (arm-id)	Plně kvalifikované ID prostředku pro prostředek. Například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Identity spravované služby přiřazené k tomuto prostředku.
location	string	Geografické umístění, ve kterém se nachází zdroj
name	string	Název prostředku
properties.provisioningState	ProvisioningState	Poslední stav zřizování pro daný prostředek experimentu
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Seznam selektorů
properties.steps	ChaosExperimentStep[]	Seznam kroků
systemData	systemData	Metadata Azure Resource Manageru obsahující informace createdBy a modifiedBy
tags	object	Značky prostředků
type	string	Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

ExperimentActionType

Výčet

Sjednocení součtů typů akcí experimentu chaosu

Hodnota	Description
continuous
delay
discrete

FilterType

Výčet

Výčet, který rozlišuje mezi typy filtrů. V současné době se podporuje pouze typ Simple.

Hodnota	Description
Simple	Jednoduchý typ filtru.

KeyValuePair

Objekt

Mapa, která popisuje nastavení akce.

Name	Typ	Description
key	string minLength: 1	Název nastavení akce.
value	string minLength: 1	Hodnota nastavení akce.

ManagedServiceIdentity

Objekt

Identita spravované služby (identita přiřazená systémem nebo identita přiřazená uživatelem)

Name	Typ	Description
principalId	string (uuid)	ID instančního objektu identity přiřazené systémem. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
tenantId	string (uuid)	ID tenanta přiřazené identity systému. Tato vlastnost bude poskytována pouze pro identitu přiřazenou systémem.
type	ManagedServiceIdentityType	Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identity User-Assigned Sada identit přiřazených uživatelem přidružená k prostředku. Klíče slovníku userAssignedIdentities budou ID prostředků ARM ve formuláři: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Hodnoty slovníku můžou být prázdné objekty ({}) v požadavcích.

ManagedServiceIdentityType

Výčet

Typ identity spravované služby (kde jsou povolené typy SystemAssigned i UserAssigned).

Hodnota	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ProvisioningState

Výčet

Aktuální stav zřizování pro daný prostředek Azure Chaos

Hodnota	Description
Canceled	Vytvoření prostředku bylo zrušeno.
Creating	Probíhá počáteční vytvoření.
Deleting	Probíhá odstranění.
Failed	Vytvoření prostředku se nezdařilo.
Succeeded	Prostředek byl vytvořen.
Updating	Probíhá aktualizace.

SelectorType

Výčet

Výčet typu selektoru

Hodnota	Description
List	Typ selektoru seznamu
Query	Typ selektoru dotazu

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

TargetReference

Objekt

Model, který představuje odkaz na cíl v selektoru

Name	Typ	Description
id	string (arm-id)	Řetězec ID prostředku cílového prostředku
type	TargetReferenceType	Výčet cílového typu odkazu.

TargetReferenceType

Výčet

Výčet cílového typu odkazu.

Hodnota	Description
ChaosTarget	Typ odkazu na cíl chaosu.

UserAssignedIdentity

Objekt

Vlastnosti identity přiřazené uživatelem

Name	Typ	Description
clientId	string (uuid)	ID klienta přiřazené identity.
principalId	string (uuid)	ID objektu zabezpečení přiřazené identity.

Sdílet prostřednictvím

Experiments - Create Or Update

Parametry identifikátoru URI

Text požadavku

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Create/update a Experiment in a resource group.

Ukázkový požadavek

Ukázková odpověď

Definice

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

Další materiály