Dela via


Experiments - Create Or Update

Skapa eller uppdatera en experimentresurs.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Chaos/experiments/{experimentName}?api-version=2024-01-01

URI-parametrar

Name I Obligatorisk Typ Description
experimentName
path True

string

Sträng som representerar ett experimentresursnamn.

Reguljärt uttrycksmönster: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

Sträng som representerar en Azure-resursgrupp.

Reguljärt uttrycksmönster: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

GUID som representerar ett Azure-prenumerations-ID.

Reguljärt uttrycksmönster: ^[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

Sträng som anger API-versionen.

Reguljärt uttrycksmönster: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$

Begärandetext

Name Obligatorisk Typ Description
location True

string

Den geo-plats där resursen finns

properties.selectors True selector[]:

Lista över väljare.

properties.steps True

step[]

Lista över steg.

identity

resourceIdentity

Experimentresursens identitet.

tags

object

Resurstaggar.

Svar

Name Typ Description
200 OK

experiment

Tidskrävande ersättningsexperimentåtgärd.

201 Created

experiment

Tidskrävande åtgärd för att skapa experiment.

Other Status Codes

ErrorResponse

Felsvaret returnerades om begäran misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation Personifiera ditt användarkonto

Exempel

Create/update a Experiment in a resource group.

Exempelbegäran

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"
          }
        ]
      }
    ]
  }
}

Exempelsvar

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"
  }
}

Definitioner

Name Description
branch

Modell som representerar en gren i steget. 9 totalt per experiment.

continuousAction

Modell som representerar en kontinuerlig åtgärd.

createdByType

Den typ av identitet som skapade resursen.

delayAction

Modell som representerar en fördröjningsåtgärd.

discreteAction

Modell som representerar en diskret åtgärd.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

ErrorDetail

Felinformationen.

ErrorResponse

Felsvar

experiment

Modell som representerar en experimentresurs.

keyValuePair

En karta som beskriver inställningarna för en åtgärd.

listSelector

Modell som representerar en listväljare.

ProvisioningState

Senaste etableringstillståndet för den angivna experimentresursen.

querySelector

Modell som representerar en frågeväljare.

resourceIdentity

Identiteten för en resurs.

ResourceIdentityType

Sträng av resursidentitetstypen.

simpleFilter

Modell som representerar ett enkelt målfilter.

simpleFilterParameters

Modell som representerar enkla filterparametrar.

step

Modell som representerar ett steg i experimentresursen.

systemData

Metadata som rör skapande och senaste ändring av resursen.

targetReference

Modell som representerar en referens till ett mål i väljaren.

TargetReferenceType

Uppräkning av referenstypen Mål.

UserAssignedIdentity

Användartilldelade identitetsegenskaper

branch

Modell som representerar en gren i steget. 9 totalt per experiment.

Name Typ Description
actions action[]:

Lista över åtgärder.

name

string

Sträng för grennamnet.

continuousAction

Modell som representerar en kontinuerlig åtgärd.

Name Typ Description
duration

string

ISO8601 formaterad sträng som representerar en varaktighet.

name

string

Sträng som representerar en funktions-URN.

parameters

keyValuePair[]

Lista över nyckelvärdepar.

selectorId

string

Sträng som representerar en väljare.

type string:

continuous

Uppräkning som diskriminerar mellan åtgärdsmodeller.

createdByType

Den typ av identitet som skapade resursen.

Name Typ Description
Application

string

Key

string

ManagedIdentity

string

User

string

delayAction

Modell som representerar en fördröjningsåtgärd.

Name Typ Description
duration

string

ISO8601 formaterad sträng som representerar en varaktighet.

name

string

Sträng som representerar en funktions-URN.

type string:

delay

Uppräkning som diskriminerar mellan åtgärdsmodeller.

discreteAction

Modell som representerar en diskret åtgärd.

Name Typ Description
name

string

Sträng som representerar en funktions-URN.

parameters

keyValuePair[]

Lista över nyckelvärdepar.

selectorId

string

Sträng som representerar en väljare.

type string:

discrete

Uppräkning som diskriminerar mellan åtgärdsmodeller.

ErrorAdditionalInfo

Ytterligare information om resurshanteringsfelet.

Name Typ Description
info

object

Ytterligare information.

type

string

Den ytterligare informationstypen.

ErrorDetail

