Megosztás a következőn keresztül:


Experiments - Create Or Update

Kísérleterőforrás létrehozása vagy frissítése.

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

URI-paraméterek

Name In Kötelező Típus Description
experimentName
path True

string

A kísérlet erőforrásnevét jelképező karakterlánc.

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

resourceGroupName
path True

string

Azure-erőforráscsoportot képviselő sztring.

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

subscriptionId
path True

string

Az Azure-előfizetés azonosítóját jelző GUID.

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

Az API-verziót állító sztring.

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

Kérelem törzse

Name Kötelező Típus Description
location True

string

A földrajzi hely, ahol az erőforrás él

properties.selectors True selector[]:

A választók listája.

properties.steps True

step[]

A lépések listája.

identity

resourceIdentity

A kísérlet erőforrásának identitása.

tags

object

Erőforráscímkék.

Válaszok

Name Típus Description
200 OK

experiment

Hosszú ideig futó cserekísérleti művelet.

201 Created

experiment

Hosszú ideig futó kísérlet létrehozása művelet.

Other Status Codes

ErrorResponse

Hibaválaszt adott vissza, ha a kérés sikertelen volt.

Biztonság

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation A felhasználói fiók megszemélyesítése

Példák

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

Definíciók

Name Description
branch

Modell, amely a lépés egy ágát jelöli. Kísérletenként összesen 9.

continuousAction

Folyamatos műveletet jelképező modell.

createdByType

Az erőforrást létrehozó identitás típusa.

delayAction

A késleltetési műveletet jelképező modell.

discreteAction

Különálló műveletet jelképező modell.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

ErrorDetail

A hiba részletei.

ErrorResponse

Hibaválasz

experiment

Kísérleterőforrást jelölő modell.

keyValuePair

Egy művelet beállításait leíró térkép.

listSelector

Listaválasztót jelölő modell.

ProvisioningState

Az adott kísérleti erőforrás legutóbbi kiépítési állapota.

querySelector

Egy lekérdezésválasztót jelölő modell.

resourceIdentity

Egy erőforrás identitása.

ResourceIdentityType

Az erőforrás-identitástípus sztringje.

simpleFilter

Egyszerű célszűrőt jelölő modell.

simpleFilterParameters

Az Egyszerű szűrőparamétereket képviselő modell.

step

Modell, amely a Kísérlet erőforrás egy lépését jelöli.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

targetReference

Modell, amely egy célra mutató hivatkozást jelöl a választóban.

TargetReferenceType

A Cél hivatkozástípus enumerálási típusa.

UserAssignedIdentity

Felhasználó által hozzárendelt identitás tulajdonságai

branch

Modell, amely a lépés egy ágát jelöli. Kísérletenként összesen 9.

Name Típus Description
actions action[]:

Műveletek listája.

name

string

Az ág nevének sztringje.

continuousAction

Folyamatos műveletet jelképező modell.

Name Típus Description
duration

string

ISO8601 időtartamot jelölő formázott sztring.

name

string

Képesség URL-ét jelölő sztring.

parameters

keyValuePair[]

Kulcsértékpárok listája.

selectorId

string

A választót jelölő karakterlánc.

type string:

continuous

Enumerálás, amely megkülönbözteti a műveleti modelleket.

createdByType

Az erőforrást létrehozó identitás típusa.

Name Típus Description
Application

string

Key

string

ManagedIdentity

string

User

string

delayAction

A késleltetési műveletet jelképező modell.

Name Típus Description
duration

string

ISO8601 időtartamot jelölő formázott sztring.

name

string

Képesség URL-ét jelölő sztring.

type string:

delay

Enumerálás, amely megkülönbözteti a műveleti modelleket.

discreteAction

Különálló műveletet jelképező modell.

Name Típus Description
name

string

Képesség URL-ét jelölő sztring.

parameters

keyValuePair[]

Kulcsértékpárok listája.

selectorId

string

A választót jelölő karakterlánc.

type string:

discrete

Enumerálás, amely megkülönbözteti a műveleti modelleket.

ErrorAdditionalInfo

Az erőforrás-kezelési hiba további információi.

Name Típus Description
info

object

A további információk.

type

string

A további adattípus.

ErrorDetail

A hiba részletei.

Name Típus Description
additionalInfo

ErrorAdditionalInfo[]

A hiba további információi.

code

string

A hibakód.

details

ErrorDetail[]

A hiba részletei.

message

string

A hibaüzenet.

target

string

A hiba célja.

ErrorResponse

