다음을 통해 공유

Caches - List

서비스:
Storagecache
API 버전:
2026-01-01

구독에 따라 사용자가 액세스할 수 있는 모든 캐시를 반환합니다.

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

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
subscriptionId
 path True

string

minLength: 1

대상 구독의 ID입니다.
api-version
 query True

string

minLength: 1

이 작업에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

CachesListResult

캐시 개체 목록입니다. 엔터티 참조는 에 설명된 대로 전체 캐시 개체를 대체할 수 있습니다. 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

작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name Description
user_impersonation 사용자 계정 가장

예제

Caches_List

샘플 요청

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

샘플 응답

상태 코드:
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"
      }
    }
  ]
}

정의

Name Description
Cache

캐시 인스턴스입니다. Azure Resource Manager 표준을 따릅니다. https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md
CacheActiveDirectorySettings

캐시를 도메인에 조인하는 데 사용되는 Active Directory 설정입니다.
CacheDirectorySettings

캐시 디렉터리 서비스 설정입니다.
CacheEncryptionSettings

암호화 설정을 캐시합니다.
CacheHealth

캐시 상태를 나타냅니다. 프로비전과 관련된 것보다 상태에 대한 자세한 정보를 제공합니다.
CacheIdentity

캐시 ID 속성입니다.
CacheIdentityType

캐시에 사용되는 ID의 형식입니다.
CacheNetworkSettings

네트워크 설정을 캐시합니다.
CacheSecuritySettings

보안 설정을 캐시합니다.
CachesListResult

캐시 나열 요청의 결과입니다. 다음 결과 집합을 가져오기 위한 캐시 목록과 URL 링크가 포함되어 있습니다.
CacheUpgradeSettings

캐시 업그레이드 설정.
CacheUpgradeStatus

캐시의 소프트웨어 업그레이드 상태를 설명하는 속성입니다.
CacheUsernameDownloadSettings

확장 그룹 사용자 이름 및 그룹 다운로드에 대한 설정입니다.
CloudError

오류 응답입니다.
CloudErrorBody

오류 응답입니다.
Condition

해결해야 하는 미해결 조건입니다.
createdByType

리소스를 만든 ID의 형식입니다.
Credentials

HPC Cache를 도메인에 가입하는 데 사용되는 Active Directory 관리자 자격 증명입니다.
DomainJoinedType

HPC 캐시가 Active Directory 도메인에 가입된 경우 True입니다.
FirmwareStatusType

이 캐시에 설치할 펌웨어 업데이트가 있는 경우 True입니다. 펌웨어는 업그레이드 작업을 통해 이전에 트리거되지 않은 경우 firmwareUpdateDeadline 이후에 자동으로 설치됩니다.
HealthStateType

캐시 상태 목록입니다. 다운은 클러스터가 응답하지 않는 경우입니다. 성능 저하는 작동하지만 몇 가지 경고가 있는 경우입니다. 생성 또는 삭제 시 전환합니다. Unknown은 향후 버전에서 새 값이 추가될 때 이전 API 버전에서 반환됩니다. WaitingForKey는 생성이 암호화 설정에서 암호화 키에 대한 액세스 권한을 부여하기 위해 시스템 할당 ID를 기다리는 경우입니다.
KeyVaultKeyReference

키 자격 증명 모음 키에 대한 참조를 설명합니다.
NfsAccessPolicy

캐시의 NFSv3 클라이언트에 적용되는 액세스 정책을 설명하는 규칙 집합입니다.
NfsAccessRule

클라이언트에 표시되는 캐시 네임스페이스의 일부에 제한을 두는 규칙입니다.
NfsAccessRuleAccess

이 규칙에서 허용하는 액세스입니다.
NfsAccessRuleScope

이 규칙의 범위입니다. 범위 및 필터는 규칙과 일치하는 클라이언트를 결정합니다.
PrimingJob

초기화 작업 인스턴스입니다.
PrimingJobState

프라이밍 작업의 상태입니다.
ProvisioningStateType

ARM 프로비저닝 상태, https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/Addendum.md#provisioningstate-property 참조
Sku

