Experiments - Create Or Update

Ссылка

Служба:: Chaos Studio

Версия API:: 2025-01-01

Создайте или обновите ресурс эксперимента.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
experimentName	path	True	string	Строка, представляющая имя ресурса эксперимента. Шаблон регулярного выражения: `^[^<>%&:?#/\\]+$`
resourceGroupName	path	True	string	Имя группы ресурсов. Имя не учитывает регистр.
subscriptionId	path	True	string uuid	Идентификатор целевой подписки. Значение должно быть UUID.
api-version	query	True	string	Версия API, используемая для этой операции.

Текст запроса

Имя	Обязательно	Тип	Описание
location	True	string	Географическое расположение, в котором находится ресурс
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Список селекторов.
properties.steps	True	ChaosExperimentStep[]	Список шагов.
identity		ManagedServiceIdentity	Удостоверения управляемой службы, назначенные этому ресурсу.
tags		object	Теги ресурсов.

Ответы

Имя	Тип	Описание
200 OK	Experiment	Операция обновления ресурса "Эксперимент" выполнена успешно
201 Created	Experiment	Операция создания ресурса "Эксперимент" выполнена успешно Заголовки Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Непредвиденное сообщение об ошибке.

Имя

Тип

Описание

200 OK

Experiment

Операция обновления ресурса "Эксперимент" выполнена успешно

201 Created

Experiment

Операция создания ресурса "Эксперимент" выполнена успешно

Заголовки

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Непредвиденное сообщение об ошибке.

Безопасность

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.

Образец запроса

HTTP

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

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

Пример ответа

Код состояния:: 200

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-11-01-preview
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-11-01-preview

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

Код состояния:: 201

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-11-01-preview
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-11-01-preview

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

Определения

Имя	Описание
ChaosExperimentBranch	Модель, представляющая ветвь на шаге. 9 итогов за эксперимент.
ChaosExperimentStep	Модель, представляющая шаг в ресурсе "Эксперимент".
ChaosTargetListSelector	Модель, представляющая селектор списка.
ChaosTargetQuerySelector	Модель, представляющая селектор запросов.
ChaosTargetSimpleFilter	Модель, представляющая простой целевой фильтр.
ChaosTargetSimpleFilterParameters	Модель, представляющая параметры простого фильтра.
ContinuousAction	Модель, представляющая непрерывное действие.
createdByType	Тип удостоверения, создавшего ресурс.
DelayAction	Модель, представляющая действие задержки.
DiscreteAction	Модель, представляющая дискретное действие.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
Experiment	Модель, представляющая ресурс эксперимента.
ExperimentActionType	Объединение действий эксперимента Chaos.
FilterType	Перечисление, которое дискриминирует типы фильтров. В настоящее время поддерживается только тип `Simple`.
KeyValuePair	Карта для описания параметров действия.
ManagedServiceIdentity	Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения
ManagedServiceIdentityType	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).
ProvisioningState	Текущее состояние подготовки для заданного ресурса Azure Chaos.
SelectorType	Перечисление типа селектора.
systemData	Метаданные, относящиеся к созданию и последнему изменении ресурса.
TargetReference	Модель, представляющая ссылку на целевой объект в селекторе.
TargetReferenceType	Перечисление ссылочного типа Target.
UserAssignedIdentity	Свойства назначаемого пользователем удостоверения

ChaosExperimentBranch

Модель, представляющая ветвь на шаге. 9 итогов за эксперимент.

Имя	Тип	Описание
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Список действий.
name	string	Строка имени ветви.

ChaosExperimentStep

Модель, представляющая шаг в ресурсе "Эксперимент".

Имя	Тип	Описание
branches	ChaosExperimentBranch[]	Список ветвей.
name	string	Строка имени шага.

ChaosTargetListSelector

Модель, представляющая селектор списка.

Имя	Тип	Описание
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Модель, представляющая доступные типы фильтров, которые можно применить к списку целевых объектов.
id	string	Строка идентификатора селектора.
targets	TargetReference[]	Список ссылок на целевые объекты.
type	string: List	Тип селектора цели Хаоса

ChaosTargetQuerySelector

Модель, представляющая селектор запросов.

Имя	Тип	Описание
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Модель, представляющая доступные типы фильтров, которые можно применить к списку целевых объектов.
id	string	Строка идентификатора селектора.
queryString	string	Запрос языка запросов Azure Resource Graph (ARG) для целевых ресурсов.
subscriptionIds	string[]	Список идентификаторов подписки для запроса ресурсов области.
type	string: Query	Тип селектора цели Хаоса

ChaosTargetSimpleFilter

Модель, представляющая простой целевой фильтр.

Имя	Тип	Описание
parameters	ChaosTargetSimpleFilterParameters	Модель, представляющая параметры простого фильтра.
type	string: Simple	Тип дискриминационных фильтров для целевого фильтра хаоса

ChaosTargetSimpleFilterParameters

Модель, представляющая параметры простого фильтра.

