From f8cef27d6ab529652778af4be6a6d7765ffaad95 Mon Sep 17 00:00:00 2001 From: Millicent Achieng Date: Thu, 25 Apr 2024 01:29:22 +0300 Subject: [PATCH] Fetch annotations for paths ending with navigation properties using target path (#509) * Fetch annotations for paths ending with navigation properties using target path * Allow fetching annotations using either path or navigation property as target * Update tests * Temporarily remove typecasts from TargetPath used for fetching annotations until we have a fix in the Edm library * Update release notes * Update Microsoft.OData.Edm library which now allows type casts in annotation target paths * Update tests * Merge annotations if some are defined out of line using TargetPath and other inline on the schema element * Update release notes --- .../Edm/EdmAnnotationExtensions.cs | 58 +- .../Generator/OpenApiParameterGenerator.cs | 90 + .../Microsoft.OpenAPI.OData.Reader.csproj | 6 +- .../ComplexPropertyBaseOperationHandler.cs | 21 + .../ComplexPropertyGetOperationHandler.cs | 23 +- .../ComplexPropertyPostOperationHandler.cs | 12 +- .../ComplexPropertyUpdateOperationHandler.cs | 12 +- .../DollarCountGetOperationHandler.cs | 16 +- .../Operation/EdmActionOperationHandler.cs | 13 +- .../Operation/EdmFunctionOperationHandler.cs | 13 +- .../EdmOperationImportOperationHandler.cs | 50 +- .../Operation/EdmOperationOperationHandler.cs | 54 +- .../Operation/EntityDeleteOperationHandler.cs | 12 +- .../Operation/EntityGetOperationHandler.cs | 12 +- .../Operation/EntitySetGetOperationHandler.cs | 22 +- .../Operation/EntitySetOperationHandler.cs | 16 +- .../EntitySetPostOperationHandler.cs | 12 +- .../Operation/EntityUpdateOperationHandler.cs | 12 +- .../MediaEntityGetOperationHandler.cs | 42 +- .../MediaEntityOperationalHandler.cs | 73 +- .../MediaEntityPutOperationHandler.cs | 50 +- .../NavigationPropertyGetOperationHandler.cs | 10 +- .../NavigationPropertyOperationHandler.cs | 112 +- .../ODataTypeCastGetOperationHandler.cs | 30 +- .../Operation/OperationHandler.cs | 27 +- .../Operation/SingletonGetOperationHandler.cs | 12 +- .../Operation/SingletonOperationHandler.cs | 18 +- .../SingletonPatchOperationHandler.cs | 12 +- .../Capabilities/DeleteRestrictionsType.cs | 30 + .../Capabilities/InsertRestrictionsType.cs | 34 + .../Capabilities/OperationRestrictionsType.cs | 20 +- .../Capabilities/ReadRestrictionsType.cs | 37 + .../Capabilities/UpdateRestrictionsType.cs | 42 + .../Vocabulary/Core/{Link.cs => LinkType.cs} | 4 +- ...ComplexPropertyGetOperationHandlerTests.cs | 27 + .../DollarCountGetOperationHandlerTests.cs | 59 + .../MediaEntityGetOperationHandlerTests.cs | 29 +- .../MediaEntityPutOperationHandlerTests.cs | 28 + ...tionPropertyDeleteOperationHandlerTests.cs | 26 + ...igationPropertyGetOperationHandlerTests.cs | 30 + ...gationPropertyPostOperationHandlerTests.cs | 26 + .../ODataTypeCastGetOperationHandlerTests.cs | 34 +- .../RefDeleteOperationHandlerTests.cs | 1 + .../Resources/TripService.OData.xml | 1066 ++--- .../Resources/TripService.OpenApi.V2.json | 3501 ++++++++++++++-- .../Resources/TripService.OpenApi.V2.yaml | 2253 ++++++++++- .../Resources/TripService.OpenApi.json | 3571 +++++++++++++++-- .../Resources/TripService.OpenApi.yaml | 2320 ++++++++++- 48 files changed, 12609 insertions(+), 1369 deletions(-) rename src/Microsoft.OpenApi.OData.Reader/Vocabulary/Core/{Link.cs => LinkType.cs} (93%) diff --git a/src/Microsoft.OpenApi.OData.Reader/Edm/EdmAnnotationExtensions.cs b/src/Microsoft.OpenApi.OData.Reader/Edm/EdmAnnotationExtensions.cs index 9b9658f9..9da97a5d 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Edm/EdmAnnotationExtensions.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Edm/EdmAnnotationExtensions.cs @@ -9,7 +9,6 @@ using System.Linq; using Microsoft.OData.Edm; using Microsoft.OData.Edm.Vocabularies; -using Microsoft.OpenApi.Models; using Microsoft.OpenApi.OData.Common; using Microsoft.OpenApi.OData.Vocabulary; using Microsoft.OpenApi.OData.Vocabulary.Authorization; @@ -163,6 +162,28 @@ public static T GetRecord(this IEdmModel model, IEdmVocabularyAnnotatable tar }); } + /// + /// Gets the record value (a complex type) for the given target path. + /// + /// The CLR mapping type. + /// The Edm model. + /// The string representation of the Edm target path. + /// The Term qualified name. + /// + public static T GetRecord(this IEdmModel model, string targetPath, string qualifiedName) + where T : IRecord, new() + { + Utils.CheckArgumentNull(model, nameof(model)); + Utils.CheckArgumentNull(targetPath, nameof(targetPath)); + Utils.CheckArgumentNull(qualifiedName, nameof(qualifiedName)); + + IEdmTargetPath target = model.GetTargetPath(targetPath); + if (target == null) + return default; + + return model.GetRecord(target, qualifiedName); + } + /// /// Gets the collection of string term value for the given . /// @@ -265,12 +286,31 @@ public static IEnumerable GetCollection(this IEdmModel model, IEdmVocabula /// The Edm target. /// The link relation type for path operation. /// Null or the links record value (a complex type) for this annotation. - public static Link GetLinkRecord(this IEdmModel model, IEdmVocabularyAnnotatable target, string linkRel) + public static LinkType GetLinkRecord(this IEdmModel model, IEdmVocabularyAnnotatable target, string linkRel) { Utils.CheckArgumentNull(model, nameof(model)); Utils.CheckArgumentNull(target, nameof(target)); - return model.GetCollection(target, CoreConstants.Links)?.FirstOrDefault(x => x.Rel == linkRel); + return model.GetCollection(target, CoreConstants.Links)?.FirstOrDefault(x => x.Rel == linkRel); + } + + /// + /// Gets the links record value (a complex type) for the given target path. + /// + /// The Edm model. + /// The string representation of the Edm target path. + /// The link relation type for path operation. + /// Null or the links record value (a complex type) for this annotation. + public static LinkType GetLinkRecord(this IEdmModel model, string targetPath, string linkRel) + { + Utils.CheckArgumentNull(model, nameof(model)); + Utils.CheckArgumentNull(targetPath, nameof(targetPath)); + + IEdmTargetPath target = model.GetTargetPath(targetPath); + if (target == null) + return null; + + return model.GetLinkRecord(target, linkRel); } /// @@ -311,6 +351,18 @@ public static IEnumerable GetAuthorizations(this IEdmModel model, }); } + public static string GetDescriptionAnnotation(this IEdmModel model, string targetPath) + { + Utils.CheckArgumentNull(model, nameof(model)); + Utils.CheckArgumentNull(targetPath, nameof(targetPath)); + + IEdmTargetPath target = model.GetTargetPath(targetPath); + if (target == null) + return null; + + return model.GetDescriptionAnnotation(target); + } + private static T GetOrAddCached(this IEdmModel model, IEdmVocabularyAnnotatable target, string qualifiedName, Func createFunc) { if (model == null || target == null) diff --git a/src/Microsoft.OpenApi.OData.Reader/Generator/OpenApiParameterGenerator.cs b/src/Microsoft.OpenApi.OData.Reader/Generator/OpenApiParameterGenerator.cs index bb3d79c8..439dc631 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Generator/OpenApiParameterGenerator.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Generator/OpenApiParameterGenerator.cs @@ -372,6 +372,24 @@ public static OpenApiParameter CreateTop(this ODataContext context, IEdmVocabula return null; } + /// + /// Create the $top parameter for Edm target path. + /// + /// The OData context. + /// The string representation of the Edm target path. + /// + public static OpenApiParameter CreateTop(this ODataContext context, string targetPath) + { + Utils.CheckArgumentNull(context, nameof(context)); + Utils.CheckArgumentNull(targetPath, nameof(targetPath)); + + IEdmTargetPath target = context.Model.GetTargetPath(targetPath); + if (target == null) + return null; + + return context.CreateTop(target); + } + /// /// Create the $skip parameter. /// @@ -396,6 +414,24 @@ public static OpenApiParameter CreateSkip(this ODataContext context, IEdmVocabul return null; } + /// + /// Create the $skip parameter for Edm target path. + /// + /// The OData context. + /// The string representation of the Edm target path. + /// + public static OpenApiParameter CreateSkip(this ODataContext context, string targetPath) + { + Utils.CheckArgumentNull(context, nameof(context)); + Utils.CheckArgumentNull(targetPath, nameof(targetPath)); + + IEdmTargetPath target = context.Model.GetTargetPath(targetPath); + if (target == null) + return null; + + return context.CreateSkip(target); + } + /// /// Create the $search parameter. /// @@ -420,6 +456,24 @@ public static OpenApiParameter CreateSearch(this ODataContext context, IEdmVocab return null; } + /// + /// Create the $search parameter for Edm target path. + /// + /// The OData context. + /// The string representation of the Edm target path. + /// + public static OpenApiParameter CreateSearch(this ODataContext context, string targetPath) + { + Utils.CheckArgumentNull(context, nameof(context)); + Utils.CheckArgumentNull(targetPath, nameof(targetPath)); + + IEdmTargetPath target = context.Model.GetTargetPath(targetPath); + if (target == null) + return null; + + return context.CreateSearch(target); + } + /// /// Create the $count parameter. /// @@ -444,6 +498,24 @@ public static OpenApiParameter CreateCount(this ODataContext context, IEdmVocabu return null; } + /// + /// Create the $count parameter for Edm target path. + /// + /// The OData context. + /// The string representation of the Edm target path. + /// + public static OpenApiParameter CreateCount(this ODataContext context, string targetPath) + { + Utils.CheckArgumentNull(context, nameof(context)); + Utils.CheckArgumentNull(targetPath, nameof(targetPath)); + + IEdmTargetPath target = context.Model.GetTargetPath(targetPath); + if (target == null) + return null; + + return context.CreateCount(target); + } + /// /// Create the $filter parameter. /// @@ -468,6 +540,24 @@ public static OpenApiParameter CreateFilter(this ODataContext context, IEdmVocab return null; } + /// + /// Create the $filter parameter for Edm target path. + /// + /// The OData context. + /// The string representation of the Edm target path. + /// + public static OpenApiParameter CreateFilter(this ODataContext context, string targetPath) + { + Utils.CheckArgumentNull(context, nameof(context)); + Utils.CheckArgumentNull(targetPath, nameof(targetPath)); + + IEdmTargetPath target = context.Model.GetTargetPath(targetPath); + if (target == null) + return null; + + return context.CreateFilter(target); + } + public static OpenApiParameter CreateOrderBy(this ODataContext context, IEdmEntitySet entitySet) { Utils.CheckArgumentNull(context, nameof(context)); diff --git a/src/Microsoft.OpenApi.OData.Reader/Microsoft.OpenAPI.OData.Reader.csproj b/src/Microsoft.OpenApi.OData.Reader/Microsoft.OpenAPI.OData.Reader.csproj index ec63a242..892cd061 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Microsoft.OpenAPI.OData.Reader.csproj +++ b/src/Microsoft.OpenApi.OData.Reader/Microsoft.OpenAPI.OData.Reader.csproj @@ -15,14 +15,14 @@ netstandard2.0 Microsoft.OpenApi.OData true - 1.6.1 + 1.6.2 This package contains the codes you need to convert OData CSDL to Open API Document of Model. © Microsoft Corporation. All rights reserved. Microsoft OpenApi OData EDM https://github.com/Microsoft/OpenAPI.NET.OData -- Generates unique DELETE operation ids of $ref paths for indexed collection navigation properties #513 - + - Adds support for fetching annotations using Edm target path preferentially #514 + Microsoft.OpenApi.OData.Reader ..\..\tool\Microsoft.OpenApi.OData.snk ..\..\bin\Debug\ diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyBaseOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyBaseOperationHandler.cs index fe983e8b..426386b2 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyBaseOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyBaseOperationHandler.cs @@ -7,6 +7,7 @@ using Microsoft.OpenApi.Models; using Microsoft.OpenApi.OData.Common; using Microsoft.OpenApi.OData.Edm; +using Microsoft.OpenApi.OData.Vocabulary.Core; namespace Microsoft.OpenApi.OData.Operation; @@ -17,6 +18,7 @@ internal abstract class ComplexPropertyBaseOperationHandler : OperationHandler /// protected override void Initialize(ODataContext context, ODataPath path) { + base.Initialize(context, path); ComplexPropertySegment = path.LastSegment as ODataComplexPropertySegment ?? throw Error.ArgumentNull(nameof(path)); } @@ -40,4 +42,23 @@ protected override void SetTags(OpenApiOperation operation) base.SetTags(operation); } + + /// + protected override void SetExternalDocs(OpenApiOperation operation) + { + if (Context.Settings.ShowExternalDocs) + { + var externalDocs = Context.Model.GetLinkRecord(TargetPath, CustomLinkRel) ?? + Context.Model.GetLinkRecord(ComplexPropertySegment.Property, CustomLinkRel); + + if (externalDocs != null) + { + operation.ExternalDocs = new OpenApiExternalDocs() + { + Description = CoreConstants.ExternalDocsDescription, + Url = externalDocs.Href + }; + } + } + } } \ No newline at end of file diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyGetOperationHandler.cs index c05cefe7..00db6ab1 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyGetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyGetOperationHandler.cs @@ -26,7 +26,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _readRestrictions = Context.Model.GetRecord(ComplexPropertySegment.Property, CapabilitiesConstants.ReadRestrictions); + _readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); + var complexPropertyReadRestrictions = Context.Model.GetRecord(ComplexPropertySegment.Property, CapabilitiesConstants.ReadRestrictions); + + if (_readRestrictions == null) + { + _readRestrictions = complexPropertyReadRestrictions; + } + else + { + _readRestrictions.MergePropertiesIfNull(complexPropertyReadRestrictions); + } } /// @@ -54,41 +64,40 @@ protected override void SetParameters(OpenApiOperation operation) OpenApiParameter parameter; if(ComplexPropertySegment.Property.Type.IsCollection()) { - // The parameters array contains Parameter Objects for all system query options allowed for this collection, // and it does not list system query options not allowed for this collection, see terms // Capabilities.TopSupported, Capabilities.SkipSupported, Capabilities.SearchRestrictions, // Capabilities.FilterRestrictions, and Capabilities.CountRestrictions // $top - parameter = Context.CreateTop(ComplexPropertySegment.Property); + parameter = Context.CreateTop(TargetPath) ?? Context.CreateTop(ComplexPropertySegment.Property); if (parameter != null) { operation.Parameters.Add(parameter); } // $skip - parameter = Context.CreateSkip(ComplexPropertySegment.Property); + parameter = Context.CreateSkip(TargetPath) ?? Context.CreateSkip(ComplexPropertySegment.Property); if (parameter != null) { operation.Parameters.Add(parameter); } // $search - parameter = Context.CreateSearch(ComplexPropertySegment.Property); + parameter = Context.CreateSearch(TargetPath) ?? Context.CreateSearch(ComplexPropertySegment.Property); if (parameter != null) { operation.Parameters.Add(parameter); } // $filter - parameter = Context.CreateFilter(ComplexPropertySegment.Property); + parameter = Context.CreateFilter(TargetPath) ?? Context.CreateFilter(ComplexPropertySegment.Property); if (parameter != null) { operation.Parameters.Add(parameter); } // $count - parameter = Context.CreateCount(ComplexPropertySegment.Property); + parameter = Context.CreateCount(TargetPath) ?? Context.CreateCount(ComplexPropertySegment.Property); if (parameter != null) { operation.Parameters.Add(parameter); diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyPostOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyPostOperationHandler.cs index d685bfbb..4efb8d23 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyPostOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyPostOperationHandler.cs @@ -26,7 +26,17 @@ protected override void Initialize(ODataContext context, ODataPath path) throw new InvalidOperationException("OData conventions do not support POSTing to a complex property that is not a collection."); } - _insertRestrictions = Context.Model.GetRecord(ComplexPropertySegment.Property, CapabilitiesConstants.InsertRestrictions); + _insertRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.InsertRestrictions); + var complexPropertyInsertRestrictions = Context.Model.GetRecord(ComplexPropertySegment.Property, CapabilitiesConstants.InsertRestrictions); + + if (_insertRestrictions == null) + { + _insertRestrictions = complexPropertyInsertRestrictions; + } + else + { + _insertRestrictions.MergePropertiesIfNull(complexPropertyInsertRestrictions); + } } /// public override OperationType OperationType => OperationType.Post; diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyUpdateOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyUpdateOperationHandler.cs index 77420131..8830276d 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyUpdateOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/ComplexPropertyUpdateOperationHandler.cs @@ -23,7 +23,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _updateRestrictions = Context.Model.GetRecord(ComplexPropertySegment.Property, CapabilitiesConstants.UpdateRestrictions); + _updateRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.UpdateRestrictions); + var complexPropertyUpdateRestrictions = Context.Model.GetRecord(ComplexPropertySegment.Property, CapabilitiesConstants.UpdateRestrictions); + + if (_updateRestrictions == null) + { + _updateRestrictions = complexPropertyUpdateRestrictions; + } + else + { + _updateRestrictions.MergePropertiesIfNull(complexPropertyUpdateRestrictions); + } } /// diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/DollarCountGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/DollarCountGetOperationHandler.cs index a0953f07..1bf4551d 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/DollarCountGetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/DollarCountGetOperationHandler.cs @@ -179,13 +179,13 @@ protected override void SetParameters(OpenApiOperation operation) OpenApiParameter parameter; - parameter = Context.CreateSearch(annotatable); + parameter = Context.CreateSearch(TargetPath) ?? Context.CreateSearch(annotatable); if (parameter != null) { operation.Parameters.Add(parameter); } - parameter = Context.CreateFilter(annotatable); + parameter = Context.CreateFilter(TargetPath) ?? Context.CreateFilter(annotatable); if (parameter != null) { operation.Parameters.Add(parameter); @@ -199,8 +199,18 @@ protected override void AppendCustomParameters(OpenApiOperation operation) return; } - ReadRestrictionsType readRestrictions = Context.Model.GetRecord(annotatable, CapabilitiesConstants.ReadRestrictions); + ReadRestrictionsType readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); + ReadRestrictionsType annotatableReadRestrictions = Context.Model.GetRecord(annotatable, CapabilitiesConstants.ReadRestrictions); + if (readRestrictions == null) + { + readRestrictions = annotatableReadRestrictions; + } + else + { + readRestrictions.MergePropertiesIfNull(annotatableReadRestrictions); + } + if (readRestrictions == null) { return; diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EdmActionOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EdmActionOperationHandler.cs index 6998f0c1..204642de 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EdmActionOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EdmActionOperationHandler.cs @@ -26,8 +26,19 @@ protected override void SetBasicInfo(OpenApiOperation operation) { base.SetBasicInfo(operation); + InsertRestrictionsType insertRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.InsertRestrictions); + InsertRestrictionsType operationReadRestrictions = Context.Model.GetRecord(EdmOperation, CapabilitiesConstants.InsertRestrictions); + + if (insertRestrictions == null) + { + insertRestrictions = operationReadRestrictions; + } + else + { + insertRestrictions.MergePropertiesIfNull(operationReadRestrictions); + } + // Description - var insertRestrictions = Context.Model.GetRecord(EdmOperation, CapabilitiesConstants.InsertRestrictions); if (!string.IsNullOrWhiteSpace(insertRestrictions?.LongDescription)) { operation.Description = insertRestrictions.LongDescription; diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EdmFunctionOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EdmFunctionOperationHandler.cs index af2c0efa..85a8f3b1 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EdmFunctionOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EdmFunctionOperationHandler.cs @@ -30,8 +30,19 @@ protected override void SetBasicInfo(OpenApiOperation operation) { base.SetBasicInfo(operation); + ReadRestrictionsType readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); + ReadRestrictionsType operationReadRestrictions = Context.Model.GetRecord(EdmOperation, CapabilitiesConstants.ReadRestrictions); + + if (readRestrictions == null) + { + readRestrictions = operationReadRestrictions; + } + else + { + readRestrictions.MergePropertiesIfNull(operationReadRestrictions); + } + // Description - var readRestrictions = Context.Model.GetRecord(EdmOperation, CapabilitiesConstants.ReadRestrictions); if (!string.IsNullOrWhiteSpace(readRestrictions?.LongDescription)) { operation.Description = readRestrictions.LongDescription; diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EdmOperationImportOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EdmOperationImportOperationHandler.cs index afdc2f9e..91cee642 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EdmOperationImportOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EdmOperationImportOperationHandler.cs @@ -22,6 +22,8 @@ namespace Microsoft.OpenApi.OData.Operation /// internal abstract class EdmOperationImportOperationHandler : OperationHandler { + private OperationRestrictionsType _operationRestriction; + /// /// Gets the . /// @@ -39,6 +41,18 @@ protected override void Initialize(ODataContext context, ODataPath path) OperationImportSegment = path.LastSegment as ODataOperationImportSegment; EdmOperationImport = OperationImportSegment.OperationImport; + + _operationRestriction = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.OperationRestrictions); + var operationRestrictions = Context.Model.GetRecord(EdmOperationImport, CapabilitiesConstants.OperationRestrictions); + + if (_operationRestriction == null) + { + _operationRestriction = operationRestrictions; + } + else + { + _operationRestriction.MergePropertiesIfNull(operationRestrictions); + } } /// @@ -46,7 +60,7 @@ protected override void SetBasicInfo(OpenApiOperation operation) { operation.Summary = "Invoke " + (EdmOperationImport.IsActionImport() ? "actionImport " : "functionImport ") + EdmOperationImport.Name; - operation.Description = Context.Model.GetDescriptionAnnotation(EdmOperationImport); + operation.Description = Context.Model.GetDescriptionAnnotation(TargetPath) ?? Context.Model.GetDescriptionAnnotation(EdmOperationImport); if (Context.Settings.EnableOperationId) { @@ -85,32 +99,30 @@ protected override void SetResponses(OpenApiOperation operation) /// protected override void SetSecurity(OpenApiOperation operation) { - OperationRestrictionsType restriction = Context.Model.GetRecord(EdmOperationImport, CapabilitiesConstants.OperationRestrictions); - if (restriction == null || restriction.Permissions == null) + if (_operationRestriction == null || _operationRestriction.Permissions == null) { return; } - operation.Security = Context.CreateSecurityRequirements(restriction.Permissions).ToList(); + operation.Security = Context.CreateSecurityRequirements(_operationRestriction.Permissions).ToList(); } /// protected override void AppendCustomParameters(OpenApiOperation operation) { - OperationRestrictionsType restriction = Context.Model.GetRecord(EdmOperationImport, CapabilitiesConstants.OperationRestrictions); - if (restriction == null) + if (_operationRestriction == null) { return; } - if (restriction.CustomHeaders != null) + if (_operationRestriction.CustomHeaders != null) { - AppendCustomParameters(operation, restriction.CustomHeaders, ParameterLocation.Header); + AppendCustomParameters(operation, _operationRestriction.CustomHeaders, ParameterLocation.Header); } - if (restriction.CustomQueryOptions != null) + if (_operationRestriction.CustomQueryOptions != null) { - AppendCustomParameters(operation, restriction.CustomQueryOptions, ParameterLocation.Query); + AppendCustomParameters(operation, _operationRestriction.CustomQueryOptions, ParameterLocation.Query); } } @@ -151,19 +163,25 @@ private static IList CreateTags(IEdmOperationImport operationImport) internal static string PathAsString(IEnumerable path) { - return String.Join("/", path); + return string.Join("/", path); } /// protected override void SetExternalDocs(OpenApiOperation operation) { - if (Context.Settings.ShowExternalDocs && Context.Model.GetLinkRecord(EdmOperationImport, CustomLinkRel) is Link externalDocs) + if (Context.Settings.ShowExternalDocs) { - operation.ExternalDocs = new OpenApiExternalDocs() + var externalDocs = Context.Model.GetLinkRecord(TargetPath, CustomLinkRel) ?? + Context.Model.GetLinkRecord(EdmOperationImport, CustomLinkRel); + + if (externalDocs != null) { - Description = CoreConstants.ExternalDocsDescription, - Url = externalDocs.Href - }; + operation.ExternalDocs = new OpenApiExternalDocs() + { + Description = CoreConstants.ExternalDocsDescription, + Url = externalDocs.Href + }; + } } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EdmOperationOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EdmOperationOperationHandler.cs index daca7925..0db40d2c 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EdmOperationOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EdmOperationOperationHandler.cs @@ -21,6 +21,8 @@ namespace Microsoft.OpenApi.OData.Operation /// internal abstract class EdmOperationOperationHandler : OperationHandler { + private OperationRestrictionsType _operationRestriction; + /// /// Gets the navigation source. /// @@ -43,7 +45,9 @@ internal abstract class EdmOperationOperationHandler : OperationHandler /// protected override void Initialize(ODataContext context, ODataPath path) - { + { + base.Initialize(context, path); + // It's bound operation, the first segment must be the navigaiton source. ODataNavigationSourceSegment navigationSourceSegment = path.FirstSegment as ODataNavigationSourceSegment; NavigationSource = navigationSourceSegment.NavigationSource; @@ -53,7 +57,17 @@ protected override void Initialize(ODataContext context, ODataPath path) HasTypeCast = path.Segments.Any(s => s is ODataTypeCastSegment); - base.Initialize(context, path); + _operationRestriction = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.OperationRestrictions); + var operationRestrictions = Context.Model.GetRecord(EdmOperation, CapabilitiesConstants.OperationRestrictions); + + if (_operationRestriction == null) + { + _operationRestriction = operationRestrictions; + } + else + { + _operationRestriction.MergePropertiesIfNull(operationRestrictions); + } } /// @@ -63,7 +77,7 @@ protected override void SetBasicInfo(OpenApiOperation operation) operation.Summary = "Invoke " + (EdmOperation.IsAction() ? "action " : "function ") + EdmOperation.Name; // Description - operation.Description = Context.Model.GetDescriptionAnnotation(EdmOperation); + operation.Description = Context.Model.GetDescriptionAnnotation(TargetPath) ?? Context.Model.GetDescriptionAnnotation(EdmOperation); // OperationId if (Context.Settings.EnableOperationId) @@ -161,32 +175,30 @@ protected override void SetResponses(OpenApiOperation operation) /// protected override void SetSecurity(OpenApiOperation operation) { - OperationRestrictionsType restriction = Context.Model.GetRecord(EdmOperation, CapabilitiesConstants.OperationRestrictions); - if (restriction == null || restriction.Permissions == null) + if (_operationRestriction == null || _operationRestriction.Permissions == null) { return; } - operation.Security = Context.CreateSecurityRequirements(restriction.Permissions).ToList(); + operation.Security = Context.CreateSecurityRequirements(_operationRestriction.Permissions).ToList(); } /// protected override void AppendCustomParameters(OpenApiOperation operation) { - OperationRestrictionsType restriction = Context.Model.GetRecord(EdmOperation, CapabilitiesConstants.OperationRestrictions); - if (restriction == null) + if (_operationRestriction == null) { return; } - if (restriction.CustomHeaders != null) + if (_operationRestriction.CustomHeaders != null) { - AppendCustomParameters(operation, restriction.CustomHeaders, ParameterLocation.Header); + AppendCustomParameters(operation, _operationRestriction.CustomHeaders, ParameterLocation.Header); } - if (restriction.CustomQueryOptions != null) + if (_operationRestriction.CustomQueryOptions != null) { - AppendCustomParameters(operation, restriction.CustomQueryOptions, ParameterLocation.Query); + AppendCustomParameters(operation, _operationRestriction.CustomQueryOptions, ParameterLocation.Query); } } @@ -261,13 +273,19 @@ protected override void SetCustomLinkRelType() /// protected override void SetExternalDocs(OpenApiOperation operation) { - if (Context.Settings.ShowExternalDocs && Context.Model.GetLinkRecord(EdmOperation, CustomLinkRel) is Link externalDocs) + if (Context.Settings.ShowExternalDocs) { - operation.ExternalDocs = new OpenApiExternalDocs() - { - Description = CoreConstants.ExternalDocsDescription, - Url = externalDocs.Href - }; + var externalDocs = Context.Model.GetLinkRecord(TargetPath, CustomLinkRel) ?? + Context.Model.GetLinkRecord(EdmOperation, CustomLinkRel); + + if (externalDocs != null) + { + operation.ExternalDocs = new OpenApiExternalDocs() + { + Description = CoreConstants.ExternalDocsDescription, + Url = externalDocs.Href + }; + } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityDeleteOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityDeleteOperationHandler.cs index 1546f5a4..db909513 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityDeleteOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityDeleteOperationHandler.cs @@ -29,7 +29,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _deleteRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.DeleteRestrictions); + _deleteRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.DeleteRestrictions); + var entityDeleteRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.DeleteRestrictions); + + if (_deleteRestrictions == null) + { + _deleteRestrictions = entityDeleteRestrictions; + } + else + { + _deleteRestrictions.MergePropertiesIfNull(entityDeleteRestrictions); + } } /// diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityGetOperationHandler.cs index d172daa6..75af3544 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityGetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityGetOperationHandler.cs @@ -30,7 +30,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _readRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.ReadRestrictions); + _readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); + var entityReadRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.ReadRestrictions); + + if (_readRestrictions == null) + { + _readRestrictions = entityReadRestrictions; + } + else + { + _readRestrictions.MergePropertiesIfNull(entityReadRestrictions); + } } /// diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetGetOperationHandler.cs index b3a90e12..cb971654 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetGetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetGetOperationHandler.cs @@ -31,7 +31,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _readRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.ReadRestrictions); + _readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); + var entityReadRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.ReadRestrictions); + + if (_readRestrictions == null) + { + _readRestrictions = entityReadRestrictions; + } + else + { + _readRestrictions.MergePropertiesIfNull(entityReadRestrictions); + } } /// @@ -75,35 +85,35 @@ protected override void SetParameters(OpenApiOperation operation) // Capabilities.TopSupported, Capabilities.SkipSupported, Capabilities.SearchRestrictions, // Capabilities.FilterRestrictions, and Capabilities.CountRestrictions // $top - OpenApiParameter parameter = Context.CreateTop(EntitySet); + OpenApiParameter parameter = Context.CreateTop(TargetPath) ?? Context.CreateTop(EntitySet); if (parameter != null) { operation.Parameters.Add(parameter); } // $skip - parameter = Context.CreateSkip(EntitySet); + parameter = Context.CreateSkip(TargetPath) ?? Context.CreateSkip(EntitySet); if (parameter != null) { operation.Parameters.Add(parameter); } // $search - parameter = Context.CreateSearch(EntitySet); + parameter = Context.CreateSearch(TargetPath) ?? Context.CreateSearch(EntitySet); if (parameter != null) { operation.Parameters.Add(parameter); } // $filter - parameter = Context.CreateFilter(EntitySet); + parameter = Context.CreateFilter(TargetPath) ?? Context.CreateFilter(EntitySet); if (parameter != null) { operation.Parameters.Add(parameter); } // $count - parameter = Context.CreateCount(EntitySet); + parameter = Context.CreateCount(TargetPath) ?? Context.CreateCount(EntitySet); if (parameter != null) { operation.Parameters.Add(parameter); diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetOperationHandler.cs index bffd943a..898c83f8 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetOperationHandler.cs @@ -61,13 +61,19 @@ protected override void SetExtensions(OpenApiOperation operation) /// protected override void SetExternalDocs(OpenApiOperation operation) { - if (Context.Settings.ShowExternalDocs && Context.Model.GetLinkRecord(EntitySet, CustomLinkRel) is Link externalDocs) + if (Context.Settings.ShowExternalDocs) { - operation.ExternalDocs = new OpenApiExternalDocs() + var externalDocs = Context.Model.GetLinkRecord(TargetPath, CustomLinkRel) ?? + Context.Model.GetLinkRecord(EntitySet, CustomLinkRel); + + if (externalDocs != null) { - Description = CoreConstants.ExternalDocsDescription, - Url = externalDocs.Href - }; + operation.ExternalDocs = new OpenApiExternalDocs() + { + Description = CoreConstants.ExternalDocsDescription, + Url = externalDocs.Href + }; + } } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetPostOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetPostOperationHandler.cs index d41ad59e..28cb40d7 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetPostOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EntitySetPostOperationHandler.cs @@ -31,7 +31,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _insertRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.InsertRestrictions); + _insertRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.InsertRestrictions); + var entityInsertRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.InsertRestrictions); + + if (_insertRestrictions == null) + { + _insertRestrictions = entityInsertRestrictions; + } + else + { + _insertRestrictions.MergePropertiesIfNull(entityInsertRestrictions); + } } /// diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityUpdateOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityUpdateOperationHandler.cs index caf38eb3..fa30d859 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/EntityUpdateOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/EntityUpdateOperationHandler.cs @@ -25,7 +25,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _updateRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.UpdateRestrictions); + _updateRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.UpdateRestrictions); + var entityUpdateRestrictions = Context.Model.GetRecord(EntitySet, CapabilitiesConstants.UpdateRestrictions); + + if (_updateRestrictions == null) + { + _updateRestrictions = entityUpdateRestrictions; + } + else + { + _updateRestrictions.MergePropertiesIfNull(entityUpdateRestrictions); + } } /// diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityGetOperationHandler.cs index 5ed69903..990b08a3 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityGetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityGetOperationHandler.cs @@ -21,24 +21,33 @@ internal class MediaEntityGetOperationHandler : MediaEntityOperationalHandler { /// public override OperationType OperationType => OperationType.Get; - private IEdmProperty _property = null; private ReadRestrictionsType _readRestrictions = null; protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - (_, _property) = GetStreamElements(); - if (_property != null) + if (Property != null) { - if (_property is IEdmNavigationProperty) + _readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); + if (Property is IEdmNavigationProperty) { - _readRestrictions = Context.Model.GetRecord(_property, CapabilitiesConstants.NavigationRestrictions)? - .RestrictedProperties?.FirstOrDefault()?.ReadRestrictions; + var navigationReadRestrictions = Context.Model.GetRecord(Property, CapabilitiesConstants.NavigationRestrictions)? + .RestrictedProperties?.FirstOrDefault()?.ReadRestrictions; + if (_readRestrictions != null && navigationReadRestrictions != null) + { + _readRestrictions.MergePropertiesIfNull(navigationReadRestrictions); + } + _readRestrictions ??= navigationReadRestrictions; } else { - _readRestrictions = Context.Model.GetRecord(_property, CapabilitiesConstants.ReadRestrictions); + var propertyReadRestrictions = Context.Model.GetRecord(Property, CapabilitiesConstants.ReadRestrictions); + if (_readRestrictions != null && propertyReadRestrictions != null) + { + _readRestrictions.MergePropertiesIfNull(propertyReadRestrictions); + } + _readRestrictions ??= propertyReadRestrictions; } } } @@ -48,8 +57,9 @@ protected override void SetBasicInfo(OpenApiOperation operation) { // Summary string placeholderValue = LastSegmentIsStreamPropertySegment ? Path.LastSegment.Identifier : "media content"; - operation.Summary = IsNavigationPropertyPath - ? $"Get {placeholderValue} for the navigation property {NavigationProperty.Name} from {NavigationSource.Name}" + operation.Summary = _readRestrictions?.Description; + operation.Summary ??= IsNavigationPropertyPath + ? $"Get {placeholderValue} for the navigation property {NavigationProperty.Name} from {NavigationSourceSegment.NavigationSource.Name}" : $"Get {placeholderValue} for {NavigationSourceSegment.EntityType.Name} from {NavigationSourceSegment.Identifier}"; // Description @@ -57,17 +67,17 @@ protected override void SetBasicInfo(OpenApiOperation operation) { string description; - if (_property is IEdmNavigationProperty) + if (Property is IEdmNavigationProperty) { description = LastSegmentIsKeySegment - ? _readRestrictions?.ReadByKeyRestrictions?.Description - : _readRestrictions?.Description - ?? Context.Model.GetDescriptionAnnotation(_property); + ? _readRestrictions?.ReadByKeyRestrictions?.LongDescription + : _readRestrictions?.LongDescription + ?? Context.Model.GetDescriptionAnnotation(Property); } else - { - // Structural property - description = Context.Model.GetDescriptionAnnotation(_property); + { + // Structural property + description = _readRestrictions?.LongDescription ?? Context.Model.GetDescriptionAnnotation(Property); } operation.Description = description; diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityOperationalHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityOperationalHandler.cs index d3f257ac..68450ec2 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityOperationalHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityOperationalHandler.cs @@ -4,7 +4,6 @@ // ------------------------------------------------------------ using Microsoft.OData.Edm; -using Microsoft.OData.Edm.Vocabularies; using Microsoft.OpenApi.Any; using Microsoft.OpenApi.Models; using Microsoft.OpenApi.OData.Common; @@ -18,7 +17,7 @@ namespace Microsoft.OpenApi.OData.Operation /// /// Base class for operation of media entity. /// - internal abstract class MediaEntityOperationalHandler : NavigationPropertyOperationHandler + internal abstract class MediaEntityOperationalHandler : OperationHandler { /// /// Gets/Sets the NavigationSource segment @@ -32,6 +31,21 @@ internal abstract class MediaEntityOperationalHandler : NavigationPropertyOperat protected bool LastSegmentIsStreamPropertySegment { get; private set; } + /// + /// Gets a bool value indicating whether the last segment is a key segment. + /// + protected bool LastSegmentIsKeySegment { get; private set; } + + /// + /// Gets the media entity property. + /// + protected IEdmProperty Property { get; private set; } + + /// + /// Gets the navigation property. + /// + protected IEdmNavigationProperty NavigationProperty { get; private set; } + /// protected override void Initialize(ODataContext context, ODataPath path) { @@ -44,36 +58,37 @@ protected override void Initialize(ODataContext context, ODataPath path) LastSegmentIsStreamPropertySegment = Path.LastSegment.Kind == ODataSegmentKind.StreamProperty; + LastSegmentIsKeySegment = path.LastSegment is ODataKeySegment; + + (_, Property) = GetStreamElements(); + if (IsNavigationPropertyPath) { - // Initialize navigation property paths from base - base.Initialize(context, path); + NavigationProperty = path.OfType().Last().NavigationProperty; } + + base.Initialize(context, path); } /// protected override void SetTags(OpenApiOperation operation) { - if (IsNavigationPropertyPath) - { - base.SetTags(operation); - } - else - { - string tagIdentifier = NavigationSourceSegment.Identifier + "." + NavigationSourceSegment.EntityType.Name; - OpenApiTag tag = new() - { - Name = tagIdentifier - }; + string tagIdentifier = IsNavigationPropertyPath + ? EdmModelHelper.GenerateNavigationPropertyPathTagName(Path, Context) + : NavigationSourceSegment.Identifier + "." + NavigationSourceSegment.EntityType.Name; - // Use an extension for TOC (Table of Content) - tag.Extensions.Add(Constants.xMsTocType, new OpenApiString("page")); + OpenApiTag tag = new() + { + Name = tagIdentifier + }; - operation.Tags.Add(tag); + // Use an extension for TOC (Table of Content) + tag.Extensions.Add(Constants.xMsTocType, new OpenApiString("page")); - Context.AppendTag(tag); - } + operation.Tags.Add(tag); + + Context.AppendTag(tag); } /// @@ -207,16 +222,22 @@ private IEdmNavigationProperty GetNavigationProperty(IEdmEntityType entityType, return entityType.DeclaredNavigationProperties().FirstOrDefault(x => x.Name.Equals(identifier)); } + /// protected override void SetExternalDocs(OpenApiOperation operation) { - if (Context.Settings.ShowExternalDocs && IsNavigationPropertyPath && - Context.Model.GetLinkRecord(NavigationProperty, CustomLinkRel) is Link externalDocs) + if (Context.Settings.ShowExternalDocs && Property != null) { - operation.ExternalDocs = new OpenApiExternalDocs() + var externalDocs = Context.Model.GetLinkRecord(TargetPath, CustomLinkRel) ?? + Context.Model.GetLinkRecord(Property, CustomLinkRel); + + if (externalDocs != null) { - Description = CoreConstants.ExternalDocsDescription, - Url = externalDocs.Href - }; + operation.ExternalDocs = new OpenApiExternalDocs() + { + Description = CoreConstants.ExternalDocsDescription, + Url = externalDocs.Href + }; + } } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityPutOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityPutOperationHandler.cs index 850a786f..0a7e1ecb 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityPutOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/MediaEntityPutOperationHandler.cs @@ -22,26 +22,36 @@ internal class MediaEntityPutOperationHandler : MediaEntityOperationalHandler { /// public override OperationType OperationType => OperationType.Put; - private IEdmProperty _property = null; + private UpdateRestrictionsType _updateRestrictions = null; protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - (_, _property) = GetStreamElements(); - - if (_property != null) + + if (Property != null) { - if (_property is IEdmNavigationProperty) + _updateRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.UpdateRestrictions); + if (Property is IEdmNavigationProperty) { - _updateRestrictions = Context.Model.GetRecord(_property, CapabilitiesConstants.NavigationRestrictions)? - .RestrictedProperties?.FirstOrDefault()?.UpdateRestrictions; + var navigationUpdateRestrictions = Context.Model.GetRecord(Property, CapabilitiesConstants.NavigationRestrictions)? + .RestrictedProperties?.FirstOrDefault()?.UpdateRestrictions; + if (_updateRestrictions != null && navigationUpdateRestrictions != null) + { + _updateRestrictions.MergePropertiesIfNull(navigationUpdateRestrictions); + } + _updateRestrictions ??= navigationUpdateRestrictions; } else { - _updateRestrictions = Context.Model.GetRecord(_property, CapabilitiesConstants.UpdateRestrictions); - } - } + var propertyUpdateRestrictions = Context.Model.GetRecord(Property, CapabilitiesConstants.UpdateRestrictions); + if (_updateRestrictions != null && propertyUpdateRestrictions != null) + { + _updateRestrictions.MergePropertiesIfNull(propertyUpdateRestrictions); + } + _updateRestrictions ??= propertyUpdateRestrictions; + } + } } /// @@ -49,27 +59,15 @@ protected override void SetBasicInfo(OpenApiOperation operation) { // Summary string placeholderValue = LastSegmentIsStreamPropertySegment ? Path.LastSegment.Identifier : "media content"; - operation.Summary = IsNavigationPropertyPath - ? $"Update {placeholderValue} for the navigation property {NavigationProperty.Name} in {NavigationSource.Name}" + operation.Summary = _updateRestrictions?.Description; + operation.Summary ??= IsNavigationPropertyPath + ? $"Update {placeholderValue} for the navigation property {NavigationProperty.Name} in {NavigationSourceSegment.NavigationSource.Name}" : $"Update {placeholderValue} for {NavigationSourceSegment.EntityType.Name} in {NavigationSourceSegment.Identifier}"; // Description if (LastSegmentIsStreamPropertySegment) { - string description; - - if (_property is IEdmNavigationProperty) - { - - description = _updateRestrictions?.Description ?? Context.Model.GetDescriptionAnnotation(_property); - } - else - { - // Structural property - description = Context.Model.GetDescriptionAnnotation(_property); - } - - operation.Description = description; + operation.Description = _updateRestrictions?.LongDescription ?? Context.Model.GetDescriptionAnnotation(Property); } // OperationId diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyGetOperationHandler.cs index 3ae6fe4c..22e6cb03 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyGetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyGetOperationHandler.cs @@ -169,31 +169,31 @@ protected override void SetParameters(OpenApiOperation operation) { // Need to verify that TopSupported or others should be applied to navigation source. // So, how about for the navigation property. - OpenApiParameter parameter = Context.CreateTop(NavigationProperty); + OpenApiParameter parameter = Context.CreateTop(TargetPath) ?? Context.CreateTop(NavigationProperty); if (parameter != null) { operation.Parameters.Add(parameter); } - parameter = Context.CreateSkip(NavigationProperty); + parameter = Context.CreateSkip(TargetPath) ?? Context.CreateSkip(NavigationProperty); if (parameter != null) { operation.Parameters.Add(parameter); } - parameter = Context.CreateSearch(NavigationProperty); + parameter = Context.CreateSearch(TargetPath) ?? Context.CreateSearch(NavigationProperty); if (parameter != null) { operation.Parameters.Add(parameter); } - parameter = Context.CreateFilter(NavigationProperty); + parameter = Context.CreateFilter(TargetPath) ?? Context.CreateFilter(NavigationProperty); if (parameter != null) { operation.Parameters.Add(parameter); } - parameter = Context.CreateCount(NavigationProperty); + parameter = Context.CreateCount(TargetPath) ?? Context.CreateCount(NavigationProperty); if (parameter != null) { operation.Parameters.Add(parameter); diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyOperationHandler.cs index 8fe72945..d7eb990a 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/NavigationPropertyOperationHandler.cs @@ -3,8 +3,6 @@ // Licensed under the MIT License (MIT). See LICENSE in the repo root for license information. // ------------------------------------------------------------ -using System.Collections.Generic; -using System.Linq; using Microsoft.OData.Edm; using Microsoft.OpenApi.Any; using Microsoft.OpenApi.Models; @@ -13,6 +11,8 @@ using Microsoft.OpenApi.OData.Vocabulary; using Microsoft.OpenApi.OData.Vocabulary.Capabilities; using Microsoft.OpenApi.OData.Vocabulary.Core; +using System.Collections.Generic; +using System.Linq; namespace Microsoft.OpenApi.OData.Operation { @@ -113,36 +113,100 @@ internal string GetOperationId(string prefix = null) /// protected override void SetExternalDocs(OpenApiOperation operation) { - if (Context.Settings.ShowExternalDocs && Context.Model.GetLinkRecord(NavigationProperty, CustomLinkRel) is Link externalDocs) + if (Context.Settings.ShowExternalDocs) { - operation.ExternalDocs = new OpenApiExternalDocs() - { - Description = CoreConstants.ExternalDocsDescription, - Url = externalDocs.Href - }; + var externalDocs = Context.Model.GetLinkRecord(TargetPath, CustomLinkRel) ?? + Context.Model.GetLinkRecord(NavigationProperty, CustomLinkRel); + + if (externalDocs != null) + { + operation.ExternalDocs = new OpenApiExternalDocs() + { + Description = CoreConstants.ExternalDocsDescription, + Url = externalDocs.Href + }; + } } - } - + } + /// /// Retrieves the CRUD restrictions annotations for the navigation property /// in context, given a capability annotation term. /// /// The fully qualified restriction annotation term. /// The restriction annotation, or null if not available. - protected IRecord GetRestrictionAnnotation(string annotationTerm) - { - return annotationTerm switch - { - CapabilitiesConstants.ReadRestrictions => Restriction?.ReadRestrictions ?? - Context.Model.GetRecord(NavigationProperty, CapabilitiesConstants.ReadRestrictions), - CapabilitiesConstants.UpdateRestrictions => Restriction?.UpdateRestrictions ?? - Context.Model.GetRecord(NavigationProperty, CapabilitiesConstants.UpdateRestrictions), - CapabilitiesConstants.InsertRestrictions => Restriction?.InsertRestrictions ?? - Context.Model.GetRecord(NavigationProperty, CapabilitiesConstants.InsertRestrictions), - CapabilitiesConstants.DeleteRestrictions => Restriction?.DeleteRestrictions ?? - Context.Model.GetRecord(NavigationProperty, CapabilitiesConstants.DeleteRestrictions), - _ => null, - }; + protected IRecord GetRestrictionAnnotation(string annotationTerm) + { + switch (annotationTerm) + { + case CapabilitiesConstants.ReadRestrictions: + var readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); + if (readRestrictions != null && Restriction?.ReadRestrictions != null) + { + readRestrictions.MergePropertiesIfNull(Restriction.ReadRestrictions); + } + readRestrictions ??= Restriction?.ReadRestrictions; + + var navPropReadRestrictions = Context.Model.GetRecord(NavigationProperty, CapabilitiesConstants.ReadRestrictions); + if (readRestrictions != null && navPropReadRestrictions != null) + { + readRestrictions.MergePropertiesIfNull(navPropReadRestrictions); + } + readRestrictions ??= navPropReadRestrictions; + + return readRestrictions; + case CapabilitiesConstants.UpdateRestrictions: + var updateRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.UpdateRestrictions); + if (updateRestrictions != null && Restriction?.UpdateRestrictions != null) + { + updateRestrictions.MergePropertiesIfNull(Restriction.UpdateRestrictions); + } + updateRestrictions ??= Restriction?.UpdateRestrictions; + + var navPropUpdateRestrictions = Context.Model.GetRecord(NavigationProperty, CapabilitiesConstants.UpdateRestrictions); + if (updateRestrictions != null && navPropUpdateRestrictions != null) + { + updateRestrictions.MergePropertiesIfNull(navPropUpdateRestrictions); + } + updateRestrictions ??= navPropUpdateRestrictions; + + return updateRestrictions; + case CapabilitiesConstants.InsertRestrictions: + var insertRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.InsertRestrictions); + if (insertRestrictions != null && Restriction?.InsertRestrictions != null) + { + insertRestrictions.MergePropertiesIfNull(Restriction.InsertRestrictions); + } + insertRestrictions ??= Restriction?.InsertRestrictions; + + var navPropInsertRestrictions = Context.Model.GetRecord(NavigationProperty, CapabilitiesConstants.InsertRestrictions); + if (insertRestrictions != null && navPropInsertRestrictions != null) + { + insertRestrictions.MergePropertiesIfNull(navPropInsertRestrictions); + } + insertRestrictions ??= navPropInsertRestrictions; + + return insertRestrictions; + case CapabilitiesConstants.DeleteRestrictions: + var deleteRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.DeleteRestrictions); + if (deleteRestrictions != null && Restriction?.DeleteRestrictions != null) + { + deleteRestrictions.MergePropertiesIfNull(Restriction.DeleteRestrictions); + } + deleteRestrictions ??= Restriction?.DeleteRestrictions; + + var navPropDeleteRestrictions = Context.Model.GetRecord(NavigationProperty, CapabilitiesConstants.DeleteRestrictions); + if (deleteRestrictions != null && navPropDeleteRestrictions != null) + { + deleteRestrictions.MergePropertiesIfNull(navPropDeleteRestrictions); + } + deleteRestrictions ??= navPropDeleteRestrictions; + + return deleteRestrictions; + default: + return null; + + } } protected IDictionary GetContent(OpenApiSchema schema = null, IEnumerable mediaTypes = null) diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/ODataTypeCastGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/ODataTypeCastGetOperationHandler.cs index c99c4e78..1a236ae8 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/ODataTypeCastGetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/ODataTypeCastGetOperationHandler.cs @@ -14,6 +14,7 @@ using Microsoft.OpenApi.OData.Edm; using Microsoft.OpenApi.OData.Generator; using Microsoft.OpenApi.OData.Vocabulary.Capabilities; +using Microsoft.OpenApi.OData.Vocabulary.Core; namespace Microsoft.OpenApi.OData.Operation; @@ -168,14 +169,17 @@ private void SetRestrictionFromAnnotatable(IEdmVocabularyAnnotatable annotatable /// protected override void SetBasicInfo(OpenApiOperation operation) { - // Summary - if (IsSingleElement) - operation.Summary = $"Get the item of type {ParentSchemaElement.ShortQualifiedName()} as {TargetSchemaElement.ShortQualifiedName()}"; - else - operation.Summary = $"Get the items of type {TargetSchemaElement.ShortQualifiedName()} in the {ParentSchemaElement.ShortQualifiedName()} collection"; + ReadRestrictionsType _readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); - // OperationId - if (Context.Settings.EnableOperationId) + // Summary + string placeHolder = IsSingleElement + ? $"Get the item of type {ParentSchemaElement.ShortQualifiedName()} as {TargetSchemaElement.ShortQualifiedName()}" + : $"Get the items of type {TargetSchemaElement.ShortQualifiedName()} in the {ParentSchemaElement.ShortQualifiedName()} collection"; + operation.Summary = _readRestrictions?.Description ?? placeHolder; + operation.Description = _readRestrictions?.LongDescription; + + // OperationId + if (Context.Settings.EnableOperationId) operation.OperationId = EdmModelHelper.GenerateODataTypeCastPathOperationIdPrefix(Path) + $".As{Utils.UpperFirstChar(TargetSchemaElement.Name)}"; base.SetBasicInfo(operation); @@ -427,4 +431,16 @@ protected override void AppendCustomParameters(OpenApiOperation operation) AppendCustomParameters(operation, readRestrictions.CustomQueryOptions, ParameterLocation.Query); } } + + protected override void SetExternalDocs(OpenApiOperation operation) + { + if (Context.Settings.ShowExternalDocs && Context.Model.GetLinkRecord(TargetPath, CustomLinkRel) is LinkType externalDocs) + { + operation.ExternalDocs = new OpenApiExternalDocs() + { + Description = CoreConstants.ExternalDocsDescription, + Url = externalDocs.Href + }; + } + } } \ No newline at end of file diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/OperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/OperationHandler.cs index e508b706..d7224780 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/OperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/OperationHandler.cs @@ -3,9 +3,10 @@ // Licensed under the MIT License (MIT). See LICENSE in the repo root for license information. // ------------------------------------------------------------ -using System; using System.Collections.Generic; using System.Linq; +using Microsoft.OData.Edm; +using System.Text; using Microsoft.OpenApi.Any; using Microsoft.OpenApi.MicrosoftExtensions; using Microsoft.OpenApi.Models; @@ -33,6 +34,11 @@ internal abstract class OperationHandler : IOperationHandler /// protected IList PathParameters; + /// + /// The string representation of the Edm target path for annotations. + /// + protected string TargetPath; + /// public virtual OpenApiOperation CreateOperation(ODataContext context, ODataPath path) { @@ -122,6 +128,7 @@ private void SetDeprecation(OpenApiOperation operation) protected virtual void Initialize(ODataContext context, ODataPath path) { SetCustomLinkRelType(); + SetTargetPath(); } /// @@ -278,6 +285,7 @@ protected virtual void SetCustomLinkRelType() OperationType.Get => Path.LastSegment?.Kind == ODataSegmentKind.Key ? LinkRelKey.ReadByKey : LinkRelKey.List, OperationType.Post => LinkRelKey.Create, OperationType.Patch => LinkRelKey.Update, + OperationType.Put => LinkRelKey.Update, OperationType.Delete => LinkRelKey.Delete, _ => null, }; @@ -289,5 +297,22 @@ protected virtual void SetCustomLinkRelType() } } } + + /// + /// Set string representation of the Edm Target Path for annotations + /// + protected virtual void SetTargetPath() + { + var targetPath = new StringBuilder(Context.Model.EntityContainer.FullName()); + + bool skipLastSegment = Path.LastSegment is ODataRefSegment || Path.LastSegment is ODataDollarCountSegment; + foreach (var segment in Path.Segments.Where(segment => segment is not ODataKeySegment + && !(skipLastSegment && segment == Path.LastSegment))) + { + targetPath.Append($"/{segment.Identifier}"); + } + TargetPath = targetPath.ToString(); + } + } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonGetOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonGetOperationHandler.cs index 16f6b072..e235ac76 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonGetOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonGetOperationHandler.cs @@ -30,7 +30,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _readRestrictions = Context.Model.GetRecord(Singleton, CapabilitiesConstants.ReadRestrictions); + _readRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.ReadRestrictions); + var singletonReadRestrictions = Context.Model.GetRecord(Singleton, CapabilitiesConstants.ReadRestrictions); + + if (_readRestrictions == null) + { + _readRestrictions = singletonReadRestrictions; + } + else + { + _readRestrictions.MergePropertiesIfNull(singletonReadRestrictions); + } } /// diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonOperationHandler.cs index 393f77bc..39760948 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonOperationHandler.cs @@ -65,13 +65,19 @@ protected override void SetExtensions(OpenApiOperation operation) /// protected override void SetExternalDocs(OpenApiOperation operation) { - if (Context.Settings.ShowExternalDocs && Context.Model.GetLinkRecord(Singleton, CustomLinkRel) is Link externalDocs) + if (Context.Settings.ShowExternalDocs) { - operation.ExternalDocs = new OpenApiExternalDocs() - { - Description = CoreConstants.ExternalDocsDescription, - Url = externalDocs.Href - }; + var externalDocs = Context.Model.GetLinkRecord(TargetPath, CustomLinkRel) ?? + Context.Model.GetLinkRecord(Singleton, CustomLinkRel); + + if (externalDocs != null) + { + operation.ExternalDocs = new OpenApiExternalDocs() + { + Description = CoreConstants.ExternalDocsDescription, + Url = externalDocs.Href + }; + } } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonPatchOperationHandler.cs b/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonPatchOperationHandler.cs index 302bac34..dc74fec3 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonPatchOperationHandler.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Operation/SingletonPatchOperationHandler.cs @@ -30,7 +30,17 @@ protected override void Initialize(ODataContext context, ODataPath path) { base.Initialize(context, path); - _updateRestrictions = Context.Model.GetRecord(Singleton, CapabilitiesConstants.UpdateRestrictions); + _updateRestrictions = Context.Model.GetRecord(TargetPath, CapabilitiesConstants.UpdateRestrictions); + var singletonUpdateRestrictions = Context.Model.GetRecord(Singleton, CapabilitiesConstants.UpdateRestrictions); + + if (_updateRestrictions == null) + { + _updateRestrictions = singletonUpdateRestrictions; + } + else + { + _updateRestrictions.MergePropertiesIfNull(singletonUpdateRestrictions); + } } /// diff --git a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/DeleteRestrictionsType.cs b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/DeleteRestrictionsType.cs index 1d2ab381..9171681d 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/DeleteRestrictionsType.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/DeleteRestrictionsType.cs @@ -123,5 +123,35 @@ public void Initialize(IEdmRecordExpression record) // LongDescription LongDescription = record.GetString("LongDescription"); } + + /// + /// Merges properties of the specified object into this instance if they are null. + /// + /// The object containing properties to merge. + public void MergePropertiesIfNull(DeleteRestrictionsType source) + { + if (source == null) + return; + + Deletable ??= source.Deletable; + + NonDeletableNavigationProperties ??= source.NonDeletableNavigationProperties; + + MaxLevels ??= source.MaxLevels; + + FilterSegmentSupported ??= source.FilterSegmentSupported; + + TypecastSegmentSupported ??= source.TypecastSegmentSupported; + + Permissions ??= source.Permissions; + + CustomHeaders ??= source.CustomHeaders; + + CustomQueryOptions ??= source.CustomQueryOptions; + + Description ??= source.Description; + + LongDescription ??= source.LongDescription; + } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/InsertRestrictionsType.cs b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/InsertRestrictionsType.cs index 020f49f5..8652f7a7 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/InsertRestrictionsType.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/InsertRestrictionsType.cs @@ -146,5 +146,39 @@ public void Initialize(IEdmRecordExpression record) // ResponseContentTypes ResponseContentTypes = record.GetCollection("ResponseContentTypes"); } + + /// + /// Merges properties of the specified object into this instance if they are null. + /// + /// The object containing properties to merge. + public void MergePropertiesIfNull(InsertRestrictionsType source) + { + if (source == null) + return; + + Insertable ??= source.Insertable; + + NonInsertableNavigationProperties ??= source.NonInsertableNavigationProperties; + + MaxLevels ??= source.MaxLevels; + + TypecastSegmentSupported ??= source.TypecastSegmentSupported; + + Permissions ??= source.Permissions; + + QueryOptions ??= source.QueryOptions; + + CustomHeaders ??= source.CustomHeaders; + + CustomQueryOptions ??= source.CustomQueryOptions; + + Description ??= source.Description; + + LongDescription ??= source.LongDescription; + + RequestContentTypes ??= source.RequestContentTypes; + + ResponseContentTypes ??= source.ResponseContentTypes; + } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/OperationRestrictionsType.cs b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/OperationRestrictionsType.cs index 261cfb51..c5613d2e 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/OperationRestrictionsType.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/OperationRestrictionsType.cs @@ -37,7 +37,7 @@ internal class OperationRestrictionsType : IRecord public IList CustomQueryOptions { get; private set; } /// - /// Init the . + /// Init the . /// /// The input record. public void Initialize(IEdmRecordExpression record) @@ -56,5 +56,23 @@ public void Initialize(IEdmRecordExpression record) // CustomQueryOptions CustomQueryOptions = record.GetCollection("CustomQueryOptions"); } + + /// + /// Merges properties of the specified object into this instance if they are null. + /// + /// The object containing properties to merge. + public void MergePropertiesIfNull(OperationRestrictionsType source) + { + if (source == null) + return; + + FilterSegmentSupported ??= source.FilterSegmentSupported; + + Permissions ??= source.Permissions; + + CustomHeaders ??= source.CustomHeaders; + + CustomQueryOptions ??= source.CustomQueryOptions; + } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/ReadRestrictionsType.cs b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/ReadRestrictionsType.cs index f709e52b..7061b4b5 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/ReadRestrictionsType.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/ReadRestrictionsType.cs @@ -77,6 +77,29 @@ public virtual void Initialize(IEdmRecordExpression record) // LongDescription LongDescription = record.GetString("LongDescription"); } + + + /// + /// Merges properties of the specified object into this instance if they are null. + /// + /// The object containing properties to merge. + public void MergePropertiesIfNull(ReadRestrictionsBase source) + { + if (source == null) + return; + + Readable ??= source.Readable; + + Permissions ??= source.Permissions; + + CustomHeaders ??= source.CustomHeaders; + + CustomQueryOptions ??= source.CustomQueryOptions; + + Description ??= source.Description; + + LongDescription ??= source.LongDescription; + } } /// @@ -111,5 +134,19 @@ public override void Initialize(IEdmRecordExpression record) // ReadByKeyRestrictions ReadByKeyRestrictions = record.GetRecord("ReadByKeyRestrictions"); } + + /// + /// Merges properties of the specified object into this instance if they are null. + /// + /// The object containing properties to merge. + public void MergePropertiesIfNull(ReadRestrictionsType source) + { + base.MergePropertiesIfNull(source); + + if (source == null) + return; + + ReadByKeyRestrictions ??= source.ReadByKeyRestrictions; + } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/UpdateRestrictionsType.cs b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/UpdateRestrictionsType.cs index 753a012e..27e3e8f5 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/UpdateRestrictionsType.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Capabilities/UpdateRestrictionsType.cs @@ -195,6 +195,48 @@ public void Initialize(IEdmRecordExpression record) // ResponseContentTypes ResponseContentTypes = record.GetCollection("ResponseContentTypes"); + } + + /// + /// Merges properties of the specified object into this instance if they are null. + /// + /// The object containing properties to merge. + public void MergePropertiesIfNull(UpdateRestrictionsType source) + { + if (source == null) + return; + + Updatable ??= source.Updatable; + + Upsertable ??= source.Upsertable; + + DeltaUpdateSupported ??= source.DeltaUpdateSupported; + + UpdateMethod ??= source.UpdateMethod; + + FilterSegmentSupported ??= source.FilterSegmentSupported; + + TypecastSegmentSupported ??= source.TypecastSegmentSupported; + + NonUpdatableNavigationProperties ??= source.NonUpdatableNavigationProperties; + + MaxLevels ??= source.MaxLevels; + + Permissions ??= source.Permissions; + + QueryOptions ??= source.QueryOptions; + + CustomHeaders ??= source.CustomHeaders; + + CustomQueryOptions ??= source.CustomQueryOptions; + + Description ??= source.Description; + + LongDescription ??= source.LongDescription; + + RequestContentTypes ??= source.RequestContentTypes; + + ResponseContentTypes ??= source.ResponseContentTypes; } } } diff --git a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Core/Link.cs b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Core/LinkType.cs similarity index 93% rename from src/Microsoft.OpenApi.OData.Reader/Vocabulary/Core/Link.cs rename to src/Microsoft.OpenApi.OData.Reader/Vocabulary/Core/LinkType.cs index 211de695..cbec48e0 100644 --- a/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Core/Link.cs +++ b/src/Microsoft.OpenApi.OData.Reader/Vocabulary/Core/LinkType.cs @@ -14,7 +14,7 @@ namespace Microsoft.OpenApi.OData.Vocabulary.Core /// Complex Type: Org.OData.Core.V1.Link /// [Term("Org.OData.Core.V1.Links")] - internal class Link : IRecord + internal class LinkType : IRecord { /// /// The link relation type. @@ -27,7 +27,7 @@ internal class Link : IRecord public Uri Href { get; private set; } /// - /// Init the . + /// Init the . /// /// public virtual void Initialize(IEdmRecordExpression record) diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/ComplexPropertyGetOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/ComplexPropertyGetOperationHandlerTests.cs index 27fe7a9e..7a7b86b0 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/ComplexPropertyGetOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/ComplexPropertyGetOperationHandlerTests.cs @@ -6,6 +6,7 @@ using System.Linq; using Microsoft.OData.Edm; using Microsoft.OpenApi.OData.Edm; +using Microsoft.OpenApi.OData.Tests; using Xunit; namespace Microsoft.OpenApi.OData.Operation.Tests; @@ -100,4 +101,30 @@ public void CreateComplexPropertyGetOperationReturnsCorrectOperationForCollectio Assert.Null(get.OperationId); } } + + [Fact] + public void CreateComplexPropertyGetOperationWithTargetPathAnnotationsReturnsCorrectOperation() + { + // Arrange + IEdmModel model = EdmModelHelper.TripServiceModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet people = model.EntityContainer.FindEntitySet("People"); + Assert.NotNull(people); + + IEdmEntityType person = people.EntityType(); + IEdmProperty complexProperty = person.FindProperty("FavoriteFeature"); + ODataPath path = new (new ODataNavigationSourceSegment(people), new ODataKeySegment(person), new ODataComplexPropertySegment(complexProperty as IEdmStructuralProperty)); + + // Act + var operation = _operationHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation); + Assert.Equal("Get favourite feature", operation.Summary); + Assert.Equal("Get the favourite feature of a specific person", operation.Description); + + Assert.NotNull(operation.ExternalDocs); + Assert.Equal("Find more info here", operation.ExternalDocs.Description); + Assert.Equal("https://learn.microsoft.com/graph/api/person-favorite-feature?view=graph-rest-1.0", operation.ExternalDocs.Url.ToString()); + } } \ No newline at end of file diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/DollarCountGetOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/DollarCountGetOperationHandlerTests.cs index 083ba4a5..141cf2df 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/DollarCountGetOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/DollarCountGetOperationHandlerTests.cs @@ -69,6 +69,38 @@ public void CreateDollarCountGetOperationForNavigationPropertyReturnsCorrectOper } } + [Fact] + public void CreateDollarCountGetOperationForNavigationPropertyWithTargetPathAnnotationsReturnsCorrectOperation() + { + // Arrange + IEdmModel model = EdmModelHelper.GraphBetaModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet users = model.EntityContainer.FindEntitySet("users"); + Assert.NotNull(users); + + IEdmEntityType user = model.SchemaElements.OfType().First(c => c.Name == "user"); + IEdmNavigationProperty navProperty = user.DeclaredNavigationProperties().First(c => c.Name == "appRoleAssignments"); + ODataPath path = new(new ODataNavigationSourceSegment(users), + new ODataKeySegment(users.EntityType()), + new ODataNavigationPropertySegment(navProperty), + new ODataDollarCountSegment()); + + // Act + var operation = _operationHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation.Parameters); + Assert.Equal(4, operation.Parameters.Count); + Assert.Equal(new[] { "id", "ConsistencyLevel", "search", "filter" }, + operation.Parameters.Select(x => x.Name ?? x.Reference.Id).ToList()); + + Assert.Equal("Get the number of the resource", operation.Summary); + + Assert.Null(operation.RequestBody); + + Assert.Equal(2, operation.Responses.Count); + } + [Theory] [InlineData(true, true)] [InlineData(false, true)] @@ -115,5 +147,32 @@ public void CreateDollarCountGetOperationForNavigationSourceReturnsCorrectOperat Assert.Null(operation.OperationId); } } + + [Fact] + public void CreateDollarCountGetOperationForNavigationSourceWithTargetPathAnnotationsReturnsCorrectOperation() + { + // Arrange + IEdmModel model = EdmModelHelper.GraphBetaModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet users = model.EntityContainer.FindEntitySet("users"); + Assert.NotNull(users); + + ODataPath path = new(new ODataNavigationSourceSegment(users), + new ODataDollarCountSegment()); + + // Act + var operation = _operationHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation); + Assert.Equal("Get the number of the resource", operation.Summary); + Assert.NotNull(operation.Parameters); + Assert.Equal(3, operation.Parameters.Count); + Assert.Equal(new[] { "ConsistencyLevel", "search", "filter" }, + operation.Parameters.Select(x => x.Name ?? x.Reference.Id).ToList()); + + Assert.Null(operation.RequestBody); + Assert.Equal(2, operation.Responses.Count); + } } } diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/MediaEntityGetOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/MediaEntityGetOperationHandlerTests.cs index a647c71d..790d601b 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/MediaEntityGetOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/MediaEntityGetOperationHandlerTests.cs @@ -7,7 +7,6 @@ using Microsoft.OData.Edm.Csdl; using Microsoft.OpenApi.OData.Common; using Microsoft.OpenApi.OData.Edm; -using Microsoft.OpenApi.OData.Vocabulary.Core; using System.Linq; using System.Xml.Linq; using Xunit; @@ -185,5 +184,33 @@ public static IEdmModel GetEdmModel(string annotation) Assert.True(result); return model; } + + [Fact] + public void CreateMediaEntityPropertyGetOperationWithTargetPathAnnotationsReturnsCorrectOperation() + { + // Arrange + IEdmModel model = OData.Tests.EdmModelHelper.TripServiceModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet people = model.EntityContainer.FindEntitySet("People"); + Assert.NotNull(people); + + IEdmEntityType person = people.EntityType(); + IEdmStructuralProperty property = person.StructuralProperties().First(c => c.Name == "Photo"); + ODataPath path = new (new ODataNavigationSourceSegment(people), + new ODataKeySegment(person), + new ODataStreamPropertySegment(property.Name)); + + // Act + var operation = _operationalHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation); + Assert.Equal("Get photo", operation.Summary); + Assert.Equal("Get photo of a specific user", operation.Description); + + Assert.NotNull(operation.ExternalDocs); + Assert.Equal("Find more info here", operation.ExternalDocs.Description); + Assert.Equal("https://learn.microsoft.com/graph/api/person-get-photo?view=graph-rest-1.0", operation.ExternalDocs.Url.ToString()); + } } } diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/MediaEntityPutOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/MediaEntityPutOperationHandlerTests.cs index fd267e92..5b68eceb 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/MediaEntityPutOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/MediaEntityPutOperationHandlerTests.cs @@ -159,5 +159,33 @@ private void VerifyMediaEntityPutOperation(string annotation, bool enableOperati Assert.Null(putOperation2.OperationId); } } + + [Fact] + public void CreateMediaEntityPropertyPutOperationWithTargetPathAnnotationsReturnsCorrectOperation() + { + // Arrange + IEdmModel model = OData.Tests.EdmModelHelper.TripServiceModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet people = model.EntityContainer.FindEntitySet("People"); + Assert.NotNull(people); + + IEdmEntityType person = people.EntityType(); + IEdmStructuralProperty property = person.StructuralProperties().First(c => c.Name == "Photo"); + ODataPath path = new(new ODataNavigationSourceSegment(people), + new ODataKeySegment(person), + new ODataStreamPropertySegment(property.Name)); + + // Act + var operation = _operationalHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation); + Assert.Equal("Update photo", operation.Summary); + Assert.Equal("Update photo of a specific user", operation.Description); + + Assert.NotNull(operation.ExternalDocs); + Assert.Equal("Find more info here", operation.ExternalDocs.Description); + Assert.Equal("https://learn.microsoft.com/graph/api/person-update-photo?view=graph-rest-1.0", operation.ExternalDocs.Url.ToString()); + } } } diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyDeleteOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyDeleteOperationHandlerTests.cs index 2aaf04c7..3c97d8a1 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyDeleteOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyDeleteOperationHandlerTests.cs @@ -65,5 +65,31 @@ public void CreateNavigationDeleteOperationReturnsCorrectOperation(bool enableOp Assert.Null(operation.OperationId); } } + + [Fact] + public void CreateNavigationDeleteOperationWithTargetPathAnnotationsReturnsCorrectOperation() + { + // Arrange + IEdmModel model = EdmModelHelper.TripServiceModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet people = model.EntityContainer.FindEntitySet("People"); + Assert.NotNull(people); + + IEdmEntityType person = model.SchemaElements.OfType().First(c => c.Name == "Person"); + IEdmNavigationProperty navProperty = person.DeclaredNavigationProperties().First(c => c.Name == "Friends"); + ODataPath path = new(new ODataNavigationSourceSegment(people), new ODataKeySegment(people.EntityType()), new ODataNavigationPropertySegment(navProperty)); + + // Act + var operation = _operationHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation); + Assert.Equal("Delete a friend.", operation.Summary); + Assert.Equal("Delete an instance of a friend relationship.", operation.Description); + + Assert.NotNull(operation.ExternalDocs); + Assert.Equal("Find more info here", operation.ExternalDocs.Description); + Assert.Equal("https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0", operation.ExternalDocs.Url.ToString()); + } } } diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyGetOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyGetOperationHandlerTests.cs index 57f565eb..5e6c401d 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyGetOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyGetOperationHandlerTests.cs @@ -70,6 +70,36 @@ public void CreateNavigationGetOperationReturnsCorrectOperation(bool enableOpera } } + [Fact] + public void CreateNavigationGetOperationWithTargetPathAnnotationsAndNavigationPropertyAnnotationsReturnsCorrectOperation() + { + // Arrange + IEdmModel model = EdmModelHelper.TripServiceModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet people = model.EntityContainer.FindEntitySet("People"); + Assert.NotNull(people); + + IEdmEntityType person = model.SchemaElements.OfType().First(c => c.Name == "Person"); + IEdmNavigationProperty navProperty = person.DeclaredNavigationProperties().First(c => c.Name == "Friends"); + ODataPath path = new(new ODataNavigationSourceSegment(people), new ODataKeySegment(people.EntityType()), new ODataNavigationPropertySegment(navProperty)); + + // Act + var operation = _operationHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation); + Assert.Equal("List friends", operation.Summary); + Assert.Equal("List the friends of a specific person", operation.Description); + + Assert.NotNull(operation.ExternalDocs); + Assert.Equal("Find more info here", operation.ExternalDocs.Description); + Assert.Equal("https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0", operation.ExternalDocs.Url.ToString()); + + Assert.NotNull(operation.Parameters); + Assert.Equal(10, operation.Parameters.Count); + Assert.Contains(operation.Parameters, x => x.Name == "ConsistencyLevel"); + } + [Fact] public void CreateNavigationGetOperationViaComposableFunctionReturnsCorrectOperation() { diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyPostOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyPostOperationHandlerTests.cs index 28b3fb39..baba8625 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyPostOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/NavigationPropertyPostOperationHandlerTests.cs @@ -70,6 +70,32 @@ public void CreateNavigationPostOperationReturnsCorrectOperation(bool enableOper } } + [Fact] + public void CreateNavigationPostOperationWithTargetPathAnnotationsReturnsCorrectOperation() + { + // Arrange + IEdmModel model = EdmModelHelper.TripServiceModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet people = model.EntityContainer.FindEntitySet("People"); + Assert.NotNull(people); + + IEdmEntityType person = model.SchemaElements.OfType().First(c => c.Name == "Person"); + IEdmNavigationProperty navProperty = person.DeclaredNavigationProperties().First(c => c.Name == "Friends"); + ODataPath path = new(new ODataNavigationSourceSegment(people), new ODataKeySegment(people.EntityType()), new ODataNavigationPropertySegment(navProperty)); + + // Act + var operation = _operationHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation); + Assert.Equal("Create a friend.", operation.Summary); + Assert.Equal("Create a new friend.", operation.Description); + + Assert.NotNull(operation.ExternalDocs); + Assert.Equal("Find more info here", operation.ExternalDocs.Description); + Assert.Equal("https://learn.microsoft.com/graph/api/person-post-friend?view=graph-rest-1.0", operation.ExternalDocs.Url.ToString()); + } + [Fact] public void CreateNavigationPostOperationReturnsCorrectOperationWithAnnotatedRequestBodyContent() { diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/ODataTypeCastGetOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/ODataTypeCastGetOperationHandlerTests.cs index 3fcac1ee..cf5f392d 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/ODataTypeCastGetOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/ODataTypeCastGetOperationHandlerTests.cs @@ -54,7 +54,7 @@ public void CreateODataTypeCastGetOperationReturnsCorrectOperationForCollectionN Assert.Single(tag.Extensions); Assert.NotNull(operation.Parameters); - Assert.Equal(9, operation.Parameters.Count); + Assert.Equal(10, operation.Parameters.Count); Assert.Null(operation.RequestBody); if(enablePagination) @@ -113,7 +113,7 @@ public void CreateODataTypeCastGetOperationReturnsCorrectOperationForCollectionN Assert.Empty(tag.Extensions); Assert.NotNull(operation.Parameters); - Assert.Equal(4, operation.Parameters.Count); //select, expand, id, id + Assert.Equal(5, operation.Parameters.Count); //select, expand, id, id, ConsistencyLevel Assert.Null(operation.RequestBody); if(enablePagination) @@ -350,4 +350,34 @@ public void CreateODataTypeCastGetOperationReturnsCorrectOperationForSingleton(b } Assert.False(operation.Responses["200"].Content["application/json"].Schema.Properties.ContainsKey("value")); } + [Fact] + public void CreateODataTypeCastGetOperationReturnsCorrectOperationForSingleNavigationPropertyWithTargetPathAnnotations() + {// .../People/{id}/BestFriend/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager + // Arrange + IEdmModel model = EdmModelHelper.TripServiceModel; + ODataContext context = new(model, new OpenApiConvertSettings()); + IEdmEntitySet people = model.EntityContainer.FindEntitySet("People"); + Assert.NotNull(people); + + IEdmEntityType person = model.SchemaElements.OfType().First(c => c.Name == "Person"); + IEdmEntityType manager = model.SchemaElements.OfType().First(c => c.Name == "Manager"); + IEdmNavigationProperty navProperty = person.DeclaredNavigationProperties().First(c => c.Name == "BestFriend"); + ODataPath path = new(new ODataNavigationSourceSegment(people), + new ODataKeySegment(people.EntityType()), + new ODataNavigationPropertySegment(navProperty), + new ODataTypeCastSegment(manager, model)); + + // Act + var operation = _operationHandler.CreateOperation(context, path); + + // Assert + Assert.NotNull(operation); + Assert.Equal("Get best friend", operation.Summary); + Assert.Equal("Get the item of type Person cast as Manager", operation.Description); + + Assert.NotNull(operation.ExternalDocs); + Assert.Equal("Find more info here", operation.ExternalDocs.Description); + Assert.Equal("https://learn.microsoft.com/graph/api/person-get-friend-manager?view=graph-rest-1.0", operation.ExternalDocs.Url.ToString()); + + } } diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/RefDeleteOperationHandlerTests.cs b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/RefDeleteOperationHandlerTests.cs index 68f3df8d..7221e62b 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/RefDeleteOperationHandlerTests.cs +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Operation/RefDeleteOperationHandlerTests.cs @@ -50,6 +50,7 @@ public void CreateNavigationRefDeleteOperationReturnsCorrectOperation(bool enabl Assert.NotNull(operation.Parameters); Assert.NotEmpty(operation.Parameters); + Assert.Equal(3, operation.Parameters.Count); Assert.Null(operation.RequestBody); diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OData.xml b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OData.xml index 6ec22e9c..e6337a35 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OData.xml +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OData.xml @@ -1,462 +1,620 @@ - - - - - - - - - - - - - - - - - - - - - Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation - - - - - - - - - - - - - - - - - - - - - - Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation - - - - - - - - - - - - - - - - - - - - - - - - Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee - Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager - - - - - - - - - - - - - Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee - Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager - - - - - - - - - Org.OData.Core.V1.RevisionKind/Deprecated - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Org.OData.Capabilities.V1.HttpMethod/PUT - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Org.OData.Core.V1.RevisionKind/Deprecated - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee - Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager - - - - - - - - - Org.OData.Core.V1.RevisionKind/Deprecated - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation + + + + + + + + + + + + + + + + + + + + + + Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation + + + + + + + + + + + + + + + + + + + + + + + + + Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee + Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee + Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager + + + + + + + + + Org.OData.Core.V1.RevisionKind/Deprecated + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Org.OData.Capabilities.V1.HttpMethod/PUT + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Org.OData.Core.V1.RevisionKind/Deprecated + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee + Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager + + + - - - - - - - - - - - + + + + Org.OData.Core.V1.RevisionKind/Deprecated + + - - - - - - - - Name - - - - - - Org.OData.Capabilities.V1.HttpMethod/PUT - - - - - - - - - - - - Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee - Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager - - - - - - - - - Org.OData.Core.V1.RevisionKind/Deprecated - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + + + + + + Name + + + + + + Org.OData.Capabilities.V1.HttpMethod/PUT + + + + + + + + + + + + Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee + Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager + + + + + + + + + Org.OData.Core.V1.RevisionKind/Deprecated + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + \ No newline at end of file diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.V2.json b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.V2.json index 2a035d85..f343152b 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.V2.json +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.V2.json @@ -1087,6 +1087,79 @@ }, "x-description": "Casts the previous resource to EventLocation." }, + "/Airports/{IcaoCode}/Location/EmergencyAuthority/Photo": { + "get": { + "tags": [ + "Airports.Person" + ], + "summary": "Get Photo for the navigation property EmergencyAuthority from Airports", + "operationId": "Airports.GetEmergencyAuthorityPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "IcaoCode", + "description": "The unique identifier of Airport", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Airport" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + } + }, + "put": { + "tags": [ + "Airports.Person" + ], + "summary": "Update Photo for the navigation property EmergencyAuthority in Airports", + "operationId": "Airports.UpdateEmergencyAuthorityPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "IcaoCode", + "description": "The unique identifier of Airport", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Airport" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + } + }, + "x-description": "Provides operations to manage the media for the Airport entity." + }, "/Airports/$count": { "get": { "tags": [ @@ -1183,7 +1256,8 @@ "tags": [ "Me.Person" ], - "summary": "Get Me", + "summary": "Get signed in person", + "description": "Retrieve the properties and relationships of Person object.", "operationId": "Me.Person.GetPerson", "produces": [ "application/json" @@ -2158,14 +2232,96 @@ }, "x-description": "Casts the previous resource to Manager." }, + "/Me/BestFriend/Photo": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from Me", + "operationId": "Me.GetBestFriendPhoto", + "produces": [ + "application/octet-stream" + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in Me", + "operationId": "Me.UpdateBestFriendPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/Me/Friends": { "get": { "tags": [ "Me.Person" ], "summary": "Get Friends from Me", + "description": "Friends of person", "operationId": "Me.ListFriends", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -2725,6 +2881,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -2784,6 +2952,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -2824,6 +3004,93 @@ }, "x-description": "Casts the previous resource to Manager." }, + "/Me/Friends/{UserName}/Photo": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property Friends from Me", + "operationId": "Me.GetFriendsPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property Friends in Me", + "operationId": "Me.UpdateFriendsPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/Me/Friends/$count": { "get": { "tags": [ @@ -2832,6 +3099,18 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount-182b", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -2863,8 +3142,21 @@ "Me.Person" ], "summary": "Get ref of Friends from Me", + "description": "Friends of person", "operationId": "Me.ListRefFriends", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -2984,14 +3276,26 @@ "operationId": "Me.ListFriends.AsEmployee", "parameters": [ { - "$ref": "#/parameters/top" - }, - { - "$ref": "#/parameters/skip" - }, - { - "$ref": "#/parameters/search" - }, + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/parameters/top" + }, + { + "$ref": "#/parameters/skip" + }, + { + "$ref": "#/parameters/search" + }, { "$ref": "#/parameters/filter" }, @@ -3052,6 +3356,18 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount.AsEmployee-884b", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -3085,6 +3401,18 @@ "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection", "operationId": "Me.ListFriends.AsManager", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -3154,6 +3482,18 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount.AsManager-9376", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -3506,6 +3846,18 @@ "summary": "Get the number of the resource", "operationId": "Me.AsEmployee.AddressInfo.GetCount-8488", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -3561,6 +3913,18 @@ "summary": "Get the number of the resource", "operationId": "Me.AddressInfo.GetCount.AsEventLocation-9375", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -3939,6 +4303,18 @@ "summary": "Get the number of the resource", "operationId": "Me.AsEmployee.BestFriend.AddressInfo.GetCount-81de", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -3994,6 +4370,18 @@ "summary": "Get the number of the resource", "operationId": "Me.BestFriend.AddressInfo.GetCount.AsEventLocation-842c", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -4181,14 +4569,96 @@ }, "x-description": "Casts the previous resource to Manager." }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/BestFriend/Photo": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from Me", + "operationId": "Me.GetBestFriendPhoto", + "produces": [ + "application/octet-stream" + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in Me", + "operationId": "Me.UpdateBestFriendPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends": { "get": { "tags": [ "Me.Person" ], "summary": "Get Friends from Me", + "description": "Friends of person", "operationId": "Me.AsEmployee.ListFriends", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -4494,6 +4964,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -4567,6 +5049,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -4748,6 +5242,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -4788,24 +5294,33 @@ }, "x-description": "Casts the previous resource to Manager." }, - "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$count": { + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName}/Photo": { "get": { "tags": [ "Me.Person" ], - "summary": "Get the number of the resource", - "operationId": "Me.AsEmployee.Friends.GetCount-0cb7", + "summary": "Get Photo for the navigation property Friends from Me", + "operationId": "Me.GetFriendsPhoto", + "produces": [ + "application/octet-stream" + ], "parameters": [ { - "$ref": "#/parameters/search" - }, - { - "$ref": "#/parameters/filter" + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" } ], "responses": { "200": { - "$ref": "#/responses/ODataCountResponse" + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } }, "default": { "$ref": "#/responses/error" @@ -4819,45 +5334,148 @@ "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." } }, - "x-description": "Provides operations to count the resources in the collection." - }, - "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$ref": { - "get": { + "put": { "tags": [ "Me.Person" ], - "summary": "Get ref of Friends from Me", - "operationId": "Me.AsEmployee.ListRefFriends", + "summary": "Update Photo for the navigation property Friends in Me", + "operationId": "Me.UpdateFriendsPhoto", + "consumes": [ + "application/octet-stream" + ], "parameters": [ { - "$ref": "#/parameters/top" - }, - { - "$ref": "#/parameters/skip" - }, - { - "$ref": "#/parameters/search" - }, - { - "$ref": "#/parameters/filter" - }, - { - "$ref": "#/parameters/count" + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" }, { - "in": "query", - "name": "$orderby", - "description": "Order items by property values", - "type": "array", - "items": { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", "type": "string" } } ], "responses": { - "200": { - "$ref": "#/responses/StringCollectionResponse" - }, + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$count": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get the number of the resource", + "operationId": "Me.AsEmployee.Friends.GetCount-0cb7", + "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/parameters/search" + }, + { + "$ref": "#/parameters/filter" + } + ], + "responses": { + "200": { + "$ref": "#/responses/ODataCountResponse" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to count the resources in the collection." + }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$ref": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get ref of Friends from Me", + "description": "Friends of person", + "operationId": "Me.AsEmployee.ListRefFriends", + "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/parameters/top" + }, + { + "$ref": "#/parameters/skip" + }, + { + "$ref": "#/parameters/search" + }, + { + "$ref": "#/parameters/filter" + }, + { + "$ref": "#/parameters/count" + }, + { + "in": "query", + "name": "$orderby", + "description": "Order items by property values", + "type": "array", + "items": { + "type": "string" + } + } + ], + "responses": { + "200": { + "$ref": "#/responses/StringCollectionResponse" + }, "default": { "$ref": "#/responses/error" } @@ -4947,6 +5565,18 @@ "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection", "operationId": "Me.ListFriends.AsManager", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -5016,6 +5646,18 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount.AsManager-85ff", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -5461,6 +6103,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -5534,6 +6188,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -5696,6 +6362,93 @@ }, "x-description": "Casts the previous resource to EventLocation." }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName}/Photo": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property Peers from Me", + "operationId": "Me.GetPeersPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property Peers in Me", + "operationId": "Me.UpdatePeersPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/$count": { "get": { "tags": [ @@ -5854,6 +6607,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.ListTrips", "parameters": [ { @@ -5934,6 +6691,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.CreateTrips", "consumes": [ "application/json" @@ -5985,6 +6746,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.GetTrips", "produces": [ "application/json" @@ -6046,6 +6811,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.UpdateTrips", "consumes": [ "application/json" @@ -6095,6 +6864,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.DeleteTrips", "parameters": [ { @@ -7692,28 +8465,97 @@ }, "x-description": "Casts the previous resource to Employee." }, - "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports": { + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Photo": { "get": { "tags": [ "Me.Person" ], - "summary": "Get DirectReports from Me", - "operationId": "Me.AsManager.ListDirectReports", - "parameters": [ - { - "$ref": "#/parameters/top" - }, - { - "$ref": "#/parameters/skip" - }, - { - "$ref": "#/parameters/search" - }, - { - "$ref": "#/parameters/filter" + "summary": "Get Photo for the navigation property BestFriend from Me", + "operationId": "Me.GetBestFriendPhoto", + "produces": [ + "application/octet-stream" + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } }, - { - "$ref": "#/parameters/count" + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in Me", + "operationId": "Me.UpdateBestFriendPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get DirectReports from Me", + "operationId": "Me.AsManager.ListDirectReports", + "parameters": [ + { + "$ref": "#/parameters/top" + }, + { + "$ref": "#/parameters/skip" + }, + { + "$ref": "#/parameters/search" + }, + { + "$ref": "#/parameters/filter" + }, + { + "$ref": "#/parameters/count" }, { "in": "query", @@ -8260,6 +9102,93 @@ }, "x-description": "Casts the previous resource to EventLocation." }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/{UserName}/Photo": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property DirectReports from Me", + "operationId": "Me.GetDirectReportsPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property DirectReports in Me", + "operationId": "Me.UpdateDirectReportsPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/$count": { "get": { "tags": [ @@ -8417,8 +9346,21 @@ "Me.Person" ], "summary": "Get Friends from Me", + "description": "Friends of person", "operationId": "Me.AsManager.ListFriends", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -8978,6 +9920,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -9018,24 +9972,33 @@ }, "x-description": "Casts the previous resource to Employee." }, - "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count": { + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/{UserName}/Photo": { "get": { "tags": [ "Me.Person" ], - "summary": "Get the number of the resource", - "operationId": "Me.AsManager.Friends.GetCount-60a7", + "summary": "Get Photo for the navigation property Friends from Me", + "operationId": "Me.GetFriendsPhoto", + "produces": [ + "application/octet-stream" + ], "parameters": [ { - "$ref": "#/parameters/search" - }, - { - "$ref": "#/parameters/filter" + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" } ], "responses": { "200": { - "$ref": "#/responses/ODataCountResponse" + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } }, "default": { "$ref": "#/responses/error" @@ -9049,44 +10012,38 @@ "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." } }, - "x-description": "Provides operations to count the resources in the collection." - }, - "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$ref": { - "get": { + "put": { "tags": [ "Me.Person" ], - "summary": "Get ref of Friends from Me", - "operationId": "Me.AsManager.ListRefFriends", + "summary": "Update Photo for the navigation property Friends in Me", + "operationId": "Me.UpdateFriendsPhoto", + "consumes": [ + "application/octet-stream" + ], "parameters": [ { - "$ref": "#/parameters/top" - }, - { - "$ref": "#/parameters/skip" - }, - { - "$ref": "#/parameters/search" - }, - { - "$ref": "#/parameters/filter" - }, - { - "$ref": "#/parameters/count" + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" }, { - "in": "query", - "name": "$orderby", - "description": "Order items by property values", - "type": "array", - "items": { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", "type": "string" } } ], "responses": { - "200": { - "$ref": "#/responses/StringCollectionResponse" + "204": { + "description": "Success" }, "default": { "$ref": "#/responses/error" @@ -9098,23 +10055,40 @@ "date": "2021-08-24T00:00:00.0000000+00:00", "version": "2021-05/me", "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." - }, - "x-ms-docs-operation-type": "operation" + } }, - "post": { + "x-description": "Provides operations to manage the media for the Person entity." + }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count": { + "get": { "tags": [ "Me.Person" ], - "summary": "Create new navigation property ref to Friends for Me", - "operationId": "Me.AsManager.CreateRefFriends", + "summary": "Get the number of the resource", + "operationId": "Me.AsManager.Friends.GetCount-60a7", "parameters": [ { - "$ref": "#/parameters/refPostBody" + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/parameters/search" + }, + { + "$ref": "#/parameters/filter" } ], "responses": { - "204": { - "description": "Success" + "200": { + "$ref": "#/responses/ODataCountResponse" }, "default": { "$ref": "#/responses/error" @@ -9126,7 +10100,99 @@ "date": "2021-08-24T00:00:00.0000000+00:00", "version": "2021-05/me", "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." - }, + } + }, + "x-description": "Provides operations to count the resources in the collection." + }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$ref": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get ref of Friends from Me", + "description": "Friends of person", + "operationId": "Me.AsManager.ListRefFriends", + "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/parameters/top" + }, + { + "$ref": "#/parameters/skip" + }, + { + "$ref": "#/parameters/search" + }, + { + "$ref": "#/parameters/filter" + }, + { + "$ref": "#/parameters/count" + }, + { + "in": "query", + "name": "$orderby", + "description": "Order items by property values", + "type": "array", + "items": { + "type": "string" + } + } + ], + "responses": { + "200": { + "$ref": "#/responses/StringCollectionResponse" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + }, + "x-ms-docs-operation-type": "operation" + }, + "post": { + "tags": [ + "Me.Person" + ], + "summary": "Create new navigation property ref to Friends for Me", + "operationId": "Me.AsManager.CreateRefFriends", + "parameters": [ + { + "$ref": "#/parameters/refPostBody" + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + }, "x-ms-docs-operation-type": "operation" }, "delete": { @@ -9177,6 +10243,18 @@ "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection", "operationId": "Me.ListFriends.AsEmployee", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -9246,6 +10324,18 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount.AsEmployee-6a35", "parameters": [ + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -9435,6 +10525,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.ListTrips", "parameters": [ { @@ -9515,6 +10609,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.CreateTrips", "consumes": [ "application/json" @@ -9566,6 +10664,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.GetTrips", "produces": [ "application/json" @@ -9627,6 +10729,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.UpdateTrips", "consumes": [ "application/json" @@ -9676,6 +10782,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.DeleteTrips", "parameters": [ { @@ -10267,6 +11377,75 @@ }, "x-description": "Provides operations to call the UpdatePersonLastName method." }, + "/Me/Photo": { + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for Person from Me", + "operationId": "Me.Person.GetPhoto", + "produces": [ + "application/octet-stream" + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for Person in Me", + "operationId": "Me.Person.UpdatePhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/Me/Trips": { "get": { "tags": [ @@ -10274,6 +11453,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "Me.ListTrips", "parameters": [ { @@ -10354,6 +11537,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "Me.CreateTrips", "consumes": [ "application/json" @@ -10405,6 +11592,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "Me.GetTrips", "produces": [ "application/json" @@ -10466,6 +11657,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "Me.UpdateTrips", "consumes": [ "application/json" @@ -10515,6 +11710,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "Me.DeleteTrips", "parameters": [ { @@ -12337,13 +13536,16 @@ }, "x-description": "Casts the previous resource to Manager." }, - "/NewComePeople/{UserName}/Friends": { + "/NewComePeople/{UserName}/BestFriend/Photo": { "get": { "tags": [ "NewComePeople.Person" ], - "summary": "Get Friends from NewComePeople", - "operationId": "NewComePeople.ListFriends", + "summary": "Get Photo for the navigation property BestFriend from NewComePeople", + "operationId": "NewComePeople.GetBestFriendPhoto", + "produces": [ + "application/octet-stream" + ], "parameters": [ { "in": "path", @@ -12352,69 +13554,37 @@ "required": true, "type": "string", "x-ms-docs-key-type": "Person" - }, - { - "$ref": "#/parameters/top" - }, - { - "$ref": "#/parameters/skip" - }, - { - "$ref": "#/parameters/search" - }, - { - "$ref": "#/parameters/filter" - }, - { - "$ref": "#/parameters/count" - }, - { - "in": "query", - "name": "$orderby", - "description": "Order items by property values", - "type": "array", - "items": { - "type": "string" - } - }, - { - "in": "query", - "name": "$select", - "description": "Select properties to be returned", - "type": "array", - "items": { - "type": "string" - } - }, - { - "in": "query", - "name": "$expand", - "description": "Expand related entities", - "type": "array", - "items": { - "type": "string" - } } ], "responses": { "200": { - "$ref": "#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonCollectionResponse" + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } }, "default": { "$ref": "#/responses/error" } }, - "x-ms-docs-operation-type": "operation" + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/bestfriend", + "description": "The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API." + } }, - "x-description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity." - }, - "/NewComePeople/{UserName}/Friends/{UserName1}/$ref": { - "delete": { + "put": { "tags": [ "NewComePeople.Person" ], - "summary": "Delete ref of navigation property Friends for NewComePeople", - "operationId": "NewComePeople.friends.DeleteRefPerson", + "summary": "Update Photo for the navigation property BestFriend in NewComePeople", + "operationId": "NewComePeople.UpdateBestFriendPhoto", + "consumes": [ + "application/octet-stream" + ], "parameters": [ { "in": "path", @@ -12425,13 +13595,142 @@ "x-ms-docs-key-type": "Person" }, { - "in": "path", - "name": "UserName1", - "description": "The unique identifier of Person", + "in": "body", + "name": "body", + "description": "New media content.", "required": true, - "type": "string", - "x-ms-docs-key-type": "Person" - }, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/bestfriend", + "description": "The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, + "/NewComePeople/{UserName}/Friends": { + "get": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Get Friends from NewComePeople", + "description": "Friends of person", + "operationId": "NewComePeople.ListFriends", + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/parameters/top" + }, + { + "$ref": "#/parameters/skip" + }, + { + "$ref": "#/parameters/search" + }, + { + "$ref": "#/parameters/filter" + }, + { + "$ref": "#/parameters/count" + }, + { + "in": "query", + "name": "$orderby", + "description": "Order items by property values", + "type": "array", + "items": { + "type": "string" + } + }, + { + "in": "query", + "name": "$select", + "description": "Select properties to be returned", + "type": "array", + "items": { + "type": "string" + } + }, + { + "in": "query", + "name": "$expand", + "description": "Expand related entities", + "type": "array", + "items": { + "type": "string" + } + } + ], + "responses": { + "200": { + "$ref": "#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonCollectionResponse" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "x-ms-docs-operation-type": "operation" + }, + "x-description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity." + }, + "/NewComePeople/{UserName}/Friends/{UserName1}/$ref": { + "delete": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Delete ref of navigation property Friends for NewComePeople", + "operationId": "NewComePeople.friends.DeleteRefPerson", + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, { "in": "header", "name": "If-Match", @@ -12943,6 +14242,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -13003,6 +14314,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -13036,6 +14359,95 @@ }, "x-description": "Casts the previous resource to Manager." }, + "/NewComePeople/{UserName}/Friends/{UserName1}/Photo": { + "get": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Get Photo for the navigation property Friends from NewComePeople", + "operationId": "NewComePeople.GetFriendsPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + } + }, + "put": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Update Photo for the navigation property Friends in NewComePeople", + "operationId": "NewComePeople.UpdateFriendsPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/NewComePeople/{UserName}/Friends/$count": { "get": { "tags": [ @@ -13052,6 +14464,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -13076,6 +14500,7 @@ "NewComePeople.Person" ], "summary": "Get ref of Friends from NewComePeople", + "description": "Friends of person", "operationId": "NewComePeople.ListRefFriends", "parameters": [ { @@ -13086,6 +14511,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -13207,6 +14644,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -13277,6 +14726,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -13311,6 +14772,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -13381,6 +14854,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -13777,6 +15262,79 @@ }, "x-description": "Provides operations to call the UpdatePersonLastName method." }, + "/NewComePeople/{UserName}/Photo": { + "get": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Get Photo for Person from NewComePeople", + "operationId": "NewComePeople.Person.GetPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + } + }, + "put": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Update Photo for Person in NewComePeople", + "operationId": "NewComePeople.Person.UpdatePhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/NewComePeople/{UserName}/Trips": { "get": { "tags": [ @@ -13784,6 +15342,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.ListTrips", "parameters": [ { @@ -13865,6 +15427,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.CreateTrips", "consumes": [ "application/json" @@ -13913,6 +15479,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.GetTrips", "produces": [ "application/json" @@ -13975,6 +15545,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.UpdateTrips", "consumes": [ "application/json" @@ -14025,6 +15599,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.DeleteTrips", "parameters": [ { @@ -15849,9 +17427,115 @@ ], "responses": { "200": { - "description": "Result entities", + "description": "Result entities", + "schema": { + "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Casts the previous resource to Employee." + }, + "/People/{UserName}/BestFriend/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get best friend", + "description": "Get the item of type Person cast as Manager", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-get-friend-manager?view=graph-rest-1.0" + }, + "operationId": "People.GetBestFriend.AsManager", + "produces": [ + "application/json" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "query", + "name": "$select", + "description": "Select properties to be returned", + "type": "array", + "items": { + "type": "string" + } + }, + { + "in": "query", + "name": "$expand", + "description": "Expand related entities", + "type": "array", + "items": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Result entities", + "schema": { + "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Casts the previous resource to Manager." + }, + "/People/{UserName}/BestFriend/Photo": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from People", + "operationId": "People.GetBestFriendPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", "schema": { - "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee" + "format": "binary", + "type": "string" } }, "default": { @@ -15866,17 +17550,14 @@ "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } }, - "x-description": "Casts the previous resource to Employee." - }, - "/People/{UserName}/BestFriend/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager": { - "get": { + "put": { "tags": [ "People.Person" ], - "summary": "Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager", - "operationId": "People.GetBestFriend.AsManager", - "produces": [ - "application/json" + "summary": "Update Photo for the navigation property BestFriend in People", + "operationId": "People.UpdateBestFriendPhoto", + "consumes": [ + "application/octet-stream" ], "parameters": [ { @@ -15888,30 +17569,19 @@ "x-ms-docs-key-type": "Person" }, { - "in": "query", - "name": "$select", - "description": "Select properties to be returned", - "type": "array", - "items": { - "type": "string" - } - }, - { - "in": "query", - "name": "$expand", - "description": "Expand related entities", - "type": "array", - "items": { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", "type": "string" } } ], "responses": { - "200": { - "description": "Result entities", - "schema": { - "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager" - } + "204": { + "description": "Success" }, "default": { "$ref": "#/responses/error" @@ -15925,14 +17595,19 @@ "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } }, - "x-description": "Casts the previous resource to Manager." + "x-description": "Provides operations to manage the media for the Person entity." }, "/People/{UserName}/Friends": { "get": { "tags": [ "People.Person" ], - "summary": "Get Friends from People", + "summary": "List friends", + "description": "List the friends of a specific person", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0" + }, "operationId": "People.ListFriends", "parameters": [ { @@ -15943,6 +17618,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -16014,7 +17701,12 @@ "tags": [ "People.Person" ], - "summary": "Delete ref of navigation property Friends for People", + "summary": "Delete a friend.", + "description": "Delete an instance of a friend relationship.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0" + }, "operationId": "People.friends.DeleteRefPerson", "parameters": [ { @@ -16590,6 +18282,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -16657,6 +18361,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -16697,6 +18413,109 @@ }, "x-description": "Casts the previous resource to Manager." }, + "/People/{UserName}/Friends/{UserName1}/Photo": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property Friends from People", + "operationId": "People.GetFriendsPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property Friends in People", + "operationId": "People.UpdateFriendsPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/People/{UserName}/Friends/$count": { "get": { "tags": [ @@ -16713,6 +18532,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -16743,7 +18574,12 @@ "tags": [ "People.Person" ], - "summary": "Get ref of Friends from People", + "summary": "List friends", + "description": "List the friends of a specific person", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0" + }, "operationId": "People.ListRefFriends", "parameters": [ { @@ -16754,6 +18590,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -16800,7 +18648,12 @@ "tags": [ "People.Person" ], - "summary": "Create new navigation property ref to Friends for People", + "summary": "Create a friend.", + "description": "Create a new friend.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-post-friend?view=graph-rest-1.0" + }, "operationId": "People.CreateRefFriends", "parameters": [ { @@ -16836,7 +18689,12 @@ "tags": [ "People.Person" ], - "summary": "Delete ref of navigation property Friends for People", + "summary": "Delete a friend.", + "description": "Delete an instance of a friend relationship.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0" + }, "operationId": "People.DeleteRefFriends", "parameters": [ { @@ -16896,6 +18754,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -16973,6 +18843,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -17014,6 +18896,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -17091,6 +18985,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -17121,7 +19027,8 @@ "tags": [ "People.Location" ], - "summary": "Get HomeAddress property value", + "summary": "Get home address", + "description": "Get the home address of a specific person", "operationId": "People.GetHomeAddress", "produces": [ "application/json" @@ -17521,6 +19428,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -17594,6 +19513,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -18046,6 +19977,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -18119,6 +20062,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -18340,12 +20295,100 @@ }, "x-description": "Casts the previous resource to Manager." }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/BestFriend/Photo": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from People", + "operationId": "People.GetBestFriendPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in People", + "operationId": "People.UpdateBestFriendPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends": { "get": { "tags": [ "People.Person" ], "summary": "Get Friends from People", + "description": "Friends of person", "operationId": "People.AsEmployee.ListFriends", "parameters": [ { @@ -18356,6 +20399,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -18701,6 +20756,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -18790,6 +20857,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -18907,18 +20986,139 @@ "x-ms-docs-key-type": "Person" }, { - "in": "body", - "name": "body", - "description": "New property values", - "required": true, - "schema": { - "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" + "in": "body", + "name": "body", + "description": "New property values", + "required": true, + "schema": { + "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation": { + "get": { + "tags": [ + "People.Person.Location" + ], + "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection", + "operationId": "People.Friends.GetHomeAddress.AsEventLocation", + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Casts the previous resource to EventLocation." + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager", + "operationId": "People.GetFriends.AsManager", + "produces": [ + "application/json" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "in": "query", + "name": "$select", + "description": "Select properties to be returned", + "type": "array", + "items": { + "type": "string" + } + }, + { + "in": "query", + "name": "$expand", + "description": "Expand related entities", + "type": "array", + "items": { + "type": "string" } } ], "responses": { - "204": { - "description": "Success" + "200": { + "description": "Result entities", + "schema": { + "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager" + } }, "default": { "$ref": "#/responses/error" @@ -18931,15 +21131,19 @@ "version": "2021-05/people", "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } - } + }, + "x-description": "Casts the previous resource to Manager." }, - "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation": { + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/Photo": { "get": { "tags": [ - "People.Person.Location" + "People.Person" + ], + "summary": "Get Photo for the navigation property Friends from People", + "operationId": "People.GetFriendsPhoto", + "produces": [ + "application/octet-stream" ], - "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection", - "operationId": "People.Friends.GetHomeAddress.AsEventLocation", "parameters": [ { "in": "path", @@ -18960,7 +21164,11 @@ ], "responses": { "200": { - "$ref": "#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } }, "default": { "$ref": "#/responses/error" @@ -18974,17 +21182,14 @@ "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } }, - "x-description": "Casts the previous resource to EventLocation." - }, - "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager": { - "get": { + "put": { "tags": [ "People.Person" ], - "summary": "Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager", - "operationId": "People.GetFriends.AsManager", - "produces": [ - "application/json" + "summary": "Update Photo for the navigation property Friends in People", + "operationId": "People.UpdateFriendsPhoto", + "consumes": [ + "application/octet-stream" ], "parameters": [ { @@ -19004,30 +21209,19 @@ "x-ms-docs-key-type": "Person" }, { - "in": "query", - "name": "$select", - "description": "Select properties to be returned", - "type": "array", - "items": { - "type": "string" - } - }, - { - "in": "query", - "name": "$expand", - "description": "Expand related entities", - "type": "array", - "items": { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", "type": "string" } } ], "responses": { - "200": { - "description": "Result entities", - "schema": { - "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager" - } + "204": { + "description": "Success" }, "default": { "$ref": "#/responses/error" @@ -19041,7 +21235,7 @@ "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } }, - "x-description": "Casts the previous resource to Manager." + "x-description": "Provides operations to manage the media for the Person entity." }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$count": { "get": { @@ -19059,6 +21253,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -19090,6 +21296,7 @@ "People.Person" ], "summary": "Get ref of Friends from People", + "description": "Friends of person", "operationId": "People.AsEmployee.ListRefFriends", "parameters": [ { @@ -19100,6 +21307,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -19242,6 +21461,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -19319,6 +21550,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -19838,6 +22081,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -19927,6 +22182,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -19952,16 +22219,131 @@ }, "x-description": "Provides operations to count the resources in the collection." }, - "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/HomeAddress": { + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/HomeAddress": { + "get": { + "tags": [ + "People.Person.Location" + ], + "summary": "Get HomeAddress property value", + "operationId": "People.AsEmployee.Peers.GetHomeAddress", + "produces": [ + "application/json" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "query", + "name": "$select", + "description": "Select properties to be returned", + "type": "array", + "items": { + "type": "string" + } + }, + { + "in": "query", + "name": "$expand", + "description": "Expand related entities", + "type": "array", + "items": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Result entities", + "schema": { + "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "patch": { + "tags": [ + "People.Person.Location" + ], + "summary": "Update property HomeAddress value.", + "operationId": "People.AsEmployee.Peers.UpdateHomeAddress", + "consumes": [ + "application/json" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New property values", + "required": true, + "schema": { + "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation": { "get": { "tags": [ "People.Person.Location" ], - "summary": "Get HomeAddress property value", - "operationId": "People.AsEmployee.Peers.GetHomeAddress", - "produces": [ - "application/json" - ], + "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection", + "operationId": "People.Peers.GetHomeAddress.AsEventLocation", "parameters": [ { "in": "path", @@ -19978,32 +22360,11 @@ "required": true, "type": "string", "x-ms-docs-key-type": "Person" - }, - { - "in": "query", - "name": "$select", - "description": "Select properties to be returned", - "type": "array", - "items": { - "type": "string" - } - }, - { - "in": "query", - "name": "$expand", - "description": "Expand related entities", - "type": "array", - "items": { - "type": "string" - } } ], "responses": { "200": { - "description": "Result entities", - "schema": { - "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" - } + "$ref": "#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" }, "default": { "$ref": "#/responses/error" @@ -20017,14 +22378,17 @@ "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } }, - "patch": { + "x-description": "Casts the previous resource to EventLocation." + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/Photo": { + "get": { "tags": [ - "People.Person.Location" + "People.Person" ], - "summary": "Update property HomeAddress value.", - "operationId": "People.AsEmployee.Peers.UpdateHomeAddress", - "consumes": [ - "application/json" + "summary": "Get Photo for the navigation property Peers from People", + "operationId": "People.GetPeersPhoto", + "produces": [ + "application/octet-stream" ], "parameters": [ { @@ -20042,20 +22406,15 @@ "required": true, "type": "string", "x-ms-docs-key-type": "Person" - }, - { - "in": "body", - "name": "body", - "description": "New property values", - "required": true, - "schema": { - "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" - } } ], "responses": { - "204": { - "description": "Success" + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } }, "default": { "$ref": "#/responses/error" @@ -20068,15 +22427,16 @@ "version": "2021-05/people", "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } - } - }, - "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation": { - "get": { + }, + "put": { "tags": [ - "People.Person.Location" + "People.Person" + ], + "summary": "Update Photo for the navigation property Peers in People", + "operationId": "People.UpdatePeersPhoto", + "consumes": [ + "application/octet-stream" ], - "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection", - "operationId": "People.Peers.GetHomeAddress.AsEventLocation", "parameters": [ { "in": "path", @@ -20093,11 +22453,21 @@ "required": true, "type": "string", "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } } ], "responses": { - "200": { - "$ref": "#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" + "204": { + "description": "Success" }, "default": { "$ref": "#/responses/error" @@ -20111,7 +22481,7 @@ "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } }, - "x-description": "Casts the previous resource to EventLocation." + "x-description": "Provides operations to manage the media for the Person entity." }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/$count": { "get": { @@ -20303,6 +22673,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.ListTrips", "parameters": [ { @@ -20391,6 +22765,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.CreateTrips", "consumes": [ "application/json" @@ -20450,6 +22828,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.GetTrips", "produces": [ "application/json" @@ -20519,6 +22901,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.UpdateTrips", "consumes": [ "application/json" @@ -20576,6 +22962,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.DeleteTrips", "parameters": [ { @@ -22467,6 +24857,93 @@ }, "x-description": "Casts the previous resource to Employee." }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Photo": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from People", + "operationId": "People.GetBestFriendPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in People", + "operationId": "People.UpdateBestFriendPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports": { "get": { "tags": [ @@ -23101,13 +25578,116 @@ "name": "UserName1", "description": "The unique identifier of Person", "required": true, - "type": "string", - "x-ms-docs-key-type": "Person" + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "$ref": "#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Casts the previous resource to EventLocation." + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/{UserName1}/Photo": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property DirectReports from People", + "operationId": "People.GetDirectReportsPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property DirectReports in People", + "operationId": "People.UpdateDirectReportsPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } } ], "responses": { - "200": { - "$ref": "#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" + "204": { + "description": "Success" }, "default": { "$ref": "#/responses/error" @@ -23121,7 +25701,7 @@ "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } }, - "x-description": "Casts the previous resource to EventLocation." + "x-description": "Provides operations to manage the media for the Person entity." }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/$count": { "get": { @@ -23312,6 +25892,7 @@ "People.Person" ], "summary": "Get Friends from People", + "description": "Friends of person", "operationId": "People.AsManager.ListFriends", "parameters": [ { @@ -23322,6 +25903,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -23969,6 +26562,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "in": "query", "name": "$select", @@ -24009,6 +26614,109 @@ }, "x-description": "Casts the previous resource to Employee." }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/{UserName1}/Photo": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property Friends from People", + "operationId": "People.GetFriendsPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property Friends in People", + "operationId": "People.UpdateFriendsPhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "path", + "name": "UserName1", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count": { "get": { "tags": [ @@ -24025,6 +26733,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -24056,6 +26776,7 @@ "People.Person" ], "summary": "Get ref of Friends from People", + "description": "Friends of person", "operationId": "People.AsManager.ListRefFriends", "parameters": [ { @@ -24066,6 +26787,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -24208,6 +26941,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/top" }, @@ -24285,6 +27030,18 @@ "type": "string", "x-ms-docs-key-type": "Person" }, + { + "in": "header", + "name": "ConsistencyLevel", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "type": "string", + "x-examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/parameters/search" }, @@ -24508,6 +27265,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.ListTrips", "parameters": [ { @@ -24596,6 +27357,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.CreateTrips", "consumes": [ "application/json" @@ -24655,6 +27420,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.GetTrips", "produces": [ "application/json" @@ -24724,6 +27493,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.UpdateTrips", "consumes": [ "application/json" @@ -24781,6 +27554,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.DeleteTrips", "parameters": [ { @@ -25460,6 +28237,103 @@ }, "x-description": "Provides operations to call the UpdatePersonLastName method." }, + "/People/{UserName}/Photo": { + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get photo", + "description": "Get photo of a specific user", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-get-photo?view=graph-rest-1.0" + }, + "operationId": "People.Person.GetPhoto", + "produces": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "schema": { + "format": "binary", + "type": "string" + } + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update photo", + "description": "Update photo of a specific user", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-update-photo?view=graph-rest-1.0" + }, + "operationId": "People.Person.UpdatePhoto", + "consumes": [ + "application/octet-stream" + ], + "parameters": [ + { + "in": "path", + "name": "UserName", + "description": "The unique identifier of Person", + "required": true, + "type": "string", + "x-ms-docs-key-type": "Person" + }, + { + "in": "body", + "name": "body", + "description": "New media content.", + "required": true, + "schema": { + "format": "binary", + "type": "string" + } + } + ], + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "x-description": "Provides operations to manage the media for the Person entity." + }, "/People/{UserName}/Trips": { "get": { "tags": [ @@ -25467,6 +28341,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "People.ListTrips", "parameters": [ { @@ -25555,6 +28433,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "People.CreateTrips", "consumes": [ "application/json" @@ -25614,6 +28496,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "People.GetTrips", "produces": [ "application/json" @@ -25683,6 +28569,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "People.UpdateTrips", "consumes": [ "application/json" @@ -25740,6 +28630,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "People.DeleteTrips", "parameters": [ { @@ -26707,7 +29601,12 @@ "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" } }, + "Photo": { + "format": "base64url", + "type": "string" + }, "Friends": { + "description": "Friends of person", "type": "array", "items": { "$ref": "#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person" diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.V2.yaml b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.V2.yaml index cd7efc5f..35e6d691 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.V2.yaml +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.V2.yaml @@ -712,6 +712,56 @@ paths: default: $ref: '#/responses/error' x-description: Casts the previous resource to EventLocation. + '/Airports/{IcaoCode}/Location/EmergencyAuthority/Photo': + get: + tags: + - Airports.Person + summary: Get Photo for the navigation property EmergencyAuthority from Airports + operationId: Airports.GetEmergencyAuthorityPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: IcaoCode + description: The unique identifier of Airport + required: true + type: string + x-ms-docs-key-type: Airport + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + put: + tags: + - Airports.Person + summary: Update Photo for the navigation property EmergencyAuthority in Airports + operationId: Airports.UpdateEmergencyAuthorityPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: IcaoCode + description: The unique identifier of Airport + required: true + type: string + x-ms-docs-key-type: Airport + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + x-description: Provides operations to manage the media for the Airport entity. /Airports/$count: get: tags: @@ -775,7 +825,8 @@ paths: get: tags: - Me.Person - summary: Get Me + summary: Get signed in person + description: Retrieve the properties and relationships of Person object. operationId: Me.Person.GetPerson produces: - application/json @@ -1433,13 +1484,71 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-description: Casts the previous resource to Manager. + /Me/BestFriend/Photo: + get: + tags: + - Me.Person + summary: Get Photo for the navigation property BestFriend from Me + operationId: Me.GetBestFriendPhoto + produces: + - application/octet-stream + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property BestFriend in Me + operationId: Me.UpdateBestFriendPhoto + consumes: + - application/octet-stream + parameters: + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. /Me/Friends: get: tags: - Me.Person summary: Get Friends from Me + description: Friends of person operationId: Me.ListFriends parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -1817,6 +1926,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -1858,6 +1975,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -1884,6 +2009,68 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-description: Casts the previous resource to Manager. + '/Me/Friends/{UserName}/Photo': + get: + tags: + - Me.Person + summary: Get Photo for the navigation property Friends from Me + operationId: Me.GetFriendsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property Friends in Me + operationId: Me.UpdateFriendsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. /Me/Friends/$count: get: tags: @@ -1891,6 +2078,14 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount-182b parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -1910,8 +2105,17 @@ paths: tags: - Me.Person summary: Get ref of Friends from Me + description: Friends of person operationId: Me.ListRefFriends parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -1989,6 +2193,14 @@ paths: summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection operationId: Me.ListFriends.AsEmployee parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -2031,6 +2243,14 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount.AsEmployee-884b parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -2052,6 +2272,14 @@ paths: summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection operationId: Me.ListFriends.AsManager parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -2094,6 +2322,14 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount.AsManager-9376 parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -2329,6 +2565,14 @@ paths: summary: Get the number of the resource operationId: Me.AsEmployee.AddressInfo.GetCount-8488 parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -2366,6 +2610,14 @@ paths: summary: Get the number of the resource operationId: Me.AddressInfo.GetCount.AsEventLocation-9375 parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -2622,6 +2874,14 @@ paths: summary: Get the number of the resource operationId: Me.AsEmployee.BestFriend.AddressInfo.GetCount-81de parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -2659,6 +2919,14 @@ paths: summary: Get the number of the resource operationId: Me.BestFriend.AddressInfo.GetCount.AsEventLocation-842c parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -2785,39 +3053,20 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-description: Casts the previous resource to Manager. - /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends: + /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/BestFriend/Photo: get: tags: - Me.Person - summary: Get Friends from Me - operationId: Me.AsEmployee.ListFriends - parameters: - - $ref: '#/parameters/top' - - $ref: '#/parameters/skip' - - $ref: '#/parameters/search' - - $ref: '#/parameters/filter' - - $ref: '#/parameters/count' - - in: query - name: $orderby - description: Order items by property values - type: array - items: - type: string - - in: query - name: $select - description: Select properties to be returned - type: array - items: - type: string - - in: query - name: $expand - description: Expand related entities - type: array - items: - type: string + summary: Get Photo for the navigation property BestFriend from Me + operationId: Me.GetBestFriendPhoto + produces: + - application/octet-stream responses: '200': - $ref: '#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonCollectionResponse' + description: Retrieved media content + schema: + format: binary + type: string default: $ref: '#/responses/error' deprecated: true @@ -2826,16 +3075,93 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. - x-ms-docs-operation-type: operation - x-description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. - x-ms-docs-grouped-path: - - /Me/Friends - - /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends - '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName}/$ref': - delete: + put: tags: - Me.Person - summary: Delete ref of navigation property Friends for Me + summary: Update Photo for the navigation property BestFriend in Me + operationId: Me.UpdateBestFriendPhoto + consumes: + - application/octet-stream + parameters: + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. + /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends: + get: + tags: + - Me.Person + summary: Get Friends from Me + description: Friends of person + operationId: Me.AsEmployee.ListFriends + parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual + - $ref: '#/parameters/top' + - $ref: '#/parameters/skip' + - $ref: '#/parameters/search' + - $ref: '#/parameters/filter' + - $ref: '#/parameters/count' + - in: query + name: $orderby + description: Order items by property values + type: array + items: + type: string + - in: query + name: $select + description: Select properties to be returned + type: array + items: + type: string + - in: query + name: $expand + description: Expand related entities + type: array + items: + type: string + responses: + '200': + $ref: '#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.PersonCollectionResponse' + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-ms-docs-operation-type: operation + x-description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. + x-ms-docs-grouped-path: + - /Me/Friends + - /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName}/$ref': + delete: + tags: + - Me.Person + summary: Delete ref of navigation property Friends for Me operationId: Me.AsEmployee.friends.DeleteRefPerson parameters: - in: path @@ -2994,6 +3320,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -3044,6 +3378,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -3169,6 +3511,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -3195,6 +3545,68 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-description: Casts the previous resource to Manager. + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName}/Photo': + get: + tags: + - Me.Person + summary: Get Photo for the navigation property Friends from Me + operationId: Me.GetFriendsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property Friends in Me + operationId: Me.UpdateFriendsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$count: get: tags: @@ -3202,6 +3614,14 @@ paths: summary: Get the number of the resource operationId: Me.AsEmployee.Friends.GetCount-0cb7 parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -3221,8 +3641,17 @@ paths: tags: - Me.Person summary: Get ref of Friends from Me + description: Friends of person operationId: Me.AsEmployee.ListRefFriends parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -3300,6 +3729,14 @@ paths: summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection operationId: Me.ListFriends.AsManager parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -3342,6 +3779,14 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount.AsManager-85ff parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -3639,6 +4084,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -3689,6 +4142,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -3799,6 +4260,68 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-description: Casts the previous resource to EventLocation. + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName}/Photo': + get: + tags: + - Me.Person + summary: Get Photo for the navigation property Peers from Me + operationId: Me.GetPeersPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property Peers in Me + operationId: Me.UpdatePeersPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/$count: get: tags: @@ -3903,6 +4426,9 @@ paths: - Me.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.ListTrips parameters: - in: header @@ -3953,6 +4479,9 @@ paths: - Me.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.CreateTrips consumes: - application/json @@ -3989,6 +4518,9 @@ paths: - Me.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.GetTrips produces: - application/json @@ -4033,6 +4565,9 @@ paths: - Me.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.UpdateTrips consumes: - application/json @@ -4069,6 +4604,9 @@ paths: - Me.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.DeleteTrips parameters: - in: path @@ -5145,26 +5683,75 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-description: Casts the previous resource to Employee. - /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports: + /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Photo: get: tags: - Me.Person - summary: Get DirectReports from Me - operationId: Me.AsManager.ListDirectReports - parameters: - - $ref: '#/parameters/top' - - $ref: '#/parameters/skip' - - $ref: '#/parameters/search' - - $ref: '#/parameters/filter' - - $ref: '#/parameters/count' - - in: query - name: $orderby - description: Order items by property values - type: array - items: - type: string - - in: query - name: $select + summary: Get Photo for the navigation property BestFriend from Me + operationId: Me.GetBestFriendPhoto + produces: + - application/octet-stream + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property BestFriend in Me + operationId: Me.UpdateBestFriendPhoto + consumes: + - application/octet-stream + parameters: + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. + /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports: + get: + tags: + - Me.Person + summary: Get DirectReports from Me + operationId: Me.AsManager.ListDirectReports + parameters: + - $ref: '#/parameters/top' + - $ref: '#/parameters/skip' + - $ref: '#/parameters/search' + - $ref: '#/parameters/filter' + - $ref: '#/parameters/count' + - in: query + name: $orderby + description: Order items by property values + type: array + items: + type: string + - in: query + name: $select description: Select properties to be returned type: array items: @@ -5527,6 +6114,68 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-description: Casts the previous resource to EventLocation. + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/{UserName}/Photo': + get: + tags: + - Me.Person + summary: Get Photo for the navigation property DirectReports from Me + operationId: Me.GetDirectReportsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property DirectReports in Me + operationId: Me.UpdateDirectReportsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/$count: get: tags: @@ -5630,8 +6279,17 @@ paths: tags: - Me.Person summary: Get Friends from Me + description: Friends of person operationId: Me.AsManager.ListFriends parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -6009,6 +6667,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -6035,6 +6701,68 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-description: Casts the previous resource to Employee. + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/{UserName}/Photo': + get: + tags: + - Me.Person + summary: Get Photo for the navigation property Friends from Me + operationId: Me.GetFriendsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property Friends in Me + operationId: Me.UpdateFriendsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count: get: tags: @@ -6042,6 +6770,14 @@ paths: summary: Get the number of the resource operationId: Me.AsManager.Friends.GetCount-60a7 parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -6061,8 +6797,17 @@ paths: tags: - Me.Person summary: Get ref of Friends from Me + description: Friends of person operationId: Me.AsManager.ListRefFriends parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -6140,6 +6885,14 @@ paths: summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection operationId: Me.ListFriends.AsEmployee parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -6182,6 +6935,14 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount.AsEmployee-6a35 parameters: + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -6311,6 +7072,9 @@ paths: - Me.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: Me.AsManager.ListTrips parameters: - in: header @@ -6361,6 +7125,9 @@ paths: - Me.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: Me.AsManager.CreateTrips consumes: - application/json @@ -6397,6 +7164,9 @@ paths: - Me.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: Me.AsManager.GetTrips produces: - application/json @@ -6441,6 +7211,9 @@ paths: - Me.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: Me.AsManager.UpdateTrips consumes: - application/json @@ -6477,6 +7250,9 @@ paths: - Me.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: Me.AsManager.DeleteTrips parameters: - in: path @@ -6880,12 +7656,64 @@ paths: description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-ms-docs-operation-type: function x-description: Provides operations to call the UpdatePersonLastName method. + /Me/Photo: + get: + tags: + - Me.Person + summary: Get Photo for Person from Me + operationId: Me.Person.GetPhoto + produces: + - application/octet-stream + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for Person in Me + operationId: Me.Person.UpdatePhoto + consumes: + - application/octet-stream + parameters: + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + x-description: Provides operations to manage the media for the Person entity. /Me/Trips: get: tags: - Me.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: Me.ListTrips parameters: - in: header @@ -6936,6 +7764,9 @@ paths: - Me.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: Me.CreateTrips consumes: - application/json @@ -6972,6 +7803,9 @@ paths: - Me.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: Me.GetTrips produces: - application/json @@ -7016,6 +7850,9 @@ paths: - Me.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: Me.UpdateTrips consumes: - application/json @@ -7052,6 +7889,9 @@ paths: - Me.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: Me.DeleteTrips parameters: - in: path @@ -8281,12 +9121,14 @@ paths: version: 2021-05/bestfriend description: The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API. x-description: Casts the previous resource to Manager. - '/NewComePeople/{UserName}/Friends': + '/NewComePeople/{UserName}/BestFriend/Photo': get: tags: - NewComePeople.Person - summary: Get Friends from NewComePeople - operationId: NewComePeople.ListFriends + summary: Get Photo for the navigation property BestFriend from NewComePeople + operationId: NewComePeople.GetBestFriendPhoto + produces: + - application/octet-stream parameters: - in: path name: UserName @@ -8294,22 +9136,91 @@ paths: required: true type: string x-ms-docs-key-type: Person - - $ref: '#/parameters/top' - - $ref: '#/parameters/skip' - - $ref: '#/parameters/search' - - $ref: '#/parameters/filter' - - $ref: '#/parameters/count' - - in: query - name: $orderby - description: Order items by property values - type: array - items: - type: string - - in: query - name: $select - description: Select properties to be returned - type: array - items: + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/bestfriend + description: The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API. + put: + tags: + - NewComePeople.Person + summary: Update Photo for the navigation property BestFriend in NewComePeople + operationId: NewComePeople.UpdateBestFriendPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/bestfriend + description: The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API. + x-description: Provides operations to manage the media for the Person entity. + '/NewComePeople/{UserName}/Friends': + get: + tags: + - NewComePeople.Person + summary: Get Friends from NewComePeople + description: Friends of person + operationId: NewComePeople.ListFriends + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual + - $ref: '#/parameters/top' + - $ref: '#/parameters/skip' + - $ref: '#/parameters/search' + - $ref: '#/parameters/filter' + - $ref: '#/parameters/count' + - in: query + name: $orderby + description: Order items by property values + type: array + items: + type: string + - in: query + name: $select + description: Select properties to be returned + type: array + items: type: string - in: query name: $expand @@ -8684,6 +9595,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -8725,6 +9644,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -8745,6 +9672,68 @@ paths: default: $ref: '#/responses/error' x-description: Casts the previous resource to Manager. + '/NewComePeople/{UserName}/Friends/{UserName1}/Photo': + get: + tags: + - NewComePeople.Person + summary: Get Photo for the navigation property Friends from NewComePeople + operationId: NewComePeople.GetFriendsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + put: + tags: + - NewComePeople.Person + summary: Update Photo for the navigation property Friends in NewComePeople + operationId: NewComePeople.UpdateFriendsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + x-description: Provides operations to manage the media for the Person entity. '/NewComePeople/{UserName}/Friends/$count': get: tags: @@ -8758,6 +9747,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -8771,6 +9768,7 @@ paths: tags: - NewComePeople.Person summary: Get ref of Friends from NewComePeople + description: Friends of person operationId: NewComePeople.ListRefFriends parameters: - in: path @@ -8779,6 +9777,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -8856,6 +9862,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -8898,6 +9912,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -8919,6 +9941,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -8961,6 +9991,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -9221,12 +10259,65 @@ paths: $ref: '#/responses/error' x-ms-docs-operation-type: function x-description: Provides operations to call the UpdatePersonLastName method. + '/NewComePeople/{UserName}/Photo': + get: + tags: + - NewComePeople.Person + summary: Get Photo for Person from NewComePeople + operationId: NewComePeople.Person.GetPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + put: + tags: + - NewComePeople.Person + summary: Update Photo for Person in NewComePeople + operationId: NewComePeople.Person.UpdatePhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + x-description: Provides operations to manage the media for the Person entity. '/NewComePeople/{UserName}/Trips': get: tags: - NewComePeople.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: NewComePeople.ListTrips parameters: - in: path @@ -9277,6 +10368,9 @@ paths: - NewComePeople.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: NewComePeople.CreateTrips consumes: - application/json @@ -9310,6 +10404,9 @@ paths: - NewComePeople.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: NewComePeople.GetTrips produces: - application/json @@ -9354,6 +10451,9 @@ paths: - NewComePeople.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: NewComePeople.UpdateTrips consumes: - application/json @@ -9390,6 +10490,9 @@ paths: - NewComePeople.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: NewComePeople.DeleteTrips parameters: - in: path @@ -10641,7 +11744,11 @@ paths: get: tags: - People.Person - summary: Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager + summary: Get best friend + description: Get the item of type Person cast as Manager + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-get-friend-manager?view=graph-rest-1.0 operationId: People.GetBestFriend.AsManager produces: - application/json @@ -10678,11 +11785,77 @@ paths: version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-description: Casts the previous resource to Manager. + '/People/{UserName}/BestFriend/Photo': + get: + tags: + - People.Person + summary: Get Photo for the navigation property BestFriend from People + operationId: People.GetBestFriendPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property BestFriend in People + operationId: People.UpdateBestFriendPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Friends': get: tags: - People.Person - summary: Get Friends from People + summary: List friends + description: List the friends of a specific person + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0 operationId: People.ListFriends parameters: - in: path @@ -10691,6 +11864,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -10734,7 +11915,11 @@ paths: delete: tags: - People.Person - summary: Delete ref of navigation property Friends for People + summary: Delete a friend. + description: Delete an instance of a friend relationship. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0 operationId: People.friends.DeleteRefPerson parameters: - in: path @@ -11134,6 +12319,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -11181,6 +12374,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -11207,6 +12408,80 @@ paths: version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-description: Casts the previous resource to Manager. + '/People/{UserName}/Friends/{UserName1}/Photo': + get: + tags: + - People.Person + summary: Get Photo for the navigation property Friends from People + operationId: People.GetFriendsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property Friends in People + operationId: People.UpdateFriendsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Friends/$count': get: tags: @@ -11220,6 +12495,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -11238,7 +12521,11 @@ paths: get: tags: - People.Person - summary: Get ref of Friends from People + summary: List friends + description: List the friends of a specific person + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0 operationId: People.ListRefFriends parameters: - in: path @@ -11247,6 +12534,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -11273,7 +12568,11 @@ paths: post: tags: - People.Person - summary: Create new navigation property ref to Friends for People + summary: Create a friend. + description: Create a new friend. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-post-friend?view=graph-rest-1.0 operationId: People.CreateRefFriends parameters: - in: path @@ -11298,7 +12597,11 @@ paths: delete: tags: - People.Person - summary: Delete ref of navigation property Friends for People + summary: Delete a friend. + description: Delete an instance of a friend relationship. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0 operationId: People.DeleteRefFriends parameters: - in: path @@ -11342,6 +12645,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -11390,6 +12701,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -11417,6 +12736,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -11465,6 +12792,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -11483,7 +12818,8 @@ paths: get: tags: - People.Location - summary: Get HomeAddress property value + summary: Get home address + description: Get the home address of a specific person operationId: People.GetHomeAddress produces: - application/json @@ -11757,6 +13093,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -11807,6 +13151,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -12118,6 +13470,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -12168,6 +13528,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -12319,11 +13687,74 @@ paths: version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-description: Casts the previous resource to Manager. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/BestFriend/Photo': + get: + tags: + - People.Person + summary: Get Photo for the navigation property BestFriend from People + operationId: People.GetBestFriendPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property BestFriend in People + operationId: People.UpdateBestFriendPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends': get: tags: - People.Person summary: Get Friends from People + description: Friends of person operationId: People.AsEmployee.ListFriends parameters: - in: path @@ -12332,6 +13763,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -12564,6 +14003,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -12626,6 +14073,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -12775,6 +14230,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -12801,6 +14264,80 @@ paths: version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-description: Casts the previous resource to Manager. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/Photo': + get: + tags: + - People.Person + summary: Get Photo for the navigation property Friends from People + operationId: People.GetFriendsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property Friends in People + operationId: People.UpdateFriendsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$count': get: tags: @@ -12814,6 +14351,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -12833,6 +14378,7 @@ paths: tags: - People.Person summary: Get ref of Friends from People + description: Friends of person operationId: People.AsEmployee.ListRefFriends parameters: - in: path @@ -12841,6 +14387,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -12936,6 +14490,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -12984,6 +14546,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -13336,6 +14906,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -13398,6 +14976,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -13526,6 +15112,80 @@ paths: version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-description: Casts the previous resource to EventLocation. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/Photo': + get: + tags: + - People.Person + summary: Get Photo for the navigation property Peers from People + operationId: People.GetPeersPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property Peers in People + operationId: People.UpdatePeersPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/$count': get: tags: @@ -13654,6 +15314,9 @@ paths: - People.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: People.AsEmployee.ListTrips parameters: - in: path @@ -13710,6 +15373,9 @@ paths: - People.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: People.AsEmployee.CreateTrips consumes: - application/json @@ -13752,6 +15418,9 @@ paths: - People.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: People.AsEmployee.GetTrips produces: - application/json @@ -13802,6 +15471,9 @@ paths: - People.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: People.AsEmployee.UpdateTrips consumes: - application/json @@ -13844,6 +15516,9 @@ paths: - People.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: People.AsEmployee.DeleteTrips parameters: - in: path @@ -15074,9 +16749,77 @@ paths: '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation': get: tags: - - People.Person.Location - summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection - operationId: People.BestFriend.GetHomeAddress.AsEventLocation + - People.Person.Location + summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection + operationId: People.BestFriend.GetHomeAddress.AsEventLocation + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + $ref: '#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse' + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Casts the previous resource to EventLocation. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee': + get: + tags: + - People.Person + summary: Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee + operationId: People.GetBestFriend.AsEmployee + produces: + - application/json + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: query + name: $select + description: Select properties to be returned + type: array + items: + type: string + - in: query + name: $expand + description: Expand related entities + type: array + items: + type: string + responses: + '200': + description: Result entities + schema: + $ref: '#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee' + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Casts the previous resource to Employee. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Photo': + get: + tags: + - People.Person + summary: Get Photo for the navigation property BestFriend from People + operationId: People.GetBestFriendPhoto + produces: + - application/octet-stream parameters: - in: path name: UserName @@ -15086,7 +16829,10 @@ paths: x-ms-docs-key-type: Person responses: '200': - $ref: '#/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse' + description: Retrieved media content + schema: + format: binary + type: string default: $ref: '#/responses/error' deprecated: true @@ -15095,15 +16841,13 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. - x-description: Casts the previous resource to EventLocation. - '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee': - get: + put: tags: - People.Person - summary: Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee - operationId: People.GetBestFriend.AsEmployee - produces: - - application/json + summary: Update Photo for the navigation property BestFriend in People + operationId: People.UpdateBestFriendPhoto + consumes: + - application/octet-stream parameters: - in: path name: UserName @@ -15111,23 +16855,16 @@ paths: required: true type: string x-ms-docs-key-type: Person - - in: query - name: $select - description: Select properties to be returned - type: array - items: - type: string - - in: query - name: $expand - description: Expand related entities - type: array - items: + - in: body + name: body + description: New media content. + required: true + schema: + format: binary type: string responses: - '200': - description: Result entities - schema: - $ref: '#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee' + '204': + description: Success default: $ref: '#/responses/error' deprecated: true @@ -15136,7 +16873,7 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. - x-description: Casts the previous resource to Employee. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports': get: tags: @@ -15585,6 +17322,80 @@ paths: version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-description: Casts the previous resource to EventLocation. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/{UserName1}/Photo': + get: + tags: + - People.Person + summary: Get Photo for the navigation property DirectReports from People + operationId: People.GetDirectReportsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property DirectReports in People + operationId: People.UpdateDirectReportsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/$count': get: tags: @@ -15712,6 +17523,7 @@ paths: tags: - People.Person summary: Get Friends from People + description: Friends of person operationId: People.AsManager.ListFriends parameters: - in: path @@ -15720,6 +17532,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -16163,6 +17983,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - in: query name: $select description: Select properties to be returned @@ -16189,6 +18017,80 @@ paths: version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-description: Casts the previous resource to Employee. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/{UserName1}/Photo': + get: + tags: + - People.Person + summary: Get Photo for the navigation property Friends from People + operationId: People.GetFriendsPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property Friends in People + operationId: People.UpdateFriendsPhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: path + name: UserName1 + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count': get: tags: @@ -16202,6 +18104,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -16221,6 +18131,7 @@ paths: tags: - People.Person summary: Get ref of Friends from People + description: Friends of person operationId: People.AsManager.ListRefFriends parameters: - in: path @@ -16229,6 +18140,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -16324,6 +18243,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/top' - $ref: '#/parameters/skip' - $ref: '#/parameters/search' @@ -16372,6 +18299,14 @@ paths: required: true type: string x-ms-docs-key-type: Person + - in: header + name: ConsistencyLevel + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + type: string + x-examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/parameters/search' - $ref: '#/parameters/filter' responses: @@ -16526,6 +18461,9 @@ paths: - People.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: People.AsManager.ListTrips parameters: - in: path @@ -16582,6 +18520,9 @@ paths: - People.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: People.AsManager.CreateTrips consumes: - application/json @@ -16624,6 +18565,9 @@ paths: - People.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: People.AsManager.GetTrips produces: - application/json @@ -16674,6 +18618,9 @@ paths: - People.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: People.AsManager.UpdateTrips consumes: - application/json @@ -16716,6 +18663,9 @@ paths: - People.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: People.AsManager.DeleteTrips parameters: - in: path @@ -17185,12 +19135,85 @@ paths: description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-ms-docs-operation-type: function x-description: Provides operations to call the UpdatePersonLastName method. + '/People/{UserName}/Photo': + get: + tags: + - People.Person + summary: Get photo + description: Get photo of a specific user + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-get-photo?view=graph-rest-1.0 + operationId: People.Person.GetPhoto + produces: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + schema: + format: binary + type: string + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update photo + description: Update photo of a specific user + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-update-photo?view=graph-rest-1.0 + operationId: People.Person.UpdatePhoto + consumes: + - application/octet-stream + parameters: + - in: path + name: UserName + description: The unique identifier of Person + required: true + type: string + x-ms-docs-key-type: Person + - in: body + name: body + description: New media content. + required: true + schema: + format: binary + type: string + responses: + '204': + description: Success + default: + $ref: '#/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + x-description: Provides operations to manage the media for the Person entity. '/People/{UserName}/Trips': get: tags: - People.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: People.ListTrips parameters: - in: path @@ -17247,6 +19270,9 @@ paths: - People.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: People.CreateTrips consumes: - application/json @@ -17289,6 +19315,9 @@ paths: - People.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: People.GetTrips produces: - application/json @@ -17339,6 +19368,9 @@ paths: - People.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: People.UpdateTrips consumes: - application/json @@ -17381,6 +19413,9 @@ paths: - People.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: People.DeleteTrips parameters: - in: path @@ -18028,7 +20063,11 @@ definitions: type: array items: $ref: '#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature' + Photo: + format: base64url + type: string Friends: + description: Friends of person type: array items: $ref: '#/definitions/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person' diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.json b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.json index cc363774..f350dd24 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.json +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.json @@ -1228,6 +1228,83 @@ } } }, + "/Airports/{IcaoCode}/Location/EmergencyAuthority/Photo": { + "description": "Provides operations to manage the media for the Airport entity.", + "get": { + "tags": [ + "Airports.Person" + ], + "summary": "Get Photo for the navigation property EmergencyAuthority from Airports", + "operationId": "Airports.GetEmergencyAuthorityPhoto", + "parameters": [ + { + "name": "IcaoCode", + "in": "path", + "description": "The unique identifier of Airport", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Airport" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + } + }, + "put": { + "tags": [ + "Airports.Person" + ], + "summary": "Update Photo for the navigation property EmergencyAuthority in Airports", + "operationId": "Airports.UpdateEmergencyAuthorityPhoto", + "parameters": [ + { + "name": "IcaoCode", + "in": "path", + "description": "The unique identifier of Airport", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Airport" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + } + } + }, "/Airports/$count": { "description": "Provides operations to count the resources in the collection.", "get": { @@ -1369,7 +1446,8 @@ "tags": [ "Me.Person" ], - "summary": "Get Me", + "summary": "Get signed in person", + "description": "Retrieve the properties and relationships of Person object.", "operationId": "Me.Person.GetPerson", "parameters": [ { @@ -2416,6 +2494,73 @@ } } }, + "/Me/BestFriend/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from Me", + "operationId": "Me.GetBestFriendPhoto", + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in Me", + "operationId": "Me.UpdateBestFriendPhoto", + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, "/Me/Friends": { "description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", "get": { @@ -2423,8 +2568,23 @@ "Me.Person" ], "summary": "Get Friends from Me", + "description": "Friends of person", "operationId": "Me.ListFriends", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -3045,6 +3205,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -3117,6 +3291,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -3170,25 +3358,37 @@ } } }, - "/Me/Friends/$count": { - "description": "Provides operations to count the resources in the collection.", + "/Me/Friends/{UserName}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", "get": { "tags": [ "Me.Person" ], - "summary": "Get the number of the resource", - "operationId": "Me.Friends.GetCount-182b", + "summary": "Get Photo for the navigation property Friends from Me", + "operationId": "Me.GetFriendsPhoto", "parameters": [ { - "$ref": "#/components/parameters/search" - }, - { - "$ref": "#/components/parameters/filter" + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" } ], "responses": { "200": { - "$ref": "#/components/responses/ODataCountResponse" + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } }, "default": { "$ref": "#/components/responses/error" @@ -3201,72 +3401,36 @@ "version": "2021-05/me", "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." } - } - }, - "/Me/Friends/$ref": { - "description": "Provides operations to manage the collection of Person entities.", - "get": { + }, + "put": { "tags": [ "Me.Person" ], - "summary": "Get ref of Friends from Me", - "operationId": "Me.ListRefFriends", + "summary": "Update Photo for the navigation property Friends in Me", + "operationId": "Me.UpdateFriendsPhoto", "parameters": [ { - "$ref": "#/components/parameters/top" - }, - { - "$ref": "#/components/parameters/skip" - }, - { - "$ref": "#/components/parameters/search" - }, - { - "$ref": "#/components/parameters/filter" - }, - { - "$ref": "#/components/parameters/count" - }, - { - "name": "$orderby", - "in": "query", - "description": "Order items by property values", - "style": "form", - "explode": false, + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, "schema": { - "uniqueItems": true, - "type": "array", - "items": { - "type": "string" - } - } - } - ], - "responses": { - "200": { - "$ref": "#/components/responses/StringCollectionResponse" - }, - "default": { - "$ref": "#/components/responses/error" + "type": "string" + }, + "x-ms-docs-key-type": "Person" } - }, - "deprecated": true, - "x-ms-deprecation": { - "removalDate": "2023-03-15T00:00:00.0000000+00:00", - "date": "2021-08-24T00:00:00.0000000+00:00", - "version": "2021-05/me", - "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." - }, - "x-ms-docs-operation-type": "operation" - }, - "post": { - "tags": [ - "Me.Person" ], - "summary": "Create new navigation property ref to Friends for Me", - "operationId": "Me.CreateRefFriends", "requestBody": { - "$ref": "#/components/requestBodies/refPostBody" + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true }, "responses": { "204": { @@ -3282,10 +3446,154 @@ "date": "2021-08-24T00:00:00.0000000+00:00", "version": "2021-05/me", "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." - }, - "x-ms-docs-operation-type": "operation" - }, - "delete": { + } + } + }, + "/Me/Friends/$count": { + "description": "Provides operations to count the resources in the collection.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get the number of the resource", + "operationId": "Me.Friends.GetCount-182b", + "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/components/parameters/search" + }, + { + "$ref": "#/components/parameters/filter" + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/ODataCountResponse" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, + "/Me/Friends/$ref": { + "description": "Provides operations to manage the collection of Person entities.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get ref of Friends from Me", + "description": "Friends of person", + "operationId": "Me.ListRefFriends", + "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/components/parameters/top" + }, + { + "$ref": "#/components/parameters/skip" + }, + { + "$ref": "#/components/parameters/search" + }, + { + "$ref": "#/components/parameters/filter" + }, + { + "$ref": "#/components/parameters/count" + }, + { + "name": "$orderby", + "in": "query", + "description": "Order items by property values", + "style": "form", + "explode": false, + "schema": { + "uniqueItems": true, + "type": "array", + "items": { + "type": "string" + } + } + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/StringCollectionResponse" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + }, + "x-ms-docs-operation-type": "operation" + }, + "post": { + "tags": [ + "Me.Person" + ], + "summary": "Create new navigation property ref to Friends for Me", + "operationId": "Me.CreateRefFriends", + "requestBody": { + "$ref": "#/components/requestBodies/refPostBody" + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + }, + "x-ms-docs-operation-type": "operation" + }, + "delete": { "tags": [ "Me.Person" ], @@ -3337,6 +3645,20 @@ "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection", "operationId": "Me.ListFriends.AsEmployee", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -3421,6 +3743,20 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount.AsEmployee-884b", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -3454,6 +3790,20 @@ "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection", "operationId": "Me.ListFriends.AsManager", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -3538,6 +3888,20 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount.AsManager-9376", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -3922,6 +4286,20 @@ "summary": "Get the number of the resource", "operationId": "Me.AsEmployee.AddressInfo.GetCount-8488", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -3977,6 +4355,20 @@ "summary": "Get the number of the resource", "operationId": "Me.AddressInfo.GetCount.AsEventLocation-9375", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -4377,6 +4769,20 @@ "summary": "Get the number of the resource", "operationId": "Me.AsEmployee.BestFriend.AddressInfo.GetCount-81de", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -4432,6 +4838,20 @@ "summary": "Get the number of the resource", "operationId": "Me.BestFriend.AddressInfo.GetCount.AsEventLocation-842c", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -4637,17 +5057,99 @@ } } }, - "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends": { - "description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/BestFriend/Photo": { + "description": "Provides operations to manage the media for the Person entity.", "get": { "tags": [ "Me.Person" ], - "summary": "Get Friends from Me", - "operationId": "Me.AsEmployee.ListFriends", - "parameters": [ - { - "$ref": "#/components/parameters/top" + "summary": "Get Photo for the navigation property BestFriend from Me", + "operationId": "Me.GetBestFriendPhoto", + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in Me", + "operationId": "Me.UpdateBestFriendPhoto", + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends": { + "description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Friends from Me", + "description": "Friends of person", + "operationId": "Me.AsEmployee.ListFriends", + "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/components/parameters/top" }, { "$ref": "#/components/parameters/skip" @@ -4993,6 +5495,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -5070,6 +5586,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -5266,6 +5796,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -5319,6 +5863,97 @@ } } }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property Friends from Me", + "operationId": "Me.GetFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property Friends in Me", + "operationId": "Me.UpdateFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$count": { "description": "Provides operations to count the resources in the collection.", "get": { @@ -5328,6 +5963,20 @@ "summary": "Get the number of the resource", "operationId": "Me.AsEmployee.Friends.GetCount-0cb7", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -5359,8 +6008,23 @@ "Me.Person" ], "summary": "Get ref of Friends from Me", + "description": "Friends of person", "operationId": "Me.AsEmployee.ListRefFriends", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -5486,6 +6150,20 @@ "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection", "operationId": "Me.ListFriends.AsManager", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -5570,6 +6248,20 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount.AsManager-85ff", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -6065,6 +6757,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -6142,6 +6848,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -6319,6 +7039,97 @@ } } }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property Peers from Me", + "operationId": "Me.GetPeersPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property Peers in Me", + "operationId": "Me.UpdatePeersPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/$count": { "description": "Provides operations to count the resources in the collection.", "get": { @@ -6485,6 +7296,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.ListTrips", "parameters": [ { @@ -6582,6 +7397,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.CreateTrips", "requestBody": { "description": "New navigation property", @@ -6631,6 +7450,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.GetTrips", "parameters": [ { @@ -6705,6 +7528,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.UpdateTrips", "parameters": [ { @@ -6755,6 +7582,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsEmployee.DeleteTrips", "parameters": [ { @@ -8503,6 +9334,73 @@ } } }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from Me", + "operationId": "Me.GetBestFriendPhoto", + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in Me", + "operationId": "Me.UpdateBestFriendPhoto", + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports": { "description": "Provides operations to manage the DirectReports property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager entity.", "get": { @@ -9137,6 +10035,97 @@ } } }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/{UserName}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property DirectReports from Me", + "operationId": "Me.GetDirectReportsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property DirectReports in Me", + "operationId": "Me.UpdateDirectReportsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/$count": { "description": "Provides operations to count the resources in the collection.", "get": { @@ -9302,8 +10291,23 @@ "Me.Person" ], "summary": "Get Friends from Me", + "description": "Friends of person", "operationId": "Me.AsManager.ListFriends", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -9924,6 +10928,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -9977,8 +10995,99 @@ } } }, - "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count": { - "description": "Provides operations to count the resources in the collection.", + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/{UserName}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for the navigation property Friends from Me", + "operationId": "Me.GetFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for the navigation property Friends in Me", + "operationId": "Me.UpdateFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, + "/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count": { + "description": "Provides operations to count the resources in the collection.", "get": { "tags": [ "Me.Person" @@ -9986,6 +11095,20 @@ "summary": "Get the number of the resource", "operationId": "Me.AsManager.Friends.GetCount-60a7", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -10017,8 +11140,23 @@ "Me.Person" ], "summary": "Get ref of Friends from Me", + "description": "Friends of person", "operationId": "Me.AsManager.ListRefFriends", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -10144,6 +11282,20 @@ "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection", "operationId": "Me.ListFriends.AsEmployee", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -10228,6 +11380,20 @@ "summary": "Get the number of the resource", "operationId": "Me.Friends.GetCount.AsEmployee-6a35", "parameters": [ + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -10430,6 +11596,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.ListTrips", "parameters": [ { @@ -10527,6 +11697,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.CreateTrips", "requestBody": { "description": "New navigation property", @@ -10576,6 +11750,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.GetTrips", "parameters": [ { @@ -10650,6 +11828,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.UpdateTrips", "parameters": [ { @@ -10700,6 +11882,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "Me.AsManager.DeleteTrips", "parameters": [ { @@ -11354,6 +12540,73 @@ "x-ms-docs-operation-type": "function" } }, + "/Me/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "Me.Person" + ], + "summary": "Get Photo for Person from Me", + "operationId": "Me.Person.GetPhoto", + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + }, + "put": { + "tags": [ + "Me.Person" + ], + "summary": "Update Photo for Person in Me", + "operationId": "Me.Person.UpdatePhoto", + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/me", + "description": "The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API." + } + } + }, "/Me/Trips": { "description": "Provides operations to manage the Trips property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", "get": { @@ -11362,6 +12615,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "Me.ListTrips", "parameters": [ { @@ -11459,6 +12716,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "Me.CreateTrips", "requestBody": { "description": "New navigation property", @@ -11508,6 +12769,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "Me.GetTrips", "parameters": [ { @@ -11582,6 +12847,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "Me.UpdateTrips", "parameters": [ { @@ -11632,6 +12901,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "Me.DeleteTrips", "parameters": [ { @@ -13675,14 +14948,14 @@ } } }, - "/NewComePeople/{UserName}/Friends": { - "description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", + "/NewComePeople/{UserName}/BestFriend/Photo": { + "description": "Provides operations to manage the media for the Person entity.", "get": { "tags": [ "NewComePeople.Person" ], - "summary": "Get Friends from NewComePeople", - "operationId": "NewComePeople.ListFriends", + "summary": "Get Photo for the navigation property BestFriend from NewComePeople", + "operationId": "NewComePeople.GetBestFriendPhoto", "parameters": [ { "name": "UserName", @@ -13693,42 +14966,148 @@ "type": "string" }, "x-ms-docs-key-type": "Person" - }, - { - "$ref": "#/components/parameters/top" - }, - { - "$ref": "#/components/parameters/skip" - }, - { - "$ref": "#/components/parameters/search" - }, - { - "$ref": "#/components/parameters/filter" - }, - { - "$ref": "#/components/parameters/count" - }, - { - "name": "$orderby", - "in": "query", - "description": "Order items by property values", - "style": "form", - "explode": false, - "schema": { - "uniqueItems": true, - "type": "array", - "items": { - "type": "string" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } } } }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/bestfriend", + "description": "The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API." + } + }, + "put": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in NewComePeople", + "operationId": "NewComePeople.UpdateBestFriendPhoto", + "parameters": [ { - "name": "$select", - "in": "query", - "description": "Select properties to be returned", - "style": "form", - "explode": false, + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/bestfriend", + "description": "The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API." + } + } + }, + "/NewComePeople/{UserName}/Friends": { + "description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", + "get": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Get Friends from NewComePeople", + "description": "Friends of person", + "operationId": "NewComePeople.ListFriends", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/components/parameters/top" + }, + { + "$ref": "#/components/parameters/skip" + }, + { + "$ref": "#/components/parameters/search" + }, + { + "$ref": "#/components/parameters/filter" + }, + { + "$ref": "#/components/parameters/count" + }, + { + "name": "$orderby", + "in": "query", + "description": "Order items by property values", + "style": "form", + "explode": false, + "schema": { + "uniqueItems": true, + "type": "array", + "items": { + "type": "string" + } + } + }, + { + "name": "$select", + "in": "query", + "description": "Select properties to be returned", + "style": "form", + "explode": false, "schema": { "uniqueItems": true, "type": "array", @@ -14371,6 +15750,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -14446,6 +15839,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -14492,6 +15899,103 @@ } } }, + "/NewComePeople/{UserName}/Friends/{UserName1}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Get Photo for the navigation property Friends from NewComePeople", + "operationId": "NewComePeople.GetFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + } + }, + "put": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Update Photo for the navigation property Friends in NewComePeople", + "operationId": "NewComePeople.UpdateFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + } + } + }, "/NewComePeople/{UserName}/Friends/$count": { "description": "Provides operations to count the resources in the collection.", "get": { @@ -14511,6 +16015,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -14535,6 +16053,7 @@ "NewComePeople.Person" ], "summary": "Get ref of Friends from NewComePeople", + "description": "Friends of person", "operationId": "NewComePeople.ListRefFriends", "parameters": [ { @@ -14547,6 +16066,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -14683,6 +16216,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -14771,10 +16318,24 @@ "x-ms-docs-key-type": "Person" }, { - "$ref": "#/components/parameters/search" - }, - { - "$ref": "#/components/parameters/filter" + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/components/parameters/search" + }, + { + "$ref": "#/components/parameters/filter" } ], "responses": { @@ -14806,6 +16367,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -14893,6 +16468,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -15342,6 +16931,83 @@ "x-ms-docs-operation-type": "function" } }, + "/NewComePeople/{UserName}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Get Photo for Person from NewComePeople", + "operationId": "NewComePeople.Person.GetPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + } + }, + "put": { + "tags": [ + "NewComePeople.Person" + ], + "summary": "Update Photo for Person in NewComePeople", + "operationId": "NewComePeople.Person.UpdatePhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + } + } + }, "/NewComePeople/{UserName}/Trips": { "description": "Provides operations to manage the Trips property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", "get": { @@ -15350,6 +17016,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.ListTrips", "parameters": [ { @@ -15450,6 +17120,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.CreateTrips", "parameters": [ { @@ -15500,6 +17174,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.GetTrips", "parameters": [ { @@ -15577,6 +17255,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.UpdateTrips", "parameters": [ { @@ -15630,6 +17312,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "NewComePeople.DeleteTrips", "parameters": [ { @@ -17701,7 +19387,12 @@ "tags": [ "People.Person" ], - "summary": "Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager", + "summary": "Get best friend", + "description": "Get the item of type Person cast as Manager", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-get-friend-manager?view=graph-rest-1.0" + }, "operationId": "People.GetBestFriend.AsManager", "parameters": [ { @@ -17767,13 +19458,109 @@ } } }, + "/People/{UserName}/BestFriend/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from People", + "operationId": "People.GetBestFriendPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in People", + "operationId": "People.UpdateBestFriendPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, "/People/{UserName}/Friends": { "description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", "get": { "tags": [ "People.Person" ], - "summary": "Get Friends from People", + "summary": "List friends", + "description": "List the friends of a specific person", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0" + }, "operationId": "People.ListFriends", "parameters": [ { @@ -17786,6 +19573,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -17872,7 +19673,12 @@ "tags": [ "People.Person" ], - "summary": "Delete ref of navigation property Friends for People", + "summary": "Delete a friend.", + "description": "Delete an instance of a friend relationship.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0" + }, "operationId": "People.friends.DeleteRefPerson", "parameters": [ { @@ -18516,6 +20322,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -18598,6 +20418,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -18651,14 +20485,14 @@ } } }, - "/People/{UserName}/Friends/$count": { - "description": "Provides operations to count the resources in the collection.", + "/People/{UserName}/Friends/{UserName1}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", "get": { "tags": [ "People.Person" ], - "summary": "Get the number of the resource", - "operationId": "People.Friends.GetCount-92b9", + "summary": "Get Photo for the navigation property Friends from People", + "operationId": "People.GetFriendsPhoto", "parameters": [ { "name": "UserName", @@ -18671,19 +20505,144 @@ "x-ms-docs-key-type": "Person" }, { - "$ref": "#/components/parameters/search" - }, - { - "$ref": "#/components/parameters/filter" + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" } ], "responses": { "200": { - "$ref": "#/components/responses/ODataCountResponse" - }, - "default": { - "$ref": "#/components/responses/error" - } + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property Friends in People", + "operationId": "People.UpdateFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, + "/People/{UserName}/Friends/$count": { + "description": "Provides operations to count the resources in the collection.", + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get the number of the resource", + "operationId": "People.Friends.GetCount-92b9", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "$ref": "#/components/parameters/search" + }, + { + "$ref": "#/components/parameters/filter" + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/ODataCountResponse" + }, + "default": { + "$ref": "#/components/responses/error" + } }, "deprecated": true, "x-ms-deprecation": { @@ -18700,7 +20659,12 @@ "tags": [ "People.Person" ], - "summary": "Get ref of Friends from People", + "summary": "List friends", + "description": "List the friends of a specific person", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0" + }, "operationId": "People.ListRefFriends", "parameters": [ { @@ -18713,6 +20677,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -18764,7 +20742,12 @@ "tags": [ "People.Person" ], - "summary": "Create new navigation property ref to Friends for People", + "summary": "Create a friend.", + "description": "Create a new friend.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-post-friend?view=graph-rest-1.0" + }, "operationId": "People.CreateRefFriends", "parameters": [ { @@ -18802,7 +20785,12 @@ "tags": [ "People.Person" ], - "summary": "Delete ref of navigation property Friends for People", + "summary": "Delete a friend.", + "description": "Delete an instance of a friend relationship.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0" + }, "operationId": "People.DeleteRefFriends", "parameters": [ { @@ -18870,6 +20858,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -18964,6 +20966,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -19007,6 +21023,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -19101,6 +21131,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -19130,7 +21174,8 @@ "tags": [ "People.Location" ], - "summary": "Get HomeAddress property value", + "summary": "Get home address", + "description": "Get the home address of a specific person", "operationId": "People.GetHomeAddress", "parameters": [ { @@ -19585,6 +21630,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -19662,6 +21721,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -20160,6 +22233,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -20237,6 +22324,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -20486,6 +22587,97 @@ } } }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/BestFriend/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from People", + "operationId": "People.GetBestFriendPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in People", + "operationId": "People.UpdateBestFriendPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends": { "description": "Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", "get": { @@ -20493,6 +22685,7 @@ "People.Person" ], "summary": "Get Friends from People", + "description": "Friends of person", "operationId": "People.AsEmployee.ListFriends", "parameters": [ { @@ -20505,6 +22698,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -20902,6 +23109,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -20999,6 +23220,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -21159,14 +23394,157 @@ } } }, - "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation": { - "description": "Casts the previous resource to EventLocation.", + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation": { + "description": "Casts the previous resource to EventLocation.", + "get": { + "tags": [ + "People.Person.Location" + ], + "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection", + "operationId": "People.Friends.GetHomeAddress.AsEventLocation", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager": { + "description": "Casts the previous resource to Manager.", + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager", + "operationId": "People.GetFriends.AsManager", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, + { + "name": "$select", + "in": "query", + "description": "Select properties to be returned", + "style": "form", + "explode": false, + "schema": { + "uniqueItems": true, + "type": "array", + "items": { + "type": "string" + } + } + }, + { + "name": "$expand", + "in": "query", + "description": "Expand related entities", + "style": "form", + "explode": false, + "schema": { + "uniqueItems": true, + "type": "array", + "items": { + "type": "string" + } + } + } + ], + "responses": { + "200": { + "description": "Result entities", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", "get": { "tags": [ - "People.Person.Location" + "People.Person" ], - "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection", - "operationId": "People.Friends.GetHomeAddress.AsEventLocation", + "summary": "Get Photo for the navigation property Friends from People", + "operationId": "People.GetFriendsPhoto", "parameters": [ { "name": "UserName", @@ -21191,7 +23569,15 @@ ], "responses": { "200": { - "$ref": "#/components/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } }, "default": { "$ref": "#/components/responses/error" @@ -21204,16 +23590,13 @@ "version": "2021-05/people", "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } - } - }, - "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager": { - "description": "Casts the previous resource to Manager.", - "get": { + }, + "put": { "tags": [ "People.Person" ], - "summary": "Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager", - "operationId": "People.GetFriends.AsManager", + "summary": "Update Photo for the navigation property Friends in People", + "operationId": "People.UpdateFriendsPhoto", "parameters": [ { "name": "UserName", @@ -21234,47 +23617,24 @@ "type": "string" }, "x-ms-docs-key-type": "Person" - }, - { - "name": "$select", - "in": "query", - "description": "Select properties to be returned", - "style": "form", - "explode": false, - "schema": { - "uniqueItems": true, - "type": "array", - "items": { - "type": "string" - } - } - }, - { - "name": "$expand", - "in": "query", - "description": "Expand related entities", - "style": "form", - "explode": false, - "schema": { - "uniqueItems": true, - "type": "array", - "items": { - "type": "string" - } - } } ], - "responses": { - "200": { - "description": "Result entities", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager" - } + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" } } }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, "default": { "$ref": "#/components/responses/error" } @@ -21307,6 +23667,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -21338,6 +23712,7 @@ "People.Person" ], "summary": "Get ref of Friends from People", + "description": "Friends of person", "operationId": "People.AsEmployee.ListRefFriends", "parameters": [ { @@ -21350,6 +23725,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -21507,6 +23896,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -21601,6 +24004,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -22190,6 +24607,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -22287,6 +24718,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -22370,14 +24815,116 @@ ], "responses": { "200": { - "description": "Result entities", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" - } - } - } + "description": "Result entities", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "patch": { + "tags": [ + "People.Person.Location" + ], + "summary": "Update property HomeAddress value.", + "operationId": "People.AsEmployee.Peers.UpdateHomeAddress", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New property values", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation": { + "description": "Casts the previous resource to EventLocation.", + "get": { + "tags": [ + "People.Person.Location" + ], + "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection", + "operationId": "People.Peers.GetHomeAddress.AsEventLocation", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "$ref": "#/components/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" }, "default": { "$ref": "#/components/responses/error" @@ -22390,13 +24937,16 @@ "version": "2021-05/people", "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } - }, - "patch": { + } + }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { "tags": [ - "People.Person.Location" + "People.Person" ], - "summary": "Update property HomeAddress value.", - "operationId": "People.AsEmployee.Peers.UpdateHomeAddress", + "summary": "Get Photo for the navigation property Peers from People", + "operationId": "People.GetPeersPhoto", "parameters": [ { "name": "UserName", @@ -22419,21 +24969,18 @@ "x-ms-docs-key-type": "Person" } ], - "requestBody": { - "description": "New property values", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location" + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } } } }, - "required": true - }, - "responses": { - "204": { - "description": "Success" - }, "default": { "$ref": "#/components/responses/error" } @@ -22445,16 +24992,13 @@ "version": "2021-05/people", "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." } - } - }, - "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/HomeAddress/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation": { - "description": "Casts the previous resource to EventLocation.", - "get": { + }, + "put": { "tags": [ - "People.Person.Location" + "People.Person" ], - "summary": "Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocation in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location collection", - "operationId": "People.Peers.GetHomeAddress.AsEventLocation", + "summary": "Update Photo for the navigation property Peers in People", + "operationId": "People.UpdatePeersPhoto", "parameters": [ { "name": "UserName", @@ -22477,9 +25021,21 @@ "x-ms-docs-key-type": "Person" } ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, "responses": { - "200": { - "$ref": "#/components/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse" + "204": { + "description": "Success" }, "default": { "$ref": "#/components/responses/error" @@ -22702,6 +25258,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.ListTrips", "parameters": [ { @@ -22809,6 +25369,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.CreateTrips", "parameters": [ { @@ -22870,6 +25434,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.GetTrips", "parameters": [ { @@ -22954,6 +25522,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.UpdateTrips", "parameters": [ { @@ -23014,6 +25586,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "People.AsEmployee.DeleteTrips", "parameters": [ { @@ -25138,6 +27714,97 @@ } } }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property BestFriend from People", + "operationId": "People.GetBestFriendPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property BestFriend in People", + "operationId": "People.UpdateBestFriendPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports": { "description": "Provides operations to manage the DirectReports property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager entity.", "get": { @@ -25882,6 +28549,117 @@ } } }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/{UserName1}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property DirectReports from People", + "operationId": "People.GetDirectReportsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property DirectReports in People", + "operationId": "People.UpdateDirectReportsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/$count": { "description": "Provides operations to count the resources in the collection.", "get": { @@ -26089,6 +28867,7 @@ "People.Person" ], "summary": "Get Friends from People", + "description": "Friends of person", "operationId": "People.AsManager.ListFriends", "parameters": [ { @@ -26101,6 +28880,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -26831,6 +29624,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "name": "$select", "in": "query", @@ -26884,6 +29691,117 @@ } } }, + "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/{UserName1}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get Photo for the navigation property Friends from People", + "operationId": "People.GetFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update Photo for the navigation property Friends in People", + "operationId": "People.UpdateFriendsPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + }, + { + "name": "UserName1", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, "/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count": { "description": "Provides operations to count the resources in the collection.", "get": { @@ -26903,6 +29821,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -26934,6 +29866,7 @@ "People.Person" ], "summary": "Get ref of Friends from People", + "description": "Friends of person", "operationId": "People.AsManager.ListRefFriends", "parameters": [ { @@ -26946,6 +29879,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -27103,6 +30050,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/top" }, @@ -27197,6 +30158,20 @@ }, "x-ms-docs-key-type": "Person" }, + { + "name": "ConsistencyLevel", + "in": "header", + "description": "Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries", + "schema": { + "type": "string" + }, + "examples": { + "example-1": { + "description": "$search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'.", + "value": "eventual" + } + } + }, { "$ref": "#/components/parameters/search" }, @@ -27445,6 +30420,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.ListTrips", "parameters": [ { @@ -27552,6 +30531,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.CreateTrips", "parameters": [ { @@ -27613,6 +30596,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.GetTrips", "parameters": [ { @@ -27697,6 +30684,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.UpdateTrips", "parameters": [ { @@ -27757,6 +30748,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "People.AsManager.DeleteTrips", "parameters": [ { @@ -28523,6 +31518,107 @@ "x-ms-docs-operation-type": "function" } }, + "/People/{UserName}/Photo": { + "description": "Provides operations to manage the media for the Person entity.", + "get": { + "tags": [ + "People.Person" + ], + "summary": "Get photo", + "description": "Get photo of a specific user", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-get-photo?view=graph-rest-1.0" + }, + "operationId": "People.Person.GetPhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "responses": { + "200": { + "description": "Retrieved media content", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + }, + "put": { + "tags": [ + "People.Person" + ], + "summary": "Update photo", + "description": "Update photo of a specific user", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/person-update-photo?view=graph-rest-1.0" + }, + "operationId": "People.Person.UpdatePhoto", + "parameters": [ + { + "name": "UserName", + "in": "path", + "description": "The unique identifier of Person", + "required": true, + "schema": { + "type": "string" + }, + "x-ms-docs-key-type": "Person" + } + ], + "requestBody": { + "description": "New media content.", + "content": { + "application/octet-stream": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "required": true + }, + "responses": { + "204": { + "description": "Success" + }, + "default": { + "$ref": "#/components/responses/error" + } + }, + "deprecated": true, + "x-ms-deprecation": { + "removalDate": "2023-03-15T00:00:00.0000000+00:00", + "date": "2021-08-24T00:00:00.0000000+00:00", + "version": "2021-05/people", + "description": "The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API." + } + } + }, "/People/{UserName}/Trips": { "description": "Provides operations to manage the Trips property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity.", "get": { @@ -28531,6 +31627,10 @@ ], "summary": "List trips.", "description": "Retrieve a list of trips.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0" + }, "operationId": "People.ListTrips", "parameters": [ { @@ -28638,6 +31738,10 @@ ], "summary": "Create a trip.", "description": "Create a new trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0" + }, "operationId": "People.CreateTrips", "parameters": [ { @@ -28699,6 +31803,10 @@ ], "summary": "Get a trip.", "description": "Retrieve the properties of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0" + }, "operationId": "People.GetTrips", "parameters": [ { @@ -28783,6 +31891,10 @@ ], "summary": "Update a trip.", "description": "Update an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0" + }, "operationId": "People.UpdateTrips", "parameters": [ { @@ -28843,6 +31955,10 @@ ], "summary": "Delete a trip.", "description": "Delete an instance of a trip.", + "externalDocs": { + "description": "Find more info here", + "url": "https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0" + }, "operationId": "People.DeleteTrips", "parameters": [ { @@ -29946,11 +33062,17 @@ "$ref": "#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature" } }, + "Photo": { + "type": "string", + "format": "base64url", + "nullable": true + }, "Friends": { "type": "array", "items": { "$ref": "#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person" }, + "description": "Friends of person", "x-ms-navigationProperty": true }, "BestFriend": { @@ -31189,6 +34311,7 @@ }, "LastName": "String", "MiddleName": "String", + "Photo": "Stream", "Trips": [ { "@odata.type": "Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip" diff --git a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.yaml b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.yaml index 1353276f..f4c91d25 100644 --- a/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.yaml +++ b/test/Microsoft.OpenAPI.OData.Reader.Tests/Resources/TripService.OpenApi.yaml @@ -802,6 +802,57 @@ paths: $ref: '#/components/responses/Microsoft.OData.Service.Sample.TrippinInMemory.Models.EventLocationCollectionResponse' default: $ref: '#/components/responses/error' + '/Airports/{IcaoCode}/Location/EmergencyAuthority/Photo': + description: Provides operations to manage the media for the Airport entity. + get: + tags: + - Airports.Person + summary: Get Photo for the navigation property EmergencyAuthority from Airports + operationId: Airports.GetEmergencyAuthorityPhoto + parameters: + - name: IcaoCode + in: path + description: The unique identifier of Airport + required: true + schema: + type: string + x-ms-docs-key-type: Airport + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + put: + tags: + - Airports.Person + summary: Update Photo for the navigation property EmergencyAuthority in Airports + operationId: Airports.UpdateEmergencyAuthorityPhoto + parameters: + - name: IcaoCode + in: path + description: The unique identifier of Airport + required: true + schema: + type: string + x-ms-docs-key-type: Airport + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' /Airports/$count: description: Provides operations to count the resources in the collection. get: @@ -882,7 +933,8 @@ paths: get: tags: - Me.Person - summary: Get Me + summary: Get signed in person + description: Retrieve the properties and relationships of Person object. operationId: Me.Person.GetPerson parameters: - name: $select @@ -1594,14 +1646,71 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + /Me/BestFriend/Photo: + description: Provides operations to manage the media for the Person entity. + get: + tags: + - Me.Person + summary: Get Photo for the navigation property BestFriend from Me + operationId: Me.GetBestFriendPhoto + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property BestFriend in Me + operationId: Me.UpdateBestFriendPhoto + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. /Me/Friends: description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. get: tags: - Me.Person summary: Get Friends from Me + description: Friends of person operationId: Me.ListFriends parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -2019,6 +2128,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -2069,6 +2187,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -2104,6 +2231,69 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + '/Me/Friends/{UserName}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - Me.Person + summary: Get Photo for the navigation property Friends from Me + operationId: Me.GetFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property Friends in Me + operationId: Me.UpdateFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. /Me/Friends/$count: description: Provides operations to count the resources in the collection. get: @@ -2112,6 +2302,15 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount-182b parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -2131,8 +2330,18 @@ paths: tags: - Me.Person summary: Get ref of Friends from Me + description: Friends of person operationId: Me.ListRefFriends parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -2216,6 +2425,15 @@ paths: summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection operationId: Me.ListFriends.AsEmployee parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -2270,6 +2488,15 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount.AsEmployee-884b parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -2291,6 +2518,15 @@ paths: summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection operationId: Me.ListFriends.AsManager parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -2345,6 +2581,15 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount.AsManager-9376 parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -2604,6 +2849,15 @@ paths: summary: Get the number of the resource operationId: Me.AsEmployee.AddressInfo.GetCount-8488 parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -2641,6 +2895,15 @@ paths: summary: Get the number of the resource operationId: Me.AddressInfo.GetCount.AsEventLocation-9375 parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -2914,6 +3177,15 @@ paths: summary: Get the number of the resource operationId: Me.AsEmployee.BestFriend.AddressInfo.GetCount-81de parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -2951,6 +3223,15 @@ paths: summary: Get the number of the resource operationId: Me.BestFriend.AddressInfo.GetCount.AsEventLocation-842c parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -3090,36 +3371,93 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. - /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends: - description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. + /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/BestFriend/Photo: + description: Provides operations to manage the media for the Person entity. get: tags: - Me.Person - summary: Get Friends from Me - operationId: Me.AsEmployee.ListFriends - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false - schema: - uniqueItems: true + summary: Get Photo for the navigation property BestFriend from Me + operationId: Me.GetBestFriendPhoto + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property BestFriend in Me + operationId: Me.UpdateBestFriendPhoto + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends: + description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. + get: + tags: + - Me.Person + summary: Get Friends from Me + description: Friends of person + operationId: Me.AsEmployee.ListFriends + parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false + schema: + uniqueItems: true type: array items: type: string @@ -3329,6 +3667,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -3381,6 +3728,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -3515,6 +3871,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -3550,6 +3915,69 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - Me.Person + summary: Get Photo for the navigation property Friends from Me + operationId: Me.GetFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property Friends in Me + operationId: Me.UpdateFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$count: description: Provides operations to count the resources in the collection. get: @@ -3558,6 +3986,15 @@ paths: summary: Get the number of the resource operationId: Me.AsEmployee.Friends.GetCount-0cb7 parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -3577,8 +4014,18 @@ paths: tags: - Me.Person summary: Get ref of Friends from Me + description: Friends of person operationId: Me.AsEmployee.ListRefFriends parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -3662,6 +4109,15 @@ paths: summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection operationId: Me.ListFriends.AsManager parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -3716,6 +4172,15 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount.AsManager-85ff parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -4048,6 +4513,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -4100,6 +4574,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -4219,6 +4702,69 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - Me.Person + summary: Get Photo for the navigation property Peers from Me + operationId: Me.GetPeersPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property Peers in Me + operationId: Me.UpdatePeersPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/$count: description: Provides operations to count the resources in the collection. get: @@ -4330,6 +4876,9 @@ paths: - Me.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.ListTrips parameters: - name: ConsistencyLevel @@ -4393,6 +4942,9 @@ paths: - Me.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.CreateTrips requestBody: description: New navigation property @@ -4427,6 +4979,9 @@ paths: - Me.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.GetTrips parameters: - name: TripId @@ -4480,6 +5035,9 @@ paths: - Me.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.UpdateTrips parameters: - name: TripId @@ -4516,6 +5074,9 @@ paths: - Me.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: Me.AsEmployee.DeleteTrips parameters: - name: TripId @@ -5700,21 +6261,68 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. - /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports: - description: Provides operations to manage the DirectReports property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager entity. + /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Photo: + description: Provides operations to manage the media for the Person entity. get: tags: - Me.Person - summary: Get DirectReports from Me - operationId: Me.AsManager.ListDirectReports - parameters: - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query + summary: Get Photo for the navigation property BestFriend from Me + operationId: Me.GetBestFriendPhoto + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property BestFriend in Me + operationId: Me.UpdateBestFriendPhoto + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports: + description: Provides operations to manage the DirectReports property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager entity. + get: + tags: + - Me.Person + summary: Get DirectReports from Me + operationId: Me.AsManager.ListDirectReports + parameters: + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query description: Order items by property values style: form explode: false @@ -6125,6 +6733,69 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/{UserName}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - Me.Person + summary: Get Photo for the navigation property DirectReports from Me + operationId: Me.GetDirectReportsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property DirectReports in Me + operationId: Me.UpdateDirectReportsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/$count: description: Provides operations to count the resources in the collection. get: @@ -6235,8 +6906,18 @@ paths: tags: - Me.Person summary: Get Friends from Me + description: Friends of person operationId: Me.AsManager.ListFriends parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -6654,6 +7335,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -6689,6 +7379,69 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + '/Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/{UserName}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - Me.Person + summary: Get Photo for the navigation property Friends from Me + operationId: Me.GetFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for the navigation property Friends in Me + operationId: Me.UpdateFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. /Me/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count: description: Provides operations to count the resources in the collection. get: @@ -6697,6 +7450,15 @@ paths: summary: Get the number of the resource operationId: Me.AsManager.Friends.GetCount-60a7 parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -6716,8 +7478,18 @@ paths: tags: - Me.Person summary: Get ref of Friends from Me + description: Friends of person operationId: Me.AsManager.ListRefFriends parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -6801,6 +7573,15 @@ paths: summary: Get the items of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee in the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person collection operationId: Me.ListFriends.AsEmployee parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -6855,6 +7636,15 @@ paths: summary: Get the number of the resource operationId: Me.Friends.GetCount.AsEmployee-6a35 parameters: + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -6991,6 +7781,9 @@ paths: - Me.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: Me.AsManager.ListTrips parameters: - name: ConsistencyLevel @@ -7054,6 +7847,9 @@ paths: - Me.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: Me.AsManager.CreateTrips requestBody: description: New navigation property @@ -7088,6 +7884,9 @@ paths: - Me.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: Me.AsManager.GetTrips parameters: - name: TripId @@ -7141,6 +7940,9 @@ paths: - Me.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: Me.AsManager.UpdateTrips parameters: - name: TripId @@ -7177,6 +7979,9 @@ paths: - Me.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: Me.AsManager.DeleteTrips parameters: - name: TripId @@ -7623,6 +8428,53 @@ paths: version: 2021-05/me description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. x-ms-docs-operation-type: function + /Me/Photo: + description: Provides operations to manage the media for the Person entity. + get: + tags: + - Me.Person + summary: Get Photo for Person from Me + operationId: Me.Person.GetPhoto + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. + put: + tags: + - Me.Person + summary: Update Photo for Person in Me + operationId: Me.Person.UpdatePhoto + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/me + description: The Me API is deprecated and will stop returning data on March 2023. Please use the new me2 API. /Me/Trips: description: Provides operations to manage the Trips property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. get: @@ -7630,6 +8482,9 @@ paths: - Me.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: Me.ListTrips parameters: - name: ConsistencyLevel @@ -7693,6 +8548,9 @@ paths: - Me.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: Me.CreateTrips requestBody: description: New navigation property @@ -7727,6 +8585,9 @@ paths: - Me.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: Me.GetTrips parameters: - name: TripId @@ -7780,6 +8641,9 @@ paths: - Me.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: Me.UpdateTrips parameters: - name: TripId @@ -7816,6 +8680,9 @@ paths: - Me.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: Me.DeleteTrips parameters: - name: TripId @@ -9188,13 +10055,13 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/bestfriend description: The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API. - '/NewComePeople/{UserName}/Friends': - description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. + '/NewComePeople/{UserName}/BestFriend/Photo': + description: Provides operations to manage the media for the Person entity. get: tags: - NewComePeople.Person - summary: Get Friends from NewComePeople - operationId: NewComePeople.ListFriends + summary: Get Photo for the navigation property BestFriend from NewComePeople + operationId: NewComePeople.GetBestFriendPhoto parameters: - name: UserName in: path @@ -9203,26 +10070,99 @@ paths: schema: type: string x-ms-docs-key-type: Person - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true - type: array - items: - type: string - - name: $select - in: query - description: Select properties to be returned - style: form - explode: false + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/bestfriend + description: The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API. + put: + tags: + - NewComePeople.Person + summary: Update Photo for the navigation property BestFriend in NewComePeople + operationId: NewComePeople.UpdateBestFriendPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/bestfriend + description: The bestfriend API is deprecated and will stop returning data on March 2023. Please use the new friends API. + '/NewComePeople/{UserName}/Friends': + description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. + get: + tags: + - NewComePeople.Person + summary: Get Friends from NewComePeople + description: Friends of person + operationId: NewComePeople.ListFriends + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true + type: array + items: + type: string + - name: $select + in: query + description: Select properties to be returned + style: form + explode: false schema: uniqueItems: true type: array @@ -9646,6 +10586,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -9697,6 +10646,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -9726,6 +10684,71 @@ paths: $ref: '#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager' default: $ref: '#/components/responses/error' + '/NewComePeople/{UserName}/Friends/{UserName1}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - NewComePeople.Person + summary: Get Photo for the navigation property Friends from NewComePeople + operationId: NewComePeople.GetFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + put: + tags: + - NewComePeople.Person + summary: Update Photo for the navigation property Friends in NewComePeople + operationId: NewComePeople.UpdateFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' '/NewComePeople/{UserName}/Friends/$count': description: Provides operations to count the resources in the collection. get: @@ -9741,6 +10764,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -9754,6 +10786,7 @@ paths: tags: - NewComePeople.Person summary: Get ref of Friends from NewComePeople + description: Friends of person operationId: NewComePeople.ListRefFriends parameters: - name: UserName @@ -9763,6 +10796,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -9850,6 +10892,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -9905,6 +10956,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -9927,6 +10987,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -9982,6 +11051,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -10275,6 +11353,57 @@ paths: default: $ref: '#/components/responses/error' x-ms-docs-operation-type: function + '/NewComePeople/{UserName}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - NewComePeople.Person + summary: Get Photo for Person from NewComePeople + operationId: NewComePeople.Person.GetPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + put: + tags: + - NewComePeople.Person + summary: Update Photo for Person in NewComePeople + operationId: NewComePeople.Person.UpdatePhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' '/NewComePeople/{UserName}/Trips': description: Provides operations to manage the Trips property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. get: @@ -10282,6 +11411,9 @@ paths: - NewComePeople.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: NewComePeople.ListTrips parameters: - name: UserName @@ -10346,6 +11478,9 @@ paths: - NewComePeople.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: NewComePeople.CreateTrips parameters: - name: UserName @@ -10379,6 +11514,9 @@ paths: - NewComePeople.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: NewComePeople.GetTrips parameters: - name: UserName @@ -10433,6 +11571,9 @@ paths: - NewComePeople.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: NewComePeople.UpdateTrips parameters: - name: UserName @@ -10470,6 +11611,9 @@ paths: - NewComePeople.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: NewComePeople.DeleteTrips parameters: - name: UserName @@ -11863,7 +13007,11 @@ paths: get: tags: - People.Person - summary: Get the item of type Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person as Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager + summary: Get best friend + description: Get the item of type Person cast as Manager + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-get-friend-manager?view=graph-rest-1.0 operationId: People.GetBestFriend.AsManager parameters: - name: UserName @@ -11908,13 +13056,13 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. - '/People/{UserName}/Friends': - description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. + '/People/{UserName}/BestFriend/Photo': + description: Provides operations to manage the media for the Person entity. get: tags: - People.Person - summary: Get Friends from People - operationId: People.ListFriends + summary: Get Photo for the navigation property BestFriend from People + operationId: People.GetBestFriendPhoto parameters: - name: UserName in: path @@ -11923,18 +13071,94 @@ paths: schema: type: string x-ms-docs-key-type: Person - - $ref: '#/components/parameters/top' - - $ref: '#/components/parameters/skip' - - $ref: '#/components/parameters/search' - - $ref: '#/components/parameters/filter' - - $ref: '#/components/parameters/count' - - name: $orderby - in: query - description: Order items by property values - style: form - explode: false - schema: - uniqueItems: true + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property BestFriend in People + operationId: People.UpdateBestFriendPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + '/People/{UserName}/Friends': + description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. + get: + tags: + - People.Person + summary: List friends + description: List the friends of a specific person + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0 + operationId: People.ListFriends + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual + - $ref: '#/components/parameters/top' + - $ref: '#/components/parameters/skip' + - $ref: '#/components/parameters/search' + - $ref: '#/components/parameters/filter' + - $ref: '#/components/parameters/count' + - name: $orderby + in: query + description: Order items by property values + style: form + explode: false + schema: + uniqueItems: true type: array items: type: string @@ -11978,7 +13202,11 @@ paths: delete: tags: - People.Person - summary: Delete ref of navigation property Friends for People + summary: Delete a friend. + description: Delete an instance of a friend relationship. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0 operationId: People.friends.DeleteRefPerson parameters: - name: UserName @@ -12417,6 +13645,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -12474,6 +13711,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -12509,6 +13755,83 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + '/People/{UserName}/Friends/{UserName1}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - People.Person + summary: Get Photo for the navigation property Friends from People + operationId: People.GetFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property Friends in People + operationId: People.UpdateFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. '/People/{UserName}/Friends/$count': description: Provides operations to count the resources in the collection. get: @@ -12524,6 +13847,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -12542,7 +13874,11 @@ paths: get: tags: - People.Person - summary: Get ref of Friends from People + summary: List friends + description: List the friends of a specific person + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-list-friends?view=graph-rest-1.0 operationId: People.ListRefFriends parameters: - name: UserName @@ -12552,6 +13888,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -12582,7 +13927,11 @@ paths: post: tags: - People.Person - summary: Create new navigation property ref to Friends for People + summary: Create a friend. + description: Create a new friend. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-post-friend?view=graph-rest-1.0 operationId: People.CreateRefFriends parameters: - name: UserName @@ -12609,7 +13958,11 @@ paths: delete: tags: - People.Person - summary: Delete ref of navigation property Friends for People + summary: Delete a friend. + description: Delete an instance of a friend relationship. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-delete-friend?view=graph-rest-1.0 operationId: People.DeleteRefFriends parameters: - name: UserName @@ -12657,6 +14010,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -12718,6 +14080,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -12746,6 +14117,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -12807,6 +14187,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -12824,7 +14213,8 @@ paths: get: tags: - People.Location - summary: Get HomeAddress property value + summary: Get home address + description: Get the home address of a specific person operationId: People.GetHomeAddress parameters: - name: UserName @@ -13134,6 +14524,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -13186,6 +14585,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -13526,6 +14934,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -13578,6 +14995,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -13747,12 +15173,76 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/BestFriend/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - People.Person + summary: Get Photo for the navigation property BestFriend from People + operationId: People.GetBestFriendPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property BestFriend in People + operationId: People.UpdateBestFriendPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends': description: Provides operations to manage the Friends property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. get: tags: - People.Person summary: Get Friends from People + description: Friends of person operationId: People.AsEmployee.ListFriends parameters: - name: UserName @@ -13762,6 +15252,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -14028,6 +15527,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -14094,6 +15602,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -14256,6 +15773,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -14291,6 +15817,83 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/{UserName1}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - People.Person + summary: Get Photo for the navigation property Friends from People + operationId: People.GetFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property Friends in People + operationId: People.UpdateFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Friends/$count': description: Provides operations to count the resources in the collection. get: @@ -14306,6 +15909,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -14325,6 +15937,7 @@ paths: tags: - People.Person summary: Get ref of Friends from People + description: Friends of person operationId: People.AsEmployee.ListRefFriends parameters: - name: UserName @@ -14334,6 +15947,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -14439,6 +16061,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -14500,6 +16131,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -14897,6 +16537,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -14963,6 +16612,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -15103,6 +16761,83 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/{UserName1}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - People.Person + summary: Get Photo for the navigation property Peers from People + operationId: People.GetPeersPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property Peers in People + operationId: People.UpdatePeersPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee/Peers/$count': description: Provides operations to count the resources in the collection. get: @@ -15243,6 +16978,9 @@ paths: - People.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: People.AsEmployee.ListTrips parameters: - name: UserName @@ -15313,6 +17051,9 @@ paths: - People.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: People.AsEmployee.CreateTrips parameters: - name: UserName @@ -15355,6 +17096,9 @@ paths: - People.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: People.AsEmployee.GetTrips parameters: - name: UserName @@ -15415,6 +17159,9 @@ paths: - People.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: People.AsEmployee.UpdateTrips parameters: - name: UserName @@ -15458,6 +17205,9 @@ paths: - People.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: People.AsEmployee.DeleteTrips parameters: - name: UserName @@ -16881,17 +18631,80 @@ paths: style: form explode: false schema: - uniqueItems: true - type: array - items: + uniqueItems: true + type: array + items: + type: string + responses: + '200': + description: Result entities + content: + application/json: + schema: + $ref: '#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee' + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/BestFriend/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - People.Person + summary: Get Photo for the navigation property BestFriend from People + operationId: People.GetBestFriendPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property BestFriend in People + operationId: People.UpdateBestFriendPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: type: string + format: binary + required: true responses: - '200': - description: Result entities - content: - application/json: - schema: - $ref: '#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Employee' + '204': + description: Success default: $ref: '#/components/responses/error' deprecated: true @@ -17402,6 +19215,83 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/{UserName1}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - People.Person + summary: Get Photo for the navigation property DirectReports from People + operationId: People.GetDirectReportsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property DirectReports in People + operationId: People.UpdateDirectReportsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/DirectReports/$count': description: Provides operations to count the resources in the collection. get: @@ -17541,6 +19431,7 @@ paths: tags: - People.Person summary: Get Friends from People + description: Friends of person operationId: People.AsManager.ListFriends parameters: - name: UserName @@ -17550,6 +19441,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -18044,6 +19944,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - name: $select in: query description: Select properties to be returned @@ -18079,6 +19988,83 @@ paths: date: '2021-08-24T00:00:00.0000000+00:00' version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/{UserName1}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - People.Person + summary: Get Photo for the navigation property Friends from People + operationId: People.GetFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update Photo for the navigation property Friends in People + operationId: People.UpdateFriendsPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + - name: UserName1 + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. '/People/{UserName}/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Manager/Friends/$count': description: Provides operations to count the resources in the collection. get: @@ -18094,6 +20080,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -18113,6 +20108,7 @@ paths: tags: - People.Person summary: Get ref of Friends from People + description: Friends of person operationId: People.AsManager.ListRefFriends parameters: - name: UserName @@ -18122,6 +20118,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -18227,6 +20232,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/top' - $ref: '#/components/parameters/skip' - $ref: '#/components/parameters/search' @@ -18288,6 +20302,15 @@ paths: schema: type: string x-ms-docs-key-type: Person + - name: ConsistencyLevel + in: header + description: 'Indicates the requested consistency level. Documentation URL: https://docs.microsoft.com/graph/aad-advanced-queries' + schema: + type: string + examples: + example-1: + description: $search and $count queries require the client to set the ConsistencyLevel HTTP header to 'eventual'. + value: eventual - $ref: '#/components/parameters/search' - $ref: '#/components/parameters/filter' responses: @@ -18455,6 +20478,9 @@ paths: - People.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: People.AsManager.ListTrips parameters: - name: UserName @@ -18525,6 +20551,9 @@ paths: - People.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: People.AsManager.CreateTrips parameters: - name: UserName @@ -18567,6 +20596,9 @@ paths: - People.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: People.AsManager.GetTrips parameters: - name: UserName @@ -18627,6 +20659,9 @@ paths: - People.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: People.AsManager.UpdateTrips parameters: - name: UserName @@ -18670,6 +20705,9 @@ paths: - People.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: People.AsManager.DeleteTrips parameters: - name: UserName @@ -19194,6 +21232,77 @@ paths: version: 2021-05/people description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. x-ms-docs-operation-type: function + '/People/{UserName}/Photo': + description: Provides operations to manage the media for the Person entity. + get: + tags: + - People.Person + summary: Get photo + description: Get photo of a specific user + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-get-photo?view=graph-rest-1.0 + operationId: People.Person.GetPhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + responses: + '200': + description: Retrieved media content + content: + application/octet-stream: + schema: + type: string + format: binary + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. + put: + tags: + - People.Person + summary: Update photo + description: Update photo of a specific user + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/person-update-photo?view=graph-rest-1.0 + operationId: People.Person.UpdatePhoto + parameters: + - name: UserName + in: path + description: The unique identifier of Person + required: true + schema: + type: string + x-ms-docs-key-type: Person + requestBody: + description: New media content. + content: + application/octet-stream: + schema: + type: string + format: binary + required: true + responses: + '204': + description: Success + default: + $ref: '#/components/responses/error' + deprecated: true + x-ms-deprecation: + removalDate: '2023-03-15T00:00:00.0000000+00:00' + date: '2021-08-24T00:00:00.0000000+00:00' + version: 2021-05/people + description: The People API is deprecated and will stop returning data on March 2023. Please use the new newPeople API. '/People/{UserName}/Trips': description: Provides operations to manage the Trips property of the Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person entity. get: @@ -19201,6 +21310,9 @@ paths: - People.Trip summary: List trips. description: Retrieve a list of trips. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-list-trips?view=graph-rest-1.0 operationId: People.ListTrips parameters: - name: UserName @@ -19271,6 +21383,9 @@ paths: - People.Trip summary: Create a trip. description: Create a new trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-post-trips?view=graph-rest-1.0 operationId: People.CreateTrips parameters: - name: UserName @@ -19313,6 +21428,9 @@ paths: - People.Trip summary: Get a trip. description: Retrieve the properties of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-get-trips?view=graph-rest-1.0 operationId: People.GetTrips parameters: - name: UserName @@ -19373,6 +21491,9 @@ paths: - People.Trip summary: Update a trip. description: Update an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-update-trips?view=graph-rest-1.0 operationId: People.UpdateTrips parameters: - name: UserName @@ -19416,6 +21537,9 @@ paths: - People.Trip summary: Delete a trip. description: Delete an instance of a trip. + externalDocs: + description: Find more info here + url: https://learn.microsoft.com/graph/api/user-delete-trips?view=graph-rest-1.0 operationId: People.DeleteTrips parameters: - name: UserName @@ -20151,10 +22275,15 @@ components: type: array items: $ref: '#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Feature' + Photo: + type: string + format: base64url + nullable: true Friends: type: array items: $ref: '#/components/schemas/Microsoft.OData.Service.Sample.TrippinInMemory.Models.Person' + description: Friends of person x-ms-navigationProperty: true BestFriend: anyOf: @@ -20933,6 +23062,7 @@ components: '@odata.type': Microsoft.OData.Service.Sample.TrippinInMemory.Models.Location LastName: String MiddleName: String + Photo: Stream Trips: - '@odata.type': Microsoft.OData.Service.Sample.TrippinInMemory.Models.Trip UserName: String (identifier)