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 minLength: 1 pattern: ^[^<>%&:?#/\\]+$	Строка, представляющая имя ресурса эксперимента.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Имя группы ресурсов. Имя не учитывает регистр.
subscriptionId	path	True	string (uuid)	Идентификатор целевой подписки. Значение должно быть UUID.
api-version	query	True	string minLength: 1	Версия 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

Object

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

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

ChaosExperimentStep

Object

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

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

ChaosTargetListSelector

Object

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

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

ChaosTargetQuerySelector

Object

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

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

ChaosTargetSimpleFilter

Object

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

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

ChaosTargetSimpleFilterParameters

Object

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

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

ContinuousAction

Object

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

Имя	Тип	Описание
duration	string (duration)	ISO8601 отформатированная строка, представляющая длительность.
name	string maxLength: 2048	Строка, представляющая URN возможности.
parameters	KeyValuePair[]	Список пар значений ключей.
selectorId	string minLength: 1	Строка, представляющая селектор.
type	string: continuous	Тип дискриминационных действий эксперимента хаоса

createdByType

Перечисление

Тип удостоверения, создавшего ресурс.

Значение	Описание
Application
Key
ManagedIdentity
User

DelayAction

Object

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

Имя	Тип	Описание
duration	string (duration)	ISO8601 отформатированная строка, представляющая длительность.
name	string maxLength: 2048	Строка, представляющая URN возможности.
type	string: delay	Тип дискриминационных действий эксперимента хаоса

DiscreteAction

Object

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

Имя	Тип	Описание
name	string maxLength: 2048	Строка, представляющая URN возможности.
parameters	KeyValuePair[]	Список пар значений ключей.
selectorId	string minLength: 1	Строка, представляющая селектор.
type	string: discrete	Тип дискриминационных действий эксперимента хаоса

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

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

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

ErrorResponse

Object

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

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

Experiment

Object

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

Имя	Тип	Описание
id	string (arm-id)	Полный идентификатор ресурса для ресурса. Например, "/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
delay
discrete

FilterType

Перечисление

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

Значение	Описание
Simple	Простой тип фильтра.

KeyValuePair

Object

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

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

ManagedServiceIdentity

Object

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

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

ManagedServiceIdentityType

Перечисление

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

Значение	Описание
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ProvisioningState

Перечисление

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

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

SelectorType

Перечисление

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

Значение	Описание
List	Тип селектора списка.
Query	Тип селектора запросов.

systemData

Object

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

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

TargetReference

Object

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

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

TargetReferenceType

Перечисление

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

Значение	Описание
ChaosTarget	Ссылочный тип целевого объекта Chaos.

UserAssignedIdentity

Object

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

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

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

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

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