你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Runbook - List By Automation Account

参考

服务:: Automation

API 版本:: 2023-11-01

检索 Runbook 列表。

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

URI 参数

名称	在	必需	类型	说明
automationAccountName	path	True	string	自动化帐户的名称。
resourceGroupName	path	True	string minLength: 1 maxLength: 90 pattern: ^[-\w\._]+$	Azure 资源组的名称。
subscriptionId	path	True	string	获取唯一标识Microsoft Azure 订阅的订阅凭据。订阅 ID 构成了每个服务调用的 URI 的一部分。
api-version	query	True	string	客户端 API 版本。

响应

名称	类型	说明
200 OK	RunbookListResult	还行
Other Status Codes	ErrorResponse	描述作失败原因的自动化错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

类型: oauth2
流向: implicit
授权 URL: https://login.microsoftonline.com/common/oauth2/authorize

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

List runbooks by automation account

示例请求

HTTP

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

示例响应

状态代码:: 200

{
  "value": [
    {
      "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/runbooks/ASR-AddPublicIp",
      "location": "East US 2",
      "name": "ASR-AddPublicIp",
      "type": "Microsoft.Automation/AutomationAccounts/Runbooks",
      "properties": {
        "runbookType": "PowerShell",
        "state": "Published",
        "logVerbose": true,
        "logProgress": true,
        "logActivityTrace": 1,
        "creationTime": "2017-03-28T21:32:25.78+00:00",
        "lastModifiedTime": "2017-03-28T21:32:25.81+00:00"
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/runbooks/AutoExport",
      "location": "East US 2",
      "name": "AutoExport",
      "type": "Microsoft.Automation/AutomationAccounts/Runbooks",
      "properties": {
        "runbookType": "PowerShell",
        "state": "Published",
        "logVerbose": true,
        "logProgress": true,
        "logActivityTrace": 1,
        "creationTime": "2017-03-28T21:32:27.327+00:00",
        "lastModifiedTime": "2017-03-28T21:32:27.327+00:00"
      }
    },
    {
      "id": "/subscriptions/subid/resourceGroups/rg/providers/Microsoft.Automation/automationAccounts/ContoseAutomationAccount/runbooks/Get-AzureVMTutorial",
      "location": "East US 2",
      "name": "Get-AzureVMTutorial",
      "type": "Microsoft.Automation/AutomationAccounts/Runbooks",
      "properties": {
        "runbookType": "PowerShellWorkflow",
        "state": "Published",
        "logVerbose": false,
        "logProgress": true,
        "logActivityTrace": 1,
        "creationTime": "2017-03-28T21:32:23.75+00:00",
        "lastModifiedTime": "2017-03-28T21:32:23.75+00:00"
      }
    }
  ]
}

定义

名称	说明
ContentHash	Runbook 属性类型的定义。
ContentLink	内容链接的定义。
ErrorResponse	作失败的错误响应
Runbook	Runbook 类型的定义。
RunbookDraft
RunbookListResult	列表 Runbook作的响应模型。
RunbookParameter	Runbook 参数类型的定义。
RunbookProvisioningState	获取或设置 Runbook 的预配状态。
RunbookState	获取或设置 Runbook 的状态。
RunbookTypeEnum	获取或设置 Runbook 的类型。

ContentHash

Object

Runbook 属性类型的定义。

名称	类型	说明
algorithm	string	获取或设置用于对内容进行哈希处理的内容哈希算法。
value	string	获取或设置内容的预期哈希值。

ContentLink

Object

内容链接的定义。

名称	类型	说明
contentHash	ContentHash	设置哈希。
uri	string	设置内容的 URI。
version	string	设置内容的版本。

ErrorResponse

Object

作失败的错误响应

名称	类型	说明
code	string	错误代码
message	string	指示作失败的原因的错误消息。

Runbook

Object

Runbook 类型的定义。

名称	类型	说明
etag	string	获取或设置资源的 etag。
id	string	资源的完全限定资源 ID
location	string	资源所在的 Azure 区域
name	string	资源的名称
properties.creationTime	string (date-time)	获取或设置创建时间。
properties.description	string	获取或设置说明。
properties.draft	RunbookDraft	获取或设置草稿 Runbook 属性。
properties.jobCount	integer (int32)	获取或设置 Runbook 的作业计数。
properties.lastModifiedBy	string	获取或设置上次修改者。
properties.lastModifiedTime	string (date-time)	获取或设置上次修改时间。
properties.logActivityTrace	integer (int32)	获取或设置用于记录 Runbook 的活动跟踪的选项。
properties.logProgress	boolean	获取或设置进度日志选项。
properties.logVerbose	boolean	获取或设置详细日志选项。
properties.outputTypes	string[]	获取或设置 Runbook 输出类型。
properties.parameters	<string, RunbookParameter>	获取或设置 Runbook 参数。
properties.provisioningState	RunbookProvisioningState	获取或设置 Runbook 的预配状态。
properties.publishContentLink	ContentLink	获取或设置已发布的 Runbook 内容链接。
properties.runbookType	RunbookTypeEnum	获取或设置 Runbook 的类型。
properties.state	RunbookState	获取或设置 Runbook 的状态。
tags	object	资源标记。
type	string	资源的类型。

RunbookDraft

Object

名称	类型	说明
creationTime	string (date-time)	获取或设置 Runbook 草稿的创建时间。
draftContentLink	ContentLink	获取或设置草稿 Runbook 内容链接。
inEdit	boolean	获取或设置 Runbook 是否处于编辑模式。
lastModifiedTime	string (date-time)	获取或设置 Runbook 草稿的上次修改时间。
outputTypes	string[]	获取或设置 Runbook 输出类型。
parameters	<string, RunbookParameter>	获取或设置 Runbook 草稿参数。

RunbookListResult

Object

列表 Runbook作的响应模型。

名称	类型	说明
nextLink	string	获取或设置下一个链接。
value	Runbook[]	获取或设置 Runbook 的列表。

RunbookParameter

Object

Runbook 参数类型的定义。

名称	类型	说明
defaultValue	string	获取或设置参数的默认值。
isMandatory	boolean	获取或设置一个布尔值，该值指示参数是否是必需的。
position	integer (int32)	获取或设置参数的位置。
type	string	获取或设置参数的类型。

RunbookProvisioningState

枚举

获取或设置 Runbook 的预配状态。

值	说明
Succeeded

RunbookState

枚举

获取或设置 Runbook 的状态。

值	说明
Edit
New
Published

RunbookTypeEnum

枚举

获取或设置 Runbook 的类型。

值	说明
Graph
GraphPowerShell
GraphPowerShellWorkflow
PowerShell
PowerShell72
PowerShellWorkflow
Python2
Python3
Script

通过

Runbook - List By Automation Account

URI 参数

响应

安全性

azure_auth

作用域

示例

List runbooks by automation account

示例请求

示例响应

定义

ContentHash

ContentLink

ErrorResponse

Runbook

RunbookDraft

RunbookListResult

RunbookParameter

RunbookProvisioningState

RunbookState

RunbookTypeEnum

其他资源