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

Accounts - Create

服务:: Data Lake Storage Gen1

API 版本:: 2016-11-01

创建指定的 Data Lake Store 帐户。

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataLakeStore/accounts/{accountName}?api-version=2016-11-01

URI 参数

名称	在	必需	类型	说明
accountName	path	True	string	Data Lake Store 帐户的名称。
resourceGroupName	path	True	string	Azure 资源组的名称。
subscriptionId	path	True	string	获取唯一标识Microsoft Azure 订阅的订阅凭据。订阅 ID 构成了每个服务调用的 URI 的一部分。
api-version	query	True	string	客户端 API 版本。

请求正文

名称	必需	类型	说明
location	True	string	资源位置。
identity		EncryptionIdentity	Key Vault 加密标识（如果有）。
properties.defaultGroup		string	Data Lake Store 帐户中创建的所有新文件夹和文件的默认所有者组。
properties.encryptionConfig		EncryptionConfig	Key Vault 加密配置。
properties.encryptionState		EncryptionState	此 Data Lake Store 帐户的当前加密状态。
properties.firewallAllowAzureIps		FirewallAllowAzureIpsState	允许或禁止通过防火墙在 Azure 中发起的 IP 的当前状态。如果防火墙已禁用，则不会强制实施。
properties.firewallRules		CreateFirewallRuleWithAccountParameters[]	与此 Data Lake Store 帐户关联的防火墙规则列表。
properties.firewallState		FirewallState	此 Data Lake Store 帐户的 IP 地址防火墙的当前状态。
properties.newTier		TierType	下个月要使用的承诺层。
properties.trustedIdProviderState		TrustedIdProviderState	此 Data Lake Store 帐户的受信任标识提供者功能的当前状态。
properties.trustedIdProviders		CreateTrustedIdProviderWithAccountParameters[]	与此 Data Lake Store 帐户关联的受信任标识提供者列表。
properties.virtualNetworkRules		CreateVirtualNetworkRuleWithAccountParameters[]	与此 Data Lake Store 帐户关联的虚拟网络规则列表。
tags		object	资源标记。

响应

名称	类型	说明
200 OK	DataLakeStoreAccount	已成功创建帐户。
201 Created	DataLakeStoreAccount	已成功启动帐户的创建。

安全性

azure_auth

Azure Active Directory OAuth2 流

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

Creates the specified Data Lake Store account

示例请求

HTTP

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/contosorg/providers/Microsoft.DataLakeStore/accounts/contosoadla?api-version=2016-11-01

{
  "location": "eastus2",
  "tags": {
    "test_key": "test_value"
  },
  "identity": {
    "type": "SystemAssigned"
  },
  "properties": {
    "encryptionState": "Enabled",
    "encryptionConfig": {
      "type": "UserManaged",
      "keyVaultMetaInfo": {
        "keyVaultResourceId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
        "encryptionKeyName": "test_encryption_key_name",
        "encryptionKeyVersion": "encryption_key_version"
      }
    },
    "firewallState": "Enabled",
    "firewallRules": [
      {
        "name": "test_rule",
        "properties": {
          "startIpAddress": "1.1.1.1",
          "endIpAddress": "2.2.2.2"
        }
      }
    ],
    "trustedIdProviderState": "Enabled",
    "trustedIdProviders": [
      {
        "name": "test_trusted_id_provider_name",
        "properties": {
          "idProvider": "https://sts.windows.net/ea9ec534-a3e3-4e45-ad36-3afc5bb291c1"
        }
      }
    ],
    "defaultGroup": "test_default_group",
    "newTier": "Consumption",
    "firewallAllowAzureIps": "Enabled"
  }
}

示例响应

状态代码:: 200

