AWS php sdk api-2.json is not synchronised with docs.aws.amazon.com

1

Hello guys! We have found some miss synchronisation between https://raw.githubusercontent.com/aws/aws-sdk-php/3.283.11/src/data/s3/2006-03-01/api-2.json and https://docs.aws.amazon.com documentation.

For example: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html says that CopyPartResult is required in response In https://raw.githubusercontent.com/aws/aws-sdk-php/3.283.11/src/data/s3/2006-03-01/api-2.json there are no required fields in responses at all Can it be somehow synchronised?

Nick
質問済み 7ヶ月前260ビュー
2回答
1

Hello,

I understand that you have noticed that "AWS php sdk api-2.json" is not synchronised with "docs.aws.amazon.com". The reason for discrepancies between official AWS documentation and specific SDK implementations, such as the AWS SDK for PHP, could be due to various factors:

  • Version Differences
  • Documentation Lag: The SDK documentation might not be up-to-date with the latest changes in the AWS service API. It takes time to update SDKs to reflect changes in the official AWS documentation.
  • Asynchronous Updates: Updates to documentation and SDKs might not happen simultaneously. The AWS service team might update the documentation, but it takes time for SDK maintainers to incorporate these changes into the SDK.

As per your concern "For example: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html says that CopyPartResult is required in response In https://raw.githubusercontent.com/aws/aws-sdk-php/3.283.11/src/data/s3/2006-03-01/api-2.json there are no required fields in responses at all Can it be somehow synchronised?"

The CopyPartResult is indeed a part of the response when you use the UploadPartCopy operation. This operation uploads a part in a multipart upload and specifies the range of bytes to copy from an existing object. The CopyPartResult typically contains information about the copied part, including the ETag, which is an MD5 hash of the part data. This information can be useful for tracking and verifying the uploaded data.


CopyPartResult:

Root level tag for the CopyPartResult parameters.

Required: Yes


[+] UploadPartCopy - https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html

[+] https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#uploadpartcopy

Since we at AWS are constantly trying to improve our offerings, I would like to inform that I have taken your feedback and have communicated the same to our documentation team.

AWS
サポートエンジニア
回答済み 6ヶ月前
0

Hey there! Any updates on this issue ?

mlnk
回答済み 1ヶ月前

ログインしていません。 ログイン 回答を投稿する。

優れた回答とは、質問に明確に答え、建設的なフィードバックを提供し、質問者の専門分野におけるスキルの向上を促すものです。

質問に答えるためのガイドライン

関連するコンテンツ