check Aml FS Subnets - check Aml FS Subnets

Layanan:: Storagecache

Versi API:: 2026-01-01

Periksa apakah subnet akan valid untuk sistem file AML membuat panggilan.

POST https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/checkAmlFSSubnets?api-version=2026-01-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
subscriptionId	path	True	string minLength: 1	ID langganan target.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.

Isi Permintaan

Nama	Jenis	Deskripsi
filesystemSubnet	string	Subnet yang digunakan untuk mengelola sistem file AML dan untuk operasi yang menghadap klien. Subnet ini harus memiliki setidaknya subnet mask /24 dalam ruang alamat VNET.
location	string	Wilayah tempat sistem file AML akan dibuat.
sku	SkuName	SKU untuk sumber daya.
storageCapacityTiB	number (float)	Ukuran sistem file AML, di TiB.

Respons

Nama	Jenis	Deskripsi
200 OK		Permintaan telah berhasil.
400 Bad Request	AmlFilesystemCheckSubnetError	Detail kesalahan yang diberikan ketika panggilan checkAmlFSSubnets gagal.
Other Status Codes	CloudError	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

checkAmlFSSubnets

Permintaan sampel

POST https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.StorageCache/checkAmlFSSubnets?api-version=2026-01-01

{
  "filesystemSubnet": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/fsSub",
  "sku": {
    "name": "AMLFS-Durable-Premium-125"
  },
  "storageCapacityTiB": 16
}


import com.azure.resourcemanager.storagecache.models.AmlFilesystemSubnetInfo;
import com.azure.resourcemanager.storagecache.models.SkuName;