{
  "id": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
  "name": "contosoadla",
  "type": "test_type",
  "location": "eastus2",
  "tags": {
    "test_key": "test_value"
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
    "tenantId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab346"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "state": "Active",
    "creationTime": "2017-04-14T13:21:56.6819037-07:00",
    "lastModifiedTime": "2017-04-14T13:21:56.6819037-07:00",
    "endpoint": "testadlfs17607.azuredatalakestore.net",
    "accountId": "94f4bf5d-78a9-4c31-8aa7-b34d07bad898",
    "encryptionState": "Enabled",
    "encryptionProvisioningState": "Succeeded",
    "encryptionConfig": {
      "type": "UserManaged",
      "keyVaultMetaInfo": {
        "keyVaultResourceId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
        "encryptionKeyName": "test_encryption_key_name",
        "encryptionKeyVersion": "encryption_key_version"
      }
    },
    "firewallState": "Enabled",
    "firewallRules": [
      {
        "id": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
        "name": "test_rule",
        "type": "test_type",
        "properties": {
          "startIpAddress": "1.1.1.1",
          "endIpAddress": "2.2.2.2"
        }
      }
    ],
    "trustedIdProviderState": "Enabled",
    "trustedIdProviders": [
      {
        "id": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
        "name": "test_trusted_id_provider_name",
        "type": "test_type",
        "properties": {
          "idProvider": "https://sts.windows.net/ea9ec534-a3e3-4e45-ad36-3afc5bb291c1"
        }
      }
    ],
    "defaultGroup": "test_default_group",
    "newTier": "Consumption",
    "currentTier": "Consumption",
    "firewallAllowAzureIps": "Enabled"
  }
}

状态代码:: 201

{
  "id": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
  "name": "contosoadla",
  "type": "test_type",
  "location": "eastus2",
  "tags": {
    "test_key": "test_value"
  },
  "identity": {
    "type": "SystemAssigned",
    "principalId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
    "tenantId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab346"
  },
  "properties": {
    "provisioningState": "Succeeded",
    "state": "Active",
    "creationTime": "2017-04-14T13:21:56.6819037-07:00",
    "lastModifiedTime": "2017-04-14T13:21:56.6819037-07:00",
    "endpoint": "testadlfs17607.azuredatalakestore.net",
    "accountId": "94f4bf5d-78a9-4c31-8aa7-b34d07bad898",
    "encryptionState": "Enabled",
    "encryptionProvisioningState": "Succeeded",
    "encryptionConfig": {
      "type": "UserManaged",
      "keyVaultMetaInfo": {
        "keyVaultResourceId": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
        "encryptionKeyName": "test_encryption_key_name",
        "encryptionKeyVersion": "encryption_key_version"
      }
    },
    "firewallState": "Enabled",
    "firewallRules": [
      {
        "id": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
        "name": "test_rule",
        "type": "test_type",
        "properties": {
          "startIpAddress": "1.1.1.1",
          "endIpAddress": "2.2.2.2"
        }
      }
    ],
    "trustedIdProviderState": "Enabled",
    "trustedIdProviders": [
      {
        "id": "34adfa4f-cedf-4dc0-ba29-b6d1a69ab345",
        "name": "test_trusted_id_provider_name",
        "type": "test_type",
        "properties": {
          "idProvider": "https://sts.windows.net/ea9ec534-a3e3-4e45-ad36-3afc5bb291c1"
        }
      }
    ],
    "defaultGroup": "test_default_group",
    "newTier": "Consumption",
    "currentTier": "Consumption",
    "firewallAllowAzureIps": "Enabled"
  }
}

定义

名称	说明
CreateDataLakeStoreAccountParameters
CreateFirewallRuleWithAccountParameters	用于创建新 Data Lake Store 帐户时创建新防火墙规则的参数。
CreateTrustedIdProviderWithAccountParameters	在创建新的 Data Lake Store 帐户时用于创建新的受信任标识提供者的参数。
CreateVirtualNetworkRuleWithAccountParameters	用于创建新 Data Lake Store 帐户时创建新虚拟网络规则的参数。
DataLakeStoreAccount	Data Lake Store 帐户信息。
DataLakeStoreAccountState	Data Lake Store 帐户的状态。
DataLakeStoreAccountStatus	Data Lake Store 帐户的预配状态。
EncryptionConfig	帐户的加密配置。
EncryptionConfigType	正在使用的加密配置的类型。目前唯一支持的类型是“UserManaged”和“ServiceManaged”。
EncryptionIdentity	加密标识属性。
EncryptionIdentityType	正在使用的加密类型。目前唯一受支持的类型是“SystemAssigned”。
EncryptionProvisioningState	此 Data Lake Store 帐户的加密预配的当前状态。
EncryptionState	此 Data Lake Store 帐户的当前加密状态。
FirewallAllowAzureIpsState	允许或禁止通过防火墙在 Azure 中发起的 IP 的当前状态。如果防火墙已禁用，则不会强制实施。
FirewallRule	Data Lake Store 防火墙规则信息。
FirewallState	此 Data Lake Store 帐户的 IP 地址防火墙的当前状态。
KeyVaultMetaInfo	帐户加密使用的元数据信息。
TierType	下个月要使用的承诺层。
TrustedIdProvider	Data Lake Store 受信任的标识提供者信息。
TrustedIdProviderState	此 Data Lake Store 帐户的受信任标识提供者功能的当前状态。
VirtualNetworkRule	Data Lake Store 虚拟网络规则信息。

