Experiments - Create Or Update

Usługa:: Chaos Studio

Wersja interfejsu API:: 2025-01-01

Utwórz lub zaktualizuj zasób eksperymentu.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
experimentName	path	True	string minLength: 1 pattern: ^[^<>%&:?#/\\]+$	Ciąg reprezentujący nazwę zasobu Eksperyment.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwa	Wymagane	Typ	Opis
location	True	string	Lokalizacja geograficzna, w której znajduje się zasób
properties.selectors	True	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Lista selektorów.
properties.steps	True	ChaosExperimentStep[]	Lista kroków.
identity		ManagedServiceIdentity	Tożsamości usługi zarządzanej przypisane do tego zasobu.
tags		object	Tagi zasobów.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Experiment	Operacja aktualizacji zasobu "Eksperyment" powiodła się
201 Created	Experiment	Operacja tworzenia zasobu "Eksperyment" powiodła się Nagłówki Azure-AsyncOperation: string Retry-After: integer
Other Status Codes	ErrorResponse	Nieoczekiwana odpowiedź na błąd.

Nazwa

Typ

Opis

200 OK

Experiment

Operacja aktualizacji zasobu "Eksperyment" powiodła się

201 Created

Experiment

Operacja tworzenia zasobu "Eksperyment" powiodła się

Nagłówki

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

ErrorResponse

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Create/update a Experiment in a resource group.

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:: 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"
  }
}

Kod stanu:: 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"
  }
}

Definicje

Nazwa	Opis
ChaosExperimentBranch	Model reprezentujący gałąź w kroku. 9 sum na eksperyment.
ChaosExperimentStep	Model reprezentujący krok w zasobie Eksperyment.
ChaosTargetListSelector	Model reprezentujący selektor listy.
ChaosTargetQuerySelector	Model reprezentujący selektor zapytań.
ChaosTargetSimpleFilter	Model reprezentujący prosty filtr docelowy.
ChaosTargetSimpleFilterParameters	Model reprezentujący parametry filtru prostego.
ContinuousAction	Model reprezentujący ciągłą akcję.
createdByType	Typ tożsamości, która utworzyła zasób.
DelayAction	Model reprezentujący akcję opóźnienia.
DiscreteAction	Model reprezentujący dyskretną akcję.
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
Experiment	Model reprezentujący zasób Eksperymentu.
ExperimentActionType	Wyliczenie typów akcji eksperymentu Chaos.
FilterType	Wyliczenie dyskryminujące typy filtrów. Obecnie obsługiwany jest tylko typ `Simple`.
KeyValuePair	Mapa opisując ustawienia akcji.
ManagedServiceIdentity	Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)
ManagedServiceIdentityType	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
ProvisioningState	Bieżący stan aprowizacji dla danego zasobu chaosu platformy Azure.
SelectorType	Wyliczenie typu selektora.
systemData	Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.
TargetReference	Model reprezentujący odwołanie do elementu docelowego w selektorze.
TargetReferenceType	Wyliczenie typu odwołania target.
UserAssignedIdentity	Właściwości tożsamości przypisanej przez użytkownika

ChaosExperimentBranch

Objekt

Model reprezentujący gałąź w kroku. 9 sum na eksperyment.

Nazwa	Typ	Opis
actions	ChaosExperimentAction[]: ContinuousAction[] DelayAction[] DiscreteAction[]	Lista akcji.
name	string minLength: 1	Ciąg nazwy gałęzi.

ChaosExperimentStep

Objekt

Model reprezentujący krok w zasobie Eksperyment.

Nazwa	Typ	Opis
branches	ChaosExperimentBranch[]	Lista gałęzi.
name	string minLength: 1	Ciąg nazwy kroku.

ChaosTargetListSelector

Objekt

Model reprezentujący selektor listy.

Nazwa	Typ	Opis
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Model reprezentujący dostępne typy filtrów, które można zastosować do listy elementów docelowych.
id	string minLength: 1	Ciąg identyfikatora selektora.
targets	TargetReference[]	Lista odwołań docelowych.
type	string: List	Typ dyskryminujący selektora chaosu

ChaosTargetQuerySelector

Objekt

Model reprezentujący selektor zapytań.

Nazwa	Typ	Opis
filter	ChaosTargetFilter: ChaosTargetSimpleFilter	Model reprezentujący dostępne typy filtrów, które można zastosować do listy elementów docelowych.
id	string minLength: 1	Ciąg identyfikatora selektora.
queryString	string	Zapytanie języka zapytań usługi Azure Resource Graph (ARG) dla zasobów docelowych.
subscriptionIds	string[]	Lista identyfikatorów subskrypcji do zapytania o zakres zasobów.
type	string: Query	Typ dyskryminujący selektora chaosu

ChaosTargetSimpleFilter

Objekt

Model reprezentujący prosty filtr docelowy.

Nazwa	Typ	Opis
parameters	ChaosTargetSimpleFilterParameters	Model reprezentujący parametry filtru prostego.
type	string: Simple	Typ dyskryminujący filtru chaosu

ChaosTargetSimpleFilterParameters

Objekt

Model reprezentujący parametry filtru prostego.

Nazwa	Typ	Opis
zones	string[]	Lista stref dostępności platformy Azure do filtrowania elementów docelowych według.

ContinuousAction

Objekt

Model reprezentujący ciągłą akcję.

