Sdílet prostřednictvím


Experiments - Create Or Update

Vytvořte nebo aktualizujte prostředek experimentu.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Chaos/experiments/{experimentName}?api-version=2024-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.

Regex pattern: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

Řetězec, který představuje skupinu prostředků Azure.

Regex pattern: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

Identifikátor GUID, který představuje ID předplatného Azure.

Regex pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

api-version
query True

string

Řetězec, který nastaví verzi rozhraní API.

Regex pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$

Text požadavku

Name Vyžadováno Typ Description
location True

string

Geografické umístění, ve kterém se nachází prostředek

properties.selectors True selector[]:

Seznam selektorů

properties.steps True

step[]

Seznam kroků

identity

resourceIdentity

Identita prostředku experimentu.

tags

object

Značky prostředků.

Odpovědi

Name Typ Description
200 OK

experiment

Dlouhotrvající operace nahrazení experimentu.

201 Created

experiment

Dlouhotrvající operace vytvoření experimentu.

Other Status Codes

ErrorResponse

V případě neúspěšné žádosti byla vrácena odpověď na chybu.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Příklady

Create/update a Experiment in a resource group.

Sample Request

PUT https://management.azure.com/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment?api-version=2024-01-01

{
  "location": "eastus2euap",
  "identity": {
    "type": "SystemAssigned"
  },
  "properties": {
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "type": "continuous",
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "selectorId": "selector1",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "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"
          }
        ]
      }
    ]
  }
}

Sample Response

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-01-01
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-01-01
{
  "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment",
  "type": "Microsoft.Chaos/experiments",
  "name": "exampleExperiment",
  "location": "eastus2euap",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "d04ab567-2c07-43ef-a7f4-4527626b7f56",
    "tenantId": "8c3e2fb2-fe7a-4bf1-b779-d73990782fe6"
  },
  "properties": {
    "provisioningState": "Creating",
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "type": "continuous",
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "selectorId": "selector1",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "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"
          }
        ]
      }
    ]
  },
  "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"
  }
}
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-01-01
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-01-01
{
  "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment",
  "type": "Microsoft.Chaos/experiments",
  "name": "exampleExperiment",
  "location": "eastus2euap",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "d04ab567-2c07-43ef-a7f4-4527626b7f56",
    "tenantId": "8c3e2fb2-fe7a-4bf1-b779-d73990782fe6"
  },
  "properties": {
    "provisioningState": "Updating",
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "type": "continuous",
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "selectorId": "selector1",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "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"
          }
        ]
      }
    ]
  },
  "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
branch

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

continuousAction

Model, který představuje nepřetržitou akci.

createdByType

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

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

Odpověď na chybu

experiment

Model, který představuje prostředek experimentu.

keyValuePair

Mapa, která popisuje nastavení akce.

listSelector

Model, který představuje selektor seznamu.

ProvisioningState

Nejnovější stav zřizování pro daný prostředek experimentu

querySelector

Model, který představuje selektor dotazu.

resourceIdentity

Identita prostředku.

ResourceIdentityType

Řetězec typu identity prostředku.

simpleFilter

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

simpleFilterParameters

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

step

Model, který představuje krok v prostředku Experiment.

systemData

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

targetReference

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

TargetReferenceType

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

UserAssignedIdentity

Vlastnosti identity přiřazené uživatelem

branch

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

Name Typ Description
actions action[]:

Seznam akcí

name

string

Řetězec názvu větve.

continuousAction

Model, který představuje nepřetržitou akci.

Name Typ Description
duration

string

ISO8601 formátovaný řetězec, který představuje dobu trvání.

name

string

Řetězec, který představuje URN schopnosti.

parameters

keyValuePair[]

Seznam párů hodnot klíčů

selectorId

string

Řetězec, který představuje selektor.

type string:

continuous

Výčet, který rozlišuje mezi akčními modely.

createdByType

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

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, který představuje URN schopnosti.

type string:

delay

Výčet, který rozlišuje mezi akčními modely.

discreteAction

Model, který představuje samostatnou akci

Name Typ Description
name

string

Řetězec, který představuje URN schopnosti.

parameters

keyValuePair[]

Seznam párů hodnot klíčů

selectorId

string

Řetězec, který představuje selektor.

type string:

discrete

Výčet, který rozlišuje mezi akčními modely.

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

Odpověď na chybu

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. Příklad – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

Identita prostředku experimentu.

location

string

Geografické umístění, ve kterém se nachází prostředek

name

string

Název prostředku

properties.provisioningState

ProvisioningState

Nejnovější stav zřizování pro daný prostředek experimentu

properties.selectors selector[]:

Seznam selektorů

properties.steps

step[]

Seznam kroků

systemData

systemData

Systémová metadata prostředku experimentu.

tags

object

Značky prostředků.

type

string

Typ prostředku. Například Microsoft.Compute/virtualMachines nebo Microsoft.Storage/storageAccounts

keyValuePair

Mapa, která popisuje nastavení akce.

Name Typ Description
key

string

Název nastavení akce.

value

string

Hodnota nastavení akce.

listSelector

Model, který představuje selektor seznamu.

Name Typ Description
filter filter:

simpleFilter

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

Výčet typu selektoru

ProvisioningState

Nejnovější stav zřizování pro daný prostředek experimentu

Name Typ Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

Model, který představuje selektor dotazu.

Name Typ Description
filter filter:

simpleFilter

Model, který představuje dostupné typy filtrů, které lze použít na seznam cílů.

id

string

Řetězec ID selektoru.

queryString

string

Dotazovací jazyk Azure Resource Graph (ARG) pro cílové prostředky

subscriptionIds

string[]

Seznam ID předplatného pro obor dotazu na prostředky

type string:

Query

Výčet typu selektoru

resourceIdentity

Identita prostředku.

Name Typ Description
principalId

string

IDENTIFIKÁTOR GUID, který představuje ID objektu zabezpečení této identity prostředku.

tenantId

string

IDENTIFIKÁTOR GUID, který představuje ID tenanta této identity prostředku.

type

ResourceIdentityType

Řetězec typu identity prostředku.

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identity
Seznam identit uživatelů přidružených k experimentu. Odkazy na klíče slovníku identit uživatelů budou ID prostředků ARM ve formátu :/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

ResourceIdentityType

Řetězec typu identity prostředku.

Name Typ Description
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

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

Name Typ Description
parameters

simpleFilterParameters

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

type string:

Simple

Výčet, který rozlišuje typy filtrů. V současné době je podporován pouze Simple typ.

simpleFilterParameters

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

Name Typ Description
zones

string[]

Seznam zón dostupnosti Azure pro filtrování cílů

step

Model, který představuje krok v prostředku Experiment.

Name Typ Description
branches

branch[]

Seznam větví.

name

string

Řetězec názvu kroku.

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á vytvořila prostředek.

lastModifiedAt

string

Časové razítko poslední změny prostředku (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 ve 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

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.