Caches - List

Referenz

Dienst:: Storagecache

API-Version:: 2024-07-01

Gibt alle Caches zurück, auf die der Benutzer unter einem Abonnement zugreifen kann.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/caches?api-version=2024-07-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	CachesListResult	Eine Liste von Cacheobjekten. Beachten Sie, dass Entitätsverweise vollständige Cacheobjekte ersetzen können, wie in http://docs.oasis-open.org/odata/odata-json-format/v4.01/cs01/odata-json-format-v4.01-cs01.html#sec_EntityReference
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

Caches_List

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.StorageCache/caches?api-version=2024-07-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "tags": {
        "Dept": "Contoso"
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.StorageCache/caches/sc1",
      "location": "westus",
      "name": "sc1",
      "type": "Microsoft.StorageCache/Cache",
      "systemData": {
        "createdBy": "user1",
        "createdByType": "User",
        "createdAt": "2020-01-01T17:18:19.1234567Z",
        "lastModifiedBy": "user2",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
      },
      "properties": {
        "cacheSizeGB": 3072,
        "health": {
          "state": "Transitioning",
          "statusDescription": "Cache is being created.",
          "conditions": [
            {
              "timestamp": "2021-04-21T18:25:43.511Z",
              "message": "Cannot contact DNS server"
            }
          ]
        },
        "mountAddresses": [
          "192.168.1.1",
          "192.168.1.2"
        ],
        "provisioningState": "Succeeded",
        "subnet": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/sub1",
        "upgradeStatus": {
          "currentFirmwareVersion": "2022.08.1",
          "firmwareUpdateStatus": "available",
          "firmwareUpdateDeadline": "2019-04-21T18:25:43.511Z",
          "lastFirmwareUpdate": "2019-01-21T18:25:43.511Z",
          "pendingFirmwareVersion": "2022.08.1"
        },
        "networkSettings": {
          "mtu": 1500,
          "dnsServers": [
            "10.1.22.33",
            "10.1.12.33"
          ],
          "dnsSearchDomain": "contoso.com",
          "ntpServer": "time.contoso.com"
        },
        "securitySettings": {
          "accessPolicies": [
            {
              "name": "default",
              "accessRules": [
                {
                  "scope": "default",
                  "access": "rw",
                  "suid": false,
                  "submountAccess": true,
                  "rootSquash": false
                }
              ]
            }
          ]
        },
        "upgradeSettings": {
          "upgradeScheduleEnabled": true,
          "scheduledTime": "2022-04-26T18:25:43.511Z"
        },
        "encryptionSettings": {
          "keyEncryptionKey": {
            "keyUrl": "https://keyvault-cmk.vault.azure.net/keys/key2048/test",
            "sourceVault": {
              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.KeyVault/vaults/keyvault-cmk"
            }
          }
        },
        "directoryServicesSettings": {
          "activeDirectory": {
            "primaryDnsIpAddress": "192.0.2.10",
            "secondaryDnsIpAddress": "192.0.2.11",
            "domainName": "contosoAd.contoso.local",
            "domainNetBiosName": "contosoAd",
            "cacheNetBiosName": "contosoSmb",
            "domainJoined": "Yes"
          },
          "usernameDownload": {
            "extendedGroups": true,
            "usernameSource": "LDAP",
            "groupFileURI": "http://contoso.net/group.file",
            "userFileURI": "http://contoso.net/passwd.file",
            "ldapServer": "192.0.2.12",
            "ldapBaseDN": "dc=contosoad,dc=contoso,dc=local",
            "encryptLdapConnection": false,
            "requireValidCertificate": false,
            "autoDownloadCertificate": false,
            "caCertificateURI": "http://contoso.net/cacert.pem",
            "usernameDownloaded": "Yes"
          }
        },
        "primingJobs": [],
        "spaceAllocation": [
          {
            "name": "st1",
            "allocationPercentage": 25
          },
          {
            "name": "st2",
            "allocationPercentage": 50
          },
          {
            "name": "st3",
            "allocationPercentage": 25
          }
        ]
      },
      "sku": {
        "name": "Standard_2G"
      }
    },
    {
      "tags": {
        "Dept": "Contoso"
      },
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.StorageCache/caches/sc2",
      "location": "westus",
      "name": "sc2",
      "type": "Microsoft.StorageCache/Cache",
      "systemData": {
        "createdBy": "user1",
        "createdByType": "User",
        "createdAt": "2020-01-01T17:18:19.1234567Z",
        "lastModifiedBy": "user2",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2020-01-02T17:18:19.1234567Z"
      },
      "properties": {
        "cacheSizeGB": 3072,
        "health": {
          "state": "Transitioning",
          "statusDescription": "Cache is being created.",
          "conditions": [
            {
              "timestamp": "2021-04-21T18:25:43.511Z",
              "message": "Cannot contact DNS server"
            }
          ]
        },
        "mountAddresses": [
          "192.168.1.1",
          "192.168.1.2"
        ],
        "provisioningState": "Updating",
        "subnet": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.Network/virtualNetworks/scvnet/subnets/sub2",
        "upgradeStatus": {
          "currentFirmwareVersion": "2022.08.1",
          "firmwareUpdateStatus": "available",
          "firmwareUpdateDeadline": "2019-04-21T18:25:43.511Z",
          "lastFirmwareUpdate": "2019-01-21T18:25:43.511Z",
          "pendingFirmwareVersion": "2022.08.1"
        },
        "networkSettings": {
          "mtu": 1500,
          "dnsServers": [
            "10.1.22.33",
            "10.1.12.33"
          ],
          "dnsSearchDomain": "contoso.com",
          "ntpServer": "time.contoso.com"
        },
        "securitySettings": {
          "accessPolicies": [
            {
              "name": "default",
              "accessRules": [
                {
                  "scope": "default",
                  "access": "rw",
                  "suid": false,
                  "submountAccess": true,
                  "rootSquash": false
                }
              ]
            }
          ]
        },
        "upgradeSettings": {
          "upgradeScheduleEnabled": true,
          "scheduledTime": "2022-04-26T18:25:43.511Z"
        },
        "encryptionSettings": {
          "keyEncryptionKey": {
            "keyUrl": "https://keyvault-cmk.vault.azure.net/keys/key2048/test",
            "sourceVault": {
              "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/scgroup/providers/Microsoft.KeyVault/vaults/keyvault-cmk"
            }
          }
        },
        "directoryServicesSettings": {
          "activeDirectory": {
            "primaryDnsIpAddress": "192.0.2.10",
            "secondaryDnsIpAddress": "192.0.2.11",
            "domainName": "contosoAd.contoso.local",
            "domainNetBiosName": "contosoAd",
            "cacheNetBiosName": "contosoSmb",
            "domainJoined": "Yes"
          },
          "usernameDownload": {
            "extendedGroups": true,
            "usernameSource": "AD",
            "groupFileURI": "http://contoso.net/group.file",
            "userFileURI": "http://contoso.net/passwd.file",
            "ldapServer": "",
            "ldapBaseDN": "",
            "encryptLdapConnection": false,
            "requireValidCertificate": false,
            "autoDownloadCertificate": false,
            "caCertificateURI": "http://contoso.net/cacert.pem",
            "usernameDownloaded": "Yes"
          }
        },
        "primingJobs": [
          {
            "primingJobName": "contosoJob1",
            "primingJobId": "00000000000_0000000000",
            "primingJobState": "Complete",
            "primingJobStatus": "success",
            "primingJobDetails": "Files: Cached=635, Failed=0, Excluded=80, Data=346030 bytes, Directories: Cached=1003, Failed=0, Excluded=0",
            "primingJobPercentComplete": 100
          },
          {
            "primingJobName": "contosoJob2",
            "primingJobId": "11111111111_1111111111",
            "primingJobState": "Queued",
            "primingJobStatus": "",
            "primingJobDetails": "",
            "primingJobPercentComplete": 0
          }
        ],
        "spaceAllocation": [],
        "zones": [
          "1"
        ]
      },
      "sku": {
        "name": "Standard_2G"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
Cache	Eine Cacheinstanz. Folgt Azure Resource Manager-Standards: https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md
CacheActiveDirectorySettings	Active Directory-Einstellungen, die zum Verbinden eines Caches zu einer Domäne verwendet werden.
CacheDirectorySettings	Einstellungen für Verzeichnisdienste zwischenspeichern.
CacheEncryptionSettings	Cacheverschlüsselungseinstellungen.
CacheHealth	Ein Hinweis auf die Cacheintegrität. Bietet mehr Informationen über den Status als nur für die Bereitstellung.
CacheIdentity	Cacheidentitätseigenschaften.
CacheIdentityType	Der Identitätstyp, der für den Cache verwendet wird
CacheNetworkSettings	Cache-Netzwerkeinstellungen.
CacheSecuritySettings	Cachesicherheitseinstellungen.
CachesListResult	Ergebnis der Anforderung an Listencaches. Sie enthält eine Liste von Caches und einen URL-Link, um den nächsten Satz von Ergebnissen abzurufen.
CacheUpgradeSettings	Cacheupgradeeinstellungen.
CacheUpgradeStatus	Eigenschaften, die den Status des Softwareupgrades des Caches beschreiben.
CacheUsernameDownloadSettings	Einstellungen für den Benutzernamen und den Gruppendownload für erweiterte Gruppen.
CloudError	Eine Fehlerantwort.
CloudErrorBody	Eine Fehlerantwort.
Condition	Ausstehende Bedingungen, die aufgelöst werden müssen.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
Credentials	Active Directory-Administratoranmeldeinformationen, die zum Beitreten zum HPC-Cache zu einer Domäne verwendet werden.
DomainJoinedType	True, wenn der HPC-Cache mit der Active Directory-Domäne verknüpft ist.
FirmwareStatusType	True, wenn ein Firmwareupdate für die Installation in diesem Cache bereit ist. Die Firmware wird automatisch nach firmwareUpdateDeadline installiert, wenn sie nicht zuvor über den Upgradevorgang ausgelöst wurde.
HealthStateType	Liste der Cacheintegritätszustände. Nach unten reagiert der Cluster nicht. Beeinträchtigt wird, wenn es funktioniert, aber einige Warnungen hat. Übergang beim Erstellen oder Löschen. Unbekannt wird in alten API-Versionen zurückgegeben, wenn in zukünftigen Versionen ein neuer Wert hinzugefügt wird. WaitingForKey wartet, wenn die Erstellung auf die zugewiesene Systemidentität wartet, um zugriff auf den Verschlüsselungsschlüssel in den Verschlüsselungseinstellungen zu erhalten.
KeyVaultKeyReference	Beschreibt einen Verweis auf den Schlüsseltresorschlüssel.
NfsAccessPolicy	Eine Reihe von Regeln, die Zugriffsrichtlinien beschreiben, die auf NFSv3-Clients des Caches angewendet werden.
NfsAccessRule	Regel zum Platzieren von Einschränkungen für Teile des Cachenamespaces, die Clients angezeigt werden.
NfsAccessRuleAccess	Von dieser Regel zugelassener Zugriff.
NfsAccessRuleScope	Bereich für diese Regel. Der Bereich und filter bestimmen, welche Clients mit der Regel übereinstimmen.
PrimingJob	Eine Primingauftragsinstanz.
PrimingJobState	Der Zustand des Primingvorgangs.
ProvisioningStateType	ARM-Bereitstellungsstatus finden Sie unter https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/Addendum.md#provisioningstate-property
Sku	SKU für den Cache.
SourceVault	Beschreibt eine Ressourcen-ID für den Quellschlüsseltresor.
StorageTargetSpaceAllocation	Zuordnungseigenschaften des Speicherziels.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
UserAssignedIdentities	Ein Wörterbuch, bei dem es sich bei jedem Schlüssel um eine vom Benutzer zugewiesene Identitätsressourcen-ID handelt, und der Wert jedes Schlüssels ist ein leeres Wörterbuch.
UsernameDownloadedType	Gibt an, ob der HPC-Cache erfolgreich den Benutzernamendownload ausgeführt hat.
UsernameSource	Diese Einstellung bestimmt, wie der Cache Benutzernamen und Gruppennamen für Clients abruft.

Cache

Objekt

Eine Cacheinstanz. Folgt Azure Resource Manager-Standards: https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md

Name	Typ	Beschreibung
id	string	Ressourcen-ID des Caches.
identity	CacheIdentity	Die Identität des Caches, falls konfiguriert.
location	string	Regionsnamezeichenfolge.
name	string pattern: ^[-0-9a-zA-Z_]{1,80}$	Name des Caches.
properties.cacheSizeGB	integer (int32)	Die Größe dieses Caches in GB.
properties.directoryServicesSettings	CacheDirectorySettings	Gibt Die Verzeichnisdiensteeinstellungen des Caches an.
properties.encryptionSettings	CacheEncryptionSettings	Gibt Die Verschlüsselungseinstellungen des Caches an.
properties.health	CacheHealth	Integrität des Caches.
properties.mountAddresses	string[]	Array von IPv4-Adressen, die von Clients verwendet werden können, die diesen Cache bereitstellen.
properties.networkSettings	CacheNetworkSettings	Gibt Netzwerkeinstellungen des Caches an.
properties.primingJobs	PrimingJob[]	Gibt die im Cache definierten Primingaufträge an.
properties.provisioningState	ProvisioningStateType	ARM-Bereitstellungsstatus finden Sie unter https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/Addendum.md#provisioningstate-property
properties.securitySettings	CacheSecuritySettings	Gibt Sicherheitseinstellungen des Caches an.
properties.spaceAllocation	StorageTargetSpaceAllocation[]	Gibt den Prozentsatz der Speicherplatzzuweisung für jedes Speicherziel im Cache an.
properties.subnet	string	Subnetz, das für den Cache verwendet wird.
properties.upgradeSettings	CacheUpgradeSettings	Upgradeeinstellungen des Caches.
properties.upgradeStatus	CacheUpgradeStatus	Upgradestatus des Caches.
properties.zones	string[]	Verfügbarkeitszonen für Ressourcen. Dieses Feld darf nur ein einzelnes Element im Array enthalten.
sku	Sku	SKU für den Cache.
systemData	systemData	Die Systemmetadaten, die sich auf diese Ressource beziehen.
tags	object	Ressourcentags.
type	string	Typ des Caches; Microsoft.StorageCache/Cache

CacheActiveDirectorySettings

Objekt

Active Directory-Einstellungen, die zum Verbinden eines Caches zu einer Domäne verwendet werden.

Name	Typ	Beschreibung
cacheNetBiosName	string pattern: ^[-0-9a-zA-Z]{1,15}$	Der NetBIOS-Name, der dem HPC-Cache zugewiesen werden soll, wenn er der Active Directory-Domäne als Server beitritt. Länge muss 1-15 Zeichen aus der Klasse [-0-9a-zA-Z].
credentials	Credentials	Active Directory-Administratoranmeldeinformationen, die zum Beitreten zum HPC-Cache zu einer Domäne verwendet werden.
domainJoined	DomainJoinedType	True, wenn der HPC-Cache mit der Active Directory-Domäne verknüpft ist.
domainName	string	Der vollqualifizierte Domänenname des Active Directory-Domänencontrollers.
domainNetBiosName	string	Der NetBIOS-Name der Active Directory-Domäne.
primaryDnsIpAddress	string	Primäre DNS-IP-Adresse, die zum Auflösen des vollqualifizierten Domänennamens des Active Directory-Domänencontrollers verwendet wird.
secondaryDnsIpAddress	string	Sekundäre DNS-IP-Adresse, die zum Auflösen des vollqualifizierten Domänennamens des Active Directory-Domänencontrollers verwendet wird.

CacheDirectorySettings

Objekt

Einstellungen für Verzeichnisdienste zwischenspeichern.

Name	Typ	Beschreibung
activeDirectory	CacheActiveDirectorySettings	Gibt Einstellungen für das Verknüpfen des HPC-Caches zu einer Active Directory-Domäne an.
usernameDownload	CacheUsernameDownloadSettings	Gibt Einstellungen für erweiterte Gruppen an. Mit erweiterten Gruppen können Benutzer Mitglieder von mehr als 16 Gruppen sein.

CacheEncryptionSettings

Objekt

Cacheverschlüsselungseinstellungen.

Name	Typ	Beschreibung
keyEncryptionKey	KeyVaultKeyReference	Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels im Schlüsseltresor an.
rotationToLatestKeyVersionEnabled	boolean	Gibt an, ob der Dienst automatisch in die neueste Version des Schlüssels im Schlüsseltresor gedreht wird.

CacheHealth

Objekt

Ein Hinweis auf die Cacheintegrität. Bietet mehr Informationen über den Status als nur für die Bereitstellung.

Name	Typ	Beschreibung
conditions	Condition[]	Ausstehende Bedingungen, die untersucht und gelöst werden müssen.
state	HealthStateType	Liste der Cacheintegritätszustände. Nach unten reagiert der Cluster nicht. Beeinträchtigt wird, wenn es funktioniert, aber einige Warnungen hat. Übergang beim Erstellen oder Löschen. Unbekannt wird in alten API-Versionen zurückgegeben, wenn in zukünftigen Versionen ein neuer Wert hinzugefügt wird. WaitingForKey wartet, wenn die Erstellung auf die zugewiesene Systemidentität wartet, um zugriff auf den Verschlüsselungsschlüssel in den Verschlüsselungseinstellungen zu erhalten.
statusDescription	string	Beschreibt die Erläuterung des Zustands.

CacheIdentity

Objekt

Cacheidentitätseigenschaften.

Name	Typ	Beschreibung
principalId	string	Die Prinzipal-ID für die vom System zugewiesene Identität des Caches.
tenantId	string	Die dem Cache zugeordnete Mandanten-ID.
type	CacheIdentityType	Der Identitätstyp, der für den Cache verwendet wird
userAssignedIdentities	UserAssignedIdentities	Ein Wörterbuch, bei dem es sich bei jedem Schlüssel um eine vom Benutzer zugewiesene Identitätsressourcen-ID handelt, und der Wert jedes Schlüssels ist ein leeres Wörterbuch.

CacheIdentityType

Enumeration

Der Identitätstyp, der für den Cache verwendet wird

Wert	Beschreibung
None
SystemAssigned
SystemAssigned, UserAssigned
UserAssigned

CacheNetworkSettings

Objekt

Cache-Netzwerkeinstellungen.

Name	Typ	Standardwert	Beschreibung
dnsSearchDomain	string		DNS-Suchdomäne
dnsServers	string[]		DNS-Server für den zu verwendenden Cache. Sie wird aus der Netzwerkkonfiguration festgelegt, wenn kein Wert angegeben wird.
mtu	integer (int32) minimum: 576 maximum: 1500	1500	Die für das Subnetz konfigurierte maximale IPv4-Übertragungseinheit.
ntpServer	string	time.windows.com	NTP-Server-IP-Adresse oder FQDN für den zu verwendenden Cache. Der Standardwert ist time.windows.com.
utilityAddresses	string[]		Array von zusätzlichen IP-Adressen, die von diesem Cache verwendet werden.

CacheSecuritySettings

Objekt

Cachesicherheitseinstellungen.

Name	Typ	Beschreibung
accessPolicies	NfsAccessPolicy[]	FÜR diesen Cache definierte NFS-Zugriffsrichtlinien.

CachesListResult

Objekt

Ergebnis der Anforderung an Listencaches. Sie enthält eine Liste von Caches und einen URL-Link, um den nächsten Satz von Ergebnissen abzurufen.

Name	Typ	Beschreibung
nextLink	string	URL zum Abrufen des nächsten Satzes von Cachelistenergebnissen, falls vorhanden.
value	Cache[]	Liste der Caches.

CacheUpgradeSettings

Objekt

Cacheupgradeeinstellungen.

Name	Typ	Beschreibung
scheduledTime	string (date-time)	Wenn "upgradeScheduleEnabled" auf "true" festgelegt ist, enthält dieses Feld die vom Benutzer ausgewählte Upgradezeit. Zum vom Benutzer ausgewählten Zeitpunkt wird das Firmwareupdate automatisch im Cache installiert.
upgradeScheduleEnabled	boolean	True, wenn der Benutzer eine Installationszeit zwischen jetzt und firmwareUpdateDeadline auswählt. Andernfalls wird die Firmware automatisch nach firmwareUpdateDeadline installiert, wenn sie nicht zuvor über den Upgradevorgang ausgelöst wurde.

CacheUpgradeStatus

Objekt

Eigenschaften, die den Status des Softwareupgrades des Caches beschreiben.

Name	Typ	Beschreibung
currentFirmwareVersion	string	Versionszeichenfolge der Firmware, die derzeit in diesem Cache installiert ist.
firmwareUpdateDeadline	string (date-time)	Zeitpunkt, zu dem das ausstehende Firmwareupdate automatisch im Cache installiert wird.
firmwareUpdateStatus	FirmwareStatusType	True, wenn ein Firmwareupdate für die Installation in diesem Cache bereit ist. Die Firmware wird automatisch nach firmwareUpdateDeadline installiert, wenn sie nicht zuvor über den Upgradevorgang ausgelöst wurde.
lastFirmwareUpdate	string (date-time)	Zeitpunkt des letzten erfolgreichen Firmwareupdates.
pendingFirmwareVersion	string	Wenn firmwareUpdateAvailable true ist, enthält dieses Feld die Versionszeichenfolge für das Update.

CacheUsernameDownloadSettings

Objekt

Einstellungen für den Benutzernamen und den Gruppendownload für erweiterte Gruppen.

Name	Typ	Standardwert	Beschreibung
autoDownloadCertificate	boolean	False	Bestimmt, ob das Zertifikat automatisch heruntergeladen werden soll. Dies gilt nur für 'caCertificateURI', wenn 'requireValidCertificate' wahr ist.
caCertificateURI	string		Der URI des Zertifizierungsstellenzertifikats zum Überprüfen der sicheren LDAP-Verbindung. Dieses Feld muss aufgefüllt werden, wenn "requireValidCertificate" auf "true" festgelegt ist.
credentials	Credentials		Wenn vorhanden, sind dies die Anmeldeinformationen für die sichere LDAP-Verbindung.
encryptLdapConnection	boolean	False	Gibt an, ob die LDAP-Verbindung verschlüsselt werden soll.
extendedGroups	boolean		Gibt an, ob erweiterte Gruppen aktiviert sind.
groupFileURI	string		Der URI der Datei, die Gruppeninformationen enthält (im Dateiformat "/etc/group"). Dieses Feld muss ausgefüllt werden, wenn "usernameSource" auf "File" festgelegt ist.
ldapBaseDN	string		Der Basisname für die LDAP-Domäne.
ldapServer	string		Der vollqualifizierte Domänenname oder die IP-Adresse des zu verwendenden LDAP-Servers.
requireValidCertificate	boolean	False	Bestimmt, ob die Zertifikate von einer Zertifizierungsstelle überprüft werden müssen. Wenn true, muss caCertificateURI angegeben werden.
userFileURI	string		Der URI der Datei, die Benutzerinformationen enthält (im Dateiformat /etc/passwd). Dieses Feld muss ausgefüllt werden, wenn "usernameSource" auf "File" festgelegt ist.
usernameDownloaded	UsernameDownloadedType		Gibt an, ob der HPC-Cache erfolgreich den Benutzernamendownload ausgeführt hat.
usernameSource	UsernameSource	None	Diese Einstellung bestimmt, wie der Cache Benutzernamen und Gruppennamen für Clients abruft.

CloudError

Objekt

Eine Fehlerantwort.

Name	Typ	Beschreibung
error	CloudErrorBody	Der Textkörper des Fehlers.

CloudErrorBody

Objekt

Eine Fehlerantwort.

Name	Typ	Beschreibung
code	string	Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollen programmgesteuert genutzt werden.
details	CloudErrorBody[]	Eine Liste mit zusätzlichen Details zum Fehler.
message	string	Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet ist.
target	string	Das Ziel des bestimmten Fehlers. Beispielsweise der Name der Eigenschaft im Fehler.

Condition

Objekt

Ausstehende Bedingungen, die aufgelöst werden müssen.

Name	Typ	Beschreibung
message	string	Das Problem, das Aufmerksamkeit erfordert.
timestamp	string (date-time)	Die Zeit, zu der die Bedingung ausgelöst wurde.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

Credentials

Objekt

Active Directory-Administratoranmeldeinformationen, die zum Beitreten zum HPC-Cache zu einer Domäne verwendet werden.

Name	Typ	Beschreibung
password	string	Nur-Text-Kennwort des Active Directory-Domänenadministrators. Dieser Wert wird verschlüsselt gespeichert und wird nicht für die Antwort zurückgegeben.
username	string	Benutzername des Active Directory-Domänenadministrators. Dieser Wert wird verschlüsselt gespeichert und wird nicht für die Antwort zurückgegeben.

DomainJoinedType

Enumeration

True, wenn der HPC-Cache mit der Active Directory-Domäne verknüpft ist.

Wert	Beschreibung
Error
No
Yes

FirmwareStatusType

Enumeration

True, wenn ein Firmwareupdate für die Installation in diesem Cache bereit ist. Die Firmware wird automatisch nach firmwareUpdateDeadline installiert, wenn sie nicht zuvor über den Upgradevorgang ausgelöst wurde.

Wert	Beschreibung
available
unavailable

HealthStateType

Enumeration

Liste der Cacheintegritätszustände. Nach unten reagiert der Cluster nicht. Beeinträchtigt wird, wenn es funktioniert, aber einige Warnungen hat. Übergang beim Erstellen oder Löschen. Unbekannt wird in alten API-Versionen zurückgegeben, wenn in zukünftigen Versionen ein neuer Wert hinzugefügt wird. WaitingForKey wartet, wenn die Erstellung auf die zugewiesene Systemidentität wartet, um zugriff auf den Verschlüsselungsschlüssel in den Verschlüsselungseinstellungen zu erhalten.

Wert	Beschreibung
Degraded
Down
Flushing
Healthy
StartFailed
Stopped
Stopping
Transitioning
Unknown
UpgradeFailed
Upgrading
WaitingForKey

KeyVaultKeyReference

Objekt

Beschreibt einen Verweis auf den Schlüsseltresorschlüssel.

Name	Typ	Beschreibung
keyUrl	string	Die URL, die auf einen Schlüsselverschlüsselungsschlüssel im Schlüsseltresor verweist.
sourceVault	SourceVault	Beschreibt eine Ressourcen-ID für den Quellschlüsseltresor.

NfsAccessPolicy

Objekt

Eine Reihe von Regeln, die Zugriffsrichtlinien beschreiben, die auf NFSv3-Clients des Caches angewendet werden.

Name	Typ	Beschreibung
accessRules	NfsAccessRule[]	Der Satz von Regeln, die clientzugriffe beschreiben, die unter dieser Richtlinie zulässig sind.
name	string	Name, der diese Richtlinie identifiziert. Bei Zugriffsrichtliniennamen wird die Groß-/Kleinschreibung nicht beachtet.

NfsAccessRule

Objekt

Regel zum Platzieren von Einschränkungen für Teile des Cachenamespaces, die Clients angezeigt werden.

Name	Typ	Beschreibung
access	NfsAccessRuleAccess	Von dieser Regel zugelassener Zugriff.
anonymousGID	string	GID-Wert, der 0 ersetzt, wenn rootSquash true ist. Dadurch wird der Wert von anonymousUID verwendet, wenn nicht angegeben.
anonymousUID	string	UID-Wert, der 0 ersetzt, wenn rootSquash true ist. 65534 wird verwendet, wenn nicht angegeben.
filter	string	Filter, der auf den Bereich für diese Regel angewendet wurde. Das Format des Filters hängt vom Bereich ab. Der Bereich "Standard" entspricht allen Clients und weist keinen Filterwert auf. Der Bereich "Netzwerk" verwendet einen Filter im CIDR-Format (z. B. 10.99.1.0/24). "host" akzeptiert eine IP-Adresse oder einen vollqualifizierten Domänennamen als Filter. Wenn ein Client keiner Filterregel entspricht und keine Standardregel vorhanden ist, wird der Zugriff verweigert.
rootSquash	boolean	Zuordnen von Stammzugriffen zu anonymousUID und anonymousGID.
scope	NfsAccessRuleScope	Bereich für diese Regel. Der Bereich und filter bestimmen, welche Clients mit der Regel übereinstimmen.
submountAccess	boolean	Lassen Sie für die Standardrichtlinie den Zugriff auf Unterverzeichnisse unter dem Stammexport zu. Wenn dies auf "Nein" festgelegt ist, können Clients nur den Pfad "/" bereitstellen. Wenn diese Einstellung auf "ja" festgelegt ist, können Clients einen tieferen Pfad wie "/a/b" bereitstellen.
suid	boolean	SuID-Semantik zulassen.

NfsAccessRuleAccess

Enumeration

Von dieser Regel zugelassener Zugriff.

Wert	Beschreibung
no
ro
rw

NfsAccessRuleScope

Enumeration

Bereich für diese Regel. Der Bereich und filter bestimmen, welche Clients mit der Regel übereinstimmen.

Wert	Beschreibung
default
host
network

PrimingJob

Objekt

Eine Primingauftragsinstanz.

Name	Typ	Beschreibung
primingJobDetails	string	Die Auftragsdetails oder Fehlerinformationen, falls vorhanden.
primingJobId	string pattern: ^[-0-9a-zA-Z_]{1,80}$	Der eindeutige Bezeichner des Primingauftrags.
primingJobName	string pattern: ^[-0-9a-zA-Z_]{1,80}$	Der Primierungsauftragsname.
primingJobPercentComplete	number (double) minimum: 0 maximum: 100	Der aktuelle Fortschritt des Primingauftrags als Prozentsatz.
primingJobState	PrimingJobState	Der Zustand des Primingvorgangs.
primingJobStatus	string	Der Statuscode des Primingauftrags.
primingManifestUrl	string	Die URL für dieprimierende Manifestdatei, die heruntergeladen werden soll. Diese Datei muss aus dem HPC-Cache lesbar sein. Wenn sich die Datei im Azure-Blobspeicher befindet, sollte die URL eine SAS (Shared Access Signature) enthalten, die Leseberechtigungen für das Blob gewährt.

PrimingJobState

Enumeration

Der Zustand des Primingvorgangs.

Wert	Beschreibung
Complete
Paused
Queued
Running

ProvisioningStateType

Enumeration

ARM-Bereitstellungsstatus finden Sie unter https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/Addendum.md#provisioningstate-property

Wert	Beschreibung
Canceled
Creating
Deleting
Failed
Succeeded
Updating

Sku

Objekt

SKU für den Cache.

Name	Typ	Beschreibung
name	string	SKU-Name für diesen Cache.

SourceVault

Objekt

Beschreibt eine Ressourcen-ID für den Quellschlüsseltresor.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.

StorageTargetSpaceAllocation

Objekt

Zuordnungseigenschaften des Speicherziels.

Name	Typ	Beschreibung
allocationPercentage	integer (int32) minimum: 1 maximum: 100	Der Prozentsatz des für dieses Speicherziel zugeordneten Cachespeicherplatzes
name	string pattern: ^[-0-9a-zA-Z_]{1,80}$	Name des Speicherziels.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

UserAssignedIdentities

Objekt

Ein Wörterbuch, bei dem es sich bei jedem Schlüssel um eine vom Benutzer zugewiesene Identitätsressourcen-ID handelt, und der Wert jedes Schlüssels ist ein leeres Wörterbuch.

Name	Typ	Beschreibung

UsernameDownloadedType

Enumeration

Gibt an, ob der HPC-Cache erfolgreich den Benutzernamendownload ausgeführt hat.

Wert	Beschreibung
Error
No
Yes

UsernameSource

Enumeration

Diese Einstellung bestimmt, wie der Cache Benutzernamen und Gruppennamen für Clients abruft.

Wert	Beschreibung
AD
File
LDAP
None

Freigeben über

Caches - List

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Caches_List

Beispielanforderung

Beispiel für eine Antwort

Definitionen

Cache

CacheActiveDirectorySettings

CacheDirectorySettings

CacheEncryptionSettings

CacheHealth

CacheIdentity

CacheIdentityType

CacheNetworkSettings

CacheSecuritySettings

CachesListResult

CacheUpgradeSettings

CacheUpgradeStatus

CacheUsernameDownloadSettings

CloudError

CloudErrorBody

Condition

createdByType

Credentials

DomainJoinedType

FirmwareStatusType

HealthStateType

KeyVaultKeyReference

NfsAccessPolicy

NfsAccessRule

NfsAccessRuleAccess

NfsAccessRuleScope

PrimingJob

PrimingJobState

ProvisioningStateType

Sku

SourceVault

StorageTargetSpaceAllocation

systemData

UserAssignedIdentities

UsernameDownloadedType

UsernameSource