Dsc Node Configuration - Create Or Update

Referencia

Service:: Automation

API Version:: 2023-11-01

Cree la configuración del nodo identificada por el nombre de configuración del nodo.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/nodeConfigurations/{nodeConfigurationName}?api-version=2023-11-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
automationAccountName	path	True	string	Nombre de la cuenta de Automation.
nodeConfigurationName	path	True	string	Nombre de configuración del nodo Dsc.
resourceGroupName	path	True	string	Nombre de un grupo de recursos de Azure. Regex pattern: `^[-\w\._]+$`
subscriptionId	path	True	string	Obtiene las credenciales de suscripción que identifican a la suscripción de Microsoft Azure de forma única. El identificador de suscripción forma parte del URI para cada llamada al servicio.
api-version	query	True	string	Versión de api de cliente.

Cuerpo de la solicitud

Nombre	Requerido	Tipo	Description
properties.configuration	True	DscConfigurationAssociationProperty	Obtiene o establece la configuración del nodo.
properties.source	True	ContentSource	Obtiene o establece el origen.
name		string	Nombre de la configuración del nodo.
properties.incrementNodeConfigurationBuild		boolean	Si se requiere una nueva versión de compilación de NodeConfiguration.
tags		object	Obtiene o establece las etiquetas adjuntas al recurso.

Respuestas

Nombre	Tipo	Description
200 OK		Aceptar
201 Created	DscNodeConfiguration	Creado
Other Status Codes	ErrorResponse	Respuesta de error de Automatización que describe por qué se produjo un error en la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

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

Scopes

Nombre	Description
user_impersonation	suplantación de su cuenta de usuario

Ejemplos

Create node configuration

Sample Request

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount20/nodeConfigurations/configName.nodeConfigName?api-version=2023-11-01

{
  "name": "configName.nodeConfigName",
  "properties": {
    "source": {
      "hash": {
        "algorithm": "sha256",
        "value": "6DE256A57F01BFA29B88696D5E77A383D6E61484C7686E8DB955FA10ACE9FFE5"
      },
      "type": "embeddedContent",
      "value": "\r\ninstance of MSFT_RoleResource as $MSFT_RoleResource1ref\r\n{\r\nResourceID = \"[WindowsFeature]IIS\";\r\n Ensure = \"Present\";\r\n SourceInfo = \"::3::32::WindowsFeature\";\r\n Name = \"Web-Server\";\r\n ModuleName = \"PsDesiredStateConfiguration\";\r\n\r\nModuleVersion = \"1.0\";\r\r\n ConfigurationName = \"configName\";\r\r\n};\r\ninstance of OMI_ConfigurationDocument\r\n\r\r\n                    {\r\n Version=\"2.0.0\";\r\n \r\r\n                        MinimumCompatibleVersion = \"1.0.0\";\r\n \r\r\n                        CompatibleVersionAdditionalProperties= {\"Omi_BaseResource:ConfigurationName\"};\r\n \r\r\n                        Author=\"weijiel\";\r\n \r\r\n                        GenerationDate=\"03/30/2017 13:40:25\";\r\n \r\r\n                        GenerationHost=\"TEST-BACKEND\";\r\n \r\r\n                        Name=\"configName\";\r\n\r\r\n                    };\r\n",
      "version": "1.0"
    },
    "incrementNodeConfigurationBuild": true,
    "configuration": {
      "name": "configName"
    }
  }
}

Sample Response

Status code:: 200

Status code:: 201

{
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount20/nodeConfigurations/configName.nodeConfigName",
  "name": "configName.nodeConfigName",
  "type": "Microsoft.Automation/AutomationAccounts/nodeConfigurations",
  "properties": {
    "lastModifiedTime": "2018-03-25T01:29:17.1205764+00:00",
    "creationTime": "2018-03-25T01:29:17.1205764+00:00",
    "configuration": {
      "name": "configName"
    },
    "source": null,
    "nodeCount": 0,
    "incrementNodeConfigurationBuild": false
  }
}

Definiciones

Nombre	Description
ContentHash	Definición del tipo de propiedad runbook.
ContentSource	Definición del origen de contenido.
ContentSourceType	Obtiene o establece el tipo de origen de contenido.
DscConfigurationAssociationProperty	Propiedad de configuración de Dsc asociada a la entidad .
DscNodeConfiguration	Definición de la configuración del nodo dsc.
DscNodeConfigurationCreateOrUpdateParameters	Parámetros proporcionados a la operación de configuración de creación o actualización del nodo.
ErrorResponse	Respuesta de error de un error de operación

ContentHash

Definición del tipo de propiedad runbook.

Nombre	Tipo	Description
algorithm	string	Obtiene o establece el algoritmo hash de contenido utilizado para aplicar un algoritmo hash al contenido.
value	string	Obtiene o establece el valor hash esperado del contenido.

ContentSource

Definición del origen de contenido.

Nombre	Tipo	Description
hash	ContentHash	Obtiene o establece el hash.
type	ContentSourceType	Obtiene o establece el tipo de origen de contenido.
value	string	Obtiene o establece el valor del contenido. Esto se basa en el tipo de origen de contenido.
version	string	Obtiene o establece la versión del contenido.

ContentSourceType

Obtiene o establece el tipo de origen de contenido.

Nombre	Tipo	Description
embeddedContent	string
uri	string

DscConfigurationAssociationProperty

Propiedad de configuración de Dsc asociada a la entidad .

Nombre	Tipo	Description
name	string	Obtiene o establece el nombre de la configuración de Dsc.

DscNodeConfiguration

Definición de la configuración del nodo dsc.

Nombre	Tipo	Description
id	string	Identificador de recurso completo para el recurso
name	string	Nombre del recurso.
properties.configuration	DscConfigurationAssociationProperty	Obtiene o establece la configuración del nodo.
properties.creationTime	string	Obtiene o establece la hora de creación.
properties.incrementNodeConfigurationBuild	boolean	Si se requiere una nueva versión de compilación de NodeConfiguration.
properties.lastModifiedTime	string	Obtiene o establece la hora de la última modificación.
properties.nodeCount	integer	Número de nodos con esta configuración de nodo asignada
properties.source	string	Origen de la configuración del nodo.
type	string	Tipo de recurso.

DscNodeConfigurationCreateOrUpdateParameters

Parámetros proporcionados a la operación de configuración de creación o actualización del nodo.

Nombre	Tipo	Description
name	string	Nombre de la configuración del nodo.
properties.configuration	DscConfigurationAssociationProperty	Obtiene o establece la configuración del nodo.
properties.incrementNodeConfigurationBuild	boolean	Si se requiere una nueva versión de compilación de NodeConfiguration.
properties.source	ContentSource	Obtiene o establece el origen.
tags	object	Obtiene o establece las etiquetas adjuntas al recurso.

ErrorResponse

Respuesta de error de un error de operación

Nombre	Tipo	Description
code	string	Código de error
message	string	Mensaje de error que indica por qué se produjo un error en la operación.

Compartir a través de