subscription Subscriptions_List requires nextLink

[cataggar]

In the subscription service, the Subscriptions_List operation returns a SubscriptionListResult which says nextLink is required. The service is not returning a nextLink when there are not enough results for paging. The API version for that operation is 2016-06-01 which is used by these tags:

• package-2021-10
• package-2020-09
• package-2019-10-preview
• package-2019-03-preview
• package-2018-11-preview
• package-2018-03-preview
• package-2016-06-01

cc @Ochirkhuyag, @navysingla, @mjfrb

https://github.com/Azure/azure-rest-api-specs/blob/main/specification/subscription/resource-manager/readme.md

azure-rest-api-specs/specification/subscription/resource-manager/Microsoft.Subscription/stable/2016-06-01/subscriptions.json

Lines 101 to 130 in 88e7838

	"/subscriptions": {
	"get": {
	"tags": [
	"Subscriptions"
	],
	"operationId": "Subscriptions_List",
	"description": "Gets all subscriptions for a tenant.",
	"x-ms-examples": {
	"listSubscriptions": {
	"$ref": "./examples/listSubscriptions.json"
	}
	},
	"parameters": [
	{
	"$ref": "#/parameters/ApiVersionParameter"
	}
	],
	"responses": {
	"200": {
	"description": "OK - Returns an array of subscriptions.",
	"schema": {
	"$ref": "#/definitions/SubscriptionListResult"
	}
	}
	},
	"x-ms-pageable": {
	"nextLinkName": "nextLink"
	}
	}
	},

azure-rest-api-specs/specification/subscription/resource-manager/Microsoft.Subscription/stable/2016-06-01/subscriptions.json

Lines 283 to 301 in 88e7838

	"SubscriptionListResult": {
	"properties": {
	"value": {
	"type": "array",
	"items": {
	"$ref": "#/definitions/Subscription"
	},
	"description": "An array of subscriptions."
	},
	"nextLink": {
	"type": "string",
	"description": "The URL to get the next set of results."
	}
	},
	"required": [
	"nextLink"
	],
	"description": "Subscription list operation response."
	},

This is a swagger quality issue. Tools like the Azure SDK for Rust rely on the service specification matching the service implementation. Azure/azure-sdk-for-rust#650

[ghost]

Thanks for the feedback! We are routing this to the appropriate team for follow-up. cc @anuragdalmia, @ShilpiGautam, @ramaganesan-rg.

Issue Details

---

In the subscription service, the Subscriptions_List operation returns a SubscriptionListResult which says nextLink is required. The service is not returning a nextLink when there are not enough results for paging. The API version for that operation is 2016-06-01 which is used by these tags:

• package-2021-10
• package-2020-09
• package-2019-10-preview
• package-2019-03-preview
• package-2018-11-preview
• package-2018-03-preview
• package-2016-06-01

cc @Ochirkhuyag, @navysingla, @mjfrb

https://github.com/Azure/azure-rest-api-specs/blob/main/specification/subscription/resource-manager/readme.md

azure-rest-api-specs/specification/subscription/resource-manager/Microsoft.Subscription/stable/2016-06-01/subscriptions.json

Lines 101 to 130 in 88e7838

	"/subscriptions": {
	"get": {
	"tags": [
	"Subscriptions"
	],
	"operationId": "Subscriptions_List",
	"description": "Gets all subscriptions for a tenant.",
	"x-ms-examples": {
	"listSubscriptions": {
	"$ref": "./examples/listSubscriptions.json"
	}
	},
	"parameters": [
	{
	"$ref": "#/parameters/ApiVersionParameter"
	}
	],
	"responses": {
	"200": {
	"description": "OK - Returns an array of subscriptions.",
	"schema": {
	"$ref": "#/definitions/SubscriptionListResult"
	}
	}
	},
	"x-ms-pageable": {
	"nextLinkName": "nextLink"
	}
	}
	},

azure-rest-api-specs/specification/subscription/resource-manager/Microsoft.Subscription/stable/2016-06-01/subscriptions.json

Lines 283 to 301 in 88e7838

	"SubscriptionListResult": {
	"properties": {
	"value": {
	"type": "array",
	"items": {
	"$ref": "#/definitions/Subscription"
	},
	"description": "An array of subscriptions."
	},
	"nextLink": {
	"type": "string",
	"description": "The URL to get the next set of results."
	}
	},
	"required": [
	"nextLink"
	],
	"description": "Subscription list operation response."
	},

This is a swagger quality issue. Tools like the Azure SDK for Rust rely on the service specification matching the service implementation. Azure/azure-sdk-for-rust#650

Author:	cataggar
Assignees:	-
Labels:	Service Attention, Subscription, needs-triage
Milestone:	-

[cataggar]

Fixed by #17674.