Buckets - List

Služba:: Azure NetApp Files

Verze rozhraní API:: 2025-09-01-preview

Popisuje všechny segmenty patřící do svazku. Segmenty umožňují dalším službám, jako jsou služby AI, připojit se k objemovým datům obsaženým v těchto kontejnerech.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
accountName	path	True	string pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,127}$	Název účtu NetApp
poolName	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9\-_]{0,63}$	Název fondu kapacity
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId	path	True	string (uuid)	ID cílového předplatného. Hodnota musí být UUID.
volumeName	path	True	string minLength: 1 maxLength: 64 pattern: ^[a-zA-Z][a-zA-Z0-9\-_]{0,63}$	Název svazku
api-version	query	True	string minLength: 1	Verze rozhraní API, která se má použít pro tuto operaci.

Odpovědi

Name	Typ	Description
200 OK	BucketList	Operace Azure byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2.

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name	Description
user_impersonation	vydávat se za váš uživatelský účet

Příklady

Buckets_List

Ukázkový požadavek

HTTP

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

Ukázková odpověď

Stavový kód:: 200

{
  "value": [
    {
      "name": "account1/pool1/volume1/bucket1",
      "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes/buckets",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myRG/providers/Microsoft.NetApp/netAppAccounts/account1/capacityPools/pool1/volumes/volume1/buckets/bucket1",
      "properties": {
        "path": "/path",
        "fileSystemUser": {
          "nfsUser": {
            "groupId": 1000,
            "userId": 1001
          }
        },
        "permissions": "ReadOnly",
        "provisioningState": "Succeeded",
        "server": {
          "certificateCommonName": "www.example.com",
          "certificateExpiryDate": "2027-08-15T13:23:32Z",
          "fqdn": "fullyqualified.domainname.com",
          "ipAddress": "1.2.3.4"
        },
        "status": "Active"
      }
    }
  ]
}

Definice

Name	Description
Bucket	Prostředek kbelíku
BucketList	Seznam prostředků kontejneru svazků svazků
BucketPermissions	Přístupová oprávnění pro segment. Buď ReadOnly, nebo ReadWrite. Výchozí hodnota je ReadOnly, pokud při vytváření kbelíku není zadána žádná hodnota.
BucketServerProperties	Vlastnosti serveru, který spravuje životní cyklus kontejnerů svazků
CifsUser	Efektivní uživatelské jméno CIFS při přístupu k datům svazku.
createdByType	Typ identity, která prostředek vytvořila.
CredentialsStatus	Stav přihlašovacích údajů kbelíku. Tam se uvádí: "NoCredentialsSet": Pár přístupového a tajného klíče nebyl vygenerován. "CredentialsExpired": Platnost páru přístupového a tajného klíče vypršela. "Aktivní": Certifikát byl nainstalován a platnost přihlašovacích údajů nevypršela.
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
FileSystemUser	Uživatel systému souborů má přístup k datům svazku. Pro Unix je to uid a gid uživatele. Pro Windows se jedná o uživatelské jméno uživatele. Všimněte si, že podrobnosti o uživatelích se systémem Unix a Windows se vzájemně vylučují, což znamená, že musí být zadána jedna nebo jiná, ale ne obě.
NetAppProvisioningState	Získá stav VolumeQuotaRule v době, kdy byla operace volána.
NfsUser	Platné ID uživatele systému souborů NFS a ID skupiny při přístupu k datům svazku.
systemData	Metadata týkající se vytvoření a poslední změny prostředku.

Bucket

Objekt

Prostředek kbelíku

Name	Typ	Default value	Description
id	string (arm-id)		Plně kvalifikované ID prostředku pro daný prostředek. Např. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string		Název prostředku
properties.fileSystemUser	FileSystemUser		Uživatel systému souborů má přístup k datům svazku. Pro Unix je to uid a gid uživatele. Pro Windows se jedná o uživatelské jméno uživatele. Všimněte si, že podrobnosti o uživatelích se systémem Unix a Windows se vzájemně vylučují, což znamená, že musí být zadána jedna nebo jiná, ale ne obě.
properties.path	string	/	Cesta svazku připojená uvnitř kontejneru. Výchozí hodnotou je kořenová cesta /, pokud při vytváření kontejneru není zadaná žádná hodnota.
properties.permissions	BucketPermissions	ReadOnly	Přístupová oprávnění pro segment. Buď ReadOnly, nebo ReadWrite. Výchozí hodnota je ReadOnly, pokud při vytváření kbelíku není zadána žádná hodnota.
properties.provisioningState	NetAppProvisioningState		Stav zřizování prostředku
properties.server	BucketServerProperties		Vlastnosti serveru, který spravuje životní cyklus kontejnerů svazků
properties.status	CredentialsStatus		Stav přihlašovacích údajů kbelíku. Tam se uvádí: "NoCredentialsSet": Pár přístupového a tajného klíče nebyl vygenerován. "CredentialsExpired": Platnost páru přístupového a tajného klíče vypršela. "Aktivní": Certifikát byl nainstalován a platnost přihlašovacích údajů nevypršela.
systemData	systemData		Metadata služby Azure Resource Manager obsahující informace o tom, kdo jej vytvořil a upravil.
type	string		Typ prostředku. Např. "Microsoft.Compute/virtualMachines" nebo "Microsoft.Storage/storageAccounts"

