다음을 통해 공유


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
experimentName
path True

string

실험 리소스 이름을 나타내는 문자열입니다.

regex 패턴: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

Azure 리소스 그룹을 나타내는 문자열입니다.

regex 패턴: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

Azure 구독 ID를 나타내는 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)$

요청 본문

Name 필수 형식 Description
location True

string

리소스가 있는 지리적 위치

properties.selectors True selector[]:

선택기 목록입니다.

properties.steps True

step[]

단계 목록입니다.

identity

resourceIdentity

실험 리소스의 ID입니다.

tags

object

리소스 태그.

응답

Name 형식 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

범위

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개.

continuousAction

연속 작업을 나타내는 모델입니다.

createdByType

리소스를 만든 ID 유형입니다.

delayAction

지연 작업을 나타내는 모델입니다.

discreteAction

불연속 작업을 나타내는 모델입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

ErrorDetail

오류 세부 정보입니다.

ErrorResponse

오류 응답

experiment

실험 리소스를 나타내는 모델입니다.

keyValuePair

작업의 설정을 설명하는 맵입니다.

listSelector

목록 선택기를 나타내는 모델입니다.

ProvisioningState

지정된 실험 리소스에 대한 가장 최근의 프로비전 상태입니다.

querySelector

쿼리 선택기를 나타내는 모델입니다.

resourceIdentity

리소스의 ID입니다.

ResourceIdentityType

리소스 ID 유형의 문자열입니다.

simpleFilter

간단한 대상 필터를 나타내는 모델입니다.

simpleFilterParameters

단순 필터 매개 변수를 나타내는 모델입니다.

step

실험 리소스의 단계를 나타내는 모델입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

targetReference

선택기에서 대상에 대한 참조를 나타내는 모델입니다.

TargetReferenceType

대상 참조 형식의 열거형입니다.

UserAssignedIdentity

사용자 할당 ID 속성

branch

단계의 분기를 나타내는 모델입니다. 실험당 총 9개.

Name 형식 Description
actions action[]:

작업 목록입니다.

name

string

분기 이름의 문자열입니다.

continuousAction

연속 작업을 나타내는 모델입니다.

Name 형식 Description
duration

string

기간을 나타내는 형식이 지정된 문자열을 ISO8601.

name

string

기능 URN을 나타내는 문자열입니다.

parameters

keyValuePair[]

키 값 쌍 목록입니다.

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

keyValuePair[]

키 값 쌍 목록입니다.

selectorId

string

선택기를 나타내는 문자열입니다.

type string:

discrete

작업 모델을 구분하는 열거형입니다.

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.

type

string

추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.

code

string

오류 코드입니다.

details

ErrorDetail[]

오류 세부 정보입니다.

message

string

오류 메시지입니다.

target

string

오류 대상입니다.

ErrorResponse

오류 응답

Name 형식 Description
error

ErrorDetail

Error 개체.

experiment

실험 리소스를 나타내는 모델입니다.

Name 형식 Description
id

string

리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

실험 리소스의 ID입니다.

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

작업의 설정을 설명하는 맵입니다.

Name 형식 Description
key

string

작업에 대한 설정의 이름입니다.

value

string

작업에 대한 설정의 값입니다.

listSelector

목록 선택기를 나타내는 모델입니다.

Name 형식 Description
filter filter:

simpleFilter

대상 목록에 적용할 수 있는 사용 가능한 필터 형식을 나타내는 모델입니다.

id

string

선택기 ID의 문자열입니다.

targets

targetReference[]

대상 참조 목록입니다.

type string:

List

선택기 유형의 열거형입니다.

ProvisioningState

지정된 실험 리소스에 대한 가장 최근의 프로비전 상태입니다.

Name 형식 Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

쿼리 선택기를 나타내는 모델입니다.

Name 형식 Description
filter filter:

simpleFilter

대상 목록에 적용할 수 있는 사용 가능한 필터 형식을 나타내는 모델입니다.

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

ResourceIdentityType

리소스 ID 유형의 문자열입니다.

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned ID
실험과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

ResourceIdentityType

리소스 ID 유형의 문자열입니다.

Name 형식 Description
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

간단한 대상 필터를 나타내는 모델입니다.

Name 형식 Description
parameters

simpleFilterParameters

단순 필터 매개 변수를 나타내는 모델입니다.

type string:

Simple

필터 형식을 구분하는 열거형입니다. 현재는 형식만 Simple 지원됩니다.

simpleFilterParameters

단순 필터 매개 변수를 나타내는 모델입니다.

Name 형식 Description
zones

string[]

대상을 필터링할 Azure 가용성 영역 목록입니다.

step

실험 리소스의 단계를 나타내는 모델입니다.

Name 형식 Description
branches

branch[]

분기 목록입니다.

name

string

단계 이름의 문자열입니다.

systemData

리소스 만들기 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string

UTC(리소스 만들기)의 타임스탬프입니다.

createdBy

string

리소스를 만든 ID입니다.

createdByType

createdByType

리소스를 만든 ID 유형입니다.

lastModifiedAt

string

리소스 마지막 수정의 타임스탬프(UTC)

lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.

lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID 유형입니다.

targetReference

선택기에서 대상에 대한 참조를 나타내는 모델입니다.

Name 형식 Description
id

string

대상 리소스의 리소스 ID 문자열입니다.

type

TargetReferenceType

대상 참조 형식의 열거형입니다.

TargetReferenceType

대상 참조 형식의 열거형입니다.

Name 형식 Description
ChaosTarget

string

UserAssignedIdentity

사용자 할당 ID 속성

Name 형식 Description
clientId

string

할당된 ID의 클라이언트 ID입니다.

principalId

string

할당된 ID의 보안 주체 ID입니다.