Automation Account - Create Or Update

Serviço:: Automation

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

Criar ou atualizar a conta de automação.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
automationAccountName	path	True	string	O nome da conta de automação.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Nome de um grupo de recursos do Azure.
subscriptionId	path	True	string	Obtém credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.
api-version	query	True	string	Versão da API do cliente.

Corpo da solicitação

Nome	Tipo	Description
identity	Identity	Define a propriedade de identidade para a conta de automação
location	string	Obtém ou define o local do recurso.
name	string	Obtém ou define o nome do recurso.
properties.disableLocalAuth	boolean	Indica se as solicitações que usam autenticação não AAD estão bloqueadas
properties.encryption	EncryptionProperties	Definir as propriedades de criptografia para a conta de automação
properties.publicNetworkAccess	boolean	Indica se o tráfego no ponto de extremidade não ARM (Webhook/Agent) é permitido na Internet pública
properties.sku	Sku	Obtém ou define o SKU da conta.
tags	object	Obtém ou define as marcas anexadas ao recurso.

Respostas

Nome	Tipo	Description
200 OK	AutomationAccount	OKEY
201 Created	AutomationAccount	Criado
Other Status Codes	ErrorResponse	Resposta de erro de automação descrevendo por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Create or update automation account

Solicitação de exemplo

HTTP

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

{
  "properties": {
    "sku": {
      "name": "Free"
    }
  },
  "name": "myAutomationAccount9",
  "location": "East US 2"
}

Resposta de exemplo

Código de status:: 201

{
  "name": "myAutomationAccount9",
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount9",
  "type": "Microsoft.Automation/AutomationAccounts",
  "location": "East US 2",
  "tags": {},
  "properties": {
    "sku": {
      "name": "Free"
    },
    "state": "Ok",
    "creationTime": "2017-03-26T01:13:43.267+00:00",
    "lastModifiedBy": "myEmailId@microsoft.com",
    "lastModifiedTime": "2017-03-26T01:13:43.267+00:00"
  }
}

Código de status:: 200

{
  "name": "ContoseAutomationAccount",
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/myAutomationAccount9",
  "type": "Microsoft.Automation/AutomationAccounts",
  "location": "East US 2",
  "tags": {},
  "properties": {
    "sku": {
      "name": "Free"
    },
    "state": "Ok",
    "creationTime": "2017-03-28T18:21:15.187+00:00",
    "lastModifiedBy": "myEmaild@microsoft.com",
    "lastModifiedTime": "2017-03-28T18:21:15.187+00:00"
  }
}

Definições

Nome	Description
AutomationAccount	Definição do tipo de conta de automação.
AutomationAccountCreateOrUpdateParameters	Os parâmetros fornecidos para a operação criar ou atualizar a conta de automação.
AutomationAccountState	Obtém o status da conta.
createdByType	O tipo de identidade que criou o recurso.
EncryptionKeySourceType	Origem da chave de criptografia
EncryptionProperties	As configurações de criptografia para a conta de automação
ErrorResponse	Resposta de erro de uma falha de operação
Identity	Identidade do recurso.
KeyVaultProperties	Configurações relativas à criptografia do cofre de chaves para um repositório de configuração.
PrivateEndpointConnection	Uma conexão de ponto de extremidade privado
PrivateEndpointProperty	Ponto de extremidade privado ao qual a conexão pertence.
PrivateLinkServiceConnectionStateProperty	Estado de conexão da conexão de ponto de extremidade privado.
ResourceIdentityType	O tipo de identidade.
Sku	O SKU da conta.
SkuNameEnum	Obtém ou define o nome da SKU da conta.
systemData	Metadados relativos à criação e última modificação do recurso.
UserAssignedIdentitiesProperties

AutomationAccount

Objeto

Definição do tipo de conta de automação.

Nome	Tipo	Description
etag	string	Obtém ou define a etag do recurso.
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
identity	Identity	Identidade do recurso.
location	string	A localização geográfica onde o recurso reside
name	string	O nome do recurso
properties.automationHybridServiceUrl	string	URL do serviço híbrido de automação que é usado para o in-boarding do Hybrid Worker.
properties.creationTime	string (date-time)	Obtém o tempo de criação.
properties.description	string	Obtém ou define a descrição.
properties.disableLocalAuth	boolean	Indica se as solicitações que usam autenticação não AAD estão bloqueadas
properties.encryption	EncryptionProperties	Propriedades de criptografia para a conta de automação
properties.lastModifiedBy	string	Obtém ou define a última modificação.
properties.lastModifiedTime	string (date-time)	Obtém a hora da última modificação.
properties.privateEndpointConnections	PrivateEndpointConnection[]	Lista de operações de Automação com suporte do provedor de recursos de Automação.
properties.publicNetworkAccess	boolean	Indica se o tráfego no ponto de extremidade não ARM (Webhook/Agent) é permitido na Internet pública
properties.sku	Sku	Obtém ou define o SKU da conta.
properties.state	AutomationAccountState	Obtém o status da conta.
systemData	systemData	Metadados do sistema de recursos.
tags	object	Marcas de recurso.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

