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)	ターゲットサブスクリプションの ID。値は UUID である必要があります。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

要求本文

名前	必須	型	説明
location	True	string	リソースが存在する地理的な場所
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	セレクターの一覧。
properties.steps	True	ChaosExperimentStep[]	手順の一覧。
identity		ManagedServiceIdentity	このリソースに割り当てられているマネージドサービス ID。
tags		object	リソースタグ。

応答

名前	型	説明
200 OK	Experiment	リソース 'Experiment' 更新操作が成功しました
201 Created	Experiment	リソース 'Experiment' の作成操作が成功しましたヘッダー Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	予期しないエラー応答。

名前

型

説明

200 OK

Experiment

リソース 'Experiment' 更新操作が成功しました

201 Created

Experiment

リソース 'Experiment' の作成操作が成功しました

ヘッダー

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 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	Simple フィルターパラメーターを表すモデル。
ContinuousAction	継続的なアクションを表すモデル。
createdByType	リソースを作成した ID の種類。
DelayAction	遅延アクションを表すモデル。
DiscreteAction	不連続アクションを表すモデル。
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
Experiment	実験リソースを表すモデル。
ExperimentActionType	Chaos 実験アクションの種類の列挙型和集合。
FilterType	フィルターの種類を区別する列挙型。現在、`Simple` の種類のみがサポートされています。
KeyValuePair	アクションの設定を記述するマップ。
ManagedServiceIdentity	マネージドサービス ID (システム割り当て ID またはユーザー割り当て ID)
ManagedServiceIdentityType	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。
ProvisioningState	特定の Azure Chaos リソースの現在のプロビジョニング状態。
SelectorType	セレクター型の列挙型。
systemData	リソースの作成と最後の変更に関連するメタデータ。
TargetReference	セレクター内のターゲットへの参照を表すモデル。
TargetReferenceType	ターゲット参照型の列挙型。
UserAssignedIdentity	ユーザー割り当て ID プロパティ

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	セレクター ID の文字列。
targets	TargetReference[]	ターゲット参照の一覧。
type	string: List	Chaos ターゲットセレクター識別子の種類

ChaosTargetQuerySelector

Object

クエリセレクターを表すモデル。

名前	型	説明
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	ターゲットリストに適用できる使用可能なフィルターの種類を表すモデル。
id	string minLength: 1	セレクター ID の文字列。
queryString	string	ターゲットリソースの Azure Resource Graph (ARG) クエリ言語クエリ。
subscriptionIds	string[]	リソースクエリのスコープを設定するサブスクリプション ID リスト。
type	string: Query	Chaos ターゲットセレクター識別子の種類

ChaosTargetSimpleFilter

Object

単純なターゲットフィルターを表すモデル。

名前	型	説明
parameters	ChaosTargetSimpleFilterParameters	Simple フィルターパラメーターを表すモデル。
type	string: Simple	Chaos ターゲットフィルター識別子の種類

ChaosTargetSimpleFilterParameters

Object

Simple フィルターパラメーターを表すモデル。

名前	型	説明
zones	string[]	ターゲットをフィルター処理する Azure 可用性ゾーンの一覧。

ContinuousAction

Object

継続的なアクションを表すモデル。

名前	型	説明
duration	string (duration)	ISO8601期間を表す書式設定された文字列です。
name	string maxLength: 2048	機能 URN を表す文字列。
parameters	KeyValuePair[]	キー値ペアの一覧。
selectorId	string minLength: 1	セレクターを表す文字列。
type	string: continuous	カオス実験アクション識別子の種類

createdByType

列挙

リソースを作成した ID の種類。

値	説明
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)	リソースの完全修飾リソース ID。例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	このリソースに割り当てられているマネージドサービス ID。
location	string	リソースが存在する地理的な場所
name	string	リソースの名前
properties.provisioningState	ProvisioningState	特定の実験リソースの最新のプロビジョニング状態。
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	セレクターの一覧。
properties.steps	ChaosExperimentStep[]	手順の一覧。
systemData	systemData	createdBy と modifiedBy 情報を含む Azure Resource Manager メタデータ。
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

マネージドサービス ID (システム割り当て ID またはユーザー割り当て ID)

名前	型	説明
principalId	string (uuid)	システム割り当て ID のサービスプリンシパル ID。このプロパティは、システム割り当て ID にのみ提供されます。
tenantId	string (uuid)	システム割り当て ID のテナント ID。このプロパティは、システム割り当て ID にのみ提供されます。
type	ManagedServiceIdentityType	マネージドサービス ID の種類 (SystemAssigned 型と UserAssigned 型の両方が許可されます)。
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned ID リソースに関連付けられているユーザー割り当て ID のセット。 userAssignedIdentities ディクショナリキーは、'/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} という形式の ARM リソース ID になります。ディクショナリ値は、要求内の空のオブジェクト ({}) にすることができます。

ManagedServiceIdentityType

列挙

マネージドサービス ID の種類 (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	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string (date-time)	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

TargetReference

Object

セレクター内のターゲットへの参照を表すモデル。

名前	型	説明
id	string (arm-id)	ターゲットリソースのリソース ID の文字列。
type	TargetReferenceType	ターゲット参照型の列挙型。

TargetReferenceType

列挙

ターゲット参照型の列挙型。

値	説明
ChaosTarget	Chaos ターゲット参照型。

UserAssignedIdentity

Object

ユーザー割り当て ID プロパティ

名前	型	説明
clientId	string (uuid)	割り当てられた ID のクライアント ID。
principalId	string (uuid)	割り当てられた ID のプリンシパル ID。

次の方法で共有

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

その他のリソース