Partilhar via

Job - Create

Serviço:
Automation
Versão da API:
2024-10-23

Crie um trabalho do runbook.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Automation/automationAccounts/{automationAccountName}/jobs/{jobName}?api-version=2024-10-23

Parâmetros do URI

Name Em Necessário Tipo Description
automationAccountName
 path True

string

O nome da conta de automação.
jobName
 path True

string

O nome do trabalho.
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. O ID da assinatura faz parte do URI de cada chamada de serviço.
api-version
 query True

string

Versão da API do cliente.

Cabeçalho do Pedido

Name Necessário Tipo Description
clientRequestId

string

Identifica essa solicitação específica do cliente.

Corpo do Pedido

Name Tipo Description
properties.parameters

object

Obtém ou define os parâmetros do trabalho.
properties.runOn

string

Obtém ou define o runOn que especifica o nome do grupo onde o trabalho deve ser executado.
properties.runbook

RunbookAssociationProperty

Obtém ou define o runbook.

Respostas

Name Tipo Description
201 Created

Job

Criado
Other Status Codes

ErrorResponse

Resposta de erro de automação descrevendo por que a operação falhou.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Âmbitos

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Create job

Pedido de amostra

PUT https://management.azure.com/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/jobs/foo?api-version=2024-10-23

{
  "properties": {
    "runbook": {
      "name": "TestRunbook"
    },
    "parameters": {
      "key01": "value01",
      "key02": "value02"
    },
    "runOn": ""
  }
}

Resposta da amostra

Código de estado:
201 
{
  "id": "/subscriptions/51766542-3ed7-4a72-a187-0c8ab644ddab/resourceGroups/mygroup/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/jobs/jobName",
  "name": "foo",
  "type": "Microsoft.Automation/AutomationAccounts/Jobs",
  "properties": {
    "jobId": "5b8a3960-e8ab-45f6-bec6-567df8467d1a",
    "runbook": {
      "name": "TestRunbook"
    },
    "provisioningState": "Processing",
    "creationTime": "2018-02-01T05:53:30.243+00:00",
    "endTime": null,
    "exception": null,
    "lastModifiedTime": "2018-02-01T05:53:30.243+00:00",
    "lastStatusModifiedTime": "2018-02-01T05:53:30.243+00:00",
    "startTime": null,
    "status": "New",
    "statusDetails": "None",
    "parameters": {
      "tag01": "value01",
      "tag02": "value02"
    },
    "runOn": "",
    "jobRuntimeEnvironment": {
      "runtimeEnvironmentName": "environmentName"
    }
  }
}

Definições

Name Description
createdByType

O tipo de identidade que criou o recurso.
ErrorResponse

Resposta de erro de uma falha de operação
Job

Definição do trabalho.
JobCreateParameters

Os parâmetros fornecidos para a operação de criação de trabalho.
JobProvisioningState

O estado atual de provisionamento do trabalho.
JobRuntimeEnvironment

A propriedade runbook associada à entidade.
JobStatus

Obtém ou define o status do trabalho.
RunbookAssociationProperty

A propriedade runbook associada à entidade.
systemData

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

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor Description
User
Application
ManagedIdentity
Key

ErrorResponse

Object

Resposta de erro de uma falha de operação

Name Tipo Description
code

string

Código de erro
message

string

Mensagem de erro indicando por que a operação falhou.

Job

Object

Definição do trabalho.

Name Tipo Description
id

string (arm-id)

ID de recurso totalmente qualificado para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name

string

O nome do recurso
properties.creationTime

string (date-time)

Obtém ou define o tempo de criação do trabalho.
properties.endTime

string (date-time)

Obtém ou define a hora de término do trabalho.
properties.exception

string

Obtém ou define a exceção do trabalho.
properties.jobId

string (uuid)

Obtém ou define a id do trabalho.
properties.jobRuntimeEnvironment

JobRuntimeEnvironment

Propriedade Runtime Environment
properties.lastModifiedTime

string (date-time)

Obtém ou define a hora da última modificação do trabalho.
properties.lastStatusModifiedTime

string (date-time)

Obtém ou define a última hora modificada de status do trabalho.
properties.parameters

object

Obtém ou define os parâmetros do trabalho.
properties.provisioningState

JobProvisioningState

O estado atual de provisionamento do trabalho.
properties.runOn

string

Obtém ou define o runOn que especifica o nome do grupo onde o trabalho deve ser executado.
properties.runbook

RunbookAssociationProperty

Obtém ou define o runbook.
properties.startTime

string (date-time)

Obtém ou define a hora de início do trabalho.
properties.startedBy

string

Obtém ou define o trabalho iniciado por.
properties.status

JobStatus

Obtém ou define o status do trabalho.
properties.statusDetails

string

Obtém ou define os detalhes de status do trabalho.
systemData

systemData

Metadados do Azure Resource Manager contendo informações createdBy e modifiedBy.
type

string

O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

JobCreateParameters

Object

Os parâmetros fornecidos para a operação de criação de trabalho.

Name Tipo Description
properties.parameters

object

Obtém ou define os parâmetros do trabalho.
properties.runOn

string

Obtém ou define o runOn que especifica o nome do grupo onde o trabalho deve ser executado.
properties.runbook

RunbookAssociationProperty

Obtém ou define o runbook.

JobProvisioningState

Enumeração

O estado atual de provisionamento do trabalho.

Valor Description
Failed
Succeeded
Suspended
Processing

JobRuntimeEnvironment

Object

A propriedade runbook associada à entidade.

Name Tipo Description
runtimeEnvironmentName

string

Nome do ambiente de tempo de execução.

JobStatus

Enumeração

Obtém ou define o status do trabalho.

Valor Description
New
Activating
Running
Completed
Failed
Stopped
Blocked
Suspended
Disconnected
Suspending
Stopping
Resuming
Removing

RunbookAssociationProperty

Object

A propriedade runbook associada à entidade.

Name Tipo Description
name

string

Obtém ou define o nome do runbook.

systemData

Object

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

Name 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.