Имя	Тип	Описание
zones	string[]	Список зон доступности Azure для фильтрации целевых объектов по.

ContinuousAction

Модель, представляющая непрерывное действие.

Имя	Тип	Описание
duration	string	ISO8601 отформатированная строка, представляющая длительность.
name	string	Строка, представляющая URN возможности.
parameters	KeyValuePair[]	Список пар значений ключей.
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	KeyValuePair[]	Список пар значений ключей.
selectorId	string	Строка, представляющая селектор.
type	string: discrete	Тип дискриминационных действий эксперимента хаоса

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

Experiment

Модель, представляющая ресурс эксперимента.

Имя	Тип	Описание
id	string	Полный идентификатор ресурса для ресурса. Например, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Удостоверения управляемой службы, назначенные этому ресурсу.
location	string	Географическое расположение, в котором находится ресурс
name	string	Имя ресурса
properties.provisioningState	ProvisioningState	Последнее состояние подготовки для заданного ресурса эксперимента.
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Список селекторов.
properties.steps	ChaosExperimentStep[]	Список шагов.
systemData	systemData	Метаданные Azure Resource Manager, содержащие данные createdBy и modifiedBy.
tags	object	Теги ресурсов.
type	string	Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

ExperimentActionType

Объединение действий эксперимента Chaos.

Имя	Тип	Описание
continuous	string
delay	string
discrete	string

FilterType

Перечисление, которое дискриминирует типы фильтров. В настоящее время поддерживается только тип Simple.

Имя	Тип	Описание
Simple	string	Простой тип фильтра.

KeyValuePair

Карта для описания параметров действия.

Имя	Тип	Описание
key	string	Имя параметра действия.
value	string	Значение параметра действия.

ManagedServiceIdentity

Управляемое удостоверение службы (назначенные системой удостоверения и (или) назначенные пользователем удостоверения

Имя	Тип	Описание
principalId	string	Идентификатор субъекта-службы назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.
tenantId	string	Идентификатор клиента назначенного системой удостоверения. Это свойство будет предоставлено только для назначаемого системой удостоверения.
type	ManagedServiceIdentityType	Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	удостоверения User-Assigned Набор назначенных пользователем удостоверений, связанных с ресурсом. Ключи словаря userAssignedIdentities будут идентификаторами ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Значения словаря могут быть пустыми объектами ({}) в запросах.

ManagedServiceIdentityType

Тип управляемого удостоверения службы (где разрешены типы SystemAssigned и UserAssigned).

Имя	Тип	Описание
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ProvisioningState

Текущее состояние подготовки для заданного ресурса Azure Chaos.

Имя	Тип	Описание
Canceled	string	Создание ресурсов было отменено.
Creating	string	Начальное создание выполняется.
Deleting	string	Выполняется удаление.
Failed	string	Не удалось создать ресурс.
Succeeded	string	Ресурс создан.
Updating	string	Выполняется обновление.

SelectorType

Перечисление типа селектора.

Имя	Тип	Описание
List	string	Тип селектора списка.
Query	string	Тип селектора запросов.

systemData

Метаданные, относящиеся к созданию и последнему изменении ресурса.

Имя	Тип	Описание
createdAt	string	Метка времени создания ресурса (UTC).
createdBy	string	Удостоверение, создающее ресурс.
createdByType	createdByType	Тип удостоверения, создавшего ресурс.
lastModifiedAt	string	Метка времени последнего изменения ресурса (UTC)
lastModifiedBy	string	Идентификатор, который последний раз изменил ресурс.
lastModifiedByType	createdByType	Тип удостоверения, который последний раз изменил ресурс.

TargetReference

Модель, представляющая ссылку на целевой объект в селекторе.

Имя	Тип	Описание
id	string	Строка идентификатора ресурса целевого ресурса.
type	TargetReferenceType	Перечисление ссылочного типа Target.

TargetReferenceType

Перечисление ссылочного типа Target.

Имя	Тип	Описание
ChaosTarget	string	Ссылочный тип целевого объекта Chaos.

UserAssignedIdentity

Свойства назначаемого пользователем удостоверения

Имя	Тип	Описание
clientId	string	Идентификатор клиента назначенного удостоверения.
principalId	string	Основной идентификатор назначенного удостоверения.

Поделиться через

Experiments - Create Or Update

Параметры URI

Текст запроса

Ответы

Безопасность

azure_auth

Области

Примеры

Create/update a Experiment in a resource group.

Образец запроса

Пример ответа

Определения

ChaosExperimentBranch

ChaosExperimentStep

ChaosTargetListSelector

ChaosTargetQuerySelector

ChaosTargetSimpleFilter

ChaosTargetSimpleFilterParameters

ContinuousAction

createdByType

DelayAction

DiscreteAction

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Experiment

ExperimentActionType

FilterType

KeyValuePair

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

SelectorType

systemData

TargetReference

TargetReferenceType

UserAssignedIdentity

Дополнительные ресурсы