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
asked 6 months ago252 views
2 Answers
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
SUPPORT ENGINEER
answered 6 months ago
0

Hey there! Any updates on this issue ?

mlnk
answered 24 days ago

You are not logged in. Log in to post an answer.

A good answer clearly answers the question and provides constructive feedback and encourages professional growth in the question asker.

Guidelines for Answering Questions