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

ステップの分岐を表すモデル。実験あたり 9 つの合計。

名前	型	説明
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	アクションの一覧。
name	string	ブランチ名の文字列。

ChaosExperimentStep

実験リソースのステップを表すモデル。

名前	型	説明
branches	ChaosExperimentBranch[]	ブランチの一覧。
name	string	ステップ名の文字列。

ChaosTargetListSelector

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

名前	型	説明
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	ターゲットリストに適用できる使用可能なフィルターの種類を表すモデル。
id	string	セレクター ID の文字列。
targets	TargetReference[]	ターゲット参照の一覧。
type	string: List	Chaos ターゲットセレクター識別子の種類

ChaosTargetQuerySelector

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

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

ChaosTargetSimpleFilter

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

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

ChaosTargetSimpleFilterParameters

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

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

ContinuousAction

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

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

createdByType

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

名前	型	説明
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	リソースの完全修飾リソース 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	string
delay	string
discrete	string

FilterType

フィルターの種類を区別する列挙型。現在、Simple の種類のみがサポートされています。

名前	型	説明
Simple	string	単純なフィルターの種類。

KeyValuePair

アクションの設定を記述するマップ。

名前	型	説明
key	string	アクションの設定の名前。
value	string	アクションの設定の値。

ManagedServiceIdentity

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

名前	型	説明
principalId	string	システム割り当て ID のサービスプリンシパル ID。このプロパティは、システム割り当て ID にのみ提供されます。
tenantId	string	システム割り当て 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	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	リソースを作成した ID。
createdByType	createdByType	リソースを作成した ID の種類。
lastModifiedAt	string	リソースの最終変更のタイムスタンプ (UTC)
lastModifiedBy	string	リソースを最後に変更した ID。
lastModifiedByType	createdByType	リソースを最後に変更した ID の種類。

TargetReference

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

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

TargetReferenceType

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

名前	型	説明
ChaosTarget	string	Chaos ターゲット参照型。

UserAssignedIdentity

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

名前	型	説明
clientId	string	割り当てられた ID のクライアント ID。
principalId	string	割り当てられた 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

その他のリソース