캐시에 대한 SKU입니다.
SourceVault

원본 키 자격 증명 모음에 대한 리소스 ID를 설명합니다.
StorageTargetSpaceAllocation

스토리지 대상 공간 할당 속성입니다.
systemData

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
UserAssignedIdentities

각 키가 사용자 할당 ID 리소스 ID이고 각 키의 값이 빈 사전인 사전입니다.
UsernameDownloadedType

HPC Cache가 사용자 이름 다운로드를 성공적으로 수행했는지 여부를 나타냅니다.
UsernameSource

이 설정은 캐시가 클라이언트의 사용자 이름 및 그룹 이름을 가져오는 방법을 결정합니다.

Cache

Object

캐시 인스턴스입니다. Azure Resource Manager 표준을 따릅니다. https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/resource-api-reference.md

Name 형식 Description
id

string

캐시의 리소스 ID입니다.
identity

CacheIdentity

구성된 경우 캐시의 ID입니다.
location

string

지역 이름 문자열입니다.
name

string

pattern: ^[-0-9a-zA-Z_]{1,80}$

캐시의 이름입니다.
properties.cacheSizeGB

integer (int32)

이 캐시의 크기(GB)입니다.
properties.directoryServicesSettings

CacheDirectorySettings

캐시의 디렉터리 서비스 설정을 지정합니다.
properties.encryptionSettings

CacheEncryptionSettings

캐시의 암호화 설정을 지정합니다.
properties.health

CacheHealth

캐시의 상태입니다.
properties.mountAddresses

string[]

이 캐시를 탑재하는 클라이언트에서 사용할 수 있는 IPv4 주소의 배열입니다.
properties.networkSettings

CacheNetworkSettings

캐시의 네트워크 설정을 지정합니다.
properties.primingJobs

PrimingJob[]

캐시에 정의된 프라이밍 작업을 지정합니다.
properties.provisioningState

ProvisioningStateType

ARM 프로비저닝 상태, https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/Addendum.md#provisioningstate-property 참조
properties.securitySettings

CacheSecuritySettings

캐시의 보안 설정을 지정합니다.
properties.spaceAllocation

StorageTargetSpaceAllocation[]

캐시의 각 스토리지 대상에 대한 공간 할당 백분율을 지정합니다.
properties.subnet

string

캐시에 사용되는 서브넷입니다.
properties.upgradeSettings

CacheUpgradeSettings

캐시의 업그레이드 설정입니다.
properties.upgradeStatus

CacheUpgradeStatus

캐시의 업그레이드 상태입니다.
properties.zones

string[]

리소스에 대한 가용성 영역입니다. 이 필드는 배열에 단일 요소만 포함해야 합니다.
sku

Sku

캐시에 대한 SKU입니다.
systemData

systemData

이 리소스와 관련된 시스템 메타 데이터입니다.
tags

object

리소스 태그.
type

string

캐시 유형; Microsoft.StorageCache/캐시

CacheActiveDirectorySettings

Object

캐시를 도메인에 조인하는 데 사용되는 Active Directory 설정입니다.

Name 형식 Description
cacheNetBiosName

string

pattern: ^[-0-9a-zA-Z]{1,15}$

Active Directory 도메인을 서버로 조인할 때 HPC Cache에 할당할 NetBIOS 이름입니다. 길이는 [-0-9a-zA-Z] 클래스에서 1-15자여야 합니다.
credentials

Credentials

HPC Cache를 도메인에 가입하는 데 사용되는 Active Directory 관리자 자격 증명입니다.
domainJoined

DomainJoinedType

HPC 캐시가 Active Directory 도메인에 가입된 경우 True입니다.
domainName

string

Active Directory 도메인 컨트롤러의 정규화된 도메인 이름입니다.
domainNetBiosName

string

Active Directory 도메인의 NetBIOS 이름입니다.
primaryDnsIpAddress

string

Active Directory 도메인 컨트롤러의 정규화된 도메인 이름을 확인하는 데 사용되는 기본 DNS IP 주소입니다.
secondaryDnsIpAddress

string

