Microsoft.CognitiveServices 계정 2017-04-18

아티클
12/21/2024

Bicep 리소스 정의

다음을 대상으로 하는 작업으로 계정 리소스 유형을 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.CognitiveServices/accounts 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.

resource symbolicname 'Microsoft.CognitiveServices/accounts@2017-04-18' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {
        clientId: 'string'
        principalId: 'string'
      }
    }
  }
  kind: 'string'
  location: 'string'
  name: 'string'
  properties: {
    apiProperties: {
      aadClientId: 'string'
      aadTenantId: 'string'
      eventHubConnectionString: 'string'
      qnaAzureSearchEndpointId: 'string'
      qnaAzureSearchEndpointKey: 'string'
      qnaRuntimeEndpoint: 'string'
      statisticsEnabled: bool
      storageAccountConnectionString: 'string'
      superUser: 'string'
      websiteName: 'string'
    }
    customSubDomainName: 'string'
    encryption: {
      keySource: 'string'
      keyVaultProperties: {
        keyName: 'string'
        keyVaultUri: 'string'
        keyVersion: 'string'
      }
    }
    networkAcls: {
      defaultAction: 'string'
      ipRules: [
        {
          value: 'string'
        }
      ]
      virtualNetworkRules: [
        {
          id: 'string'
          ignoreMissingVnetServiceEndpoint: bool
          state: 'string'
        }
      ]
    }
    privateEndpointConnections: [
      {
        location: 'string'
        properties: {
          groupIds: [
            'string'
          ]
          privateEndpoint: {}
          privateLinkServiceConnectionState: {
            actionsRequired: 'string'
            description: 'string'
            status: 'string'
          }
        }
      }
    ]
    publicNetworkAccess: 'string'
    userOwnedStorage: [
      {
        resourceId: 'string'
      }
    ]
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

속성 값

CognitiveServicesAccountApiProperties

이름	묘사	값
aadClientId	(Metrics Advisor만 해당) Azure AD 클라이언트 ID(애플리케이션 ID)입니다.	문자열 제약 조건: 최대 길이 = 500
aadTenantId	(Metrics Advisor만 해당) Azure AD 테넌트 ID입니다.	문자열 제약 조건: 최대 길이 = 500
eventHubConnectionString	(개인 설정만 해당) Bing Search의 통계를 사용하도록 설정하는 플래그입니다.	문자열 제약 조건: 최대 길이 = 1000 패턴 = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(QnAMaker만 해당) QnAMaker의 Azure Search 엔드포인트 ID입니다.	문자열
qnaAzureSearchEndpointKey	(QnAMaker만 해당) QnAMaker의 Azure Search 엔드포인트 키입니다.	문자열
qnaRuntimeEndpoint	(QnAMaker만 해당) QnAMaker의 런타임 엔드포인트입니다.	문자열
statisticsEnabled	(Bing Search만 해당) Bing Search의 통계를 사용하도록 설정하는 플래그입니다.	bool
storageAccountConnectionString	(개인 설정만 해당) 스토리지 계정 연결 문자열입니다.	문자열 제약 조건: 최대 길이 = 1000 패턴 = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
수퍼유저	(Metrics Advisor만 해당) 메트릭 관리자의 슈퍼 사용자입니다.	문자열 제약 조건: 최대 길이 = 500
websiteName	(Metrics Advisor만 해당) Metrics Advisor의 웹 사이트 이름입니다.	문자열 제약 조건: 최대 길이 = 500

CognitiveServicesAccountProperties

이름	묘사	값
apiProperties	특수 API에 대한 api 속성입니다.	cognitiveServicesAccountApiProperties
customSubDomainName	토큰 기반 인증에 사용되는 선택적 하위 도메인 이름입니다.	문자열
암호화	이 리소스의 암호화 속성입니다.	암호화
networkAcls	특정 네트워크 위치의 접근성을 제어하는 규칙의 컬렉션입니다.	NetworkRuleSet
privateEndpointConnections	Cognitive Services 계정과 연결된 프라이빗 엔드포인트 연결입니다.	PrivateEndpointConnection[]
publicNetworkAccess	이 계정에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.	'사용 안 함' 'Enabled'
userOwnedStorage	이 리소스에 대한 스토리지 계정입니다.	userOwnedStorage[]

CognitiveServicesAccountTags

이름	묘사	값

암호화

이름	묘사	값
keySource	암호화에 대한 keySource의 가능한 값을 열거합니다.	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultProperties	KeyVault의 속성	KeyVaultProperties

신원

이름	묘사	값
형	관리 서비스 ID의 유형입니다.	'None' 'SystemAssigned' 'UserAssigned'
userAssignedIdentities	리소스와 연결된 사용자 할당 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

이름	묘사	값

IpRule

이름	묘사	값
값	CIDR 표기법의 IPv4 주소 범위(예: '124.56.78.91'(단순 IP 주소) 또는 '124.56.78.0/24'(124.56.78로 시작하는 모든 주소).	string(필수)

KeyVaultProperties

이름	묘사	값
keyName	KeyVault의 키 이름	문자열
keyVaultUri	KeyVault의 URI	문자열
keyVersion	KeyVault의 키 버전	문자열

Microsoft.CognitiveServices/accounts

이름	묘사	값
신원	Cognitive Services 계정의 ID입니다.	ID
종류	리소스의 종류입니다.	문자열
위치	리소스의 위치	문자열
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 2 최대 길이 = 64 패턴 = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$`(필수)
속성	Cognitive Services 계정의 속성입니다.	CognitiveServicesAccountProperties
sku	Cognitive Services 계정의 SKU입니다.	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.

NetworkRuleSet

이름	묘사	값
defaultAction	ipRules 및 virtualNetworkRules의 규칙이 일치하지 않는 경우의 기본 작업입니다. 바이패스 속성이 평가된 후에만 사용됩니다.	'허용' '거부'
ipRules	IP 주소 규칙 목록입니다.	ipRule[]
virtualNetworkRules	가상 네트워크 규칙 목록입니다.	VirtualNetworkRule[]

PrivateEndpoint

이름	묘사	값

PrivateEndpointConnection

이름	묘사	값
위치	프라이빗 엔드포인트 연결의 위치	문자열
속성	리소스 속성입니다.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

이름	묘사	값
groupIds	프라이빗 링크 리소스 그룹 ID입니다.	string[]
privateEndpoint	프라이빗 엔드포인트의 리소스입니다.	PrivateEndpoint
privateLinkServiceConnectionState	서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.	PrivateLinkServiceConnectionState(필수)

PrivateLinkServiceConnectionState

이름	묘사	값
actionsRequired	서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.	문자열
묘사	연결의 승인/거부 이유입니다.	문자열
상태	서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다.	'승인됨' '연결 끊김' '보류 중' '거부됨'

Sku

이름	묘사	값
이름	sku 이름을 가져오거나 설정합니다. 계정 만들기에 필요하며 업데이트에 대한 선택 사항입니다.	string(필수)

UserAssignedIdentity

이름	묘사	값
clientId	이 ID와 연결된 클라이언트 앱 ID입니다.	문자열
principalId	이 ID와 연결된 Azure Active Directory 보안 주체 ID입니다.	문자열

UserOwnedStorage

이름	묘사	값
resourceId	Microsoft.Storage 리소스의 전체 리소스 ID입니다.	문자열

VirtualNetworkRule

이름	묘사	값
아이디	'/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'과 같은 vnet 서브넷의 전체 리소스 ID입니다.	string(필수)
ignoreMissingVnetServiceEndpoint	누락된 vnet 서비스 엔드포인트를 무시합니다.	bool
상태	가상 네트워크 규칙의 상태를 가져옵니다.	문자열

빠른 시작 샘플

다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.

Bicep 파일	묘사
Azure AI Studio 기본 설정	이 템플릿 집합은 기본 설정으로 Azure AI Studio를 설정하는 방법을 보여 줍니다. 즉, 공용 인터넷 액세스를 사용하도록 설정, 암호화를 위한 Microsoft 관리형 키 및 AI 리소스에 대한 Microsoft 관리 ID 구성을 의미합니다.
Azure AI Studio 기본 설정	이 템플릿 집합은 기본 설정으로 Azure AI Studio를 설정하는 방법을 보여 줍니다. 즉, 공용 인터넷 액세스를 사용하도록 설정, 암호화를 위한 Microsoft 관리형 키 및 AI 리소스에 대한 Microsoft 관리 ID 구성을 의미합니다.
Azure AI Studio 기본 설정	이 템플릿 집합은 기본 설정으로 Azure AI Studio를 설정하는 방법을 보여 줍니다. 즉, 공용 인터넷 액세스를 사용하도록 설정, 암호화를 위한 Microsoft 관리형 키 및 AI 리소스에 대한 Microsoft 관리 ID 구성을 의미합니다.
Azure AI Studio 네트워크 제한	이 템플릿 집합은 암호화를 위해 Microsoft 관리형 키를 사용하고 AI 리소스에 대한 Microsoft 관리 ID 구성을 사용하여 프라이빗 링크 및 송신을 사용하지 않도록 설정하여 Azure AI Studio를 설정하는 방법을 보여 줍니다.
Azure AI Studio 네트워크 제한	이 템플릿 집합은 암호화를 위해 Microsoft 관리형 키를 사용하고 AI 리소스에 대한 Microsoft 관리 ID 구성을 사용하여 프라이빗 링크 및 송신을 사용하지 않도록 설정하여 Azure AI Studio를 설정하는 방법을 보여 줍니다.
Microsoft Entra ID 인증 사용하여 Azure AI Studio	이 템플릿 집합은 Azure AI Services 및 Azure Storage와 같은 종속 리소스에 대해 Microsoft Entra ID 인증을 사용하여 Azure AI Studio를 설정하는 방법을 보여 줍니다.
Azure AI 서비스 다중 서비스 리소스 배포	이 템플릿은 기계 학습 전문 지식 없이도 모든 개발자의 손이 닿는 범위 내에서 AI를 가져오는 Azure AI 서비스 리소스를 배포합니다. 앱에서 의사 결정을 보고, 듣고, 말하고, 검색하고, 이해하고, 가속화하는 기능을 포함하는 API 호출만 있으면 됩니다.
Azure AI Translator 리소스 배포	이 템플릿은 기계 학습 전문 지식 없이도 모든 개발자의 손이 닿는 범위 내에서 AI를 가져오는 Azure AI Translator 리소스를 배포합니다.
Azure AI Vision 리소스 배포	이 템플릿은 기계 학습 전문 지식 없이도 모든 개발자의 손이 닿는 범위 내에서 AI를 가져오는 Azure AI Vision 리소스를 배포합니다.
관리형 가상 네트워크 사용하여 보안 Azure AI Studio 배포	이 템플릿은 강력한 네트워크 및 ID 보안 제한을 사용하여 안전한 Azure AI Studio 환경을 만듭니다.

ARM 템플릿 리소스 정의

다음을 대상으로 하는 작업으로 계정 리소스 유형을 배포할 수 있습니다.

리소스 그룹 - 리소스 그룹 배포 명령 참조

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.CognitiveServices/accounts 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.

{
  "type": "Microsoft.CognitiveServices/accounts",
  "apiVersion": "2017-04-18",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
        "clientId": "string",
        "principalId": "string"
      }
    }
  },
  "kind": "string",
  "location": "string",
  "properties": {
    "apiProperties": {
      "aadClientId": "string",
      "aadTenantId": "string",
      "eventHubConnectionString": "string",
      "qnaAzureSearchEndpointId": "string",
      "qnaAzureSearchEndpointKey": "string",
      "qnaRuntimeEndpoint": "string",
      "statisticsEnabled": "bool",
      "storageAccountConnectionString": "string",
      "superUser": "string",
      "websiteName": "string"
    },
    "customSubDomainName": "string",
    "encryption": {
      "keySource": "string",
      "keyVaultProperties": {
        "keyName": "string",
        "keyVaultUri": "string",
        "keyVersion": "string"
      }
    },
    "networkAcls": {
      "defaultAction": "string",
      "ipRules": [
        {
          "value": "string"
        }
      ],
      "virtualNetworkRules": [
        {
          "id": "string",
          "ignoreMissingVnetServiceEndpoint": "bool",
          "state": "string"
        }
      ]
    },
    "privateEndpointConnections": [
      {
        "location": "string",
        "properties": {
          "groupIds": [ "string" ],
          "privateEndpoint": {
          },
          "privateLinkServiceConnectionState": {
            "actionsRequired": "string",
            "description": "string",
            "status": "string"
          }
        }
      }
    ],
    "publicNetworkAccess": "string",
    "userOwnedStorage": [
      {
        "resourceId": "string"
      }
    ]
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

속성 값

CognitiveServicesAccountApiProperties

이름	묘사	값
aadClientId	(Metrics Advisor만 해당) Azure AD 클라이언트 ID(애플리케이션 ID)입니다.	문자열 제약 조건: 최대 길이 = 500
aadTenantId	(Metrics Advisor만 해당) Azure AD 테넌트 ID입니다.	문자열 제약 조건: 최대 길이 = 500
eventHubConnectionString	(개인 설정만 해당) Bing Search의 통계를 사용하도록 설정하는 플래그입니다.	문자열 제약 조건: 최대 길이 = 1000 패턴 = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(QnAMaker만 해당) QnAMaker의 Azure Search 엔드포인트 ID입니다.	문자열
qnaAzureSearchEndpointKey	(QnAMaker만 해당) QnAMaker의 Azure Search 엔드포인트 키입니다.	문자열
qnaRuntimeEndpoint	(QnAMaker만 해당) QnAMaker의 런타임 엔드포인트입니다.	문자열
statisticsEnabled	(Bing Search만 해당) Bing Search의 통계를 사용하도록 설정하는 플래그입니다.	bool
storageAccountConnectionString	(개인 설정만 해당) 스토리지 계정 연결 문자열입니다.	문자열 제약 조건: 최대 길이 = 1000 패턴 = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
수퍼유저	(Metrics Advisor만 해당) 메트릭 관리자의 슈퍼 사용자입니다.	문자열 제약 조건: 최대 길이 = 500
websiteName	(Metrics Advisor만 해당) Metrics Advisor의 웹 사이트 이름입니다.	문자열 제약 조건: 최대 길이 = 500

CognitiveServicesAccountProperties

이름	묘사	값
apiProperties	특수 API에 대한 api 속성입니다.	cognitiveServicesAccountApiProperties
customSubDomainName	토큰 기반 인증에 사용되는 선택적 하위 도메인 이름입니다.	문자열
암호화	이 리소스의 암호화 속성입니다.	암호화
networkAcls	특정 네트워크 위치의 접근성을 제어하는 규칙의 컬렉션입니다.	NetworkRuleSet
privateEndpointConnections	Cognitive Services 계정과 연결된 프라이빗 엔드포인트 연결입니다.	PrivateEndpointConnection[]
publicNetworkAccess	이 계정에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.	'사용 안 함' 'Enabled'
userOwnedStorage	이 리소스에 대한 스토리지 계정입니다.	userOwnedStorage[]

CognitiveServicesAccountTags

이름	묘사	값

암호화

이름	묘사	값
keySource	암호화에 대한 keySource의 가능한 값을 열거합니다.	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultProperties	KeyVault의 속성	KeyVaultProperties

신원

이름	묘사	값
형	관리 서비스 ID의 유형입니다.	'None' 'SystemAssigned' 'UserAssigned'
userAssignedIdentities	리소스와 연결된 사용자 할당 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

이름	묘사	값

IpRule

이름	묘사	값
값	CIDR 표기법의 IPv4 주소 범위(예: '124.56.78.91'(단순 IP 주소) 또는 '124.56.78.0/24'(124.56.78로 시작하는 모든 주소).	string(필수)

KeyVaultProperties

이름	묘사	값
keyName	KeyVault의 키 이름	문자열
keyVaultUri	KeyVault의 URI	문자열
keyVersion	KeyVault의 키 버전	문자열

Microsoft.CognitiveServices/accounts

이름	묘사	값
apiVersion	api 버전	'2017-04-18'
신원	Cognitive Services 계정의 ID입니다.	ID
종류	리소스의 종류입니다.	문자열
위치	리소스의 위치	문자열
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 2 최대 길이 = 64 패턴 = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$`(필수)
속성	Cognitive Services 계정의 속성입니다.	CognitiveServicesAccountProperties
sku	Cognitive Services 계정의 SKU입니다.	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다. 템플릿 태그를 참조하세요.
형	리소스 종류	'Microsoft.CognitiveServices/accounts'

NetworkRuleSet

이름	묘사	값
defaultAction	ipRules 및 virtualNetworkRules의 규칙이 일치하지 않는 경우의 기본 작업입니다. 바이패스 속성이 평가된 후에만 사용됩니다.	'허용' '거부'
ipRules	IP 주소 규칙 목록입니다.	ipRule[]
virtualNetworkRules	가상 네트워크 규칙 목록입니다.	VirtualNetworkRule[]

PrivateEndpoint

이름	묘사	값

PrivateEndpointConnection

이름	묘사	값
위치	프라이빗 엔드포인트 연결의 위치	문자열
속성	리소스 속성입니다.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

이름	묘사	값
groupIds	프라이빗 링크 리소스 그룹 ID입니다.	string[]
privateEndpoint	프라이빗 엔드포인트의 리소스입니다.	PrivateEndpoint
privateLinkServiceConnectionState	서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.	PrivateLinkServiceConnectionState(필수)

PrivateLinkServiceConnectionState

이름	묘사	값
actionsRequired	서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.	문자열
묘사	연결의 승인/거부 이유입니다.	문자열
상태	서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다.	'승인됨' '연결 끊김' '보류 중' '거부됨'

Sku

이름	묘사	값
이름	sku 이름을 가져오거나 설정합니다. 계정 만들기에 필요하며 업데이트에 대한 선택 사항입니다.	string(필수)

UserAssignedIdentity

이름	묘사	값
clientId	이 ID와 연결된 클라이언트 앱 ID입니다.	문자열
principalId	이 ID와 연결된 Azure Active Directory 보안 주체 ID입니다.	문자열

UserOwnedStorage

이름	묘사	값
resourceId	Microsoft.Storage 리소스의 전체 리소스 ID입니다.	문자열

VirtualNetworkRule

이름	묘사	값
아이디	'/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'과 같은 vnet 서브넷의 전체 리소스 ID입니다.	string(필수)
ignoreMissingVnetServiceEndpoint	누락된 vnet 서비스 엔드포인트를 무시합니다.	bool
상태	가상 네트워크 규칙의 상태를 가져옵니다.	문자열

빠른 시작 템플릿

다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.

템플렛	묘사
Azure AI Studio 기본 설정 Azure 배포	이 템플릿 집합은 기본 설정으로 Azure AI Studio를 설정하는 방법을 보여 줍니다. 즉, 공용 인터넷 액세스를 사용하도록 설정, 암호화를 위한 Microsoft 관리형 키 및 AI 리소스에 대한 Microsoft 관리 ID 구성을 의미합니다.
Azure AI Studio 기본 설정 Azure 배포	이 템플릿 집합은 기본 설정으로 Azure AI Studio를 설정하는 방법을 보여 줍니다. 즉, 공용 인터넷 액세스를 사용하도록 설정, 암호화를 위한 Microsoft 관리형 키 및 AI 리소스에 대한 Microsoft 관리 ID 구성을 의미합니다.
Azure AI Studio 기본 설정 Azure 배포	이 템플릿 집합은 기본 설정으로 Azure AI Studio를 설정하는 방법을 보여 줍니다. 즉, 공용 인터넷 액세스를 사용하도록 설정, 암호화를 위한 Microsoft 관리형 키 및 AI 리소스에 대한 Microsoft 관리 ID 구성을 의미합니다.
Azure AI Studio 네트워크 제한 Azure 배포	이 템플릿 집합은 암호화를 위해 Microsoft 관리형 키를 사용하고 AI 리소스에 대한 Microsoft 관리 ID 구성을 사용하여 프라이빗 링크 및 송신을 사용하지 않도록 설정하여 Azure AI Studio를 설정하는 방법을 보여 줍니다.
Azure AI Studio 네트워크 제한 Azure 배포	이 템플릿 집합은 암호화를 위해 Microsoft 관리형 키를 사용하고 AI 리소스에 대한 Microsoft 관리 ID 구성을 사용하여 프라이빗 링크 및 송신을 사용하지 않도록 설정하여 Azure AI Studio를 설정하는 방법을 보여 줍니다.
Microsoft Entra ID 인증 사용하여 Azure AI Studio Azure 배포	이 템플릿 집합은 Azure AI Services 및 Azure Storage와 같은 종속 리소스에 대해 Microsoft Entra ID 인증을 사용하여 Azure AI Studio를 설정하는 방법을 보여 줍니다.
Azure AI 서비스 다중 서비스 리소스 배포 Azure 배포	이 템플릿은 기계 학습 전문 지식 없이도 모든 개발자의 손이 닿는 범위 내에서 AI를 가져오는 Azure AI 서비스 리소스를 배포합니다. 앱에서 의사 결정을 보고, 듣고, 말하고, 검색하고, 이해하고, 가속화하는 기능을 포함하는 API 호출만 있으면 됩니다.
Azure AI Translator 리소스 배포 Azure 배포	이 템플릿은 기계 학습 전문 지식 없이도 모든 개발자의 손이 닿는 범위 내에서 AI를 가져오는 Azure AI Translator 리소스를 배포합니다.
Azure AI Vision 리소스 배포 Azure 배포	이 템플릿은 기계 학습 전문 지식 없이도 모든 개발자의 손이 닿는 범위 내에서 AI를 가져오는 Azure AI Vision 리소스를 배포합니다.
관리형 가상 네트워크 사용하여 보안 Azure AI Studio 배포 Azure 배포	이 템플릿은 강력한 네트워크 및 ID 보안 제한을 사용하여 안전한 Azure AI Studio 환경을 만듭니다.

Terraform(AzAPI 공급자) 리소스 정의

다음을 대상으로 하는 작업으로 계정 리소스 유형을 배포할 수 있습니다.

리소스 그룹

각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.

리소스 형식

Microsoft.CognitiveServices/accounts 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts@2017-04-18"
  name = "string"
  identity = {
    type = "string"
    userAssignedIdentities = {
      {customized property} = {
        clientId = "string"
        principalId = "string"
      }
    }
  }
  kind = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  body = jsonencode({
    properties = {
      apiProperties = {
        aadClientId = "string"
        aadTenantId = "string"
        eventHubConnectionString = "string"
        qnaAzureSearchEndpointId = "string"
        qnaAzureSearchEndpointKey = "string"
        qnaRuntimeEndpoint = "string"
        statisticsEnabled = bool
        storageAccountConnectionString = "string"
        superUser = "string"
        websiteName = "string"
      }
      customSubDomainName = "string"
      encryption = {
        keySource = "string"
        keyVaultProperties = {
          keyName = "string"
          keyVaultUri = "string"
          keyVersion = "string"
        }
      }
      networkAcls = {
        defaultAction = "string"
        ipRules = [
          {
            value = "string"
          }
        ]
        virtualNetworkRules = [
          {
            id = "string"
            ignoreMissingVnetServiceEndpoint = bool
            state = "string"
          }
        ]
      }
      privateEndpointConnections = [
        {
          location = "string"
          properties = {
            groupIds = [
              "string"
            ]
            privateEndpoint = {
            }
            privateLinkServiceConnectionState = {
              actionsRequired = "string"
              description = "string"
              status = "string"
            }
          }
        }
      ]
      publicNetworkAccess = "string"
      userOwnedStorage = [
        {
          resourceId = "string"
        }
      ]
    }
  })
}

속성 값

CognitiveServicesAccountApiProperties

이름	묘사	값
aadClientId	(Metrics Advisor만 해당) Azure AD 클라이언트 ID(애플리케이션 ID)입니다.	문자열 제약 조건: 최대 길이 = 500
aadTenantId	(Metrics Advisor만 해당) Azure AD 테넌트 ID입니다.	문자열 제약 조건: 최대 길이 = 500
eventHubConnectionString	(개인 설정만 해당) Bing Search의 통계를 사용하도록 설정하는 플래그입니다.	문자열 제약 조건: 최대 길이 = 1000 패턴 = `^( )Endpoint=sb://(.);( )SharedAccessKeyName=(.);( )SharedAccessKey=(.)$`
qnaAzureSearchEndpointId	(QnAMaker만 해당) QnAMaker의 Azure Search 엔드포인트 ID입니다.	문자열
qnaAzureSearchEndpointKey	(QnAMaker만 해당) QnAMaker의 Azure Search 엔드포인트 키입니다.	문자열
qnaRuntimeEndpoint	(QnAMaker만 해당) QnAMaker의 런타임 엔드포인트입니다.	문자열
statisticsEnabled	(Bing Search만 해당) Bing Search의 통계를 사용하도록 설정하는 플래그입니다.	bool
storageAccountConnectionString	(개인 설정만 해당) 스토리지 계정 연결 문자열입니다.	문자열 제약 조건: 최대 길이 = 1000 패턴 = `^(( )DefaultEndpointsProtocol=(http\|https)( );( ))?AccountName=(.)AccountKey=(.)EndpointSuffix=(.)$`
수퍼유저	(Metrics Advisor만 해당) 메트릭 관리자의 슈퍼 사용자입니다.	문자열 제약 조건: 최대 길이 = 500
websiteName	(Metrics Advisor만 해당) Metrics Advisor의 웹 사이트 이름입니다.	문자열 제약 조건: 최대 길이 = 500

CognitiveServicesAccountProperties

이름	묘사	값
apiProperties	특수 API에 대한 api 속성입니다.	cognitiveServicesAccountApiProperties
customSubDomainName	토큰 기반 인증에 사용되는 선택적 하위 도메인 이름입니다.	문자열
암호화	이 리소스의 암호화 속성입니다.	암호화
networkAcls	특정 네트워크 위치의 접근성을 제어하는 규칙의 컬렉션입니다.	NetworkRuleSet
privateEndpointConnections	Cognitive Services 계정과 연결된 프라이빗 엔드포인트 연결입니다.	PrivateEndpointConnection[]
publicNetworkAccess	이 계정에 대해 퍼블릭 엔드포인트 액세스가 허용되는지 여부입니다. 값은 선택 사항이지만 전달된 경우 '사용' 또는 '사용 안 함'이어야 합니다.	'사용 안 함' 'Enabled'
userOwnedStorage	이 리소스에 대한 스토리지 계정입니다.	userOwnedStorage[]

CognitiveServicesAccountTags

이름	묘사	값

암호화

이름	묘사	값
keySource	암호화에 대한 keySource의 가능한 값을 열거합니다.	'Microsoft.CognitiveServices' 'Microsoft.KeyVault'
keyVaultProperties	KeyVault의 속성	KeyVaultProperties

신원

이름	묘사	값
형	관리 서비스 ID의 유형입니다.	'None' 'SystemAssigned' 'UserAssigned'
userAssignedIdentities	리소스와 연결된 사용자 할당 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName} 형식의 ARM 리소스 ID입니다.	IdentityUserAssignedIdentities