CreateDataLakeStoreAccountParameters

Object

名称	类型	说明
identity	EncryptionIdentity	Key Vault 加密标识（如果有）。
location	string	资源位置。
properties.defaultGroup	string	Data Lake Store 帐户中创建的所有新文件夹和文件的默认所有者组。
properties.encryptionConfig	EncryptionConfig	Key Vault 加密配置。
properties.encryptionState	EncryptionState	此 Data Lake Store 帐户的当前加密状态。
properties.firewallAllowAzureIps	FirewallAllowAzureIpsState	允许或禁止通过防火墙在 Azure 中发起的 IP 的当前状态。如果防火墙已禁用，则不会强制实施。
properties.firewallRules	CreateFirewallRuleWithAccountParameters[]	与此 Data Lake Store 帐户关联的防火墙规则列表。
properties.firewallState	FirewallState	此 Data Lake Store 帐户的 IP 地址防火墙的当前状态。
properties.newTier	TierType	下个月要使用的承诺层。
properties.trustedIdProviderState	TrustedIdProviderState	此 Data Lake Store 帐户的受信任标识提供者功能的当前状态。
properties.trustedIdProviders	CreateTrustedIdProviderWithAccountParameters[]	与此 Data Lake Store 帐户关联的受信任标识提供者列表。
properties.virtualNetworkRules	CreateVirtualNetworkRuleWithAccountParameters[]	与此 Data Lake Store 帐户关联的虚拟网络规则列表。
tags	object	资源标记。

CreateFirewallRuleWithAccountParameters

Object

用于创建新 Data Lake Store 帐户时创建新防火墙规则的参数。

名称	类型	说明
name	string	要创建的防火墙规则的唯一名称。
properties.endIpAddress	string	防火墙规则的结束 IP 地址。这可以是 ipv4 或 ipv6。 “开始”和“结束”应位于同一协议中。
properties.startIpAddress	string	防火墙规则的起始 IP 地址。这可以是 ipv4 或 ipv6。 “开始”和“结束”应位于同一协议中。

CreateTrustedIdProviderWithAccountParameters

Object

在创建新的 Data Lake Store 帐户时用于创建新的受信任标识提供者的参数。

名称	类型	说明
name	string	要创建的受信任标识提供者的唯一名称。
properties.idProvider	string	此受信任的标识提供者的 URL。

CreateVirtualNetworkRuleWithAccountParameters

Object

用于创建新 Data Lake Store 帐户时创建新虚拟网络规则的参数。

名称	类型	说明
name	string	要创建的虚拟网络规则的唯一名称。
properties.subnetId	string	子网的资源标识符。

DataLakeStoreAccount

Object

Data Lake Store 帐户信息。

名称	类型	说明
id	string	资源标识符。
identity	EncryptionIdentity	Key Vault 加密标识（如果有）。
location	string	资源位置。
name	string	资源名称。
properties.accountId	string (uuid)	与此 Data Lake Store 帐户关联的唯一标识符。
properties.creationTime	string (date-time)	帐户创建时间。
properties.currentTier	TierType	用于本月的承诺层。
properties.defaultGroup	string	Data Lake Store 帐户中创建的所有新文件夹和文件的默认所有者组。
properties.encryptionConfig	EncryptionConfig	Key Vault 加密配置。
properties.encryptionProvisioningState	EncryptionProvisioningState	此 Data Lake Store 帐户的加密预配的当前状态。
properties.encryptionState	EncryptionState	此 Data Lake Store 帐户的当前加密状态。
properties.endpoint	string	此帐户的完整 CName 终结点。
properties.firewallAllowAzureIps	FirewallAllowAzureIpsState	允许或禁止通过防火墙在 Azure 中发起的 IP 的当前状态。如果防火墙已禁用，则不会强制实施。
properties.firewallRules	FirewallRule[]	与此 Data Lake Store 帐户关联的防火墙规则列表。
properties.firewallState	FirewallState	此 Data Lake Store 帐户的 IP 地址防火墙的当前状态。
properties.lastModifiedTime	string (date-time)	上次修改时间的帐户。
properties.newTier	TierType	下个月要使用的承诺层。
properties.provisioningState	DataLakeStoreAccountStatus	Data Lake Store 帐户的预配状态。
properties.state	DataLakeStoreAccountState	Data Lake Store 帐户的状态。
properties.trustedIdProviderState	TrustedIdProviderState	此 Data Lake Store 帐户的受信任标识提供者功能的当前状态。
properties.trustedIdProviders	TrustedIdProvider[]	与此 Data Lake Store 帐户关联的受信任标识提供者列表。
properties.virtualNetworkRules	VirtualNetworkRule[]	与此 Data Lake Store 帐户关联的虚拟网络规则列表。
tags	object	资源标记。
type	string	资源类型。

