The GET method fetches the content of an individual certificate. See clause 5.5.x.3.2.
@@ -196,13 +334,69 @@ paths:
components:
parameters:
filter_subject_instances:
name:filter
description:>
Attribute-based filtering expression according to clause 5.2 of ETSI GS NFV SOL 013 [4].
The CMF shall support receiving this parameter as part of the URI query string. The VNFM may
supply this parameter.
All attribute names that appear in the SubjectInstance and in data types referenced from it
shall be supported by the CMF in the filter expression.
in:query
required:false
schema:
type:string
exclude_default_subject_instances:
name:exclude_default
in:query
description:>-
Indicates to exclude the following complex attributes from the response. See clause 5.3 of
ETSI GS NFV-SOL 013 [8] for details. The CMF shall support this parameter.
The following attributes shall be excluded from the SubjectInstance structure in the response
body if this parameter is provided, or none of the parameters "all_fields", "fields", "exclude_fields",
"exclude_default" are provided:
- pkiBody
required:false
schema:
type:string
filter_certificate_instances:
name:filter
description:>
Attribute-based filtering expression according to clause 5.2 of ETSI GS NFV SOL 013 [4].
The CMF shall support receiving this parameter as part of the URI query string. The VNFM may
supply this parameter.
All attribute names that appear in the SubjectInstance and in data types referenced from it
shall be supported by the CMF in the filter expression.
in:query
required:false
schema:
type:string
exclude_default_certificate_instances:
name:exclude_default
in:query
description:>-
Indicates to exclude the following complex attributes from the response. See clause 5.3 of
ETSI GS NFV-SOL 013 [8] for details. The CMF shall support this parameter.
The following attributes shall be excluded from the SubjectInstance structure in the response
body if this parameter is provided, or none of the parameters "all_fields", "fields", "exclude_fields",
"exclude_default" are provided:
- pkiBody
required:false
schema:
type:string
subjectId:
name:subjectId
in:path
description:|
Identifier of the Subject instance. See note 1.
NOTE 1: This identifier can be retrieved from the resource referenced by the "Location" HTTP header in the response to a POST request creating a new "Individual Subject instance" resource. It can also be retrieved from the "id" attribute in the message content of that response.
NOTE 1: This identifier can be retrieved from the resource referenced by the "Location" HTTP
header in the response to a POST request creating a new "Individual Subject instance" resource.
It can also be retrieved from the "id" attribute in the message content of that response.
required:true
style:simple
explode:false
@@ -215,7 +409,9 @@ components:
description:|
certificateId Identifier of the Certificate instance. See note 2.
NOTE 2: This identifier can be retrieved from the resource referenced by the "Location" HTTP header in the response to a POST request creating a new "Individual Certificate instance" resource. It can also be retrieved from the "id" attribute in the message content of that response.
NOTE 2: This identifier can be retrieved from the resource referenced by the "Location" HTTP
header in the response to a POST request creating a new "Individual Certificate instance" resource.
It can also be retrieved from the "id" attribute in the message content of that response.
required:true
style:simple
explode:false
@@ -227,11 +423,14 @@ components:
description:>
201 CREATED
Shall be returned when a new "Individual Subject instance" resource and the associated Subject instance identifier has been created successfully.
Shall be returned when a new "Individual Subject instance" resource and the associated Subject
instance identifier has been created successfully.
The response body shall contain a representation of the created Subject instance, as defined in clause x.x.x.x.
The response body shall contain a representation of the created Subject instance, as defined in
clause x.x.x.x.
The HTTP response shall include a "Location" HTTP header that contains the resource URI of the created Subject instance.
The HTTP response shall include a "Location" HTTP header that contains the resource URI of the
created Subject instance.
headers:
Location:
description:|
@@ -269,9 +468,61 @@ components:
description:>
409 CONFLICT
Shall be returned upon the following error: The operation cannot be executed currently, due to a conflict with the state of the resource.
Shall be returned upon the following error: The operation cannot be executed currently, due to a
conflict with the state of the resource.
The response body shall contain a ProblemDetails structure, in which the "detail" attribute shall convey more information about the error.
The response body shall contain a ProblemDetails structure, in which the "detail" attribute shall
convey more information about the error.
headers:
Location:
description:|
The resource URI of the created subject resource.
style:simple
explode:false
schema:
type:string
format:url
WWW-Authenticate:
description:>
Challenge if the corresponding HTTP request has not provided
authorization, or error details if the corresponding HTTP
request has provided an invalid authorization token.
schema:
type:string
Version:
description:>
Version of the API used in the response.
schema:
type:string
Content-Type:
description:|
The MIME type of the body of the response. Reference: IETF RFC 9110
