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

Workflows - Create Or Update

服务:: Logic Apps

API 版本:: 2019-05-01

创建或更新工作流。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Logic/workflows/{workflowName}?api-version=2019-05-01

URI 参数

名称	在	必需	类型	说明
resourceGroupName	path	True	string	资源组名称。
subscriptionId	path	True	string	订阅 ID。
workflowName	path	True	string	工作流名称。
api-version	query	True	string	API 版本。

请求正文

名称	类型	说明
identity	ManagedServiceIdentity	托管服务标识属性。
location	string	资源位置。
properties.accessControl	FlowAccessControlConfiguration	访问控制配置。
properties.definition	Object	定义。
properties.endpointsConfiguration	FlowEndpointsConfiguration	终结点配置。
properties.integrationAccount	ResourceReference	集成帐户。
properties.integrationServiceEnvironment	ResourceReference	集成服务环境。
properties.parameters	<string, WorkflowParameter>	参数。
properties.state	WorkflowState	状态。
tags	object	资源标记。

响应

名称	类型	说明
200 OK	Workflow	好的
201 Created	Workflow	已创建
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Create or update a workflow

示例请求

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-resource-group/providers/Microsoft.Logic/workflows/test-workflow?api-version=2019-05-01

{
  "properties": {
    "integrationAccount": {
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-resource-group/providers/Microsoft.Logic/integrationAccounts/test-integration-account"
    },
    "definition": {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {
        "$connections": {
          "defaultValue": {},
          "type": "Object"
        }
      },
      "triggers": {
        "manual": {
          "type": "Request",
          "kind": "Http",
          "inputs": {
            "schema": {}
          }
        }
      },
      "actions": {
        "Find_pet_by_ID": {
          "runAfter": {},
          "type": "ApiConnection",
          "inputs": {
            "host": {
              "connection": {
                "name": "@parameters('$connections')['test-custom-connector']['connectionId']"
              }
            },
            "method": "get",
            "path": "/pet/@{encodeURIComponent('1')}"
          }
        }
      },
      "outputs": {}
    },
    "parameters": {
      "$connections": {
        "value": {
          "test-custom-connector": {
            "connectionId": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-resource-group/providers/Microsoft.Web/connections/test-custom-connector",
            "connectionName": "test-custom-connector",
            "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/providers/Microsoft.Web/locations/brazilsouth/managedApis/test-custom-connector"
          }
        }
      }
    }
  },
  "location": "brazilsouth",
  "tags": {}
}

示例响应

状态代码:: 200

{
  "properties": {
    "provisioningState": "Succeeded",
    "createdTime": "2018-04-25T01:39:21.4365247Z",
    "changedTime": "2018-08-09T22:54:54.3533634Z",
    "state": "Enabled",
    "version": "08586677515911718341",
    "accessEndpoint": "http://tempuri.org",
    "integrationAccount": {
      "name": "test-integration-account",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-resource-group/providers/Microsoft.Logic/integrationAccounts/test-integration-account",
      "type": "Microsoft.Logic/integrationAccounts"
    },
    "integrationServiceEnvironment": {
      "name": "test-integration-service-environment",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-resource-group/providers/Microsoft.Logic/integrationServiceEnvironments/test-integration-service-environment",
      "type": "Microsoft.Logic/integrationServiceEnvironments"
    },
    "definition": {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {},
      "triggers": {},
      "actions": {},
      "outputs": {}
    },
    "parameters": {},
    "endpointsConfiguration": {
      "workflow": {
        "outgoingIpAddresses": [
          {
            "address": "13.84.159.168"
          },
          {
            "address": "13.65.86.56"
          },
          {
            "address": "13.65.82.190"
          }
        ],
        "accessEndpointIpAddresses": [
          {
            "address": "104.210.153.89"
          },
          {
            "address": "13.85.79.155"
          },
          {
            "address": "13.65.39.247"
          }
        ]
      },
      "connector": {
        "outgoingIpAddresses": [
          {
            "address": "40.84.145.61"
          }
        ]
      }
    }
  }
}

状态代码:: 201

