Azure / Azure/azure-rest-api-specs

[FEATURE REQ] Document https://management.azure.com/batch

Open
#39,106 1 comment 3 reactions 0 assignees View on GitHub
Batch customer-reported feature-request question Service Attention
Dominant language
TypeSpec
Stars
3.1k
Forks
5.9k
Avg merge
2d 22h
Merged PRs (30d)
444

Description

### API Spec link

None yet

### API Spec version

2020-06-01

### Please describe the feature.

I could not find where the batch endpoint is documented in the rest api specs, so please document it. It's being used extensively by portal, ansible, etc but I could not locate official docs by msft on it.

curl 'https://management.azure.com/batch?api-version=2020-06-01' \
-H 'accept: */*' \
-H 'accept-language: en' \
-H 'authorization: Bearer .... \
-H 'content-type: application/json' \
--data-raw $'{"requests":[{...}]'

I've seen discussion in sdks about using it, but sofar they do not do it because it's not available in the rest api specs:
https://github.com/Azure/azure-sdk-for-go/issues/23799
https://github.com/Azure/azure-sdk-for-go/issues/17155
https://github.com/Azure/azure-sdk-for-go/issues/15957
https://github.com/Azure/azure-sdk-for-python/issues/9271
https://github.com/Azure/autorest.typescript/issues/34

Contributor guide

Open the contributing guide

Research direction

No implementation file or test is named. Start by reviewing the repository's REST API specification conventions and the linked SDK discussions, then determine how the Azure management batch endpoint and version 2020-06-01 should be represented; done means the endpoint is documented in the REST API specs and validation passes.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi
Domain
api, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
38/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.