Active Directory 도메인 컨트롤러의 정규화된 도메인 이름을 확인하는 데 사용되는 보조 DNS IP 주소입니다.

CacheDirectorySettings

Object

캐시 디렉터리 서비스 설정입니다.

Name 형식 Description
activeDirectory

CacheActiveDirectorySettings

HPC Cache를 Active Directory 도메인에 조인하기 위한 설정을 지정합니다.
usernameDownload

CacheUsernameDownloadSettings

확장 그룹에 대한 설정을 지정합니다. 확장 그룹을 사용하면 사용자가 16개 이상의 그룹의 구성원이 될 수 있습니다.

CacheEncryptionSettings

Object

암호화 설정을 캐시합니다.

Name 형식 Description
keyEncryptionKey

KeyVaultKeyReference

키 자격 증명 모음에서 키 암호화 키의 위치를 지정합니다.
rotationToLatestKeyVersionEnabled

boolean

서비스가 키 자격 증명 모음에서 키의 최신 버전으로 자동으로 회전할지 여부를 지정합니다.

CacheHealth

Object

캐시 상태를 나타냅니다. 프로비전과 관련된 것보다 상태에 대한 자세한 정보를 제공합니다.

Name 형식 Description
conditions

Condition[]

조사하고 해결해야 할 미해결 조건.
state

HealthStateType

캐시 상태 목록입니다. 다운은 클러스터가 응답하지 않는 경우입니다. 성능 저하는 작동하지만 몇 가지 경고가 있는 경우입니다. 생성 또는 삭제 시 전환합니다. Unknown은 향후 버전에서 새 값이 추가될 때 이전 API 버전에서 반환됩니다. WaitingForKey는 생성이 암호화 설정에서 암호화 키에 대한 액세스 권한을 부여하기 위해 시스템 할당 ID를 기다리는 경우입니다.
statusDescription

string

상태에 대한 설명을 설명합니다.

CacheIdentity

Object

캐시 ID 속성입니다.

Name 형식 Description
principalId

string

캐시의 시스템 할당 ID에 대한 보안 주체 ID입니다.
tenantId

string

캐시와 연결된 테넌트 ID입니다.
type

CacheIdentityType

캐시에 사용되는 ID의 형식입니다.
userAssignedIdentities

UserAssignedIdentities

각 키가 사용자 할당 ID 리소스 ID이고 각 키의 값이 빈 사전인 사전입니다.

CacheIdentityType

열거형

캐시에 사용되는 ID의 형식입니다.

값 Description
SystemAssigned
UserAssigned
SystemAssigned, UserAssigned
None

CacheNetworkSettings

Object

네트워크 설정을 캐시합니다.

Name 형식 Default value Description
dnsSearchDomain

string

DNS 검색 도메인
dnsServers

string[]

사용할 캐시의 DNS 서버입니다. 값이 제공되지 않으면 네트워크 구성에서 설정됩니다.
mtu

integer (int32)

minimum: 576
maximum: 1500 		1500

서브넷에 대해 구성된 IPv4 최대 전송 단위입니다.
ntpServer

string

time.windows.com

사용할 캐시의 NTP 서버 IP 주소 또는 FQDN입니다. 기본값은 time.windows.com.
utilityAddresses

string[]

이 캐시에서 사용하는 추가 IP 주소의 배열입니다.

CacheSecuritySettings

Object

보안 설정을 캐시합니다.

Name 형식 Description
accessPolicies

NfsAccessPolicy[]

이 캐시에 대해 정의된 NFS 액세스 정책입니다.

CachesListResult

Object

캐시 나열 요청의 결과입니다. 다음 결과 집합을 가져오기 위한 캐시 목록과 URL 링크가 포함되어 있습니다.

Name 형식 Description
nextLink

string

URL을 사용하여 다음 캐시 목록 결과 세트(있는 경우)를 가져옵니다.
value

Cache[]

캐시 목록.

CacheUpgradeSettings

Object

캐시 업그레이드 설정.

Name 형식 Description
scheduledTime

string (date-time)

