Runbook - Update

Služba:

Automation

Verze rozhraní API:

2023-11-01

Aktualizujte runbook identifikovaný názvem runbooku.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
automationAccountName	path	True	string	Název účtu Automation.
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Název skupiny prostředků Azure
runbookName	path	True	string pattern: ^[a-zA-Z][a-zA-Z-_0-9]*$	Název runbooku.
subscriptionId	path	True	string	Získá přihlašovací údaje předplatného, které jednoznačně identifikují předplatné Microsoft Azure. ID předplatného tvoří součást identifikátoru URI pro každé volání služby.
api-version	query	True	string	Verze rozhraní API klienta.

Text požadavku

Name	Typ	Description
location	string	Získá nebo nastaví umístění prostředku.
name	string	Získá nebo nastaví název prostředku.
properties.description	string	Získá nebo nastaví popis runbooku.
properties.logActivityTrace	integer (int32)	Získá nebo nastaví možnosti trasování na úrovni aktivity runbooku.
properties.logProgress	boolean	Získá nebo nastaví možnost protokolu průběhu.
properties.logVerbose	boolean	Získá nebo nastaví možnost podrobného protokolu.
tags	object	Získá nebo nastaví značky připojené k prostředku.

Odpovědi

Name	Typ	Description
200 OK	Runbook	OK
Other Status Codes	ErrorResponse	Odpověď na chybu automatizace popisující, proč operace selhala.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	zosobnění uživatelského účtu

Příklady

Update runbook

Ukázkový požadavek

HTTP

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/runbooks/Get-AzureVMTutorial?api-version=2023-11-01

{
  "properties": {
    "description": "Updated Description of the Runbook",
    "logVerbose": false,
    "logProgress": true,
    "logActivityTrace": 1
  }
}

Ukázková odpověď

Stavový kód:

200

{
  "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/runbooks/Get-AzureVMTutorial",
  "name": "Get-AzureVMTutorial",
  "type": "Microsoft.Automation/AutomationAccounts/Runbooks",
  "location": "East US 2",
  "tags": {
    "tag01": "value01",
    "tag02": "value02"
  },
  "etag": "\"636265044994500000\"",
  "properties": {
    "description": "Updated Description of the Runbook",
    "logVerbose": false,
    "logProgress": true,
    "logActivityTrace": 1,
    "runbookType": "PowerShellWorkflow",
    "parameters": {},
    "state": "Published",
    "jobCount": 0,
    "provisioningState": "Succeeded",
    "outputTypes": [],
    "creationTime": "2017-03-30T21:01:33.777+00:00",
    "lastModifiedBy": "myEmaild@microsoft.com",
    "lastModifiedTime": "2017-03-30T21:01:39.45+00:00"
  }
}

Definice

Name	Description
ContentHash	Definice typu vlastnosti runbooku
ContentLink	Definice odkazu na obsah
ErrorResponse	Chybová odpověď selhání operace
Runbook	Definice typu runbooku
RunbookDraft
RunbookParameter	Definice typu parametru runbooku
RunbookProvisioningState	Získá nebo nastaví stav zřizování runbooku.
RunbookState	Získá nebo nastaví stav runbooku.
RunbookTypeEnum	Získá nebo nastaví typ runbooku.
RunbookUpdateParameters	Parametry zadané operaci aktualizačního runbooku.

ContentHash

Objekt

Definice typu vlastnosti runbooku

Name	Typ	Description
algorithm	string	Získá nebo nastaví hashovací algoritmus obsahu použitý k hash obsahu.
value	string	Získá nebo nastaví očekávanou hodnotu hash obsahu.

ContentLink

Objekt

Definice odkazu na obsah

Name	Typ	Description
contentHash	ContentHash	Nastaví hodnotu hash.
uri	string	Nastaví identifikátor URI obsahu.
version	string	Nastaví verzi obsahu.

ErrorResponse

Objekt

Chybová odpověď selhání operace

Name	Typ	Description
code	string	Kód chyby
message	string	Chybová zpráva označující, proč operace selhala.

