런타임 API를 사용하여 모델을 배포하고 텍스트에서 엔터티를 추출합니다.

Foundry에서 사용자 지정 모델을 배포하는 방법에 대한 자세한 내용은미세 조정된 모델 배포를 참조하세요 .

배포 작업 제출

다음 URL, 헤더 및 JSON 본문을 사용하여 PUT 요청을 제출하여 배포 작업을 제출합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

{Endpoint}/language/authoring/analyze-text/projects/{projectName}/deployments/{deploymentName}?api-version={API-VERSION}

헤더

다음 헤더를 사용하여 요청을 인증합니다.

요청 본문

요청 본문에서 다음 JSON을 사용합니다. 배포에 할당할 모델의 이름을 사용합니다.

{
  "trainedModelLabel": "{MODEL-NAME}"
}

API 요청을 보내면 작업이 올바르게 제출되었음을 나타내는 응답을 받게 됩니다 202 . 응답 헤더에서 다음과 같이 형식이 operation-location 지정된 값을 추출합니다.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

이 작업은 비동기식이므로 {JOB-ID}은 요청을 식별하는 데 사용됩니다. 이 URL을 사용하여 배포 상태를 가져올 수 있습니다.

배포 작업 상태 가져오기

다음 GET 요청을 사용하여 배포 작업의 상태를 쿼리합니다. 이전 단계에서 받은 URL을 사용하거나 자리 표시자 값을 자신의 값으로 바꿀 수 있습니다.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{DEPLOYMENT-NAME}/jobs/{JOB-ID}?api-version={API-VERSION}

헤더

다음 헤더를 사용하여 요청을 인증합니다.

응답 본문

요청을 보내면 다음 응답이 표시됩니다. status 매개 변수가 "succeeded"로 변경될 때까지 이 엔드포인트를 계속 폴링합니다. 요청의 성공을 나타내는 200 코드를 확인해 야 합니다.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

배포된 모델을 바꾸려면 배포된 모델을 동일한 지역의 다른 모델과 교환할 수 있습니다.

1. 이름 아래에서 모델 이름을 선택한 다음 모델 배포를 선택합니다.

2. 교환 모델을 선택합니다.

   다시 배포를 완료하는 데 몇 분 정도 걸립니다. 그동안 배포된 모델은 이 프로세스가 완료될 때까지 Translator API에서 계속 사용할 수 있습니다.

다음 URL, 헤더, JSON 본문을 사용하는 POST 요청을 만들어 배포 교환 작업을 시작합니다.

요청 URL

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/:swap?api-version={API-VERSION}

헤더

다음 헤더를 사용하여 요청을 인증합니다.

요청 본문

{
  "firstDeploymentName": "{FIRST-DEPLOYMENT-NAME}",
  "secondDeploymentName": "{SECOND-DEPLOYMENT-NAME}"
}

API 요청을 보내면 성공을 나타내는 응답을 받게 됩니다 202 .

프로젝트가 더 이상 필요하지 않은 경우 Foundry에서 삭제할 수 있습니다.

1. Foundry 홈페이지로 이동합니다. 이 단계를 이미 완료하고 세션이 활성 상태인 경우가 아니면 로그인하여 인증 프로세스를 시작합니다.
2. Foundry를 사용하여 건물 유지에서 삭제할 프로젝트를 선택합니다.
3. 관리 센터를 선택합니다.
4. 프로젝트 삭제를 선택합니다.

모든 프로젝트와 함께 허브를 삭제하려면 다음을 수행합니다.

1. 개요 탭으로 허브 섹션에서 이동합니다.

2. 오른쪽에서 허브 삭제를 선택합니다.

3. 링크를 클릭하면 허브를 삭제할 수 있는 Azure Portal이 열립니다.

다음 URL, 헤더, JSON 본문을 사용하는 DELETE 요청을 만들어 배포를 삭제합니다.

요청 URL

{Endpoint}/language/authoring/analyze-text/projects/{PROJECT-NAME}/deployments/{deploymentName}?api-version={API-VERSION}

헤더

다음 헤더를 사용하여 요청을 인증합니다.