Hibaválasz

Name Típus Description
error

ErrorDetail

A hibaobjektum.

experiment

Kísérleterőforrást jelölő modell.

Name Típus Description
id

string

Az erőforrás teljes erőforrás-azonosítója. Például : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

A kísérlet erőforrásának identitása.

location

string

A földrajzi hely, ahol az erőforrás él

name

string

Az erőforrás neve

properties.provisioningState

ProvisioningState

Az adott kísérleti erőforrás legutóbbi kiépítési állapota.

properties.selectors selector[]:

A választók listája.

properties.steps

step[]

A lépések listája.

systemData

systemData

A kísérlet erőforrásának rendszer metaadatai.

tags

object

Erőforráscímkék.

type

string

Az erőforrás típusa. Például"Microsoft.Compute/virtualMachines" vagy "Microsoft.Storage/storageAccounts"

keyValuePair

Egy művelet beállításait leíró térkép.

Name Típus Description
key

string

A művelet beállításának neve.

value

string

A művelet beállításának értéke.

listSelector

Listaválasztót jelölő modell.

Name Típus Description
filter filter:

simpleFilter

A céllistára alkalmazható elérhető szűrőtípusokat képviselő modell.

id

string

A választóazonosító sztringje.

targets

targetReference[]

Célhivatkozások listája.

type string:

List

A választótípus enumerálási száma.

ProvisioningState

Az adott kísérleti erőforrás legutóbbi kiépítési állapota.

Name Típus Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

Egy lekérdezésválasztót jelölő modell.

Name Típus Description
filter filter:

simpleFilter

A céllistára alkalmazható elérhető szűrőtípusokat képviselő modell.

id

string

A választóazonosító sztringje.

queryString

string

Az Azure Resource Graph (ARG) lekérdezési nyelv lekérdezése a célerőforrásokhoz.

subscriptionIds

string[]

Előfizetés-azonosítók listája az erőforrás-lekérdezés hatóköréhez.

type string:

Query

A választótípus enumerálási száma.

resourceIdentity

Egy erőforrás identitása.

Name Típus Description
principalId

string

GUID, amely az erőforrás-identitás fő azonosítóját jelöli.

tenantId

string

GUID, amely az erőforrás-identitás bérlőazonosítóját jelöli.

type

ResourceIdentityType

Az erőforrás-identitástípus sztringje.

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned-identitások
A kísérlethez társított felhasználói identitások listája. A felhasználói identitás szótárkulcs-hivatkozásai ARM-erőforrásazonosítók lesznek a következő formában: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ResourceIdentityType

Az erőforrás-identitástípus sztringje.

Name Típus Description
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

Egyszerű célszűrőt jelölő modell.

Name Típus Description
parameters

simpleFilterParameters

Az Egyszerű szűrőparamétereket képviselő modell.

type string:

Simple

Szám, amely megkülönbözteti a szűrőtípusokat. Jelenleg csak Simple a típus támogatott.

simpleFilterParameters

Az Egyszerű szűrőparamétereket képviselő modell.

Name Típus Description
zones

string[]

Az Azure rendelkezésre állási zónáinak listája a célok szűréséhez.

step

Modell, amely a Kísérlet erőforrás egy lépését jelöli.

Name Típus Description
branches

branch[]

Ágak listája.

name

string

A lépésnév sztringje.

systemData

Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok.

Name Típus Description
createdAt

string

Az erőforrás-létrehozás időbélyege (UTC).

createdBy

string

Az erőforrást létrehozó identitás.

createdByType

createdByType

Az erőforrást létrehozó identitás típusa.

lastModifiedAt

string

Az erőforrás utolsó módosításának időbélyege (UTC)

lastModifiedBy

string

Az erőforrást utoljára módosító identitás.

lastModifiedByType

createdByType

Az erőforrást legutóbb módosító identitás típusa.

targetReference

Modell, amely egy célra mutató hivatkozást jelöl a választóban.

Name Típus Description
id

string

Egy célerőforrás erőforrás-azonosítójának sztringje.

type

TargetReferenceType

A Cél hivatkozástípus enumerálási típusa.

TargetReferenceType

A Cél hivatkozástípus enumerálási típusa.

Name Típus Description
ChaosTarget

string

UserAssignedIdentity

Felhasználó által hozzárendelt identitás tulajdonságai

Name Típus Description
clientId

string

A hozzárendelt identitás ügyfél-azonosítója.

principalId

string

A hozzárendelt identitás egyszerű azonosítója.