createUploadDestinationForResource

创建一个上传目标，返回所需的信息以将文件上传到该目标并以编程方式访问该文件。

使用计划：

速率（每秒请求数）	突发
10	10

x-amzn-RateLimit-Limit 响应头返回适用于请求操作的使用计划速率限制（如果可用）。上表指示了此操作的默认速率和突发值。其业务需求需要更高吞吐量的销售合作伙伴可能会看到比此处显示的更高的速率和突发值。有关更多信息，请参阅销售合作伙伴 API 中的使用计划和速率限制。

请求参数

Path 参数

resource

string

必需

您正在创建的上传目标的资源。例如，如果您正在为Messaging API的createLegalDisclosure操作创建上传目标，则 {resource} 将是 /messaging/v1/orders/{amazonOrderId}/messages/legalDisclosure，而整个路径将是 /uploads/2020-11-01/uploadDestinations/messaging/v1/orders/{amazonOrderId}/messages/legalDisclosure。如果您正在为Aplus内容文档创建上传目标，则 {resource} 将是 aplus/2020-11-01/contentDocuments，路径将是 /uploads/v1/uploadDestinations/aplus/2020-11-01/contentDocuments。

Query 参数

marketplaceIds

array[string]

必需

一个市场标识符的列表。这指定了上传将可用的市场。只能指定一个市场。

<= 1 items

contentMD5

string

必需

要提交到上传目标的内容的MD5哈希值。这个值用于确定在传输过程中数据是否已被损坏或篡改。

contentType

string

可选

要上传的文件的内容类型。

返回响应

🟢201成功

application/json

成功。

Headers

x-amzn-RateLimit-Limit

string

可选

您对此操作的速率限制（每秒请求数量）。

x-amzn-RequestId

string

可选

唯一请求参考标识符。

Body

createUploadDestination 操作的响应架构。

payload

object (UploadDestination)

可选

有关上传目的地的信息。

uploadDestinationId

string

可选

上传目标的唯一标识符。

url

string

上传目标的URL。

可选

headers

object

可选

上传请求中包含的头部。

errors

array[object (Error) {3}]

可选

请求失败时返回的错误响应列表。

code

string

必需

一个标识发生错误类型的错误代码。

message

string

必需

一种以人类可读的形式描述错误状态的消息。

details

string

可选

可以帮助拨打者理解或解决问题的附加细节。

示例

{
  "payload": {
    "uploadDestinationId": "5d4e42b5-1d6e-44e8-a89c-2abfca0625bb",
    "url": "https://s3.amazonaws.com/buyer-seller-messaging-test-draft-attachment-namarketplace/%2F067/5d4e42b5-1d6e-44e8-a89c-2abfca0625bb?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20190701T214102Z&X-Amz-SignedHeaders=content-md5%3Bhost%3Bx-amz-server-side-encryption&X-Amz-Expires=900&X-Amz-Credential=AKIAW5VUA47ENEOYT7RC%2F20190701%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=d4f85c5f1a32a788a8d54e3f00a2a08af45be5b83551cdd81c82ae353dfcdfd4",
    "headers": {
      "Content-MD5": "5d41402abc4b2a76b9719d911017c592",
      "x-amz-server-side-encryption": "aws:kms"
    }
  }
}

🟠400请求有误

🟠403禁止访问

🟠404记录不存在

🟠413413

🟠415415

🟠429429

🔴500服务器错误

🔴503服务器故障

请求参数

示例代码

返回响应