Azure / azure-rest-api-specs

The source for REST API specifications for Microsoft Azure.
MIT License
2.61k stars 5.02k forks source link

Storage blob inventory policy schemaFields description doesn't match with the server behavior #21503

Open yifanz0 opened 1 year ago

yifanz0 commented 1 year ago

In the description of schemaFields https://github.com/Azure/azure-rest-api-specs/blob/main/specification/storage/resource-manager/Microsoft.Storage/stable/2022-05-01/storage.json#L5256, it says

The valid values for this field for the 'Blob' definition.objectType include 'Name, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, AccessTierInferred, Tags, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Snapshot, VersionId, IsCurrentVersion, Metadata, LastAccessTime, Tags, Etag, ContentType, ContentEncoding, ContentLanguage, ContentCRC64, CacheControl, ContentDisposition, LeaseStatus, LeaseState, LeaseDuration, ServerEncrypted, Deleted, DeletionId, DeletedTime, RemainingRetentionDays, ImmutabilityPolicyUntilDate, ImmutabilityPolicyMode, LegalHold, CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTime, CopyStatusDescription, CustomerProvidedKeySha256, RehydratePriority, ArchiveStatus, XmsBlobSequenceNumber, EncryptionScope, IncrementalCopy, TagCount'.

However the server throws an exception saying the input is valid if we use those values (ContentType, ContentEncoding, ContentLanguage, ContentCRC64, CacheControl, ContentDisposition). Instead, it asks for Content-Type, Content-Encoding, Content-Language, Content-CRC64, Cache-Control, and Content-Disposition.

ghost commented 1 year ago

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @xgithubtriage.

Issue Details
In the description of schemaFields https://github.com/Azure/azure-rest-api-specs/blob/main/specification/storage/resource-manager/Microsoft.Storage/stable/2022-05-01/storage.json#L5256, it says The valid values for this field for the 'Blob' definition.objectType include 'Name, Creation-Time, Last-Modified, Content-Length, Content-MD5, BlobType, AccessTier, AccessTierChangeTime, AccessTierInferred, Tags, Expiry-Time, hdi_isfolder, Owner, Group, Permissions, Acl, Snapshot, VersionId, IsCurrentVersion, Metadata, LastAccessTime, Tags, Etag, **ContentType, ContentEncoding, ContentLanguage, ContentCRC64, CacheControl, ContentDisposition,** LeaseStatus, LeaseState, LeaseDuration, ServerEncrypted, Deleted, DeletionId, DeletedTime, RemainingRetentionDays, ImmutabilityPolicyUntilDate, ImmutabilityPolicyMode, LegalHold, CopyId, CopyStatus, CopySource, CopyProgress, CopyCompletionTime, CopyStatusDescription, CustomerProvidedKeySha256, RehydratePriority, ArchiveStatus, XmsBlobSequenceNumber, EncryptionScope, IncrementalCopy, TagCount'. However the server throws an exception saying the input is valid if we use those values (ContentType, ContentEncoding, ContentLanguage, ContentCRC64, CacheControl, ContentDisposition). Instead, it asks for **Content-Type, Content-Encoding, Content-Language, Content-CRC64, Cache-Control, and Content-Disposition**.
Author: yifanz0
Assignees: -
Labels: `Storage`, `Service Attention`
Milestone: -
blueww commented 1 year ago

@HimanshuChhabra Would you please help to look at this issue and fix the description if needed?