仪表板提交对象Dashboard submission objects

重要提示 截至 2016 年 10 月底,将不再提供可使用的仪表板提交 REST API。Important The dashboard submission REST APIs will no longer be available for use as of the end of October 2016. 正在考虑为将来版本提供适用于驱动程序提交的 API。APIs for driver submissions are under consideration for a future release.

这些对象包含有关仪表板提交的信息。These objects contain information about the dashboard submissions.

下表显示了仪表板提交对象:The following list shows the dashboard submission objects:

AssetAsset

与仪表板提交关联的附件,例如硬件认证工具包 (HCK) 和签名目录。The collateral associated with the dashboard submission, such as Hardware Certification Kit (HCK) packages and signed catalogs.

这些资源存储在 Azure 存储中,并且可以通过共享访问签名 (SAS) URI 和 Azure 存储 API 进行访问。These assets are stored in Azure Storage and can be accessed using the Shared Access Signature (SAS) URI and the Azure Storage API. 有关下载资源的详细信息,请参阅创建生产设备提交For more information about downloading assets, see Create a production device submission.

属性Properties

下表显示了资源属性。The following table shows the asset properties.

属性名Property name 类型Type 说明Description

DeviceSigningAssetIDDeviceSigningAssetID

GUIDGUID

资源的唯一标识符。The unique identifier for the asset. 使用此属性可请求一个用于下载资源的 SAS URL。Use this property to request an SAS URL to download the asset.

名称Name

字符串String

资源的用户友好描述。A user-friendly description of the asset.

AssetTypeAssetType

AssetTypeAssetType

一个枚举,用于标识特定资源。An enumeration identifying a specific asset.

方法Methods

GetPut 方法在所有属性上均受支持。Get and Put methods are supported on all properties.

示例对象Example object

Asset : {
 "DeviceSigningAssetID" : "4e53d41f-4ccc-481c-bd00-0f73400f5d6a",
 "Name" : "contoso_toaster.hckx",
 "AssetType" : "InitialUpload"
}

AssetTypeAssetType

一个枚举,用于描述与仪表板提交关联的资源。An enumeration describing an asset associated with a dashboard submission.

可能值:Possible values:

  • InitialUpload – 一个已上载的提交。InitialUpload – a submission that has been uploaded.

  • SignedFile – 一个已签名文件。SignedFile – a signed file.

MarketingNameMarketingName

用于描述你的产品的名称。Name describing your product. 这些名称显示在 SysDev 仪表板的 Windows 认证产品列表中。These names appear on the Windows Certified Products List in the SysDev Dashboard.

属性Properties

下表显示了 MarketingName 属性。The following table shows the MarketingName properties.

属性名Property name 类型Type 说明Description

名称Name

字符串String

一个自定义字符串,用于描述你的产品。A custom string describing your product.

LocaleLocale

字符串String

一组字符串,用于定义你的产品的区域设置。A set of strings defining the locale for your product.

方法Methods

Get 和 Put 方法在所有属性上均受支持。Get and Put methods are supported on all properties.

示例对象Example object

MarketingName : {
"Name" : "Localized Contoso Toaster",
"Locales" : ["en-US"]
}

OSSelectionOSSelection

描述了支持你的产品的操作系统。Describes the supported operating systems for your product. 它还包含你的提交的分类,如硬件认证分类中所列。It also contains the classification of your submission as listed in the Hardware Certification Taxonomy. 你可以使用此对象获取低级别的签名。You can also use this object to get down-level signatures.

属性Properties

下表显示了 OSSelection 属性。The following table shows the OSSelection properties.

属性名Property name 类型Type 说明Description 是否为必需?Required? 默认Default

操作系统OS

字符串String

支持此产品的操作系统。The operating system for this product.

Yes

UnclassifiedUnclassified

ProductTypeProductType

字符串String

产品类型,如硬件认证分类中所列。The product type as listed in the Hardware Certification Taxonomy. 你还可以在硬件认证对象模型中找到此值。You can also find this value in the Hardware Certification Object Model.

No

SignatureOnlySignatureOnly

QualificationLevelQualificationLevel

字符串String

一个字符串,用于为指定的操作系统定义请求的资格。A string defining the requested qualification for the specified operating system. 可能值:Possible values:

  • SignatureOnlySignatureOnly

  • 接受Accepted

  • 认证Certified

