Share via


Experiments - Create Or Update

Cree o actualice un recurso de experimento.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
experimentName
path True

string

Cadena que representa un nombre de recurso de experimento.

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

resourceGroupName
path True

string

Cadena que representa un grupo de recursos de Azure.

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

subscriptionId
path True

string

GUID que representa un identificador de suscripción de Azure.

Regex 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}$

api-version
query True

string

Cadena que establece la versión de la API.

Regex pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$

Cuerpo de la solicitud

Nombre Requerido Tipo Description
location True

string

Ubicación geográfica donde reside el recurso

properties.selectors True selector[]:

Lista de selectores.

properties.steps True

step[]

Lista de pasos.

identity

resourceIdentity

Identidad del recurso del experimento.

tags

object

Etiquetas del recurso.

Respuestas

Nombre Tipo Description
200 OK

experiment

Operación de reemplazo de experimento de larga duración.

201 Created

experiment

Operación de creación de experimentos de larga duración.

Other Status Codes

ErrorResponse

Respuesta de error devuelta si la solicitud no se realizó correctamente.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre Description
user_impersonation Suplantación de su cuenta de usuario

Ejemplos

Create/update a Experiment in a resource group.

Sample Request

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"
          }
        ]
      }
    ]
  }
}

Sample Response

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"
  }
}

Definiciones

Nombre Description
branch

Modelo que representa una rama en el paso. 9 total por experimento.

continuousAction

Modelo que representa una acción continua.

createdByType

Tipo de identidad que creó el recurso.

delayAction

Modelo que representa una acción de retraso.

discreteAction

Modelo que representa una acción discreta.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

ErrorDetail

Detalle del error.

ErrorResponse

Respuesta de error

experiment

Modelo que representa un recurso de experimento.

keyValuePair

Mapa para describir la configuración de una acción.

listSelector

Modelo que representa un selector de lista.

ProvisioningState

Estado de aprovisionamiento más reciente para el recurso de experimento especificado.

querySelector

Modelo que representa un selector de consultas.

resourceIdentity

Identidad de un recurso.

ResourceIdentityType

Cadena del tipo de identidad del recurso.

simpleFilter

Modelo que representa un filtro de destino simple.

simpleFilterParameters

Modelo que representa los parámetros de filtro simple.

step

Modelo que representa un paso en el recurso Experimento.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

targetReference

Modelo que representa una referencia a un destino en el selector.

TargetReferenceType

Enumeración del tipo de referencia target.

UserAssignedIdentity

Propiedades de identidad asignadas por el usuario

branch

Modelo que representa una rama en el paso. 9 total por experimento.

Nombre Tipo Description
actions action[]:

Lista de acciones.

name

string

Cadena del nombre de la rama.

continuousAction

Modelo que representa una acción continua.

Nombre Tipo Description
duration

string

ISO8601 cadena con formato que representa una duración.

name

string

Cadena que representa un URN de funcionalidad.

parameters

keyValuePair[]

Lista de pares clave-valor.

selectorId

string

Cadena que representa un selector.

type string:

continuous

Enumeración que discrimina entre los modelos de acción.

createdByType

Tipo de identidad que creó el recurso.

Nombre Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

delayAction

Modelo que representa una acción de retraso.

Nombre Tipo Description
duration

string

ISO8601 cadena con formato que representa una duración.

name

string

Cadena que representa un URN de funcionalidad.

type string:

delay

Enumeración que discrimina entre los modelos de acción.

discreteAction

Modelo que representa una acción discreta.

Nombre Tipo Description
name

string

Cadena que representa un URN de funcionalidad.

parameters

keyValuePair[]

Lista de pares clave-valor.

selectorId

string

Cadena que representa un selector.

type string:

discrete

Enumeración que discrimina entre los modelos de acción.

ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.

type

string

Tipo de información adicional.

ErrorDetail

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.

code

string

Código de error.

details

ErrorDetail[]

Los detalles del error.

message

string

El mensaje de error.

target

string

Destino del error.

ErrorResponse

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

experiment

Modelo que representa un recurso de experimento.

Nombre Tipo Description
id

