PersonGroupOperations class
PersonGroupOperations를 나타내는 클래스입니다.
생성자
Person |
PersonGroupOperations를 만듭니다. |
메서드
create(string, string, Person |
지정된 personGroupId, 이름, 사용자가 제공한 userData 및 recognitionModel을 사용하여 새 사용자 그룹을 만듭니다.
개인 그룹 할당량:
|
create(string, string, Person |
|
create(string, string, Service |
|
delete |
기존 사용자 그룹을 삭제합니다. 사람 그룹에 있는 모든 사람의 지속형 얼굴 기능도 삭제됩니다. |
delete |
|
delete |
|
get(string, Person |
사용자 그룹 이름, userData 및 recognitionModel을 검색합니다. 이 personGroup에서 사람 정보를 얻으려면 PersonGroup Person - List를 사용합니다. |
get(string, Person |
|
get(string, Service |
|
get |
사용자 그룹의 학습 상태 검색합니다(완료 또는 진행 중). |
get |
|
get |
|
list(Person |
사용자 그룹의 personGroupId, name, userData 및 recognitionModel을 나열합니다.
|
list(Person |
|
list(Service |
|
train(string, Request |
사람 그룹 학습 작업을 큐에 추가하면 학습 작업이 즉시 시작되지 않을 수 있습니다. |
train(string, Request |
|
train(string, Service |
|
update(string, Person |
기존 사용자 그룹의 표시 이름 및 userData를 업데이트합니다. 요청 본문에 표시되지 않는 속성은 업데이트되지 않습니다. |
update(string, Person |
|
update(string, Service |
생성자 세부 정보
PersonGroupOperations(FaceClientContext)
PersonGroupOperations를 만듭니다.
new PersonGroupOperations(client: FaceClientContext)
매개 변수
- client
- FaceClientContext
서비스 클라이언트에 대한 참조입니다.
메서드 세부 정보
create(string, string, PersonGroupCreateOptionalParams)
지정된 personGroupId, 이름, 사용자가 제공한 userData 및 recognitionModel을 사용하여 새 사용자 그룹을 만듭니다.
사람 그룹은 얼굴 인식 기능을 포함하여 업로드된 사람 데이터의 컨테이너입니다.
만든 후 PersonGroup Person - Create 를 사용하여 그룹에 사용자를 추가한 다음 PersonGroup - Train 을 호출하여 이 그룹을 Face - Identify에 대해 준비합니다.
이미지가 저장되지 않습니다. PersonGroup Person - Delete 또는 PersonGroup - Delete가 호출될 때까지 사람의 추출된 얼굴 기능 및 userData만 서버에 저장 됩니다.
이 사용자 그룹과 연결하려면 'recognitionModel'을 지정해야 합니다. 'recognitionModel'의 기본값은 'recognition_01'입니다. 최신 모델이 필요한 경우 이 매개 변수에 필요한 모델을 명시적으로 지정하세요. 기존 사용자 그룹에 추가된 새 얼굴은 컬렉션과 이미 연결된 인식 모델을 사용합니다. 사람 그룹의 기존 얼굴 기능은 다른 버전의 인식 모델에서 추출한 기능으로 업데이트할 수 없습니다.
개인 그룹 할당량:
- 무료 계층 구독 할당량: 1,000명 그룹. 각각 최대 1,000명을 수용할 수 있습니다.
- S0 계층 구독 할당량: 1,000,000명 그룹. 각각 최대 10,000명을 수용할 수 있습니다.
- 대규모 얼굴 식별 문제를 처리하려면 LargePersonGroup을 사용하는 것이 좋습니다.
function create(personGroupId: string, name: string, options?: PersonGroupCreateOptionalParams): Promise<RestResponse>
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- name
-
string
사용자 정의 이름, 최대 길이는 128입니다.
- options
- PersonGroupCreateOptionalParams
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
create(string, string, PersonGroupCreateOptionalParams, ServiceCallback<void>)
function create(personGroupId: string, name: string, options: PersonGroupCreateOptionalParams, callback: ServiceCallback<void>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- name
-
string
사용자 정의 이름, 최대 길이는 128입니다.
- options
- PersonGroupCreateOptionalParams
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
create(string, string, ServiceCallback<void>)
function create(personGroupId: string, name: string, callback: ServiceCallback<void>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- name
-
string
사용자 정의 이름, 최대 길이는 128입니다.
- callback
-
ServiceCallback<void>
콜백
deleteMethod(string, RequestOptionsBase)
기존 사용자 그룹을 삭제합니다. 사람 그룹에 있는 모든 사람의 지속형 얼굴 기능도 삭제됩니다.
function deleteMethod(personGroupId: string, options?: RequestOptionsBase): Promise<RestResponse>
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
deleteMethod(string, RequestOptionsBase, ServiceCallback<void>)
function deleteMethod(personGroupId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
deleteMethod(string, ServiceCallback<void>)
function deleteMethod(personGroupId: string, callback: ServiceCallback<void>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백
get(string, PersonGroupGetOptionalParams)
사용자 그룹 이름, userData 및 recognitionModel을 검색합니다. 이 personGroup에서 사람 정보를 얻으려면 PersonGroup Person - List를 사용합니다.
function get(personGroupId: string, options?: PersonGroupGetOptionalParams): Promise<PersonGroupGetResponse>
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- PersonGroupGetOptionalParams
선택적 매개 변수
반환
Promise<PersonGroupGetResponse>
Promise<Models.PersonGroupGetResponse>
get(string, PersonGroupGetOptionalParams, ServiceCallback<PersonGroup>)
function get(personGroupId: string, options: PersonGroupGetOptionalParams, callback: ServiceCallback<PersonGroup>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- PersonGroupGetOptionalParams
선택적 매개 변수
- callback
콜백
get(string, ServiceCallback<PersonGroup>)
function get(personGroupId: string, callback: ServiceCallback<PersonGroup>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- callback
콜백
getTrainingStatus(string, RequestOptionsBase)
사용자 그룹의 학습 상태 검색합니다(완료 또는 진행 중).
function getTrainingStatus(personGroupId: string, options?: RequestOptionsBase): Promise<PersonGroupGetTrainingStatusResponse>
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<PersonGroupGetTrainingStatusResponse>
Promise<Models.PersonGroupGetTrainingStatusResponse>
getTrainingStatus(string, RequestOptionsBase, ServiceCallback<TrainingStatus>)
function getTrainingStatus(personGroupId: string, options: RequestOptionsBase, callback: ServiceCallback<TrainingStatus>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
콜백
getTrainingStatus(string, ServiceCallback<TrainingStatus>)
function getTrainingStatus(personGroupId: string, callback: ServiceCallback<TrainingStatus>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- callback
콜백
list(PersonGroupListOptionalParams)
사용자 그룹의 personGroupId, name, userData 및 recognitionModel을 나열합니다.
- 사람 그룹은 personGroupId의 사전순으로 저장됩니다.
- "start" 매개 변수(문자열, 선택 사항)는 반환된 항목이 문자열 비교에 의해 더 큰 ID를 갖는 사용자 제공 personGroupId 값입니다. "start"는 첫 번째 항목의 반환을 나타내기 위해 비어 있음으로 설정됩니다.
- "top" 매개 변수(int, 선택 사항)는 반환할 항목 수를 지정합니다. 한 번의 호출로 최대 1,000개의 항목을 반환할 수 있습니다. 더 많은 항목을 가져오려면 현재 호출의 마지막으로 반환된 항목의 ID로 "시작"을 지정할 수 있습니다.
예를 들어 총 5인 그룹: "group1", ..., "group5".
"start=&top="은 5개의 그룹을 모두 반환합니다.
"start=&top=2"는 "group1", "group2"를 반환합니다.
"start=group2&top=3"은 "group3", "group4", "group5"를 반환합니다.
function list(options?: PersonGroupListOptionalParams): Promise<PersonGroupListResponse>
매개 변수
- options
- PersonGroupListOptionalParams
선택적 매개 변수
반환
Promise<PersonGroupListResponse>
Promise<Models.PersonGroupListResponse>
list(PersonGroupListOptionalParams, ServiceCallback<PersonGroup[]>)
function list(options: PersonGroupListOptionalParams, callback: ServiceCallback<PersonGroup[]>)
매개 변수
- options
- PersonGroupListOptionalParams
선택적 매개 변수
- callback
콜백
list(ServiceCallback<PersonGroup[]>)
function list(callback: ServiceCallback<PersonGroup[]>)
매개 변수
- callback
콜백
train(string, RequestOptionsBase)
사람 그룹 학습 작업을 큐에 추가하면 학습 작업이 즉시 시작되지 않을 수 있습니다.
function train(personGroupId: string, options?: RequestOptionsBase): Promise<RestResponse>
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
train(string, RequestOptionsBase, ServiceCallback<void>)
function train(personGroupId: string, options: RequestOptionsBase, callback: ServiceCallback<void>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- RequestOptionsBase
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
train(string, ServiceCallback<void>)
function train(personGroupId: string, callback: ServiceCallback<void>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백
update(string, PersonGroupUpdateOptionalParams)
기존 사용자 그룹의 표시 이름 및 userData를 업데이트합니다. 요청 본문에 표시되지 않는 속성은 업데이트되지 않습니다.
function update(personGroupId: string, options?: PersonGroupUpdateOptionalParams): Promise<RestResponse>
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- PersonGroupUpdateOptionalParams
선택적 매개 변수
반환
Promise<RestResponse>
Promise<msRest.RestResponse>
update(string, PersonGroupUpdateOptionalParams, ServiceCallback<void>)
function update(personGroupId: string, options: PersonGroupUpdateOptionalParams, callback: ServiceCallback<void>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- options
- PersonGroupUpdateOptionalParams
선택적 매개 변수
- callback
-
ServiceCallback<void>
콜백
update(string, ServiceCallback<void>)
function update(personGroupId: string, callback: ServiceCallback<void>)
매개 변수
- personGroupId
-
string
특정 사용자 그룹을 참조하는 ID입니다.
- callback
-
ServiceCallback<void>
콜백