Experiments - Create Or Update

Riferimento

Servizio:: Chaos Studio

Versione API:: 2025-01-01

Creare o aggiornare una risorsa Esperimento.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
experimentName	path	True	string	Stringa che rappresenta un nome di risorsa Experiment. Criterio di espressione regolare: `^[^<>%&:?#/\\]+$`
resourceGroupName	path	True	string	Nome del gruppo di risorse. Il nome non fa distinzione tra maiuscole e minuscole.
subscriptionId	path	True	string uuid	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string	Versione dell'API da usare per questa operazione.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Posizione geografica in cui risiede la risorsa
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Elenco di selettori.
properties.steps	True	ChaosExperimentStep[]	Elenco dei passaggi.
identity		ManagedServiceIdentity	Identità del servizio gestito assegnate a questa risorsa.
tags		object	Tag di risorsa.

Risposte

Nome	Tipo	Descrizione
200 OK	Experiment	Operazione di aggiornamento della risorsa 'Experiment' completata
201 Created	Experiment	Operazione di creazione della risorsa 'Experiment' completata Intestazioni Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore imprevista.

Nome

Tipo

Descrizione

200 OK

Experiment

Operazione di aggiornamento della risorsa 'Experiment' completata

201 Created

Experiment

Operazione di creazione della risorsa 'Experiment' completata

Intestazioni

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Risposta di errore imprevista.

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

HTTP

PUT https://management.azure.com/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment?api-version=2025-01-01

{
  "identity": {
    "type": "SystemAssigned"
  },
  "tags": {
    "key7131": "ryohwcoiccwsnewjigfmijz",
    "key2138": "fjaeecgnvqd"
  },
  "location": "eastus2euap",
  "properties": {
    "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"
          }
        ]
      }
    ],
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "type": "continuous",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ],
                "selectorId": "selector1"
              }
            ]
          }
        ]
      }
    ]
  }
}

Risposta di esempio

Codice di stato:: 200

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-11-01-preview
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-11-01-preview

{
  "name": "exampleExperiment",
  "type": "Microsoft.Chaos/experiments",
  "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "d04ab567-2c07-43ef-a7f4-4527626b7f56",
    "tenantId": "8c3e2fb2-fe7a-4bf1-b779-d73990782fe6"
  },
  "tags": {
    "key7131": "ryohwcoiccwsnewjigfmijz",
    "key2138": "fjaeecgnvqd"
  },
  "location": "eastus2euap",
  "properties": {
    "provisioningState": "Updating",
    "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"
          }
        ]
      }
    ],
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "type": "continuous",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ],
                "selectorId": "selector1"
              }
            ]
          }
        ]
      }
    ]
  },
  "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"
  }
}

Codice di stato:: 201

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-11-01-preview
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-11-01-preview

{
  "name": "exampleExperiment",
  "type": "Microsoft.Chaos/experiments",
  "id": "/subscriptions/6b052e15-03d3-4f17-b2e1-be7f07588291/resourceGroups/exampleRG/providers/Microsoft.Chaos/experiments/exampleExperiment",
  "identity": {
    "type": "SystemAssigned",
    "principalId": "d04ab567-2c07-43ef-a7f4-4527626b7f56",
    "tenantId": "8c3e2fb2-fe7a-4bf1-b779-d73990782fe6"
  },
  "tags": {
    "key7131": "ryohwcoiccwsnewjigfmijz",
    "key2138": "fjaeecgnvqd"
  },
  "location": "eastus2euap",
  "properties": {
    "provisioningState": "Creating",
    "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"
          }
        ]
      }
    ],
    "steps": [
      {
        "name": "step1",
        "branches": [
          {
            "name": "branch1",
            "actions": [
              {
                "name": "urn:csci:microsoft:virtualMachine:shutdown/1.0",
                "type": "continuous",
                "duration": "PT10M",
                "parameters": [
                  {
                    "key": "abruptShutdown",
                    "value": "false"
                  }
                ],
                "selectorId": "selector1"
              }
            ]
          }
        ]
      }
    ]
  },
  "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
ChaosExperimentBranch	Modello che rappresenta un ramo nel passaggio . 9 totale per esperimento.
ChaosExperimentStep	Modello che rappresenta un passaggio nella risorsa Esperimento.
ChaosTargetListSelector	Modello che rappresenta un selettore elenco.
ChaosTargetQuerySelector	Modello che rappresenta un selettore di query.
ChaosTargetSimpleFilter	Modello che rappresenta un filtro di destinazione semplice.
ChaosTargetSimpleFilterParameters	Modello che rappresenta i parametri di filtro semplice.
ContinuousAction	Modello che rappresenta un'azione continua.
createdByType	Tipo di identità che ha creato la risorsa.
DelayAction	Modello che rappresenta un'azione di ritardo.
DiscreteAction	Modello che rappresenta un'azione discreta.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
Experiment	Modello che rappresenta una risorsa Experiment.
ExperimentActionType	Unione enumerazione dei tipi di azione dell'esperimento Chaos.
FilterType	Enumerazione che discrimina tra i tipi di filtro. Attualmente è supportato solo `Simple` tipo.
KeyValuePair	Mappa per descrivere le impostazioni di un'azione.
ManagedServiceIdentity	Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)
ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
ProvisioningState	Stato di provisioning corrente per una determinata risorsa di Azure Chaos.
SelectorType	Enumerazione del tipo di selettore.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.
TargetReference	Modello che rappresenta un riferimento a una destinazione nel selettore.
TargetReferenceType	Enumerazione del tipo riferimento di destinazione.
UserAssignedIdentity	Proprietà di identità assegnate dall'utente