{
  "properties": {
    "provisioningState": "Succeeded",
    "createdTime": "2018-04-25T01:39:21.4365247Z",
    "changedTime": "2018-08-09T22:54:54.3533634Z",
    "state": "Enabled",
    "version": "08586677515911718341",
    "accessEndpoint": "http://tempuri.org",
    "integrationAccount": {
      "name": "test-integration-account",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-resource-group/providers/Microsoft.Logic/integrationAccounts/test-integration-account",
      "type": "Microsoft.Logic/integrationAccounts"
    },
    "integrationServiceEnvironment": {
      "name": "test-integration-service-environment",
      "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/test-resource-group/providers/Microsoft.Logic/integrationServiceEnvironments/test-integration-service-environment",
      "type": "Microsoft.Logic/integrationServiceEnvironments"
    },
    "definition": {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {},
      "triggers": {},
      "actions": {},
      "outputs": {}
    },
    "parameters": {},
    "endpointsConfiguration": {
      "workflow": {
        "outgoingIpAddresses": [
          {
            "address": "13.84.159.168"
          },
          {
            "address": "13.65.86.56"
          },
          {
            "address": "13.65.82.190"
          }
        ],
        "accessEndpointIpAddresses": [
          {
            "address": "104.210.153.89"
          },
          {
            "address": "13.85.79.155"
          },
          {
            "address": "13.65.39.247"
          }
        ]
      },
      "connector": {
        "outgoingIpAddresses": [
          {
            "address": "40.84.145.61"
          }
        ]
      }
    }
  }
}

定义

名称	说明
ErrorProperties	错误属性指示逻辑服务无法处理传入请求的原因。错误消息中提供了原因。
ErrorResponse	错误响应表示逻辑服务无法处理传入请求。 error 属性包含错误详细信息。
FlowAccessControlConfiguration	访问控制配置。
FlowAccessControlConfigurationPolicy	访问控制配置策略。
FlowEndpoints	流端点配置。
FlowEndpointsConfiguration	终结点配置。
IpAddress	IP 地址。
IpAddressRange	IP 地址范围。
ManagedServiceIdentity	托管服务标识属性。
ManagedServiceIdentityType	托管服务标识的类型。类型“SystemAssigned”包括隐式创建的标识。类型“None”将从资源中删除任何标识。
Object
OpenAuthenticationAccessPolicies	AuthenticationPolicy 类型为 Open。
OpenAuthenticationAccessPolicy	打开用户定义的身份验证访问策略。
OpenAuthenticationPolicyClaim	打开身份验证策略声明。
OpenAuthenticationProviderType	打开身份验证策略提供程序类型。
ParameterType	参数类型。
ResourceReference	资源引用。
Sku	SKU 类型。
SkuName	SKU 名称。
userAssignedIdentity	用户分配的标识属性。
Workflow	工作流类型。
WorkflowParameter	工作流参数。
WorkflowProvisioningState	工作流预配状态。
WorkflowState	工作流状态。

ErrorProperties

Object

错误属性指示逻辑服务无法处理传入请求的原因。错误消息中提供了原因。

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

ErrorResponse

Object

错误响应表示逻辑服务无法处理传入请求。 error 属性包含错误详细信息。

名称	类型	说明
error	ErrorProperties	错误属性。

FlowAccessControlConfiguration

Object

访问控制配置。

名称	类型	说明
actions	FlowAccessControlConfigurationPolicy	工作流操作的访问控制配置。
contents	FlowAccessControlConfigurationPolicy	用于访问工作流运行内容的访问控制配置。
triggers	FlowAccessControlConfigurationPolicy	用于调用工作流触发器的访问控制配置。
workflowManagement	FlowAccessControlConfigurationPolicy	工作流管理的访问控制配置。

FlowAccessControlConfigurationPolicy

Object

访问控制配置策略。

名称	类型	说明
allowedCallerIpAddresses	IpAddressRange[]	允许的调用方 IP 地址范围。
openAuthenticationPolicies	OpenAuthenticationAccessPolicies	工作流的身份验证策略。

FlowEndpoints

Object

流端点配置。

名称	类型	说明
accessEndpointIpAddresses	IpAddress[]	访问终结点 IP 地址。
outgoingIpAddresses	IpAddress[]	传出 IP 地址。

FlowEndpointsConfiguration

Object

终结点配置。

名称	类型	说明
connector	FlowEndpoints	连接器终结点。
workflow	FlowEndpoints	工作流终结点。

IpAddress

Object

IP 地址。

名称	类型	说明
address	string	地址。

IpAddressRange

Object

IP 地址范围。

名称	类型	说明
addressRange	string	IP 地址范围。

ManagedServiceIdentity

Object

托管服务标识属性。

