Compartilhar via

Experiments - Create Or Update

  • Referência
Serviço:
Chaos Studio
Versão da API:
2024-01-01

Criar ou atualizar um 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 URI

Nome Em Obrigató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

Cadeia de caracteres que representa um grupo de recursos do Azure.

Padrão Regex: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$
subscriptionId
 path True

string

GUID que representa uma ID de assinatura do Azure.

Padrão Regex: ^[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

Cadeia de caracteres que define a versão da API.

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

Corpo da solicitação

Nome Obrigatório Tipo Description
location True

string

A localização geográfica em que o recurso reside
properties.selectors True selector[]:

Lista de seletores.
properties.steps True

step[]

Lista de etapas.
identity

resourceIdentity

A identidade do recurso de experimento.
tags

object

Marcas de recurso.

Respostas

Nome Tipo Description
200 OK

experiment

Operação de substituição de experimento de execução prolongada.
201 Created

experiment

Operação de criação de experimento de execução prolongada.
Other Status Codes

ErrorResponse

Resposta de erro retornada se a solicitação não tiver sido bem-sucedida.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation Representar sua conta de usuário

Exemplos

Create/update a Experiment in a resource group.

Solicitação de exemplo

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

Resposta de exemplo

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

Definições

Nome Description
branch

Modelo que representa um branch na etapa. 9 total por experimento.
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

As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail

Os detalhes do erro.
ErrorResponse

Resposta de erro
experiment

Modelo que representa um recurso de Experimento.
keyValuePair

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

Modelo que representa um seletor de lista.
ProvisioningState

Estado de provisionamento mais recente para o recurso de experimento especificado.
querySelector

Modelo que representa um seletor de consulta.
resourceIdentity

A identidade de um recurso.
ResourceIdentityType

Cadeia de caracteres do tipo de identidade do recurso.
simpleFilter

Modelo que representa um filtro de destino simples.
simpleFilterParameters

Modelo que representa os parâmetros de filtro Simples.
step

Modelo que representa uma etapa no recurso Experimento.
systemData

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

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

Enumeração do tipo de referência De destino.
UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

branch

Modelo que representa um branch na etapa. 9 total por experimento.

Nome Tipo Description
actions action[]:

Lista de ações.
name

string

Cadeia de caracteres do nome do branch.

continuousAction

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

Nome Tipo Description
duration

string

ISO8601 cadeia de caracteres formatada que representa uma duração.
name

string

Cadeia de caracteres que representa um URN de Funcionalidade.
parameters

keyValuePair[]

Lista de pares chave-valor.
selectorId

string

Cadeia de caracteres que representa um seletor.
type string:

continuous

Enumeração que discrimina os modelos de ação.

createdByType

O tipo de identidade que criou o recurso.

Nome Tipo Description
Application

string

Key

string

ManagedIdentity

string

User

string

delayAction

Modelo que representa uma ação de atraso.

Nome Tipo Description
duration

string

ISO8601 cadeia de caracteres formatada que representa uma duração.
name

string

Cadeia de caracteres que representa um URN de Funcionalidade.
type string:

delay

Enumeração que discrimina os modelos de ação.

discreteAction

Modelo que representa uma ação discreta.

Nome Tipo Description
name

string

Cadeia de caracteres que representa um URN de Funcionalidade.
parameters

keyValuePair[]

Lista de pares chave-valor.
selectorId

string

Cadeia de caracteres que representa um seletor.
type string:

discrete

Enumeração que discrimina os modelos de ação.

ErrorAdditionalInfo

As informações adicionais do erro de gerenciamento de recursos.

Nome Tipo Description
info

object

As informações adicionais.
type

string

O tipo de informação adicional.

ErrorDetail

Os detalhes do erro.

Nome Tipo Description
additionalInfo

ErrorAdditionalInfo[]

As informações adicionais do erro.
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

Nome Tipo Description
error

ErrorDetail

O objeto de erro.

experiment

Modelo que representa um recurso de Experimento.

Nome Tipo Description
id

string

ID de recurso totalmente qualificada para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
identity

resourceIdentity

A identidade do recurso de experimento.
location

string

A localização geográfica em que o recurso reside
name

string

O nome do recurso
properties.provisioningState

ProvisioningState

Estado de provisionamento mais recente para o recurso de experimento especificado.
properties.selectors selector[]:

Lista de seletores.
properties.steps

step[]

Lista de etapas.
systemData

systemData

Os metadados do sistema do recurso de experimento.
tags

object

Marcas de recurso.
type

string

Tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

keyValuePair

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

Nome Tipo Description
key

string

O nome da configuração da ação.
value

string

O valor da configuração da ação.

listSelector

Modelo que representa um seletor de lista.

Nome Tipo Description
filter filter:

simpleFilter

Modelo que representa os tipos de filtro disponíveis que podem ser aplicados a uma lista de destinos.
id

string

Cadeia de caracteres da ID do seletor.
targets

targetReference[]

Lista de referências de destino.
type string:

List

Enumeração do tipo seletor.

ProvisioningState

Estado de provisionamento mais recente para o recurso de experimento especificado.

Nome Tipo Description
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

Modelo que representa um seletor de consulta.

Nome Tipo Description
filter filter:

simpleFilter

Modelo que representa os tipos de filtro disponíveis que podem ser aplicados a uma lista de destinos.
id

string

Cadeia de caracteres da ID do seletor.
queryString

string

Consulta de linguagem de consulta do ARG (Azure Resource Graph) para recursos de destino.
subscriptionIds

string[]

Lista de IDs de assinatura para a consulta de recurso de escopo.
type string:

Query

Enumeração do tipo seletor.

resourceIdentity

A identidade de um recurso.

Nome Tipo Description
principalId

string

GUID que representa a ID da entidade de segurança dessa identidade de recurso.
tenantId

string

GUID que representa a ID do locatário dessa identidade de recurso.
type

ResourceIdentityType

Cadeia de caracteres do tipo de identidade do recurso.
userAssignedIdentities

<string,  UserAssignedIdentity>

Identidades User-Assigned
A lista de identidades de usuário associadas ao Experimento. As referências de chave de dicionário de identidade do usuário serão IDs de recurso do ARM no formato: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ResourceIdentityType

Cadeia de caracteres do tipo de identidade do recurso.

Nome Tipo Description
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

Modelo que representa um filtro de destino simples.

Nome Tipo Description
parameters

simpleFilterParameters

Modelo que representa os parâmetros de filtro Simples.
type string:

Simple

Enumeração que discrimina os tipos de filtro. Atualmente, há suporte apenas Simple para o tipo .

simpleFilterParameters

Modelo que representa os parâmetros de filtro Simples.

Nome Tipo Description
zones

string[]

Lista de zonas de disponibilidade do Azure pelas quais filtrar destinos.

step

Modelo que representa uma etapa no recurso Experimento.

Nome Tipo Description
branches

branch[]

Lista de branches.
name

string

Cadeia de caracteres do nome da etapa.

systemData

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

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

Nome Tipo Description
id

string

Cadeia de caracteres da ID do recurso de um recurso de destino.
type

TargetReferenceType

Enumeração do tipo de referência De destino.

TargetReferenceType

Enumeração do tipo de referência De destino.

Nome Tipo Description
ChaosTarget

string

UserAssignedIdentity

Propriedades de identidade atribuídas pelo usuário

Nome Tipo Description
clientId

string

A ID do cliente da identidade atribuída.
principalId

string

A ID da entidade de segurança da identidade atribuída.