Post by AMI_archerwen on Feb 24, 2022 4:29:12 GMT
"TransferProtocol": {
"$ref": "#/definitions/TransferProtocolType",
"description": "The network protocol that the Update Service uses to retrieve the software image file located at the URI provided in ImageURI, if the URI does not contain a scheme.",
"longDescription": "This parameter shall contain the network protocol that the Update Service shall use to retreive the software image located at the ImageURI. If this parameter is not provided (or supported), and a transfer protocol is not specified by a scheme contained within this URI, the Service shall use HTTP to retrieve the image."
}
"TransferProtocolType": {
"enum": [
"CIFS",
"FTP",
"SFTP",
"HTTP",
"HTTPS",
"NSF",
"SCP",
"TFTP",
"OEM",
"NFS"
],
"enumDeprecated": {
"NSF": "This value has been deprecated in favor of NFS."
},
"enumDescriptions": {
"CIFS": "Common Internet File System (CIFS).",
"FTP": "File Transfer Protocol (FTP).",
"HTTP": "Hypertext Transfer Protocol (HTTP).",
"HTTPS": "Hypertext Transfer Protocol Secure (HTTPS).",
"NFS": "Network File System (NFS).",
"NSF": "Network File System (NFS).",
"OEM": "A manufacturer-defined protocol.",
"SCP": "Secure Copy Protocol (SCP).",
"SFTP": "Secure File Transfer Protocol (SFTP).",
"TFTP": "Trivial File Transfer Protocol (TFTP)."
},
"enumVersionAdded": {
"NFS": "v1_3_0",
"SFTP": "v1_1_0"
},
"enumVersionDeprecated": {
"NSF": "v1_3_0"
},
"type": "string"
}
Above is the definition of "TransferProtocol" in schema.
I know this is not a required property when we send the SimpleUpdate request.
And the schema mentioned "If this parameter is not provided (or supported), and a transfer protocol is not specified by a scheme contained within this URI, the Service shall use HTTP to retrieve the image."
But I have a question for "Not supported", below is the example.
{
"TransferProtocol": "BBB",
"ImageURI": "192.168.0.112/Firmware/imagename.ima"
}
If the provide a non sense value (not list in enum value) for "TransferProtocol", is the request still can be send? -> I think this is also a kind of "Not supported" situation.
Or actually we can choose some of enum value from the list to supported? -> We don't need to supported all.
Thanks,
Archer.
"$ref": "#/definitions/TransferProtocolType",
"description": "The network protocol that the Update Service uses to retrieve the software image file located at the URI provided in ImageURI, if the URI does not contain a scheme.",
"longDescription": "This parameter shall contain the network protocol that the Update Service shall use to retreive the software image located at the ImageURI. If this parameter is not provided (or supported), and a transfer protocol is not specified by a scheme contained within this URI, the Service shall use HTTP to retrieve the image."
}
"TransferProtocolType": {
"enum": [
"CIFS",
"FTP",
"SFTP",
"HTTP",
"HTTPS",
"NSF",
"SCP",
"TFTP",
"OEM",
"NFS"
],
"enumDeprecated": {
"NSF": "This value has been deprecated in favor of NFS."
},
"enumDescriptions": {
"CIFS": "Common Internet File System (CIFS).",
"FTP": "File Transfer Protocol (FTP).",
"HTTP": "Hypertext Transfer Protocol (HTTP).",
"HTTPS": "Hypertext Transfer Protocol Secure (HTTPS).",
"NFS": "Network File System (NFS).",
"NSF": "Network File System (NFS).",
"OEM": "A manufacturer-defined protocol.",
"SCP": "Secure Copy Protocol (SCP).",
"SFTP": "Secure File Transfer Protocol (SFTP).",
"TFTP": "Trivial File Transfer Protocol (TFTP)."
},
"enumVersionAdded": {
"NFS": "v1_3_0",
"SFTP": "v1_1_0"
},
"enumVersionDeprecated": {
"NSF": "v1_3_0"
},
"type": "string"
}
Above is the definition of "TransferProtocol" in schema.
I know this is not a required property when we send the SimpleUpdate request.
And the schema mentioned "If this parameter is not provided (or supported), and a transfer protocol is not specified by a scheme contained within this URI, the Service shall use HTTP to retrieve the image."
But I have a question for "Not supported", below is the example.
{
"TransferProtocol": "BBB",
"ImageURI": "192.168.0.112/Firmware/imagename.ima"
}
If the provide a non sense value (not list in enum value) for "TransferProtocol", is the request still can be send? -> I think this is also a kind of "Not supported" situation.
Or actually we can choose some of enum value from the list to supported? -> We don't need to supported all.
Thanks,
Archer.