Experiments - Create Or Update

Serviço:: Chaos Studio

Versão da API:: 2025-01-01

Crie ou atualize um recurso de Experimento.

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

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
experimentName	path	True	string minLength: 1 pattern: ^[^<>%&:?#/\\]+$	Cadeia de caracteres que representa um nome de recurso de experimento.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A geolocalização onde o recurso vive
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Lista de seletores.
properties.steps	True	ChaosExperimentStep[]	Lista de etapas.
identity		ManagedServiceIdentity	As identidades de serviço gerenciado atribuídas a este recurso.
tags		object	Tags de recursos.

Respostas

Name	Tipo	Description
200 OK	Experiment	Operação de atualização do recurso 'Experimento' bem-sucedida
201 Created	Experiment	Recurso 'Experimento' criar operação bem-sucedida Cabeçalhos Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Uma resposta de erro inesperada.

Name

Tipo

Description

200 OK

Experiment

Operação de atualização do recurso 'Experimento' bem-sucedida

201 Created

Experiment

Recurso 'Experimento' criar operação bem-sucedida

Cabeçalhos

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

Create/update a Experiment in a resource group.

Pedido de amostra

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

Resposta da amostra

Código de estado:: 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"
  }
}

Código de estado:: 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"
  }
}

Definições

Name	Description
ChaosExperimentBranch	Modelo que representa uma ramificação na etapa. 9 no total por experimento.
ChaosExperimentStep	Modelo que representa uma etapa no recurso Experimentar.
ChaosTargetListSelector	Modelo que representa um seletor de lista.
ChaosTargetQuerySelector	Modelo que representa um seletor de consulta.
ChaosTargetSimpleFilter	Modelo que representa um filtro de destino simples.
ChaosTargetSimpleFilterParameters	Modelo que representa os parâmetros de filtro simples.
ContinuousAction	Modelo que representa uma ação contínua.
createdByType	O tipo de identidade que criou o recurso.
DelayAction	Modelo que representa uma ação de atraso.
DiscreteAction	Modelo que representa uma ação discreta.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
Experiment	Modelo que representa um recurso de Experimento.
ExperimentActionType	Enum união de tipos de ação experimento do Caos.
FilterType	Enum que discrimina entre tipos de filtro. Atualmente, apenas `Simple` tipo é suportado.
KeyValuePair	Um mapa para descrever as configurações de uma ação.
ManagedServiceIdentity	Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)
ManagedServiceIdentityType	Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).
ProvisioningState	Estado de provisionamento atual para um determinado recurso do Azure Chaos.
SelectorType	Enum do tipo seletor.
systemData	Metadados referentes à criação e última modificação do recurso.
TargetReference	Modelo que representa uma referência a um Destino no seletor.
TargetReferenceType	Enum do tipo de referência Target.
UserAssignedIdentity	Propriedades de identidade atribuídas pelo usuário

ChaosExperimentBranch

Object

Modelo que representa uma ramificação na etapa. 9 no total por experimento.

Name	Tipo	Description
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Lista de ações.
name	string minLength: 1	Cadeia de caracteres do nome da ramo.

ChaosExperimentStep

Object

Modelo que representa uma etapa no recurso Experimentar.

Name	Tipo	Description
branches	ChaosExperimentBranch[]	Lista de sucursais.
name	string minLength: 1	String do nome da etapa.

ChaosTargetListSelector

Object

Modelo que representa um seletor de lista.

Name	Tipo	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modelo que representa os tipos de filtro disponíveis que podem ser aplicados a uma lista de destinos.
id	string minLength: 1	String do ID do seletor.
targets	TargetReference[]	Lista de referências de destino.
type	string: List	Tipo de seletor de alvo do caos

ChaosTargetQuerySelector

Object

Modelo que representa um seletor de consulta.

Name	Tipo	Description
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Modelo que representa os tipos de filtro disponíveis que podem ser aplicados a uma lista de destinos.
id	string minLength: 1	String do ID do seletor.
queryString	string	Consulta da Linguagem de Consulta do Azure Resource Graph (ARG) para recursos de destino.
subscriptionIds	string[]	Lista de ID de assinatura para consulta de recursos de escopo.
type	string: Query	Tipo de seletor de alvo do caos

ChaosTargetSimpleFilter

Object

Modelo que representa um filtro de destino simples.

Name	Tipo	Description
parameters	ChaosTargetSimpleFilterParameters	Modelo que representa os parâmetros de filtro simples.
type	string: Simple	Tipo de discriminador de filtro alvo do caos

ChaosTargetSimpleFilterParameters

Object

Modelo que representa os parâmetros de filtro simples.

Name	Tipo	Description
zones	string[]	Lista de zonas de disponibilidade do Azure pelas quais filtrar destinos.

