Microsoft 검색에는 여러 리소스 종류가 포함되며 일부는 다른 리소스 공급자의 리소스에 대한 종속성이 있습니다. 리소스 명명 제약 조건을 이해하면 명확성을 높이고 충돌을 방지하며 자동화를 사용하도록 설정하고 거버넌스 및 보안을 지원할 수 있습니다.
이 문서에서는 Microsoft 검색 내의 모든 리소스 종류에 대한 명명 규칙을 알아봅니다. 이 지침은 정보에 입각한 결정을 내리고 배포 오류를 방지하는 데 도움이 됩니다.
일반 명명 지침
다음 규칙은 리소스별 섹션에 달리 명시되지 않는 한 모든 Microsoft 검색 리소스에 적용됩니다.
- 고유성: 리소스 이름은 해당 범위(구독 또는 리소스 그룹) 내에서 고유해야 합니다.
- 예측: 일관된 명명 패턴을 사용하여 자동화 및 통합을 용이하게 합니다.
- 허용되는 문자: 아래의 자원별 문자 및 패턴 규칙을 따르세요; 많은 유형이 하이픈도 허용합니다.
- 대/소문자 구분: 리소스 이름은 대/소문자를 구분하지 않지만 일관성을 위해 소문자로 입력해 저장해야 합니다.
- 길이: 각 리소스 종류는 자체 최소 및 최대 길이를 정의합니다. 이러한 제한을 초과하면 배포 오류가 발생합니다.
-
공백 또는 특수 문자 없음: 리소스 이름은 달리 명시되지 않는 한 하이픈(
-)을 제외하고 공백이나 특수 문자를 포함할 수 없습니다. - 연속 구분 기호 없음: 여러 하이픈, 밑줄 또는 기타 구분 기호가 연속적으로 나타나지 않아야 합니다.
관리되는 리소스 그룹 명명 규칙
특정 검색 리소스가 만들어지면 해당 MRG(관리되는 리소스 그룹)가 해당 리소스를 지원하는 데 필요한 서비스 구성 요소를 호스트하도록 자동으로 프로비전됩니다. 다음 명명 규칙은 이러한 MRG에 적용됩니다.
| 리소스 종류 | 명명 규칙 | Example |
|---|---|---|
| Microsoft 검색 작업 영역 | mrg-dwsp-<customer-provided-name>-<6-char-random-sequence> |
mrg-dwsp-testworkspace-abcdef |
| Microsoft 디스커버리 북쉘프 | mrg-dbksf-<customer-provided-name>-<6-char-random-sequence> |
mrg-dbksf-testbookshelf-lmnopq |
| Microsoft 검색 슈퍼컴퓨터 | mrg-dscmp-<customer-provided-name>-<6-char-random-sequence> |
mrg-dscmp-testsc-abcxyz |
리소스별 명명 규칙
다음 섹션에서는 각 Microsoft 검색 리소스 종류에 대한 명명 규칙을 설명합니다.
Workspaces
작업 영역 이름은 작업 영역 엔드포인트 하위 도메인 이름으로도 사용됩니다.
| Property | Value |
|---|---|
| 허용되는 문자 | 소문자(a–z), 숫자(0–9), 하이픈(-) |
| Length | 3~24자 |
| 패턴 | 문자로 시작해야 합니다. 숫자와 하이픈을 포함할 수 있습니다. 는 문자 또는 숫자로 끝나야 합니다. |
| Examples |
workspace01, workspace-main |
프로젝트
| Property | Value |
|---|---|
| 허용되는 문자 | 소문자, 숫자, 하이픈(-) |
| Length | 3~12자 |
| 패턴 | 문자로 시작해야 합니다. 하이픈은 단어 구분 기호로 사용할 수 있습니다. |
| Examples |
ai-project, adhesives01 |
슈퍼컴퓨터
| Property | Value |
|---|---|
| 허용되는 문자 | 소문자, 숫자, 하이픈(-) |
| Length | 3~24자 |
| 패턴 | 문자로 시작해야 합니다. 하이픈은 구분 기호로 허용됩니다. 는 문자 또는 숫자로 끝나야 합니다. |
| Examples |
quantum-supercomputer, supercomputer01 |
노드풀
| Property | Value |
|---|---|
| 허용되는 문자 | 소문자(a–z), 숫자(0–9), 하이픈(-) |
| Length | 3~12자 |
| 패턴 | 문자로 시작해야 합니다. 숫자와 하이픈을 포함할 수 있습니다. 는 문자 또는 숫자로 끝나야 합니다. |
| Examples |
nodepool01, gpu-nodepool |
Tools
| Property | Value |
|---|---|
| 허용되는 문자 | 대문자 또는 소문자, 숫자, 하이픈(-) |
| Length | 3~24자 |
| 패턴 | 문자로 시작해야 합니다. 하이픈은 구분 기호로 사용됩니다. 는 문자 또는 숫자로 끝나야 합니다. |
| Examples |
adft-tool, mol-toolkit |
Agents
| Property | Value |
|---|---|
| 허용되는 문자 | 대문자 또는 소문자, 숫자, 하이픈(-) |
| Length | 3~63자 |
| 패턴 | 영숫자 문자(문자 또는 숫자)로 시작하고 끝나야 합니다. 하이픈은 중간에 사용할 수 있습니다. |
| Examples |
search-agent, crawler-agent |
보관 컨테이너
| Property | Value |
|---|---|
| 허용되는 문자 | 소문자, 숫자, 하이픈(-) |
| Length | 3~24자 |
| 패턴 | 문자로 시작하고 끝나야 합니다. 하이픈은 선택적 단어 구분선입니다. |
| Examples |
contoso-datacontainer, archivecontainer |
저장 자산
| Property | Value |
|---|---|
| 허용되는 문자 | 소문자(a–z), 숫자(0–9), 하이픈(-) |
| Length | 3~24자 |
| 패턴 | 문자로 시작해야 합니다. 숫자와 하이픈을 포함할 수 있습니다. 는 문자 또는 숫자로 끝나야 합니다. |
| Examples |
input-molecules-01, outputdata |
조사
| Property | Value |
|---|---|
| 허용되는 문자 | 소문자, 숫자, 하이픈(-) |
| Length | 1~20자 |
| 패턴 | 문자로 시작하고 끝나야 합니다. 하이픈은 단어 구분 기호로 사용됨 |
| Examples |
chem-investigation, anomaly-study |
국제화 및 지역화
모든 리소스 이름에 영어 용어 및 ASCII 문자를 사용하여 시스템 및 전역 지역에서 최대 호환성을 보장합니다. 지역화가 필요한 경우 리소스 이름에 직접 지역화된 이름을 인코딩하는 대신 매핑 테이블 또는 메타데이터 필드를 사용합니다.
유효성 검사 및 오류 처리
온보딩 설정 작업은 프로비저닝 전에 이름을 확인합니다. 구문 검사와 사용 불가능한 실시간 이름 사용 가능 검사를 모두 검토하세요; 로컬 성공이 Azure에서 고유성을 증명하는 것은 아닙니다. 도구 생성 이름은 기본 프로젝트 저장소 컨테이너 이름과 같은 추가 파생 규칙을 가질 수 있습니다.
모든 리소스 이름은 만들거나 수정하기 전에 유효성이 검사됩니다. 유효성 검사에는 다음이 포함됩니다.
- 구문 검사: 길이, 허용 문자, 연속 구분 기호의 금지.
- 고유성 검사: 적절한 범위(구독 또는 리소스 그룹) 내에서 확인됩니다.
Azure 포털 또는 Microsoft Discovery Studio를 사용하는 경우 명명 제약 조건을 위반하면 명시적 오류 메시지가 실시간으로 표시됩니다. 다시 시도하기 전에 특정 리소스 종류에 대한 규칙에 따라 입력을 수정합니다.