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

Caches - Create Or Update

服务:: Azure NetApp Files

API 版本:: 2025-09-01-preview

在容量池中创建或更新指定的缓存

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.NetApp/netAppAccounts/{accountName}/capacityPools/{poolName}/caches/{cacheName}?api-version=2025-09-01-preview

URI 参数

名称	在	必需	类型	说明
accountName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$	NetApp 帐户的名称
cacheName	path	True	string minLength: 3 maxLength: 64 pattern: ^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$	缓存资源的名称。
poolName	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$	容量池的名称
resourceGroupName	path	True	string minLength: 1 maxLength: 90	资源组的名称。此名称不区分大小写。
subscriptionId	path	True	string (uuid)	目标订阅的 ID。该值必须是 UUID。
api-version	query	True	string minLength: 1	要用于此操作的 API 版本。

请求正文

名称	必需	类型	说明
location	True	string	资源所在的地理位置
properties	True	CacheProperties	缓存属性
tags		object	资源标记。
zones		string[]	可用性区域。

响应

名称

类型

说明

200 OK

资源“缓存”更新作成功

201 Created

资源“缓存”创建作成功

标头

Azure-AsyncOperation: string
Retry-After: integer

Other Status Codes

意外错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

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

作用域

名称	说明
user_impersonation	冒充您的用户帐户

示例

Caches_CreateOrUpdate

示例请求

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/caches/cache1?api-version=2025-09-01-preview

{
  "location": "eastus",
  "properties": {
    "filepath": "cache-west-us2-01",
    "size": 107374182400,
    "ldap": "Enabled",
    "ldapServerType": "OpenLDAP",
    "cacheSubnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1",
    "peeringSubnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1",
    "encryptionKeySource": "Microsoft.NetApp",
    "originClusterInformation": {
      "peerClusterName": "cluster1",
      "peerAddresses": [
        "192.0.2.10",
        "192.0.2.11"
      ],
      "peerVserverName": "vserver1",
      "peerVolumeName": "originvol1"
    }
  }
}


import com.azure.resourcemanager.netapp.models.CacheProperties;
import com.azure.resourcemanager.netapp.models.EncryptionKeySource;
import com.azure.resourcemanager.netapp.models.LdapServerType;
import com.azure.resourcemanager.netapp.models.LdapState;
import com.azure.resourcemanager.netapp.models.OriginClusterInformation;
import java.util.Arrays;

/**
 * Samples for Caches CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-09-01-preview/Caches_CreateOrUpdate.json
     */
    /**
     * Sample code: Caches_CreateOrUpdate.
     * 
     * @param manager Entry point to NetAppFilesManager.
     */
    public static void cachesCreateOrUpdate(com.azure.resourcemanager.netapp.NetAppFilesManager manager) {
        manager.caches().define("cache1").withRegion("eastus").withExistingCapacityPool("myRG", "account1", "pool1")
            .withProperties(new CacheProperties().withFilepath("cache-west-us2-01").withSize(107374182400L)
                .withCacheSubnetResourceId(
                    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1")
                .withPeeringSubnetResourceId(
                    "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1")
                .withEncryptionKeySource(EncryptionKeySource.MICROSOFT_NET_APP).withLdap(LdapState.ENABLED)
                .withLdapServerType(LdapServerType.OPEN_LDAP)
                .withOriginClusterInformation(new OriginClusterInformation().withPeerClusterName("cluster1")
                    .withPeerAddresses(Arrays.asList("192.0.2.10", "192.0.2.11")).withPeerVserverName("vserver1")
                    .withPeerVolumeName("originvol1")))
            .create();
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from azure.identity import DefaultAzureCredential

from azure.mgmt.netapp import NetAppManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-netapp
# USAGE
    python caches_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = NetAppManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="SUBSCRIPTION_ID",
    )

    response = client.caches.begin_create_or_update(
        resource_group_name="myRG",
        account_name="account1",
        pool_name="pool1",
        cache_name="cache1",
        body={
            "location": "eastus",
            "properties": {
                "cacheSubnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1",
                "encryptionKeySource": "Microsoft.NetApp",
                "filepath": "cache-west-us2-01",
                "ldap": "Enabled",
                "ldapServerType": "OpenLDAP",
                "originClusterInformation": {
                    "peerAddresses": ["192.0.2.10", "192.0.2.11"],
                    "peerClusterName": "cluster1",
                    "peerVolumeName": "originvol1",
                    "peerVserverName": "vserver1",
                },
                "peeringSubnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1",
                "size": 107374182400,
            },
        },
    ).result()
    print(response)


# x-ms-original-file: 2025-09-01-preview/Caches_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armnetapp_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/netapp/armnetapp/v8"
)