NiNi

SignatureOnlySignatureOnly

方法Methods

GetPut 方法在所有属性上均受支持。Get and Put methods are supported on all properties.

示例对象Example object

{
"OS" : "Windows 8",
"ProductType" : "Printer",
"QualificationLevel" : "Signature Only"
}

SigningRequestSigningRequest

文件签名服务的初始输入对象。The initial input object for the File Signing Services.

属性Properties

下表显示了资源属性。The following table shows the asset properties.

属性名Property name 类型Type 说明Description 是否为必需?Required?

ProductNameProductName

字符串String

主产品名称。The primary product name.

Yes

AnnouncementDateAnnouncementDate

DateTimeDateTime

产品将显示在仪表板报告(如认证产品列表和 Windows 兼容中心)上的日期和时间。The date and time that the product will appear on Dashboard reports, such as the Certified Products List and Windows Compatibility Center.

No

PublishingDatePublishingDate

DateTimeDateTime

产品将发布到 Windows 更新的日期和时间。The date and time that the product will be published to Windows Update.

No

MarketingNamesMarketingNames

MarketingName[]MarketingName[]

产品的营销名称列表。The list of marketing names for the product. 每个请求都有一个主名称(必选)和任意数目的别名。Each request has one primary name (required), and any number of aliases.

No

OSSelectionsOSSelections

字符串String

描述了支持你的产品的操作系统。Describes the supported operating systems for your product. 它还包含你的提交的分类,如硬件认证分类中所列。It also contains the classification of your submission as listed in the Hardware Certification Taxonomy. 你可以使用此对象获取低级别的签名。You can also use this object to get down-level signatures.

InitialUploadFileSizeInitialUploadFileSize

LongLong

要上载的文件长度,以字节单位。The length in bytes of the file to be uploaded.

TestHarnessTypeTestHarnessType

字符串String

用于创建此程序包的工具包类型。The type of kit that was used to create this package. 值应该为 HLK 或 HCK。Value should be either HLK or HCK.

方法Methods

GetPut 方法在所有属性上均受支持。Get and Put methods are supported on all properties.

示例对象Example object

{
"ProductName" : "Testing Name",
"MarketingNames" : ["Localized Contoso Toaster"],
"AnnouncementDate" : "2015-01-01T00:00:00",
"PublishingDate" : "2015-11-11T00:00:00",
"OSSelections" : [{
"OS" : "Windows 8",
"ProductType" : "Printer",
"QualificationLevel" : "Signature Only"
}
], 
"InitialUploadFileSize":1233334563,
“TestHarnessType”:”HLK”
}

SigningRequestInfoSigningRequestInfo

描述了一个仪表板提交。Describes a Dashboard submission. 你可以使用此对象来确定仪表板处理是否完成、选择要下载的资源,或查看已授予的资格。You can use this object to determine whether Dashboard processing is complete, select assets for download, or view qualifications that have been granted.

属性Properties

下表显示了 SigningRequestInfo 属性。The following table shows the SigningRequestInfo properties.

属性名Property name 类型Type 说明Description

RequestIDRequestID

GUIDGUID

此提交的唯一标识符。The unique identifier for this submission. 通过 PATCHGET 服务调用,可使用此属性访问请求。Use this to access the request through PATCH and GET service calls.

ProductNameProductName

字符串String

主产品名称。The primary product name.

SubmissionIDSubmissionID

字符串String

提交的仪表板提交 ID。The Dashboard submission ID for the submission.

状态Status

字符串String

请求的处理状态。The processing status of the request.

CreatedDateCreatedDate

DateTimeDateTime

请求生成的日期和时间。The date and time that the request was generated.

AnnouncementDateAnnouncementDate

DateTimeDateTime

产品将显示在 Microsoft 报告(如 Windows 认证产品列表Windows 兼容中心)上的日期和时间。The date and time that the product will appear on Microsoft reports, such as the Windows Certified Products List and Windows Compatibility Center.

PublishingDatePublishingDate

DateTimeDateTime

产品将发布到 Windows 更新的日期和时间。The date and time that the product will be published to Windows Update.

VerificationReportVerificationReport

URLURL

认证验证报告 PDF 文件的位置。The location of the Certification Verification Report PDF file.

