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 |
---|---|---|---|---|
experiment
|
path | True |
string |
A kísérlet erőforrásnevét jelképező karakterlánc. Regex pattern: |
resource
|
path | True |
string |
Azure-erőforráscsoportot képviselő sztring. Regex pattern: |
subscription
|
path | True |
string |
Az Azure-előfizetés azonosítóját jelző GUID. Regex pattern: |
api-version
|
query | True |
string |
Az API-verziót állító sztring. Regex pattern: |
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 |
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 |
Hosszú ideig futó cserekísérleti művelet. |
|
201 Created |
Hosszú ideig futó kísérlet létrehozása művelet. |
|
Other Status Codes |
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. |
continuous |
Folyamatos műveletet jelképező modell. |
created |
Az erőforrást létrehozó identitás típusa. |
delay |
A késleltetési műveletet jelképező modell. |
discrete |
Különálló műveletet jelképező modell. |
Error |
Az erőforrás-kezelési hiba további információi. |
Error |
A hiba részletei. |
Error |
Hibaválasz |
experiment |
Kísérleterőforrást jelölő modell. |
key |
Egy művelet beállításait leíró térkép. |
list |
Listaválasztót jelölő modell. |
Provisioning |
Az adott kísérleti erőforrás legutóbbi kiépítési állapota. |
query |
Egy lekérdezésválasztót jelölő modell. |
resource |
Egy erőforrás identitása. |
Resource |
Az erőforrás-identitástípus sztringje. |
simple |
Egyszerű célszűrőt jelölő modell. |
simple |
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. |
system |
Az erőforrás létrehozásával és utolsó módosításával kapcsolatos metaadatok. |
target |
Modell, amely egy célra mutató hivatkozást jelöl a választóban. |
Target |
A Cél hivatkozástípus enumerálási típusa. |
User |
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 |
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 |
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 |
A hiba további információi. |
|
code |
string |
A hibakód. |
details |
A hiba részletei. |
|
message |
string |
A hibaüzenet. |
target |
string |
A hiba célja. |
ErrorResponse
Hibaválasz
Name | Típus | Description |
---|---|---|
error |
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 |
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 |
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 |
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: |
A céllistára alkalmazható elérhető szűrőtípusokat képviselő modell. |
id |
string |
A választóazonosító sztringje. |
targets |
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: |
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 |
Az erőforrás-identitástípus sztringje. |
|
userAssignedIdentities |
<string,
User |
User-Assigned-identitások |
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 |
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 |
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 |
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 |
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 |
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. |