Release-v27.0

declarative/declarations/assets/data.yaml

@@ -15,27 +15,32 @@ payload:
       introduced: '10.0'
 payloadkeys:
 - key: Reference
+  title: External reference
   type: <dictionary>
   presence: required
   content: The external reference.
   subkeys:
   - key: DataURL
+    title: Data URL
     type: <string>
     presence: required
     content: The URL to retrieve data, which needs to start with `https://`.
   - key: ContentType
+    title: Content type
     type: <string>
     presence: optional
     content: The media type that describes the data. If present, the system checks
       the actual media type of the downloaded data, and an error occurs if the values
       don't match.
   - key: Size
+    title: Size
     type: <integer>
     presence: optional
     content: The size of the data. Set the size to `0` if there's no expectation of
       a response body. If present, the system checks the actual size of the downloaded
       data, and an error occurs if the values don't match.
   - key: Hash-SHA-256
+    title: SHA-256 hash
     type: <string>
     presence: optional
     content: A SHA-256 hash of the data stored at the `DataURL`. Don't set this value
@@ -43,11 +48,14 @@ payloadkeys:
       the actual hash of the downloaded data, and an error occurs if the values don't
       match.
 - key: Authentication
+  title: Server authentication
   type: <dictionary>
   presence: optional
-  content: The server authentication details.
+  content: The server authentication details. If this key is absent, the default authentication
+    type is MDM.
   subkeys:
   - key: Type
+    title: Authentication type
     type: <string>
     presence: required
     rangelist:
@@ -57,3 +65,9 @@ payloadkeys:
       The type of authentication, which has these allowed values:
       - `MDM`: A request that uses MDM semantics, which includes the device-identity certificate, and any user authentication. This is equivalent to an MDM request made to the `CheckInURL` or `ServerURL`. This option is only available through declarative device management.
       - `None`: A standard GET request.
+
+      If the `Authentication` dictionary is absent, the default authentication type is MDM.
+examples:
+- title: Asset example
+  files:
+  - file: examples/declarative/declarations/assets/data/example1.json