openapi: 3.0.0 info: version: 2015-04-16 x-release: v4 title: 'AWS Directory Service #X Amz Target=DirectoryService 20150416.AcceptSharedDirectory #X Amz Target=DirectoryService 20150416.AcceptSharedDirectory #X Amz Target=DirectoryService 20150416.UpdateSettings API' description: Directory Service

Directory Service is a web service that makes it easy for you to setup and run directories in the Amazon Web Services cloud, or connect your Amazon Web Services resources with an existing self-managed Microsoft Active Directory. This guide provides detailed information about Directory Service operations, data types, parameters, and errors. For information about Directory Services features, see Directory Service and the Directory Service Administration Guide.

Amazon Web Services provides SDKs that consist of libraries and sample code for various programming languages and platforms (Java, Ruby, .Net, iOS, Android, etc.). The SDKs provide a convenient way to create programmatic access to Directory Service and other Amazon Web Services services. For more information about the Amazon Web Services SDKs, including how to download and install them, see Tools for Amazon Web Services.

x-logo: url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: ds x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/ds-2015-04-16.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://ds.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Directory Service multi-region endpoint - url: https://ds.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The Directory Service multi-region endpoint - url: http://ds.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Directory Service endpoint for China (Beijing) and China (Ningxia) - url: https://ds.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The Directory Service endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: '#X Amz Target=DirectoryService 20150416.UpdateSettings' paths: /#X-Amz-Target=DirectoryService_20150416.UpdateSettings: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: UpdateSettings description: Updates the configurable settings for the specified directory. responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/UpdateSettingsResult' '480': description: DirectoryDoesNotExistException content: application/json: schema: $ref: '#/components/schemas/DirectoryDoesNotExistException' '481': description: UnsupportedOperationException content: application/json: schema: $ref: '#/components/schemas/UnsupportedOperationException' '482': description: DirectoryUnavailableException content: application/json: schema: $ref: '#/components/schemas/DirectoryUnavailableException' '483': description: IncompatibleSettingsException content: application/json: schema: $ref: '#/components/schemas/IncompatibleSettingsException' '484': description: UnsupportedSettingsException content: application/json: schema: $ref: '#/components/schemas/UnsupportedSettingsException' '485': description: InvalidParameterException content: application/json: schema: $ref: '#/components/schemas/InvalidParameterException' '486': description: ClientException content: application/json: schema: $ref: '#/components/schemas/ClientException' '487': description: ServiceException content: application/json: schema: $ref: '#/components/schemas/ServiceException' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/UpdateSettingsRequest' parameters: - name: X-Amz-Target in: header required: true schema: type: string enum: - DirectoryService_20150416.UpdateSettings tags: - '#X Amz Target=DirectoryService 20150416.UpdateSettings' components: schemas: DirectoryUnavailableException: {} UpdateSettingsRequest: type: object required: - DirectoryId - Settings title: UpdateSettingsRequest properties: DirectoryId: allOf: - $ref: '#/components/schemas/DirectoryId' - description: The identifier of the directory for which to update settings. Settings: allOf: - $ref: '#/components/schemas/Settings' - description: The list of Setting objects. ClientException: {} DirectoryConfigurationSettingName: type: string pattern: ^[a-zA-Z0-9-/. _]*$ minLength: 1 maxLength: 255 DirectoryId: type: string pattern: ^d-[0-9a-f]{10}$ DirectoryConfigurationSettingValue: type: string pattern: ^[a-zA-Z0-9]*$ minLength: 1 maxLength: 255 Settings: type: array items: $ref: '#/components/schemas/Setting' UnsupportedSettingsException: {} UnsupportedOperationException: {} DirectoryDoesNotExistException: {} IncompatibleSettingsException: {} ServiceException: {} Setting: type: object required: - Name - Value properties: Name: allOf: - $ref: '#/components/schemas/DirectoryConfigurationSettingName' - description:

The name of the directory setting. For example:

TLS_1_0

Value: allOf: - $ref: '#/components/schemas/DirectoryConfigurationSettingValue' - description: 'The value of the directory setting for which to retrieve information. For example, for TLS_1_0, the valid values are: Enable and Disable.' description: Contains information about the configurable settings for a directory. InvalidParameterException: {} UpdateSettingsResult: type: object properties: DirectoryId: allOf: - $ref: '#/components/schemas/DirectoryId' - description: The identifier of the directory. parameters: X-Amz-Date: name: X-Amz-Date in: header schema: type: string required: false X-Amz-SignedHeaders: name: X-Amz-SignedHeaders in: header schema: type: string required: false X-Amz-Credential: name: X-Amz-Credential in: header schema: type: string required: false X-Amz-Content-Sha256: name: X-Amz-Content-Sha256 in: header schema: type: string required: false X-Amz-Algorithm: name: X-Amz-Algorithm in: header schema: type: string required: false X-Amz-Signature: name: X-Amz-Signature in: header schema: type: string required: false X-Amz-Security-Token: name: X-Amz-Security-Token in: header schema: type: string required: false securitySchemes: hmac: type: apiKey name: Authorization in: header description: Amazon Signature authorization v4 x-amazon-apigateway-authtype: awsSigv4 externalDocs: description: Amazon Web Services documentation url: https://docs.aws.amazon.com/ds/ x-hasEquivalentPaths: true