Nazwa	Typ	Opis
duration	string (duration)	ISO8601 sformatowany ciąg reprezentujący czas trwania.
name	string maxLength: 2048	Ciąg reprezentujący identyfikator URN możliwości.
parameters	KeyValuePair[]	Lista par klucz-wartość.
selectorId	string minLength: 1	Ciąg reprezentujący selektor.
type	string: continuous	Typ dyskryminującego działania eksperymentu chaosu

createdByType

Wyliczanie

Typ tożsamości, która utworzyła zasób.

Wartość	Opis
User
Application
ManagedIdentity
Key

DelayAction

Objekt

Model reprezentujący akcję opóźnienia.

Nazwa	Typ	Opis
duration	string (duration)	ISO8601 sformatowany ciąg reprezentujący czas trwania.
name	string maxLength: 2048	Ciąg reprezentujący identyfikator URN możliwości.
type	string: delay	Typ dyskryminującego działania eksperymentu chaosu

DiscreteAction

Objekt

Model reprezentujący dyskretną akcję.

Nazwa	Typ	Opis
name	string maxLength: 2048	Ciąg reprezentujący identyfikator URN możliwości.
parameters	KeyValuePair[]	Lista par klucz-wartość.
selectorId	string minLength: 1	Ciąg reprezentujący selektor.
type	string: discrete	Typ dyskryminującego działania eksperymentu chaosu

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

Experiment

Objekt

Model reprezentujący zasób Eksperymentu.

Nazwa	Typ	Opis
id	string (arm-id)	W pełni kwalifikowany identyfikator zasobu dla zasobu. Np. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	ManagedServiceIdentity	Tożsamości usługi zarządzanej przypisane do tego zasobu.
location	string	Lokalizacja geograficzna, w której znajduje się zasób
name	string	Nazwa zasobu
properties.provisioningState	ProvisioningState	Najnowszy stan aprowizacji dla danego zasobu eksperymentu.
properties.selectors	ChaosTargetSelector[]: ChaosTargetListSelector[] ChaosTargetQuerySelector[]	Lista selektorów.
properties.steps	ChaosExperimentStep[]	Lista kroków.
systemData	systemData	Metadane usługi Azure Resource Manager zawierające informacje createdBy i modifiedBy.
tags	object	Tagi zasobów.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ExperimentActionType

Wyliczanie

Wyliczenie typów akcji eksperymentu Chaos.

Wartość	Opis
delay
discrete
continuous

FilterType

Wyliczanie

Wyliczenie dyskryminujące typy filtrów. Obecnie obsługiwany jest tylko typ Simple.

Wartość	Opis
Simple	Prosty typ filtru.

KeyValuePair

Objekt

Mapa opisując ustawienia akcji.

Nazwa	Typ	Opis
key	string minLength: 1	Nazwa ustawienia akcji.
value	string minLength: 1	Wartość ustawienia akcji.

ManagedServiceIdentity

Objekt

Tożsamość usługi zarządzanej (tożsamości przypisane przez system i/lub tożsamości przypisane przez użytkownika)

Nazwa	Typ	Opis
principalId	string (uuid)	Identyfikator jednostki usługi tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.
tenantId	string (uuid)	Identyfikator dzierżawy tożsamości przypisanej przez system. Ta właściwość zostanie udostępniona tylko dla tożsamości przypisanej przez system.
type	ManagedServiceIdentityType	Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).
userAssignedIdentities	<string, UserAssignedIdentity>	tożsamości User-Assigned Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach.

ManagedServiceIdentityType

Wyliczanie

Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned).

Wartość	Opis
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ProvisioningState

Wyliczanie

Bieżący stan aprowizacji dla danego zasobu chaosu platformy Azure.

Wartość	Opis
Succeeded	Zasób został utworzony.
Failed	Tworzenie zasobu nie powiodło się.
Canceled	Tworzenie zasobów zostało anulowane.
Creating	Wstępne tworzenie w toku.
Updating	Aktualizowanie w toku.
Deleting	Trwa usuwanie.

SelectorType

Wyliczanie

Wyliczenie typu selektora.

Wartość	Opis
List	Typ selektora listy.
Query	Typ selektora zapytań.

systemData

Objekt

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa	Typ	Opis
createdAt	string (date-time)	Sygnatura czasowa tworzenia zasobu (UTC).
createdBy	string	Tożsamość, która utworzyła zasób.
createdByType	createdByType	Typ tożsamości, która utworzyła zasób.
lastModifiedAt	string (date-time)	Znacznik czasu ostatniej modyfikacji zasobu (UTC)
lastModifiedBy	string	Tożsamość, która ostatnio zmodyfikowała zasób.
lastModifiedByType	createdByType	Typ tożsamości, która ostatnio zmodyfikowała zasób.

TargetReference

Objekt

Model reprezentujący odwołanie do elementu docelowego w selektorze.

Nazwa	Typ	Opis
id	string (arm-id)	Ciąg identyfikatora zasobu zasobu docelowego.
type	TargetReferenceType	Wyliczenie typu odwołania target.

TargetReferenceType

Wyliczanie

Wyliczenie typu odwołania target.

Wartość	Opis
ChaosTarget	Typ odwołania docelowego chaosu.

UserAssignedIdentity

Objekt

Właściwości tożsamości przypisanej przez użytkownika

Nazwa	Typ	Opis
clientId	string (uuid)	Identyfikator klienta przypisanej tożsamości.
principalId	string (uuid)	Identyfikator podmiotu zabezpieczeń przypisanej tożsamości.

Udostępnij przez

Experiments - Create Or Update

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

Create/update a Experiment in a resource group.

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

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