upgradeScheduleEnabled가 true이면 이 필드는 사용자가 선택한 업그레이드 시간을 보유합니다. 사용자가 선택한 시간에 펌웨어 업데이트가 캐시에 자동으로 설치됩니다.
upgradeScheduleEnabled

boolean

True이면 현재와 firmwareUpdateDeadline 간에 설치 시간을 선택합니다. 그렇지 않으면 업그레이드 작업을 통해 이전에 트리거되지 않은 경우 firmwareUpdateDeadline 후에 펌웨어가 자동으로 설치됩니다.

CacheUpgradeStatus

Object

캐시의 소프트웨어 업그레이드 상태를 설명하는 속성입니다.

Name 형식 Description
currentFirmwareVersion

string

이 캐시에 현재 설치된 펌웨어의 버전 문자열입니다.
firmwareUpdateDeadline

string (date-time)

보류 중인 펌웨어 업데이트가 캐시에 자동으로 설치되는 시간입니다.
firmwareUpdateStatus

FirmwareStatusType

이 캐시에 설치할 펌웨어 업데이트가 있는 경우 True입니다. 펌웨어는 업그레이드 작업을 통해 이전에 트리거되지 않은 경우 firmwareUpdateDeadline 이후에 자동으로 설치됩니다.
lastFirmwareUpdate

string (date-time)

마지막으로 성공적인 펌웨어 업데이트 시간입니다.
pendingFirmwareVersion

string

firmwareUpdateAvailable이 true이면 이 필드에는 업데이트에 대한 버전 문자열이 포함됩니다.

CacheUsernameDownloadSettings

Object

확장 그룹 사용자 이름 및 그룹 다운로드에 대한 설정입니다.

Name 형식 Default value Description
autoDownloadCertificate

boolean

False

인증서를 자동으로 다운로드해야 하는지 여부를 결정합니다. 'requireValidCertificate'가 true인 경우에만 'caCertificateURI'에 적용됩니다.
caCertificateURI

string

LDAP 보안 연결의 유효성을 검사하는 CA 인증서의 URI입니다. 'requireValidCertificate'가 true로 설정된 경우 이 필드를 채워야 합니다.
credentials

Credentials

있는 경우 보안 LDAP 연결에 대한 자격 증명입니다.
encryptLdapConnection

boolean

False

LDAP 연결을 암호화해야 하는지 여부입니다.
extendedGroups

boolean

확장 그룹을 사용할 수 있는지 여부입니다.
groupFileURI

string

그룹 정보를 포함하는 파일의 URI(/etc/group 파일 형식)입니다. 'usernameSource'가 'File'로 설정된 경우 이 필드를 채워야 합니다.
ldapBaseDN

string

LDAP 도메인의 기본 고유 이름입니다.
ldapServer

string

사용할 LDAP 서버의 정규화된 도메인 이름 또는 IP 주소입니다.
requireValidCertificate

boolean

False

인증 기관에서 인증서의 유효성을 검사해야 하는지 여부를 결정합니다. true이면 caCertificateURI를 제공해야 합니다.
userFileURI

string

사용자 정보를 포함하는 파일의 URI(/etc/passwd 파일 형식)입니다. 'usernameSource'가 'File'로 설정된 경우 이 필드를 채워야 합니다.
usernameDownloaded

UsernameDownloadedType

HPC Cache가 사용자 이름 다운로드를 성공적으로 수행했는지 여부를 나타냅니다.
usernameSource

UsernameSource

None

이 설정은 캐시가 클라이언트의 사용자 이름 및 그룹 이름을 가져오는 방법을 결정합니다.

CloudError

Object

오류 응답입니다.

Name 형식 Description
error

CloudErrorBody

오류의 본문입니다.

CloudErrorBody

Object

오류 응답입니다.

Name 형식 Description
code

string

오류의 식별자입니다. 코드는 고정적이며 프로그래밍 방식으로 사용할 수 있습니다.
details

CloudErrorBody[]

오류에 대한 추가 세부 정보 목록입니다.
message

string

사용자 인터페이스에 표시하기에 적합한 오류를 설명하는 메시지입니다.
target

string

특정 오류의 대상입니다. 예를 들어 오류가 발생한 속성의 이름입니다.