Felinformationen.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Ytterligare information om felet.

code

string

Felkoden.

details

ErrorDetail[]

Felinformationen.

message

string

Felmeddelandet.

target

string

Felmålet.

ErrorResponse

Felsvar

Name Typ Description
error

ErrorDetail

Felobjektet.

experiment

Modell som representerar en experimentresurs.

Name Typ Description
id

string

Fullständigt kvalificerat resurs-ID för resursen. Ex – /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

Experimentresursens identitet.

location

string

Den geo-plats där resursen finns

name

string

Namnet på resursen

properties.provisioningState

ProvisioningState

Senaste etableringstillståndet för den angivna experimentresursen.

properties.selectors selector[]:

Lista över väljare.

properties.steps

step[]

Lista över steg.

systemData

systemData

Systemmetadata för experimentresursen.

tags

object

Resurstaggar.

type

string

Resurstypen. Till exempel "Microsoft.Compute/virtualMachines" eller "Microsoft.Storage/storageAccounts"

keyValuePair

En karta som beskriver inställningarna för en åtgärd.

Name Typ Description
key

string

Namnet på inställningen för åtgärden.

value

string

Värdet för inställningen för åtgärden.

listSelector

Modell som representerar en listväljare.

Name Typ Description
filter filter:

simpleFilter

Modell som representerar tillgängliga filtertyper som kan tillämpas på en mållista.

id

string

Sträng för väljarens ID.

targets

targetReference[]

Lista över målreferenser.

type string:

List

Uppräkning av väljarens typ.

ProvisioningState

Senaste etableringstillståndet för den angivna experimentresursen.

Name Typ Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

Modell som representerar en frågeväljare.

Name Typ Description
filter filter:

simpleFilter

Modell som representerar tillgängliga filtertyper som kan tillämpas på en mållista.

id

string

Sträng för väljarens ID.

queryString

string

Azure Resource Graph (ARG) Fråga språkfråga för målresurser.

subscriptionIds

string[]

Prenumerations-ID-lista för omfångsresursfråga.

type string:

Query

Uppräkning av väljarens typ.

resourceIdentity

Identiteten för en resurs.

Name Typ Description
principalId

string

GUID som representerar huvud-ID:t för den här resursidentiteten.

tenantId

string

GUID som representerar klientorganisations-ID för den här resursidentiteten.

type

ResourceIdentityType

Sträng av resursidentitetstypen.

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identiteter
Listan över användaridentiteter som är associerade med experimentet. Nyckelreferenserna för användaridentitetsordlistan är ARM-resurs-ID:er i formatet: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ResourceIdentityType

Sträng av resursidentitetstypen.

Name Typ Description
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

Modell som representerar ett enkelt målfilter.

Name Typ Description
parameters

simpleFilterParameters

Modell som representerar enkla filterparametrar.

type string:

Simple

Uppräkning som diskriminerar mellan filtertyper. För närvarande stöds endast Simple typ.

simpleFilterParameters

Modell som representerar enkla filterparametrar.

Name Typ Description
zones

string[]

Lista över Azure-tillgänglighetszoner som mål ska filtreras efter.

step

Modell som representerar ett steg i experimentresursen.

Name Typ Description
branches

branch[]

Lista över grenar.

name

string

Sträng för stegnamnet.

systemData

Metadata som rör skapande och senaste ändring av resursen.

Name Typ Description
createdAt

string

Tidsstämpeln för resursskapande (UTC).

createdBy

string

Identiteten som skapade resursen.

createdByType

createdByType

Den typ av identitet som skapade resursen.

lastModifiedAt

string

Tidsstämpeln för resursens senaste ändring (UTC)

lastModifiedBy

string

Identiteten som senast ändrade resursen.

lastModifiedByType

createdByType

Den typ av identitet som senast ändrade resursen.

targetReference

Modell som representerar en referens till ett mål i väljaren.

Name Typ Description
id

string

Sträng för resurs-ID för en målresurs.

type

TargetReferenceType

Uppräkning av referenstypen Mål.

TargetReferenceType

Uppräkning av referenstypen Mål.

Name Typ Description
ChaosTarget

string

UserAssignedIdentity

Användartilldelade identitetsegenskaper

Name Typ Description
clientId

string

Klient-ID för den tilldelade identiteten.

principalId

string

Huvud-ID för den tilldelade identiteten.