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

NetApp Resource - Check Quota Availability

参考

服务:: Azure NetApp Files

API 版本:: 2024-07-01

检查配额可用性
检查配额是否可用。

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.NetApp/locations/{location}/checkQuotaAvailability?api-version=2024-07-01

URI 参数

名称	在	必需	类型	说明
location	path	True	string	Azure 区域的名称。
subscriptionId	path	True	string uuid	目标订阅的 ID。该值必须是 UUID。
api-version	query	True	string	用于此操作的 API 版本。

请求正文

名称	必需	类型	说明
name	True	string	要验证的资源的名称。
resourceGroup	True	string	资源组名称。
type	True	CheckQuotaNameResourceTypes	用于验证的资源类型。

响应

名称	类型	说明
200 OK	CheckAvailabilityResponse	还行
Other Status Codes	ErrorResponse	描述操作失败的原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

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

作用域

名称	说明
user_impersonation	模拟用户帐户

示例

CheckQuotaAvailability

示例请求

POST https://management.azure.com/subscriptions/D633CC2E-722B-4AE1-B636-BBD9E4C60ED9/providers/Microsoft.NetApp/locations/eastus/checkQuotaAvailability?api-version=2024-07-01

{
  "name": "resource1",
  "type": "Microsoft.NetApp/netAppAccounts",
  "resourceGroup": "myRG"
}


import com.azure.resourcemanager.netapp.models.CheckQuotaNameResourceTypes;
import com.azure.resourcemanager.netapp.models.QuotaAvailabilityRequest;

/**
 * Samples for NetAppResource CheckQuotaAvailability.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/CheckQuotaAvailability.json
     */
    /**
     * Sample code: CheckQuotaAvailability.
     * 
     * @param manager Entry point to NetAppFilesManager.
     */
    public static void checkQuotaAvailability(com.azure.resourcemanager.netapp.NetAppFilesManager manager) {
        manager.netAppResources().checkQuotaAvailabilityWithResponse("eastus",
            new QuotaAvailabilityRequest().withName("resource1")
                .withType(CheckQuotaNameResourceTypes.MICROSOFT_NET_APP_NET_APP_ACCOUNTS).withResourceGroup("myRG"),
            com.azure.core.util.Context.NONE);
    }
}

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/v7"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/366aaa13cdd218b9adac716680e49473673410c8/specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/CheckQuotaAvailability.json
func ExampleResourceClient_CheckQuotaAvailability() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armnetapp.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewResourceClient().CheckQuotaAvailability(ctx, "eastus", armnetapp.QuotaAvailabilityRequest{
		Name:          to.Ptr("resource1"),
		Type:          to.Ptr(armnetapp.CheckQuotaNameResourceTypesMicrosoftNetAppNetAppAccounts),
		ResourceGroup: to.Ptr("myRG"),
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.CheckAvailabilityResponse = armnetapp.CheckAvailabilityResponse{
	// 	IsAvailable: to.Ptr(true),
	// }
}

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 Check if a quota is available.
 *
 * @summary Check if a quota is available.
 * x-ms-original-file: specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/CheckQuotaAvailability.json
 */
async function checkQuotaAvailability() {
  const subscriptionId =
    process.env["NETAPP_SUBSCRIPTION_ID"] || "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9";
  const location = "eastus";
  const name = "resource1";
  const typeParam = "Microsoft.NetApp/netAppAccounts";
  const resourceGroup = "myRG";
  const credential = new DefaultAzureCredential();
  const client = new NetAppManagementClient(credential, subscriptionId);
  const result = await client.netAppResource.checkQuotaAvailability(
    location,
    name,
    typeParam,
    resourceGroup,
  );
  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.Resources;
using Azure.ResourceManager.NetApp;

// Generated from example definition: specification/netapp/resource-manager/Microsoft.NetApp/stable/2024-07-01/examples/CheckQuotaAvailability.json
// this example is just showing the usage of "NetAppResource_CheckQuotaAvailability" 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 SubscriptionResource created on azure
// for more information of creating SubscriptionResource, please refer to the document of SubscriptionResource
string subscriptionId = "D633CC2E-722B-4AE1-B636-BBD9E4C60ED9";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation
AzureLocation location = new AzureLocation("eastus");
NetAppQuotaAvailabilityContent content = new NetAppQuotaAvailabilityContent("resource1", NetAppQuotaAvailabilityResourceType.MicrosoftNetAppNetAppAccounts, "myRG");
NetAppCheckAvailabilityResult result = await subscriptionResource.CheckNetAppQuotaAvailabilityAsync(location, content);

Console.WriteLine($"Succeeded: {result}");

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

示例响应

状态代码:: 200

{
  "isAvailable": true
}

定义

名称	说明
CheckAvailabilityResponse	有关资源可用性的信息。
CheckQuotaNameResourceTypes	用于验证的资源类型。
ErrorAdditionalInfo	资源管理错误附加信息。
ErrorDetail	错误详细信息。
ErrorResponse	错误响应
InAvailabilityReasonType	`Invalid` 指示提供的名称与 Azure 应用服务命名要求不匹配。 `AlreadyExists` 指示名称已在使用中，因此不可用。
QuotaAvailabilityRequest	配额可用性请求内容。

CheckAvailabilityResponse

有关资源可用性的信息。

名称	类型	说明
isAvailable	boolean	`true` 指示名称有效且可用。 `false` 指示名称无效、不可用或两者均无效。
message	string	如果 reason == 无效，请向用户提供给定名称无效的原因，并提供资源命名要求，以便用户可以选择有效的名称。如果原因 == AlreadyExists，请解释资源名称已在使用中，并指示它们选择其他名称。
reason	InAvailabilityReasonType	`Invalid` 指示提供的名称与 Azure 应用服务命名要求不匹配。 `AlreadyExists` 指示名称已在使用中，因此不可用。

CheckQuotaNameResourceTypes

用于验证的资源类型。

名称	类型	说明
Microsoft.NetApp/netAppAccounts	string
Microsoft.NetApp/netAppAccounts/capacityPools	string
Microsoft.NetApp/netAppAccounts/capacityPools/volumes	string
Microsoft.NetApp/netAppAccounts/capacityPools/volumes/snapshots	string

ErrorAdditionalInfo

资源管理错误附加信息。

名称	类型	说明
info	object	其他信息。
type	string	其他信息类型。

ErrorDetail

错误详细信息。

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

ErrorResponse

错误响应

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

InAvailabilityReasonType

Invalid 指示提供的名称与 Azure 应用服务命名要求不匹配。 AlreadyExists 指示名称已在使用中，因此不可用。

名称	类型	说明
AlreadyExists	string
Invalid	string

QuotaAvailabilityRequest

配额可用性请求内容。

名称	类型	说明
name	string	要验证的资源的名称。
resourceGroup	string	资源组名称。
type	CheckQuotaNameResourceTypes	用于验证的资源类型。

通过

NetApp Resource - Check Quota Availability

URI 参数

请求正文

响应

安全性

azure_auth

作用域

示例

CheckQuotaAvailability

示例请求

示例响应

定义

CheckAvailabilityResponse

CheckQuotaNameResourceTypes

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

InAvailabilityReasonType

QuotaAvailabilityRequest

其他资源