// Generated from example definition: 2025-09-01-preview/Caches_CreateOrUpdate.json
func ExampleCachesClient_BeginCreateOrUpdate() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armnetapp.NewClientFactory("00000000-0000-0000-0000-000000000000", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewCachesClient().BeginCreateOrUpdate(ctx, "myRG", "account1", "pool1", "cache1", armnetapp.Cache{
		Location: to.Ptr("eastus"),
		Properties: &armnetapp.CacheProperties{
			Filepath:                to.Ptr("cache-west-us2-01"),
			Size:                    to.Ptr[int64](107374182400),
			Ldap:                    to.Ptr(armnetapp.LdapStateEnabled),
			LdapServerType:          to.Ptr(armnetapp.LdapServerTypeOpenLDAP),
			CacheSubnetResourceID:   to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1"),
			PeeringSubnetResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1"),
			EncryptionKeySource:     to.Ptr(armnetapp.EncryptionKeySourceMicrosoftNetApp),
			OriginClusterInformation: &armnetapp.OriginClusterInformation{
				PeerClusterName: to.Ptr("cluster1"),
				PeerAddresses: []*string{
					to.Ptr("192.0.2.10"),
					to.Ptr("192.0.2.11"),
				},
				PeerVserverName: to.Ptr("vserver1"),
				PeerVolumeName:  to.Ptr("originvol1"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res = armnetapp.CachesClientCreateOrUpdateResponse{
	// 	Cache: &armnetapp.Cache{
	// 		ID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/caches/cache1"),
	// 		Name: to.Ptr("account1/pool1/cache1"),
	// 		Type: to.Ptr("Microsoft.NetApp/netAppAccounts/capacityPools/caches"),
	// 		Location: to.Ptr("eastus"),
	// 		Properties: &armnetapp.CacheProperties{
	// 			Filepath: to.Ptr("cache-west-us2-01"),
	// 			Size: to.Ptr[int64](214748364800),
	// 			ProvisioningState: to.Ptr(armnetapp.CacheProvisioningStateSucceeded),
	// 			CacheState: to.Ptr(armnetapp.CacheLifeCycleStateSucceeded),
	// 			CacheSubnetResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1"),
	// 			PeeringSubnetResourceID: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1"),
	// 			EncryptionKeySource: to.Ptr(armnetapp.EncryptionKeySourceMicrosoftNetApp),
	// 			OriginClusterInformation: &armnetapp.OriginClusterInformation{
	// 				PeerClusterName: to.Ptr("cluster1"),
	// 				PeerAddresses: []*string{
	// 					to.Ptr("192.0.2.10"),
	// 					to.Ptr("192.0.2.11"),
	// 				},
	// 				PeerVserverName: to.Ptr("vserver1"),
	// 				PeerVolumeName: to.Ptr("originvol1"),
	// 			},
	// 			CifsChangeNotifications: to.Ptr(armnetapp.CifsChangeNotifyStateDisabled),
	// 			GlobalFileLocking: to.Ptr(armnetapp.GlobalFileLockingStateDisabled),
	// 			WriteBack: to.Ptr(armnetapp.EnableWriteBackStateDisabled),
	// 			Ldap: to.Ptr(armnetapp.LdapStateEnabled),
	// 			LdapServerType: to.Ptr(armnetapp.LdapServerTypeOpenLDAP),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { NetAppManagementClient } = require("@azure/arm-netapp");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to create or update the specified Cache within the Capacity Pool
 *
 * @summary create or update the specified Cache within the Capacity Pool
 * x-ms-original-file: 2025-09-01-preview/Caches_CreateOrUpdate.json
 */
async function cachesCreateOrUpdate() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "00000000-0000-0000-0000-000000000000";
  const client = new NetAppManagementClient(credential, subscriptionId);
  const result = await client.caches.createOrUpdate("myRG", "account1", "pool1", "cache1", {
    location: "eastus",
    properties: {
      filepath: "cache-west-us2-01",
      size: 107374182400,
      ldap: "Enabled",
      ldapServerType: "OpenLDAP",
      cacheSubnetResourceId:
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1",
      peeringSubnetResourceId:
        "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1",
      encryptionKeySource: "Microsoft.NetApp",
      originClusterInformation: {
        peerClusterName: "cluster1",
        peerAddresses: ["192.0.2.10", "192.0.2.11"],
        peerVserverName: "vserver1",
        peerVolumeName: "originvol1",
      },
    },
  });
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.NetApp.Models;
using Azure.ResourceManager.NetApp;

// Generated from example definition: specification/netapp/resource-manager/Microsoft.NetApp/NetApp/preview/2025-09-01-preview/examples/Caches_CreateOrUpdate.json
// this example is just showing the usage of "Caches_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this CapacityPoolResource created on azure
// for more information of creating CapacityPoolResource, please refer to the document of CapacityPoolResource
string subscriptionId = "00000000-0000-0000-0000-000000000000";
string resourceGroupName = "myRG";
string accountName = "account1";
string poolName = "pool1";
ResourceIdentifier capacityPoolResourceId = CapacityPoolResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, accountName, poolName);
CapacityPoolResource capacityPool = client.GetCapacityPoolResource(capacityPoolResourceId);

// get the collection of this NetAppCacheResource
NetAppCacheCollection collection = capacityPool.GetNetAppCaches();

// invoke the operation
string cacheName = "cache1";
NetAppCacheData data = new NetAppCacheData(new AzureLocation("eastus"), new NetAppCacheProperties(
    "cache-west-us2-01",
    107374182400L,
    new ResourceIdentifier("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1"),
    new ResourceIdentifier("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1"),
    NetAppEncryptionKeySource.MicrosoftNetApp,
    new OriginClusterInformation("cluster1", new string[] { "192.0.2.10", "192.0.2.11" }, "vserver1", "originvol1"))
{
    Ldap = LdapState.Enabled,
    LdapServerType = LdapServerType.OpenLdap,
});
ArmOperation<NetAppCacheResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, cacheName, data);
NetAppCacheResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
NetAppCacheData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

示例响应

状态代码:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/caches/cache1",
  "name": "account1/pool1/cache1",
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/caches",
  "location": "eastus",
  "properties": {
    "filepath": "cache-west-us2-01",
    "size": 214748364800,
    "provisioningState": "Succeeded",
    "cacheState": "Succeeded",
    "cacheSubnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1",
    "peeringSubnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1",
    "encryptionKeySource": "Microsoft.NetApp",
    "originClusterInformation": {
      "peerClusterName": "cluster1",
      "peerAddresses": [
        "192.0.2.10",
        "192.0.2.11"
      ],
      "peerVserverName": "vserver1",
      "peerVolumeName": "originvol1"
    },
    "cifsChangeNotifications": "Disabled",
    "globalFileLocking": "Disabled",
    "writeBack": "Disabled",
    "ldap": "Enabled",
    "ldapServerType": "OpenLDAP"
  }
}

状态代码:: 201

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/caches/cache1",
  "name": "account1/pool1/cache1",
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/caches",
  "location": "eastus",
  "properties": {
    "filepath": "cache-west-us2-01",
    "size": 107374182400,
    "provisioningState": "Succeeded",
    "cacheState": "Creating",
    "cacheSubnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/cacheVnet/subnets/cacheSubnet1",
    "peeringSubnetResourceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRP/providers/Microsoft.Network/virtualNetworks/icLifVnet/subnets/peeringSubnet1",
    "encryptionKeySource": "Microsoft.NetApp",
    "originClusterInformation": {
      "peerClusterName": "cluster1",
      "peerAddresses": [
        "192.0.2.10",
        "192.0.2.11"
      ],
      "peerVserverName": "vserver1",
      "peerVolumeName": "originvol1"
    },
    "cifsChangeNotifications": "Disabled",
    "globalFileLocking": "Disabled",
    "writeBack": "Disabled",
    "ldap": "Enabled",
    "ldapServerType": "OpenLDAP"
  }
}

定义

名称	说明
Cache	缓存资源
CacheLifeCycleState	Azure NetApp 文件缓存生命周期管理
CacheMountTargetProperties	包含挂载缓存所需的所有信息
CacheProperties	缓存资源属性
CachePropertiesExportPolicy	导出策略规则集
CacheProvisioningState	Azure 生命周期管理
ChownMode	此参数指定有权更改文件的所有权的人员。受限 - 只有根用户可以更改文件的所有权。不受限制 - 非根用户可以更改其拥有的文件的所有权。
CifsChangeNotifyState	指示是否为缓存启用 CIFS 更改通知的标志。
createdByType	创建资源的标识的类型。
EnableWriteBackState	指示是否为缓存启用写回的标志。
EncryptionKeySource	用于加密卷中数据的密钥源。如果 NetApp 帐户具有 encryption.keySource = “Microsoft.KeyVault”，则适用。可能的值（不区分大小写）是：“Microsoft.NetApp，Microsoft.KeyVault”
EncryptionState	指定缓存是否加密。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
ExportPolicyRule	卷导出策略规则
GlobalFileLockingState	指示是否为缓存启用全局文件锁的标志。
KerberosState	描述缓存是否启用了 Kerberos。
LdapServerType	LDAP 服务器的类型
LdapState	指定是否启用 LDAP。
OriginClusterInformation	存储与缓存关联的源集群信息。
ProtocolTypes	支持的协议类型集合，包括NFSv3、NFSv4和SMB协议
SmbAccessBasedEnumeration	为 SMB 共享启用基于访问的枚举共享属性。仅适用于 SMB/DualProtocol 卷
SmbEncryptionState	为正在进行的 smb3 数据启用加密。仅适用于 SMB/DualProtocol 缓存
SmbNonBrowsable	为 SMB 共享启用不可浏览的属性。仅适用于 SMB/DualProtocol 卷
SmbSettings	缓存的 SMB 设置
systemData	与创建和上次修改资源相关的元数据。
VolumeLanguage	卷支持的语言。

Cache

对象

缓存资源

名称	类型	说明
etag	string	“如果在响应正文中提供了 etag，则也可以根据正常的 etag 约定将其作为标头提供。实体标记用于比较同一请求资源的两个或多个实体。 HTTP/1.1 在 etag（第 14.19 节）、If-Match（第 14.24 节）、If-None-Match（第 14.26 节）和 If-Range（第 14.27 节）标头字段中使用实体标签。
id	string (arm-id)	资源的完全限定资源 ID。例如，“/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}”
location	string	资源所在的地理位置
name	string	资源的名称
properties	CacheProperties	缓存属性
systemData	systemData	包含 createdBy 和 modifiedBy 信息的 Azure 资源管理器元数据。
tags	object	资源标记。
type	string	资源类型。例如，“Microsoft.Compute/virtualMachines”或“Microsoft.Storage/storageAccounts”
zones	string[]	可用性区域。

CacheLifeCycleState

枚举

Azure NetApp 文件缓存生命周期管理

值	说明
ClusterPeeringOfferSent	已发送群集对等互连产品/服务。
VserverPeeringOfferSent	VServer 对等互连产品/服务已发送。
Creating	正在创建缓存。
Succeeded	缓存创建成功，可供使用。
Failed	缓存处于失败状态

CacheMountTargetProperties

对象

包含挂载缓存所需的所有信息

名称	类型	说明
ipAddress	string	挂载目标的 IPv4 地址，用于挂载缓存。
mountTargetId	string minLength: 36 maxLength: 36 pattern: ^[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}$	用于标识 MountTarget 的 UUID v4
smbServerFqdn	string	SMB 服务器的完全限定域名 FQDN

CacheProperties

对象

缓存资源属性

名称	类型	说明
actualThroughputMibps	number (float)	根据大小和服务级别计算的自动 qosType 卷的实际吞吐量（以 MiB/s 为单位）
cacheState	CacheLifeCycleState	Azure NetApp 文件缓存生命周期管理
cacheSubnetResourceId	string (arm-id)	将用于分配数据 IP 的委派缓存子网的 Azure 资源 URI。
cifsChangeNotifications	CifsChangeNotifyState	指示是否为缓存启用 CIFS 更改通知的标志。
encryption	EncryptionState	指定缓存是否加密。
encryptionKeySource	EncryptionKeySource	用于加密缓存中数据的密钥源。如果 NetApp 帐户具有 encryption.keySource = “Microsoft.KeyVault”，则适用。可能的值（不区分大小写）是：“Microsoft.NetApp，Microsoft.KeyVault”
exportPolicy	CachePropertiesExportPolicy	导出策略规则集
filepath	string minLength: 1 maxLength: 80 pattern: ^[a-zA-Z][a-zA-Z0-9\-]{0,79}$	缓存的文件路径。
globalFileLocking	GlobalFileLockingState	指示是否为缓存启用全局文件锁的标志。
kerberos	KerberosState	描述缓存是否启用了 Kerberos。
keyVaultPrivateEndpointResourceId	string (arm-id)	KeyVault 的专用终结点的资源 ID。它必须与卷位于同一 VNET 中。仅当 encryptionKeySource = 'Microsoft.KeyVault' 时才适用。
language	VolumeLanguage	卷支持的语言。
ldap	LdapState	指定是否为 Flexcache 卷启用 LDAP。
ldapServerType	LdapServerType	指定 flexcache 卷的 LDAP 服务器类型。
maximumNumberOfFiles	integer (int64)	允许的最大文件数。
mountTargets	CacheMountTargetProperties[]	可用于挂载此缓存的挂载目标列表
originClusterInformation	OriginClusterInformation	源集群信息
peeringSubnetResourceId	string (arm-id)	将用于 ANF 群集间接口 IP 地址的委派子网的 Azure 资源 URI。
protocolTypes	ProtocolTypes[]	支持的协议类型集合，包括NFSv3、NFSv4和SMB协议
provisioningState	CacheProvisioningState	Azure 生命周期管理
size	integer (int64) minimum: 53687091200 maximum: 1125899906842624	文件系统允许的最大存储配额（以字节为单位）。有效值在 50GiB 到 1PiB 的范围内。以字节表示为 1GiB 的倍数的值。
smbSettings	SmbSettings	缓存的 SMB 信息
throughputMibps	number (float)	此缓存卷可以实现的最大吞吐量（以 MiB/s 为单位），并且仅接受为手动 qosType 缓存的输入
writeBack	EnableWriteBackState	指示是否为缓存启用写回的标志。

CachePropertiesExportPolicy

对象

导出策略规则集

名称	类型	说明
rules	ExportPolicyRule[]	导出策略规则

CacheProvisioningState

枚举

Azure 生命周期管理

值	说明
Creating	正在创建资源。
Updating	正在更新资源。
Deleting	正在删除资源。
Failed	资源处于失败状态。
Succeeded	资源成功。
Canceled	资源创建已取消。

ChownMode

枚举

此参数指定有权更改文件的所有权的人员。受限 - 只有根用户可以更改文件的所有权。不受限制 - 非根用户可以更改其拥有的文件的所有权。

值	说明
Restricted
Unrestricted

CifsChangeNotifyState

枚举

指示是否为缓存启用 CIFS 更改通知的标志。

值	说明
Disabled	CIFS 更改通知已禁用
Enabled	CIFS 更改通知已启用

createdByType

枚举

创建资源的标识的类型。

值	说明
User
Application
ManagedIdentity
Key

EnableWriteBackState

枚举

指示是否为缓存启用写回的标志。

值	说明
Disabled	已禁用写回缓存
Enabled	已启用写回缓存

EncryptionKeySource

枚举

用于加密卷中数据的密钥源。如果 NetApp 帐户具有 encryption.keySource = “Microsoft.KeyVault”，则适用。可能的值（不区分大小写）是：“Microsoft.NetApp，Microsoft.KeyVault”

值	说明
Microsoft.NetApp	Microsoft管理的密钥加密
Microsoft.KeyVault	客户管理的密钥加密

EncryptionState

枚举

指定缓存是否加密。

值	说明
Disabled	加密已禁用
Enabled	已启用加密

ErrorAdditionalInfo

对象

资源管理错误附加信息。

名称	类型	说明
info	object	附加信息。
type	string	附加信息类型。

ErrorDetail

对象

错误详细信息。

名称	类型	说明
additionalInfo	ErrorAdditionalInfo[]	错误附加信息。
code	string	错误代码。
details	ErrorDetail[]	错误详细信息。
message	string	错误消息。
target	string	错误目标。

ErrorResponse

对象

错误响应

名称	类型	说明
error	ErrorDetail	错误对象。

ExportPolicyRule

对象

卷导出策略规则

名称	类型	默认值	说明
allowedClients	string		客户端入口规范为逗号分隔字符串，带有 IPv4CIDR、IPv4 主机地址和主机名
chownMode	ChownMode	Restricted	此参数指定有权更改文件的所有权的人员。受限 - 只有根用户可以更改文件的所有权。不受限制 - 非根用户可以更改其拥有的文件的所有权。
cifs	boolean		允许 CIFS 协议
hasRootAccess	boolean	True	对卷具有根访问权限
kerberos5ReadOnly	boolean	False	Kerberos5 只读访问权限。与 swagger 版本 2020-05-01 或更高版本一起使用
kerberos5ReadWrite	boolean	False	Kerberos5 读取和写入访问权限。与 swagger 版本 2020-05-01 或更高版本一起使用
kerberos5iReadOnly	boolean	False	Kerberos5i 只读访问权限。与 swagger 版本 2020-05-01 或更高版本一起使用
kerberos5iReadWrite	boolean	False	Kerberos5i 读取和写入访问权限。与 swagger 版本 2020-05-01 或更高版本一起使用
kerberos5pReadOnly	boolean	False	Kerberos5p 只读访问权限。与 swagger 版本 2020-05-01 或更高版本一起使用
kerberos5pReadWrite	boolean	False	Kerberos5p 读取和写入访问权限。与 swagger 版本 2020-05-01 或更高版本一起使用
nfsv3	boolean		允许 NFSv3 协议。仅对 NFSv3 类型卷启用
nfsv41	boolean		允许 NFSv4.1 协议。仅对 NFSv4.1 类型卷启用
ruleIndex	integer (int32)		订单索引
unixReadOnly	boolean		只读访问权限
unixReadWrite	boolean		读取和写入访问权限

GlobalFileLockingState

枚举

指示是否为缓存启用全局文件锁的标志。

值	说明
Disabled	禁用全局文件锁定
Enabled	启用全局文件锁定

KerberosState

枚举

描述缓存是否启用了 Kerberos。

值	说明
Disabled	禁用 Kerberos
Enabled	已启用 Kerberos

LdapServerType

枚举

LDAP 服务器的类型

值	说明
ActiveDirectory	卷应使用 Active Directory 进行 LDAP 连接。
OpenLDAP	卷应使用 OpenLDAP 进行 LDAP 连接。

LdapState

枚举

指定是否启用 LDAP。

值	说明
Disabled	LDAP 已禁用。
Enabled	已启用 LDAP

OriginClusterInformation

对象

存储与缓存关联的源集群信息。

名称	类型	说明
peerAddresses	string[]	ONTAP 集群间 LIF IP 地址。每个集群节点需要一个 IP 地址
peerClusterName	string	托管源卷的外部集群的 ONTAP 集群名称
peerVolumeName	string	与此缓存关联的外部源卷名称
peerVserverName	string	外部虚拟服务器（SVM）名称托管源卷的 SVM 的名称

ProtocolTypes

枚举

支持的协议类型集合，包括NFSv3、NFSv4和SMB协议

值	说明
NFSv3	NFSv3 协议类型
NFSv4	NFSv4 协议类型
SMB	SMB 协议类型

SmbAccessBasedEnumeration

枚举

为 SMB 共享启用基于访问的枚举共享属性。仅适用于 SMB/DualProtocol 卷

值	说明
Disabled	smbAccessBasedEnumeration 共享设置已禁用
Enabled	smbAccessBasedEnumeration 共享设置已启用

SmbEncryptionState

枚举

为正在进行的 smb3 数据启用加密。仅适用于 SMB/DualProtocol 缓存

值	说明
Disabled	SMB 加密已禁用
Enabled	已启用 SMB 加密

SmbNonBrowsable

枚举

为 SMB 共享启用不可浏览的属性。仅适用于 SMB/DualProtocol 卷

值	说明
Disabled	smbNonBrowsable 共享设置已禁用
Enabled	已启用 smbNonBrowsable 共享设置

SmbSettings

对象

缓存的 SMB 设置

名称	类型	说明
smbAccessBasedEnumerations	SmbAccessBasedEnumeration	为 SMB 共享启用基于访问的枚举共享属性。仅适用于 SMB/DualProtocol 卷
smbEncryption	SmbEncryptionState	为正在进行的 smb3 数据启用加密。仅适用于 SMB/DualProtocol 缓存。
smbNonBrowsable	SmbNonBrowsable	为 SMB 共享启用不可浏览的属性。仅适用于 SMB/DualProtocol 卷

systemData

对象

与创建和上次修改资源相关的元数据。

名称	类型	说明
createdAt	string (date-time)	资源创建时间戳（UTC）。
createdBy	string	创建资源的标识。
createdByType	createdByType	创建资源的标识的类型。
lastModifiedAt	string (date-time)	资源上次修改的时间戳（UTC）
lastModifiedBy	string	上次修改资源的标识。
lastModifiedByType	createdByType	上次修改资源的标识的类型。

VolumeLanguage

枚举

卷支持的语言。

值	说明
c.utf-8	具有 UTF-8 的 Posix
utf8mb4	支持 4 字节字符的 UTF-8
ar	阿拉伯语 - 已弃用
ar.utf-8	带 UTF-8 的阿拉伯语
hr	克罗地亚语 - 已弃用
hr.utf-8	带 UTF-8 的克罗地亚语
cs	捷克语 - 已弃用
cs.utf-8	使用 UTF-8 的捷克
da	丹麦语 - 已弃用
da.utf-8	带 UTF-8 的丹麦语
nl	荷兰语 - 已弃用
nl.utf-8	带 UTF-8 的荷兰语
en	英语 - 已弃用
en.utf-8	UTF-8 英语
fi	芬兰语 - 已弃用
fi.utf-8	带 UTF-8 的芬兰语
fr	法语 - 已弃用
fr.utf-8	带有 UTF-8 的法语
de	德语 - 已弃用
de.utf-8	使用 UTF-8 的德语
he	希伯来语 - 已弃用
he.utf-8	带 UTF-8 的希伯来语
hu	匈牙利语 - 已弃用
hu.utf-8	带 UTF-8 的匈牙利语
it	意大利语 - 已弃用
it.utf-8	使用 UTF-8 的意大利语
ja	日语 euc-j - 已弃用
ja.utf-8	带有 UTF-8 的日语 euc-j
ja-v1	日语 euc-j - 已弃用
ja-v1.utf-8	带有 UTF-8 的日语 euc-j
ja-jp.pck	日语 pck
ja-jp.pck.utf-8	UTF-8 的日语 pck - 已弃用
ja-jp.932	日语 cp932
ja-jp.932.utf-8	带有 UTF-8 的日语 cp932 - 已弃用
ja-jp.pck-v2	日语 pck - sjis
ja-jp.pck-v2.utf-8	日语 pck - 带有 UTF-8 的 sjis - 已弃用
ko	朝鲜语 - 已弃用
ko.utf-8	使用 UTF-8 的朝鲜语
no	挪威语 - 已弃用
no.utf-8	使用 UTF-8 的挪威语
pl	波兰语 - 已弃用
pl.utf-8	使用 UTF-8 进行波兰
pt	葡萄牙语 - 已弃用
pt.utf-8	使用 UTF-8 的葡萄牙语
c	Posix - 已弃用
ro	罗马尼亚语 - 已弃用
ro.utf-8	带 UTF-8 的罗马尼亚语
ru	俄语 - 已弃用
ru.utf-8	使用 UTF-8 的俄语
zh	简体中文 - 已弃用
zh.utf-8	使用 UTF-8 的简体中文
zh.gbk	简体中文 gbk 中文
zh.gbk.utf-8	UTF-8 的简化 gbk 中文 - 已弃用
zh-tw.big5	繁体中文 BIG 5
zh-tw.big5.utf-8	带有 UTF-8 的传统中国 BIG 5 - 已弃用
zh-tw	繁体中文 EUC-TW
zh-tw.utf-8	使用 UTF-8 的繁体中文 EUC-TW - 已弃用
sk	斯洛伐克语 - 已弃用
sk.utf-8	带 UTF-8 的斯洛伐克语
sl	斯洛文尼亚语 - 已弃用
sl.utf-8	斯洛文尼亚语与 UTF-8
es	西班牙语 - 已弃用
es.utf-8	使用 UTF-8 的西班牙语
sv	瑞典语 - 已弃用
sv.utf-8	带 UTF-8 的瑞典语
tr	土耳其 - 已弃用
tr.utf-8	带 UTF-8 的土耳其
en-us	美国英语 - 已弃用
en-us.utf-8	UTF-8 美国英语