ContinuousAction

Object

Modelo que representa uma ação contínua.

Name	Tipo	Description
duration	string (duration)	ISO8601 cadeia de caracteres formatada que representa uma duração.
name	string maxLength: 2048	Cadeia de caracteres que representa um URN de capacidade.
parameters	KeyValuePair[]	Lista de pares de valores de chave.
selectorId	string minLength: 1	String que representa um seletor.
type	string: continuous	Tipo discriminador de ação do experimento do caos

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
User
Application
ManagedIdentity
Key

DelayAction

Object

Modelo que representa uma ação de atraso.

Name	Tipo	Description
duration	string (duration)	ISO8601 cadeia de caracteres formatada que representa uma duração.
name	string maxLength: 2048	Cadeia de caracteres que representa um URN de capacidade.
type	string: delay	Tipo discriminador de ação do experimento do caos

DiscreteAction

Object

Modelo que representa uma ação discreta.

Name	Tipo	Description
name	string maxLength: 2048	Cadeia de caracteres que representa um URN de capacidade.
parameters	KeyValuePair[]	Lista de pares de valores de chave.
selectorId	string minLength: 1	String que representa um seletor.
type	string: discrete	Tipo discriminador de ação do experimento do caos

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

Experiment

Object

Modelo que representa um recurso de Experimento.

Name	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	As identidades de serviço gerenciado atribuídas a este recurso.
location	string	A geolocalização onde o recurso vive
name	string	O nome do recurso
properties.provisioningState	ProvisioningState	Estado de provisionamento mais recente para o recurso de experimento fornecido.
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Lista de seletores.
properties.steps	ChaosExperimentStep[]	Lista de etapas.
systemData	systemData	Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
tags	object	Tags de recursos.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

ExperimentActionType

Enumeração

Enum união de tipos de ação experimento do Caos.

Valor	Description
delay
discrete
continuous

FilterType

Enumeração

Enum que discrimina entre tipos de filtro. Atualmente, apenas Simple tipo é suportado.

Valor	Description
Simple	Tipo de filtro simples.

KeyValuePair

Object

Um mapa para descrever as configurações de uma ação.

Name	Tipo	Description
key	string minLength: 1	O nome da configuração da ação.
value	string minLength: 1	O valor da configuração para a ação.

ManagedServiceIdentity

Object

Identidade do serviço gerenciado (identidades atribuídas pelo sistema e/ou pelo usuário)

Name	Tipo	Description
principalId	string (uuid)	O ID da entidade de serviço da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.
tenantId	string (uuid)	O ID do locatário da identidade atribuída ao sistema. Esta propriedade só será fornecida para uma identidade atribuída ao sistema.
type	ManagedServiceIdentityType	Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).
userAssignedIdentities	<string, UserAssignedIdentity>	User-Assigned Identidades O conjunto de identidades atribuídas pelo usuário associadas ao recurso. As chaves do dicionário userAssignedIdentities serão ids de recurso ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Os valores de dicionário podem ser objetos vazios ({}) em solicitações.

ManagedServiceIdentityType

Enumeração

Tipo de identidade de serviço gerenciado (onde os tipos SystemAssigned e UserAssigned são permitidos).

Valor	Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Enumeração

Estado de provisionamento atual para um determinado recurso do Azure Chaos.

Valor	Description
Succeeded	O recurso foi criado.
Failed	Falha na criação de recursos.
Canceled	A criação de recursos foi cancelada.
Creating	Criação inicial em curso.
Updating	Atualização em curso.
Deleting	Supressão em curso.

SelectorType

Enumeração

Enum do tipo seletor.

Valor	Description
List	Tipo de seletor de lista.
Query	Tipo de seletor de consulta.

systemData

Object

Metadados referentes à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

TargetReference

Object

Modelo que representa uma referência a um Destino no seletor.

Name	Tipo	Description
id	string (arm-id)	Cadeia de caracteres da ID do recurso de um recurso de destino.
type	TargetReferenceType	Enum do tipo de referência Target.

TargetReferenceType

Enumeração

Enum do tipo de referência Target.

Valor	Description
ChaosTarget	Tipo de referência de destino do caos.

UserAssignedIdentity

Object

Propriedades de identidade atribuídas pelo usuário

Name	Tipo	Description
clientId	string (uuid)	O ID do cliente da identidade atribuída.
principalId	string (uuid)	O ID principal da identidade atribuída.

Partilhar via

Experiments - Create Or Update

Parâmetros do URI

Corpo do Pedido

Respostas

Segurança

azure_auth

Âmbitos

Exemplos

Create/update a Experiment in a resource group.

Pedido de amostra

Resposta da amostra

Definições

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