共用方式為


Experiments - Create Or Update

建立或更新實驗資源。

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

URI 參數

名稱 位於 必要 類型 Description
experimentName
path True

string

表示實驗資源名稱的字串。

Regex 模式: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

代表 Azure 資源群組的字串。

Regex 模式: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

表示 Azure 訂用帳戶標識碼的 GUID。

Regex 模式: ^[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 版本的字串。

Regex 模式: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$

要求本文

名稱 必要 類型 Description
location True

string

資源所在的地理位置

properties.selectors True selector[]:

選取器清單。

properties.steps True

step[]

步驟清單。

identity

resourceIdentity

實驗資源的身分識別。

tags

object

資源標籤。

回應

名稱 類型 Description
200 OK

experiment

長時間執行的取代實驗作業。

201 Created

experiment

長時間執行建立實驗作業。

Other Status Codes

ErrorResponse

如果要求失敗,則傳回錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱 Description
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"
  }
}

定義

名稱 Description
branch

代表步驟中分支的模型。 每個實驗總計9個。

continuousAction

表示連續動作的模型。

createdByType

建立資源的身分識別類型。

delayAction

表示延遲動作的模型。

discreteAction

表示離散動作的模型。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

ErrorDetail

錯誤詳細數據。

ErrorResponse

錯誤回應

experiment

代表實驗資源的模型。

keyValuePair

描述動作設定的對應。

listSelector

代表清單選取器的模型。

ProvisioningState

指定實驗資源的最新布建狀態。

querySelector

表示查詢選取器的模型。

resourceIdentity

資源的身分識別。

ResourceIdentityType

資源識別類型的字串。

simpleFilter

代表簡單目標篩選條件的模型。

simpleFilterParameters

代表簡單篩選參數的模型。

step

代表實驗資源中步驟的模型。

systemData

與建立和上次修改資源相關的元數據。

targetReference

代表選取器中目標參考的模型。

TargetReferenceType

目標參考類型的列舉。

UserAssignedIdentity

使用者指派的身分識別屬性

branch

代表步驟中分支的模型。 每個實驗總計9個。

名稱 類型 Description
actions action[]:

動作清單。

name

string

分支名稱的字串。

continuousAction

表示連續動作的模型。

名稱 類型 Description
duration

string

ISO8601表示持續時間的格式化字串。

name

string

表示功能 URN 的字串。

parameters

keyValuePair[]

索引鍵值組的清單。

selectorId

string

表示選取器的字串。

type string:

continuous

區分動作模型之間的列舉。

createdByType

建立資源的身分識別類型。

名稱 類型 Description
Application

string

Key

string

ManagedIdentity

string

User

string

delayAction

表示延遲動作的模型。

名稱 類型 Description
duration

string

ISO8601表示持續時間的格式化字串。

name

string

表示功能 URN 的字串。

type string:

delay

區分動作模型之間的列舉。

discreteAction

表示離散動作的模型。

名稱 類型 Description
name

string

表示功能 URN 的字串。

parameters

keyValuePair[]

索引鍵值組的清單。

selectorId

string

表示選取器的字串。

type string:

discrete

區分動作模型之間的列舉。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。

type

string

其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。

code

string

錯誤碼。

details

ErrorDetail[]

錯誤詳細資料。

message

string

錯誤訊息。

target

string

錯誤目標。

ErrorResponse

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

experiment

代表實驗資源的模型。

名稱 類型 Description
id

string

資源的完整資源識別碼。 Ex - /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

描述動作設定的對應。

名稱 類型 Description
key

string

動作的設定名稱。

value

string

動作之設定的值。

listSelector

代表清單選取器的模型。

名稱 類型 Description
filter filter:

simpleFilter

模型,表示可套用至目標清單的可用篩選類型。

id

string

選取器識別碼的字串。

targets

targetReference[]

目標參考清單。

type string:

List

選取器類型的列舉。

ProvisioningState

指定實驗資源的最新布建狀態。

名稱 類型 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

表示查詢選取器的模型。

名稱 類型 Description
filter filter:

simpleFilter

模型,表示可套用至目標清單的可用篩選類型。

id

string

選取器識別碼的字串。

queryString

string

Azure Resource Graph (ARG) 目標資源的查詢語言查詢。

subscriptionIds

string[]

範圍資源查詢的訂用帳戶標識碼清單。

type string:

Query

選取器類型的列舉。

resourceIdentity

資源的身分識別。

名稱 類型 Description
principalId

string

GUID,表示此資源識別的主體標識符。

tenantId

string

GUID,表示此資源識別的租用戶標識碼。

type

ResourceIdentityType

資源識別類型的字串。

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned 身分識別
與實驗相關聯的使用者身分識別清單。 使用者身分識別字典索引鍵參考的格式為 ARM 資源標識符:'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'。

ResourceIdentityType

資源識別類型的字串。

名稱 類型 Description
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

代表簡單目標篩選條件的模型。

名稱 類型 Description
parameters

simpleFilterParameters

代表簡單篩選參數的模型。

type string:

Simple

區分篩選類型之間的列舉。 目前僅 Simple 支持類型。

simpleFilterParameters

代表簡單篩選參數的模型。

名稱 類型 Description
zones

string[]

要依據篩選目標的 Azure 可用性區域清單。

step

代表實驗資源中步驟的模型。

名稱 類型 Description
branches

branch[]

分支清單。

name

string

步驟名稱的字串。

systemData

與建立和上次修改資源相關的元數據。

名稱 類型 Description
createdAt

string

資源建立的時間戳 (UTC) 。

createdBy

string

建立資源的身分識別。

createdByType

createdByType

建立資源的身分識別類型。

lastModifiedAt

string

上次修改的資源時間戳 (UTC)

lastModifiedBy

string

上次修改資源的身分識別。

lastModifiedByType

createdByType

上次修改資源的身分識別類型。

targetReference

代表選取器中目標參考的模型。

名稱 類型 Description
id

string

目標資源的資源識別符字串。

type

TargetReferenceType

目標參考類型的列舉。

TargetReferenceType

目標參考類型的列舉。

名稱 類型 Description
ChaosTarget

string

UserAssignedIdentity

使用者指派的身分識別屬性

名稱 類型 Description
clientId

string

指派之身分識別的用戶端標識碼。

principalId

string

指派之身分識別的主體標識碼。