[httpapi] Scope of deprecation header

Darrel Miller <Darrel.Miller@microsoft.com> Thu, 03 December 2020 02:07 UTC

Return-Path: <Darrel.Miller@microsoft.com>
X-Original-To: httpapi@ietfa.amsl.com
Delivered-To: httpapi@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 6615B3A07EB for <httpapi@ietfa.amsl.com>; Wed, 2 Dec 2020 18:07:44 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.101
X-Spam-Level:
X-Spam-Status: No, score=-2.101 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.001, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=microsoft.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id SHxUZDPzBWrY for <httpapi@ietfa.amsl.com>; Wed, 2 Dec 2020 18:07:42 -0800 (PST)
Received: from NAM06-BL2-obe.outbound.protection.outlook.com (mail-eopbgr650109.outbound.protection.outlook.com [40.107.65.109]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 3043C3A07F0 for <httpapi@ietf.org>; Wed, 2 Dec 2020 18:07:41 -0800 (PST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=gaajDOlJNt/oKaIAvl0Iot3EvaBe2zc3AiICTFlQ7jzYCYUCRbiBG9Ely2+rXNkLhpFtWaCIXrlBC4CJmBHOOCSOsjCXVmXyEPmfY5USY+AZF78vWpRr7Z8cPvTjQslHEtYsrsbuuxHT+hqdz29d6eCcHAby9lWyao10m7lobwPo3/GnvsoHYErG1WF6urQEBXwxflMwYeaqndODEsKvuG+Ltu+KTuqtgLaZfp9LNgsNydIVdHWD+3IcwN7MoqYz3pcKiSnl10WR0JD92MEvvktIpDDty4cUGyRYCsmmTBdjsLzkWGdzeMXpEqcauj/N6LiEnek6AGG9wnTHqypJPg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Kzn9cxuQ1bzlnFdyuAGZ1l7mnESjcvdPTaqYIjbc5dU=; b=FR9KCOCP7qHPQDp9KxNap0VtA0ynwTQCK52uvz70KKAOnhKU0FWT7QiIVzIYsa54XjGA67XPRLn34qaNa8yahkQ1g9hPDKR00J6+CkdtkDQEXEKd56Pk9cjNNny79JvreOgLoI0gJ3IwbLLwZ/4BzK7sKmvLV0j7+cPj+itvJfrZ0lkJ9xmiBwQ0CUHPgAGr+OR80P+YTGhz+JMPb59BlVwCpyQMM89E4cFOObDnlste8RagtX07PZ4K0DJV6qEefGyMiRJ4g6SiKwRVSFiQFWbXxPmPIFAzU3sKnkEL3J0/Xq6HtZPULPJff5agGWgS6o+A16TXNTwIUFQjkl2e3A==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=microsoft.com; dmarc=pass action=none header.from=microsoft.com; dkim=pass header.d=microsoft.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=Kzn9cxuQ1bzlnFdyuAGZ1l7mnESjcvdPTaqYIjbc5dU=; b=a5bLqcIQLVXpRZM4ZtB0AespnoX0d4Q9iRCpc8xaC5ivk9OS2rovlyuQfmeM8xhJCsC2XgSYeSREyLcaArKIUwyEPrlhXI1uXqm6wUtAz5AbVAwiMZBR/1bcwSnZ1VyubVHXRkapITHBDl/9vLqTpcRorODRyBJrDRWtivfGQts=
Received: from (2603:10b6:610:6f::7) by CH2PR00MB0678.namprd00.prod.outlook.com (2603:10b6:610:a9::23) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3674.0; Thu, 3 Dec 2020 02:07:40 +0000
Received: from CH2PR00MB0842.namprd00.prod.outlook.com ([fe80::293c:2cbf:2cb6:528b]) by CH2PR00MB0842.namprd00.prod.outlook.com ([fe80::293c:2cbf:2cb6:528b%7]) with mapi id 15.20.3675.000; Thu, 3 Dec 2020 02:07:40 +0000
From: Darrel Miller <Darrel.Miller@microsoft.com>
To: "httpapi@ietf.org" <httpapi@ietf.org>
Thread-Topic: Scope of deprecation header
Thread-Index: AQHWyRGwQKfBpqLfTEeaNHdmagvuyA==
Date: Thu, 03 Dec 2020 02:07:39 +0000
Message-ID: <CH2PR00MB0842A4B482CA4E290BFA772CF0F29@CH2PR00MB0842.namprd00.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
msip_labels: MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Enabled=True; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_SiteId=72f988bf-86f1-41af-91ab-2d7cd011db47; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_SetDate=2020-12-03T01:14:47.5101095Z; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_ContentBits=0; MSIP_Label_f42aa342-8706-4288-bd11-ebb85995028c_Method=Privileged
authentication-results: ietf.org; dkim=none (message not signed) header.d=none;ietf.org; dmarc=none action=none header.from=microsoft.com;
x-originating-ip: [74.15.147.35]
x-ms-publictraffictype: Email
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: f216b10b-6600-406e-0303-08d89730366e
x-ms-traffictypediagnostic: CH2PR00MB0678:
x-microsoft-antispam-prvs: <CH2PR00MB0678B22C1B5EEEE73BE1FB22F0F29@CH2PR00MB0678.namprd00.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:9508;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: ACw4akngI152BQSL1KkDcHxBPFmXU24euhIrAWpgVwMNtCfh6NXiqR1fuBNilZAsfTcMin1v0/eraGGdTfL3nBm/jvBFTJTAYxRAB0/4qpjPvyXrmU82MfAKCsVIHRCs4sGrzvWZwsI7tj0CkkU2xWzM0AsNU78YSsgroFZyra3JarjIMIBFg1j7+sQfg+PAErYlqH67fhoeMT4nym+GLdBF3V2fhfT3zNcxdVhYhRO4qU4sudOmc4kbYYu/jIZiGVMDBIR4wiFb39W4pqA1tnPHfaClKYMyXXoYgMmGg6wwnwzooMvGxv0+6FBk3kgD9HwDKfq1uME28stHVoj5xJ+vB8kPhb9hNHSQejSCySwImdixL9Cu8uwQTn33Dgv9m5+6rYk3CMgqP9BU4QtW1uKP88ovNT8qL1Q5XqpHjE7enqhQ6N3OtETKJ27oMM6u
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:CH2PR00MB0842.namprd00.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(396003)(346002)(39860400002)(376002)(136003)(366004)(5660300002)(6916009)(316002)(52536014)(8676002)(3480700007)(82960400001)(82950400001)(186003)(166002)(9686003)(26005)(55016002)(8990500004)(91956017)(66476007)(64756008)(76116006)(66446008)(66946007)(66556008)(8936002)(71200400001)(6506007)(86362001)(33656002)(7696005)(83380400001)(966005)(478600001)(10290500003)(2906002); DIR:OUT; SFP:1102;
x-ms-exchange-antispam-messagedata: FK0Daus0f2pBMKeUBwdkGgB5Zn9G+W9tiLSIA5vtMC4rsDfrsSZ0NgZwjpg7YNfTlk0L6VxfvBFVAQcWG3AzY0SQKTMk+0b6NdU1KxpJEMwnRLRBh1CXIC/2MA4QDR8OtEpMldR9vrQUm1QB+VnDF+4mEgjlXU2zf4lAX6tsKxMTSx1IuJX3xm8Iu2S9BOPuX873TdXhqehpD7DO0uKSkXddEuiRxgtm7zAamUV8RElA5qj/i0w9isKRgVPqShTabrRzFUwydIDW3V9Y2dDakQ/92p7fu35ZrPX/AfzvkC+Lpbc8sp8uvQiy79eCXZ/ubqljsk6seUKKW/CxFYC4jJpFN6XFAW03dgF6L40nQwtn4JoSbcPaHGYMLczhI33pzsjgwFEXjGsJlrj4Ia7epuw8hlYx9fEmsAmziLwUvM7cR5WfvvICuKd0YyBh522EgEb/V6k3wS71VmrTFyAfPprHInQ/PL8eupeZ+/HUWQ1n1KFMB5e83XGa+Bl4c3CGCnSQXhav3Kt4jW9CWn91Rslofpa0aoqxRzNPFsfLn/ftwz1ILyJ5UyiWbpKXLhZPZ+wjc5yqwEgcxoYGShCSxS9LAwT1UO6c0EpdqwNHsP4XImUg+q5Fgw8/CpU8hmGRaRnnGX06Ae5oT6AqVb24nwuXVtvKUUMAmpLizFNdQN0sBpQBWbT4tVoMxNW6E3C3Gk1nc8sql899+NEgeC6ZZcpBp+Pl5fEGCTL9OjXNSH7wOhEOail8YbOC+qK5YSD99+m89dVCRvNK7KbCd4GNwLdOh6d3p1gxqlp1Eo5jQAUHoTrVCna1d22SbUBoihuiZXolf6jDd5WyIoyFXmp+2Qz8bkFKZrm5kpp5qkSRw1psdqM0plUsVXqiE3Xui9/BwAqFksKgbYLAHvoYITwoJj+RBwTy/OQp5ivMHnO9en3a3S6x4GLC4/svJs5DHMai4vOsIaISq2qv55a8aeh8ySDtRueyFBuNh97WcNETTzKZHw9Z4kbdj3eEqB0TOBZW19F9vM5kSF/KgZFnLO1xVxDLMjFsaaMWjZZpaTRE1rEWRKnc69TvfW0x0ZbCH3q+U9KM11ICIR4jJuK2Njohvg==
x-ms-exchange-transport-forked: True
Content-Type: multipart/alternative; boundary="_000_CH2PR00MB0842A4B482CA4E290BFA772CF0F29CH2PR00MB0842namp_"
MIME-Version: 1.0
X-OriginatorOrg: microsoft.com
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-AuthSource: CH2PR00MB0842.namprd00.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: f216b10b-6600-406e-0303-08d89730366e
X-MS-Exchange-CrossTenant-originalarrivaltime: 03 Dec 2020 02:07:39.9044 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 72f988bf-86f1-41af-91ab-2d7cd011db47
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: TkHGfnZgOP/coZwztqjWcVxrSTea9bbfNjrqhrK5N0Qm/8aNLFLWuRR3wzBjJlDXnf1icvOR6fOPpZoPjLsEUg==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: CH2PR00MB0678
Archived-At: <https://mailarchive.ietf.org/arch/msg/httpapi/4QExuktiyCOD6RKBBwsfzk6xecw>
Subject: [httpapi] Scope of deprecation header
X-BeenThere: httpapi@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Building Blocks for HTTP APIs <httpapi.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/httpapi>, <mailto:httpapi-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/httpapi/>
List-Post: <mailto:httpapi@ietf.org>
List-Help: <mailto:httpapi-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/httpapi>, <mailto:httpapi-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 03 Dec 2020 02:07:45 -0000

Erik,

There are some issues that I would like to clarify with the current draft.

In the introduction of the document, the following statement is made.


  *   It just informs client of the fact that a resource is deprecated.
https://tools.ietf.org/html/draft-dalal-deprecation-header-00#section-1

In the documentation, there is further qualification,


Ø  For a resource, deprecation could involve one or more parts of

  *   request, response or both.
https://tools.ietf.org/html/draft-dalal-deprecation-header-00#section-3.1

There is then a list of potential partial deprecations, including methods, headers and request or response body elements.

By introducing the possibility of signalling the deprecation of some element of the overall HTTP interaction, it seems to be in conflict with the original statement that says a “resource is deprecated”.  It also introduces other conflicts such as not allowing multiple deprecation headers.  If deprecation can be partial, wouldn’t it be likely there would be multiple deprecations for a single resource?

The Sunset header is more explicit about the granularity of impact.  RFC 8594 describes the impact of the sunset header,


Ø  indicates that a URI is likely to become unresponsive at a

Ø     specified point in the future
https://tools.ietf.org/html/rfc8594

Is it intended that there be different granularity for the deprecated header vs sunset header?

Darrel