名称	类型	说明
principalId	string (uuid)	托管服务标识的主体 ID。
tenantId	string (uuid)	托管服务标识的租户。
type	ManagedServiceIdentityType	托管服务标识的类型。类型“SystemAssigned”包括隐式创建的标识。类型“None”将从资源中删除任何标识。
userAssignedIdentities	<string, userAssignedIdentity>	与资源关联的用户分配标识的列表。用户标识字典密钥引用的格式为 ARM 资源 ID：“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}

ManagedServiceIdentityType

枚举

托管服务标识的类型。类型“SystemAssigned”包括隐式创建的标识。类型“None”将从资源中删除任何标识。

值	说明
SystemAssigned
UserAssigned
None

Object

OpenAuthenticationAccessPolicies

Object

AuthenticationPolicy 类型为 Open。

名称	类型	说明
policies	<string, OpenAuthenticationAccessPolicy>	打开身份验证策略。

OpenAuthenticationAccessPolicy

Object

打开用户定义的身份验证访问策略。

名称	类型	说明
claims	OpenAuthenticationPolicyClaim[]	访问策略声明。
type	OpenAuthenticationProviderType	OAuth 的提供程序类型。

OpenAuthenticationPolicyClaim

Object

打开身份验证策略声明。

名称	类型	说明
name	string	声明名称。
value	string	索赔的价值。

OpenAuthenticationProviderType

枚举

打开身份验证策略提供程序类型。

值	说明
AAD

ParameterType

枚举

参数类型。

值	说明
NotSpecified
String
SecureString
Int
Float
Bool
Array
Object
SecureObject

ResourceReference

Object

资源引用。

名称	类型	说明
id	string	资源 ID。
name	string	获取资源名称。
type	string	获取资源类型。

Sku

Object

SKU 类型。

名称	类型	说明
name	SkuName	名称。
plan	ResourceReference	计划的引用。

SkuName

枚举

SKU 名称。

值	说明
NotSpecified
Free
Shared
Basic
Standard
Premium

userAssignedIdentity

Object

用户分配的标识属性。

名称	类型	说明
clientId	string	用户分配标识的客户端 ID
principalId	string	用户分配标识的主体 ID

Workflow

Object

工作流类型。

名称	类型	说明
id	string	资源 ID。
identity	ManagedServiceIdentity	托管服务标识属性。
location	string	资源位置。
name	string	获取资源名称。
properties.accessControl	FlowAccessControlConfiguration	访问控制配置。
properties.accessEndpoint	string	获取访问终结点。
properties.changedTime	string (date-time)	获取更改的时间。
properties.createdTime	string (date-time)	获取创建的时间。
properties.definition	Object	定义。
properties.endpointsConfiguration	FlowEndpointsConfiguration	终结点配置。
properties.integrationAccount	ResourceReference	集成帐户。
properties.integrationServiceEnvironment	ResourceReference	集成服务环境。
properties.parameters	<string, WorkflowParameter>	参数。
properties.provisioningState	WorkflowProvisioningState	获取预配状态。
properties.sku	Sku	SKU。
properties.state	WorkflowState	状态。
properties.version	string	获取版本。
tags	object	资源标记。
type	string	获取资源类型。

WorkflowParameter

Object

工作流参数。

名称	类型	说明
description	string	说明。
metadata	Object	元数据。
type	ParameterType	类型。
value	Object	值。

WorkflowProvisioningState

枚举

工作流预配状态。

值	说明
NotSpecified
Accepted
Running
Ready
Creating
Created
Deleting
Deleted
Canceled
Failed
Succeeded
Moving
Updating
Registering
Registered
Unregistering
Unregistered
Completed
Renewing
Pending
Waiting
InProgress

WorkflowState

枚举

工作流状态。

值	说明
NotSpecified
Completed
Enabled
Disabled
Deleted
Suspended

通过

Workflows - Create Or Update

URI 参数

请求正文

响应

安全性

azure_auth

作用域

示例

Create or update a workflow

示例请求

示例响应

定义

ErrorProperties

ErrorResponse

FlowAccessControlConfiguration

FlowAccessControlConfigurationPolicy

FlowEndpoints

FlowEndpointsConfiguration

IpAddress

IpAddressRange

ManagedServiceIdentity

ManagedServiceIdentityType

Object

OpenAuthenticationAccessPolicies

OpenAuthenticationAccessPolicy

OpenAuthenticationPolicyClaim

OpenAuthenticationProviderType

ParameterType

ResourceReference

Sku

SkuName

userAssignedIdentity

Workflow

WorkflowParameter

WorkflowProvisioningState

WorkflowState