Tech-
invite
3GPP
space
IETF
space
21
22
23
24
25
26
27
28
29
31
32
33
34
35
36
37
38
4‑5x
Content for
TS 26.512
Word version: 17.3.0
1…
4…
4.4…
5…
6…
11…
A…
6
General aspects of APIs for 5G Media Streaming
7
Provisioning (M1) APIs
8
Media Ingest and Publish (M2) protocols
9
Internal (M3) APIs
10
Media Streaming (M4) APIs
...
6
General aspects of APIs for 5G Media Streaming
p. 39
6.1
HTTP resource URIs and paths
p. 39
6.2
Usage of HTTP
p. 39
6.2.1
HTTP protocol version
p. 39
6.2.1.1
5GMS AF
p. 39
6.2.1.2
5GMS AS
p. 39
6.2.2
HTTP message bodies for API resources
p. 39
6.2.3
Usage of HTTP headers
p. 40
6.2.3.1
General
p. 40
6.2.3.2
User Agent identification
p. 40
6.2.3.2.1
Media Stream Handler identification
p. 40
6.2.3.2.2
Media Session Handler identification
p. 40
6.2.3.3
Server identification
p. 40
6.2.3.3.1
5GMSd AF identification
p. 40
6.2.3.4
Support for conditional HTTP GET requests
p. 40
6.2.3.5
Support for conditional HTTP POST, PUT, PATCH and DELETE requests
p. 41
6.3
HTTP response codes
p. 41
6.4
Common API data types
p. 41
6.4.1
General
p. 41
6.4.2
Simple data types
p. 41
6.4.3
Structured data types
p. 42
6.4.3.1
IpPacketFilterSet type
p. 42
6.4.3.2
ServiceDataFlowDescription type
p. 42
6.4.3.3
M5QoSSpecification type
p. 42
6.4.3.4
M1QoSSpecification type
p. 42
6.4.3.5
ChargingSpecification type
p. 43
6.4.3.6
TypedLocation type
p. 43
6.4.3.7
OperationSuccessResponse type
p. 43
6.4.3.8
EdgeProcessingEligibilityCriteria type
|R17|
p. 44
6.4.3.9
EndpointAddress type
|R17|
p. 44
6.4.4
Enumerated data types
p. 45
6.4.4.1
CellIdentifierType enumeration
p. 45
6.4.4.2
SdfMethod enumeration
p. 45
6.4.4.3
ProvisioningSessionType enumeration
p. 45
6.4.4.4
EASRelocationTolerance enumeration
|R17|
p. 45
6.4.4.5
CacheStatus enumeration
|R17|
p. 46
6.5
Explanation of API data model notation
p. 46
7
Provisioning (M1) APIs
p. 47
7.1
General
p. 47
7.2
Provisioning Sessions API
p. 47
7.2.1
Overview
p. 47
7.2.2
Resource structure
p. 47
7.2.3
Data model
p. 48
7.2.3.1
ProvisioningSession resource
p. 48
7.3
Server Certificates Provisioning API
p. 49
7.3.1
Overview
p. 49
7.3.2
Resource structure
p. 49
7.3.3
Data model
p. 50
7.3.3.1
Certificate Signing Request
p. 50
7.3.3.2
Server Certificate resource
p. 50
7.3.4
Operations
p. 50
7.4
Content Preparation Templates Provisioning API
p. 51
7.4.1
Overview
p. 51
7.4.2
Resource structure
p. 51
7.4.3
Data model
p. 51
7.4.4
Operations
p. 51
7.5
Content Protocols Discovery API
p. 52
7.5.1
Overview
p. 52
7.5.2
Resource structure
p. 52
7.5.3
Data model
p. 52
7.5.3.1
ContentProtocols resource
p. 52
7.5.3.2
ContentProtocolDescriptor type
p. 53
7.6
Content Hosting Provisioning API
p. 53
7.6.1
Overview
p. 53
7.6.2
Resource structure
p. 53
7.6.3
Data model
p. 53
7.6.3.1
ContentHostingConfiguration resource
p. 53
7.6.3.2
DistributionNetworkType enumeration
|R17|
p. 58
7.6.3.3
DistributionMode enumeration
|R17|
p. 58
7.6.4
Operations
p. 58
7.6.4.1
Overview
p. 58
7.6.4.2
Content caching
p. 58
7.6.4.3
Cache purging
p. 59
7.6.4.4
Content processing
p. 59
7.6.4.5
URL signing
p. 59
7.6.4.6
Geofencing
p. 60
7.7
Consumption Reporting Provisioning API
p. 61
7.7.1
Overview
p. 61
7.7.2
Resource structure
p. 61
7.7.3
Data model
p. 62
7.7.3.1
ConsumptionReportingConfiguration resource
p. 62
7.8
Metrics Reporting Provisioning API
p. 62
7.8.1
Overview
p. 62
7.8.2
Resource structure
p. 62
7.8.3
Data model
p. 63
7.8.3.1
MetricsReportingConfiguration resource
p. 63
7.9
Policy Templates Provisioning API
p. 64
7.9.1
Overview
p. 64
7.9.2
Resource structure
p. 65
7.9.3
Data model
p. 66
7.9.3.1
PolicyTemplate resource
p. 66
7.10
Edge Resources Provisioning API
|R17|
p. 67
7.10.1
General
p. 67
7.10.2
Resource structure
p. 67
7.10.3
Data model
p. 68
7.10.3.1
EdgeResourcesConfiguration resource type
p. 68
7.10.3.2
EdgeManagementMode enumeration
p. 68
7.10.3.3
EASRequirements type
p. 69
7.10.3.4
M1EASRelocationRequirements type
p. 69
7.11
Event Data Processing Provisioning API
|R17|
p. 70
7.11.1
General
p. 70
7.11.2
Resource structure
p. 70
7.11.3
Data model
p. 71
7.11.3.1
EventDataProcessingConfiguration resource type
p. 71
8
Media Ingest and Publish (M2) protocols
p. 71
8.1
General
p. 71
8.2
HTTP pull-based content ingest protocol
p. 72
8.3
DASH-IF push-based content ingest protocol
p. 72
9
Internal (M3) APIs
p. 72
10
Media Streaming (M4) APIs
p. 73
10.1
General
p. 73
10.2
DASH Distribution
p. 73