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 |
---|---|---|---|---|
experiment
|
path | True |
string |
表示實驗資源名稱的字串。 Regex 模式: |
resource
|
path | True |
string |
代表 Azure 資源群組的字串。 Regex 模式: |
subscription
|
path | True |
string |
表示 Azure 訂用帳戶標識碼的 GUID。 Regex 模式: |
api-version
|
query | True |
string |
設定 API 版本的字串。 Regex 模式: |
要求本文
名稱 | 必要 | 類型 | Description |
---|---|---|---|
location | True |
string |
資源所在的地理位置 |
properties.selectors | True | selector[]: |
選取器清單。 |
properties.steps | True |
step[] |
步驟清單。 |
identity |
實驗資源的身分識別。 |
||
tags |
object |
資源標籤。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
長時間執行的取代實驗作業。 |
|
201 Created |
長時間執行建立實驗作業。 |
|
Other Status Codes |
如果要求失敗,則傳回錯誤回應。 |
安全性
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個。 |
continuous |
表示連續動作的模型。 |
created |
建立資源的身分識別類型。 |
delay |
表示延遲動作的模型。 |
discrete |
表示離散動作的模型。 |
Error |
資源管理錯誤其他資訊。 |
Error |
錯誤詳細數據。 |
Error |
錯誤回應 |
experiment |
代表實驗資源的模型。 |
key |
描述動作設定的對應。 |
list |
代表清單選取器的模型。 |
Provisioning |
指定實驗資源的最新布建狀態。 |
query |
表示查詢選取器的模型。 |
resource |
資源的身分識別。 |
Resource |
資源識別類型的字串。 |
simple |
代表簡單目標篩選條件的模型。 |
simple |
代表簡單篩選參數的模型。 |
step |
代表實驗資源中步驟的模型。 |
system |
與建立和上次修改資源相關的元數據。 |
target |
代表選取器中目標參考的模型。 |
Target |
目標參考類型的列舉。 |
User |
使用者指派的身分識別屬性 |
branch
代表步驟中分支的模型。 每個實驗總計9個。
名稱 | 類型 | Description |
---|---|---|
actions | action[]: |
動作清單。 |
name |
string |
分支名稱的字串。 |
continuousAction
表示連續動作的模型。
名稱 | 類型 | Description |
---|---|---|
duration |
string |
ISO8601表示持續時間的格式化字串。 |
name |
string |
表示功能 URN 的字串。 |
parameters |
索引鍵值組的清單。 |
|
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 |
索引鍵值組的清單。 |
|
selectorId |
string |
表示選取器的字串。 |
type |
string:
discrete |
區分動作模型之間的列舉。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
名稱 | 類型 | Description |
---|---|---|
info |
object |
其他資訊。 |
type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
名稱 | 類型 | Description |
---|---|---|
additionalInfo |
錯誤其他資訊。 |
|
code |
string |
錯誤碼。 |
details |
錯誤詳細資料。 |
|
message |
string |
錯誤訊息。 |
target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
名稱 | 類型 | Description |
---|---|---|
error |
error 物件。 |
experiment
代表實驗資源的模型。
名稱 | 類型 | Description |
---|---|---|
id |
string |
資源的完整資源識別碼。 Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
實驗資源的身分識別。 |
|
location |
string |
資源所在的地理位置 |
name |
string |
資源的名稱 |
properties.provisioningState |
指定實驗資源的最新布建狀態。 |
|
properties.selectors | selector[]: |
選取器清單。 |
properties.steps |
step[] |
步驟清單。 |
systemData |
實驗資源的系統元數據。 |
|
tags |
object |
資源標籤。 |
type |
string |
資源類型。 例如“Microsoft.Compute/virtualMachines” 或 “Microsoft.Storage/storageAccounts” |
keyValuePair
描述動作設定的對應。
名稱 | 類型 | Description |
---|---|---|
key |
string |
動作的設定名稱。 |
value |
string |
動作之設定的值。 |
listSelector
代表清單選取器的模型。
名稱 | 類型 | Description |
---|---|---|
filter | filter: |
模型,表示可套用至目標清單的可用篩選類型。 |
id |
string |
選取器識別碼的字串。 |
targets |
目標參考清單。 |
|
type |
string:
List |
選取器類型的列舉。 |
ProvisioningState
指定實驗資源的最新布建狀態。
名稱 | 類型 | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
querySelector
表示查詢選取器的模型。
名稱 | 類型 | Description |
---|---|---|
filter | filter: |
模型,表示可套用至目標清單的可用篩選類型。 |
id |
string |
選取器識別碼的字串。 |
queryString |
string |
Azure Resource Graph (ARG) 目標資源的查詢語言查詢。 |
subscriptionIds |
string[] |
範圍資源查詢的訂用帳戶標識碼清單。 |
type |
string:
Query |
選取器類型的列舉。 |
resourceIdentity
資源的身分識別。
名稱 | 類型 | Description |
---|---|---|
principalId |
string |
GUID,表示此資源識別的主體標識符。 |
tenantId |
string |
GUID,表示此資源識別的租用戶標識碼。 |
type |
資源識別類型的字串。 |
|
userAssignedIdentities |
<string,
User |
User-Assigned 身分識別 |
ResourceIdentityType
資源識別類型的字串。
名稱 | 類型 | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
simpleFilter
代表簡單目標篩選條件的模型。
名稱 | 類型 | Description |
---|---|---|
parameters |
代表簡單篩選參數的模型。 |
|
type |
string:
Simple |
區分篩選類型之間的列舉。 目前僅 |
simpleFilterParameters
代表簡單篩選參數的模型。
名稱 | 類型 | Description |
---|---|---|
zones |
string[] |
要依據篩選目標的 Azure 可用性區域清單。 |
step
代表實驗資源中步驟的模型。
名稱 | 類型 | Description |
---|---|---|
branches |
branch[] |
分支清單。 |
name |
string |
步驟名稱的字串。 |
systemData
與建立和上次修改資源相關的元數據。
名稱 | 類型 | Description |
---|---|---|
createdAt |
string |
資源建立的時間戳 (UTC) 。 |
createdBy |
string |
建立資源的身分識別。 |
createdByType |
建立資源的身分識別類型。 |
|
lastModifiedAt |
string |
上次修改的資源時間戳 (UTC) |
lastModifiedBy |
string |
上次修改資源的身分識別。 |
lastModifiedByType |
上次修改資源的身分識別類型。 |
targetReference
代表選取器中目標參考的模型。
名稱 | 類型 | Description |
---|---|---|
id |
string |
目標資源的資源識別符字串。 |
type |
目標參考類型的列舉。 |
TargetReferenceType
目標參考類型的列舉。
名稱 | 類型 | Description |
---|---|---|
ChaosTarget |
string |
UserAssignedIdentity
使用者指派的身分識別屬性
名稱 | 類型 | Description |
---|---|---|
clientId |
string |
指派之身分識別的用戶端標識碼。 |
principalId |
string |
指派之身分識別的主體標識碼。 |