Update Directory Service (v2.0)

PUT 
/sdwan/v2.0/api/directoryservices/:directory_service_id

Update a directory service.

Request

Path Parameters

directory_service_id stringrequired

The ID of the directory service.

application/json

Body

Details of Directory Service

directory_tenant_id string

The directory tenant ID.

enabled boolean

The directory service enabled.

group_attributes DirectoryGroupAttribute

The directory group attributes.

email string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

The email address values.

primary_name string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

The primary name.

id string

The ID.

region string

Region of the tenant.

tags string[]

A information field that can be added to identify the directory service. Maximum 10 unique tags of length 1024 each are allowed.

user_attributes DirectoryUserAttribute

The directory user attributes.

alternate_username_1 string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Alternate Username_1

alternate_username_2 string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Alternate Username_2

alternate_username_3 string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Alternate Username_3

email string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Email

primary_name string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Primary Name

Responses

200

Successful Operation

application/json

Schema

Schema

directory_tenant_id string

The directory tenant ID.

enabled boolean

The directory service enabled.

group_attributes DirectoryGroupAttribute

The directory group attributes.

email string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

The email address values.

primary_name string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

The primary name.

id string

The ID.

region string

Region of the tenant.

tags string[]

A information field that can be added to identify the directory service. Maximum 10 unique tags of length 1024 each are allowed.

user_attributes DirectoryUserAttribute

The directory user attributes.

alternate_username_1 string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Alternate Username_1

alternate_username_2 string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Alternate Username_2

alternate_username_3 string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Alternate Username_3

email string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Email

primary_name string

Possible values: [SAM_ACCOUNT_NAME, EMAIL, COMMON_NAME, DISTINGUISHED_NAME, USER_PRINCIPAL_NAME]

Primary Name

Example (from schema)

{
  "directory_tenant_id": "string",
  "enabled": true,
  "group_attributes": {
    "email": "SAM_ACCOUNT_NAME",
    "primary_name": "SAM_ACCOUNT_NAME"
  },
  "id": "string",
  "region": "string",
  "tags": [
    "string"
  ],
  "user_attributes": {
    "alternate_username_1": "SAM_ACCOUNT_NAME",
    "alternate_username_2": "SAM_ACCOUNT_NAME",
    "alternate_username_3": "SAM_ACCOUNT_NAME",
    "email": "SAM_ACCOUNT_NAME",
    "primary_name": "SAM_ACCOUNT_NAME"
  }
}

400

Bad Request

application/json

Schema

Schema

_error ErrorResponse[]
Array [
code string
The error code.
message string
The error message.
]

Example (from schema)

{
  "_error": [
    {
      "code": "string",
      "message": "string"
    }
  ]
}

Example

{
  "value": {
    "_error": [
      {
        "code": "INVALID_JSON_EXTRA_ATTRIBUTE"
      },
      {
        "code": "DIRECTORY_SERVICE_PRIMARY_USER_ATTRIBUTE_REQUIRED"
      },
      {
        "code": "DIRECTORY_SERVICE_USER_ATTRIBUTE_NOT_ALLOWED"
      },
      {
        "code": "DIRECTORY_SERVICE_PRIMARY_GROUP_ATTRIBUTE_NOT_ALLOWED"
      },
      {
        "code": "DIRECTORY_SERVICE_PRIMARY_USER_GROUP_ATTRIBUTE_REQUIRED"
      }
    ]
  }
}

Loading...