Bagikan melalui


Experiments - Create Or Update

Membuat atau memperbarui sumber daya Eksperimen.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
experimentName
path True

string

String yang mewakili nama sumber daya Eksperimen.

Regex pattern: ^[^<>%&:?#/\\]+$

resourceGroupName
path True

string

String yang mewakili grup sumber daya Azure.

Regex pattern: ^[a-zA-Z0-9_\-\.\(\)]*[a-zA-Z0-9_\-\(\)]$

subscriptionId
path True

string

GUID yang mewakili ID langganan Azure.

Regex pattern: ^[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

String yang mengatur versi API.

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

Isi Permintaan

Nama Diperlukan Jenis Deskripsi
location True

string

Lokasi geografis tempat sumber daya berada

properties.selectors True selector[]:

Daftar pemilih.

properties.steps True

step[]

Daftar langkah.

identity

resourceIdentity

Identitas sumber daya eksperimen.

tags

object

Tag sumber daya.

Respons

Nama Jenis Deskripsi
200 OK

experiment

Operasi eksperimen penggantian yang berjalan lama.

201 Created

experiment

Operasi buat eksperimen yang berjalan lama.

Other Status Codes

ErrorResponse

Respons kesalahan dikembalikan jika permintaan tidak berhasil.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama Deskripsi
user_impersonation Meniru akun pengguna Anda

Contoh

Create/update a Experiment in a resource group.

Sample Request

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

Sample Response

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

Definisi

Nama Deskripsi
branch

Model yang mewakili cabang dalam langkah. Total 9 per eksperimen.

continuousAction

Model yang mewakili tindakan berkelanjutan.

createdByType

Jenis identitas yang membuat sumber daya.

delayAction

Model yang mewakili tindakan penundaan.

discreteAction

Model yang mewakili tindakan diskrit.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

ErrorDetail

Detail kesalahan.

ErrorResponse

Respons kesalahan

experiment

Model yang mewakili sumber daya Eksperimen.

keyValuePair

Peta untuk menjelaskan pengaturan tindakan.

listSelector

Model yang mewakili pemilih daftar.

ProvisioningState

Status penyediaan terbaru untuk sumber daya eksperimen yang diberikan.

querySelector

Model yang mewakili pemilih kueri.

resourceIdentity

Identitas sumber daya.

ResourceIdentityType

String jenis identitas sumber daya.

simpleFilter

Model yang mewakili filter target sederhana.

simpleFilterParameters

Model yang mewakili parameter filter Sederhana.

step

Model yang mewakili langkah dalam sumber daya Eksperimen.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

targetReference

Model yang mewakili referensi ke Target di pemilih.

TargetReferenceType

Enum jenis referensi Target.

UserAssignedIdentity

Properti identitas yang ditetapkan pengguna

branch

Model yang mewakili cabang dalam langkah. Total 9 per eksperimen.

Nama Jenis Deskripsi
actions action[]:

Daftar tindakan.

name

string

String nama cabang.

continuousAction

Model yang mewakili tindakan berkelanjutan.

Nama Jenis Deskripsi
duration

string

ISO8601 string berformat yang mewakili durasi.

name

string

String yang mewakili URN Kemampuan.

parameters

keyValuePair[]

Daftar pasangan nilai kunci.

selectorId

string

String yang mewakili pemilih.

type string:

continuous

Enum yang membeda-bedakan antara model tindakan.

createdByType

Jenis identitas yang membuat sumber daya.

Nama Jenis Deskripsi
Application

string

Key

string

ManagedIdentity

string

User

string

delayAction

Model yang mewakili tindakan penundaan.

Nama Jenis Deskripsi
duration

string

ISO8601 string berformat yang mewakili durasi.

name

string

String yang mewakili URN Kemampuan.

type string:

delay

Enum yang membeda-bedakan antara model tindakan.

discreteAction

Model yang mewakili tindakan diskrit.

Nama Jenis Deskripsi
name

string

String yang mewakili URN Kemampuan.

parameters

keyValuePair[]

Daftar pasangan nilai kunci.

selectorId

string

String yang mewakili pemilih.

type string:

discrete

Enum yang membeda-bedakan antara model tindakan.

ErrorAdditionalInfo

Info tambahan kesalahan manajemen sumber daya.

Nama Jenis Deskripsi
info

object

Info tambahan.

type

string

Jenis info tambahan.

ErrorDetail

Detail kesalahan.

Nama Jenis Deskripsi
additionalInfo

ErrorAdditionalInfo[]

Info tambahan kesalahan.

code

string

Kode kesalahan.

details

ErrorDetail[]

Detail kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan.

ErrorResponse

Respons kesalahan

Nama Jenis Deskripsi
error

ErrorDetail

Objek kesalahan.

experiment

Model yang mewakili sumber daya Eksperimen.

Nama Jenis Deskripsi
id

string

ID sumber daya yang sepenuhnya memenuhi syarat untuk sumber daya. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}

identity

resourceIdentity

Identitas sumber daya eksperimen.

location

string

Lokasi geografis tempat sumber daya berada

name

string

Nama sumber daya.

properties.provisioningState

ProvisioningState

Status penyediaan terbaru untuk sumber daya eksperimen yang diberikan.

properties.selectors selector[]:

Daftar pemilih.

properties.steps

step[]

Daftar langkah.

systemData

systemData

Metadata sistem sumber daya eksperimen.

tags

object

Tag sumber daya.

type

string

Jenis sumber daya. Misalnya "Microsoft.Compute/virtualMachines" atau "Microsoft.Storage/storageAccounts"

keyValuePair

Peta untuk menjelaskan pengaturan tindakan.

Nama Jenis Deskripsi
key

string

Nama pengaturan untuk tindakan.

value

string

Nilai pengaturan untuk tindakan.

listSelector

Model yang mewakili pemilih daftar.

Nama Jenis Deskripsi
filter filter:

simpleFilter

Model yang mewakili jenis filter yang tersedia yang dapat diterapkan ke daftar target.

id

string

String ID pemilih.

targets

targetReference[]

Daftar referensi Target.

type string:

List

Enum jenis pemilih.

ProvisioningState

Status penyediaan terbaru untuk sumber daya eksperimen yang diberikan.

Nama Jenis Deskripsi
Canceled

string

Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

querySelector

Model yang mewakili pemilih kueri.

Nama Jenis Deskripsi
filter filter:

simpleFilter

Model yang mewakili jenis filter yang tersedia yang dapat diterapkan ke daftar target.

id

string

String ID pemilih.

queryString

string

Kueri Bahasa Kueri Azure Resource Graph (ARG) untuk sumber daya target.

subscriptionIds

string[]

Daftar id langganan untuk lingkup kueri sumber daya.

type string:

Query

Enum jenis pemilih.

resourceIdentity

Identitas sumber daya.

Nama Jenis Deskripsi
principalId

string

GUID yang mewakili ID utama identitas sumber daya ini.

tenantId

string

GUID yang mewakili ID penyewa identitas sumber daya ini.

type

ResourceIdentityType

String jenis identitas sumber daya.

userAssignedIdentities

<string,  UserAssignedIdentity>

identitas User-Assigned
Daftar identitas pengguna yang terkait dengan Eksperimen. Referensi kunci kamus identitas pengguna akan menjadi id sumber daya ARM dalam formulir: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

ResourceIdentityType

String jenis identitas sumber daya.

Nama Jenis Deskripsi
None

string

SystemAssigned

string

UserAssigned

string

simpleFilter

Model yang mewakili filter target sederhana.

Nama Jenis Deskripsi
parameters

simpleFilterParameters

Model yang mewakili parameter filter Sederhana.

type string:

Simple

Enum yang mendiskriminasi antara jenis filter. Saat ini hanya Simple jenis yang didukung.

simpleFilterParameters

Model yang mewakili parameter filter Sederhana.

Nama Jenis Deskripsi
zones

string[]

Daftar zona ketersediaan Azure untuk memfilter target.

step

Model yang mewakili langkah dalam sumber daya Eksperimen.

Nama Jenis Deskripsi
branches

branch[]

Daftar cabang.

name

string

String nama langkah.

systemData

Metadata yang berkaitan dengan pembuatan dan modifikasi terakhir sumber daya.

Nama Jenis Deskripsi
createdAt

string

Tanda waktu pembuatan sumber daya (UTC).

createdBy

string

Identitas yang membuat sumber daya.

createdByType

createdByType

Jenis identitas yang membuat sumber daya.

lastModifiedAt

string

Tanda waktu modifikasi terakhir sumber daya (UTC)

lastModifiedBy

string

Identitas yang terakhir mengubah sumber daya.

lastModifiedByType

createdByType

Jenis identitas yang terakhir mengubah sumber daya.

targetReference

Model yang mewakili referensi ke Target di pemilih.

Nama Jenis Deskripsi
id

string

String ID sumber daya dari sumber daya Target.

type

TargetReferenceType

Enum jenis referensi Target.

TargetReferenceType

Enum jenis referensi Target.

Nama Jenis Deskripsi
ChaosTarget

string

UserAssignedIdentity

Properti identitas yang ditetapkan pengguna

Nama Jenis Deskripsi
clientId

string

ID klien dari identitas yang ditetapkan.

principalId

string

ID utama identitas yang ditetapkan.