AutomationAccountCreateOrUpdateParameters

Objeto

Os parâmetros fornecidos para a operação criar ou atualizar a conta de automação.

Nome	Tipo	Description
identity	Identity	Define a propriedade de identidade para a conta de automação
location	string	Obtém ou define o local do recurso.
name	string	Obtém ou define o nome do recurso.
properties.disableLocalAuth	boolean	Indica se as solicitações que usam autenticação não AAD estão bloqueadas
properties.encryption	EncryptionProperties	Definir as propriedades de criptografia para a conta de automação
properties.publicNetworkAccess	boolean	Indica se o tráfego no ponto de extremidade não ARM (Webhook/Agent) é permitido na Internet pública
properties.sku	Sku	Obtém ou define o SKU da conta.
tags	object	Obtém ou define as marcas anexadas ao recurso.

AutomationAccountState

Enumeração

Obtém o status da conta.

Valor	Description
Ok
Suspended
Unavailable

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

EncryptionKeySourceType

Enumeração

Origem da chave de criptografia

Valor	Description
Microsoft.Automation
Microsoft.Keyvault

EncryptionProperties

Objeto

As configurações de criptografia para a conta de automação

Nome	Tipo	Description
identity	Identity	Identidade do usuário usada para CMK.
keySource	EncryptionKeySourceType	Origem da chave de criptografia
keyVaultProperties	KeyVaultProperties	Propriedades do cofre de chaves.

ErrorResponse

Objeto

Resposta de erro de uma falha de operação

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

Identity

Objeto

Identidade do recurso.

Nome	Tipo	Description
principalId	string	A ID principal da identidade do recurso. O valor deve ser uma UUID.
tenantId	string	A ID do locatário do recurso.
type	ResourceIdentityType	O tipo de identidade.
userAssignedIdentities	<string, UserAssignedIdentitiesProperties>	A lista de identidades de usuário associadas ao recurso. As referências de chave do dicionário de identidade do usuário serão IDs de recurso do ARM no formulário: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}'.

KeyVaultProperties

Objeto

Configurações relativas à criptografia do cofre de chaves para um repositório de configuração.

Nome	Tipo	Description
keyName	string	O nome da chave usada para criptografar dados.
keyVersion	string	A versão chave da chave usada para criptografar dados.
keyvaultUri	string	O URI da chave do cofre de chaves usada para criptografar dados.

PrivateEndpointConnection

Objeto

Uma conexão de ponto de extremidade privado

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.groupIds	string[]	Obtém as groupIds.
properties.privateEndpoint	PrivateEndpointProperty	Ponto de extremidade privado ao qual a conexão pertence.
properties.privateLinkServiceConnectionState	PrivateLinkServiceConnectionStateProperty	Estado de conexão da conexão de ponto de extremidade privado.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

PrivateEndpointProperty

Objeto

Ponto de extremidade privado ao qual a conexão pertence.

Nome	Tipo	Description
id	string	ID do recurso do ponto de extremidade privado.

PrivateLinkServiceConnectionStateProperty

Objeto

Estado de conexão da conexão de ponto de extremidade privado.

Nome	Tipo	Description
actionsRequired	string	Qualquer ação necessária além do fluxo de trabalho básico (aprovar/rejeitar/desconectar)
description	string	A descrição da conexão do serviço de link privado.
status	string	O status da conexão do serviço de link privado.

ResourceIdentityType

Enumeração

O tipo de identidade.

Valor	Description
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

Sku

Objeto

O SKU da conta.

Nome	Tipo	Description
capacity	integer (int32)	Obtém ou define a capacidade de SKU.
family	string	Obtém ou define a família SKU.
name	SkuNameEnum	Obtém ou define o nome da SKU da conta.

SkuNameEnum

Enumeração

Obtém ou define o nome da SKU da conta.

Valor	Description
Basic
Free

systemData

Objeto

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

Nome	Tipo	Description
createdAt	string (date-time)	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 (date-time)	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.

UserAssignedIdentitiesProperties

Objeto

Nome	Tipo	Description
clientId	string	A ID do cliente da identidade atribuída pelo usuário.
principalId	string	A ID principal da identidade atribuída pelo usuário.

Compartilhar via

Automation Account - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Create or update automation account

Solicitação de exemplo

Resposta de exemplo

Definições

AutomationAccount

AutomationAccountCreateOrUpdateParameters

AutomationAccountState

createdByType

EncryptionKeySourceType

EncryptionProperties

ErrorResponse

Identity

KeyVaultProperties

PrivateEndpointConnection

PrivateEndpointProperty

PrivateLinkServiceConnectionStateProperty

ResourceIdentityType

Sku

SkuNameEnum

systemData

UserAssignedIdentitiesProperties