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 |
---|---|---|---|---|
experiment
|
path | True |
string |
Ciąg reprezentujący nazwę zasobu eksperymentu. Wzorzec wyrażenia regularnego: |
resource
|
path | True |
string |
Ciąg reprezentujący grupę zasobów platformy Azure. Wzorzec wyrażenia regularnego: |
subscription
|
path | True |
string |
Identyfikator GUID reprezentujący identyfikator subskrypcji platformy Azure. Wzorzec wyrażenia regularnego: |
api-version
|
query | True |
string |
Ciąg, który ustawia wersję interfejsu API. Wzorzec wyrażenia regularnego: |
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 |
Tożsamość zasobu eksperymentu. |
||
tags |
object |
Tagi zasobów. |
Odpowiedzi
Nazwa | Typ | Opis |
---|---|---|
200 OK |
Długotrwała operacja zastępowania eksperymentu. |
|
201 Created |
Długotrwała operacja tworzenia eksperymentu. |
|
Other Status Codes |
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. |
continuous |
Model reprezentujący ciągłą akcję. |
created |
Typ tożsamości, która utworzyła zasób. |
delay |
Model reprezentujący akcję opóźnienia. |
discrete |
Model reprezentujący dyskretną akcję. |
Error |
Dodatkowe informacje o błędzie zarządzania zasobami. |
Error |
Szczegóły błędu. |
Error |
Odpowiedź na błąd |
experiment |
Model reprezentujący zasób eksperymentu. |
key |
Mapa opisowa ustawień akcji. |
list |
Model reprezentujący selektor listy. |
Provisioning |
Najnowszy stan aprowizacji dla danego zasobu eksperymentu. |
query |
Model reprezentujący selektor zapytań. |
resource |
Tożsamość zasobu. |
Resource |
Ciąg typu tożsamości zasobu. |
simple |
Model reprezentujący prosty filtr docelowy. |
simple |
Model reprezentujący proste parametry filtru. |
step |
Model reprezentujący krok w zasobie Eksperyment. |
system |
Metadane dotyczące tworzenia i ostatniej modyfikacji zasobu. |
target |
Model reprezentujący odwołanie do elementu docelowego w selektorze. |
Target |
Wyliczenie typu odwołania docelowego. |
User |
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 |
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 |
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 |
Dodatkowe informacje o błędzie. |
|
code |
string |
Kod błędu. |
details |
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 |
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 |
Tożsamość zasobu eksperymentu. |
|
location |
string |
Lokalizacja geograficzna, w której znajduje się zasób |
name |
string |
Nazwa zasobu |
properties.provisioningState |
Najnowszy stan aprowizacji dla danego zasobu eksperymentu. |
|
properties.selectors | selector[]: |
Lista selektorów. |
properties.steps |
step[] |
Lista kroków. |
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: |
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 |
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: |
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 |
Ciąg typu tożsamości zasobu. |
|
userAssignedIdentities |
<string,
User |
tożsamości User-Assigned |
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 |
Model reprezentujący proste parametry filtru. |
|
type |
string:
Simple |
Wyliczenie, które rozróżnia typy filtrów. Obecnie obsługiwany jest tylko |
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 |
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 |
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 |
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. |