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
gefragt vor 7 Monaten260 Aufrufe
2 Antworten
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-TECHNIKER
beantwortet vor 6 Monaten
0

Hey there! Any updates on this issue ?

mlnk
beantwortet vor einem Monat

Du bist nicht angemeldet. Anmelden um eine Antwort zu veröffentlichen.

Eine gute Antwort beantwortet die Frage klar, gibt konstruktives Feedback und fördert die berufliche Weiterentwicklung des Fragenstellers.

Richtlinien für die Beantwortung von Fragen