Condividi tramite


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
experimentName
path True

string

Stringa che rappresenta un nome di risorsa Esperimento.

Criterio di espressione regolare: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

Stringa che rappresenta un gruppo di risorse di Azure.

Criterio di espressione regolare: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

GUID che rappresenta un ID sottoscrizione di Azure.

Criterio di espressione regolare: ^[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

Stringa che imposta la versione dell'API.

Criterio di espressione regolare: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$

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

resourceIdentity

Identità della risorsa dell'esperimento.

tags

object

Tag di risorse.

Risposte

Nome Tipo Descrizione
200 OK

experiment

Operazione di sostituzione a esecuzione prolungata.

201 Created

experiment

Esecuzione prolungata dell'operazione di creazione dell'esperimento.

Other Status Codes

ErrorResponse

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.

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 sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

experiment

Modello che rappresenta una risorsa Esperimento.

keyValuePair

Mappa per descrivere le impostazioni di un'azione.

listSelector

Modello che rappresenta un selettore elenco.

ProvisioningState

Stato di provisioning più recente per la risorsa di esperimento specificata.

querySelector

Modello che rappresenta un selettore di query.

resourceIdentity

Identità di una risorsa.

ResourceIdentityType

Stringa del tipo di identità della risorsa.

simpleFilter

Modello che rappresenta un semplice filtro di destinazione.

simpleFilterParameters

Modello che rappresenta i parametri di filtro semplice.

step

Modello che rappresenta un passaggio nella risorsa Esperimento.

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 di riferimento Target.

UserAssignedIdentity

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

keyValuePair[]

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

keyValuePair[]

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

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 Esperimento.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

Identità della risorsa dell'esperimento.

location

string

Posizione geografica in cui vive la risorsa

name

string

nome della risorsa.

properties.provisioningState

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

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:

simpleFilter

Modello che rappresenta i tipi di filtro disponibili che possono essere applicati a un elenco di destinazioni.

id

string

Stringa dell'ID selettore.

targets

targetReference[]

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:

simpleFilter

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

ResourceIdentityType

Stringa del tipo di identità della risorsa.

userAssignedIdentities

<string,  UserAssignedIdentity>

identità User-Assigned
Elenco delle identità utente associate all'esperimento. I riferimenti alla chiave del dizionario delle identità utente saranno id risorsa ARM nel modulo: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

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

simpleFilterParameters

Modello che rappresenta i parametri di filtro semplice.

type string:

Simple

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

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

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

createdByType

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

TargetReferenceType

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.