DataLakeStoreAccountState

枚举

Data Lake Store 帐户的状态。

值	说明
Active
Suspended

DataLakeStoreAccountStatus

枚举

Data Lake Store 帐户的预配状态。

值	说明
Failed
Creating
Running
Succeeded
Patching
Suspending
Resuming
Deleting
Deleted
Undeleting
Canceled

EncryptionConfig

Object

帐户的加密配置。

名称	类型	说明
keyVaultMetaInfo	KeyVaultMetaInfo	用于连接到用户托管加密密钥的 Key Vault 信息。
type	EncryptionConfigType	正在使用的加密配置的类型。目前唯一支持的类型是“UserManaged”和“ServiceManaged”。

EncryptionConfigType

枚举

正在使用的加密配置的类型。目前唯一支持的类型是“UserManaged”和“ServiceManaged”。

值	说明
UserManaged
ServiceManaged

EncryptionIdentity

Object

加密标识属性。

名称	类型	说明
principalId	string (uuid)	与加密关联的主体标识符。
tenantId	string (uuid)	与加密关联的租户标识符。
type	EncryptionIdentityType	正在使用的加密类型。目前唯一受支持的类型是“SystemAssigned”。

EncryptionIdentityType

枚举

正在使用的加密类型。目前唯一受支持的类型是“SystemAssigned”。

值	说明
SystemAssigned

EncryptionProvisioningState

枚举

此 Data Lake Store 帐户的加密预配的当前状态。

值	说明
Creating
Succeeded

EncryptionState

枚举

此 Data Lake Store 帐户的当前加密状态。

值	说明
Enabled
Disabled

FirewallAllowAzureIpsState

枚举

允许或禁止通过防火墙在 Azure 中发起的 IP 的当前状态。如果防火墙已禁用，则不会强制实施。

值	说明
Enabled
Disabled

FirewallRule

Object

Data Lake Store 防火墙规则信息。

名称	类型	说明
id	string	资源标识符。
name	string	资源名称。
properties.endIpAddress	string	防火墙规则的结束 IP 地址。这可以是 ipv4 或 ipv6。 “开始”和“结束”应位于同一协议中。
properties.startIpAddress	string	防火墙规则的起始 IP 地址。这可以是 ipv4 或 ipv6。 “开始”和“结束”应位于同一协议中。
type	string	资源类型。

FirewallState

枚举

此 Data Lake Store 帐户的 IP 地址防火墙的当前状态。

值	说明
Enabled
Disabled

KeyVaultMetaInfo

Object

帐户加密使用的元数据信息。

名称	类型	说明
encryptionKeyName	string	用户托管加密密钥的名称。
encryptionKeyVersion	string	用户托管加密密钥的版本。
keyVaultResourceId	string	用于加密的用户托管 Key Vault 的资源标识符。

TierType

枚举

下个月要使用的承诺层。

值	说明
Consumption
Commitment_1TB
Commitment_10TB
Commitment_100TB
Commitment_500TB
Commitment_1PB
Commitment_5PB

TrustedIdProvider

Object

Data Lake Store 受信任的标识提供者信息。

名称	类型	说明
id	string	资源标识符。
name	string	资源名称。
properties.idProvider	string	此受信任的标识提供者的 URL。
type	string	资源类型。

TrustedIdProviderState

枚举

此 Data Lake Store 帐户的受信任标识提供者功能的当前状态。

值	说明
Enabled
Disabled

VirtualNetworkRule

Object

Data Lake Store 虚拟网络规则信息。

名称	类型	说明
id	string	资源标识符。
name	string	资源名称。
properties.subnetId	string	子网的资源标识符。
type	string	资源类型。