azure.cognitiveservices.vision.face.models.PersonGroup.yml

### YamlMime:PythonClass
uid: azure.cognitiveservices.vision.face.models.PersonGroup
name: PersonGroup
fullName: azure.cognitiveservices.vision.face.models.PersonGroup
module: azure.cognitiveservices.vision.face.models
inheritances:
- azure.cognitiveservices.vision.face.models._models_py3.MetaDataContract
summary: 'Person group object.


  All required parameters must be populated in order to send to Azure.'
constructor:
  syntax: 'PersonGroup(*, name: str, person_group_id: str, user_data: str = None,
    recognition_model=''recognition_01'', **kwargs)'
  parameters:
  - name: name
    description: Required. User defined name, maximum length is 128.
    isRequired: true
    types:
    - <xref:str>
  - name: user_data
    description: User specified data. Length should not exceed 16KB.
    isRequired: true
    types:
    - <xref:str>
  - name: recognition_model
    description: 'Possible values include: ''recognition_01'',

      ''recognition_02'', ''recognition_03'', ''recognition_04''. Default value:

      "recognition_01" .'
    isRequired: true
    types:
    - <xref:str>
    - <xref:azure.cognitiveservices.vision.face.models.RecognitionModel>
  - name: person_group_id
    description: 'Required. PersonGroupId of the target person

      group.'
    isRequired: true
    types:
    - <xref:str>
  keywordOnlyParameters:
  - name: name
    isRequired: true
  - name: person_group_id
    isRequired: true
  - name: user_data
    isRequired: true
  - name: recognition_model
    defaultValue: recognition_01
methods:
- uid: azure.cognitiveservices.vision.face.models.PersonGroup.as_dict
  name: as_dict
  summary: "Return a dict that can be JSONify using json.dump.\n\nAdvanced usage might\
    \ optionally use a callback as parameter:\n\nKey is the attribute name used in\
    \ Python. Attr_desc\nis a dict of metadata. Currently contains 'type' with the\n\
    msrest type and 'key' with the RestAPI encoded key.\nValue is the current value\
    \ in this object.\n\nThe string returned will be used to serialize the key.\n\
    If the return type is a list, this is considered hierarchical\nresult dict.\n\n\
    See the three examples in this file:\n\n* attribute_transformer \n\n* full_restapi_key_transformer\
    \ \n\n* last_restapi_key_transformer \n\nIf you want XML serialization, you can\
    \ pass the kwargs is_xml=True."
  signature: as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>,
    **kwargs)
  parameters:
  - name: key_transformer
    description: A key transformer function.
    types:
    - <xref:function>
  - name: keep_readonly
    defaultValue: 'True'
  return:
    description: A dict JSON compatible object
    types:
    - <xref:dict>
- uid: azure.cognitiveservices.vision.face.models.PersonGroup.deserialize
  name: deserialize
  summary: Parse a str using the RestAPI syntax and return a model.
  signature: deserialize(data, content_type=None)
  parameters:
  - name: data
    description: A str using RestAPI structure. JSON by default.
    isRequired: true
    types:
    - <xref:str>
  - name: content_type
    description: JSON by default, set application/xml if XML.
    defaultValue: None
    types:
    - <xref:str>
  return:
    description: An instance of this model
  exceptions:
  - type: DeserializationError if something went wrong
- uid: azure.cognitiveservices.vision.face.models.PersonGroup.enable_additional_properties_sending
  name: enable_additional_properties_sending
  signature: enable_additional_properties_sending()
- uid: azure.cognitiveservices.vision.face.models.PersonGroup.from_dict
  name: from_dict
  summary: 'Parse a dict using given key extractor return a model.


    By default consider key

    extractors (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor

    and last_rest_key_case_insensitive_extractor)'
  signature: from_dict(data, key_extractors=None, content_type=None)
  parameters:
  - name: data
    description: A dict using RestAPI structure
    isRequired: true
    types:
    - <xref:dict>
  - name: content_type
    description: JSON by default, set application/xml if XML.
    defaultValue: None
    types:
    - <xref:str>
  - name: key_extractors
    defaultValue: None
  return:
    description: An instance of this model
  exceptions:
  - type: DeserializationError if something went wrong
- uid: azure.cognitiveservices.vision.face.models.PersonGroup.is_xml_model
  name: is_xml_model
  signature: is_xml_model()
- uid: azure.cognitiveservices.vision.face.models.PersonGroup.serialize
  name: serialize
  summary: 'Return the JSON that would be sent to azure from this model.


    This is an alias to *as_dict(full_restapi_key_transformer, keep_readonly=False)*.


    If you want XML serialization, you can pass the kwargs is_xml=True.'
  signature: serialize(keep_readonly=False, **kwargs)
  parameters:
  - name: keep_readonly
    description: If you want to serialize the readonly attributes
    defaultValue: 'False'
    types:
    - <xref:bool>
  return:
    description: A dict JSON compatible object
    types:
    - <xref:dict>
- uid: azure.cognitiveservices.vision.face.models.PersonGroup.validate
  name: validate
  summary: Validate this model recursively and return a list of ValidationError.
  signature: validate()
  return:
    description: A list of validation error
    types:
    - <xref:list>