/**
 * Samples for ResourceProvider CheckAmlFSSubnets.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-01-01/checkAmlFSSubnets.json
     */
    /**
     * Sample code: checkAmlFSSubnets.
     * 
     * @param manager Entry point to StorageCacheManager.
     */
    public static void checkAmlFSSubnets(com.azure.resourcemanager.storagecache.StorageCacheManager manager) {
        manager.resourceProviders().checkAmlFSSubnetsWithResponse(new AmlFilesystemSubnetInfo().withFilesystemSubnet(
            "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/fsSub")
            .withStorageCapacityTiB(16.0F).withSku(new SkuName().withName("AMLFS-Durable-Premium-125")),
            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 armstoragecache_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/storagecache/armstoragecache/v4"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/3ca2244e6becf79bdd1198e9d66f0e8e8d3a0977/specification/storagecache/resource-manager/Microsoft.StorageCache/StorageCache/stable/2026-01-01/examples/checkAmlFSSubnets.json
func ExampleManagementClient_CheckAmlFSSubnets() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armstoragecache.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	_, err = clientFactory.NewManagementClient().CheckAmlFSSubnets(ctx, &armstoragecache.ManagementClientCheckAmlFSSubnetsOptions{AmlFilesystemSubnetInfo: &armstoragecache.AmlFilesystemSubnetInfo{
		FilesystemSubnet: to.Ptr("/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/fsSub"),
		SKU: &armstoragecache.SKUName{
			Name: to.Ptr("AMLFS-Durable-Premium-125"),
		},
		StorageCapacityTiB: to.Ptr[float32](16),
	},
	})
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
}

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

const { StorageCacheManagementClient } = require("@azure/arm-storagecache");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to Check that subnets will be valid for AML file system create calls.
 *
 * @summary Check that subnets will be valid for AML file system create calls.
 * x-ms-original-file: specification/storagecache/resource-manager/Microsoft.StorageCache/StorageCache/stable/2026-01-01/examples/checkAmlFSSubnets.json
 */
async function checkAmlFsSubnets() {
  const subscriptionId =
    process.env["STORAGECACHE_SUBSCRIPTION_ID"] || "00000000-0000-0000-0000-000000000000";
  const amlFilesystemSubnetInfo = {
    filesystemSubnet:
      "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/fsSub",
    sku: { name: "AMLFS-Durable-Premium-125" },
    storageCapacityTiB: 16,
  };
  const options = { amlFilesystemSubnetInfo };
  const credential = new DefaultAzureCredential();
  const client = new StorageCacheManagementClient(credential, subscriptionId);
  const result = await client.checkAmlFSSubnets(options);
  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.Resources;
using Azure.ResourceManager.StorageCache.Models;
using Azure.ResourceManager.StorageCache;

// Generated from example definition: specification/storagecache/resource-manager/Microsoft.StorageCache/StorageCache/stable/2026-01-01/examples/checkAmlFSSubnets.json
// this example is just showing the usage of "CheckAmlFSSubnets" 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 = "00000000-0000-0000-0000-000000000000";
ResourceIdentifier subscriptionResourceId = SubscriptionResource.CreateResourceIdentifier(subscriptionId);
SubscriptionResource subscriptionResource = client.GetSubscriptionResource(subscriptionResourceId);

// invoke the operation
AmlFileSystemSubnetContent content = new AmlFileSystemSubnetContent
{
    FilesystemSubnet = "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/fsSub",
    StorageCapacityTiB = 16,
    SkuName = "AMLFS-Durable-Premium-125",
};
await subscriptionResource.CheckAmlFSSubnetsAsync(content: content);

Console.WriteLine("Succeeded");

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

Respon sampel

Kode status:: 200

Kode status:: 400

{
  "filesystemSubnet": {
    "message": "A subnet with a minimum size of /24 is required.",
    "status": "Invalid"
  }
}

Definisi

Nama	Deskripsi
AmlFilesystemCheckSubnetError	Detail kesalahan yang diberikan ketika panggilan checkAmlFSSubnets gagal.
AmlFilesystemCheckSubnetErrorFilesystemSubnet	Detail kesalahan untuk subnet sistem file AML.
AmlFilesystemSubnetInfo	Informasi yang diperlukan untuk memvalidasi subnet yang akan digunakan dalam pembuatan sistem file AML
CloudError	Respons kesalahan.
CloudErrorBody	Respons kesalahan.
FilesystemSubnetStatusType	Status pemeriksaan subnet sistem file AML.
SkuName	SKU untuk sumber daya.

AmlFilesystemCheckSubnetError

Objek

Detail kesalahan yang diberikan ketika panggilan checkAmlFSSubnets gagal.

Nama	Jenis	Deskripsi
filesystemSubnet	AmlFilesystemCheckSubnetErrorFilesystemSubnet	Detail kesalahan untuk subnet sistem file AML.

AmlFilesystemCheckSubnetErrorFilesystemSubnet

Objek

Detail kesalahan untuk subnet sistem file AML.

Nama	Jenis	Deskripsi
message	string	Detail pemeriksaan subnet sistem file AML.
status	FilesystemSubnetStatusType	Status pemeriksaan subnet sistem file AML.

AmlFilesystemSubnetInfo

Objek

Informasi yang diperlukan untuk memvalidasi subnet yang akan digunakan dalam pembuatan sistem file AML

Nama	Jenis	Deskripsi
filesystemSubnet	string	Subnet yang digunakan untuk mengelola sistem file AML dan untuk operasi yang menghadap klien. Subnet ini harus memiliki setidaknya subnet mask /24 dalam ruang alamat VNET.
location	string	Wilayah tempat sistem file AML akan dibuat.
sku	SkuName	SKU untuk sumber daya.
storageCapacityTiB	number (float)	Ukuran sistem file AML, di TiB.

CloudError

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
error	CloudErrorBody	Isi kesalahan.

CloudErrorBody

Objek

Respons kesalahan.

Nama	Jenis	Deskripsi
code	string	Pengidentifikasi untuk kesalahan. Kode invarian dan dimaksudkan untuk dikonsumsi secara terprogram.
details	CloudErrorBody[]	Daftar detail tambahan tentang kesalahan.
message	string	Pesan yang menjelaskan kesalahan, dimaksudkan agar cocok untuk ditampilkan di antarmuka pengguna.
target	string	Target kesalahan tertentu. Misalnya, nama properti dalam kesalahan.

FilesystemSubnetStatusType

Enumerasi

Status pemeriksaan subnet sistem file AML.

Nilai	Deskripsi
Ok	Oke
Invalid	Tidak valid

SkuName

Objek

SKU untuk sumber daya.

Nama	Jenis	Deskripsi
name	string	Nama SKU untuk sumber daya ini.