azure.iot.hub.protocol.models.twin_properties_py3.TwinProperties.yml

### YamlMime:PythonClass
uid: azure.iot.hub.protocol.models.twin_properties_py3.TwinProperties
name: TwinProperties
fullName: azure.iot.hub.protocol.models.twin_properties_py3.TwinProperties
module: azure.iot.hub.protocol.models.twin_properties_py3
inheritances:
- msrest.serialization.Model
summary: 'The desired and reported properties of the twin. The maximum depth of the

  object is 10.'
constructor:
  syntax: TwinProperties(*, desired=None, reported=None, **kwargs)
  parameters:
  - name: desired
    description: 'The collection of desired property key-value pairs. The

      keys are UTF-8 encoded, case-sensitive and up-to 1KB in length. Allowed

      characters exclude UNICODE control characters (segments C0 and C1), ''.'',

      ''$'' and space. The desired porperty values are JSON objects, up-to 4KB in

      length.'
    isRequired: true
    types:
    - <xref:dict>[<xref:str>, <xref:object>]
  - name: reported
    description: 'The collection of reported property key-value pairs. The

      keys are UTF-8 encoded, case-sensitive and up-to 1KB in length. Allowed

      characters exclude UNICODE control characters (segments C0 and C1), ''.'',

      ''$'' and space. The reported property values are JSON objects, up-to 4KB in

      length.'
    isRequired: true
    types:
    - <xref:dict>[<xref:str>, <xref:object>]
  keywordOnlyParameters:
  - name: desired
    isRequired: true
  - name: reported
    isRequired: true
methods:
- uid: azure.iot.hub.protocol.models.twin_properties_py3.TwinProperties.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.iot.hub.protocol.models.twin_properties_py3.TwinProperties.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.iot.hub.protocol.models.twin_properties_py3.TwinProperties.enable_additional_properties_sending
  name: enable_additional_properties_sending
  signature: enable_additional_properties_sending()
- uid: azure.iot.hub.protocol.models.twin_properties_py3.TwinProperties.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.iot.hub.protocol.models.twin_properties_py3.TwinProperties.is_xml_model
  name: is_xml_model
  signature: is_xml_model()
- uid: azure.iot.hub.protocol.models.twin_properties_py3.TwinProperties.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.iot.hub.protocol.models.twin_properties_py3.TwinProperties.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>