From 6ecec2d2cfbe6eece1eb6901d75d028890006cde Mon Sep 17 00:00:00 2001 From: Amanda Nguyen <48961492+amnguye@users.noreply.github.com> Date: Tue, 8 Jun 2021 09:48:29 -0700 Subject: [PATCH] Align with service and documentation where Blob Quick Query XML elements are optional instead of required (#14688) --- .../preview/2019-12-12/blob.json | 30 ++++++---------- .../preview/2020-02-10/blob.json | 34 +++++++------------ .../preview/2020-04-08/blob.json | 34 +++++++------------ .../preview/2020-06-12/blob.json | 34 +++++++------------ .../preview/2020-08-04/blob.json | 34 +++++++------------ .../preview/2020-10-02/blob.json | 34 +++++++------------ 6 files changed, 70 insertions(+), 130 deletions(-) diff --git a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2019-12-12/blob.json b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2019-12-12/blob.json index 07a59ad2ef5b..153e8e03542d 100644 --- a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2019-12-12/blob.json +++ b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2019-12-12/blob.json @@ -10030,47 +10030,40 @@ "xml": { "name": "DelimitedTextConfiguration" }, - "description": "delimited text configuration", + "description": "Groups the settings used for interpreting the blob data if the blob is delimited text formatted.", "type": "object", - "required": [ - "ColumnSeparator", - "FieldQuote", - "RecordSeparator", - "EscapeChar", - "HeadersPresent" - ], "properties": { "ColumnSeparator": { "type": "string", - "description": "column separator", + "description": "The string used to separate columns.", "xml": { "name": "ColumnSeparator" } }, "FieldQuote": { "type": "string", - "description": "field quote", + "description": "The string used to quote a specific field.", "xml": { "name": "FieldQuote" } }, "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } }, "EscapeChar": { "type": "string", - "description": "escape char", + "description": "The string used as an escape character.", "xml": { "name": "EscapeChar" } }, "HeadersPresent": { "type": "boolean", - "description": "has headers", + "description": "Represents whether the data has headers.", "xml": { "name": "HasHeaders" } @@ -10083,13 +10076,10 @@ }, "description": "json text configuration", "type": "object", - "required": [ - "RecordSeparator" - ], "properties": { "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } @@ -10542,7 +10532,7 @@ } }, "QueryRequest": { - "description": "the quick query body", + "description": "Groups the set of query request settings.", "type": "object", "required": [ "QueryType", @@ -10551,7 +10541,7 @@ "properties": { "QueryType": { "type": "string", - "description": "the query type", + "description": "Required. The type of the provided query expression.", "xml": { "name": "QueryType" }, @@ -10561,7 +10551,7 @@ }, "Expression": { "type": "string", - "description": "a query statement", + "description": "The query expression in SQL. The maximum size of the query expression is 256KiB.", "xml": { "name": "Expression" } diff --git a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-02-10/blob.json b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-02-10/blob.json index 337fef865de0..ee556e2c9097 100644 --- a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-02-10/blob.json +++ b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-02-10/blob.json @@ -10053,47 +10053,40 @@ "xml": { "name": "DelimitedTextConfiguration" }, - "description": "delimited text configuration", + "description": "Groups the settings used for interpreting the blob data if the blob is delimited text formatted.", "type": "object", - "required": [ - "ColumnSeparator", - "FieldQuote", - "RecordSeparator", - "EscapeChar", - "HeadersPresent" - ], "properties": { "ColumnSeparator": { "type": "string", - "description": "column separator", + "description": "The string used to separate columns.", "xml": { "name": "ColumnSeparator" } }, "FieldQuote": { "type": "string", - "description": "field quote", + "description": "The string used to quote a specific field.", "xml": { "name": "FieldQuote" } }, "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } }, "EscapeChar": { "type": "string", - "description": "escape char", + "description": "The string used as an escape character.", "xml": { "name": "EscapeChar" } }, "HeadersPresent": { "type": "boolean", - "description": "has headers", + "description": "Represents whether the data has headers.", "xml": { "name": "HasHeaders" } @@ -10106,13 +10099,10 @@ }, "description": "json text configuration", "type": "object", - "required": [ - "RecordSeparator" - ], "properties": { "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } @@ -10123,7 +10113,7 @@ "xml": { "name": "ArrowConfiguration" }, - "description": "arrow configuration", + "description": "Groups the settings used for formatting the response if the response should be Arrow formatted.", "type": "object", "required": [ "Schema" @@ -10145,7 +10135,7 @@ "xml": { "name": "Field" }, - "description": "field of an arrow schema", + "description": "Groups settings regarding specific field of an arrow schema", "type": "object", "required": [ "Type" @@ -10611,7 +10601,7 @@ } }, "QueryRequest": { - "description": "the quick query body", + "description": "Groups the set of query request settings.", "type": "object", "required": [ "QueryType", @@ -10620,7 +10610,7 @@ "properties": { "QueryType": { "type": "string", - "description": "the query type", + "description": "Required. The type of the provided query expression.", "xml": { "name": "QueryType" }, @@ -10630,7 +10620,7 @@ }, "Expression": { "type": "string", - "description": "a query statement", + "description": "The query expression in SQL. The maximum size of the query expression is 256KiB.", "xml": { "name": "Expression" } diff --git a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-04-08/blob.json b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-04-08/blob.json index ba67c4b5d986..2e03da938f08 100644 --- a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-04-08/blob.json +++ b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-04-08/blob.json @@ -10435,47 +10435,40 @@ "xml": { "name": "DelimitedTextConfiguration" }, - "description": "delimited text configuration", + "description": "Groups the settings used for interpreting the blob data if the blob is delimited text formatted.", "type": "object", - "required": [ - "ColumnSeparator", - "FieldQuote", - "RecordSeparator", - "EscapeChar", - "HeadersPresent" - ], "properties": { "ColumnSeparator": { "type": "string", - "description": "column separator", + "description": "The string used to separate columns.", "xml": { "name": "ColumnSeparator" } }, "FieldQuote": { "type": "string", - "description": "field quote", + "description": "The string used to quote a specific field.", "xml": { "name": "FieldQuote" } }, "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } }, "EscapeChar": { "type": "string", - "description": "escape char", + "description": "The string used as an escape character.", "xml": { "name": "EscapeChar" } }, "HeadersPresent": { "type": "boolean", - "description": "has headers", + "description": "Represents whether the data has headers.", "xml": { "name": "HasHeaders" } @@ -10488,13 +10481,10 @@ }, "description": "json text configuration", "type": "object", - "required": [ - "RecordSeparator" - ], "properties": { "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } @@ -10505,7 +10495,7 @@ "xml": { "name": "ArrowConfiguration" }, - "description": "arrow configuration", + "description": "Groups the settings used for formatting the response if the response should be Arrow formatted.", "type": "object", "required": [ "Schema" @@ -10527,7 +10517,7 @@ "xml": { "name": "Field" }, - "description": "field of an arrow schema", + "description": "Groups settings regarding specific field of an arrow schema", "type": "object", "required": [ "Type" @@ -10993,7 +10983,7 @@ } }, "QueryRequest": { - "description": "the quick query body", + "description": "Groups the set of query request settings.", "type": "object", "required": [ "QueryType", @@ -11002,7 +10992,7 @@ "properties": { "QueryType": { "type": "string", - "description": "the query type", + "description": "Required. The type of the provided query expression.", "xml": { "name": "QueryType" }, @@ -11012,7 +11002,7 @@ }, "Expression": { "type": "string", - "description": "a query statement", + "description": "The query expression in SQL. The maximum size of the query expression is 256KiB.", "xml": { "name": "Expression" } diff --git a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-06-12/blob.json b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-06-12/blob.json index 0f45345431cd..bbb85b9eb346 100644 --- a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-06-12/blob.json +++ b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-06-12/blob.json @@ -10820,47 +10820,40 @@ "xml": { "name": "DelimitedTextConfiguration" }, - "description": "delimited text configuration", + "description": "Groups the settings used for interpreting the blob data if the blob is delimited text formatted.", "type": "object", - "required": [ - "ColumnSeparator", - "FieldQuote", - "RecordSeparator", - "EscapeChar", - "HeadersPresent" - ], "properties": { "ColumnSeparator": { "type": "string", - "description": "column separator", + "description": "The string used to separate columns.", "xml": { "name": "ColumnSeparator" } }, "FieldQuote": { "type": "string", - "description": "field quote", + "description": "The string used to quote a specific field.", "xml": { "name": "FieldQuote" } }, "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } }, "EscapeChar": { "type": "string", - "description": "escape char", + "description": "The string used as an escape character.", "xml": { "name": "EscapeChar" } }, "HeadersPresent": { "type": "boolean", - "description": "has headers", + "description": "Represents whether the data has headers.", "xml": { "name": "HasHeaders" } @@ -10873,13 +10866,10 @@ }, "description": "json text configuration", "type": "object", - "required": [ - "RecordSeparator" - ], "properties": { "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } @@ -10890,7 +10880,7 @@ "xml": { "name": "ArrowConfiguration" }, - "description": "arrow configuration", + "description": "Groups the settings used for formatting the response if the response should be Arrow formatted.", "type": "object", "required": [ "Schema" @@ -10912,7 +10902,7 @@ "xml": { "name": "Field" }, - "description": "field of an arrow schema", + "description": "Groups settings regarding specific field of an arrow schema", "type": "object", "required": [ "Type" @@ -11378,7 +11368,7 @@ } }, "QueryRequest": { - "description": "the quick query body", + "description": "Groups the set of query request settings.", "type": "object", "required": [ "QueryType", @@ -11387,7 +11377,7 @@ "properties": { "QueryType": { "type": "string", - "description": "the query type", + "description": "Required. The type of the provided query expression.", "xml": { "name": "QueryType" }, @@ -11397,7 +11387,7 @@ }, "Expression": { "type": "string", - "description": "a query statement", + "description": "The query expression in SQL. The maximum size of the query expression is 256KiB.", "xml": { "name": "Expression" } diff --git a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-08-04/blob.json b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-08-04/blob.json index 4f86f34808ea..91aba3f8aa34 100644 --- a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-08-04/blob.json +++ b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-08-04/blob.json @@ -10820,47 +10820,40 @@ "xml": { "name": "DelimitedTextConfiguration" }, - "description": "delimited text configuration", + "description": "Groups the settings used for interpreting the blob data if the blob is delimited text formatted.", "type": "object", - "required": [ - "ColumnSeparator", - "FieldQuote", - "RecordSeparator", - "EscapeChar", - "HeadersPresent" - ], "properties": { "ColumnSeparator": { "type": "string", - "description": "column separator", + "description": "The string used to separate columns.", "xml": { "name": "ColumnSeparator" } }, "FieldQuote": { "type": "string", - "description": "field quote", + "description": "The string used to quote a specific field.", "xml": { "name": "FieldQuote" } }, "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } }, "EscapeChar": { "type": "string", - "description": "escape char", + "description": "The string used as an escape character.", "xml": { "name": "EscapeChar" } }, "HeadersPresent": { "type": "boolean", - "description": "has headers", + "description": "Represents whether the data has headers.", "xml": { "name": "HasHeaders" } @@ -10873,13 +10866,10 @@ }, "description": "json text configuration", "type": "object", - "required": [ - "RecordSeparator" - ], "properties": { "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } @@ -10890,7 +10880,7 @@ "xml": { "name": "ArrowConfiguration" }, - "description": "arrow configuration", + "description": "Groups the settings used for formatting the response if the response should be Arrow formatted.", "type": "object", "required": [ "Schema" @@ -10919,7 +10909,7 @@ "xml": { "name": "Field" }, - "description": "field of an arrow schema", + "description": "Groups settings regarding specific field of an arrow schema", "type": "object", "required": [ "Type" @@ -11385,7 +11375,7 @@ } }, "QueryRequest": { - "description": "the quick query body", + "description": "Groups the set of query request settings.", "type": "object", "required": [ "QueryType", @@ -11394,7 +11384,7 @@ "properties": { "QueryType": { "type": "string", - "description": "the query type", + "description": "Required. The type of the provided query expression.", "xml": { "name": "QueryType" }, @@ -11404,7 +11394,7 @@ }, "Expression": { "type": "string", - "description": "a query statement", + "description": "The query expression in SQL. The maximum size of the query expression is 256KiB.", "xml": { "name": "Expression" } diff --git a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-10-02/blob.json b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-10-02/blob.json index b300ee4b3225..a4a2b1d51706 100644 --- a/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-10-02/blob.json +++ b/specification/storage/data-plane/Microsoft.BlobStorage/preview/2020-10-02/blob.json @@ -10838,47 +10838,40 @@ "xml": { "name": "DelimitedTextConfiguration" }, - "description": "delimited text configuration", + "description": "Groups the settings used for interpreting the blob data if the blob is delimited text formatted.", "type": "object", - "required": [ - "ColumnSeparator", - "FieldQuote", - "RecordSeparator", - "EscapeChar", - "HeadersPresent" - ], "properties": { "ColumnSeparator": { "type": "string", - "description": "column separator", + "description": "The string used to separate columns.", "xml": { "name": "ColumnSeparator" } }, "FieldQuote": { "type": "string", - "description": "field quote", + "description": "The string used to quote a specific field.", "xml": { "name": "FieldQuote" } }, "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } }, "EscapeChar": { "type": "string", - "description": "escape char", + "description": "The string used as an escape character.", "xml": { "name": "EscapeChar" } }, "HeadersPresent": { "type": "boolean", - "description": "has headers", + "description": "Represents whether the data has headers.", "xml": { "name": "HasHeaders" } @@ -10891,13 +10884,10 @@ }, "description": "json text configuration", "type": "object", - "required": [ - "RecordSeparator" - ], "properties": { "RecordSeparator": { "type": "string", - "description": "record separator", + "description": "The string used to separate records.", "xml": { "name": "RecordSeparator" } @@ -10908,7 +10898,7 @@ "xml": { "name": "ArrowConfiguration" }, - "description": "arrow configuration", + "description": "Groups the settings used for formatting the response if the response should be Arrow formatted.", "type": "object", "required": [ "Schema" @@ -10937,7 +10927,7 @@ "xml": { "name": "Field" }, - "description": "field of an arrow schema", + "description": "Groups settings regarding specific field of an arrow schema", "type": "object", "required": [ "Type" @@ -11403,7 +11393,7 @@ } }, "QueryRequest": { - "description": "the quick query body", + "description": "Groups the set of query request settings.", "type": "object", "required": [ "QueryType", @@ -11412,7 +11402,7 @@ "properties": { "QueryType": { "type": "string", - "description": "the query type", + "description": "Required. The type of the provided query expression.", "xml": { "name": "QueryType" }, @@ -11422,7 +11412,7 @@ }, "Expression": { "type": "string", - "description": "a query statement", + "description": "The query expression in SQL. The maximum size of the query expression is 256KiB.", "xml": { "name": "Expression" }