string

Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

Identidad del recurso del experimento.

location

string

Ubicación geográfica donde reside el recurso

name

string

Nombre del recurso.

properties.provisioningState

ProvisioningState

Estado de aprovisionamiento más reciente para el recurso de experimento especificado.

properties.selectors selector[]:

Lista de selectores.

properties.steps

step[]

Lista de pasos.

systemData

systemData

Metadatos del sistema del recurso del experimento.

tags

object

Etiquetas del recurso.

type

string

Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

keyValuePair

Mapa para describir la configuración de una acción.

Nombre Tipo Description
key

string

Nombre de la configuración de la acción.

value

string

Valor de la configuración de la acción.

listSelector

Modelo que representa un selector de lista.

Nombre Tipo Description
filter filter:

simpleFilter

Modelo que representa los tipos de filtro disponibles que se pueden aplicar a una lista de destinos.

id

string

Cadena del identificador del selector.

targets

targetReference[]

Lista de referencias de destino.

type string:

List

Enumeración del tipo de selector.

ProvisioningState

Estado de aprovisionamiento más reciente para el recurso de experimento especificado.

Nombre Tipo Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

Modelo que representa un selector de consultas.

Nombre Tipo Description
filter filter:

simpleFilter

Modelo que representa los tipos de filtro disponibles que se pueden aplicar a una lista de destinos.

id

string

Cadena del identificador del selector.

queryString

string

Consulta del lenguaje de consulta de Azure Resource Graph (ARG) para los recursos de destino.

subscriptionIds

string[]

Lista de identificadores de suscripción para definir el ámbito de la consulta de recursos.

type string:

Query

Enumeración del tipo de selector.

resourceIdentity

Identidad de un recurso.

Nombre Tipo Description
principalId

string

GUID que representa el identificador de entidad de seguridad de esta identidad de recurso.

tenantId

string

GUID que representa el identificador de inquilino de esta identidad de recurso.

type

ResourceIdentityType

Cadena del tipo de identidad del recurso.

userAssignedIdentities

<string,  UserAssignedIdentity>

identidades de User-Assigned
Lista de identidades de usuario asociadas al experimento. Las referencias de clave de diccionario de identidades de usuario serán identificadores de recurso de ARM con el formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ResourceIdentityType

Cadena del tipo de identidad del recurso.

Nombre Tipo Description
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

Modelo que representa un filtro de destino simple.

Nombre Tipo Description
parameters

simpleFilterParameters

Modelo que representa los parámetros de filtro simple.

type string:

Simple

Enumeración que discrimina entre tipos de filtro. Actualmente solo Simple se admite el tipo.

simpleFilterParameters

Modelo que representa los parámetros de filtro simple.

Nombre Tipo Description
zones

string[]

Lista de zonas de disponibilidad de Azure por las que se van a filtrar los destinos.

step

Modelo que representa un paso en el recurso Experimento.

Nombre Tipo Description
branches

branch[]

Lista de ramas.

name

string

Cadena del nombre del paso.

systemData

Metadatos relacionados con la creación y la última modificación del recurso.

Nombre Tipo Description
createdAt

string

Marca de tiempo de creación de recursos (UTC).

createdBy

string

Identidad que creó el recurso.

createdByType

createdByType

Tipo de identidad que creó el recurso.

lastModifiedAt

string

Marca de tiempo de la última modificación del recurso (UTC)

lastModifiedBy

string

Identidad que modificó por última vez el recurso.

lastModifiedByType

createdByType

Tipo de identidad que modificó por última vez el recurso.

targetReference

Modelo que representa una referencia a un destino en el selector.

Nombre Tipo Description
id

string

Cadena del identificador de recurso de un recurso de destino.

type

TargetReferenceType

Enumeración del tipo de referencia target.

TargetReferenceType

Enumeración del tipo de referencia target.

Nombre Tipo Description
ChaosTarget

string

UserAssignedIdentity

Propiedades de identidad asignadas por el usuario

Nombre Tipo Description
clientId

string

Identificador de cliente de la identidad asignada.

principalId

string

Identificador de entidad de seguridad de la identidad asignada.