API 요청을 보내면 성공을 나타내는 응답을 받게 202 됩니다. 즉, 배포가 삭제됩니다. 작업의 상태를 확인하는 데 사용되는 Operation-Location 헤더가 포함된 성공적인 호출 결과.

사용자 지정 모델을 배포하는 방법에 대한 자세한 내용은 미세 조정된 모델 배포를 참조하세요.

프로그래밍 방식으로 배포 리소스를 할당하려면 Microsoft Entra 인증이 필요합니다. Microsoft Entra ID는 다중 지역 배포를 위해 프로젝트에 할당하려는 리소스에 대한 액세스 권한이 있는지 확인하는 데 사용됩니다. REST API를 호출할 때 프로그래밍 방식으로 Microsoft Entra 인증을 사용하려면 Foundry 도구 설명서에서 자세히 알아보세요.

리소스 할당

다음 URL, 헤더 및 JSON 본문을 사용하여 POST 요청을 제출하여 배포 리소스를 할당합니다.

요청 URL

API 요청을 만들 때 다음 URL을 사용합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:assign?api-version={API-VERSION}

헤더

이 API를 인증하려면 Microsoft Entra 인증을 사용합니다.

본문

다음 샘플 JSON을 본문으로 사용합니다.

{
  "resourcesMetadata": [
    {
      "azureResourceId": "{AZURE-RESOURCE-ID}",
      "customDomain": "{CUSTOM-DOMAIN}",
      "region": "{REGION-CODE}"
    }
  ]
}

리소스 할당 상태 가져오기

다음 GET 요청을 사용하여 배포 리소스 할당 작업의 상태를 가져옵니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

요청 URL

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/assign/jobs/{JOB-ID}?api-version={API-VERSION}

헤더

다음 헤더를 사용하여 요청을 인증합니다.

응답 본문

요청을 보내면 다음 응답이 표시됩니다. status 매개 변수가 succeeded로 변경될 때까지 이 엔드포인트를 계속 폴링합니다.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}

프로젝트가 더 이상 필요하지 않은 경우 Foundry에서 삭제할 수 있습니다.

1. Foundry 홈페이지로 이동합니다. 이 단계를 이미 완료하고 세션이 활성 상태인 경우가 아니면 로그인하여 인증 프로세스를 시작합니다.
2. Foundry를 사용하여 건물 유지에서 삭제할 프로젝트를 선택합니다.
3. 관리 센터를 선택합니다.
4. 프로젝트 삭제를 선택합니다.

모든 프로젝트와 함께 허브를 삭제하려면 다음을 수행합니다.

1. 개요 탭으로 허브 섹션에서 이동합니다.

2. 오른쪽에서 허브 삭제를 선택합니다.

3. 링크를 클릭하면 허브를 삭제할 수 있는 Azure Portal이 열립니다.

리소스 할당 해제

다음 URL, 헤더 및 JSON 본문을 사용하여 POST 요청을 제출하여 프로젝트에서 배포 리소스를 할당 취소하거나 제거합니다.

요청 URL

API 요청을 만들 때 다음 URL을 사용합니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/:unassign?api-version={API-VERSION}

헤더

다음 헤더를 사용하여 요청을 인증합니다.

본문

다음 샘플 JSON을 본문으로 사용합니다.

{
  "assignedResourceIds": [
    "{AZURE-RESOURCE-ID}"
  ]
}

리소스 할당 취소 상태 가져오기

다음 GET 요청을 사용하여 배포 리소스 할당 취소 작업의 상태를 가져옵니다. 자리 표시자 값을 사용자 고유의 값으로 바꿉니다.

요청 URL

{ENDPOINT}/language/authoring/analyze-text/projects/{PROJECT-NAME}/resources/unassign/jobs/{JOB-ID}?api-version={API-VERSION}

헤더

다음 헤더를 사용하여 요청을 인증합니다.

응답 본문

요청을 보내면 다음 응답이 표시됩니다. status 매개 변수가 "succeeded"로 변경될 때까지 이 엔드포인트를 계속 폴링합니다.

{
    "jobId":"{JOB-ID}",
    "createdDateTime":"{CREATED-TIME}",
    "lastUpdatedDateTime":"{UPDATED-TIME}",
    "expirationDateTime":"{EXPIRATION-TIME}",
    "status":"running"
}