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 |
---|---|---|---|---|
experiment
|
path | True |
string |
Tekenreeks die de naam van een Experiment-resource vertegenwoordigt. Regex-patroon: |
resource
|
path | True |
string |
Tekenreeks die een Azure-resourcegroep vertegenwoordigt. Regex-patroon: |
subscription
|
path | True |
string |
GUID die een Azure-abonnements-id vertegenwoordigt. Regex-patroon: |
api-version
|
query | True |
string |
Tekenreeks waarmee de API-versie wordt ingesteld. Regex-patroon: |
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 |
De identiteit van de experimentresource. |
||
tags |
object |
Resourcetags. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
Langdurige vervangingsexperimentbewerking. |
|
201 Created |
Langdurige bewerking voor het maken van een experiment. |
|
Other Status Codes |
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. |
continuous |
Model dat een doorlopende actie vertegenwoordigt. |
created |
Het type identiteit waarmee de resource is gemaakt. |
delay |
Model dat een vertragingsactie vertegenwoordigt. |
discrete |
Model dat een discrete actie vertegenwoordigt. |
Error |
Aanvullende informatie over de resourcebeheerfout. |
Error |
De foutdetails. |
Error |
Foutreactie |
experiment |
Model dat een experimentresource vertegenwoordigt. |
key |
Een kaart om de instellingen van een actie te beschrijven. |
list |
Model dat een lijstkiezer vertegenwoordigt. |
Provisioning |
Meest recente inrichtingsstatus voor de opgegeven experimentresource. |
query |
Model dat een querykiezer vertegenwoordigt. |
resource |
De identiteit van een resource. |
Resource |
Tekenreeks van het resource-id-type. |
simple |
Model dat een eenvoudig doelfilter vertegenwoordigt. |
simple |
Model dat de eenvoudige filterparameters vertegenwoordigt. |
step |
Model dat een stap in de experimentresource vertegenwoordigt. |
system |
Metagegevens met betrekking tot het maken en laatste wijzigen van de resource. |
target |
Model dat een verwijzing naar een doel in de selector vertegenwoordigt. |
Target |
Opsomming van het doelreferentietype. |
User |
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 |
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 |
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 |
De fout aanvullende informatie. |
|
code |
string |
De foutcode. |
details |
De foutdetails. |
|
message |
string |
Het foutbericht. |
target |
string |
Het foutdoel. |
ErrorResponse
Foutreactie
Name | Type | Description |
---|---|---|
error |
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 |
De identiteit van de experimentresource. |
|
location |
string |
De geografische locatie waar de resource zich bevindt |
name |
string |
De naam van de resource |
properties.provisioningState |
Meest recente inrichtingsstatus voor de opgegeven experimentresource. |
|
properties.selectors | selector[]: |
Lijst met selectors. |
properties.steps |
step[] |
Lijst met stappen. |
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: |
Model dat de beschikbare filtertypen vertegenwoordigt die kunnen worden toegepast op een lijst met doelen. |
id |
string |
Tekenreeks van de selector-id. |
targets |
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: |
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 |
Tekenreeks van het resource-id-type. |
|
userAssignedIdentities |
<string,
User |
User-Assigned identiteiten |
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 |
Model dat de eenvoudige filterparameters vertegenwoordigt. |
|
type |
string:
Simple |
Opsomming die onderscheid maakt tussen filtertypen. Momenteel wordt alleen |
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 |
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 |
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 |
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. |