Condition

Object

해결해야 하는 미해결 조건입니다.

Name 형식 Description
message

string

주의가 필요한 문제입니다.
timestamp

string (date-time)

조건이 제기된 시간입니다.

createdByType

열거형

리소스를 만든 ID의 형식입니다.

값 Description
User
Application
ManagedIdentity
Key

Credentials

Object

HPC Cache를 도메인에 가입하는 데 사용되는 Active Directory 관리자 자격 증명입니다.

Name 형식 Description
password

string

Active Directory 도메인 관리자의 일반 텍스트 암호입니다. 이 값은 암호화된 상태로 저장되며 응답에 반환되지 않습니다.
username

string

Active Directory 도메인 관리자의 사용자 이름입니다. 이 값은 암호화된 상태로 저장되며 응답에 반환되지 않습니다.

DomainJoinedType

열거형

HPC 캐시가 Active Directory 도메인에 가입된 경우 True입니다.

값 Description
Yes
No
Error

FirmwareStatusType

열거형

이 캐시에 설치할 펌웨어 업데이트가 있는 경우 True입니다. 펌웨어는 업그레이드 작업을 통해 이전에 트리거되지 않은 경우 firmwareUpdateDeadline 이후에 자동으로 설치됩니다.

값 Description
available
unavailable

HealthStateType

열거형

캐시 상태 목록입니다. 다운은 클러스터가 응답하지 않는 경우입니다. 성능 저하는 작동하지만 몇 가지 경고가 있는 경우입니다. 생성 또는 삭제 시 전환합니다. Unknown은 향후 버전에서 새 값이 추가될 때 이전 API 버전에서 반환됩니다. WaitingForKey는 생성이 암호화 설정에서 암호화 키에 대한 액세스 권한을 부여하기 위해 시스템 할당 ID를 기다리는 경우입니다.

값 Description
Unknown
Healthy
Degraded
Down
Transitioning
Stopping
Stopped
Upgrading
Flushing
WaitingForKey
StartFailed
UpgradeFailed

KeyVaultKeyReference

Object

키 자격 증명 모음 키에 대한 참조를 설명합니다.

Name 형식 Description
keyUrl

string

키 자격 증명 모음의 키 암호화 키를 참조하는 URL입니다.
sourceVault

SourceVault

원본 키 자격 증명 모음에 대한 리소스 ID를 설명합니다.

NfsAccessPolicy

Object

캐시의 NFSv3 클라이언트에 적용되는 액세스 정책을 설명하는 규칙 집합입니다.

Name 형식 Description
accessRules

NfsAccessRule[]

이 정책에 따라 허용되는 클라이언트 액세스를 설명하는 규칙 집합입니다.
name

string

이 정책을 식별하는 이름입니다. 액세스 정책 이름은 대/소문자를 구분하지 않습니다.

NfsAccessRule

Object

클라이언트에 표시되는 캐시 네임스페이스의 일부에 제한을 두는 규칙입니다.

Name 형식 Description
access

NfsAccessRuleAccess

이 규칙에서 허용하는 액세스입니다.
anonymousGID

string

rootSquash가 true일 때 0을 대체하는 GID 값입니다. 이 값은 제공되지 않은 경우 anonymousUID 값을 사용합니다.
anonymousUID

string

rootSquash가 true일 때 0을 대체하는 UID 값입니다. 65534는 제공되지 않은 경우 사용됩니다.
filter

string

이 규칙의 범위에 적용된 필터입니다. 필터의 형식은 해당 범위에 따라 달라집니다. 'default' 범위는 모든 클라이언트와 일치하며 필터 값이 없습니다. '네트워크' 범위는 CIDR 형식으로 필터를 사용합니다(예: 10.99.1.0/24). 'host'는 IP 주소 또는 정규화된 도메인 이름을 필터로 사용합니다. 클라이언트가 필터 규칙과 일치하지 않고 기본 규칙이 없으면 액세스가 거부됩니다.
rootSquash

boolean

루트 액세스를 anonymousUID 및 anonymousGID에 매핑합니다.
scope

NfsAccessRuleScope

