Experiments - Create Or Update
Cree o actualice un 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 identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
experiment
|
path | True |
string |
Cadena que representa un nombre de recurso de experimento. Patrón de Regex: |
resource
|
path | True |
string |
Cadena que representa un grupo de recursos de Azure. Patrón de Regex: |
subscription
|
path | True |
string |
GUID que representa un identificador de suscripción de Azure. Patrón de Regex: |
api-version
|
query | True |
string |
Cadena que establece la versión de la API. Patrón de Regex: |
Cuerpo de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
location | True |
string |
Ubicación geográfica donde reside el recurso |
properties.selectors | True | selector[]: |
Lista de selectores. |
properties.steps | True |
step[] |
Lista de pasos. |
identity |
Identidad del recurso del experimento. |
||
tags |
object |
Etiquetas del recurso. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Operación de reemplazo de experimento de larga duración. |
|
201 Created |
Operación de creación de experimentos de larga duración. |
|
Other Status Codes |
Respuesta de error devuelta si la solicitud no se realizó correctamente. |
Seguridad
azure_auth
Flujo OAuth2 de Azure Active Directory
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
user_impersonation | Suplantación de su cuenta de usuario |
Ejemplos
Create/update a Experiment in a resource group.
Solicitud de ejemplo
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"
}
]
}
]
}
}
Respuesta de muestra
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"
}
}
Definiciones
Nombre | Description |
---|---|
branch |
Modelo que representa una rama en el paso. 9 total por experimento. |
continuous |
Modelo que representa una acción continua. |
created |
Tipo de identidad que creó el recurso. |
delay |
Modelo que representa una acción de retraso. |
discrete |
Modelo que representa una acción discreta. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
experiment |
Modelo que representa un recurso de experimento. |
key |
Mapa para describir la configuración de una acción. |
list |
Modelo que representa un selector de lista. |
Provisioning |
Estado de aprovisionamiento más reciente para el recurso de experimento especificado. |
query |
Modelo que representa un selector de consultas. |
resource |
Identidad de un recurso. |
Resource |
Cadena del tipo de identidad del recurso. |
simple |
Modelo que representa un filtro de destino simple. |
simple |
Modelo que representa los parámetros de filtro simple. |
step |
Modelo que representa un paso en el recurso Experimento. |
system |
Metadatos relacionados con la creación y la última modificación del recurso. |
target |
Modelo que representa una referencia a un destino en el selector. |
Target |
Enumeración del tipo de referencia target. |
User |
Propiedades de identidad asignadas por el usuario |
branch
Modelo que representa una rama en el paso. 9 total por experimento.
Nombre | Tipo | Description |
---|---|---|
actions | action[]: |
Lista de acciones. |
name |
string |
Cadena del nombre de la rama. |
continuousAction
Modelo que representa una acción continua.
Nombre | Tipo | Description |
---|---|---|
duration |
string |
ISO8601 cadena con formato que representa una duración. |
name |
string |
Cadena que representa un URN de funcionalidad. |
parameters |
Lista de pares clave-valor. |
|
selectorId |
string |
Cadena que representa un selector. |
type |
string:
continuous |
Enumeración que discrimina entre los modelos de acción. |
createdByType
Tipo de identidad que creó el recurso.
Nombre | Tipo | Description |
---|---|---|
Application |
string |
|
Key |
string |
|
ManagedIdentity |
string |
|
User |
string |
delayAction
Modelo que representa una acción de retraso.
Nombre | Tipo | Description |
---|---|---|
duration |
string |
ISO8601 cadena con formato que representa una duración. |
name |
string |
Cadena que representa un URN de funcionalidad. |
type |
string:
delay |
Enumeración que discrimina entre los modelos de acción. |
discreteAction
Modelo que representa una acción discreta.
Nombre | Tipo | Description |
---|---|---|
name |
string |
Cadena que representa un URN de funcionalidad. |
parameters |
Lista de pares clave-valor. |
|
selectorId |
string |
Cadena que representa un selector. |
type |
string:
discrete |
Enumeración que discrimina entre los modelos de acción. |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
experiment
Modelo que representa un recurso de experimento.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Identificador de recurso completo del recurso. Por ejemplo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
Identidad del recurso del experimento. |
|
location |
string |
Ubicación geográfica donde reside el recurso |
name |
string |
Nombre del recurso. |
properties.provisioningState |
Estado de aprovisionamiento más reciente para el recurso de experimento especificado. |
|
properties.selectors | selector[]: |
Lista de selectores. |
properties.steps |
step[] |
Lista de pasos. |
systemData |
Metadatos del sistema del recurso del experimento. |
|
tags |
object |
Etiquetas del recurso. |
type |
string |
Tipo de recurso. Por ejemplo, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
keyValuePair
Mapa para describir la configuración de una acción.
Nombre | Tipo | Description |
---|---|---|
key |
string |
Nombre de la configuración de la acción. |
value |
string |
Valor de la configuración de la acción. |
listSelector
Modelo que representa un selector de lista.
Nombre | Tipo | Description |
---|---|---|
filter | filter: |
Modelo que representa los tipos de filtro disponibles que se pueden aplicar a una lista de destinos. |
id |
string |
Cadena del identificador del selector. |
targets |
Lista de referencias de destino. |
|
type |
string:
List |
Enumeración del tipo de selector. |
ProvisioningState
Estado de aprovisionamiento más reciente para el recurso de experimento especificado.
Nombre | Tipo | Description |
---|---|---|
Canceled |
string |
|
Creating |
string |
|
Deleting |
string |
|
Failed |
string |
|
Succeeded |
string |
|
Updating |
string |
querySelector
Modelo que representa un selector de consultas.
Nombre | Tipo | Description |
---|---|---|
filter | filter: |
Modelo que representa los tipos de filtro disponibles que se pueden aplicar a una lista de destinos. |
id |
string |
Cadena del identificador del selector. |
queryString |
string |
Consulta del lenguaje de consulta de Azure Resource Graph (ARG) para los recursos de destino. |
subscriptionIds |
string[] |
Lista de identificadores de suscripción para definir el ámbito de la consulta de recursos. |
type |
string:
Query |
Enumeración del tipo de selector. |
resourceIdentity
Identidad de un recurso.
Nombre | Tipo | Description |
---|---|---|
principalId |
string |
GUID que representa el identificador de entidad de seguridad de esta identidad de recurso. |
tenantId |
string |
GUID que representa el identificador de inquilino de esta identidad de recurso. |
type |
Cadena del tipo de identidad del recurso. |
|
userAssignedIdentities |
<string,
User |
identidades de User-Assigned |
ResourceIdentityType
Cadena del tipo de identidad del recurso.
Nombre | Tipo | Description |
---|---|---|
None |
string |
|
SystemAssigned |
string |
|
UserAssigned |
string |
simpleFilter
Modelo que representa un filtro de destino simple.
Nombre | Tipo | Description |
---|---|---|
parameters |
Modelo que representa los parámetros de filtro simple. |
|
type |
string:
Simple |
Enumeración que discrimina entre tipos de filtro. Actualmente solo |
simpleFilterParameters
Modelo que representa los parámetros de filtro simple.
Nombre | Tipo | Description |
---|---|---|
zones |
string[] |
Lista de zonas de disponibilidad de Azure por las que se van a filtrar los destinos. |
step
Modelo que representa un paso en el recurso Experimento.
Nombre | Tipo | Description |
---|---|---|
branches |
branch[] |
Lista de ramas. |
name |
string |
Cadena del nombre del paso. |
systemData
Metadatos relacionados con la creación y la última modificación del recurso.
Nombre | Tipo | Description |
---|---|---|
createdAt |
string |
Marca de tiempo de creación de recursos (UTC). |
createdBy |
string |
Identidad que creó el recurso. |
createdByType |
Tipo de identidad que creó el recurso. |
|
lastModifiedAt |
string |
Marca de tiempo de la última modificación del recurso (UTC) |
lastModifiedBy |
string |
Identidad que modificó por última vez el recurso. |
lastModifiedByType |
Tipo de identidad que modificó por última vez el recurso. |
targetReference
Modelo que representa una referencia a un destino en el selector.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Cadena del identificador de recurso de un recurso de destino. |
type |
Enumeración del tipo de referencia target. |
TargetReferenceType
Enumeración del tipo de referencia target.
Nombre | Tipo | Description |
---|---|---|
ChaosTarget |
string |
UserAssignedIdentity
Propiedades de identidad asignadas por el usuario
Nombre | Tipo | Description |
---|---|---|
clientId |
string |
Identificador de cliente de la identidad asignada. |
principalId |
string |
Identificador de entidad de seguridad de la identidad asignada. |