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

minLength: 1
pattern: ^[^<>%&:?#/\\]+$

Stringa che rappresenta un nome di risorsa Experiment.

resourceGroupName
path True

string

pattern: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

Stringa che rappresenta un gruppo di risorse di Azure.

subscriptionId
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

resourceIdentity

Identità della risorsa dell'esperimento.

tags

object

Tag di risorsa.

Risposte

Nome Tipo Descrizione
200 OK

experiment

L'operazione di sostituzione a esecuzione prolungata dell'esperimento.

201 Created

experiment

Esecuzione prolungata dell'operazione di creazione dell'esperimento.

Other Status Codes

ErrorResponse

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.

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.

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 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 filtro di destinazione semplice.

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

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

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

keyValuePair[]

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

keyValuePair[]

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

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

resourceIdentity

Identità della risorsa dell'esperimento.

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 selector[]:

Elenco di selettori.

properties.steps

step[]

Elenco dei passaggi.

systemData

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:

simpleFilter

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

targetReference[]

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:

simpleFilter

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

ResourceIdentityType

Stringa del tipo di identità della risorsa.

userAssignedIdentities

<string,  UserAssignedIdentity>

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

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

simpleFilterParameters

Modello che rappresenta i parametri di filtro semplice.

type string:

Simple

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

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

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

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

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

TargetReferenceType

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.