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 minLength: 1pattern: ^[^<>%&:?#/\\]+$ |
Stringa che rappresenta un nome di risorsa Experiment. |
resource
|
path | True |
string pattern: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$ |
Stringa che rappresenta un gruppo di risorse di Azure. |
subscription
|
path | True |
string pattern: ^[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}$ |
GUID che rappresenta un ID sottoscrizione di Azure. |
api-version
|
query | True |
string pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$ |
Stringa che imposta la versione dell'API. |
Corpo della richiesta
Nome | Necessario | Tipo | Descrizione |
---|---|---|---|
location | True |
string |
Posizione geografica in cui risiede la risorsa |
properties.selectors | True | selector[]: |
Elenco di selettori. |
properties.steps | True |
step[] |
Elenco dei passaggi. |
identity |
Identità della risorsa dell'esperimento. |
||
tags |
object |
Tag di risorsa. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
L'operazione di sostituzione a esecuzione prolungata dell'esperimento. |
|
201 Created |
Esecuzione prolungata dell'operazione di creazione dell'esperimento. |
|
Other Status Codes |
Risposta di errore restituita se la richiesta non è riuscita. |
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 sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
experiment |
Modello che rappresenta una risorsa Experiment. |
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 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 filtro di destinazione semplice. |
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 riferimento di destinazione. |
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 minLength: 1 |
Stringa del nome del ramo. |
continuousAction
Modello che rappresenta un'azione continua.
Nome | Tipo | Descrizione |
---|---|---|
duration |
string (duration) pattern: ^P(\d+Y)?(\d+M)?(\d+D)?(T(\d+H)?(\d+M)?(\d+(\.\d+)?S)?)?$ |
ISO8601 stringa formattata che rappresenta una durata. |
name |
string maxLength: 2048 |
Stringa che rappresenta un URN di funzionalità. |
parameters |
Elenco di coppie chiave-valore. |
|
selectorId |
string minLength: 1 |
Stringa che rappresenta un selettore. |
type |
string:
continuous |
Enumerazione che discrimina tra i modelli di azione. |
createdByType
Tipo di identità che ha creato la risorsa.
Valore | Descrizione |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
delayAction
Modello che rappresenta un'azione di ritardo.
Nome | Tipo | Descrizione |
---|---|---|
duration |
string (duration) pattern: ^P(\d+Y)?(\d+M)?(\d+D)?(T(\d+H)?(\d+M)?(\d+(\.\d+)?S)?)?$ |
ISO8601 stringa formattata che rappresenta una durata. |
name |
string maxLength: 2048 |
Stringa che rappresenta un URN di funzionalità. |
type |
string:
delay |
Enumerazione che discrimina tra i modelli di azione. |
discreteAction
Modello che rappresenta un'azione discreta.
Nome | Tipo | Descrizione |
---|---|---|
name |
string maxLength: 2048 |
Stringa che rappresenta un URN di funzionalità. |
parameters |
Elenco di coppie chiave-valore. |
|
selectorId |
string minLength: 1 |
Stringa che rappresenta un selettore. |
type |
string:
discrete |
Enumerazione che discrimina tra i modelli di azione. |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di 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 Experiment.
Nome | Tipo | Descrizione |
---|---|---|
id |
string |
ID risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
Identità della risorsa dell'esperimento. |
|
location |
string |
Posizione geografica in cui risiede la risorsa |
name |
string |
Nome della risorsa |
properties.provisioningState |
Stato di provisioning più recente per la risorsa esperimento specificata. |
|
properties.selectors | selector[]: |
Elenco di selettori. |
properties.steps |
step[] |
Elenco dei passaggi. |
systemData |
Metadati di sistema della risorsa dell'esperimento. |
|
tags |
object |
Tag di risorsa. |
type |
string |
Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
keyValuePair
Mappa per descrivere le impostazioni di un'azione.
Nome | Tipo | Descrizione |
---|---|---|
key |
string minLength: 1 |
Nome dell'impostazione per l'azione. |
value |
string minLength: 1 |
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 minLength: 1 |
Stringa dell'ID del selettore. |
targets |
Elenco dei riferimenti di destinazione. |
|
type |
string:
List |
Enumerazione del tipo di selettore. |
ProvisioningState
Stato di provisioning più recente per la risorsa esperimento specificata.
Valore | Descrizione |
---|---|
Canceled | |
Creating | |
Deleting | |
Failed | |
Succeeded | |
Updating |
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 minLength: 1 |
Stringa dell'ID del 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 di ambito. |
type |
string:
Query |
Enumerazione del tipo di selettore. |
resourceIdentity
Identità di una risorsa.
Nome | Tipo | Descrizione |
---|---|---|
principalId |
string pattern: ^[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}$ |
GUID che rappresenta l'ID entità di questa identità della risorsa. |
tenantId |
string pattern: ^[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}$ |
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.
Valore | Descrizione |
---|---|
None | |
SystemAssigned | |
UserAssigned |
simpleFilter
Modello che rappresenta un filtro di destinazione semplice.
Nome | Tipo | Descrizione |
---|---|---|
parameters |
Modello che rappresenta i parametri di filtro semplice. |
|
type |
string:
Simple |
Enumerazione che discrimina tra 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 in base a cui filtrare le destinazioni. |
step
Modello che rappresenta un passaggio nella risorsa Esperimento.
Nome | Tipo | Descrizione |
---|---|---|
branches |
branch[] |
Elenco di rami. |
name |
string minLength: 1 |
Stringa del nome del passaggio. |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string (date-time) |
Timestamp dell'ultima modifica della risorsa (UTC) |
lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
targetReference
Modello che rappresenta un riferimento a una destinazione nel selettore.
Nome | Tipo | Descrizione |
---|---|---|
id |
string pattern: ^\/[Ss][Uu][Bb][Ss][Cc][Rr][Ii][Pp][Tt][Ii][Oo][Nn][Ss]\/[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}\/[Rr][Ee][Ss][Oo][Uu][Rr][Cc][Ee][Gg][Rr][Oo][Uu][Pp][Ss]\/[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]\/[Pp][Rr][Oo][Vv][Ii][Dd][Ee][Rr][Ss]\/[a-zA-Z0-9]+\.[a-zA-Z0-9]+\/[a-zA-Z0-9_\-\.]+\/[a-zA-Z0-9_\-\.]+\/[Pp][Rr][Oo][Vv][Ii][Dd][Ee][Rr][Ss]\/[Mm][Ii][Cc][Rr][Oo][Ss][Oo][Ff][Tt]\.[Cc][Hh][Aa][Oo][Ss]\/[Tt][Aa][Rr][Gg][Ee][Tt][Ss]\/[a-zA-Z0-9_\-\.]+$ |
Stringa dell'ID risorsa di una risorsa di destinazione. |
type |
Enumerazione del tipo riferimento di destinazione. |
TargetReferenceType
Enumerazione del tipo riferimento di destinazione.
Valore | Descrizione |
---|---|
ChaosTarget |
UserAssignedIdentity
Proprietà di identità assegnate dall'utente
Nome | Tipo | Descrizione |
---|---|---|
clientId |
string (uuid) |
ID client dell'identità assegnata. |
principalId |
string (uuid) |
ID entità dell'identità assegnata. |