Updated on 2023-11-09 GMT+08:00

Obtaining Template Version Content

Function

ShowTemplateVersionContent

This API obtains the template version content.

  • template_id is the unique ID of the template. It is a UUID generated by RFS when a template is created. Template names are unique at one specific time, so you can create a template named HelloWorld and another template with the same name after deleting the first one. For parallel development, team members may want to ensure that they are operating the template they created, not one with the same name created by other members after deleting the previous one. To avoid this mismatch, check the ID, since RFS ensures each template has a unique ID that does not change with updates. If the template_id value differs from the current template ID, 400 is returned.
  • This API returns the download link (a pre-signed URL of OBS, valid for 5 minutes) of the template content through temporary redirection. You can download the template version content from the link.

ShowTemplateVersionContent returns only the template version content. To obtain the metadata of a template version, call ShowTemplateVersionMetadata.

URI

GET /v1/{project_id}/templates/{template_name}/versions/{version_id}

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

project_id

Yes

String

Project ID. It can be obtained by calling an API or from the console.

Obtaining a Project ID

Minimum: 3

Maximum: 64

template_name

Yes

String

Name of the template to be created.

Minimum: 1

Maximum: 128

version_id

Yes

String

Template version ID. It starts with V (uppercase). The number of the ID is incremented by 1 each time a version is created.

Minimum: 2

Maximum: 11

Table 2 Query Parameters

Parameter

Mandatory

Type

Description

template_id

No

String

ID of a template. If template_id exists, the template service checks whether template_id matches template_name. If not, 400 is returned.

Minimum: 36

Maximum: 36

Request Parameters

Table 3 Request header parameters

Parameter

Mandatory

Type

Description

Client-Request-Id

Yes

String

Unique request ID. It is specified by a user and is used to locate a request. UUID is recommended.

Minimum: 36

Maximum: 128

Response Parameters

Status code: 307

Table 4 Response header parameters

Parameter

Type

Description

Location

String

HTTP redirection header. The client can use this header to redirect to a new address. The content is a template download link, which is a pre-signed OBS URL valid for 10 minutes.

Status code: 400

Table 5 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 401

Table 6 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 403

Table 7 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 404

Table 8 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 429

Table 9 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Status code: 500

Table 10 Response body parameters

Parameter

Type

Description

error_code

String

Error code.

error_msg

String

Error message.

Example Requests

  • Obtain a specified version of a specified template.
    GET https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template/versions/V1
  • Obtain a specified version of a specified template and check whether the template ID matches the current template.
    GET https://{endpoint}/v1/c364070ab35041ddae68cf8b4839b60f/templates/my_template/versions/V1?template_id=1b15e005-bdbb-4bd7-8f9a-a09b6774b4b3

Example Responses

None

Status Codes

Status Code

Description

200

空响应体

307

Template version content requested. The request is redirected to the download link.

400

Invalid request.

401

Authentication failed.

403

The user does not have the permission to call this API.

404

The template or template version does not exist.

429

Too frequent requests.

500

Internal server error.

Error Codes

See Error Codes.