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


Experiments - Create Or Update

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

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

Параметры URI

Имя В Обязательно Тип Описание
experimentName
path True

string

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

Шаблон регулярного выражения: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

Строка, представляющая группу ресурсов Azure.

Шаблон регулярного выражения: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

GUID, представляющий идентификатор подписки Azure.

Шаблон регулярного выражения: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$

api-version
query True

string

Строка, задающая версию API.

Шаблон регулярного выражения: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$

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

Имя Обязательно Тип Описание
location True

string

Географическое расположение, в котором находится ресурс

properties.selectors True selector[]:

Список селекторов.

properties.steps True

step[]

Список шагов.

identity

resourceIdentity

Удостоверение ресурса эксперимента.

tags

object

Теги ресурсов.

Ответы

Имя Тип Описание
200 OK

experiment

Длительная операция замены эксперимента.

201 Created

experiment

Длительная операция создания эксперимента.

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.

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

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 на эксперимент.

continuousAction

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

createdByType

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

delayAction

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

discreteAction

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

ErrorAdditionalInfo

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

ErrorDetail

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

ErrorResponse

Сообщение об ошибке

experiment

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

keyValuePair

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

listSelector

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

ProvisioningState

Последнее состояние подготовки для заданного ресурса эксперимента.

querySelector

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

resourceIdentity

Удостоверение ресурса.

ResourceIdentityType

Строка типа удостоверения ресурса.

simpleFilter

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

simpleFilterParameters

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

step

Модель, представляющая шаг в ресурсе Experiment.

systemData

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

targetReference

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

TargetReferenceType

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

UserAssignedIdentity

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

branch

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

Имя Тип Описание
actions action[]:

Список действий.

name

string

Строка имени ветви.

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

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

Имя Тип Описание
id

string

Полный идентификатор ресурса. Пример : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

Удостоверение ресурса эксперимента.

location

string

Географическое расположение, в котором находится ресурс

name

string

Имя ресурса.

properties.provisioningState

ProvisioningState

Последнее состояние подготовки для заданного ресурса эксперимента.

properties.selectors selector[]:

Список селекторов.

properties.steps

step[]

Список шагов.

systemData

systemData

Системные метаданные ресурса эксперимента.

tags

object

Теги ресурсов.

type

string

Тип ресурса. Например, "Microsoft.Compute/virtualMachines" или "Microsoft.Storage/storageAccounts"

keyValuePair

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

Имя Тип Описание
key

string

Имя параметра для действия.

value

string

Значение параметра для действия.

listSelector

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

Имя Тип Описание
filter filter:

simpleFilter

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

id

string

Строка идентификатора селектора.

targets

targetReference[]

Список целевых ссылок.

type string:

List

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

ProvisioningState

Последнее состояние подготовки для заданного ресурса эксперимента.

Имя Тип Описание
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

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

Имя Тип Описание
filter filter:

simpleFilter

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

id

string

Строка идентификатора селектора.

queryString

string

Запрос языка запросов Azure Resource Graph (ARG) для целевых ресурсов.

subscriptionIds

string[]

Список идентификаторов подписки для запроса область ресурса.

type string:

Query

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

resourceIdentity

Удостоверение ресурса.

Имя Тип Описание
principalId

string

GUID, представляющий идентификатор субъекта этого удостоверения ресурса.

tenantId

string

GUID, представляющий идентификатор клиента этого удостоверения ресурса.

type

ResourceIdentityType

Строка типа удостоверения ресурса.

userAssignedIdentities

<string,  UserAssignedIdentity>

Удостоверения User-Assigned
Список удостоверений пользователей, связанных с экспериментом. Ссылки на ключи словаря удостоверений пользователей будут иметь идентификаторы ресурсов ARM в форме: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ResourceIdentityType

Строка типа удостоверения ресурса.

Имя Тип Описание
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

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

Имя Тип Описание
parameters

simpleFilterParameters

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

type string:

Simple

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

simpleFilterParameters

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

Имя Тип Описание
zones

string[]

Список зон доступности Azure для фильтрации целевых объектов.

step

Модель, представляющая шаг в ресурсе Experiment.

Имя Тип Описание
branches

branch[]

Список ветвей.

name

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

UserAssignedIdentity

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

Имя Тип Описание
clientId

string

Идентификатор клиента назначенного удостоверения.

principalId

string

Идентификатор субъекта назначенного удостоверения.