Experiments - Create Or Update
Creare o aggiornare una risorsa Esperimento.
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Chaos/experiments/{experimentName}?api-version=2024-01-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
experiment
|
path | True |
string |
Stringa che rappresenta un nome di risorsa Esperimento. Criterio di espressione regolare: |
resource
|
path | True |
string |
Stringa che rappresenta un gruppo di risorse di Azure. Criterio di espressione regolare: |
subscription
|
path | True |
string |
GUID che rappresenta un ID sottoscrizione di Azure. Criterio di espressione regolare: |
api-version
|
query | True |
string |
Stringa che imposta la versione dell'API. Criterio di espressione regolare: |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
location | True |
string |
Posizione geografica in cui vive la risorsa |
properties.selectors | True | selector[]: |
Elenco dei selettore. |
properties.steps | True |
step[] |
Elenco dei passaggi. |
identity |
Identità della risorsa dell'esperimento. |
||
tags |
object |
Tag di risorse. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Operazione di sostituzione a esecuzione prolungata. |
|
201 Created |
Esecuzione prolungata dell'operazione di creazione dell'esperimento. |
|
Other Status Codes |
Risposta di errore restituita se la richiesta ha avuto esito negativo. |
Sicurezza
azure_auth
Flusso OAuth2 di Azure Active Directory
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
Nome | Descrizione |
---|---|
user_impersonation | Rappresentare l'account utente |
Esempio
Create/update a Experiment in a resource group.
Esempio di richiesta
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"
}
]
}
]
}
}
Risposta di esempio
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"
}
}
Definizioni
Nome | Descrizione |
---|---|
branch |
Modello che rappresenta un ramo nel passaggio. 9 totale per esperimento. |
continuous |
Modello che rappresenta un'azione continua. |
created |
Tipo di identità che ha creato la risorsa. |
delay |
Modello che rappresenta un'azione di ritardo. |
discrete |
Modello che rappresenta un'azione discreta. |
Error |
Informazioni aggiuntive sulla gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
experiment |
Modello che rappresenta una risorsa Esperimento. |
key |
Mappa per descrivere le impostazioni di un'azione. |
list |
Modello che rappresenta un selettore elenco. |
Provisioning |
Stato di provisioning più recente per la risorsa di esperimento specificata. |
query |
Modello che rappresenta un selettore di query. |
resource |
Identità di una risorsa. |
Resource |
Stringa del tipo di identità della risorsa. |
simple |
Modello che rappresenta un semplice filtro di destinazione. |
simple |
Modello che rappresenta i parametri di filtro semplice. |
step |
Modello che rappresenta un passaggio nella risorsa Esperimento. |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
target |
Modello che rappresenta un riferimento a una destinazione nel selettore. |
Target |
Enumerazione del tipo di riferimento Target. |
User |
Proprietà di identità assegnate dall'utente |
branch
Modello che rappresenta un ramo nel passaggio. 9 totale per esperimento.
Nome | Tipo | Descrizione |
---|---|---|
actions | action[]: |
Elenco di azioni. |
name |
string |
Stringa del nome del ramo. |
continuousAction
Modello che rappresenta un'azione continua.
Nome | Tipo | Descrizione |
---|---|---|
duration |
string |
ISO8601 stringa formattata che rappresenta una durata. |
name |
string |
Stringa che rappresenta un URN di funzionalità. |
parameters |
Elenco di coppie di valori chiave. |
|
selectorId |
string |
Stringa che rappresenta un selettore. |
type |
string:
continuous |
Enumerazione che discrimina i modelli di azione. |
createdByType
Tipo di identità che ha creato la risorsa.
Nome | Tipo | Descrizione |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
delayAction
Modello che rappresenta un'azione di ritardo.
Nome | Tipo | Descrizione |
---|---|---|
duration |
string |
ISO8601 stringa formattata che rappresenta una durata. |
name |
string |
Stringa che rappresenta un URN di funzionalità. |
type |
string:
delay |
Enumerazione che discrimina i modelli di azione. |
discreteAction
Modello che rappresenta un'azione discreta.
Nome | Tipo | Descrizione |
---|---|---|
name |
string |
Stringa che rappresenta un URN di funzionalità. |
parameters |
Elenco di coppie di valori chiave. |
|
selectorId |
string |
Stringa che rappresenta un selettore. |
type |
string:
discrete |
Enumerazione che discrimina i modelli di azione. |
ErrorAdditionalInfo
Informazioni aggiuntive sulla gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
experiment
Modello che rappresenta una risorsa Esperimento.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
Identità della risorsa dell'esperimento. |
|
location |
string |
Posizione geografica in cui vive la risorsa |
name |
string |
nome della risorsa. |
properties.provisioningState |
Stato di provisioning più recente per la risorsa di esperimento specificata. |
|
properties.selectors | selector[]: |
Elenco dei selettore. |
properties.steps |
step[] |
Elenco dei passaggi. |
systemData |
Metadati di sistema della risorsa dell'esperimento. |
|
tags |
object |
Tag di risorse. |
type |
string |
Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
keyValuePair
Mappa per descrivere le impostazioni di un'azione.
Nome | Tipo | Descrizione |
---|---|---|
key |
string |
Nome dell'impostazione per l'azione. |
value |
string |
Valore dell'impostazione per l'azione. |
listSelector
Modello che rappresenta un selettore elenco.
Nome | Tipo | Descrizione |
---|---|---|
filter | filter: |
Modello che rappresenta i tipi di filtro disponibili che possono essere applicati a un elenco di destinazioni. |
id |
string |
Stringa dell'ID selettore. |
targets |
Elenco dei riferimenti di destinazione. |
|
type |
string:
List |
Enumerazione del tipo di selettore. |
ProvisioningState
Stato di provisioning più recente per la risorsa di esperimento specificata.
Nome | Tipo | Descrizione |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
querySelector
Modello che rappresenta un selettore di query.
Nome | Tipo | Descrizione |
---|---|---|
filter | filter: |
Modello che rappresenta i tipi di filtro disponibili che possono essere applicati a un elenco di destinazioni. |
id |
string |
Stringa dell'ID selettore. |
queryString |
string |
Query del linguaggio di query di Azure Resource Graph (ARG) per le risorse di destinazione. |
subscriptionIds |
string[] |
Elenco id sottoscrizione per la query delle risorse dell'ambito. |
type |
string:
Query |
Enumerazione del tipo di selettore. |
resourceIdentity
Identità di una risorsa.
Nome | Tipo | Descrizione |
---|---|---|
principalId |
string |
GUID che rappresenta l'ID principale di questa identità della risorsa. |
tenantId |
string |
GUID che rappresenta l'ID tenant di questa identità della risorsa. |
type |
Stringa del tipo di identità della risorsa. |
|
userAssignedIdentities |
<string,
User |
identità User-Assigned |
ResourceIdentityType
Stringa del tipo di identità della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
simpleFilter
Modello che rappresenta un semplice filtro di destinazione.
Nome | Tipo | Descrizione |
---|---|---|
parameters |
Modello che rappresenta i parametri di filtro semplice. |
|
type |
string:
Simple |
Enumerazione che discrimina i tipi di filtro. Attualmente è supportato solo |
simpleFilterParameters
Modello che rappresenta i parametri di filtro semplice.
Nome | Tipo | Descrizione |
---|---|---|
zones |
string[] |
Elenco delle zone di disponibilità di Azure da cui filtrare le destinazioni. |
step
Modello che rappresenta un passaggio nella risorsa Esperimento.
Nome | Tipo | Descrizione |
---|---|---|
branches |
branch[] |
Elenco di rami. |
name |
string |
Stringa del nome del passaggio. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string |
Timestamp della creazione di risorse (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string |
Timestamp dell'ultima modifica della risorsa (UTC) |
lastModifiedBy |
string |
Identità che ha modificato l'ultima risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima risorsa. |
targetReference
Modello che rappresenta un riferimento a una destinazione nel selettore.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
Stringa dell'ID risorsa di una risorsa di destinazione. |
type |
Enumerazione del tipo di riferimento Target. |
TargetReferenceType
Enumerazione del tipo di riferimento Target.
Nome | Tipo | Descrizione |
---|---|---|
ChaosTarget |
string |
UserAssignedIdentity
Proprietà di identità assegnate dall'utente
Nome | Tipo | Descrizione |
---|---|---|
clientId |
string |
ID client dell'identità assegnata. |
principalId |
string |
ID principale dell'identità assegnata. |