Compartilhar via


Factories - Update

Updates a factory.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataFactory/factories/{factoryName}?api-version=2018-06-01

URI Parameters

Name In Required Type Description
factoryName
path True

string

The factory name.

Regex pattern: ^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$

resourceGroupName
path True

string

The resource group name.

Regex pattern: ^[-\w\._\(\)]+$

subscriptionId
path True

string

The subscription identifier.

api-version
query True

string

The API version.

Request Body

Name Type Description
identity

FactoryIdentity

Managed service identity of the factory.

properties.publicNetworkAccess

PublicNetworkAccess

Whether or not public network access is allowed for the data factory.

tags

object

The resource tags.

Responses

Name Type Description
200 OK

Factory

OK.

Other Status Codes

CloudError

An error response received from the Azure Data Factory service.

Security

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation impersonate your user account

Examples

Factories_Update

Sample request

PATCH https://management.azure.com/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName?api-version=2018-06-01

{
  "tags": {
    "exampleTag": "exampleValue"
  }
}

Sample response

Date: Tue, 19 Jun 2018 05:41:50 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1192
x-ms-request-id: 699c67a6-fef5-40c9-bc73-d571d09783c3
x-ms-correlation-request-id: 699c67a6-fef5-40c9-bc73-d571d09783c3
{
  "name": "exampleFactoryName",
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.DataFactory/factories/exampleFactoryName",
  "type": "Microsoft.DataFactory/factories",
  "properties": {
    "provisioningState": "Succeeded",
    "createTime": "2018-06-19T05:41:50.0041314Z",
    "version": "2018-06-01"
  },
  "eTag": "\"00003f04-0000-0000-0000-5b28979e0000\"",
  "location": "East US",
  "tags": {
    "exampleTag": "exampleValue"
  }
}

Definitions

Name Description
CloudError

The object that defines the structure of an Azure Data Factory error response.

CMKIdentityDefinition

Managed Identity used for CMK.

EncryptionConfiguration

Definition of CMK for the factory.

Factory

Factory resource type.

FactoryGitHubConfiguration

Factory's GitHub repo information.

FactoryIdentity

Identity properties of the factory resource.

FactoryIdentityType

The identity type.

FactoryUpdateParameters

Parameters for updating a factory resource.

FactoryVSTSConfiguration

Factory's VSTS repo information.

GitHubClientSecret

Client secret information for factory's bring your own app repository configuration.

GlobalParameterSpecification

Definition of a single parameter for an entity.

GlobalParameterType

Global Parameter type.

PublicNetworkAccess

Whether or not public network access is allowed for the data factory.

PurviewConfiguration

Purview configuration.

UserAssignedIdentitySpecification

Definition of a single user assigned identity for a factory.

CloudError

The object that defines the structure of an Azure Data Factory error response.

Name Type Description
error.code

string

Error code.

error.details

CloudError[]

Array with additional error details.

error.message

string

Error message.

error.target

string

Property name/path in request associated with error.

CMKIdentityDefinition

Managed Identity used for CMK.

Name Type Description
userAssignedIdentity

string

The resource id of the user assigned identity to authenticate to customer's key vault.

EncryptionConfiguration

Definition of CMK for the factory.

Name Type Description
identity

CMKIdentityDefinition

User assigned identity to use to authenticate to customer's key vault. If not provided Managed Service Identity will be used.

keyName

string

The name of the key in Azure Key Vault to use as Customer Managed Key.

keyVersion

string

The version of the key used for CMK. If not provided, latest version will be used.

vaultBaseUrl

string

The url of the Azure Key Vault used for CMK.

Factory

Factory resource type.

Name Type Description
eTag

string

Etag identifies change in the resource.

id

string

The resource identifier.

identity

FactoryIdentity

Managed service identity of the factory.

location

string

The resource location.

name

string

The resource name.

properties.createTime

string

Time the factory was created in ISO8601 format.

properties.encryption

EncryptionConfiguration

Properties to enable Customer Managed Key for the factory.

properties.globalParameters

<string,  GlobalParameterSpecification>

List of parameters for factory.

properties.provisioningState

string

Factory provisioning state, example Succeeded.

properties.publicNetworkAccess

PublicNetworkAccess

Whether or not public network access is allowed for the data factory.

properties.purviewConfiguration

PurviewConfiguration

Purview information of the factory.

properties.repoConfiguration FactoryRepoConfiguration:

Git repo information of the factory.

properties.version

string

Version of the factory.

tags

object

The resource tags.

type

string

The resource type.

FactoryGitHubConfiguration

Factory's GitHub repo information.

Name Type Description
accountName

string

Account name.

clientId

string

GitHub bring your own app client id.

clientSecret

GitHubClientSecret

GitHub bring your own app client secret information.

collaborationBranch

string

Collaboration branch.

disablePublish

boolean

Disable manual publish operation in ADF studio to favor automated publish.

hostName

string

GitHub Enterprise host name. For example: https://github.mydomain.com

lastCommitId

string

Last commit id.

repositoryName

string

Repository name.

rootFolder

string

Root folder.

type string:

FactoryGitHubConfiguration

Type of repo configuration.

FactoryIdentity

Identity properties of the factory resource.

Name Type Description
principalId

string

The principal id of the identity.

tenantId

string

The client tenant id of the identity.

type

FactoryIdentityType

The identity type.

userAssignedIdentities

<string,  UserAssignedIdentitySpecification>

List of user assigned identities for the factory.

FactoryIdentityType

The identity type.

Name Type Description
SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

FactoryUpdateParameters

Parameters for updating a factory resource.

Name Type Description
identity

FactoryIdentity

Managed service identity of the factory.

properties.publicNetworkAccess

PublicNetworkAccess

Whether or not public network access is allowed for the data factory.

tags

object

The resource tags.

FactoryVSTSConfiguration

Factory's VSTS repo information.

Name Type Description
accountName

string

Account name.

collaborationBranch

string

Collaboration branch.

disablePublish

boolean

Disable manual publish operation in ADF studio to favor automated publish.

lastCommitId

string

Last commit id.

projectName

string

VSTS project name.

repositoryName

string

Repository name.

rootFolder

string

Root folder.

tenantId

string

VSTS tenant id.

type string:

FactoryVSTSConfiguration

Type of repo configuration.

GitHubClientSecret

Client secret information for factory's bring your own app repository configuration.

Name Type Description
byoaSecretAkvUrl

string

Bring your own app client secret AKV URL.

byoaSecretName

string

Bring your own app client secret name in AKV.

GlobalParameterSpecification

Definition of a single parameter for an entity.

Name Type Description
type

GlobalParameterType

Global Parameter type.

value

object

Value of parameter.

GlobalParameterType

Global Parameter type.

Name Type Description
Array

string

Bool

string

Float

string

Int

string

Object

string

String

string

PublicNetworkAccess

Whether or not public network access is allowed for the data factory.

Name Type Description
Disabled

string

Enabled

string

PurviewConfiguration

Purview configuration.

Name Type Description
purviewResourceId

string

Purview resource id.

UserAssignedIdentitySpecification

Definition of a single user assigned identity for a factory.