MarketingNamesMarketingNames

MarketingName []MarketingName []

提交的营销名称列表。The list of marketing names for the submission. 每个提交在此集合中都有一个主名称(必选)和任意数目的别名。Each submission has one primary name (required), and any number of aliases in this collection.

资源Assets

Asset[]Asset[]

与提交关联的资源列表。The list of asset associated with the submission. 用于描述已上载程序包、已签名文件和 DUA shell 包的资源。Assets describe the uploaded packages, signed files, and DUA shell packages.

OSSelectionsOSSelections

字符串String

描述了支持你的产品的操作系统。Describes the supported operating systems for your product. 它还包含你的提交的分类,如硬件认证分类中所列。It also contains the classification of your submission as listed in the Hardware Certification Taxonomy. 你可以使用此对象获取低级别的签名。You can also use this object to get down-level signatures.

方法Methods

GetPut 方法在所有属性上均受支持。Get and Put methods are supported on all properties.

示例对象Example object

{
"RequestID" : "2b70c57a-7898-48dc-b877-4c0541885eb9",
"ProductName" : "Contoso Toaster",
"SubmissionID" : 33,
"Status" : "Approved",
"CreatedDate" : "2014-01-01T00:00:00",
"AnnouncementDate" : "2015-01-01T00:00:00",
"PublishingDate" : "2015-11-11T00:00:00",
"VerificationReport" : "https://sysdev.microsoft.com/LogoVerificationReport.aspx?sid=32",
"OSSelections" : [{
"OS" : "Windows 8",
"ProductType" : "Printer",
"QualificationLevel" : "Signature Only"
}
],
"MarketingNames" : [{
"Name" : " Localized Contoso Toaster ",
"Locales" : ["en-US"]
}
],
"Assets" : [{
"DeviceSigningAssetID" : "4e53d41f-4ccc-481c-bd00-0f73400f5d6a",
"Name" : "32.hckx",
"AssetType" : 1
}
]
}

SigningRequestUpdateSigningRequestUpdate

用于更新现有提交的对象。The object used for updating an existing submission. 你可以使用此对象将提交标记为 UploadComplete 来启动后端处理。You can also use this object to mark a submission as UploadComplete to start backend processing.

属性Properties

下表显示了资源属性。The following table shows the asset properties.

属性名Property name 类型Type 说明Description 是否为必需?Required?

RequestIDRequestID

GUIDGUID

此提交的唯一标识符。The unique identifier for this submission. 通过 PATCHGET 服务调用,可使用此属性访问请求。Use this to access the request through PATCH and GET service calls.

Yes

ProductNameProductName

字符串String

主产品名称。The primary product name.

No

AnnouncementDateAnnouncementDate

DateTimeDateTime

产品将显示在仪表板报告(如认证产品列表和 Windows 兼容中心)上的日期和时间。The date and time that the product will appear on Dashboard reports, such as the Certified Products List and Windows Compatibility Center.

No

PublishingDatePublishingDate

DateTimeDateTime

产品将发布到 Windows 更新的日期和时间。The date and time that the product will be published to Windows Update.

No

MarketingNamesMarketingNames

MarketingName[]MarketingName[]

产品的营销名称列表。The list of marketing names for the product. 每个请求都有一个主名称(必选)和任意数目的别名。Each request has one primary name (required), and any number of aliases.

No

UploadCompleteUploadComplete

BoolBool

一个标志,用于指定你何时已针对此提交成功上载初始包。A flag specifying when you have successfully uploaded the initial package for this submission. 使用更新现有提交步骤将此属性设置为 TRUE,来启动后端处理。Use Update an existing submission procedure to set this property to TRUE to start backend processing.

No

方法Methods

GetPut 方法在所有属性上均受支持。Get and Put methods are supported on all properties.

示例对象Example object

{
"RequestID" : "2b70c57a-7898-48dc-b877-4c0541885eb9",
"ProductName" : "Contoso Toaster",
"AnnouncementDate" : "2015-01-01T00:00:00",
"PublishingDate" : "2015-11-11T00:00:00",
"MarketingNames" : [{
"Name" : "Localized Contoso Toaster",
"Locales" : ["en-US"]
}
],
"UploadComplete" : true
}

向 Microsoft 发送有关该主题的评论Send comments about this topic to Microsoft