github.com/kyma-project/kyma-environment-broker@v0.0.1/docs/user/04-20-custom-administrators.md (about)

     1  # Set a custom list of SAP BTP, Kyma runtime administrators
     2  
     3  Kyma Environment Broker allows you to set a custom list of runtime administrators during SAP BTP, Kyma runtime provisioning and update operations.
     4  To do so, specify the additional **administrators** parameter in the provisioning or update request.
     5  >**NOTE:** Make sure to provide at least one administrator in the list. The empty list causes a validation error.
     6  
     7  In the provisioning request, the **administrators** parameter overwrites the default administrator list that is taken from the **user_id** field.
     8  See the example:
     9  
    10  ```bash
    11     export VERSION=1.15.0
    12     curl --request PUT "https://$BROKER_URL/oauth/v2/service_instances/$INSTANCE_ID?accepts_incomplete=true" \
    13     --header 'X-Broker-API-Version: 2.14' \
    14     --header 'Content-Type: application/json' \
    15     --header "$AUTHORIZATION_HEADER" \
    16     --data-raw "{
    17         \"service_id\": \"47c9dcbf-ff30-448e-ab36-d3bad66ba281\",
    18         \"plan_id\": \"4deee563-e5ec-4731-b9b1-53b42d855f0c\",
    19         \"context\": {
    20             \"globalaccount_id\": \"$GLOBAL_ACCOUNT_ID\",
    21             \"subaccount_id\": \"$SUBACCOUNT_ID\",
    22             \"user_id\": \"$USER_ID\",
    23         },
    24         \"parameters\": {
    25             \"name\": \"$NAME\",
    26             \"region\": \"$REGION\",
    27             \"administrators\":[\"admin1@test.com\",\"admin2@test.com\"]
    28         }
    29     }"
    30  ```
    31  
    32  In the update request, the **administrators** parameter overwrites the last list of administrators.
    33  See the example:
    34  
    35  ```bash
    36     export VERSION=1.15.0
    37     curl --request PATCH "https://$BROKER_URL/oauth/v2/service_instances/$INSTANCE_ID?accepts_incomplete=true" \
    38     --header 'X-Broker-API-Version: 2.14' \
    39     --header 'Content-Type: application/json' \
    40     --header "$AUTHORIZATION_HEADER" \
    41     --data-raw "{
    42         \"service_id\": \"47c9dcbf-ff30-448e-ab36-d3bad66ba281\",
    43         \"plan_id\": \"4deee563-e5ec-4731-b9b1-53b42d855f0c\",
    44         \"context\": {
    45             \"globalaccount_id\": \"$GLOBAL_ACCOUNT_ID\",
    46             \"subaccount_id\": \"$SUBACCOUNT_ID\",
    47         },
    48         \"parameters\": {
    49             \"administrators\":[\"admin3@test.com\"]
    50         }
    51     }"
    52  ```
    53  
    54  >**NOTE:** You can't use the **user_id** field to overwrite the administrators list. Use the **administrators** parameter instead.