Delen via


Experiments - Create Or Update

Een experimentresource maken of bijwerken.

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

URI-parameters

Name In Vereist Type Description
experimentName
path True

string

Tekenreeks die de naam van een Experiment-resource vertegenwoordigt.

Regex-patroon: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

Tekenreeks die een Azure-resourcegroep vertegenwoordigt.

Regex-patroon: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

GUID die een Azure-abonnements-id vertegenwoordigt.

Regex-patroon: ^[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

Tekenreeks waarmee de API-versie wordt ingesteld.

Regex-patroon: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$

Aanvraagbody

Name Vereist Type Description
location True

string

De geografische locatie waar de resource zich bevindt

properties.selectors True selector[]:

Lijst met selectors.

properties.steps True

step[]

Lijst met stappen.

identity

resourceIdentity

De identiteit van de experimentresource.

tags

object

Resourcetags.

Antwoorden

Name Type Description
200 OK

experiment

Langdurige vervangingsexperimentbewerking.

201 Created

experiment

Langdurige bewerking voor het maken van een experiment.

Other Status Codes

ErrorResponse

Er wordt een fout geretourneerd als de aanvraag is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name Description
user_impersonation Uw gebruikersaccount imiteren

Voorbeelden

Create/update a Experiment in a resource group.

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
branch

Model dat een vertakking in de stap vertegenwoordigt. 9 totaal per experiment.

continuousAction

Model dat een doorlopende actie vertegenwoordigt.

createdByType

Het type identiteit waarmee de resource is gemaakt.

delayAction

Model dat een vertragingsactie vertegenwoordigt.

discreteAction

Model dat een discrete actie vertegenwoordigt.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

ErrorDetail

De foutdetails.

ErrorResponse

Foutreactie

experiment

Model dat een experimentresource vertegenwoordigt.

keyValuePair

Een kaart om de instellingen van een actie te beschrijven.

listSelector

Model dat een lijstkiezer vertegenwoordigt.

ProvisioningState

Meest recente inrichtingsstatus voor de opgegeven experimentresource.

querySelector

Model dat een querykiezer vertegenwoordigt.

resourceIdentity

De identiteit van een resource.

ResourceIdentityType

Tekenreeks van het resource-id-type.

simpleFilter

Model dat een eenvoudig doelfilter vertegenwoordigt.

simpleFilterParameters

Model dat de eenvoudige filterparameters vertegenwoordigt.

step

Model dat een stap in de experimentresource vertegenwoordigt.

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

targetReference

Model dat een verwijzing naar een doel in de selector vertegenwoordigt.

TargetReferenceType

Opsomming van het doelreferentietype.

UserAssignedIdentity

Eigenschappen van door de gebruiker toegewezen identiteit

branch

Model dat een vertakking in de stap vertegenwoordigt. 9 totaal per experiment.

Name Type Description
actions action[]:

Lijst met acties.

name

string

Tekenreeks van de naam van de vertakking.

continuousAction

Model dat een doorlopende actie vertegenwoordigt.

Name Type Description
duration

string

ISO8601 opgemaakte tekenreeks die een duur vertegenwoordigt.

name

string

Tekenreeks die een mogelijkheids-URN vertegenwoordigt.

parameters

keyValuePair[]

Lijst met sleutelwaardeparen.

selectorId

string

Tekenreeks die een selector vertegenwoordigt.

type string:

continuous

Opsomming die onderscheid maakt tussen actiemodellen.

createdByType

Het type identiteit waarmee de resource is gemaakt.

Name Type Description
Application

string

Key

string

ManagedIdentity

string

User

string

delayAction

Model dat een vertragingsactie vertegenwoordigt.

Name Type Description
duration

string

ISO8601 opgemaakte tekenreeks die een duur vertegenwoordigt.

name

string

Tekenreeks die een mogelijkheids-URN vertegenwoordigt.

type string:

delay

Opsomming die onderscheid maakt tussen actiemodellen.

discreteAction

Model dat een discrete actie vertegenwoordigt.

Name Type Description
name

string

Tekenreeks die een mogelijkheids-URN vertegenwoordigt.

parameters

keyValuePair[]

Lijst met sleutelwaardeparen.

selectorId

string

Tekenreeks die een selector vertegenwoordigt.

type string:

discrete

Opsomming die onderscheid maakt tussen actiemodellen.

ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.

type

string

Het type aanvullende informatie.

ErrorDetail

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout aanvullende informatie.

code

string

De foutcode.

details

ErrorDetail[]

De foutdetails.

message

string

Het foutbericht.

target

string

Het foutdoel.

ErrorResponse

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

experiment

Model dat een experimentresource vertegenwoordigt.

Name Type Description
id

string

Volledig gekwalificeerde resource-id voor de resource. Bijvoorbeeld - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

De identiteit van de experimentresource.

location

string

De geografische locatie waar de resource zich bevindt

name

string

De naam van de resource

properties.provisioningState

ProvisioningState

Meest recente inrichtingsstatus voor de opgegeven experimentresource.

properties.selectors selector[]:

Lijst met selectors.

properties.steps

step[]

Lijst met stappen.

systemData

systemData

De systeemmetagegevens van de experimentresource.

tags

object

Resourcetags.

type

string

Het type resource. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

keyValuePair

Een kaart om de instellingen van een actie te beschrijven.

Name Type Description
key

string

De naam van de instelling voor de actie.

value

string

De waarde van de instelling voor de actie.

listSelector

Model dat een lijstkiezer vertegenwoordigt.

Name Type Description
filter filter:

simpleFilter

Model dat de beschikbare filtertypen vertegenwoordigt die kunnen worden toegepast op een lijst met doelen.

id

string

Tekenreeks van de selector-id.

targets

targetReference[]

Lijst met doelverwijzingen.

type string:

List

Opsomming van het selectortype.

ProvisioningState

Meest recente inrichtingsstatus voor de opgegeven experimentresource.

Name Type Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

Model dat een querykiezer vertegenwoordigt.

Name Type Description
filter filter:

simpleFilter

Model dat de beschikbare filtertypen vertegenwoordigt die kunnen worden toegepast op een lijst met doelen.

id

string

Tekenreeks van de selector-id.

queryString

string

Querytaal van Azure Resource Graph (ARG) voor doelresources.

subscriptionIds

string[]

Lijst met abonnements-id's voor het bereik van de resourcequery.

type string:

Query

Opsomming van het selectortype.

resourceIdentity

De identiteit van een resource.

Name Type Description
principalId

string

GUID die de principal-id van deze resource-id vertegenwoordigt.

tenantId

string

GUID die de tenant-id van deze resource-id vertegenwoordigt.

type

ResourceIdentityType

Tekenreeks van het resource-id-type.

userAssignedIdentities

<string,  UserAssignedIdentity>

User-Assigned identiteiten
De lijst met gebruikersidentiteiten die zijn gekoppeld aan het experiment. De sleutelverwijzingen naar de gebruikersidentiteitswoordenlijst zijn ARM-resource-id's in de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}.

ResourceIdentityType

Tekenreeks van het resource-id-type.

Name Type Description
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

Model dat een eenvoudig doelfilter vertegenwoordigt.

Name Type Description
parameters

simpleFilterParameters

Model dat de eenvoudige filterparameters vertegenwoordigt.

type string:

Simple

Opsomming die onderscheid maakt tussen filtertypen. Momenteel wordt alleen Simple het type ondersteund.

simpleFilterParameters

Model dat de eenvoudige filterparameters vertegenwoordigt.

Name Type Description
zones

string[]

Lijst met Azure-beschikbaarheidszones om doelen op te filteren.

step

Model dat een stap in de experimentresource vertegenwoordigt.

Name Type Description
branches

branch[]

Lijst met vertakkingen.

name

string

Tekenreeks van de naam van de stap.

systemData

Metagegevens met betrekking tot het maken en laatste wijzigen van de resource.

Name Type Description
createdAt

string

De tijdstempel van het maken van resources (UTC).

createdBy

string

De identiteit die de resource heeft gemaakt.

createdByType

createdByType

Het type identiteit waarmee de resource is gemaakt.

lastModifiedAt

string

Het tijdstempel van de laatste wijziging van de resource (UTC)

lastModifiedBy

string

De identiteit die de resource het laatst heeft gewijzigd.

lastModifiedByType

createdByType

Het type identiteit dat de resource het laatst heeft gewijzigd.

targetReference

Model dat een verwijzing naar een doel in de selector vertegenwoordigt.

Name Type Description
id

string

Tekenreeks van de resource-id van een doelresource.

type

TargetReferenceType

Opsomming van het doelreferentietype.

TargetReferenceType

Opsomming van het doelreferentietype.

Name Type Description
ChaosTarget

string

UserAssignedIdentity

Eigenschappen van door de gebruiker toegewezen identiteit

Name Type Description
clientId

string

De client-id van de toegewezen identiteit.

principalId

string

De principal-id van de toegewezen identiteit.