ChaosExperimentBranch

Modello che rappresenta un ramo nel passaggio . 9 totale per esperimento.

Nome	Tipo	Descrizione
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Elenco di azioni.
name	string	Stringa del nome del ramo.

ChaosExperimentStep

Modello che rappresenta un passaggio nella risorsa Esperimento.

Nome	Tipo	Descrizione
branches	ChaosExperimentBranch[]	Elenco di rami.
name	string	Stringa del nome del passaggio.

ChaosTargetListSelector

Modello che rappresenta un selettore elenco.

Nome	Tipo	Descrizione
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modello che rappresenta i tipi di filtro disponibili che possono essere applicati a un elenco di destinazioni.
id	string	Stringa dell'ID del selettore.
targets	TargetReference[]	Elenco dei riferimenti di destinazione.
type	string: List	Tipo di discriminante del selettore di destinazione Chaos

ChaosTargetQuerySelector

Modello che rappresenta un selettore di query.

Nome	Tipo	Descrizione
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modello che rappresenta i tipi di filtro disponibili che possono essere applicati a un elenco di destinazioni.
id	string	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	Tipo di discriminante del selettore di destinazione Chaos

ChaosTargetSimpleFilter

Modello che rappresenta un filtro di destinazione semplice.

Nome	Tipo	Descrizione
parameters	ChaosTargetSimpleFilterParameters	Modello che rappresenta i parametri di filtro semplice.
type	string: Simple	Tipo di discriminante del filtro di destinazione Chaos

ChaosTargetSimpleFilterParameters

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.

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	KeyValuePair[]	Elenco di coppie chiave-valore.
selectorId	string	Stringa che rappresenta un selettore.
type	string: continuous	Tipo di discriminazione dell'azione dell'esperimento Chaos

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	Tipo di discriminazione dell'azione dell'esperimento Chaos

DiscreteAction

Modello che rappresenta un'azione discreta.

Nome	Tipo	Descrizione
name	string	Stringa che rappresenta un URN di funzionalità.
parameters	KeyValuePair[]	Elenco di coppie chiave-valore.
selectorId	string	Stringa che rappresenta un selettore.
type	string: discrete	Tipo di discriminazione dell'azione dell'esperimento Chaos

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	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	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	ManagedServiceIdentity	Identità del servizio gestito assegnate a questa risorsa.
location	string	Posizione geografica in cui risiede la risorsa
name	string	Nome della risorsa
properties.provisioningState	ProvisioningState	Stato di provisioning più recente per la risorsa esperimento specificata.
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Elenco di selettori.
properties.steps	ChaosExperimentStep[]	Elenco dei passaggi.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
tags	object	Tag di risorsa.
type	string	Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ExperimentActionType

Unione enumerazione dei tipi di azione dell'esperimento Chaos.

Nome	Tipo	Descrizione
continuous	string
delay	string
discrete	string

FilterType

Enumerazione che discrimina tra i tipi di filtro. Attualmente è supportato solo Simple tipo.

Nome	Tipo	Descrizione
Simple	string	Tipo di filtro semplice.

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.

ManagedServiceIdentity

Identità del servizio gestita (identità assegnate dal sistema e/o assegnate dall'utente)

Nome	Tipo	Descrizione
principalId	string	ID entità servizio dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
tenantId	string	ID tenant dell'identità assegnata dal sistema. Questa proprietà verrà fornita solo per un'identità assegnata dal sistema.
type	ManagedServiceIdentityType	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	identità User-Assigned Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.

ManagedServiceIdentityType

Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).

Nome	Tipo	Descrizione
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ProvisioningState

Stato di provisioning corrente per una determinata risorsa di Azure Chaos.

Nome	Tipo	Descrizione
Canceled	string	La creazione della risorsa è stata annullata.
Creating	string	Creazione iniziale in corso.
Deleting	string	Eliminazione in corso.
Failed	string	Creazione della risorsa non riuscita.
Succeeded	string	La risorsa è stata creata.
Updating	string	Aggiornamento in corso.

SelectorType

Enumerazione del tipo di selettore.

Nome	Tipo	Descrizione
List	string	Tipo di selettore elenco.
Query	string	Tipo di selettore di query.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	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 volta la risorsa.
lastModifiedByType	createdByType	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	Stringa dell'ID risorsa di una risorsa di destinazione.
type	TargetReferenceType	Enumerazione del tipo riferimento di destinazione.

TargetReferenceType

Enumerazione del tipo riferimento di destinazione.

Nome	Tipo	Descrizione
ChaosTarget	string	Tipo di riferimento di destinazione Chaos.

UserAssignedIdentity

Proprietà di identità assegnate dall'utente

Nome	Tipo	Descrizione
clientId	string	ID client dell'identità assegnata.
principalId	string	ID entità dell'identità assegnata.

Condividi tramite

Experiments - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Create/update a Experiment in a resource group.

Esempio di richiesta

Risposta di esempio

Definizioni

ChaosExperimentBranch

ChaosExperimentStep

ChaosTargetListSelector

ChaosTargetQuerySelector

ChaosTargetSimpleFilter

ChaosTargetSimpleFilterParameters

ContinuousAction

createdByType

DelayAction

DiscreteAction

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

Experiment

ExperimentActionType

FilterType

KeyValuePair

ManagedServiceIdentity

ManagedServiceIdentityType

ProvisioningState

SelectorType

systemData

TargetReference

TargetReferenceType

UserAssignedIdentity

Risorse aggiuntive