Accounts - Get
매개 변수로 지정된 Cognitive Services 계정을 반환합니다.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{accountName}?api-version=2024-10-01
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
account
|
path | True |
string minLength: 2maxLength: 64 pattern: ^[a-zA-Z0-9][a-zA-Z0-9_.-]*$ |
Cognitive Services 계정의 이름입니다. |
resource
|
path | True |
string minLength: 1maxLength: 90 |
리소스 그룹의 이름입니다. 이름은 대/소문자를 구분하지 않습니다. |
subscription
|
path | True |
string minLength: 1 |
대상 구독의 ID입니다. |
api-version
|
query | True |
string minLength: 1 |
이 작업에 사용할 API 버전입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
리소스 공급자는 작업이 성공적으로 완료되었음을 나타내기 위해 200(확인)을 반환해야 합니다. 응답 본문의 각 필드에 대한 자세한 설명은 PUT 리소스 섹션의 요청 본문 설명을 참조하세요. 유일한 GET 특정 속성은 "name", "type" 및 "id"입니다. 필드 설명 종류가 필요합니다. 문자열. 이 API 계정에 대한 API 집합입니다. · 될 수 있습니다. 단일 API(예: Face API, Vision API, Speech API). API 번들: Face + Speech, Vision + Emotion 등 sku.name 필수입니다. 이 API의 가격 책정 계층/계획입니다. 가능: F0 - 무료 B0 - 기본 S0 - 표준 P0 - 프리미엄 |
|
Other Status Codes |
작업이 실패한 이유를 설명하는 오류 응답입니다. 리소스가 없으면 404(NotFound)가 반환되어야 합니다. |
예제
Get Account
샘플 요청
샘플 응답
{
"id": "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.CognitiveServices/accounts/myAccount",
"name": "myAccount",
"type": "Microsoft.CognitiveServices/accounts",
"location": "westus",
"sku": {
"name": "F0"
},
"kind": "Emotion",
"tags": {
"Owner": "felixwa",
"ExpiredDate": "2017/09/01"
},
"etag": "W/\"datetime'2017-04-10T04%3A42%3A19.7067387Z'\"",
"properties": {
"endpoint": "https://westus.api.cognitive.microsoft.com/emotion/v1.0",
"provisioningState": "Succeeded"
}
}
정의
Name | Description |
---|---|
Abuse |
학대 처벌. |
Abuse |
AbusePenalty의 동작입니다. |
Account |
Cognitive Services 계정은 프로비전된 계정을 나타내는 Azure 리소스로, 유형, 위치 및 SKU입니다. |
Account |
Cognitive Services 계정의 속성입니다. |
Api |
특수 API에 대한 api 속성입니다. |
By |
신뢰할 수 있는 서비스에 대한 설정입니다. |
Call |
호출 속도 제한 Cognitive Services 계정입니다. |
Commitment |
약정 플랜 연결입니다. |
created |
리소스를 만든 ID의 형식입니다. |
Encryption |
암호화를 구성하는 속성 |
Error |
리소스 관리 오류 추가 정보입니다. |
Error |
오류 세부 정보입니다. |
Error |
오류 응답 |
Identity |
리소스의 ID입니다. |
Ip |
특정 IP 주소 또는 IP 범위의 접근성을 제어하는 규칙입니다. |
key |
암호화에 대한 keySource의 가능한 값을 열거합니다. |
Key |
keyVault 속성을 구성하는 속성 |
Multi |
Multiregion 설정 Cognitive Services 계정입니다. |
Network |
ipRules 및 virtualNetworkRules의 규칙이 일치하지 않는 경우의 기본 작업입니다. 바이패스 속성이 평가된 후에만 사용됩니다. |
Network |
네트워크 접근성을 제어하는 규칙 집합입니다. |
Private |
프라이빗 엔드포인트 리소스입니다. |
Private |
프라이빗 엔드포인트 연결 리소스입니다. |
Private |
PrivateEndpointConnectProperties의 속성입니다. |
Private |
현재 프로비저닝 상태입니다. |
Private |
프라이빗 엔드포인트 연결 상태입니다. |
Private |
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다. |
Provisioning |
작업이 호출되었을 때 Cognitive Services 계정의 상태를 가져옵니다. |
Public |
이 계정에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. |
Quota |
|
Rai |
Cognitive Services Rai Monitor 구성. |
Region |
호출 속도 제한 Cognitive Services 계정입니다. |
Request |
|
Resource |
ID 형식입니다. |
Routing |
다중region 라우팅 메서드. |
Sku |
SKU를 나타내는 리소스 모델 정의 |
Sku |
SkuCapability는 특정 기능의 기능을 나타냅니다. |
Sku |
SKU 계정의 정보를 변경합니다. |
Sku |
이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. |
system |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
Throttling |
|
User |
사용자가 할당한 관리 ID입니다. |
User |
사용자가 Cognitive Services 계정에 대한 AML 작업 영역을 소유했습니다. |
User |
Cognitive Services 계정에 대한 사용자 소유 스토리지입니다. |
Virtual |
특정 가상 네트워크의 접근성을 제어하는 규칙입니다. |
AbusePenalty
학대 처벌.
Name | 형식 | Description |
---|---|---|
action |
AbusePenalty의 동작입니다. |
|
expiration |
string (date-time) |
AbusePenalty 만료 날짜 시간입니다. |
rateLimitPercentage |
number |
속도 제한의 백분율입니다. |
AbusePenaltyAction
AbusePenalty의 동작입니다.
값 | Description |
---|---|
Block | |
Throttle |
Account
Cognitive Services 계정은 프로비전된 계정을 나타내는 Azure 리소스로, 유형, 위치 및 SKU입니다.
Name | 형식 | Description |
---|---|---|
etag |
string |
리소스 Etag. |
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
identity |
리소스의 ID입니다. |
|
kind |
string |
리소스의 종류입니다. |
location |
string |
리소스가 있는 지리적 위치 |
name |
string |
리소스의 이름 |
properties |
Cognitive Services 계정의 속성입니다. |
|
sku |
SKU를 나타내는 리소스 모델 정의 |
|
systemData |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
|
tags |
object |
리소스 태그. |
type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
AccountProperties
Cognitive Services 계정의 속성입니다.
Name | 형식 | Description |
---|---|---|
abusePenalty |
학대 처벌. |
|
allowedFqdnList |
string[] |
|
amlWorkspace |
사용자가 소유한 AML 작업 영역 속성입니다. |
|
apiProperties |
특수 API에 대한 api 속성입니다. |
|
callRateLimit |
호출 속도 제한 Cognitive Services 계정입니다. |
|
capabilities |
Cognitive Services 계정의 기능을 가져옵니다. 각 항목은 특정 기능의 기능을 나타냅니다. 값은 읽기 전용이며 참조 전용입니다. |
|
commitmentPlanAssociations |
Cognitive Services 계정의 약정 계획 연결입니다. |
|
customSubDomainName |
string |
토큰 기반 인증에 사용되는 선택적 하위 도메인 이름입니다. |
dateCreated |
string |
Cognitive Services 계정 생성 날짜를 가져옵니다. |
deletionDate |
string |
삭제된 계정에만 사용할 수 있는 삭제 날짜입니다. |
disableLocalAuth |
boolean |
|
dynamicThrottlingEnabled |
boolean |
동적 제한을 사용하도록 설정하는 플래그입니다. |
encryption |
이 리소스의 암호화 속성입니다. |
|
endpoint |
string |
만든 계정의 엔드포인트입니다. |
endpoints |
object |
|
internalId |
string |
내부 식별자입니다(사용되지 않으며 이 속성을 사용하지 않음). |
isMigrated |
boolean |
리소스가 기존 키에서 마이그레이션되는 경우 |
locations |
Cognitive Services 계정의 다중 변경 설정입니다. |
|
migrationToken |
string |
리소스 마이그레이션 토큰입니다. |
networkAcls |
특정 네트워크 위치의 접근성을 제어하는 규칙의 컬렉션입니다. |
|
privateEndpointConnections |
Cognitive Services 계정과 연결된 프라이빗 엔드포인트 연결입니다. |
|
provisioningState |
작업이 호출되었을 때 Cognitive Services 계정의 상태를 가져옵니다. |
|
publicNetworkAccess |
이 계정에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. |
|
quotaLimit | ||
raiMonitorConfig |
Cognitive Services Rai Monitor 구성. |
|
restore |
boolean |
|
restrictOutboundNetworkAccess |
boolean |
|
scheduledPurgeDate |
string |
예약된 제거 날짜로, 삭제된 계정에만 사용할 수 있습니다. |
skuChangeInfo |
SKU 계정의 정보를 변경합니다. |
|
userOwnedStorage |
이 리소스에 대한 스토리지 계정입니다. |
ApiProperties
특수 API에 대한 api 속성입니다.
Name | 형식 | Description |
---|---|---|
aadClientId |
string maxLength: 500 |
(Metrics Advisor만 해당) Azure AD 클라이언트 ID(애플리케이션 ID)입니다. |
aadTenantId |
string maxLength: 500 |
(Metrics Advisor만 해당) Azure AD 테넌트 ID입니다. |
eventHubConnectionString |
string maxLength: 1000pattern: ^( *)Endpoint=sb://(.*);( *)SharedAccessKeyName=(.*);( *)SharedAccessKey=(.*)$ |
(개인 설정만 해당) Bing Search의 통계를 사용하도록 설정하는 플래그입니다. |
qnaAzureSearchEndpointId |
string |
(QnAMaker만 해당) QnAMaker의 Azure Search 엔드포인트 ID입니다. |
qnaAzureSearchEndpointKey |
string |
(QnAMaker만 해당) QnAMaker의 Azure Search 엔드포인트 키입니다. |
qnaRuntimeEndpoint |
string |
(QnAMaker만 해당) QnAMaker의 런타임 엔드포인트입니다. |
statisticsEnabled |
boolean |
(Bing Search만 해당) Bing Search의 통계를 사용하도록 설정하는 플래그입니다. |
storageAccountConnectionString |
string maxLength: 1000pattern: ^(( *)DefaultEndpointsProtocol=(http|https)( *);( *))?AccountName=(.*)AccountKey=(.*)EndpointSuffix=(.*)$ |
(개인 설정만 해당) 스토리지 계정 연결 문자열입니다. |
superUser |
string maxLength: 500 |
(Metrics Advisor만 해당) 메트릭 관리자의 슈퍼 사용자입니다. |
websiteName |
string maxLength: 500 |
(Metrics Advisor만 해당) Metrics Advisor의 웹 사이트 이름입니다. |
ByPassSelection
신뢰할 수 있는 서비스에 대한 설정입니다.
값 | Description |
---|---|
AzureServices | |
None |
CallRateLimit
호출 속도 제한 Cognitive Services 계정입니다.
Name | 형식 | Description |
---|---|---|
count |
number |
호출 속도 제한의 개수 값입니다. |
renewalPeriod |
number |
통화 속도 제한의 갱신 기간(초)입니다. |
rules |
CommitmentPlanAssociation
약정 플랜 연결입니다.
Name | 형식 | Description |
---|---|---|
commitmentPlanId |
string |
약정 계획의 Azure 리소스 ID입니다. |
commitmentPlanLocation |
string |
약정 플랜의 위치입니다. |
createdByType
리소스를 만든 ID의 형식입니다.
값 | Description |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
Encryption
암호화를 구성하는 속성
Name | 형식 | Default value | Description |
---|---|---|---|
keySource | Microsoft.KeyVault |
암호화에 대한 keySource의 가능한 값을 열거합니다. |
|
keyVaultProperties |
KeyVault의 속성 |
ErrorAdditionalInfo
리소스 관리 오류 추가 정보입니다.
Name | 형식 | Description |
---|---|---|
info |
object |
추가 정보입니다. |
type |
string |
추가 정보 유형입니다. |
ErrorDetail
오류 세부 정보입니다.
Name | 형식 | Description |
---|---|---|
additionalInfo |
오류 추가 정보입니다. |
|
code |
string |
오류 코드입니다. |
details |
오류 세부 정보입니다. |
|
message |
string |
오류 메시지입니다. |
target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
Name | 형식 | Description |
---|---|---|
error |
오류 개체입니다. |
Identity
리소스의 ID입니다.
Name | 형식 | Description |
---|---|---|
principalId |
string |
리소스 ID의 보안 주체 ID입니다. |
tenantId |
string |
리소스의 테넌트 ID입니다. |
type |
ID 형식입니다. |
|
userAssignedIdentities |
<string,
User |
리소스와 연결된 사용자 할당 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다. |
IpRule
특정 IP 주소 또는 IP 범위의 접근성을 제어하는 규칙입니다.
Name | 형식 | Description |
---|---|---|
value |
string |
CIDR 표기법의 IPv4 주소 범위(예: '124.56.78.91'(단순 IP 주소) 또는 '124.56.78.0/24'(124.56.78로 시작하는 모든 주소). |
keySource
암호화에 대한 keySource의 가능한 값을 열거합니다.
값 | Description |
---|---|
Microsoft.CognitiveServices | |
Microsoft.KeyVault |
KeyVaultProperties
keyVault 속성을 구성하는 속성
Name | 형식 | Description |
---|---|---|
identityClientId |
string |
|
keyName |
string |
KeyVault의 키 이름 |
keyVaultUri |
string |
KeyVault의 URI |
keyVersion |
string |
KeyVault의 키 버전 |
MultiRegionSettings
Multiregion 설정 Cognitive Services 계정입니다.
Name | 형식 | Description |
---|---|---|
regions |
호출 속도 제한 Cognitive Services 계정입니다. |
|
routingMethod |
다중region 라우팅 메서드. |
NetworkRuleAction
ipRules 및 virtualNetworkRules의 규칙이 일치하지 않는 경우의 기본 작업입니다. 바이패스 속성이 평가된 후에만 사용됩니다.
값 | Description |
---|---|
Allow | |
Deny |
NetworkRuleSet
네트워크 접근성을 제어하는 규칙 집합입니다.
Name | 형식 | Description |
---|---|---|
bypass |
신뢰할 수 있는 서비스에 대한 설정입니다. |
|
defaultAction |
ipRules 및 virtualNetworkRules의 규칙이 일치하지 않는 경우의 기본 작업입니다. 바이패스 속성이 평가된 후에만 사용됩니다. |
|
ipRules |
Ip |
IP 주소 규칙 목록입니다. |
virtualNetworkRules |
가상 네트워크 규칙 목록입니다. |
PrivateEndpoint
프라이빗 엔드포인트 리소스입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
프라이빗 엔드포인트에 대한 ARM 식별자 |
PrivateEndpointConnection
프라이빗 엔드포인트 연결 리소스입니다.
Name | 형식 | Description |
---|---|---|
etag |
string |
리소스 Etag. |
id |
string |
리소스에 대한 정규화된 리소스 ID입니다. 예 - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} |
location |
string |
프라이빗 엔드포인트 연결의 위치 |
name |
string |
리소스의 이름 |
properties |
리소스 속성입니다. |
|
systemData |
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다. |
|
type |
string |
리소스의 형식입니다. 예: "Microsoft.Compute/virtualMachines" 또는 "Microsoft.Storage/storageAccounts" |
PrivateEndpointConnectionProperties
PrivateEndpointConnectProperties의 속성입니다.
Name | 형식 | Description |
---|---|---|
groupIds |
string[] |
프라이빗 링크 리소스 그룹 ID입니다. |
privateEndpoint |
프라이빗 엔드포인트의 리소스입니다. |
|
privateLinkServiceConnectionState |
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다. |
|
provisioningState |
프라이빗 엔드포인트 연결 리소스의 프로비전 상태입니다. |
PrivateEndpointConnectionProvisioningState
현재 프로비저닝 상태입니다.
값 | Description |
---|---|
Creating | |
Deleting | |
Failed | |
Succeeded |
PrivateEndpointServiceConnectionStatus
프라이빗 엔드포인트 연결 상태입니다.
값 | Description |
---|---|
Approved | |
Pending | |
Rejected |
PrivateLinkServiceConnectionState
서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.
Name | 형식 | Description |
---|---|---|
actionsRequired |
string |
서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다. |
description |
string |
연결의 승인/거부 이유입니다. |
status |
서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다. |
ProvisioningState
작업이 호출되었을 때 Cognitive Services 계정의 상태를 가져옵니다.
값 | Description |
---|---|
Accepted | |
Creating | |
Deleting | |
Failed | |
Moving | |
ResolvingDNS | |
Succeeded |
PublicNetworkAccess
이 계정에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다.
값 | Description |
---|---|
Disabled | |
Enabled |
QuotaLimit
Name | 형식 | Description |
---|---|---|
count |
number |
|
renewalPeriod |
number |
|
rules |
RaiMonitorConfig
Cognitive Services Rai Monitor 구성.
Name | 형식 | Description |
---|---|---|
adxStorageResourceId |
string |
스토리지 리소스 ID입니다. |
identityClientId |
string |
스토리지에 액세스할 ID 클라이언트 ID입니다. |
RegionSetting
호출 속도 제한 Cognitive Services 계정입니다.
Name | 형식 | Description |
---|---|---|
customsubdomain |
string |
지역을 지역 사용자 지정 하위 도메인에 매핑합니다. |
name |
string |
지역 이름입니다. |
value |
number |
우선 순위 또는 가중 라우팅 메서드의 값입니다. |
RequestMatchPattern
Name | 형식 | Description |
---|---|---|
method |
string |
|
path |
string |
ResourceIdentityType
ID 형식입니다.
값 | Description |
---|---|
None | |
SystemAssigned | |
SystemAssigned, UserAssigned | |
UserAssigned |
RoutingMethods
다중region 라우팅 메서드.
값 | Description |
---|---|
Performance | |
Priority | |
Weighted |
Sku
SKU를 나타내는 리소스 모델 정의
Name | 형식 | Description |
---|---|---|
capacity |
integer (int32) |
SKU가 스케일 아웃/인을 지원하는 경우 용량 정수가 포함되어야 합니다. 리소스에 대해 스케일 아웃/인이 불가능한 경우 생략할 수 있습니다. |
family |
string |
서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. |
name |
string |
SKU의 이름입니다. 예 - P3. 일반적으로 letter+number 코드입니다. |
size |
string |
SKU 크기입니다. 이름 필드가 계층과 다른 값의 조합인 경우 독립 실행형 코드입니다. |
tier |
이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다. |
SkuCapability
SkuCapability는 특정 기능의 기능을 나타냅니다.
Name | 형식 | Description |
---|---|---|
name |
string |
SkuCapability의 이름입니다. |
value |
string |
SkuCapability의 값입니다. |
SkuChangeInfo
SKU 계정의 정보를 변경합니다.
Name | 형식 | Description |
---|---|---|
countOfDowngrades |
number |
다운그레이드 횟수를 가져옵니다. |
countOfUpgradesAfterDowngrades |
number |
다운그레이드 후 업그레이드 수를 가져옵니다. |
lastChangeDate |
string |
마지막 변경 날짜를 가져옵니다. |
SkuTier
이 필드는 서비스에 둘 이상의 계층이 있지만 PUT에는 필요하지 않은 경우 리소스 공급자가 구현해야 합니다.
값 | Description |
---|---|
Basic | |
Enterprise | |
Free | |
Premium | |
Standard |
systemData
리소스의 생성 및 마지막 수정과 관련된 메타데이터입니다.
Name | 형식 | Description |
---|---|---|
createdAt |
string (date-time) |
리소스 만들기의 타임스탬프(UTC)입니다. |
createdBy |
string |
리소스를 만든 ID입니다. |
createdByType |
리소스를 만든 ID의 형식입니다. |
|
lastModifiedAt |
string (date-time) |
리소스 마지막 수정의 타임스탬프(UTC) |
lastModifiedBy |
string |
리소스를 마지막으로 수정한 ID입니다. |
lastModifiedByType |
리소스를 마지막으로 수정한 ID의 형식입니다. |
ThrottlingRule
Name | 형식 | Description |
---|---|---|
count |
number |
|
dynamicThrottlingEnabled |
boolean |
|
key |
string |
|
matchPatterns | ||
minCount |
number |
|
renewalPeriod |
number |
UserAssignedIdentity
사용자가 할당한 관리 ID입니다.
Name | 형식 | Description |
---|---|---|
clientId |
string |
이 ID와 연결된 클라이언트 앱 ID입니다. |
principalId |
string |
이 ID와 연결된 Azure Active Directory 보안 주체 ID입니다. |
UserOwnedAmlWorkspace
사용자가 Cognitive Services 계정에 대한 AML 작업 영역을 소유했습니다.
Name | 형식 | Description |
---|---|---|
identityClientId |
string |
AML 작업 영역 리소스의 ID 클라이언트 ID입니다. |
resourceId |
string |
AML 작업 영역 리소스의 전체 리소스 ID입니다. |
UserOwnedStorage
Cognitive Services 계정에 대한 사용자 소유 스토리지입니다.
Name | 형식 | Description |
---|---|---|
identityClientId |
string |
|
resourceId |
string |
Microsoft.Storage 리소스의 전체 리소스 ID입니다. |
VirtualNetworkRule
특정 가상 네트워크의 접근성을 제어하는 규칙입니다.
Name | 형식 | Description |
---|---|---|
id |
string |
'/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'과 같은 vnet 서브넷의 전체 리소스 ID입니다. |
ignoreMissingVnetServiceEndpoint |
boolean |
누락된 vnet 서비스 엔드포인트를 무시합니다. |
state |
string |
가상 네트워크 규칙의 상태를 가져옵니다. |