Experiments - Create Or Update

Referência

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	Cadeia de caracteres que representa um nome de recurso de experimento. Padrão Regex: `^[^<>%&:?#/\\]+$`
resourceGroupName	path	True	string	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	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

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	Cadeia de caracteres do nome da ramo.

ChaosExperimentStep

Modelo que representa uma etapa no recurso Experimentar.

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

ChaosTargetListSelector

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	String do ID do seletor.
targets	TargetReference[]	Lista de referências de destino.
type	string: List	Tipo de seletor de alvo do caos

ChaosTargetQuerySelector

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

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

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

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

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

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

DelayAction

Modelo que representa uma ação de atraso.

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

DiscreteAction

Modelo que representa uma ação discreta.

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

ErrorAdditionalInfo

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

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

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

Experiment

Modelo que representa um recurso de Experimento.

Name	Tipo	Description
id	string	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

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

Name	Tipo	Description
continuous	string
delay	string
discrete	string

FilterType

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

Name	Tipo	Description
Simple	string	Tipo de filtro simples.

KeyValuePair

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

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

ManagedServiceIdentity

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

Name	Tipo	Description
principalId	string	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	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

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

Name	Tipo	Description
None	string
SystemAssigned	string
SystemAssigned,UserAssigned	string
UserAssigned	string

ProvisioningState

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

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

SelectorType

Enum do tipo seletor.

Name	Tipo	Description
List	string	Tipo de seletor de lista.
Query	string	Tipo de seletor de consulta.

systemData

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

Name	Tipo	Description
createdAt	string	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	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

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

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

TargetReferenceType

Enum do tipo de referência Target.

Name	Tipo	Description
ChaosTarget	string	Tipo de referência de destino do caos.

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

Name	Tipo	Description
clientId	string	O ID do cliente da identidade atribuída.
principalId	string	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

Recursos adicionais