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

Accounts - Create

创建指定的 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

密钥保管库加密标识(如果有)。

properties.defaultGroup

string

Data Lake Store 帐户中创建的所有新文件夹和文件的默认所有者组。

properties.encryptionConfig

EncryptionConfig

密钥保管库加密配置。

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 流

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

Scopes

名称 说明
user_impersonation 模拟用户帐户

示例

Creates the specified Data Lake Store account

Sample Request

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"
  }
}

Sample Response

{
  "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"
  }
}
{
  "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

名称 类型 说明
identity

EncryptionIdentity

密钥保管库加密标识(如果有)。

location

string

资源位置。

properties.defaultGroup

string

Data Lake Store 帐户中创建的所有新文件夹和文件的默认所有者组。

properties.encryptionConfig

EncryptionConfig

密钥保管库加密配置。

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

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

名称 类型 说明
name

string

要创建的防火墙规则的唯一名称。

properties.endIpAddress

string

防火墙规则的结束 IP 地址。 这可以是 ipv4 或 ipv6。 Start 和 End 应位于同一协议中。

properties.startIpAddress

string

防火墙规则的起始 IP 地址。 这可以是 ipv4 或 ipv6。 Start 和 End 应位于同一协议中。

CreateTrustedIdProviderWithAccountParameters

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

名称 类型 说明
name

string

要创建的受信任标识提供者的唯一名称。

properties.idProvider

string

此受信任标识提供者的 URL。

CreateVirtualNetworkRuleWithAccountParameters

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

名称 类型 说明
name

string

要创建的虚拟网络规则的唯一名称。

properties.subnetId

string

子网的资源标识符。

DataLakeStoreAccount

Data Lake Store 帐户信息。

名称 类型 说明
id

string

资源标识符。

identity

EncryptionIdentity

密钥保管库加密标识(如果有)。

location

string

资源位置。

name

string

资源名称。

properties.accountId

string

与此 Data Lake Store 帐户关联的唯一标识符。

properties.creationTime

string

帐户创建时间。

properties.currentTier

TierType

当前月份使用的承诺层。

properties.defaultGroup

string

Data Lake Store 帐户中创建的所有新文件夹和文件的默认所有者组。

properties.encryptionConfig

EncryptionConfig

密钥保管库加密配置。

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

帐户上次修改时间。

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

string

Suspended

string

DataLakeStoreAccountStatus

Data Lake Store 帐户的预配状态。

名称 类型 说明
Canceled

string

Creating

string

Deleted

string

Deleting

string

Failed

string

Patching

string

Resuming

string

Running

string

Succeeded

string

Suspending

string

Undeleting

string

EncryptionConfig

帐户的加密配置。

名称 类型 说明
keyVaultMetaInfo

KeyVaultMetaInfo

密钥保管库用于连接到用户管理的加密密钥的信息。

type

EncryptionConfigType

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

EncryptionConfigType

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

名称 类型 说明
ServiceManaged

string

UserManaged

string

EncryptionIdentity

加密标识属性。

名称 类型 说明
principalId

string

与加密关联的主体标识符。

tenantId

string

与加密关联的租户标识符。

type

EncryptionIdentityType

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

EncryptionIdentityType

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

名称 类型 说明
SystemAssigned

string

EncryptionProvisioningState

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

名称 类型 说明
Creating

string

Succeeded

string

EncryptionState

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

名称 类型 说明
Disabled

string

Enabled

string

FirewallAllowAzureIpsState

允许或禁止通过防火墙在 Azure 中源自的 IP 的当前状态。 如果防火墙处于禁用状态,则不会强制执行此操作。

名称 类型 说明
Disabled

string

Enabled

string

FirewallRule

Data Lake Store 防火墙规则信息。

名称 类型 说明
id

string

资源标识符。

name

string

资源名称。

properties.endIpAddress

string

防火墙规则的结束 IP 地址。 这可以是 ipv4 或 ipv6。 Start 和 End 应位于同一协议中。

properties.startIpAddress

string

防火墙规则的起始 IP 地址。 这可以是 ipv4 或 ipv6。 Start 和 End 应位于同一协议中。

type

string

资源类型。

FirewallState

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

名称 类型 说明
Disabled

string

Enabled

string

KeyVaultMetaInfo

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

名称 类型 说明
encryptionKeyName

string

用户管理的加密密钥的名称。

encryptionKeyVersion

string

用户管理的加密密钥的版本。

keyVaultResourceId

string

用于加密的用户托管密钥保管库的资源标识符。

TierType

用于下个月的承诺层。

名称 类型 说明
Commitment_100TB

string

Commitment_10TB

string

Commitment_1PB

string

Commitment_1TB

string

Commitment_500TB

string

Commitment_5PB

string

Consumption

string

TrustedIdProvider

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

名称 类型 说明
id

string

资源标识符。

name

string

资源名称。

properties.idProvider

string

此受信任标识提供者的 URL。

type

string

资源类型。

TrustedIdProviderState

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

名称 类型 说明
Disabled

string

Enabled

string

VirtualNetworkRule

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

名称 类型 说明
id

string

资源标识符。

name

string

资源名称。

properties.subnetId

string

子网的资源标识符。

type

string

资源类型。