IdentityUserAssignedIdentities

이름	묘사	값

IpRule

이름	묘사	값
값	CIDR 표기법의 IPv4 주소 범위(예: '124.56.78.91'(단순 IP 주소) 또는 '124.56.78.0/24'(124.56.78로 시작하는 모든 주소).	string(필수)

KeyVaultProperties

이름	묘사	값
keyName	KeyVault의 키 이름	문자열
keyVaultUri	KeyVault의 URI	문자열
keyVersion	KeyVault의 키 버전	문자열

Microsoft.CognitiveServices/accounts

이름	묘사	값
신원	Cognitive Services 계정의 ID입니다.	ID
종류	리소스의 종류입니다.	문자열
위치	리소스의 위치	문자열
이름	리소스 이름	문자열 제약 조건: 최소 길이 = 2 최대 길이 = 64 패턴 = `^[a-zA-Z0-9][a-zA-Z0-9_.-]*$`(필수)
속성	Cognitive Services 계정의 속성입니다.	CognitiveServicesAccountProperties
sku	Cognitive Services 계정의 SKU입니다.	Sku
태그	리소스 태그	태그 이름 및 값의 사전입니다.
형	리소스 종류	"Microsoft.CognitiveServices/accounts@2017-04-18"

NetworkRuleSet

이름	묘사	값
defaultAction	ipRules 및 virtualNetworkRules의 규칙이 일치하지 않는 경우의 기본 작업입니다. 바이패스 속성이 평가된 후에만 사용됩니다.	'허용' '거부'
ipRules	IP 주소 규칙 목록입니다.	ipRule[]
virtualNetworkRules	가상 네트워크 규칙 목록입니다.	VirtualNetworkRule[]

PrivateEndpoint

이름	묘사	값

PrivateEndpointConnection

이름	묘사	값
위치	프라이빗 엔드포인트 연결의 위치	문자열
속성	리소스 속성입니다.	PrivateEndpointConnectionProperties

PrivateEndpointConnectionProperties

이름	묘사	값
groupIds	프라이빗 링크 리소스 그룹 ID입니다.	string[]
privateEndpoint	프라이빗 엔드포인트의 리소스입니다.	PrivateEndpoint
privateLinkServiceConnectionState	서비스 소비자와 공급자 간의 연결 상태에 대한 정보 컬렉션입니다.	PrivateLinkServiceConnectionState(필수)

PrivateLinkServiceConnectionState

이름	묘사	값
actionsRequired	서비스 공급자의 변경 내용에 소비자에 대한 업데이트가 필요한지 여부를 나타내는 메시지입니다.	문자열
묘사	연결의 승인/거부 이유입니다.	문자열
상태	서비스 소유자가 연결을 승인/거부/제거했는지 여부를 나타냅니다.	'승인됨' '연결 끊김' '보류 중' '거부됨'

Sku

이름	묘사	값
이름	sku 이름을 가져오거나 설정합니다. 계정 만들기에 필요하며 업데이트에 대한 선택 사항입니다.	string(필수)

UserAssignedIdentity

이름	묘사	값
clientId	이 ID와 연결된 클라이언트 앱 ID입니다.	문자열
principalId	이 ID와 연결된 Azure Active Directory 보안 주체 ID입니다.	문자열

UserOwnedStorage

이름	묘사	값
resourceId	Microsoft.Storage 리소스의 전체 리소스 ID입니다.	문자열

VirtualNetworkRule

이름	묘사	값
아이디	'/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/virtualNetworks/test-vnet/subnets/subnet1'과 같은 vnet 서브넷의 전체 리소스 ID입니다.	string(필수)
ignoreMissingVnetServiceEndpoint	누락된 vnet 서비스 엔드포인트를 무시합니다.	bool
상태	가상 네트워크 규칙의 상태를 가져옵니다.	문자열

다음을 통해 공유

Microsoft.CognitiveServices 계정 2017-04-18

Bicep 리소스 정의

리소스 형식

속성 값

CognitiveServicesAccountApiProperties

CognitiveServicesAccountProperties

CognitiveServicesAccountTags

암호화

신원

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/accounts

NetworkRuleSet

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

PrivateLinkServiceConnectionState

Sku

UserAssignedIdentity

UserOwnedStorage

VirtualNetworkRule

빠른 시작 샘플

ARM 템플릿 리소스 정의

리소스 형식

속성 값

CognitiveServicesAccountApiProperties

CognitiveServicesAccountProperties

CognitiveServicesAccountTags

암호화

신원

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/accounts

NetworkRuleSet

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

PrivateLinkServiceConnectionState

Sku

UserAssignedIdentity

UserOwnedStorage

VirtualNetworkRule

빠른 시작 템플릿

Terraform(AzAPI 공급자) 리소스 정의

리소스 형식

속성 값

CognitiveServicesAccountApiProperties

CognitiveServicesAccountProperties

CognitiveServicesAccountTags

암호화

신원

IdentityUserAssignedIdentities

IpRule

KeyVaultProperties

Microsoft.CognitiveServices/accounts

NetworkRuleSet

PrivateEndpoint

PrivateEndpointConnection

PrivateEndpointConnectionProperties

PrivateLinkServiceConnectionState

Sku

UserAssignedIdentity

UserOwnedStorage

VirtualNetworkRule

피드백

추가 리소스