BucketList

Objekt

Seznam prostředků kontejneru svazků svazků

Name	Typ	Description
nextLink	string (uri)	Odkaz na další stránku položek
value	Bucket[]	Položky Bucket na této stránce

BucketPermissions

Výčet

Přístupová oprávnění pro segment. Buď ReadOnly, nebo ReadWrite. Výchozí hodnota je ReadOnly, pokud při vytváření kbelíku není zadána žádná hodnota.

Hodnota	Description
ReadOnly	Přístup pouze pro čtení k bucketu.
ReadWrite	Přístup pro čtení i zápis do kbelíku.

BucketServerProperties

Objekt

Vlastnosti serveru, který spravuje životní cyklus kontejnerů svazků

Name	Typ	Description
certificateCommonName	string minLength: 1 maxLength: 64	Běžný název certifikátu převzatý z certifikátu nainstalovaného na bucket serveru
certificateExpiryDate	string (date-time)	Datum vypršení platnosti certifikátu bucket serveru.
certificateObject	string minLength: 1 maxLength: 10240	Soubor PEM s kódováním Base64, který zahrnuje certifikát serveru kontejneru i privátní klíč. Používá se k ověření uživatele a umožňuje přístup ke svazkovým datům jen pro čtení.
fqdn	string	Hostitelská část adresy URL kontejneru, překlad na IP adresu kontejneru a povolená certifikátem serveru.
ipAddress	string	IPv4 adresa bucket serveru

CifsUser

Objekt

Efektivní uživatelské jméno CIFS při přístupu k datům svazku.

Name	Typ	Description
username	string	Uživatelské jméno uživatele CIFS

createdByType

Výčet

Typ identity, která prostředek vytvořila.

Hodnota	Description
User
Application
ManagedIdentity
Key

CredentialsStatus

Výčet

Stav přihlašovacích údajů kbelíku. Tam se uvádí:

"NoCredentialsSet": Pár přístupového a tajného klíče nebyl vygenerován. "CredentialsExpired": Platnost páru přístupového a tajného klíče vypršela. "Aktivní": Certifikát byl nainstalován a platnost přihlašovacích údajů nevypršela.

Hodnota	Description
NoCredentialsSet	Pár přístupových a tajných klíčů nebyl vygenerován.
CredentialsExpired	Platnost páru přístupového a tajného klíče vypršela.
Active	Certifikát byl nainstalován na server bucket a přihlašovací údaje bucketu nevypršely.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

FileSystemUser

Objekt

Uživatel systému souborů má přístup k datům svazku. Pro Unix je to uid a gid uživatele. Pro Windows se jedná o uživatelské jméno uživatele. Všimněte si, že podrobnosti o uživatelích se systémem Unix a Windows se vzájemně vylučují, což znamená, že musí být zadána jedna nebo jiná, ale ne obě.

Name	Typ	Description
cifsUser	CifsUser	Efektivní uživatelské jméno CIFS při přístupu k datům svazku.
nfsUser	NfsUser	Platné ID uživatele systému souborů NFS a ID skupiny při přístupu k datům svazku.

NetAppProvisioningState

Výčet

Získá stav VolumeQuotaRule v době, kdy byla operace volána.

Hodnota	Description
Accepted	Zdroj byl přijat
Creating	Vytváří se zdroj
Patching	Prostředek se opravuje
Updating	Prostředek se aktualizuje
Deleting	Prostředek se odstraňuje
Moving	Prostředek se přesouvá
Failed	Prostředek se nezdařil
Succeeded	Prostředek byl úspěšný

NfsUser

Objekt

Platné ID uživatele systému souborů NFS a ID skupiny při přístupu k datům svazku.

Name	Typ	Description
groupId	integer (int64)	GID uživatele systému souborů NFS
userId	integer (int64)	UID uživatele systému souborů NFS

systemData

Objekt

Metadata týkající se vytvoření a poslední změny prostředku.

Name	Typ	Description
createdAt	string (date-time)	Časové razítko vytvoření prostředku (UTC).
createdBy	string	Identita, která prostředek vytvořila.
createdByType	createdByType	Typ identity, která prostředek vytvořila.
lastModifiedAt	string (date-time)	Časové razítko poslední změny zdroje (UTC)
lastModifiedBy	string	Identita, která naposledy změnila prostředek.
lastModifiedByType	createdByType	Typ identity, která naposledy změnila prostředek.

Sdílet prostřednictvím

Buckets - List

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

Buckets_List

Ukázkový požadavek

Ukázková odpověď

Definice

Bucket

BucketList

BucketPermissions

BucketServerProperties

CifsUser

createdByType

CredentialsStatus

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

FileSystemUser

NetAppProvisioningState

NfsUser

systemData