이 규칙의 범위입니다. 범위 및 필터는 규칙과 일치하는 클라이언트를 결정합니다.
submountAccess

boolean

기본 정책의 경우 루트 내보내기 아래의 하위 디렉터리에 대한 액세스를 허용합니다. 이 값을 아니요로 설정하면 클라이언트는 경로 '/'만 탑재할 수 있습니다. 예로 설정하면 클라이언트는 '/a/b'와 같은 더 깊은 경로를 탑재할 수 있습니다.
suid

boolean

SUID 의미 체계를 허용합니다.

NfsAccessRuleAccess

열거형

이 규칙에서 허용하는 액세스입니다.

값 Description
no
ro
rw

NfsAccessRuleScope

열거형

이 규칙의 범위입니다. 범위 및 필터는 규칙과 일치하는 클라이언트를 결정합니다.

값 Description
default
network
host

PrimingJob

Object

초기화 작업 인스턴스입니다.

Name 형식 Description
primingJobDetails

string

작업 세부 정보 또는 오류 정보(있는 경우)입니다.
primingJobId

string

pattern: ^[-0-9a-zA-Z_]{1,80}$

프라이밍 작업의 고유 식별자입니다.
primingJobName

string

pattern: ^[-0-9a-zA-Z_]{1,80}$

프라이밍 작업 이름입니다.
primingJobPercentComplete

number (double)

minimum: 0
maximum: 100

프라이밍 작업의 현재 진행률(백분율)입니다.
primingJobState

PrimingJobState

프라이밍 작업의 상태입니다.
primingJobStatus

string

프라이밍 작업의 상태 코드입니다.
primingManifestUrl

string

다운로드할 프라이밍 매니페스트 파일의 URL입니다. 이 파일은 HPC 캐시에서 읽을 수 있어야 합니다. 파일이 Azure Blob Storage에 있는 경우 URL에는 Blob에 대한 읽기 권한을 부여하는 SAS(공유 액세스 서명)가 포함되어야 합니다.

PrimingJobState

열거형

프라이밍 작업의 상태입니다.

값 Description
Queued
Running
Paused
Complete

ProvisioningStateType

열거형

ARM 프로비저닝 상태, https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/Addendum.md#provisioningstate-property 참조

값 Description
Succeeded
Failed
Canceled
Creating
Deleting
Updating

Sku

Object

캐시에 대한 SKU입니다.

Name 형식 Description
name

string

이 캐시의 SKU 이름입니다.

SourceVault

Object

원본 키 자격 증명 모음에 대한 리소스 ID를 설명합니다.

Name 형식 Description
id

string

리소스 ID입니다.

StorageTargetSpaceAllocation

Object

스토리지 대상 공간 할당 속성입니다.

Name 형식 Description
allocationPercentage

integer (int32)

minimum: 1
maximum: 100

이 스토리지 대상에 할당된 캐시 공간의 백분율
name

string

pattern: ^[-0-9a-zA-Z_]{1,80}$

스토리지 대상의 이름입니다.

systemData

Object

리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.

Name 형식 Description
createdAt

string (date-time)

리소스 만들기의 타임스탬프(UTC)입니다.
createdBy

string

리소스를 만든 ID입니다.
createdByType

createdByType

리소스를 만든 ID의 형식입니다.
lastModifiedAt

string (date-time)

리소스 마지막 수정의 타임스탬프(UTC)
lastModifiedBy

string

리소스를 마지막으로 수정한 ID입니다.
lastModifiedByType

createdByType

리소스를 마지막으로 수정한 ID의 형식입니다.

UserAssignedIdentities

Object

각 키가 사용자 할당 ID 리소스 ID이고 각 키의 값이 빈 사전인 사전입니다.

Name 형식 Description

UsernameDownloadedType

열거형

HPC Cache가 사용자 이름 다운로드를 성공적으로 수행했는지 여부를 나타냅니다.

값 Description
Yes
No
Error

UsernameSource

열거형

이 설정은 캐시가 클라이언트의 사용자 이름 및 그룹 이름을 가져오는 방법을 결정합니다.

값 Description
AD
LDAP
File
None