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 |
---|---|---|---|---|
experiment
|
path | True |
string |
Řetězec, který představuje název prostředku experimentu. Vzor regulárního výrazu: |
resource
|
path | True |
string |
Řetězec, který představuje skupinu prostředků Azure. Vzor regulárního výrazu: |
subscription
|
path | True |
string |
Identifikátor GUID, který představuje ID předplatného Azure. Vzor regulárního výrazu: |
api-version
|
query | True |
string |
Řetězec, který nastaví verzi rozhraní API. Vzor regulárního výrazu: |
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 |
Identita prostředku experimentu. |
||
tags |
object |
Značky prostředků. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Dlouhotrvající operace nahrazení experimentu. |
|
201 Created |
Dlouhotrvající operace vytvoření experimentu. |
|
Other Status Codes |
V případě neúspěšné žádosti byla vrácena odpověď na chybu. |
Zabezpečení
azure_auth
Tok Azure Active Directory OAuth2
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
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"
}
]
}
]
}
}
Ukázková odpověď
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. |
continuous |
Model, který představuje nepřetržitou akci. |
created |
Typ identity, která vytvořila prostředek. |
delay |
Model, který představuje akci zpoždění. |
discrete |
Model, který představuje samostatnou akci |
Error |
Další informace o chybě správy prostředků |
Error |
Podrobnosti o chybě. |
Error |
Odpověď na chybu |
experiment |
Model, který představuje prostředek experimentu. |
key |
Mapa, která popisuje nastavení akce. |
list |
Model, který představuje selektor seznamu. |
Provisioning |
Nejnovější stav zřizování pro daný prostředek experimentu |
query |
Model, který představuje selektor dotazu. |
resource |
Identita prostředku. |
Resource |
Řetězec typu identity prostředku. |
simple |
Model, který představuje jednoduchý cílový filtr. |
simple |
Model, který představuje parametry jednoduchého filtru. |
step |
Model, který představuje krok v prostředku Experiment. |
system |
Metadata týkající se vytvoření a poslední změny prostředku |
target |
Model, který představuje odkaz na cíl ve selektoru. |
Target |
Výčet cílového typu odkazu. |
User |
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 |
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 |
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 |
Další informace o chybě |
|
code |
string |
Kód chyby |
details |
Podrobnosti o chybě |
|
message |
string |
Chybová zpráva |
target |
string |
Cíl chyby. |
ErrorResponse
Odpověď na chybu
Name | Typ | Description |
---|---|---|
error |
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 |
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 |
Nejnovější stav zřizování pro daný prostředek experimentu |
|
properties.selectors | selector[]: |
Seznam selektorů |
properties.steps |
step[] |
Seznam kroků |
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: |
Model, který představuje dostupné typy filtrů, které lze použít na seznam cílů. |
id |
string |
Řetězec ID selektoru. |
targets |
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: |
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 |
Řetězec typu identity prostředku. |
|
userAssignedIdentities |
<string,
User |
User-Assigned identity |
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 |
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 |
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 |
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 |
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 |
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. |