Udostępnij za pośrednictwem


Experiments - Create Or Update

Utwórz lub zaktualizuj zasób eksperymentu.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
experimentName
path True

string

Ciąg reprezentujący nazwę zasobu eksperymentu.

Wzorzec wyrażenia regularnego: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

Ciąg reprezentujący grupę zasobów platformy Azure.

Wzorzec wyrażenia regularnego: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

Identyfikator GUID reprezentujący identyfikator subskrypcji platformy Azure.

Wzorzec wyrażenia regularnego: ^[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

Ciąg, który ustawia wersję interfejsu API.

Wzorzec wyrażenia regularnego: ^[0-9]{4}-[0-9]{2}-[0-9]{2}(|-preview)$

Treść żądania

Nazwa Wymagane Typ Opis
location True

string

Lokalizacja geograficzna, w której znajduje się zasób

properties.selectors True selector[]:

Lista selektorów.

properties.steps True

step[]

Lista kroków.

identity

resourceIdentity

Tożsamość zasobu eksperymentu.

tags

object

Tagi zasobów.

Odpowiedzi

Nazwa Typ Opis
200 OK

experiment

Długotrwała operacja zastępowania eksperymentu.

201 Created

experiment

Długotrwała operacja tworzenia eksperymentu.

Other Status Codes

ErrorResponse

Odpowiedź z błędem zwrócona, jeśli żądanie nie powiodło się.

Zabezpieczenia

azure_auth

Przepływ 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 Personifikuj konto użytkownika

Przykłady

Create/update a Experiment in a resource group.

Przykładowe żądanie

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

Przykładowa odpowiedź

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

Definicje

Nazwa Opis
branch

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

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.

keyValuePair

Mapa opisowa ustawień akcji.

listSelector

Model reprezentujący selektor listy.

ProvisioningState

Najnowszy stan aprowizacji dla danego zasobu eksperymentu.

querySelector

Model reprezentujący selektor zapytań.

resourceIdentity

Tożsamość zasobu.

ResourceIdentityType

Ciąg typu tożsamości zasobu.

simpleFilter

Model reprezentujący prosty filtr docelowy.

simpleFilterParameters

Model reprezentujący proste parametry filtru.

step

Model reprezentujący krok w zasobie Eksperyment.

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

UserAssignedIdentity

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

branch

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

Nazwa Typ Opis
actions action[]:

Lista akcji.

name

string

Ciąg nazwy gałęzi.

continuousAction

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

Nazwa Typ Opis
duration

string

ISO8601 sformatowany ciąg reprezentujący czas trwania.

name

string

Ciąg reprezentujący identyfikator URN możliwości.

parameters

keyValuePair[]

Lista par klucz-wartość.

selectorId

string

Ciąg reprezentujący selektor.

type string:

continuous

Wyliczenie, które rozróżnia modele akcji.

createdByType

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

Nazwa Typ Opis
Application

string

Key

string

ManagedIdentity

string

User

string

delayAction

Model reprezentujący akcję opóźnienia.

Nazwa Typ Opis
duration

string

ISO8601 sformatowany ciąg reprezentujący czas trwania.

name

string

Ciąg reprezentujący identyfikator URN możliwości.

type string:

delay

Wyliczenie, które rozróżnia modele akcji.

discreteAction

Model reprezentujący dyskretną akcję.

Nazwa Typ Opis
name

string

Ciąg reprezentujący identyfikator URN możliwości.

parameters

keyValuePair[]

Lista par klucz-wartość.

selectorId

string

Ciąg reprezentujący selektor.

type string:

discrete

Wyliczenie, które rozróżnia modele akcji.

ErrorAdditionalInfo

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

Nazwa Typ Opis
info

object

Dodatkowe informacje.

type

string

Dodatkowy typ informacji.

ErrorDetail

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

Odpowiedź na błąd

Nazwa Typ Opis
error

ErrorDetail

Obiekt error.

experiment

Model reprezentujący zasób eksperymentu.

Nazwa Typ Opis
id

string

W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

Tożsamość zasobu eksperymentu.

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 selector[]:

Lista selektorów.

properties.steps

step[]

Lista kroków.

systemData

systemData

Metadane systemowe zasobu eksperymentu.

tags

object

Tagi zasobów.

type

string

Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

keyValuePair

Mapa opisowa ustawień akcji.

Nazwa Typ Opis
key

string

Nazwa ustawienia akcji.

value

string

Wartość ustawienia dla akcji.

listSelector

Model reprezentujący selektor listy.

Nazwa Typ Opis
filter filter:

simpleFilter

Model reprezentujący dostępne typy filtrów, które można zastosować do listy elementów docelowych.

id

string

Ciąg identyfikatora selektora.

targets

targetReference[]

Lista odwołań do elementów docelowych.

type string:

List

Wyliczenie typu selektora.

ProvisioningState

Najnowszy stan aprowizacji dla danego zasobu eksperymentu.

Nazwa Typ Opis
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

Model reprezentujący selektor zapytań.

Nazwa Typ Opis
filter filter:

simpleFilter

Model reprezentujący dostępne typy filtrów, które można zastosować do listy elementów docelowych.

id

string

Ciąg identyfikatora selektora.

queryString

string

Zapytanie języka zapytań języka zapytań usługi Azure Resource Graph (ARG) dla zasobów docelowych.

subscriptionIds

string[]

Lista identyfikatorów subskrypcji do zapytania o zasób zakresu.

type string:

Query

Wyliczenie typu selektora.

resourceIdentity

Tożsamość zasobu.

Nazwa Typ Opis
principalId

string

Identyfikator GUID reprezentujący identyfikator podmiotu zabezpieczeń tej tożsamości zasobu.

tenantId

string

Identyfikator GUID reprezentujący identyfikator dzierżawy tej tożsamości zasobu.

type

ResourceIdentityType

Ciąg typu tożsamości zasobu.

userAssignedIdentities

<string,  UserAssignedIdentity>

tożsamości User-Assigned
Lista tożsamości użytkowników skojarzonych z eksperymentem. Odwołania do klucza słownika tożsamości użytkownika będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}".

ResourceIdentityType

Ciąg typu tożsamości zasobu.

Nazwa Typ Opis
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

Model reprezentujący prosty filtr docelowy.

Nazwa Typ Opis
parameters

simpleFilterParameters

Model reprezentujący proste parametry filtru.

type string:

Simple

Wyliczenie, które rozróżnia typy filtrów. Obecnie obsługiwany jest tylko Simple typ.

simpleFilterParameters

Model reprezentujący proste parametry filtru.

Nazwa Typ Opis
zones

string[]

Lista stref dostępności platformy Azure do filtrowania elementów docelowych według.

step

Model reprezentujący krok w zasobie Eksperyment.

Nazwa Typ Opis
branches

branch[]

Lista gałęzi.

name

string

Ciąg nazwy kroku.

systemData

Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu.

Nazwa Typ Opis
createdAt

string

Sygnatura czasowa tworzenia zasobów (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

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

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

Nazwa Typ Opis
id

string

Ciąg identyfikatora zasobu zasobu docelowego.

type

TargetReferenceType

Wyliczenie typu odwołania docelowego.

TargetReferenceType

Wyliczenie typu odwołania docelowego.

Nazwa Typ Opis
ChaosTarget

string

UserAssignedIdentity

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

Nazwa Typ Opis
clientId

string

Identyfikator klienta przypisanej tożsamości.

principalId

string

Identyfikator podmiotu zabezpieczeń przypisanej tożsamości.