orkungedik/SAP-basis-dataset huggingface dataset:
## 4.2.13.2.13.1.3.3  Signing Certificates - Communication Systems
Technical name: SigningCertificatesCommSystems
## Properties
| Property              | Description             | Necessity       |
|-----------------------|-------------------------|-----------------|
| SigningKey            | Signing key             | Mandatory (Key) |
| CommunicationSystemID | Communication system ID | Mandatory (Key) |
## Note
To display more information about the properties on the SAP Business Accelerator Hub, choose Schema View .
## 4.2.13.2.14  Integrating Cross-domain Identity Management
You can use this communication scenario to maintain data via SCIM.
## Context
The communication scenario SAP\_COM\_0465 allows you to maintain data via SCIM (System for Cross-domain Identity Management).
## Authentication Methods
This communication scenario can be configured with the following inbound authentication methods:
- Basic Authentication (user and password)
- X.509 (certificates)
## Procedure
1. Check if a communication user already exists for this scenario. If not, create a communication user in the Maintain Communication Users app.
For more information, see the Related information section.
2. Check if a communication system already exists for this scenario. If not, create a communication system in the Communication Systems app.
3. Check if a communication arrangement already exists for this scenario. If not, create a communication arrangement for the System for Cross-domain Identity Management Integration scenario (SAP\_COM\_0465) in the Communication Arrangements app.
For more information, see the Related information section.
## Related Information
Communication Management [page 2707]
SCIM Interface for IAM [page 1066] User Management (System for Cross-domain Identity Management (SCIM))
## 4.2.13.2.14.2  Example: User Endpoint
Please find an example of a user endpoint below:
```
 Sample Code { "schemas" : [ "urn:ietf:params:scim:schemas:core:2.0:User", "urn:ietf:params:scim:schemas:extension:sap:2.0:User" ], "id" : "CB0000000001", "externalId" : "WORKER_ID", "userName" : "JOHN_DOE", "name" : { "formatted" : "John Doe", "familyName" : "Doe", "givenName" : "John" }, "displayName" : "John Doe", "emails" : [ { "value" : "john.doe@sap.com", "type" : "work", "primary" : true } ], "phoneNumbers" : [ { "value" : "+123456789", "type" : "work" }, { "value" : "+987654321", "type" : "mobile" } ], "userType" : "Employee", "preferredLanguage" : "E", "timezone" : "CET",
```
```
"active" : true, "groups" : [ { "value" : "BUGR_ZCBUSERGROUP", "$ref" : "https://system.com/sap/bc/http/sap/aps_iam_api_scim/Groups/ BUGR_ZCBUSERGROUP", "display" : "business user group", "type" : "userGroup" }, { "value" : "BROL_BUSINESSROLE1", "$ref" : "https://system.com/sap/bc/http/sap/aps_iam_api_scim/Groups/ BROL_BUSINESSROLE1", "display" : "business role 1", "type" : "authorization" }, { "value" : "BROL_BUSINESSROLE2", "$ref" : "https://system.com/sap/bc/http/sap/aps_iam_api_scim/Groups/ BROL_BUSINESSROLE2", "display" : "business role 2", "type" : "authorization" } ], "urn:ietf:params:scim:schemas:extension:sap:2.0:User" : { "userUuid" : "GLOBAL_USER_ID" }, "meta" : { "resourceType" : "User", "created" : "2015-05-22T12:53:56Z", "lastModified" : "2015-05-22T12:53:56Z", "version" : "20150522125356", "location" : "https://system.com/sap/bc/http/sap/aps_iam_api_scim/Users/ CB0000000001" } }
```
## 4.2.13.2.14.3  Example: Group Endpoint
Please find an example of a group endpoint below:
```
 Sample Code { "schemas" : [ "urn:ietf:params:scim:schemas:core:2.0:Group", "urn:ietf:params:scim:schemas:extension:sap:2.0:Group" ], "id" : "BROL_BUSINESSROLE1", "externalId" : "BUSINESSROLE1", "displayName" : "business role 1", "members" : [ { "value" : "CB0000000001", "$ref" : "https://system.com/sap/bc/http/sap/aps_iam_api_scim/Users/ CB0000000001", "display" : "John Doe" } ], "urn:ietf:params:scim:schemas:extension:sap:2.0:Group" : { "type" : "authorization",
```
```
"supportedOperations" : "membership" }, "meta" : { "resourceType" : "Group", "created" : "2018-12-11T19:18:05Z", "lastModified" : "2021-09-08T12:38:32Z", "version" : "20210908123832", "location" : "https://system.com/sap/bc/http/sap/aps_iam_api_scim/Groups/ BROL_BUSINESSROLE1 } }
```
## 4.2.13.2.15  Manage Git Repository
The Manage Git Repository API allows you to manage software components (Git repositories) on an SAP BTP ABAP Environment system.
## Overview
On an ABAP Environment system, software components, which represent Git repositories, can be controlled with Git operations. This includes cloning to an ABAP Environment system, pulling updates and working with branches (create, delete, checkout). These operations can be used with this API.
Technical Name : MANAGE\_GIT\_REPOSITORY
OData Version : 2.0
Root URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY
## Permissions
In order to access this service, you need to:
- Create a Communication User as described in How to Create Communication Users [page 2710].
- Create a Communication System as described in How to Create Communication Systems.
- Create a Communication Arrangement as described in How to Create a Communication Arrangement [page 2712].
- Select the communication scenario SAP\_COM\_0510 for your communication arrangement and have mapped it to your communication system.
## Service Structure
Service Metadata URI : sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/$metadata
## Service Entities
Service Entity
Description
| Branches [page 1072]   | Branches of a software component   |
|------------------------|------------------------------------|
| Service Entity            | Description                           |
|---------------------------|---------------------------------------|
| Clones [page 1079]        | Clone job of a software component     |
| Execution Log [page 1083] | Execution Log of a software component |
| Pull [page 1086]          | Pull job of a software component      |
| Transport Log [page 1090] | Transport log of an impored transport |
## 4.2.13.2.15.1  Branches
Resource path: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Branches
## Operations
## CRUD Operations
| HTTP Method   | Operation                   |
|---------------|-----------------------------|
| GET           | Read Branches [page 1073]   |
| POST          | Create Branch [page 1074]   |
| DELETE        | Delete Branches [page 1076] |
## Custom Operations
| HTTP Method   | Operation Type   | Operation                     | URI                                                         |
|---------------|------------------|-------------------------------|-------------------------------------------------------------|
| POST          | Action           | Checkout Branches [page 1077] | /sap/opu/odata/sap/ MANAGE_GIT_REPOSI- TORY/checkout_branch |
## Parameters
| Property     | Description                                                     |
|--------------|-----------------------------------------------------------------|
| branch_name  | name of the branch                                              |
| sc_name      | name of the software component                                  |
| is_active    | indicates if the branch is active in the system                 |
| critivality  |                                                                 |
| derived_from | name of the original branch from which the branch was de- rived |
| created_by   | user who created the branch                                     |
| created_on   | date when the branch was created                                |
| commit_id    | latest commit ID on the branch                                  |
## Property
| commit_message   | commit message of the latest commit   |
|------------------|---------------------------------------|
| last_commit_by   | user who commited the last commit     |
| last_commit_on   | date of the latest commit             |
## 4.2.13.2.15.1.1  Read Branches
Read one or multiple branches .
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Branches
Operation Type:
CRUD
HTTP Method:
GET
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| x-csrf-token | no         | fetch                            |
## Request Parameters
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | query string     |
| branch_name | yes        | string      | name of the branch             | query string     |
## Request Example
##  Sample Code
GET /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/
Branches(branch\_name='newBranch',sc\_name='/DMO/GIT\_REPOSITORY' HTTP/1.1
Host: host.com
Authentication: basicAuthentication
Accept: application/json
Description
## Response
## Response Headers
Header x-csrf-token
## Response Status and Error Codes
|   Code | Reason    | Description                                                           |
|--------|-----------|-----------------------------------------------------------------------|
|    200 | OK        | Branch was read successfully                                          |
|    404 | Not foumd | Could not read branch; software com- ponent or branch may not exist.. |
## Request Payload Example
```
 Sample Code { "d": { "__metadata": { "id": "https://host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ Branches(branch_name='newBranch',sc_name='/DMO/GIT_REPOSITORY')", "uri": "https://host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ Branches(branch_name='newBranch',sc_name='/DMO/GIT_REPOSITORY')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.BranchesType" }, "branch_name": "newBranch", "sc_name": "/DMO/GIT_REPOSITORY", "is_active": false, "criticality": 0, "derived_from": "main", "created_by": "CC0000000001", "created_on": "/Date(1584967657000+0000)/", "last_commit_on": "/Date(1584634658000+0000)/" } }
```
## 4.2.13.2.15.1.2  Create Branch
Create a new branch.
## Request
```
URI: /sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Branches Operation Type: CRUD HTTP Method: POST
```
Description
Token, which can be used for POST requests
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| Content-Type | no         | application/json application/xml |
| x-csrf-token | yes        | Value of x-csrf-token            |
## Request Parameters
| Parameter    | Required   | Data Type   | Description                                                   | Parameter Type   |
|--------------|------------|-------------|---------------------------------------------------------------|------------------|
| sc_name      | yes        | string      | name of the software component                                | Request body     |
| branch_name  | yes        | string      | name of the branch                                            | Request body     |
| derived_from | yes        | string      | name of the original branch form which the branch was derived | Request body     |
## Request Example
## 
```
Sample Code POST/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Branches HTTP/1.1 Host: host.com Authentication: basicAuthentication X-csrf-token: xCsrfToken Content-Type: application/json Accept: application/json { "sc_name" : "/DMO/GIT_REPOSITORY", "derived_from" : "main", "branch_name" : "newBranch" }
```
## Response
## Response Status and Error Codes
|   Code | Reason      | Description                                                             |
|--------|-------------|-------------------------------------------------------------------------|
|    201 | Created     | Branch was created successfully                                         |
|    400 | Bad Request | Could not create a branch due to the values passed in the request body. |
## Request Payload Example
```
 Sample Code { "d": { "__metadata": { "id": "https://host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ Branches(branch_name='newBranch',sc_name='/DMO/GIT_REPOSITORY')", "uri": "https://host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ Branches(branch_name='newBranch',sc_name='/DMO/GIT_REPOSITORY')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.BranchesType" }, "branch_name": "newBranch", "sc_name": "/DMO/GIT_REPOSITORY", "is_active": false, "criticality": 0, "derived_from": "master", "created_by": "CC0000000001", "created_on": "/Date(1584967657000+0000)/", "last_commit_on": "/Date(1584634658000+0000)/" } }
```
## 4.2.13.2.15.1.3  Delete Branches
Delete a branch.
## Request
```
URI: /sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Branches Operation Type: CRUD HTTP Method: DELETE
```
## Request Headers
## Request Parameters
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | query string     |
| branch_name | yes        | string      | name of the branch             | query string     |
## Request Example
## 
```
Sample Code DELETE /sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Branches(branch_name='my-tobe-deleted-branch',sc_name='/DMO/GIT_REPOSITORY') HTTP/1.1
```
Host: host.com
Authentication: basicAuthentication
Accept: application/json
## Response
## Response Headers
 Sample Code
HTTP/1.1 204 No Content
## Response Status and Error Codes
|   Code | Reason      | Description                                                             |
|--------|-------------|-------------------------------------------------------------------------|
|    204 | No content  | Branch was deleted successfully                                         |
|    400 | Bad Request | Could not delete branch due to the val- ues passed in the request body. |
## 4.2.13.2.15.1.4  Checkout Branches
Checkout a branch.
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Branches
Operation Type:
CRUD
HTTP Method:
POST
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Content-Type | no         | application/json application/xml |
| Accept       | no         | application/json application/xml |
| Header       | Required   | Values                |
|--------------|------------|-----------------------|
| x-csrf-token | yes        | Value of x-csrf-token |
## Request Parameters
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | query string     |
| branch_name | yes        | string      | name of the branch             | query string     |
## Request Example
## 
```
Sample Code POST/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/checkout_branch? branch_name='newBranch'&sc_name="'/DMO/GIT_REPOSITORY' HTTP/1.1
```
```
Host: host.com Authentication: basicAuthentication X-csrf-token: xCsrfToken Content-Type: application/json Accept: application/json
```
## Response
## Response Status and Error Codes
|   Code | Reason      | Description                                                               |
|--------|-------------|---------------------------------------------------------------------------|
|    200 | OK          | Branch was checked out successfully                                       |
|    400 | Bad Request | Could not check out a branch due to the values passed in the request body |
## Response Payload Example
```
 Sample Code { "d": { "__metadata": { "id": "https://host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ Pull(guid'UUID')", "uri": "https://host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ Pull(guid'UUID')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.PullType" }, "uuid": "UUID ", "sc_name": "/DMO/GIT_REPOSITORY ", "namespace": "", "status": "R", "status_descr": "Running", "start_time": "/Date(1571227437000+0000)/", "change_time": "/Date(1571227472000+0000)/", "criticality": 2,
```
```
"user_name": "CC0000000001", "to_Execution_log": { "__deferred": { "uri": "https://host.com/sap/opu/odata/sap/ MANAGE_GIT_REPOSITORY/Pull(guid'UUID')/to_Execution_log" } }, "to_Transport_log": { "__deferred": { "uri": "https://host.com/sap/opu/odata/sap/ MANAGE_GIT_REPOSITORY/Pull(guid'UUID')/to_Transport_log" } } } }
```
## 4.2.13.2.15.2  Clones
Resource path: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Clones
## Operations
## CRUD Operations
HTTP Method
## Description
| GET   | Read Clones [page 1080]   |
|-------|---------------------------|
| POST  | Create Clone [page 1081]  |
## Parameterss
| Property     | Description                              |
|--------------|------------------------------------------|
| uuid         | ID of the job                            |
| sc_name      | Nameof the software component            |
| branch_name  | Nameof the branch                        |
| commit_id    | Commit ID                                |
| import_type  | Type of import                           |
| status       | Status of the job                        |
| status_descr | Status description                       |
| user_name    | Nameof the user who triggered the action |
| start_time   | Start time of the job                    |
| change_time  | Last update of the job                   |
## 4.2.13.2.15.2.1  Read Clones
Read a clone job. The entity is only available after the job has finished. To track the status of the job, you can use the GET /Pull(guid'UUID') request.
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Clones
Operation Type:
CRUD
HTTP Method:
GET
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| x-csrf-token | no         | fetch                            |
## Request Parameters
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | query string     |
| branch_name | yes        | string      | name of the branch             | query string     |
| uuid        | yes        | string      | ID of the job                  | query string     |
## Request Example
##  Sample Code
GET /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Clones(uuid=02409ac8- dc6a-1edb-908e-31e4b44596d4',branch\_name='main',sc\_name='/DMO/ GIT\_REPOSITORY') HTTP/1.1
Host: host.com
Authentication: basicAuthentication
Accept: application/json
## Response
## Response Headers
Header
Description
| x-csrf-token   | Token, which can be used for POST requests   |
|----------------|----------------------------------------------|
## Response Status and Error Codes
|   Code | Reason      | Description                                                   |
|--------|-------------|---------------------------------------------------------------|
|    200 | OK          | Read clone succesfully                                        |
|    400 | Bad Request | Could not read the clone entity. Please check the parameters. |
## Request Payload Example
```
 Sample Code { "d": { "__metadata": { "id": "https://4c7c0f11da7c-43cf-b60c-e6e308144458.abap.stagingaws.hanavlab.ondemand.com/sap/opu/ odata/sap/MANAGE_GIT_REPOSITORY/Clones(uuid=guid'02409ac8dc6a-1edb-908e-31e4b44596d4',sc_name='%2FDMO%2F GIT_REPOSITORY,branch_name='main')", "uri": "https://4c7c0f11da7c-43cf-b60c-e6e308144458.abap.stagingaws.hanavlab.ondemand.com/sap/opu/ odata/sap/MANAGE_GIT_REPOSITORY/Clones(uuid=guid'02409ac8dc6a-1edb-908e-31e4b44596d4',sc_name='%2FDMO%2F GIT_REPOSITORY,branch_name='main')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.ClonesType" }, "uuid": "02409ac8-dc6a-1edb-908e-31e4b44596d4", "sc_name": "/DMO/GIT_REPOSITORY", "branch_name": "main", "commit_id": "", "import_type": "Clone", "namespace": "", "status": "S", "status_descr": "Success", "criticality": 3, "user_name": "CC0000000001", "start_time": "/Date(1608214205000+0000)/", "change_time": "/Date(1608214243000+0000)/" } }
```
## 4.2.13.2.15.2.2  Create Clone
Create a clone job.
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Clones
Operation Type:
CRUD
HTTP Method:
POST
## Request Headers
| Header        | Required   | Values                           |
|---------------|------------|----------------------------------|
| Accept        | no         | application/json application/xml |
| Contentt-Type | no         | application/json application/xml |
| x-csrf-token  | no         | fetch                            |
## Request Parameters
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | Request body     |
| branch_name | no         | string      | name of the branch             | Request body     |
| commit_id   | no         | string      | commit ID                      | Request body     |
## Request Example
## 
```
Sample Code
```
```
POST/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Clones HTTP/1.1
```
```
Host: host.com Authentication: basicAuthentication X-csrf-token: xCsrfToken Content-Type: application/json Accept: application/json { "sc_name" : "/DMO/GIT_REPOSITORY" "branch_name": "main" }
```
## Response
## Response Status and Error Codes
|   Code | Reason      | Description                                                |
|--------|-------------|------------------------------------------------------------|
|    201 | Created     | Created a clone job                                        |
|    400 | Bad Request | Could not read the clone job. Please check the parameters. |
## Request Payload Example
```
 Sample Code { "d": { { "__metadata": { "id": "host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Clones(uuid=guid'02ceab7dff04-1eda-b1ea-eb7fdbf28bc4',sc_name='ZHM_INITIAL_TEST',branch_name='')", "uri": "host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Clones(uuid=guid'02ceab7dff04-1eda-b1ea-eb7fdbf28bc4',sc_name='ZHM_INITIAL_TEST',branch_name='')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.ClonesType" }, "uuid": "02ceab7d-ff04-1eda-b1ea-eb7fdbf28bc4", "sc_name": "/DMO/GIT_REPOSITORY", "branch_name": "", "import_type": "Clone", "namespace": "", "status": "S", "status_descr": "Success", "criticality": 3, "user_name": "administrator@example.com", "start_time": "/Date(1594898863000+0000)/", "change_time": "/Date(1594898891000+0000)/" } } }
```
## 4.2.13.2.15.3   Execution Log
Resource path: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/ExecutionLogs
## Operations
## CRUD Operations
| HTTP Method   | Description                                    |
|---------------|------------------------------------------------|
| GET           | Read Execution Log [page 1084]                 |
| Parameters    |                                                |
| Property      | Description                                    |
| uuid          | ID of the job                                  |
| index_no      | Index number of the log entry                  |
| type          | Type of the log (information, warning, etc...) |
| descry        | Description text of this log entry             |
| timestamp     | Timestamp of the log entry                     |
## 4.2.13.2.15.3.1  Read Execution Log
Read the execution log of a specific job.
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/to\_Execution\_log
Operation Type:
CRUD
HTTP Method:
GET
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| x-csrf-token | no         | fetch                            |
## Request Parameters
| Parameter   | Required   | Data Type   | Description   | Parameter Type   |
|-------------|------------|-------------|---------------|------------------|
| uuid        | yes        | string      | ID of the job | query string     |
## Request Example
```
 Sample Code GET /sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Pull(uuid=02409ac8dc6a-1edb-908e-31e4b44596d4')/to_Execution_log HTTP/1.1 Host: host.com Authentication: basicAuthentication Accept: application/json
```
## Response
## Response Headers
Header x-csrf-token
## Response Status and Error Codes
|   Code | Reason      | Description                                              |
|--------|-------------|----------------------------------------------------------|
|    200 | OK          | Read execution log succesfully                           |
|    400 | Bad Request | Could not find an execution log with the specified UUID. |
## Request Payload Example
```
 Sample Code { "d": { "results": [ { "__metadata": { "id": "host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ ExecutionLogs(index_no=1m,uuid=guid'UUID')", "uri": "host.com/sap/opu/ odata/sap/MANAGE_GIT_REPOSITORY/ExecutionLogs(index_no=1m,uuid=guid'UUID')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.ExecutionLogsType" } , "index_no": "1", "uuid": "UUID", "type": "Information", "descr": "Step X: MESSAGE", "timestamp": "/Date(1571227438000+0000)/", "criticality": 0, } ] } }
```
Description
Token, which can be used for POST requests
## 4.2.13.2.15.4  Pull
Resource path: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Pull
## Operations
## CRUD Operations
| HTTP Method   | Description        | Operation   |
|---------------|--------------------|-------------|
| GET           | Read pull          |             |
| POST          | Trigger a pull job |             |
## Custom Operations
| HTTP Method   | Description   | Operation   | URI                                                                              |
|---------------|---------------|-------------|----------------------------------------------------------------------------------|
| GET           | Associationl  |             | /sap/opu/odata/sap/ MANAGE_GIT_REPOSI- TORY /Pull(guid'UUID')/ to_Executiong_log |
| GET           | Associationl  |             | /sap/opu/odata/sap/ MANAGE_GIT_REPOSI- TORY /Pull(guid'UUID')/ to_Transport_log  |
## Parameters
| Property     | Description                              |
|--------------|------------------------------------------|
| uuid         | ID of the job                            |
| sc_name      | Nameof the software component            |
| branch_name  | Nameof the branch                        |
| commit_id    | Commit ID                                |
| import_type  | Type of import                           |
| status       | Status of the job                        |
| status_descr | Status description                       |
| user_name    | Nameof the user who triggered the action |
| start_time   | Start time of the job                    |
| change_time  | Last update of the job                   |
## 4.2.13.2.15.4.1  Read Pull
Read a pull jon.
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Pull
Operation Type:
CRUD
HTTP Method:
GET
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| x-csrf-token | no         | fetch                            |
## Request Parameters
| Parameter   | Required   | Data Type   | Description   | Parameter Type   |
|-------------|------------|-------------|---------------|------------------|
| uuid        | yes        | string      | ID of the job | query string     |
## Request Example
##  Sample Code
```
GET /sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Pull(uuid=02409ac8- dc6a-1edb-908e-31e4b44596d4') HTTP/1.1 Host: host.com Authentication: basicAuthentication Accept: application/json
```
## Response
## Response Headers
| Header       | Description                                |
|--------------|--------------------------------------------|
| x-csrf-token | Token, which can be used for POST requests |
## Response Status and Error Codes
|   Code | Reason      | Description                                           |
|--------|-------------|-------------------------------------------------------|
|    200 | OK          | Read pull succesfully                                 |
|    400 | Bad Request | Could not find a pull entity with the specified UUID. |
## Request Payload Example
```
 Sample Code { "d": { "__metadata": { "id": "https://host.com/sap/opu/odata/sap/ MANAGE_GIT_REPOSITORY/Pull(guid'UUID')", "uri": "https://host.com/sap/opu/ odata/sap/MANAGE_GIT_REPOSITORY/Pull(guid'UUID')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.PullType" } , "uuid": "UUID ", "sc_name": "/DMO/GIT_REPOSITORY ", "namespace": "", "status": "R", "status_descr": "Running", "start_time": "/Date(1571227437000+0000)/", "change_time": "/Date(1571227472000+0000)/", "criticality": 2, "user_name": "CC0000000001", "to_Execution_log": { "__deferred": { "uri": "https://host.com/sap/opu/odata/sap/ MANAGE_GIT_REPOSITORY/Pull(guid'UUID')/to_Execution_log" } } , "to_Transport_log": { "__deferred": { "uri": "https://host.com/sap/opu/odata/sap/ MANAGE_GIT_REPOSITORY/Pull(guid'UUID')/to_Transport_log" } } } }
```
## 4.2.13.2.15.4.2  Create Pull
Create a pull job.
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Pull
Operation Type:
CRUD
HTTP Method:
POST
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| Content-Type | no         | application/json application/xml |
| x-csrf-token | yes        | Value of x-csrf-token            |
## Request Parameters
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | Request body     |
| commit_id   | no         | string      | commit ID                      | Request body     |
## Request Example
```
 Sample Code POST/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Pull HTTP/1.1 Host: host.com Authentication: basicAuthentication X-csrf-token: xCsrfToken Content-Type: application/json Accept: application/json { "sc_name" : "/DMO/GIT_REPOSITORY" }
```
## Response
## Response Status and Error Codes
|   Code | Reason      | Description                                               |
|--------|-------------|-----------------------------------------------------------|
|    201 | Created     | Created a pull job                                        |
|    400 | Bad Request | Could not read the pull job. Please check the parameters. |
## Request Payload Example
```
 Sample Code { "d": { "__metadata": { "id": "https://host.com/sap/opu/odata/sap/ MANAGE_GIT_REPOSITORY/Pull(guid'UUID')", "uri": "https://host.com/sap/opu/ odata/sap/MANAGE_GIT_REPOSITORY/Pull(guid'UUID')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.PullType" } , "uuid": "UUID ", "sc_name": "/DMO/GIT_REPOSITORY ", "namespace": "", "status": "R", "status_descr": "Running", "start_time": "/Date(1571227437000+0000)/", "change_time": "/Date(1571227472000+0000)/", "criticality": 2, "user_name": "CC0000000001", "to_Execution_log": { "__deferred": { "uri": "https://host.com/sap/opu/odata/sap/ MANAGE_GIT_REPOSITORY/Pull(guid'UUID')/to_Execution_log" } } , "to_Transport_log": { "__deferred": { "uri": "https://host.com/sap/opu/odata/sap/ MANAGE_GIT_REPOSITORY/Pull(guid'UUID')/to_Transport_log" } } } }
```
## 4.2.13.2.15.5  Transport Log
Resource path: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/TransportLogs
## Operations
CRUD Operations
HTTP Method
GET
Operation
Read Transport Log [page 1091]
## Parameters
| Property   | Description                                    |
|------------|------------------------------------------------|
| uuid       | ID of the job                                  |
| index_no   | Index number of the log entry                  |
| type       | Type of the log (information, warning, etc...) |
| descry     | Description text of this log entry             |
| timestamp  | Timestamp of the log entry                     |
## 4.2.13.2.15.5.1  Read Transport Log
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/to\_Transport\_log
Operation Type:
CRUD
HTTP Method:
GET
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| x-csrf-token | no         | fetch                            |
## Request Parameters
| Parameter   | Required   | Data Type   | Description   | Parameter Type   |
|-------------|------------|-------------|---------------|------------------|
| uuid        | yes        | string      | ID of the job | query string     |
## Request Example
##  Sample Code
GET /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Pull(uuid=02409ac8- dc6a-1edb-908e-31e4b44596d4')/to\_Transport\_log HTTP/1.1 Host: host.com Authentication: basicAuthentication Accept: application/json
## Response
## Response Headers
Header x-csrf-token
## Response Status and Error Codes
|   Code | Reason      | Description                                             |
|--------|-------------|---------------------------------------------------------|
|    200 | OK          | Read transport log succesfully                          |
|    400 | Bad Request | Could not find a transport log with the specified UUID. |
## Request Payload Example
```
 Sample Code { { "d": { "results": [ { "__metadata": { "id": "host.com/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ ExecutionLogs(index_no=1m,uuid=guid'UUID')", "uri": "host.com/sap/opu/ odata/sap/MANAGE_GIT_REPOSITORY/ExecutionLogs(index_no=1m,uuid=guid'UUID')", "type": "cds_sd_a4c_a2g_gha_sc_web_api.ExecutionLogsType" } , "index_no": "1", "uuid": "UUID", "type": "Information", "descr": "Step X: Message", "timestamp": "/Date(1571227438000+0000)/", "criticality": 0, } ] } }
```
## 4.2.13.2.15.6  Tags
Resource path: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Tags
Description
Token, which can be used for POST requests
## Operations
## CRUD Operations
| HTTP Method   | Operation                          |
|---------------|------------------------------------|
| GET           | Read Entities from Tag [page 1093] |
| POST          | Create Tag [page 1094]             |
| DELETE        | Delete Tag [page 1097]             |
## Custom Operations
| HTTP Method   | Operation Type   | Operation                    | URI                                                                                                                      |
|---------------|------------------|------------------------------|--------------------------------------------------------------------------------------------------------------------------|
| POST          | Action           | Read Tags by Key [page 1096] | /sap/opu/odata/sap/ MANAGE_GIT_REPOSI- TORY/ Tags(sc_name='{sc_name}',c ommit_id='{com- mit_id}',tag_name='{tag_na me}') |
## 4.2.13.2.15.6.1  Read Entities from Tag
Read entities from tags.
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Tags
Operation Type:
CRUD
HTTP Method:
GET
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| x-csrf-token | no         | fetch                            |
## Request Parameters
No parameters.
## Request Example
##  Sample Code
GET /sap/opu/odata/sap/Tags Host: host.com Authentication: basicAuthentication Accept: application/json
## Response
## Response Headers
Header x-csrf-token
## Response Status and Error Codes
|   Code | Reason    | Description                                                           |
|--------|-----------|-----------------------------------------------------------------------|
|    200 | OK        | Branch was read successfully                                          |
|    404 | Not foumd | Could not read branch; software com- ponent or branch may not exist.. |
## Request Payload Example
 Sample Code
## 4.2.13.2.15.6.2  Create Tag
Create a new tag.
## Request
URI: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/Tags
Operation Type:
CRUD
HTTP Method:
POST
Description
Token, which can be used for POST requests
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| Content-Type | no         | application/json application/xml |
| x-csrf-token | yes        | Value of x-csrf-token            |
## Request Parameters
No parameters.
## Request Body
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | Request body     |
| commit_id   | yes        | string      | long commit id                 | Request body     |
| tag_name    | yes        | string      | name of the tag                | Request body     |
##  Sample Code
```
POST/sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Tags
```
```
HTTP/1.1 Host: host.com Authentication: basicAuthentication X-csrf-token: xCsrfToken Content-Type: application/json Accept: application/json { "sc_name": "string", "commit_id": "string", "tag_name": "string", "tag_description": "string", "tag_created_by": "string", "tag_created_on": "/Date(1492098664000)/", "short_commit_id": "string", "message": "string", "author": "string", "author_mail": "string" }
```
## Response
## Response Status and Error Codes
|   Code | Reason      | Description                                                          |
|--------|-------------|----------------------------------------------------------------------|
|    201 | Created     | Tag was created successfully                                         |
|    400 | Bad Request | Could not create a tag due to the values passed in the request body. |
## Request Payload Example
 Sample Code
## 4.2.13.2.15.6.3  Read Tags by Key
Read entities from tags.
## Request
URI:
: /sap/opu/odata/sap/MANAGE\_GIT\_REPOSITORY/
Tags(sc\_name='{sc\_name}',commit\_id='{commit\_id}',tag\_name='{tag\_name}')
Operation Type:
CRUD
HTTP Method:
GET
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| x-csrf-token | no         | fetch                            |
## Request Parameters
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | query string     |
| commit_id   | yes        | string      | long commit id                 | query string     |
| Parameter   | Required   | Data Type   | Description     | Parameter Type   |
|-------------|------------|-------------|-----------------|------------------|
| tag_name    | yes        | string      | name of the tag | query string     |
## Request Example
```
 Sample Code GET /sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ Tags(sc_name='{sc_name}',commit_id='{commit_id}',tag_name='{tag_name}') HTTP/1.1 Host: host.com Authentication: basicAuthentication Accept: application/json
```
## Response
## Response Headers
Header
Description
| x-csrf-token   | Token, which can be used for POST requests   |
|----------------|----------------------------------------------|
## Response Status and Error Codes
|   Code | Reason    | Description                                                           |
|--------|-----------|-----------------------------------------------------------------------|
|    200 | OK        | Tag was read successfully                                             |
|    404 | Not foumd | Could not read tag; software compo- nent or commit id may not exist.. |
## Request Payload Example
##  Sample Code
## 4.2.13.2.15.6.4  Delete Tag
Delete a branch.
## Request
```
URI: /sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/ Tags(sc_name='{sc_name}',commit_id='{commit_id}',tag_name='{tag_name}')
```
Operation Type:
CRUD
HTTP Method:
DELETE
## Request Headers
| Header       | Required   | Values                           |
|--------------|------------|----------------------------------|
| Accept       | no         | application/json application/xml |
| x-csrf-token | yes        | Value of x-csrf-token            |
## Request Body
| Parameter   | Required   | Data Type   | Description                    | Parameter Type   |
|-------------|------------|-------------|--------------------------------|------------------|
| sc_name     | yes        | string      | name of the software component | query string     |
| commid_id   | yes        | string      | long commit id                 | query string     |
| tag_name    | yes        | string      | name of the branch             | query string     |
## Request Example
##  Sample Code
```
DELETE /sap/opu/odata/sap/MANAGE_GIT_REPOSITORY/Branches(branch_name='my-to- be-deleted-branch',sc_name='/DMO/GIT_REPOSITORY') HTTP/1.1 Host: host.com Authentication: basicAuthentication Accept: application/json
```
## Response
## Response Headers
##  Sample Code
HTTP/1.1 204 No Content
## Response Status and Error Codes
|   Code | Reason      | Description                                                        |
|--------|-------------|--------------------------------------------------------------------|
|    204 | No content  | Tag was deleted successfully                                       |
|    400 | Bad Request | Could not delete tag due to the values passed in the request body. |
## 4.2.13.3  Integrating On-Premise Systems
Set up the Cloud Connector to enable communication from the ABAP environment to your on-premise systems using Remote Function Calls (RFC) and HTTP calls.
## Concept
For each subaccount, a Connectivity service instance is set up automatically in the SAP provider account. To use this instance, activate the Cloud Connector in your communication system.
In this scenario, you must connect the Cloud Connector to and configure trust for your Cloud Foundry subaccount as described in SAP BTP Connectivity: Cloud Connector.
<!-- image -->
##  Restriction
This scenario requires a Cloud Connector as of version 2.12.3 or higher.
##  Note
For more information on the deprecated scenario that uses the Connectivity service in the Neo environment, see Create a Communication Arrangement for Cloud Connector Integration (Deprecated) [page 1101].
After you have completed the setup, a connection from the ABAP environment tenant to an on-premise system is established in the following order:
1. The ABAP environment tenant requests to open the tunnel connection through the Connectivity service.
2. The Connectivity service tells the Cloud Connector to open the connection to this specific ABAP environment tenant using the admin connection.
3. The Cloud Connector opens a tunnel connection to the ABAP environment tenant using its public tenant URL.
4. After the tunnel is established, it can be used for actual data connection using RFC and HTTP(S) protocols.
## Next Steps
To set up your actual data connections between your ABAP environment and on-premise systems, you must enable the required Cloud Connector in your communication system. See Enable On-Premise Connectivity [page 1100].
## Troubleshooting
In case of issues using the Cloud Connector, see Cloud Connector Troubleshooting for a troubleshooting guide.
## 4.2.13.3.1  Enable On-Premise Connectivity
Create an HTTP and an RFC destination to enable communication from the ABAP environment to your onpremise systems.
## Prerequisites
- You have installed Cloud Connector version 2.12.3 or higher, see Cloud Connector: Installation.
- You have done the initial configuration for the Cloud Connector, see Cloud Connector: Initial Configuration.
- If you want to use principal propagation as authentication type, the Cloud Connector must be configured to support this authentication type. See Cloud Connector: Configuring Principal Propagation. Also, make sure that no communication arrangement to the deprecated communication scenario SAP\_COM\_0200 exists.
- If you use more than one Cloud Connector in your subaccount, you have assigned a location ID to each of these Cloud Connectors. See Managing Subaccounts.
## Procedure
To enable on-premise connectivity, you must use the Cloud Connector in your communication system:
- Creating a Communication System for Outbound HTTP
- Creating a Communication System for Outbound RFC
## Related Information
Outbound Communication Communication System
## 4.2.13.4  Managing the SAP BTP ABAP environment Service Instance
In this chapter, you learn how to create configurations as an administrator for different integration use cases.
## Create a Destination [page 1104]
If your business application uses external services, you have to set up a destination for outbound communication either in your subaccount, which is recommended, or in your space.
## Create a Communication Arrangement for Inbound Communication with Service Key Type Basic [page 1105]
Learn how to quickly create a communication user and communication arrangement for an inbound communication scenario by using a service key of type basic.
## Configure Timeout of @sap/approuter Component of a Communication Arrangement for Inbound Communication with Service Key OAuth [page 1106]
By default, communication between the approuter and connected services is timed out after 30 seconds. This default value is suitable for most applications. However, for long-lasting data transfer, communication lasts longer. If you experience timeouts, you can set the service key parameter abap\_endpoint\_timeout to a value higher than 30 seconds.
## 4.2.13.4.1  Create a Destination
If your business application uses external services, you have to set up a destination for outbound communication either in your subaccount, which is recommended, or in your space.
## Creating a Destination in Your Subaccount
1. Log on to the SAP BTP cockpit and navigate to your subaccount.
2. In the navigation area, go to Connectivity Destinations and select New Destination .
3. Set up your destination and select Save . For more information, see Create Destinations from Scratch.
## Creating a Destination in Your Space
##  Prerequisites
- You have created an ABAP service instance. See Creating an ABAP System.
- You have created a destination service instance. See Creating Service Instances in Cloud Foundry.
- You have created a service key. See Creating Service Keys in Cloud Foundry.
1. Log on to the SAP BTP and go to the subaccount that contains the space you'd like to navigate to. See Navigate in the Cockpit.
2. In the navigation area, go to Cloud Foundry Spaces and select the space that contains the ABAP system service instance.
3. Select Services Instances and navigate to your ABAP system service instance.
4. To open the administration launchpad, click on  and select View Dashboard .
5. If necessary, provide your logon credentials to access the administration launchpad.
6. In the Communication Management section, select the Communication Arrangements tile.
7. On the Communication Arrangements page, select New .
8. In the New Communication Arrangement dialog, use the value help to select scenario SAP\_COM\_0276 and give the arrangement a meaningful name (e.g. the name of the destination service instance).
9. Enter the service key of your destination service instance and select Create .
##  Note
The process for connecting to an ABAP service instance URL when creating a new ABAP Cloud project in ABAP development tools for Eclipse has changed. For more information, see ABAP Service Instance URL [page 1772].