Experiments - Create Or Update
실험 리소스를 만들거나 업데이트합니다.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Chaos/experiments/{experimentName}?api-version=2024-01-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
experiment
|
path | True |
string |
실험 리소스 이름을 나타내는 문자열입니다. regex 패턴: |
resource
|
path | True |
string |
Azure 리소스 그룹을 나타내는 문자열입니다. regex 패턴: |
subscription
|
path | True |
string |
Azure 구독 ID를 나타내는 GUID입니다. regex 패턴: |
api-version
|
query | True |
string |
API 버전을 설정하는 문자열입니다. regex 패턴: |
요청 본문
Name | 필수 | 형식 | Description |
---|---|---|---|
location | True |
string |
리소스가 있는 지리적 위치 |
properties.selectors | True | selector[]: |
선택기 목록입니다. |
properties.steps | True |
step[] |
단계 목록입니다. |
identity |
실험 리소스의 ID입니다. |
||
tags |
object |
리소스 태그. |
응답
Name | 형식 | 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
범위
Name | 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"
}
}
정의
Name | Description |
---|---|
branch |
단계의 분기를 나타내는 모델입니다. 실험당 총 9개. |
continuous |
연속 작업을 나타내는 모델입니다. |
created |
리소스를 만든 ID 유형입니다. |
delay |
지연 작업을 나타내는 모델입니다. |
discrete |
불연속 작업을 나타내는 모델입니다. |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
experiment |
실험 리소스를 나타내는 모델입니다. |
key |
작업의 설정을 설명하는 맵입니다. |
list |
목록 선택기를 나타내는 모델입니다. |
Provisioning |
지정된 실험 리소스에 대한 가장 최근의 프로비전 상태입니다. |
query |
쿼리 선택기를 나타내는 모델입니다. |
resource |
리소스의 ID입니다. |
Resource |
리소스 ID 유형의 문자열입니다. |
simple |
간단한 대상 필터를 나타내는 모델입니다. |
simple |
단순 필터 매개 변수를 나타내는 모델입니다. |
step |
실험 리소스의 단계를 나타내는 모델입니다. |
system |
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다. |
target |
선택기에서 대상에 대한 참조를 나타내는 모델입니다. |
Target |
대상 참조 형식의 열거형입니다. |
User |
사용자 할당 ID 속성 |
branch
단계의 분기를 나타내는 모델입니다. 실험당 총 9개.
Name | 형식 | Description |
---|---|---|
actions | action[]: |
작업 목록입니다. |
name |
string |
분기 이름의 문자열입니다. |
continuousAction
연속 작업을 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
duration |
string |
기간을 나타내는 형식이 지정된 문자열을 ISO8601. |
name |
string |
기능 URN을 나타내는 문자열입니다. |
parameters |
키 값 쌍 목록입니다. |
|
selectorId |
string |
선택기를 나타내는 문자열입니다. |
type |
string:
continuous |
작업 모델을 구분하는 열거형입니다. |
createdByType
리소스를 만든 ID 유형입니다.
Name | 형식 | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
delayAction
지연 작업을 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
duration |
string |
기간을 나타내는 형식이 지정된 문자열을 ISO8601. |
name |
string |
기능 URN을 나타내는 문자열입니다. |
type |
string:
delay |
작업 모델을 구분하는 열거형입니다. |
discreteAction
불연속 작업을 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
name |
string |
기능 URN을 나타내는 문자열입니다. |
parameters |
키 값 쌍 목록입니다. |
|
selectorId |
string |
선택기를 나타내는 문자열입니다. |
type |
string:
discrete |
작업 모델을 구분하는 열거형입니다. |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
Error 개체. |
experiment
실험 리소스를 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
실험 리소스의 ID입니다. |
|
location |
string |
리소스가 있는 지리적 위치 |
name |
string |
리소스의 이름입니다. |
properties.provisioningState |
지정된 실험 리소스에 대한 가장 최근의 프로비전 상태입니다. |
|
properties.selectors | selector[]: |
선택기 목록입니다. |
properties.steps |
step[] |
단계 목록입니다. |
systemData |
실험 리소스의 시스템 메타데이터입니다. |
|
tags |
object |
리소스 태그. |
type |
string |
리소스 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
keyValuePair
작업의 설정을 설명하는 맵입니다.
Name | 형식 | Description |
---|---|---|
key |
string |
작업에 대한 설정의 이름입니다. |
value |
string |
작업에 대한 설정의 값입니다. |
listSelector
목록 선택기를 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
filter | filter: |
대상 목록에 적용할 수 있는 사용 가능한 필터 형식을 나타내는 모델입니다. |
id |
string |
선택기 ID의 문자열입니다. |
targets |
대상 참조 목록입니다. |
|
type |
string:
List |
선택기 유형의 열거형입니다. |
ProvisioningState
지정된 실험 리소스에 대한 가장 최근의 프로비전 상태입니다.
Name | 형식 | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
querySelector
쿼리 선택기를 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
filter | filter: |
대상 목록에 적용할 수 있는 사용 가능한 필터 형식을 나타내는 모델입니다. |
id |
string |
선택기 ID의 문자열입니다. |
queryString |
string |
대상 리소스에 대한 ARG(Azure Resource Graph) 쿼리 언어 쿼리입니다. |
subscriptionIds |
string[] |
리소스 쿼리를 scope 구독 ID 목록입니다. |
type |
string:
Query |
선택기 유형의 열거형입니다. |
resourceIdentity
리소스의 ID입니다.
Name | 형식 | Description |
---|---|---|
principalId |
string |
이 리소스 ID의 주체 ID를 나타내는 GUID입니다. |
tenantId |
string |
이 리소스 ID의 테넌트 ID를 나타내는 GUID입니다. |
type |
리소스 ID 유형의 문자열입니다. |
|
userAssignedIdentities |
<string,
User |
User-Assigned ID |
ResourceIdentityType
리소스 ID 유형의 문자열입니다.
Name | 형식 | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
simpleFilter
간단한 대상 필터를 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
parameters |
단순 필터 매개 변수를 나타내는 모델입니다. |
|
type |
string:
Simple |
필터 형식을 구분하는 열거형입니다. 현재는 형식만 |
simpleFilterParameters
단순 필터 매개 변수를 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
zones |
string[] |
대상을 필터링할 Azure 가용성 영역 목록입니다. |
step
실험 리소스의 단계를 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
branches |
branch[] |
분기 목록입니다. |
name |
string |
단계 이름의 문자열입니다. |
systemData
리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string |
UTC(리소스 만들기)의 타임스탬프입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID 유형입니다. |
|
lastModifiedAt |
string |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID 유형입니다. |
targetReference
선택기에서 대상에 대한 참조를 나타내는 모델입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
대상 리소스의 리소스 ID 문자열입니다. |
type |
대상 참조 형식의 열거형입니다. |
TargetReferenceType
대상 참조 형식의 열거형입니다.
Name | 형식 | Description |
---|---|---|
ChaosTarget |
string |
UserAssignedIdentity
사용자 할당 ID 속성
Name | 형식 | Description |
---|---|---|
clientId |
string |
할당된 ID의 클라이언트 ID입니다. |
principalId |
string |
할당된 ID의 보안 주체 ID입니다. |