Experiments - Create Or Update
Создайте или обновите ресурс эксперимента.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Chaos/experiments/{experimentName}?api-version=2024-01-01
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
experiment
|
path | True |
string |
Строка, представляющая имя ресурса эксперимента. Шаблон регулярного выражения: |
resource
|
path | True |
string |
Строка, представляющая группу ресурсов Azure. Шаблон регулярного выражения: |
subscription
|
path | True |
string |
GUID, представляющий идентификатор подписки Azure. Шаблон регулярного выражения: |
api-version
|
query | True |
string |
Строка, задающая версию API. Шаблон регулярного выражения: |
Текст запроса
Имя | Обязательно | Тип | Описание |
---|---|---|---|
location | True |
string |
Географическое расположение, в котором находится ресурс |
properties.selectors | True | selector[]: |
Список селекторов. |
properties.steps | True |
step[] |
Список шагов. |
identity |
Удостоверение ресурса эксперимента. |
||
tags |
object |
Теги ресурсов. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Длительная операция замены эксперимента. |
|
201 Created |
Длительная операция создания эксперимента. |
|
Other Status Codes |
Если запрос был неудачным, возвращается ответ об ошибке. |
Безопасность
azure_auth
Поток OAuth2 в Azure Active Directory
Тип:
oauth2
Flow:
implicit
URL-адрес авторизации:
https://login.microsoftonline.com/common/oauth2/authorize
Области
Имя | Описание |
---|---|
user_impersonation | Олицетворение учетной записи пользователя |
Примеры
Create/update a Experiment in a resource group.
Образец запроса
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"
}
]
}
]
}
}
Пример ответа
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"
}
}
Определения
Имя | Описание |
---|---|
branch |
Модель, представляющая ветвь на шаге. Всего 9 на эксперимент. |
continuous |
Модель, представляющая непрерывное действие. |
created |
Тип удостоверения, создавшего ресурс. |
delay |
Модель, представляющая действие задержки. |
discrete |
Модель, представляющая дискретное действие. |
Error |
Дополнительные сведения об ошибке управления ресурсами. |
Error |
Сведения об ошибке. |
Error |
Сообщение об ошибке |
experiment |
Модель, представляющая ресурс Experiment. |
key |
Карта для описания параметров действия. |
list |
Модель, представляющая селектор списка. |
Provisioning |
Последнее состояние подготовки для заданного ресурса эксперимента. |
query |
Модель, представляющая селектор запросов. |
resource |
Удостоверение ресурса. |
Resource |
Строка типа удостоверения ресурса. |
simple |
Модель, представляющая простой целевой фильтр. |
simple |
Модель, представляющая параметры фильтра Simple. |
step |
Модель, представляющая шаг в ресурсе Experiment. |
system |
Метаданные, относящиеся к созданию и последнему изменению ресурса. |
target |
Модель, представляющая ссылку на целевой объект в селекторе. |
Target |
Перечисление ссылочного типа Target. |
User |
Свойства удостоверения, назначаемые пользователем |
branch
Модель, представляющая ветвь на шаге. Всего 9 на эксперимент.
Имя | Тип | Описание |
---|---|---|
actions | action[]: |
Список действий. |
name |
string |
Строка имени ветви. |
continuousAction
Модель, представляющая непрерывное действие.
Имя | Тип | Описание |
---|---|---|
duration |
string |
ISO8601 отформатированную строку, представляющую длительность. |
name |
string |
Строка, представляющая URN возможности. |
parameters |
Список пар "ключ-значение". |
|
selectorId |
string |
Строка, представляющая селектор. |
type |
string:
continuous |
Перечисление, которое различает модели действий. |
createdByType
Тип удостоверения, создавшего ресурс.
Имя | Тип | Описание |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
delayAction
Модель, представляющая действие задержки.
Имя | Тип | Описание |
---|---|---|
duration |
string |
ISO8601 отформатированную строку, представляющую длительность. |
name |
string |
Строка, представляющая URN возможности. |
type |
string:
delay |
Перечисление, которое различает модели действий. |
discreteAction
Модель, представляющая дискретное действие.
Имя | Тип | Описание |
---|---|---|
name |
string |
Строка, представляющая URN возможности. |
parameters |
Список пар "ключ-значение". |
|
selectorId |
string |
Строка, представляющая селектор. |
type |
string:
discrete |
Перечисление, которое различает модели действий. |
ErrorAdditionalInfo
Дополнительные сведения об ошибке управления ресурсами.
Имя | Тип | Описание |
---|---|---|
info |
object |
Дополнительные сведения. |
type |
string |
Тип дополнительных сведений. |
ErrorDetail
Сведения об ошибке.
Имя | Тип | Описание |
---|---|---|
additionalInfo |
Дополнительные сведения об ошибке. |
|
code |
string |
Код ошибки. |
details |
Сведения об ошибке. |
|
message |
string |
Сообщение об ошибке. |
target |
string |
Целевой объект ошибки. |
ErrorResponse
Сообщение об ошибке
Имя | Тип | Описание |
---|---|---|
error |
Объект ошибки. |
experiment
Модель, представляющая ресурс Experiment.
Имя | Тип | Описание |
---|---|---|
id |
string |
Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
Удостоверение ресурса эксперимента. |
|
location |
string |
Географическое расположение, в котором находится ресурс |
name |
string |
Имя ресурса. |
properties.provisioningState |
Последнее состояние подготовки для заданного ресурса эксперимента. |
|
properties.selectors | selector[]: |
Список селекторов. |
properties.steps |
step[] |
Список шагов. |
systemData |
Системные метаданные ресурса эксперимента. |
|
tags |
object |
Теги ресурсов. |
type |
string |
Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts" |
keyValuePair
Карта для описания параметров действия.
Имя | Тип | Описание |
---|---|---|
key |
string |
Имя параметра для действия. |
value |
string |
Значение параметра для действия. |
listSelector
Модель, представляющая селектор списка.
Имя | Тип | Описание |
---|---|---|
filter | filter: |
Модель, представляющая доступные типы фильтров, которые можно применить к списку целевых объектов. |
id |
string |
Строка идентификатора селектора. |
targets |
Список целевых ссылок. |
|
type |
string:
List |
Перечисление типа селектора. |
ProvisioningState
Последнее состояние подготовки для заданного ресурса эксперимента.
Имя | Тип | Описание |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
querySelector
Модель, представляющая селектор запросов.
Имя | Тип | Описание |
---|---|---|
filter | filter: |
Модель, представляющая доступные типы фильтров, которые можно применить к списку целевых объектов. |
id |
string |
Строка идентификатора селектора. |
queryString |
string |
Запрос языка запросов Azure Resource Graph (ARG) для целевых ресурсов. |
subscriptionIds |
string[] |
Список идентификаторов подписки для запроса область ресурса. |
type |
string:
Query |
Перечисление типа селектора. |
resourceIdentity
Удостоверение ресурса.
Имя | Тип | Описание |
---|---|---|
principalId |
string |
GUID, представляющий идентификатор субъекта этого удостоверения ресурса. |
tenantId |
string |
GUID, представляющий идентификатор клиента этого удостоверения ресурса. |
type |
Строка типа удостоверения ресурса. |
|
userAssignedIdentities |
<string,
User |
Удостоверения User-Assigned |
ResourceIdentityType
Строка типа удостоверения ресурса.
Имя | Тип | Описание |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
simpleFilter
Модель, представляющая простой целевой фильтр.
Имя | Тип | Описание |
---|---|---|
parameters |
Модель, представляющая параметры фильтра Simple. |
|
type |
string:
Simple |
Перечисление, различающее типы фильтров. В настоящее время поддерживается только |
simpleFilterParameters
Модель, представляющая параметры фильтра Simple.
Имя | Тип | Описание |
---|---|---|
zones |
string[] |
Список зон доступности Azure для фильтрации целевых объектов. |
step
Модель, представляющая шаг в ресурсе Experiment.
Имя | Тип | Описание |
---|---|---|
branches |
branch[] |
Список ветвей. |
name |
string |
Строка имени шага. |
systemData
Метаданные, относящиеся к созданию и последнему изменению ресурса.
Имя | Тип | Описание |
---|---|---|
createdAt |
string |
Метка времени создания ресурса (UTC). |
createdBy |
string |
Удостоверение, создающее ресурс. |
createdByType |
Тип удостоверения, создавшего ресурс. |
|
lastModifiedAt |
string |
Метка времени последнего изменения ресурса (UTC) |
lastModifiedBy |
string |
Удостоверение, которое в последний раз изменял ресурс. |
lastModifiedByType |
Тип удостоверения, изменяющего ресурс в последний раз. |
targetReference
Модель, представляющая ссылку на целевой объект в селекторе.
Имя | Тип | Описание |
---|---|---|
id |
string |
Строка идентификатора целевого ресурса. |
type |
Перечисление ссылочного типа Target. |
TargetReferenceType
Перечисление ссылочного типа Target.
Имя | Тип | Описание |
---|---|---|
ChaosTarget |
string |
UserAssignedIdentity
Свойства удостоверения, назначаемые пользователем
Имя | Тип | Описание |
---|---|---|
clientId |
string |
Идентификатор клиента назначенного удостоверения. |
principalId |
string |
Идентификатор субъекта назначенного удостоверения. |