Runtime Environments - Create

Referência

Serviço:: Automation

Versão da API:: 2023-05-15-preview

Criar ou atualizar o Ambiente de Runtime

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/runtimeEnvironments/{runtimeEnvironmentName}?api-version=2023-05-15-preview

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
automationAccountName	path	True	string	O nome da conta de automatização.
resourceGroupName	path	True	string	Nome de um grupo de Recursos do Azure. Padrão Regex: `^[-\w\._]+$`
runtimeEnvironmentName	path	True	string	O nome do Ambiente de Runtime. Padrão Regex: `^[a-zA-Z][a-zA-Z-_0-9]*$`
subscriptionId	path	True	string	Obtém credenciais de subscrição que identificam exclusivamente a subscrição do Microsoft Azure. O ID da subscrição faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API de Cliente.

Corpo do Pedido

Name	Necessário	Tipo	Description
location	True	string	A localização geográfica onde o recurso se encontra
properties.defaultPackages		object	Lista de pacotes predefinidos para o Ambiente
properties.description		string	Obtém ou define a descrição.
properties.runtime.language		string	Idioma do Ambiente de Runtime
properties.runtime.version		string	Versão do Idioma
tags		object	Etiquetas de recursos.

Respostas

Name	Tipo	Description
200 OK	RuntimeEnvironment	Atualizado
201 Created	RuntimeEnvironment	Criado
Other Status Codes	ErrorResponse	Resposta de erro de automatização que descreve o motivo pela qual a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	representar a sua conta de utilizador

Exemplos

Create or update automation account

Pedido de amostra

HTTP

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount9/runtimeEnvironments/myRuntimeEnvironmentName?api-version=2023-05-15-preview

{
  "properties": {
    "runtime": {
      "language": "PowerShell",
      "version": "7.1"
    },
    "defaultPackages": {
      "Az": "8.3.0"
    }
  },
  "location": "East US 2"
}

Resposta da amostra

Código de estado:: 201

{
  "name": "myRuntimeEnvironmentName",
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount9/runtimeEnvironments/myRuntimeEnvironmentName",
  "type": "Microsoft.Automation/automationAccounts/runtimeEnvironments",
  "location": "East US 2",
  "tags": {},
  "systemData": {
    "createdAt": "2023-07-05T07:32:41.4389914+00:00",
    "lastModifiedAt": "2023-07-05T07:33:07.5597465+00:00"
  },
  "properties": {
    "runtime": {
      "language": "PowerShell",
      "version": "7.1"
    },
    "defaultPackages": {
      "Az": "8.3.0"
    }
  }
}

Código de estado:: 200

{
  "name": "myRuntimeEnvironmentName",
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount9/runtimeEnvironments/myRuntimeEnvironmentName",
  "type": "Microsoft.Automation/automationAccounts/runtimeEnvironments",
  "location": "East US 2",
  "tags": {},
  "systemData": {
    "createdAt": "2023-07-05T07:32:41.4389914+00:00",
    "lastModifiedAt": "2023-07-05T07:33:07.5597465+00:00"
  },
  "properties": {
    "runtime": {
      "language": "PowerShell",
      "version": "7.1"
    },
    "defaultPackages": {
      "Az": "8.3.0"
    }
  }
}

Definições

Name	Description
createdByType	O tipo de identidade que criou o recurso.
ErrorResponse	Resposta de erro de uma falha de operação
RuntimeEnvironment	Definição do tipo de Ambiente de Runtime.
systemData	Metadados relativos à criação e última modificação do recurso.

createdByType

O tipo de identidade que criou o recurso.

Name	Tipo	Description
Application	string
Key	string
ManagedIdentity	string
User	string

ErrorResponse

Resposta de erro de uma falha de operação

Name	Tipo	Description
code	string	Código de erro
message	string	Mensagem de erro a indicar por que motivo a operação falhou.

RuntimeEnvironment

Definição do tipo de Ambiente de Runtime.

Name	Tipo	Description
id	string	ID de recurso completamente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
location	string	A localização geográfica onde o recurso se encontra
name	string	O nome do recurso
properties.defaultPackages	object	Lista de pacotes predefinidos para o Ambiente
properties.description	string	Obtém ou define a descrição.
properties.runtime.language	string	Idioma do Ambiente de Runtime
properties.runtime.version	string	Versão do Idioma
systemData	systemData	Metadados do sistema de recursos.
tags	object	Etiquetas de recursos.
type	string	O tipo de recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

systemData

Metadados relativos à criação e última modificação do recurso.

Name	Tipo	Description
createdAt	string	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Partilhar via