Runbook

Objekt

Definice typu runbooku

Name	Typ	Description
etag	string	Získá nebo nastaví značku prostředku.
id	string	Plně kvalifikované ID prostředku pro prostředek
location	string	Oblast Azure, ve které se prostředek nachází
name	string	Název prostředku
properties.creationTime	string (date-time)	Získá nebo nastaví čas vytvoření.
properties.description	string	Získá nebo nastaví popis.
properties.draft	RunbookDraft	Získá nebo nastaví vlastnosti konceptu runbooku.
properties.jobCount	integer (int32)	Získá nebo nastaví počet úloh runbooku.
properties.lastModifiedBy	string	Získá nebo nastaví naposledy změněno.
properties.lastModifiedTime	string (date-time)	Získá nebo nastaví čas poslední změny.
properties.logActivityTrace	integer (int32)	Získá nebo nastaví možnost protokolování trasování aktivity runbooku.
properties.logProgress	boolean	Získá nebo nastaví možnost protokolu průběhu.
properties.logVerbose	boolean	Získá nebo nastaví možnost podrobného protokolu.
properties.outputTypes	string[]	Získá nebo nastaví výstupní typy runbooku.
properties.parameters	<string,  RunbookParameter>	Získá nebo nastaví parametry runbooku.
properties.provisioningState	RunbookProvisioningState	Získá nebo nastaví stav zřizování runbooku.
properties.publishContentLink	ContentLink	Získá nebo nastaví publikovaný odkaz na obsah runbooku.
properties.runbookType	RunbookTypeEnum	Získá nebo nastaví typ runbooku.
properties.state	RunbookState	Získá nebo nastaví stav runbooku.
tags	object	Značky prostředků
type	string	Typ prostředku.

RunbookDraft

Objekt

Name	Typ	Description
creationTime	string (date-time)	Získá nebo nastaví čas vytvoření konceptu runbooku.
draftContentLink	ContentLink	Získá nebo nastaví odkaz na obsah konceptu runbooku.
inEdit	boolean	Získá nebo nastaví, zda runbook je v režimu úprav.
lastModifiedTime	string (date-time)	Získá nebo nastaví čas poslední změny konceptu runbooku.
outputTypes	string[]	Získá nebo nastaví výstupní typy runbooku.
parameters	<string,  RunbookParameter>	Získá nebo nastaví parametry konceptu runbooku.

RunbookParameter

Objekt

Definice typu parametru runbooku

Name	Typ	Description
defaultValue	string	Získá nebo nastaví výchozí hodnotu parametru.
isMandatory	boolean	Získá nebo nastaví logickou hodnotu označující, zda je parametr povinný, nebo ne.
position	integer (int32)	Získá nebo nastaví pozici parametru.
type	string	Získá nebo nastaví typ parametru.

RunbookProvisioningState

Výčet

Získá nebo nastaví stav zřizování runbooku.

Hodnota	Description
Succeeded

RunbookState

Výčet

Získá nebo nastaví stav runbooku.

Hodnota	Description
Edit
New
Published

RunbookTypeEnum

Výčet

Získá nebo nastaví typ runbooku.

Hodnota	Description
Graph
GraphPowerShell
GraphPowerShellWorkflow
PowerShell
PowerShell72
PowerShellWorkflow
Python2
Python3
Script

RunbookUpdateParameters

Objekt

Parametry zadané operaci aktualizačního runbooku.

Name	Typ	Description
location	string	Získá nebo nastaví umístění prostředku.
name	string	Získá nebo nastaví název prostředku.
properties.description	string	Získá nebo nastaví popis runbooku.
properties.logActivityTrace	integer (int32)	Získá nebo nastaví možnosti trasování na úrovni aktivity runbooku.
properties.logProgress	boolean	Získá nebo nastaví možnost protokolu průběhu.
properties.logVerbose	boolean	Získá nebo nastaví možnost podrobného protokolu.
tags	object	Získá nebo nastaví značky připojené k prostředku.