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	Řetězec, který představuje název prostředku experimentu Vzor regulárního výrazu: `^[^<>%&:?#/\\]+$`
resourceGroupName	path	True	string	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	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

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

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

ChaosExperimentStep

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

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

ChaosTargetListSelector

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	Řetězec ID selektoru
targets	TargetReference[]	Seznam cílových odkazů
type	string: List	Typ diskriminátoru selektoru cíle chaosu

ChaosTargetQuerySelector

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

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

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

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

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

createdByType

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

Name	Typ	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DelayAction

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

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

DiscreteAction

Model, který představuje samostatnou akci

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

ErrorAdditionalInfo

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

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

ErrorDetail

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

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

Experiment

Model, který představuje prostředek experimentu

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

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

Name	Typ	Description
continuous	string
delay	string
discrete	string

FilterType

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

Name	Typ	Description
Simple	string	Jednoduchý typ filtru.

KeyValuePair

Mapa, která popisuje nastavení akce.

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

ManagedServiceIdentity

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

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

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

Name	Typ	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ProvisioningState

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

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

SelectorType

Výčet typu selektoru

Name	Typ	Description
List	string	Typ selektoru seznamu
Query	string	Typ selektoru dotazu

systemData

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

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

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

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

TargetReferenceType

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

Name	Typ	Description
ChaosTarget	string	Typ odkazu na cíl chaosu.

UserAssignedIdentity

Vlastnosti identity přiřazené uživatelem

Name	Typ	Description
clientId	string	ID klienta přiřazené identity.
principalId	string	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